Overview

The Znode Commerce Connector provides native (out-of-the-box) data exchanges for integrating with Microsoft Dynamics 365 Finance & Supply Chain Management (F&SCM). These exchanges are available through the Add From Library option and allow data to be synchronized between F&SCM and Znode without building custom integrations.

Native exchanges include preconfigured source, destination, and YAML mappings, allowing organizations to quickly configure the connection and begin importing data into Znode.

Prerequisites

Before configuring any F&SCM data exchange, ensure the following information is available.

Available Data Exchanges

The following native exchanges retrieve data from F&SCM and import it into Znode.

Adding an F&SCM Data Exchange

1. Navigate to Commerce Connector → Manage Commerce Connector.
2. Click Add From Library.

1. Select the required F&SCM data exchange.

1. Click Add.
2. Configure the connection using:
   • Endpoint
   • Access Token URL
   • Client ID
   • Client Secret
   • Scope
3. Save the configuration.
4. Review the Mapping configuration.
5. Run the data exchange.

Understanding Data Exchange Components

Each F&SCM data exchange consists of the following sections.

Proper mappings ensure that data is imported accurately and populated into the correct destination fields.

Data Exchange Use Cases

Product Import (Simple and Configurable Products)

Purpose

Imports product information from F&SCM into Znode, allowing organizations to synchronize their product catalog between the two systems.

Configuration Overview

• Source Configuration – Retrieves product data from F&SCM.
• Destination Configuration – Imports product data into Znode.
• Mapping Configuration – Maps F&SCM product fields to Znode product fields.

Price Import

Purpose

Imports pricing information from F&SCM into Znode to keep pricing synchronized.

• Source Configuration – Retrieves pricing data.
• Destination Configuration – Imports pricing into Znode.
• Mapping Configuration – Maps pricing fields.

Category Import

Purpose

Imports category information from F&SCM into Znode.

• Source Configuration – Retrieves category data.
• Destination Configuration – Imports category data.
• Mapping Configuration – Maps category fields.

Inventory Import

Purpose

Imports inventory information from F&SCM into Znode.

• Source Configuration – Retrieves inventory data.
• Destination Configuration – Imports inventory into Znode.
• Mapping Configuration – Maps inventory fields.

Account Import

Purpose

Imports customer account information from F&SCM into Znode.

• Source Configuration – Retrieves account data.
• Destination Configuration – Imports account data into Znode.
• Mapping Configuration – Maps account fields.

Monitoring Exchange Execution

Data Exchange Logs

Review the Data Exchange Logs after each execution to verify whether the data exchange completed successfully.

Znode Import Logs

Znode Import Logs are generated only for exchanges that use the Znode Import process.

These logs indicate whether imported records were successfully processed.

To view import errors

1. Open the Import Log.
2. Click the View Details (Eye) icon.
3. Review the reported error.
4. Correct the source data or mapping configuration.
5. Run the data exchange again.

Mapping Configuration

The Mapping Configuration defines how data retrieved from Microsoft Dynamics 365 Finance & Supply Chain Management is mapped to fields in Znode.

Mapping Structure

Purpose

The mapping configuration is used to:

• Match source fields to destination fields.
• Transform data between systems.
• Ensure accurate synchronization.
• Support data validation during import.

Example

The following example illustrates how F&SCM fields can be mapped to corresponding Znode fields during an Inventory Import.

Important Considerations

• Ensure all required Znode fields are mapped before running the data exchange.
• Verify that the source and destination field data types are compatible.
• Review the mapping configuration whenever changes are made to the source or destination data structure.
• Validate mappings before executing imports in a production environment.

Important Note on Preconfigured Mappings

All native data exchanges include preconfigured YAML mappings designed to support common implementation scenarios.

The connector provides out-of-the-box mappings only for the predefined attributes included in the standard Znode Product Template. Since custom attributes are implementation-specific and vary based on business requirements, they are not included in the default mapping configuration.

To import data for custom attributes, the corresponding field mappings must be configured manually in the Mapping section before running the data exchange.

The out-of-the-box YAML mapping is configured only for fields that receive data from the source API. Fields that are not populated by the API are included in the mapping configuration with empty mappings 

Known Limitations

• Mapping requirements may vary depending on the Microsoft Dynamics 365 Finance & Supply Chain Management implementation and data model.
• Additional custom attributes require manual mapping configuration.
• When using Transmission Mode – Znode Import with the Default Product Template, the connector automatically maps only the predefined product attributes listed below.

Troubleshooting

Summary

The native Microsoft Dynamics 365 Finance & Supply Chain Management data exchanges provide an efficient way to synchronize products, pricing, inventory, categories, and customer accounts with Znode. The preconfigured YAML mappings simplify implementation while allowing customization to meet specific business requirements. Before deploying to production, review and validate all mappings to ensure that the required data is imported successfully.