Connect Sana to Microsoft Dynamics 365 Business Central

Sana Commerce Cloud connects to Microsoft Dynamics 365 Business Central via Web Service. Sana supports OData and SAOP Web services for Microsoft Dynamics 365 Business Central Cloud with the OAuth authentication.

NOTE

Support for the SOAP protocol is being deprecated in Microsoft Dynamics 365 Business Central Cloud and Microsoft will remove it in the future. It is highly recommended to use OData.

To establish connection between Sana and Microsoft Dynamics 365 Business Central, in Sana Admin click: System > ERP connection and enter the necessary settings.

Field

Description

Connection type

Select the connection type that should be used to connect your Sana Commerce Cloud web store to your Microsoft Dynamics 365 Business Central Cloud system.

You can use the following connection types:

  • Microsoft Dynamics 365 Business Central (OData + OAuth)
  • Microsoft Dynamics 365 Business Central (SOAP + OAuth)

Webservice URL

Enter the OData Web Service URL of Microsoft Dynamics 365 Business Central.

Starting with Sana Commerce Cloud 10.0.43 in Microsoft Dynamics 365 Business Central Cloud, you can find the Web Service URL in the Sana Web Services window when the Sana extension is installed inside Microsoft Dynamics 365 Business Central. In Microsoft Dynamics 365 Business Central choose the Search for Page or Report icon and enter Webshop Setup. In the Webshop Setup window click Web Services.

OData URL

The OData URL must be in the following format:

https://api.businesscentral.dynamics.com/v2.0/[TenantID]/[TenantName]/ODataV4/SCCWebService_ProcessJsonRequest?company=[CompanyName]OR[CompanyId]

Example:

https://api.businesscentral.dynamics.com/v2.0/a1bc2345-67de-8901-2fgh-3i45j67bbc12/Sana/ODataV4/SCCWebService_ProcessJsonRequest?company=SANA%20USA%2C%20Inc.

SOAP URL

NOTE

SOAP web services are deprecated in update 21 for Microsoft Dynamics 365 Business Central Cloud.

You can find the SOAP URL in the Web Services window when the Sana extension is installed inside Microsoft Dynamics 365 Business Central and configured. You should copy the SOAP URL of the SC_NAV_WebService service.

Access Token URL

Enter the Access Token URL. It must be in the following format:

https://login.windows.net/[Directory (tenant) ID]/oauth2/v2.0/token

The URL must contain the Directory (tenant) ID generated in the Microsoft Azure Portal when creating an application for Sana.

Example:

https://login.windows.net/a12bcdef-g3h4-567i-8901-23j4k5lm23n4/oauth2/v2.0/token

For more information, see Set Up OAuth Authentication.

Client ID

Enter the ID of the application (client) created in the Microsoft Azure Portal.

For more information, see Set Up OAuth Authentication.

Client secret

Enter the client secret generated in the Microsoft Azure Portal when creating an application for Sana.

This is a secret string that the application uses to prove its identity.

For more information, see Set Up OAuth Authentication.

Click Test connection to check whether the connection between Sana Commerce Cloud and Microsoft Dynamics 365 Business Central is established.

Now the Sana web store is connected to Microsoft Dynamics 365 Business Central and you can try it out.

Get started with the Sana web store integrated with Microsoft Dynamics 365 Business Central:

  1. Use the Get Started guide to get to know about Sana Commerce.

  2. Read the Sana User Guide to learn about Sana Commerce features and tools and how to configure them.

  3. Refer to the Microsoft Dynamics 365 Business Central Sana user manual for in-depth information about the core settings which you need to configure in Microsoft Dynamics 365 Business Central and master data management.