Commerce asynchronous document framework

This article describes the capabilities and configurations of an asynchronous document framework in Microsoft Dynamics 365 Commerce.

Store inventory operations such as Inbound, Outbound, Stock Count, Adjustment, and Movement include performance improvements to ensure that users who have high volumes of receipt postings across many stores or companies, and large inventory documents, can process those documents to Commerce headquarters without experiencing time-outs or failures. These improvements require the use of an asynchronous document framework.

When an asynchronous document framework is used, you can commit inventory document changes from point of sale (POS) to Commerce headquarters and then move on to other tasks while the processing to Commerce headquarters occurs in the background. You can check the status of a document through each operation's document list page in POS to confirm that posting was successful. In the POS application, you can also use each operation's document list to see any documents that could not be posted to Commerce headquarters. If a document fails, POS users can make corrections to it and then try again to process it to Commerce headquarters.

Configure an asynchronous document framework


An asynchronous document framework must be configured before a company tries to use the store inventory operations in POS.

To configure an asynchronous document framework, complete the following procedures.

Create and configure a number sequence

To create and configure a number sequence, follow these steps.

  1. Go to Organization administration > Number sequences > Number sequences.
  2. On the Number sequences page, create a number sequence.
  3. In the Number sequence code and Name fields, enter user-defined values.
  4. On the References FastTab, select Add.
  5. In the Area field, select Commerce parameters.
  6. In the Reference field, select Retail document operation identifier.
  7. On the General FastTab, in the Setup section, set the Continuous option to No to ensure that there are no performance issues.

Create and schedule two batch jobs for the document processing and monitoring tasks


In Commerce version 10.0.13 and later, you don't have to configure these batch jobs through the batch job framework. Instead, the batch processes can be configured in Commerce headquarters, at Retail and Commerce > Retail and Commerce IT. Use the Retail document operation monitor and Retail document operation processing menu options to configure the batch jobs.

The batch jobs that you create will be used to process documents that fail or time out. They will also be used when the number of active inventory documents that are being processed from POS exceeds a system-configured value.

To create and schedule two batch jobs for the document processing and monitoring tasks, follow these steps.

  1. Go to System administration > Inquiries > Batch jobs.

  2. On the Batch job page, create two batch jobs:

    1. Configure one job to run the RetailDocumentOperationMonitorBatch class.
    2. Configure the other job to run the RetailDocumentOperationProcessingBatch class.
  3. Schedule the new batch jobs to run on a recurring basis. For example, set the schedule so that the jobs run every five minutes.

Additional resources

Inbound inventory operation in POS

Outbound inventory operation in POS