Cloud

Finding and configuring SOAP settings in Business Central - Cloud

URL

Finding the actual SOAP address in Business Central Cloud is quite easy. The base is always the same, the only addition is the unique ID for your organization (Azure AD tenant) and the name of the environment.

Base URL
https://api.businesscentral.dynamics.com/v2.0/

The unique ID for your organization can be found under "Help and support", which can be found by clicking the big "?" (question mark) up to the left, right next to your user icon. In the picture below the ID is the text marked in yellow and the environment name is marked in pink.

The Azure AD tenant and the environment name.

Adding these two to the end of the address ending with "/WS", as shown below, gives you the full SOAP address as required by Golden EDI.

Full URL
https://api.businesscentral.dynamics.com/v2.0/7f894e1f-44ae-4264-a99b-000000000000/Sandbox/WS

Credentials

The Golden EDI cloud service will communicate with your Business Central instance over the SOAP web service. To do this Golden EDI cloud service need to authenticate with a user account. Please create a specific user for the Golden EDI cloud service and then generate a Web Service Access Key with the Key Never Expires option.

The user can be a Full User or a Limited User. The Limited User is has a cheaper license fee and is therefor the preferred choice.

Permissions

You can limit the tables the user has access to protect the wider system. To do this you can set so that the user only has access to the following tables.

  • 70019007 - GEDI Class Information - Read and Write

  • 70019002 - GEDI Message Queue - Read and Write

  • 70019001 - GEDI Message Line - Read and Write

  • 70019013 - GEDI Class Setup - Read

  • 70019005 - GEDI Message Code - Read

  • 70019003 - GEDI Profiles - Read

Information to send to Golden EDI

When the configuration is done you need to send the following information to Golden EDI or if you set up your own organization in our Cloud Service this is the information you need access to.

  • URL, The full SOAP address as found above.

  • Company Name, Example: My Company Ltd

  • Username, The username for authentication to SOAP.

  • Password or Web Service Access Key, The password for the above username.

How to test the configuration

It is a good idea to test the configuration before sending us the configuration information. Open up a web browser and try to access the full URL including company name for the SOAP web service. The URL looks like this:

Example URL
https://api.businesscentral.dynamics.com/v2.0/7f894e1f-44ae-4264-a99b-000000000000/Sandbox/WS/My%20Company%20Ltd/services

When asked for credentials enter the credentials for the user you created for Golden EDI. The result could look like this if everything is ok (The result is from Google Chrome web browser):

Example of a successful configuration when browsing the SOAP web service with Chrome

Last updated