Setting up GRANIT Interfaces

The GRANIT Integration allows users to integrate the GRANIT webshop into Microsoft Dynamics 365 Business Central to synchronize and check data such as item catalogs, prices and item availability.

This chapter covers the first setup of the GRANIT Integration after successful installation.

This chapter includes the following topics:

• User Setup for GRANIT
• Setting up GRANIT Interfaces
  • Setting up GRANIT Price List Parameters
  • Setting up GRANIT Price & Availability Parameters
  • Setting up GRANIT Smart Orders Parameters
  • Setting up GRANIT OCI Parameters
  • Setting up GRANIT Customer Sales Order Parameters
    • Customer Sales Order Interface Setup
    • Business Partner Setup
    • Integration Module Setup

User Setup for GRANIT

The user setup for the GRANIT Integration is the same as the user setup in Microsoft Dynamics 365 Business Central.
For a thorough description of the complete user setup, click here.

• Use the quick search (ALT+Q) to find the User Setup page where the following fields have been added for the GRANIT Integration:

• Fill in the fields as required.
• Your entries will be saved automatically.

You have successfully completed the user setup for the GRANIT Interface.

Setting up GRANIT Interfaces

After the successful installation, the separate interfaces need to be set up.
To set up an interface, please proceed as follows:

• Use the quick search (ALT+Q) to find the Interface List page, and click on the interface you want to set up.
• The corresponding Interface Card is shown.
• The type of interface is shown in the General FastTab.
• Optional Enter a clear description of the interface into the Description field.
• In the General FastTab:
  • Activate the Interface Log toggle switch to keep a record of all interface activities via the Log button in the menu bar.

• Select the authorization type in the Authorization Type field under the Authorization FastTab.
• Select the authorization code in the Authorization Code field.
• The fields in the Parameters and other FastTabs are described separately for the individual interfaces. Please make sure to finalize the following setups before proceeding:
  • Setting up GRANIT Price List Parameters
  • Setting up GRANIT Price & Availability Parameters
  • Setting up GRANIT Smart Orders Parameters
  • Setting up GRANIT OCI Parameters
  • Setting up GRANIT Customer Sales Order Parameters
    • Customer Sales Order Interface Setup
    • Business Partner Setup
    • Integration Module Setup
• After successful setup, click on Activate Interface in the menu bar.
• Your entries will be saved automatically.

You have successfully set up the interface.

Setting up GRANIT Price List Parameters

You can set up the following parameters in the Parameters FastTab on the Interface Card of the GRANIT Price List Interface.

• Fill out the Value field of each parameter.
• Your entries will be saved automatically.

You have successfully set up the parameters for the interface. Please proceed with the next step in the Setting up GRANIT Interfaces section to activate it.

Setting up GRANIT Price & Availability Parameters

You can set up the following parameters in the Parameters FastTab on the Interface Card of the GRANIT Price & Availability Interface.

• Fill out the Value field of each parameter.
• Your entries will be saved automatically.

You have successfully set up the parameters for the interface. Please proceed with the next step in the Setting up GRANIT Interfaces section to activate it.

Setting up GRANIT Smart Orders Parameters

You can set up the following parameters in the Parameters FastTab on the Interface Card of the GRANIT Smart Orders Interface.

• Fill out the Value field of each parameter.
• Your entries will be saved automatically.

You have successfully set up the parameters for the interface. Please proceed with the next step in the Setting up GRANIT Interfaces section to activate it.

Setting up GRANIT OCI Parameters

You can set up the following parameters in the Parameters FastTab on the Interface Card of the GRANIT OCI Interface.

• Fill out the Value field of each parameter.
• Your entries will be saved automatically.

You have successfully set up the parameters for the interface. Please proceed with the next step in the Setting up GRANIT Interfaces section to activate it.

Setting up GRANIT Customer Sales Order Parameters

You can set up the Customer Sales Order Interface (Partnershop) as follows:

• Customer Sales Order Interface Setup
• Business Partner Setup
• Integration Module Setup

Customer Sales Order Interface Setup

• Open the Interface List page in Microsoft Dynamics 365 Business Central and select the GRANIT Customer Sales Order Interface entry.
• Make sure that the Interface Log toggle switch is activated in the General FastTab.
• Skip the Parameters FastTab as there are no values to set up.
• In the Mapping Setup FastTab, click on the TSRD BPIA Data Mapping entry.
• The Data Mappings table is opened. Please add the corresponding mappings for the GRANIT XML files as per the following table, so that the purchase order file can be processed:

• Your entries will be saved automatically.
• Close the Data Mappings table.
• If the Finalized checkbox is not yet selected, click on the Finalize Setup button in the menu bar of the Mapping Setup FastTab. The color of the TSRD BPIA Data Mapping entry must be green.
• Proceed with the Business Partner Setup.

Business Partner Setup

It is necessary to map the Microsoft Dynamics 365 Business Central vendor to the actual GRANIT company, or multiple vendors to their corresponding GRANIT companies, in a multi-vendor environment. To set up business partners, please proceed as follows:

• Use the quick search (ALT+Q) to find the Business Partners page.
• Open the GRANIT Integration App entry.
• In the menu bar of the Business Partner page, click on the Relations button.
• In the Business Partner Relations table, proceed as follows:
  • In the Relation Type column, select Vendor.
  • In the Relation No. column, select the vendor number for the GRANIT business partner.
  • The Description column is automatically filled and cannot be changed.
  • Repeat these steps for all GRANIT business partners, if applicable.
• Close the Business Partner Relations table.
• Proceed with the Integration Module Setup.

Integration Module Setup

Next, the integration module must be set up for the GRANIT Integration App entry. Please proceed as follows:

• Select the entry and, in the menu bar of the Business Partner page, click on the Integration Modules button.
• Open the CUSTOMERSALESORDER entry.
• On the Integration Module page, proceed as follows:
• In the Interface FastTab, select the following values:
  • Interface Type = GRANIT Customer Sales Order
  • Storage Type = Azure Blob Storage
• In the Parameters FastTab, enter the following information in the Value field to prepare the interface:

• In the menu bar, click on Activate to activate the integration module.
• You can close all pages.

You have successfully set up the mapping, business partner, and integration module for the interface. Please proceed with the next step in the Setting up GRANIT Interfaces section to activate it.