Connect Vertex
Edit on GitHubThis document describes how to connect a Spryker project to Vertex.
Prerequisites
- Install Vertex
- Create an account with Vertex. If you need support getting a Vertex account, contact support or your Customer Success Manager.
Connect Vertex
- In the Back Office, go to Apps.
- On the App Composition Platform Catalog page, click Vertex. This opens the Vertex app details page.
- In the top right corner of the Vertex app details page, click Connect app. The notification saying that the application connection is pending is displayed.
- In the top right corner of the Vertex app details page, click Configure.
- To activate the app, select Active.
- In Security URI, enter the Security URI of your Vertex platform. For details on the Security URI, see Vertex documentation.
- In Transaction calls URI, enter the Transaction Calls URI of your Vertex platform. For details on the Transaction Calls URI, see Vertex documentation.
- In Client ID/Client secret, enter your Vertex client secret. See Vertex documentation for details about how to obtain it.
- For DEFAULT TAXPAYER COMPANY CODE, enter the company code you set in your Vertex account.
- Optional: To enable invoice saving in Vertex, select Enable invoice save in Vertex.
- Click Save.
Verify Vertex connection
Test the configuration
To ensure accuracy and compliance with tax laws, we highly recommend thoroughly testing the Vertex integration.
Once you’ve configured Vertex, the taxes are calculated in real time in the checkout. A message about this is displayed on the checkout page.
On the Storefront, the tax amount is displayed on the checkout summary page.
In the Back Office, the taxes are displayed on the order details page.
If you configured invoices to be saved in Vertex, you can view the taxes processed by Vertex as follows:
- In the Vertex dashboard, go to Reporting > Standard Reports.
- Click Report Output.
- Next to the report you want to view the taxes for, click Action>View report.
- On the invoice page, you can verify the invoice number that corresponds to the Spryker order number and the applicable country tax calculated by Vertex.
Next steps
Thank you!
For submitting the form