Skip to Content
Technical Articles
Author's profile photo Swati Singh

Vertex Configuration in SAP Business ByDesign


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 “”. 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.

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo François-Xavier LEPOUTRE
      François-Xavier LEPOUTRE

      Hello Swati Singh

      It seems some US states have different taxes depending on the type of product/service that is sold.

      For instance, in San Francisco, California, the tax rate for the same address is different whether you sell goods (8.6250%) or services (0%) to the same address.

      If you simulate the sale with the correct item info (based on Vertex mappings of Commodity Codes) on Vertex backoffice UI, the difference is clearly stated.

      However, when SAP Business ByDesign requests the tax rate to Vertex, the tax rate that it gets for goods and services for that same address is the same (8.6250%), when it should be different.

      What is there to configure in SAP Business ByDesign so that it can get the distinction between Products and Services when it is requesting tax rates to Vertex ? Is there some kind of matching required between ProductID (or any other field) with Vertex commodity codes mapping in order to get the correct tax rate?

      Thank you !

      Author's profile photo Swati Singh
      Swati Singh


      Sorry for late reply. I left the organization 3 years ago and therefore cannot recall much. Please reach out to the current stakeholders for this question. Or maybe you can try raising a customer incident to confirm the same.


      Swati Singh