BeyondERP.Newsletter
Menu

Setup step on the Material handling equipment interface parameters page · Material handling equipment interface

Set up Material handling equipment interface parameters

Use this page to map system users to warehouse workers, control duplicate inbound message IDs and manual inbound messages, and select number sequences for queue items and work line pairs.

Used by
Material handling manager
Business process
Manage warehouse operations
Menu item
WMHEParameters
Main table
WMHEParameters
Data entity
None for this page's own settings
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 setup page that holds the general settings and number sequences for the material handling equipment interface.
What you do hereUse this page to map system users to warehouse workers, control duplicate inbound message IDs and manual inbound messages, and select number sequences for queue items and work line pairs.
ExampleFor example, you map the system user that the material handling system calls the service with to a warehouse worker, so picks and puts from inbound events are assigned to that worker.
Material handling equipment interface parameters 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.

Setup steps on this page

Set up Material handling equipment interface parameters

Use this page to map system users to warehouse workers, control duplicate inbound message IDs and manual inbound messages, and select number sequences for queue items and work line pairs.

Steps from Microsoft

  1. Turn on the configuration key: put the system in maintenance mode, select Trade > Warehouse and Transportation management > Material handling equipment interface in License configuration, and turn maintenance mode off.
  2. Register the material handling system in Microsoft Entra ID applications with its own service user.
  3. Go to Material handling equipment interface > Setup > Material handling equipment interface parameters.
  4. On the General tab, in User mappings, map that service user to the warehouse worker whose default warehouse is the automated warehouse.
  5. Set Enable inbound message ID to Yes, and Enable manual inbound message creation to Yes only in a test environment.
  6. On the Number sequences tab, select the number sequences for inbound queue items, outbound queue items and work line pairs.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
User mappingsMaps each system user that calls the inbound queue service to a warehouse worker. Picks and puts processed through the inbound queue are assigned to that worker and run in the worker's default warehouse.Microsoft Learn MHE-SVC to worker 24-CONV
Enable inbound message IDWhen Yes, an inbound message with a duplicate message ID is rejected.Microsoft Learn YesEnableMessageId
Enable manual inbound message creationWhen Yes, you can create inbound records directly on the Inbound queue page to simulate messages.Microsoft Learn No (Yes only in a test environment)EnableManualInboundMessageCreation
Number sequencesThe system-wide number sequences that generate unique IDs for inbound queue items, outbound queue items and work line pairs.Microsoft Learn Mate_3, Mate_7, Mate_11

Common errors and fixes

MessageWhat to do
The Material handling equipment interface menu isn't thereThe configuration key is off. Turn it on in License configuration while the system is in maintenance mode, then turn maintenance mode off. Microsoft Learn
Inbound events fail or run in the wrong warehouseThe calling user isn't mapped in User mappings, or the mapped worker's default warehouse isn't the automated warehouse. Correct the mapping or the worker. Microsoft Learn
The same event is processed twiceEnable inbound message ID is No, so duplicate message IDs are accepted. Set it to Yes and make the material handling system send a unique message ID per event. Microsoft Learn

Test checklist

  1. Turn on the configuration key in maintenance mode.
  2. Set User mappings, Enable inbound message ID = Yes and the three number sequences.
  3. Create a subscription and release a sales order to create picking work; check a WorkCreation event appears in the Outbound queue.
  4. Submit a WorkConfirm inbound event with the work line pair ID and check the work lines close.
  5. Submit the same message ID again and check it is rejected.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Material handling equipment interface parametersEnable inbound message ID = Yes; Enable manual inbound message creation = Yes only in test environments; map each calling system user to a warehouse worker in User mappingsWith Enable inbound message ID = Yes, a duplicate inbound message ID is rejected, so the same event from the material handling system can't be processed twice. Manual inbound message creation is for simulating messages.How is the material handling system authenticated and mapped to a warehouse worker?Leaving Enable inbound message ID = No: duplicate message IDs are accepted, so a resent completion or short pick can run twice.Test: Duplicate inbound message is rejected

Number sequences

ReferenceShared or per companyNote
Inbound queue IDSharedBEAT uses number sequence Mate_3. Microsoft Learn calls these system-wide number sequences. Microsoft Learn
Outbound queue IDSharedBEAT uses number sequence Mate_7. Microsoft Learn calls these system-wide number sequences. Microsoft Learn
Work line pair IDSharedBEAT uses number sequence Mate_11. Microsoft Learn calls these system-wide number sequences. Microsoft Learn

Feature management and licence

Licence or add-inMaterial handling equipment interface configuration key (Trade > Warehouse and Transportation management), turned on in maintenance mode

Microsoft Learn

Solution architect

5Design impact

Shared or per companyPer company: the parameters entity is not shared across companies in Data management. Learn calls the three number sequences system-wide. Microsoft Learn
Can it be undoneReversible: Parameters can be changed at any time and apply to inbound events received from then on.
If you change it laterSetting Enable inbound message ID to No allows duplicate inbound message IDs, so the same event can be accepted more than once. Microsoft Learn
Technical architect

6Technical

Menu itemWMHEParameters Checked in Dynamics 365
FormWMHEParameters Checked in Dynamics 365
TableWMHEParametersShown as “MATERIAL HANDLING EQUIPMENT INTERFACE PARAMETERS” in Record infoChecked in Dynamics 365
Data entitiesWMHEParametersEntityMaterial handling equipment interface parameters (The parameters; confirm in a test environment whether User mappings is included.) Checked in Dynamics 365
Who can open itPrivilegesMaintain material handling parameters WMHEMaterialHandlingParametersMaintainView material handling parameters WMHEMaterialHandlingParametersViewDutiesInquire into material handling setup WMHEInquireIntoMaterialHandlingSetupMaintain material handling setup WMHEMaintainMaterialHandlingSetup
1 security roleMaterial handling manager WMHEMaterialHandlingManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itMaterial handling manager WMHEMaterialHandlingManagerGive people one of these roles. On this system, 1 role can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=WMHEParameters
Data migrationWMHEParametersEntity The parameters: inbound message ID check and manual inbound message creation.Load order: Load the parameters after the configuration key is on and the warehouse workers exist; then load the subscriptions. Set User mappings and the number sequences on the page in each environment, because the users differ per environment.Load first: Number sequences, Warehouse workers, Microsoft Entra ID applicationsMicrosoft Learn
Everyone

8Sources

To cite this step: MHE-SETUP-010, Set up Material handling equipment interface parameters. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/MHE-SETUP-010