Public Release Note - D365 Finance and Operations Inventory Connector 1


1 Introduction

The inventory connector is used to get stock information from Microsoft Dynamics 365 for Finance and Operations and show it in Intershop Commerce Management (ICM).

This release note provides important product information, including version information and dependencies. It also outlines the basic setup and configuration steps.

1.1 References

1.2 Version Information and Dependencies

Intershop Commerce ManagementIntershop D365 Finance and Operations Inventory Connector

7.10.3+

1.0.0

The D365 Finance and Operations Inventory Connector consists of the following microservices:

  • Inventory Microservice
  • Prefetcher Microservice

The source code can be downloaded from https://repository.intershop.de//mvn-inventoryconnector-releases/.

Info

The connector works with standard, un-customized Microsoft Dynamics 365 for Finance and Operations.

2 Feature Overview

The Inventory Connector consists of two microservices: One for cached inventory calls and one for uncached calls.

The cache retrieves inventory information from Dynamics 365 Finance and Operations (e.g., all 15 minutes). This data is used for storefront browsing and the checkout, because it is fast. However, when the order is created (i.e., the customer clicks "Submit Order"), the uncached inventory call is used. It retrieves the data directly from Dynamics 365 and is a bit slower. It prevents the creation of orders with products which just got out of stock. Additionally the inventory cache is updated with live data from uncached calls.

The inventory connector retrieves inventory information from the "on hand inventory" from Dynamics 365.

2.1 Communication Schema - ICM - Inventory Connector Microservice

ICM makes a request in JSON format containing product SKU(s) and warehouse. The microservice returns a response for "on hand inventory" of the requested product(s).

The communication between ICM and the Microservice is synchronous.

2.2 Communication Schema - Inventory Connector Microservice - Microsoft Dynamics 365 for Finance and Operations

Once the microservice receives a request from the ICM, the inventory amount will be returned from the caching microservice (e.g., for product lists and product details pages) or directly from MS Dynamics 365 via link (when creating an order).

The communication between the microservice and Microsoft Dynamics 365 for Finance and Operations is synchronous.

3 Setup

The inventory connector is implemented as microservice.

To familiarize yourself with the concepts, please refer to:

Setup instructions can be found at:

Note

The Inventory Connector consists of two microservices. Both have to be deployed separately.

4 Configuration

4.1 Inventory Microservice Configuration

The following configuration data has to be provided to the Inventory Microservice. Currently the properties have to be specified in a file that is located within the Java classpath of the Microservice, see Cookbook - D365 Finance and Operations Inventory Connector.

4.1.1 Azure Active Directory Credentials Configuration

The configuration for getting an access token from Azure Active Directory (AAD) is necessary for OData access to Microsoft Dynamics 365 for Finance and Operations:

Azure Active Directory Credentials Configuration
# Azure Active Directory credentials
intershop.inventory.azure.resource=
intershop.inventory.azure.tenant=
intershop.inventory.azure.clientID=
intershop.inventory.azure.clientSecret=
intershop.inventory.azure.token.requestURL=
intershop.inventory.azure.token.minimumTTL=

4.1.2 Concurrency Configuration

Configuration for the number of threads used to process requests from ICM:

Concurrency Configuration
# Concurrency configuration
#intershop.inventory.threadPool.size=

4.2 Prefetcher Microservice Configuration

Only little configuration is needed for the Prefetcher Microservice. Once the Prefetcher is up and running in Eureka, the Inventory Microservice will detect it and will use its functionality and configuration.

4.2.1 Tenant Configuration

Configuration for the Microsoft Dynamics 365 for Finance and Operations tenant (organization):

Tenant Configuration
# Tenant configuration
intershop.inventory.caching.routing.1.backend.tenant=

4.2.2 Other Configuration

Configuration of how often the inventory in the cache is updated:

Other Configuration
intershop.inventory.time.unit.to.refresh.cache=M/S/H
intershop.inventory.time.interval.for.inventory.cache.scheduler=15

4.3 Managed Service Configuration

To connect the Inventory Microservice with the ICM, a managed inventory service must be configured.

Note

The microservice allows configuration of one Dynamics 365 tenant. If this maps to one ICM sales channel, create the managed service at channel level.

If multiple sales channels (within one ICM organization) use inventory data from the same Dynamics 365 tenant, you can also create the managed service at organization level and enable sharing.

Note

Creating a managed inventory service for a sales organization or a sales channel requires the access privilege System Manager for this organization resp. channel.

Create a service configuration (set technical configuration).

  1. Go to the Commerce Management application: Sales Organization | Services.
  2. Create a new service configuration for the inventory service (and enable sharing).
  3. Set the inventory service specific settings:
    • WarehouseID

    • Organization (tenant)

Note

To prevent some strange behavior you should make standrad inventory service DISABLE, UNSHARE, INACTIVE.

5 Limitations

  • The microservice can be used for connecting one ICM sales channel to one D365 Finance and Operations organization (tenant). Multi-tenant capabilities are not implemented yet.

6 Known Issues

No known issues.

7 Changelog

7.1 Version 1.0.0

Initial version

Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources
Support Tickets