Set up Adobe Commerce provider

This article describes how to set up the Adobe Commerce provider in Microsoft Dynamics 365 Intelligent Order Management.

Adobe Commerce (formerly Magento) is an e-commerce platform that is designed to give online businesses a flexible shopping cart system, and enable them to manage the appearance, content, and features of an online store.

For more information about Adobe Commerce, see Adobe Commerce.

Prerequisites

To set up the Adobe Commerce provider, you must have a sample store set up. For information about how to set up your account and sample store, see Cloud guide for Commerce.

Set up the provider

To set up the provider, follow these steps.

1. In Intelligent Order Management, go to Providers > Catalog.

2. On the Adobe Commerce tile, select Add Provider.

3. On the Terms and Conditions page, select Create.

4. In the Connections section, you must set up two connections:

   • Adobe Commerce Dataverse (current environment) Connection
   • Adobe Commerce connection:

   To set up each connection, follow these steps:

   1. Select the connection.

   2. Select Create.

   3. Enter the following information:

      • Connection Name – Enter a name of your choice.
      • API Key – Enter the Adobe Commerce API key.
      • Store Host URL – Enter the Adobe Commerce Store Host URL.

   4. Select Create.

   5. Save the connection.

   6. Select Activate to activate the connection.

   7. Select Save and close.

5. Select Activate to activate the provider.

6. Select Save and close.

7. Go to Providers > Installed, and validate that the provider that you set up is listed and has a status of Activated.

Out-of-box capabilities

The Adobe Commerce provider has the following capabilities.

Capability	Details
Transformation	Adobe Commerce Sales Order to Dataverse Sales Order – Transform a sales order from Adobe Commerce into a sales order in Dataverse.
Transformation	Adobe Commerce Customer to Dataverse Account – Transform an Adobe Commerce customer into an account in Dataverse.
Transformation	Dataverse Sales Order Status to Adobe Commerce Order Status – Send the order update status back to Adobe Commerce.

Run a sample transaction by using Adobe Commerce

After your store is set up, you're ready to run a sample transaction by using Adobe Commerce. To set up data for the sample transaction, complete the following procedures in Adobe Commerce and Intelligent Order Management.

Create a customer in Adobe Commerce

First, you must set up a customer in Adobe Commerce.

To set up a customer in Adobe Commerce, follow these steps.

1. In Adobe Commerce, open the Customer page.
2. Select Add New Customers.
3. Enter details for the customer.
4. In the Customer email field, enter the customer's email address. Then select Save.
5. Add Customer Address Details.
6. Enter the customer's address information, and then select Save Customer.
7. To use the customer for a transaction, you must sign out of Adobe Commerce and then sign back in.

Configure the mappings in Intelligent Order Management

• In Intelligent Order Management, in the lower-right corner of any page, change the area from IOM to Configurations.

  Note

  If you use a left-to-right (LTR) language, the setting is in the lower-left corner.

Set up price list mapping

Next, you must set up price list mapping.

To set up price list mapping, follow these steps.

1. Go to Mappings > Price Lists.

2. Select New.

3. On the New Price List Mapping page, enter the following information:

   1. In the Mapping Group field, enter Default Mapping Group.
   2. In the Account field, select the account that you created (if you created one).
   3. In the Price list field, enter MasterPriceList.
   4. In the External Field Name field, enter ProviderName.
   5. In the External Field Value field, enter Adobe Commerce.

4. Select Save and close.

Set up unit mapping

After you set up price list mapping, you must set up unit mapping.

To set up unit mapping, follow these steps.

1. Go to Mappings > Units.

2. Select New.

3. On the New Unit Mapping page, enter the following information:

   1. In the Mapping Group field, enter Default Mapping Group.
   2. In the Account field, select the account that you created (if you created one).
   3. In the Unit field, enter ea.
   4. In the External Field Name field, enter unit.
   5. In the External Field Value field, enter each.

4. Select Save and close.

Set up product mapping

Next, you must set up product mapping.

To set up product mapping, follow these steps.

1. Go to Mappings > Products.

2. Select New.

3. On the New Product Mapping page, enter the following information:

   1. In the Mapping Group field, enter Default Mapping Group.
   2. In the Account field, select the account that you created (if you created one).
   3. In the Product field, enter Airport Duo.
   4. In the External Field Name field, enter productid.
   5. In the External Field Value field, enter WS03-XS-Red.

4. Select Save and close.

Create an order in Adobe Commerce

Next, you must create an order in Adobe Commerce and submit it to Intelligent Order Management.

To create an order in Adobe Commerce, follow these steps.

1. Sign in to the Adobe Commerce store account that you previously set up.

2. Go to Sales > Orders, and select Create New Order.

3. In the list of customers, double-tap (or double-click) the customer that you created earlier.

4. Select Add Products By SKU or Add Products, enter the product that you set up in Intelligent Order Management, and then select Enter.

5. Scroll down, select Get shipping methods and rates, and then select either Table rate or Fixed Rate.

6. Select Submit Order. An order ID is generated.

   Note

   Adobe Commerce order IDs aren't unique.

7. To view the order, go to Sales > Orders.

View an Adobe Commerce order in Intelligent Order Management

To view the results of the orchestration and the flow, follow these steps.

1. In Intelligent Order Management, go to Sales Orders. Your Adobe Commerce order is shown in the Name column.
2. Select the order number to view the summary.
3. Select the Orchestration Step Results tab to view the results.

Additional resources

• Adobe Commerce API documentation.