Public Release Note - D365 Finance and Operations Order History Connector 1


The Order History Microservice is used to transfer order information from Microsoft Dynamics 365 to Intershop Commerce Management (ICM).

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


Version Information and Dependencies

Intershop Commerce ManagementMicrosoft Order Submission Microservice -

The source code can be downloaded from


The order history connector is implemented as Microservice.

To familiarize yourself with the concepts, please refer to Overview - Microservices and Overview - Service Registration and Discovery.

Setup instructions can be found at Cookbook - Microservice Deployment (valid to 7.10) and Cookbook - Eureka Deployment and ICM Configuration (valid to 7.10).


Following configuration data has to be provided to Order History Microservice. Currently the properties have to be specified in a file that is within the Java classpath of the Microservice.

Azure Active Directory Credentials Configuration

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

# Azure Active Directory credentials

Concurrency Configuration

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

# Concurrency configuration

Payment Methods Mapping Configuration

How the methods of payment in Microsoft Dynamics 365 are mapped to Intershop payment methods can be extended and adjusted in the file

Configuration for mapping of ICM payment methods to related ones specified in Microsoft Dynamics 365 for Finance and Operation's Contoso demo:

# Payment method mapping configuration
# pattern: intershop.orderhistory.mapping.payment.method.<dyn365-name>=<icm-name>

The referenced payment methods have to be created and configured before in Dynamics 365 and ICM.

Managed Service Configuration

In order to connect the Order History Microservice with the ICM, a managed order history service has to be configured.


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) are connected to the same Dynamics 365 tenant, you can also create the managed service at organization level and enable sharing.

To 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 order history service (and enable sharing).
  3. Set the order history service specific settings:
    • Microservice URI e.g., Eureka service URI 'service://orderHistory'.

Feature Overview

All orders of a customer will be displayed in the order list in the My Account section.

FeatureDisplayedAdditional Notes
List Viewx
Detail View


  • Standard Microsoft Dynamics 365 is used for the mapping.
  • All users of a customers can see all orders of the customer in the My Account section. No user order list view is available.
  • Order details will not be displayed in the My Account section.
  • Order Totals cannot currently be displayed without executing a job in the Dynamics back-office first (job "Calculate sales totals"). Before this job is triggered, all totals will be displayed as 0.

Known Issues


Version 2.0.0

  • Renaming of several attributes of resource objects in ICM backend API.

Version 1.0.0

  • Initial version

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.
The Intershop Knowledge Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties. Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to if you experience login issues,
or if you want to register as customer.