Enterprise Resource Planning Blogs by SAP
Get insights and updates about cloud ERP and RISE with SAP, SAP S/4HANA and SAP S/4HANA Cloud, and more enterprise management capabilities with SAP blog posts.
Showing results for 
Search instead for 
Did you mean: 


Vertex is a Tax Provider in the United States which streamlines the process of taxation there. During tax calculation, SAP Business ByDesign makes a Soap call to Vertex by sending the document date, document types, addresses including postal codes, etc. and Vertex returns Tax Details, Jurisdiction Codes, Jurisdiction Types, and names, etc. The Vertex tax provider calculates and returns accurate taxes applicable to the sale or purchase of goods and services.


In order to determine and calculate taxes using Vertex integration, some preparation is necessary. It's a two-step process: -

Step 1: Scoping In Vertex within ByDesign.

Following are the steps to scope in Vertex within the ByDesign System: –

  1. Go to w/c Business Configuration -> Implementation Projects.

  2. Choose the main project and click on “Edit project scope”.

  3. Proceed to step 4 “Questions”

  4. Select Scoping Element “Tax Calculation” via path “Built-in Services and Support” -> “Business Environment” -> “Tax Calculation” and answer the question “Do you want to use the services provided by Vertex to determine tax rates for the US?” with “Yes”.

  5. Save the changes to trigger a Business Configuration deployment.

Step 2: Setup for Communication to Vertex.

Following are the steps to set up communication with Vertex: –

  1. Go to w/c Application and User Management -> Communication Systems.

  2. Create a new Communication System. Give hostname as “bydcsconnect.vertexsmb.com”. Mention the System Instance as per the below screenshot. Save the communication system and set it to Active by clicking on Action->Set to Active.

  3. Now create a new communication arrangement via Application and user Management->New Communication Arrangement. Choose “Request tax rates from Vertex”. This Communication Arrangement is a pre-built connection between ByDesign and the third-party software, Vertex.

  4. Set the communication system as created in the previous step (“VERTEX” in this case).

  5. Choose None in the authentication method and enter credentials.

  6. Click “Edit Advanced Settings”. Enter the details like hostname and path.

  7. Click on Next, Finish and Activate. Once done you should have the communication arrangement set up.


Create a new manual invoice with proper data such as account id, product, etc. The tax rates will be returned by Vertex and the field external tax determination is set to true.

For Tax jurisdiction subtype field, go to Personalize ->This screen ->Tax details and choose tax jurisdiction subtype field. For Exempted Base Amount field, choose Exempted Base Amount field on the same screen. Click Save.

The Tax code that can be chosen from the dropdown of tax codes are the standard tax codes for the US, no user created tax codes are displayed in a Vertex scoped system.

Please note that once Vertex is configured in the system, one has to make sure that all the addresses within the system are correct, especially the postal and region codes should be in sync because the external tax provider validates all the addresses being sent to it.

For more details, on recent enhancements made in the integration with external tax vendors, have a look at the Release Highlights video.