Have you installed the code needed?


To integrate Microsoft Dynamics 365 Business Central with Shiptheory, you will need to install some specific code onto your Microsoft Dynamics 365 Business Central platform. This might require some assistance from your system integrator.


Please follow this guide to configure your Microsoft Dynamics 365 Business Central account before continuing in Shiptheory. You will not be able to connect your Microsoft Dynamics 365 Business Central account to Shiptheory until this section is complete.


Once completed, you will be ready to connect with Shiptheory.




Connect Microsoft Dynamics 365 Business Central with Shiptheory


To connect Microsoft Dynamics 365 Business Central with Shiptheory, you will need the following:

  • Tenant ID
  • Client ID
  • Client Secret
  • Company ID
  • Environment Name (default to Production)


You will also need to choose the correct Shipment Type based on what you have installed in Business Central. Please see the above Integration Guide for details.


If you do not have them, please take a look at this article: Find the Tenant ID, Client ID & secret and Company ID from Microsoft Dynamics 365 Business Central


On the left-hand menu, click Channels > Manage Channels:



Scroll down and click on the Microsoft Dynamics 365 on your account, or you can type to find it:


Please read the instructions and have the code installed and tested on your Business Central - enter the information needed, tick the box if you have installed the code, and press Next to continue:



On the next page, check the information and choose which MS365 order reference you would like to use for the Shipment ID in Shiptheory:


If you would like Shiptheory to download the MS365 warehouse address as the sender address, please click Advanced Settings, otherwise click SAVE.




Error Messages


If you encountered any errors during the connection, please find the suggested steps to resolve below:


Error MessageSuggest steps to resolve
Unable to authenticate: Please check your Tenant ID, Client ID and Client Secret
  • Double check the information you entered
  • Has your client secret expired? When your client secret is generated, an expiry date is set. You will need to regenerate your secret if it expires 
Environment does not exist
  • Check your Microsoft Dynamics 365 Business Central environment
The Warehouse Shipment UPDATE API is not working. Please check your configuration in Business Central and try again

or

The Warehouse Shipment DOWNLOAD API is not working. Please check your configuration in Business Central and try again
  • Check the endpoints are being correctly implemented according to the Integration Guide
  • Use developer tools like Postman or Insomnia to test the API in Business Central


If you have any trouble with getting set up, or are unsure of what information to include or just need any clarification - you can reach out to our support team and we'll be happy to help.