SOAP Configuration for Dynamics NAV 2018 and Business Central

SOAP web service configuration

This page describes how to configure the NAV SOAP web service.‌

Install SOAP web service

SSL

SOAP Base URL

‌You may enter the correct external SOAP Base URL in the SOAP Base URL setting. The base URL must have the following syntax: http[s]://hostname:port/instance/WS/Example Base URL

https://nav.mycompany.com:7047/MyNAVInstance/WS/

Configure SOAP web service

Credentials

‌The Golden EDI cloud service will communicate with your NAV instance over the SOAP web service. To do this Golden EDI cloud service need to authenticate with a NAV user account. Please create a specific user for the Golden EDI cloud service, we recommend you to generate a Web Service Access Key with a the Key Never Expires option. If you choose to go for a ordinary user password the password will need to not expire.‌

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:‌

  • Full User - Make sure the user has the user permission set Super.

  • Limited User

    (Table IDs for NAV 2018 and BC ) set the permissions to the following:

    Tables with write/read:

    • 70019007 - GEDI ClassInformation

    • 70019002 - GEDI Message Queues

    • 70019001 - GEDI Message Line

    Tables with read:

    • 70019013 - GEDI Class Setup

    • 70019005 - GEDI Message Code

    • 70019003 - GEDI Profiles

Firewall

‌In most cases your IT infrastructure contains a firewall between the Internet and your NAV server (or maybe you use the Windows firewall). Golden EDI cloud service needs to have access from Internet to the SOAP web service. If you have a firewall you need to open up the correct port in your firewall for the Golden EDI cloud service. Usually this means to open up port 7047 for TCP connections from the Internet to your NAV server. You can limit the access to the SOAP web service for these source IP addresses:‌

  • 104.46.62.206

  • 13.69.154.177

  • 83.233.252.2

‌Golden EDI cloud service has multiple data centerns in different geographical locations and therefor uses multiple IP addresses when accessing your NAV SOAP service.‌

You can of course use any TCP port as long as the external port in the firewall is translated to the correct TCP port on your NAV server (Usually port 7047 but can be configured to your choice).‌

DNS name

‌We prefer that you have a DNS name for the public IP address that is used to access your NAV server.‌

Information to send to Golden EDI

‌When the configuration is done you need to send this information to Golden EDI:‌

  • Server/Domain name, Example: myserver.mydomain.com

  • Port, Example: 7047

  • SSL/HTTPS usage: yes/no

  • Server instance, Example: DynamicsNAV

  • NAV Company name, Example: My Company Ltd

‌You can send the above information or the SOAP Base URL and the NAV company name:Example of a SOAP Base URL

https://myserver.mydomain.com:7047/DynamicsNAV/WS/

‌We also need the credentials for the user created above:‌

  • Username

  • Web Service Access Key or Password

  • Domain

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:‌

http[s]://hostname:port/instance/WS/company-name/servicesExample of a full URL to the NAV SOAP web service

https://myserver.mydomain.com:7047/DynamicsNAV/WS/My%20Company%20Ltd/services

You should see entries for the Golden EDI pages as described under the section Configure SOAP web service.

Last updated