BeyondERP.Newsletter
Menu

Setup step on the Inbound queue cleanup page · Material handling equipment interface

Clean up the inbound queue

Remove processed inbound queue items on a schedule so the queue doesn't keep filling up.

Business process
Manage warehouse operations
Menu item
WMHEInboundQueueCleanup
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA periodic cleanup task that removes inbound queue items that have already been processed.
What you do hereUse this page to remove processed items so that the inbound queue doesn't keep filling up.
ExampleFor example, you schedule the job weekly on Sunday at 02:00 with The number of days to keep = 30 and Delete errored records = No, so processed inbound events older than 30 days are removed and errored events stay until someone reprocesses them.
Inbound queue cleanup 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

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 the inbound queue fills up with items that were already processed.
How oftenRegularly, as a recurring batch job, once you know how much inbound history you need.
Batch settingsRun it in the background as a recurring job outside peak warehouse hours.
What the output showsProcessed inbound queue items older than the days you entered are deleted, and errored ones too if you chose that. Errored items that disappeared without being fixed mean Delete errored records was set to Yes.

Source: Microsoft Learn

Setup steps on this page

Clean up the inbound queue

Remove processed inbound queue items on a schedule so the queue doesn't keep filling up.

Steps from Microsoft

  1. Go to Material handling equipment interface > Periodic tasks > Cleanup > Inbound queue cleanup.
  2. In The number of days to keep, enter how many days of processed inbound items to keep.
  3. Set Delete errored records to Yes only if errored events that were never reprocessed may also be deleted.
  4. Run it, then use the Queue manager workspace to confirm that the inbound queue is smaller and recent items are still there.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExample
The number of days to keepHow many days of processed inbound queue items to keep; older processed items are deleted.Microsoft Learn 30
Delete errored recordsWhen Yes, errored inbound events are deleted as well, with their error logs, even if they were never reprocessed.Microsoft Learn No
Run in the backgroundRuns the cleanup as a batch job, once or on a recurrence.Microsoft Learn

Common errors and fixes

MessageWhat to do
Errored events disappeared before anyone reprocessed themDelete errored records was Yes. Deleted items can't be restored; set it to No and reprocess or resolve errored events first. Microsoft Learn
The queue pages are slow and the queue keeps growingThe cleanup isn't scheduled. Schedule it as a recurring batch job with a retention agreed with the warehouse. Microsoft Learn

Test checklist

  1. No processed inbound item is older than the days to keep.
  2. Errored items are still there unless you chose to delete them.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Clean up the inbound queueRecurring batch job with a retention agreed with the warehouse (for example 30 days) and Delete errored records = No.The queues keep every inbound event until they are cleaned up; deleted items can't be restored.How long is inbound queue history kept?Setting Delete errored records = Yes: errored events that were never reprocessed are deleted with their error logs, and the work they describe stays undone.Test: Cleanup keeps recent and errored items

Feature management and licence

Licence or add-inThe Material handling equipment interface configuration key (System administration > Setup > License configuration > Trade > Warehouse and Transportation management) must be on; it is turned on in maintenance mode. No Feature management feature is needed. In this system 1 role can open this page, among them Material handling manager.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyPer company: the job cleans the inbound queue of the current company. Checked in Dynamics 365
Can it be undoneIrreversible: Deleted queue items can't be restored.
If you change it laterDeletes processed inbound queue items, and errored ones if Delete errored records is Yes. Microsoft Learn
Technical architect

6Technical

Menu itemWMHEInboundQueueCleanup Checked in Dynamics 365
FormSysOperationTemplateForm Checked in Dynamics 365
Roles to set it up and use itTo use itMaterial handling manager WMHEMaterialHandlingManagerGive 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=WMHEInboundQueueCleanup
Data migrationLoad order: The Inbound queue cleanup job has no data entity in Data management, so it can't be loaded from a file or a configuration template. It only deletes inbound queue records; there is nothing to load.Checked in Dynamics 365
Everyone

8Sources

To cite this step: MHE-JOB-030, Clean up the inbound queue. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/MHE-JOB-030