Shipment Hub

Shipment Hub is an M3 Experience Designer application that provides a single location to work with shipments, deliveries, documents, and picklists. It displays shipment details in a main list, and users can drill down to related deliveries, delivery lines, shipment and delivery documents, delivery address information, and picklist data. In the same application, users can perform key actions such as releasing deliveries for allocation and picking, confirming picklists, and closing shipments. Users can also access the related M3 functions when detailed tasks are required.

User stories

A warehouse planner or shipping coordinator requires one application that displays all active shipments with the status, route, warehouse, and weight, and provides quick access to the related deliveries, delivery lines, documents, and picklists.

M3 Business Engine configuration

To display data in the Shipment Hub application, you must set up the shipments in 'Shipment. Open' (DRS100).

For details about the configuration per component, see the Components section below.

Application authorization

To access and run the Experience Designer application, you must be authorized for the M3 Business Engine functions and API transactions that the application uses.

This table shows the functions and transactions that the Shipment Hub application uses.

Function or API Transaction Information category View Notes
CRS620MI SearchSupplier To ensure this API works as expected, you must activate the CIDMAS table for search in M3 Function Search Administration.
DRS100MI GetShipment
DRS100MI CloseShipment
LISTMI ListDataAsCSV M3_LIST_MHDISH M3_02_01
LISTMI ListDataAsCSV M3_LIST_MHDISL M3_01_01
LISTMI ListDataAsCSV M3_LIST_DCONSI M3_01_01
LISTMI ListDataAsCSV M3_LIST_DDOCUX M3_01_01
LISTMI ListDataAsCSV M3_LIST_DDOCUX M3_02_01
MWS410MI RelForAlloc
MWS410MI RelForPick
MWS410MI GetAdr
MWS420MI LstPickersPL
MWS420MI LstPLViaPckLst
MWS420MI Confirm

How to use the application

Overview and navigation

When you open Shipment Hub, an overview of all shipments is displayed. When you select a shipment, the tabs update automatically to show the related deliveries, delivery lines, addresses, documents, picklists, and detailed shipment information.

Shipments

The Shipments data grid lists all shipments. You can scroll through the list, sort any column, and use filters such as shipment number, forward agent, route, place of load, status range, or departure date to find a shipment.

From this area, you can:
  • Close a shipment by clicking Close shipment from the toolbar.
  • View and manage the selected shipment by clicking Manage shipment, which opens 'Shipment. Open Toolbox' (DRS100).
On the Shipment Details tab, you can view grouped information about the selected shipment, including route and transport details, dates and times, and loading and packaging information.

Deliveries and delivery lines

The Delivery Information tab shows all deliveries that belong to the selected shipment. You can review the status, picking sequence, customer details, warehouse, and estimated weight.

From this tab, you can:

  • Release a delivery for allocation by clicking Release for allocation from the toolbar.
  • Release a delivery for picking by clicking Release for picking from the toolbar.
  • View and manage the selected delivery by clicking Manage delivery in 'Delivery. Open Toolbox' (MWS410).

The Delivery Lines sub‑tab shows all lines for the selected delivery, including the item, order details, quantities, pick list information, and weight or volume. The Manage line toolbar button opens 'Delivery. Manage Line Toolbox' (MWS411) for the selected delivery line. The Delivery Address sub‑tab shows the complete address for the delivery so you can verify the address details directly in the application.

Shipment and delivery documents

The Shipment Documents tab shows all documents connected to the shipment, including the document number, name, status, and Bill of Lading details. To work on a document, select it in the list and click the Manage document toolbar button to open 'Delivery. Connect Delivery Documents' (MWS260).

The Delivery Documents sub‑tab works the same way and shows all documents linked to the selected delivery. You can also click Manage document to open (MWS260) for document‑level tasks.

Picking list, picking list lines and picklist lines

The Picking List tab provides an overview of the picking and packing progress. You can review the picking and packing status, picker, picking team, and picking time.

From this tab, you can:

  • Confirm a picklist by clicking Confirm from the toolbar.
  • Click Manage picking list to open 'Picking List. Report' (MWS420) for additional follow‑up.

The Picking List Lines tab shows the detailed lines for the picklist, including the item, location, lot number, quantities, and stock zone. Clicking Report lines opens 'Picking List. Report Line' (MWS422).

Components

This table shows the specific configuration per component:

Component Component details
Application header Component ID: appHeader

