BeyondERP.Newsletter
Menu

Job page · Sales and marketing

Dynamics 365 Sales integration message processor

A periodic job that processes the messages in the Dynamics 365 Sales Integration queue.

Business process
Manage background jobs
Menu item
action:TradeCDSMessageProcessor
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA periodic job that processes the messages in the Dynamics 365 Sales Integration queue.
What you do hereUse this periodic task to handle Dynamics 365 Sales integration events in the background, so users don't have to wait for each request to finish.
ExampleFor example, BEAT sets Create quotation journal in batch to Yes; when a sales representative activates quotation QT-000410 in Dynamics 365 Sales, a Create sales quotation journal message is queued, and the recurring job running every 5 minutes processes it with Messages per task = 50.
Dynamics 365 Sales integration message processor page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processManage background jobs
Menu pathSales and marketing › Periodic tasks › Dynamics 365 Sales integration message processor
Set up firstUse message processor Microsoft Learn
Used next byMessage processor messages Microsoft Learn
Related pagesMessage queue setup Microsoft Learn Calculate sales order totals for Sales Microsoft Learn
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

When to run it

When to run itWhen you use asynchronous processing for the Dynamics 365 Sales integration, such as pushing totals or creating quotation journals in batch.
How oftenContinuously, as a recurring batch job, for as long as the integration uses the message queue.
Batch settingsSet it up as a recurring batch job; it processes only the Dynamics 365 Sales Integration queue. Avoid a very low Messages per task, which creates many small tasks.
What the output showsMessages in the Dynamics 365 Sales Integration queue are processed, for example Calculate and push totals for sales order or Create sales quotation journal. Messages that stay queued usually mean the batch job isn't running; failed ones show on Message processor messages.

Source: Microsoft Learn

Setup steps on this page

Schedule the Sales integration message processor

Process Dynamics 365 Sales integration events in the background so users don't wait.

Steps from Microsoft

  1. Go to Sales and marketing > Periodic tasks > Dynamics 365 Sales integration message processor.
  2. Check that Use message processor is on in Accounts receivable parameters > Dynamics 365 Sales integration; without it nothing is queued.
  3. On the Run in the background FastTab, set a recurrence for the Dynamics 365 Sales Integration queue and select OK.
  4. In Accounts receivable parameters, set Messages per task so one task runs one to two minutes; 50 usually works.
  5. Open Message processor messages, filter on the Dynamics 365 Sales Integration queue, and requeue or cancel failed messages.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExample
Run in the backgroundHow, when and how often the Dynamics 365 Sales Integration queue is processed, as for other batch jobs.Microsoft Learn
Messages per taskOn Accounts receivable parameters: the most messages one task processes; aim for one to two minutes per task, 50 usually works, 0 means 30.Microsoft Learn 50

Common errors and fixes

MessageWhat to do
Messages stay in Queued state.Schedule this batch job so it runs regularly; it is what processes the Dynamics 365 Sales Integration queue. Microsoft Learn
A message has the state Failed.Select it on Message processor messages, read the Log tab, fix the cause, and process or requeue it. Microsoft Learn

Test checklist

  1. No messages stay in Queued status for long on Message processor messages.
  2. Totals pushed from Supply Chain Management appear on the order in Dynamics 365 Sales.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Schedule the Sales integration message processorRecurring batch job for the Dynamics 365 Sales Integration queue, with Messages per task set so a task runs one to two minutes (50 usually works).The job processes only that queue; a very low Messages per task creates many small tasks and adds overhead.What value for Messages per task?Turning on Use message processor without scheduling this job, so quotation journals and pushed totals stay queued.Test: Queued Sales messages are processed

Feature management and licence

Feature to turn onIntegrate Sales Quotation lifecycle with Dynamics 365 SalesProcess Dynamics 365 Sales integration related events
Licence or add-inOn the live system, Sales manager runs this job. Use message processor needs the features Integrate Sales Quotation lifecycle with Dynamics 365 Sales and Process Dynamics 365 Sales integration related events; both are on by default from 10.0.41 and mandatory from 10.0.43.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyOnly the Dynamics 365 Sales Integration message queue. Microsoft Learn
Can it be undoneNo: Processed messages have already updated Supply Chain Management and Sales; correct the documents themselves. Failed messages can be requeued or canceled on Message processor messages. Microsoft Learn
If you change it laterProcesses queued integration messages, which create quotation journals, link orders to quotations and push prices and totals to Dynamics 365 Sales. Microsoft Learn
Technical architect

6Technical

Menu itemaction:TradeCDSMessageProcessor Checked in Dynamics 365
FormDialog Checked in Dynamics 365
Roles to set it up and use itTo use itSales manager TradeSalesManagerGive people one of these roles. On this system, 1 role can run this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=action:TradeCDSMessageProcessor
Data migrationLoad order: Dynamics 365 Sales integration message processor has no data entity in Data management. It processes queued messages; there is nothing to migrate.Checked in Dynamics 365
Everyone

8Sources