Order Management System for Adobe Commerce

Adobe Commerce feature Exclusive feature only in Adobe Commerce (Learn more)

Learn how to manage your stock aggregates and the Order Management integration, available if you use the Order Management System (OMS) Connector with Adobe Commerce, as well as view both the message log and changelog.

MCOM menu

If you use the Order Management System (OMS) with Adobe Commerce, an MCOM option is available in the left menu of the Admin.

With this MCOM option, you can manage stock aggregates and integrations, and access both the message log and changelog.

To display the MCOM menu:

On the Admin sidebar, choose MCOM.

MCOM menu

Manage stock aggregates

Manage Stock Aggregates provides information about existing stock aggregates, and allows you to add new stock aggregates or edit or delete existing ones.

Manage Stock Aggregates

You create sources and aggregates in the Order Management System (OMS) Admin. Then you assign which websites are associated with each aggregate via Manage Stock Aggregates in the Adobe Commerce Admin.

Add a stock aggregate

  1. On the Admin sidebar, go to MCOM > Manage Stock Aggregates.

  2. Click Add New Stock Aggregate.

  3. Enter a Stock code (name) for this stock aggregate.

    NOTE

    The stock code that you enter should match the stock aggregate code in the OMS.

  4. Choose a Website from the populated list.

  5. When complete, click Save Stock Aggregate.

    Create new stock aggregate

Edit or delete a stock aggregate

  1. On the Admin sidebar, go to MCOM > Manage Stock Aggregates.
  2. In the Action column, click Edit for an existing stock aggregate.
  3. To edit the stock aggregate, revise the Stock code or Website information and click Save Stock Aggregate.
  4. To delete the stock aggregate, click Delete and then click OK in the confirmation dialog that appears.

Message log

Message Log enables you to view message processing logs, message history, and full error traces for the Connector.

Message Log

Enable message performance logs

  1. Log into the Adobe Commerce Admin.
  2. On the Admin sidebar, go to Stores > Settings > Configuration.
  3. In the left panel, expand MCOM Connector and choose Configuration.
  4. Scroll down to the Performance Monitor section and enable desired New Relic or Logger Output options.
  5. Click Save Config.

See the Message performance section of the Views logs topic in the Order Management System (OMS) documentation for more information about what metrics are available out-of-the-box, an example log file, and more.

View message processing logs

  1. On the Admin sidebar, go to MCOM > Message Log.

  2. Click Filters and add any search criteria you want to employ, such as Topic (message) and direction (ingoing or outgoing).

  3. Click Apply Filters to see your query results.

    Apply filters for your search query

  4. Click View for the message that you want to view.

    The Details view for that message appears, including information about the message body and other related history.

  5. If the message was processed with an error, you can click within the History section to see a full error trace.

    Click the History section to see a full error trace

Information about fatal errors is in the apache/nginx error log (the same place logs are located for the Connector-less Adobe Commerce installation).

If you are working in Developer mode, all errors are visible on your screen.

Retry a topic (message)

You can retry a failed topic (message) in Message Log.

  1. On the Admin sidebar, go to MCOM > Message Log.

  2. To determine whether a topic was successful, see the Status column.

    Successful topics show a SUCCESS status.

  3. In the leftmost column, select the checkbox for the topic you want to retry.

  4. Click Actions and select Retry.

    The topic (message) is resubmitted.

    Retry a topic (message)

Integration

Integration enables you to add or disable the Order Management System (OMS) integration for Adobe Commerce and view details of the integration.

Register the integration

  1. On the Admin sidebar, go to MCOM > Integration.
  2. Click Register to register the MCOM (also known as OMS) integration.

Disable or enable the integration

  1. On the Admin sidebar, go to MCOM > Integration.

  2. Check the status of the integration in the Status row—either Enabled or Disabled.

    • To enable a disabled integration, click Enable. A confirmation message appears to inform you the integration has been enabled.
    • To disable an enabled integration, click Disable. A confirmation message appears to inform you the integration has been disabled.

    Disable or enable integration

Changelog

On the Admin sidebar, go to MCOM > Changelog. You are immediately redirected to the Adobe Commerce version 2.2 Connector changelog. Change the version number in the URL to 2.3 to access the 2.3 Connector changelog.

Export full catalog

You can manually request a full catalog export from Adobe Commerce. This feature queues all products from the catalog for export to the Order Management System (OMS).

Outside of manually exporting the full catalog, products are added to this queue after a new product is created, an existing product is updated, or after a bulk update to product attributes.

When requested, these outgoing messages are exported to a .csv file in chunks of 5,000.

To export the full catalog:

  1. On the Admin sidebar, go to Catalog > Products.

  2. Click Export Full Catalog.

    Export Full Catalog

  3. Click OK in the confirmation dialog.

    A progress bar appears to show the status of the requested catalog export. When the export is complete, a confirmation message appears to confirm the action.

To manually export the catalog from the command line, see the Export full catalog section of the OMS Connector documentation.

On this page