Purpose: Shows the main application header with navigation and title.

Shipments data grid

Component ID: DataGrid_Shipments

Purpose: Shows the list of shipments.

M3BE data used: 'Shipment. Open Toolbox' (DRS100)

Data services used: ListMI_SearchShipments

Comments: This data service uses search. You must activate the DCONSI table for search in M3 Function Search Administration.

Deliveries data grid

Component ID: DataGrid_Deliveries

Purpose: Shows delivery records related to shipments.

M3BE data used: 'Deliveries. Open Toolbox' (MWS410)

Data services used: ListMI_Deliveries

Shipment Documents data grid

Component ID: DataGrid_ShipmentDocuments

Purpose: Lists documents associated with shipments.

M3BE data used: 'Delivery. Connect Delivery Document' (MWS260)

Data services used: ListMI_ShipmentDocuments

Shipment Picklists data grid

Component ID: DataGrid_ShipmentPicklists

Purpose: Manages picklists for shipments.

M3BE data used: 'Picking List. Report' (MWS420)

Data services used: List_ShipmentPicklist

Shipment picklist lines data grid

Component ID: DataGrid_ShipmentPicklistLines

Purpose: Displays detailed lines for shipment picklists.

M3BE data used: 'Picking List. Report Lines' (MWS422)

Data services used: List_ShipmentPicklistLines

Delivery Lines data grid

Component ID: DataGrid_DeliveryLines

Purpose: Shows line items for deliveries.

M3BE data used: 'Delivery. Open Line Toolbox' (MWS411)

Data services used: ListMI_DeliveryLines

Delivery Documents data grid

Component ID: DataGrid_DeliveryDocuments

Purpose: Lists documents linked to deliveries.

M3BE data used: 'Delivery. Connect Delivery Documents' (MWS260)

Data services used: ListMI_DeliveryDocuments

Delivery Address form

Component ID: Form_DeliveryAddress

Purpose: Displays and edits delivery address information.

M3BE data used: 'Delivery. Open Toolbox' (MWS410)

Data services used: Get_DeliveryAddress

General Information form

Component ID: Form_GeneralShipmentInfo

Purpose: Shows general shipment information.

M3BE data used: 'Shipment. Open Toolbox' (DRS100)

Data services used: Get_Shipment

Route and Transport Details form

Component ID: Form_RouteTransportDetails

Purpose: Displays route and transport details.

M3BE data used: 'Shipment. Open Toolbox' (DRS100)

Data services used: Get_Shipment

Loading and Packaging Details form

Component ID: Form_LoadPackagingDetails

Purpose: Displays loading and packaging details.

M3BE data used: 'Shipment. Open Toolbox' (DRS100)

Data services used: Get_Shipment

Dates and Times form

Component ID: Form_StatusTiming

Purpose: Displays dates and times for the selected shipment.

M3BE data used: 'Shipment. Open Toolbox' (DRS100)

Data services used: Get_Shipment

Links and bookmarks

This table shows the available links and bookmarks in the application, including their types and the functions they open:
Link ID Type Purpose
Link_ManageDelivery M3 Bookmark Opens 'Delivery. Open Toolbox' (MWS410) for the selected delivery.
Link_ManageDeliveryDocument M3 Bookmark Opens 'Delivery. Connect Delivery Documents' (MWS260) for the selected delivery.
Link_ManageDeliveryLine M3 Bookmark Opens 'Delivery. Open Line' (MWS411) for the selected delivery.
Link_ManageShipment M3 Bookmark Opens 'Shipment. Open Toolbox' (DRS100) for the selected shipment.
Link_ManageShipmentDocument M3 Bookmark Opens 'Delivery. Connect Delivery Documents' (MWS260) for the selected shipment.
Link_ReportPicklist M3 Bookmark Opens 'Picking List. Report' (MWS420) for the selected delivery.
Link_ReportPicklistLines M3 Bookmark Opens 'Picking List. Report Lines' (MWS422) for the selected delivery and picklist.

Conditional styles

This table shows the styling conditions applied to each components in the application:

Component Condition name Target field Condition Styling
Documents data grid Condition_OYDODE OYDODE DBDLIX>0 Text color: #0066D4 - blue

Text weight: bold

Delivery Documents data grid Condition_OYDODE OYDODE DBDONR>0 Text color: #0066D4 – blue

Text weight: bold