M3 Business Engine Administrator's Guide for Warehouse Management Interfaces

This document provides general information for consultants and customers on Warehouse Management Interfaces (WHI). To fully understand the concepts in this document, you must have experience using M3 BE.

This document does not describe the details on M3 Interface (MI) programs and their transactions, such as which files and fields are required and how they are used.

For a detailed description of MI programs and their transactions, see the API Repository in M3 API Tools.


Warehouse Management Interfaces (WHI) is primarily used to manage material flow and logistics within a warehouse. WHI is a set of gates in and out of M3 that supports integration to Warehouse Management Systems (WMS) and material handling equipment (MHE).

MHE includes scanners, bar code readers, handheld devices, conveyors, and more.

The communication can be through APIs. This communication can be asynchronous for managing large volumes or synchronous, for example, from and to a bar code reader.

WHI is divided into these parts:

These business processes are supported:

Upload goods receipt/put away of purchase orders, distribution orders, requisition orders, manufacturing orders, and customer order returns.

Warehouse Integration Architecture (WHI)

Upload batch programs architecture

The auto jobs MMS855 and MHS855 with the corresponding trigger files MMM855 and MHM855 process incoming messages without a call from an external system. The autojob is executed if an external system sends a request towards M3. This is done by setting the value of the process flag (PRFL) in the MI transaction to *AUT.

This figure illustrates the architecture of the MHS850 batch entry.

* Autojobs are reading their respective workfile.

MHS855 reads MHM855

MHS855T1 reads MHMT01

MHS855T2 reads MHMT02

MHS855T3 reads MHMT03

MHS855T4 reads MHMT04

MHS855T5 reads MHMT05

MHS855T6 reads MHMT06

MHS855T7 reads MHMT07

MHS855T8 reads MHMT08

MHS855T9 reads MHMT09

MHS855TA reads MHMT0A

This figure describes the architecture of the MMS850 batch entry.

MHE integration architecture

The material handling equipment (MHE) software simulates a user and uses the graphical interface to execute changes in M3. This diagram illustrates the main approaches for MHE integration:

The MHE software uses MI programs to execute changes in M3.

MHE interface download using WHI

The MHE software uses MI programs to populate the WHI interface files. Validations are done on and execution of transactions are based on the data in the interface files.

MHE interface upload using WHI

Using warehouse management interfaces

The WHI concept works for interfacing to larger WMS, 3PL concepts, and MHE, but the following needs to be considered when using Warehouse Management Interfaces:

Use the APIs provided in M3 API Toolkit to download and upload data

The APIs provided in the M3 API toolkit are used to download and upload data.

The upload APIs have specific transactions with logic for how to populate the intermediate files as well as generic transactions defined. This approach is strongly recommended rather than writing directly to the files.

For a detailed description of MI programs and their transactions, see the API Repository in M3 API Tools.

There are MI transactions per MI program that set the download flag (DOWN) to 1 on the records in the download file. This will make the list transactions exclude these records next time they are run.

Process flag (PRFL):

UTC mode in API transactions

Most of the order-initiated stock transactions in API MHS850MI can receive date and time expressed as UTC time by inputting the value “1” in the field 'Coordinated Universal Time Mode' (UTCM). With that mode activated, the provided date and time is considered being provided as UTC and is converted to local warehouse time before being saved in the interface tables.

In the interface files MHIHED, MHIPAC MHILIN, the date and time are always considered as local warehouse time. If UTCM is activated in the Get and List transactions, MHS850MI will convert the date and time found in interface files from local warehouse time to UTC, before returning the values to the API output.

Note: The date and time must both be available for the conversion to succeed. Depending on the transaction, certain date and time combinations can or cannot be converted. That is, RPDT RPTM (reported date and time) can be converted while EXPI (expiration date), having no time, cannot be converted.
Related topics