Commerce asynchronous document framework

Note

The Retail Interest Group by Dynamics 365 Commerce has moved from Yammer to Viva Engage. If you don't have access to the new Viva Engage community, fill out this form (https://aka.ms/JoinD365commerceVivaEngageCommunity) to be added and stay engaged in the latest discussions.

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 timeouts or failures. These improvements require the use of an asynchronous document framework.

When you use an asynchronous document framework, 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 couldn't 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

Important

You must configure an asynchronous document framework before a company can 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 problems.

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

Note

In Commerce version 10.0.13 and later, you don't have to configure these batch jobs through the batch job framework. Instead, you can configure the batch processes 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.

Use the batch jobs to process documents that fail or time out. Use them when the number of active inventory documents that are processing 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