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.
- Close a shipment by clicking from the toolbar.
- View and manage the selected shipment by clicking , which opens 'Shipment. Open Toolbox' (DRS100).
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 from the toolbar.
- Release a delivery for picking by clicking from the toolbar.
- View and manage the selected delivery by clicking 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 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 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 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 from the toolbar.
- Click 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 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
| 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 |