The Order Submission Microservice is used to transfer order information from Intershop Commerce Management (ICM) to Microsoft Dynamics 365.
This document provides important product information, including version information and dependencies. It also outlines the basic setup and configuration steps.
|Intershop Commerce Management||Microsoft Order Submission Microservice|
The source code can be downloaded from https://repository.intershop.de//mvn-ordersubmission-releases/.
The order submission connector is implemented as Microservice.
Setup instructions can be found at Cookbook - Microservice Deployment and Cookbook - Eureka Deployment and ICM Configuration.
More details can also be found in Recipe - Configure the Microservice .
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
Configuration for the number of threads used to process requests from ICM:
# Concurrency configuration
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.ordersubmission.mapping.payment.method.<icm-name>=<dyn365-name>
intershop.ordersubmission.mapping.payment.method.ISH_INVOICE=ELECTRONIC intershop.ordersubmission.mapping.payment.method.ISH_CASH_ON_DELIVERY=CASH_DELIV intershop.ordersubmission.mapping.payment.method.ISH_CASH_IN_ADVANCE=CASH_ADV
The referenced payment methods have to be created and configured before in Dynamics 365.
Configuration for routing an order from a specific ICM Organization/Channel to a certain Legal Entity in Microsoft Dynamics 365 for Finance and Operations:
# Order routing configuration
intershop.ordersubmission.order.routing.1.icm.urn.pattern=urn:order:ICM:inSPIRED:inTRONICS intershop.ordersubmission.order.routing.1.backend.system.ID=XYZ.dynamics.com intershop.ordersubmission.order.routing.1.backend.system.tenant=demf intershop.ordersubmission.order.routing.1.backend.system.URL=XYZ.dynamics.com
In order to connect the Order Submission Microservice with the ICM, a managed order submission 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):
Microservice URI e.g., Eureka service URI 'service://orderSubmission'.
ICM exposes a complete but generic order in JSON format. This means that the order contains all available data as well as data that is stored at the order and its line items in the context of a customization.
The communication between ICM and the Microservice is asynchronous in order to avoid timeouts due to the fact that the Microservice has to create an order in Microsoft Dynamics 365 for Finance and Operations using several requests.
The Microservice splits the generic order provided by ICM into several OData requests for the following OData entries of Microsoft Dynamics 365 for Finance and Operations:
The communication between the Microservice and Microsoft Dynamics 365 for Finance and Operations is synchronous.
The following table lists supported data mappings/workflows between ICM and Microsoft Dynamics 365 for Finance and Operations as well as limitations. These limitations mainly origin from the fact that Microsoft Dynamics 365 for Finance and Operations does not support numerous standard features provided by ICM:
|Bundle||(X)||For bundle products that exist in Microsoft Dynamics 365 for Finance and Operations. No bundle products information is passed to Microsoft Dynamics 365 for Finance and Operations.|
|Product Net Price||X|
|Product Gross Price||-||Microsoft Dynamics 365 for Finance and Operations supports only net prices.|
|Line Item based Discounts||(X)||Indirect via discounted single base and line item price. No promotional discount related information is passed to Microsoft Dynamics 365 for Finance and Operations.|
|Order based discounts||-|
|Hidden Gifts||X||No information that this is a hidden gift is passed to Microsoft Dynamics 365 for Finance and Operations.|
|VAT based countries||X|
|none-VAT based countries (e.g., U.S., Canada)||-|
|Product related warranties||-|
|Payment||Methods of payment have to be created in Microsoft Dynamics 365 for Finance and Operations and mapped to related ICM's payment methods by Microservice configuration.|
|Invoice||X||By passing the (configurable) ID of the payment method.|
|Cash in Advance||X||By passing the (configurable) ID of the payment method.|
|Cash on Delivery||X||By passing the (configurable) ID of the payment method.|
|Redirecting Payment (e.g., Paypal, Klarna, Credit Card via. Token Provider)||(-)||Supported in ICM, but no transfer of payment related transaction and history data to Microsoft Dynamics 365 for Finance and Operations.|
|Ship-to address||X||On line item level (|
|Invoice-to address||X / -||For unregistered users only. Address is stored in |
|Shipping Buckets||X / -||Support for different ship-to addresses on line item level. No support for line items with different shipping methods in one order (Limitation of Microsoft Dynamics 365 for Finance and Operations).|
|Shipping Method||X||Shipping carriers have to be created in Microsoft Dynamics 365 for Finance and Operations and mapped to ICM's shipping methods by Microservice configuration.|
|Surcharges||-||No surcharges are passed to Microsoft Dynamics 365 for Finance and Operations.|
|Desired Delivery Date||X|
|Order Totals||(-)||Totals are not passed to Microsoft Dynamics 365 for Finance and Operations. Total amounts are calculated by a scheduled job in Microsoft Dynamics 365 for Finance and Operations. According to Microsoft, there has been a new version since spring 2018 that supports totals passed via OData.|
|Unregistered Customer||X||New customer is created from One-Time-Customer template in Microsoft Dynamics 365 for Finance and Operations.|
|Registered Customer||(X)||For existing customers in Microsoft Dynamics 365 for Finance and Operations only. These customers and contacts have to be created manually in Microsoft Dynamics 365 for Finance and Operations or by the Customer Connector before.|
|Orders created as a result of registered checkout||X|
|Orders created as a result of unregistered checkout||X|
|Order Creation Date||(X)||Order creation date is stored in |
|Recurring Orders||X||Maintained and triggered by ICM.|
|Message to Merchant||-|
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.