Skip to main content

EDIFACT HANMOV – Cargo/Goods Handling and Movement

What is the EDIFACT HANMOV Message? 

TheElectronic Data Interchange EDIFACT HANMOV (Cargo/Goods Handling and Movement Message) is a standardized EDI message used to communicate instructions, status updates, and reporting, and information for the physical handling and movement of goods within a warehouse or distribution center. Commonly used in ports, terminals, warehouses, container yards, freight stations, and multimodal transport hubs; the EDIFACT HANMOV message directs recipients on how items are identified. The EDIFACT HANMOV then goes on to direct recipients on how items must be prepared, handled, assembled, packed, or moved, to execute operations safely and consistently.  

The EDIFACT HANMOV (Cargo/Goods Handling and Movement Message) enables stakeholders to communicate operational actions such as: 

  • Moving goods between storage locations
  • Issuing gate-in or gate-out notifications
  • Reporting handling completion or exceptions
  • Assigning equipment or transport units (cranes, trucks, forklifts, containers)
  • Loading or unloading containers/pallets 

 

How is the EDIFACT HANMOV Message Used?  

Trading partners use EDIFACT HANMOV to request or confirm handling activities such as loading, unloading, consolidation, kitting, relabeling, special storage, or hazard‑aware handling instructions. Schedules and events in the sender's WMS/ERP trigger the generation of the EDIFACT HANMOV messages; recipients then perform the action, reconcile the outcome, identify references and identities, and send a response to an activity request in the form of a response message. The EDIFACT HANMOV is one of several messages used to confirm handling activities. 
 

EDIFACT HANMOV vs. X12 940 Warehouse Shipping Order 

The EDIFACT HANMOV (Cargo/Goods Handling and Movement) and X12 940 (Warehouse Shipping Order) are both EDI standards used in supply chain and logistics to communicate instructions between trading partners, particularly those involving warehouses or distribution centers.  

They do, however, differ in scope, functionality, and regional adoption. HANMOV is part of the UN/EDIFACT standard (widely used in Europe, Asia, and internationally), while the X12 940 is part of the ANSI X12 standard (primarily North American).  HANMOV is bidirectional, making it a bit more versatile and capable of covering a broader range of internal warehouse operations beyond shipping; by contrast, the X12 940 is very focused on shipping authorization.  
 

How does PartnerLinQ use the EDIFACT HANMOV Message? 

PartnerLinQAS2 uses the EDIFACT HANMOV message as part of its logistics coordination and terminal connectivity transaction layer, enabling real-time visibility and orchestration between shippers, carriers, 3PLs, warehouses, ports, customs, and rail systems.  

PartnerLinQ Orchestration exchanges CONTRL acknowledgments to enforce syntactic integrity, then routes EDIFACT HANMOV message intake via AS2 or APIs, validates qualifiers, and enriches operations with dashboards and alerts for missing or late messages.  

PartnerLinQ maps EDIFACT HANMOV message instructions to Logistics Service Provider (LSP) warehouse workflows while preserving sender-specific qualifiers and instructions as might be required by the sender. 

Digital Handling Instructions: PartnerLinQ converts WMS/TMS/ERP instructions into HANMOV messages (e.g., move pallet to dock door #3, load container ABCU1234567). 

Event Automation: PartnerLinQ enables triggered alerting, like when handling is delayed, cargo is misplaced, or exceptions occur (damaged, hazardous, missing units). 

Application Programming InterfaceAPI–EDI Transformation: PartnerLinQ easily transforms WMS, TMS, ERP, and EDI instructions from SAP, D365, Oracle, Blue Yonder, or Manhattan into consumable API-based warehouse instructions that mirror the EDIFACT HANMOV supporting modern Supply Chain technologies for shippers, carriers, 3PLs, warehouses, port, customs, terminals, and rail systems.
 

How do larger dairy and food products companies use the EDIFACT HANMOV Message? 

Larger dairy and food products companies, companies such Lactalis, Danone, Nestle, Aria, Saputo, Schreiber Foods, Kraft Heinz, Müller, and Agropur, often rely on Logistics Service Provider (LSP) warehouses. These larger dairy and food products operations use the EDIFACT HANMOV message to instruct service providers (LSPs) of safe and compliant handling. Messaging may include local product status, notes, and grading codes. Instructions may be at the line or SSCC level, an approach that supports the regulated handling of dairy and food products through terminal and warehouse operations while promoting precise product movements and execution in global supply chain environments.  
 

What responses to the EDIFACT HANMOV message are expected/sent? 

EDIFACT messages used to respond to the EDIFACT HANMOV vary by sender requirement, below are some of the most common message variations used today to respond to an inbound EDIFACT HANMOV message: 

DocumentDescription
CONTRL (Functional Acknowledgment)Confirms the delivery of information and documents any formatting errors or loss of data.
APERAK (Operational Acceptance / Confirmation)Used to confirm acceptance or rejection of the handling instruction at the business level. May also report errors.
IFTMIN / IFTMCS (Transport / Movement Confirmation)Used in response to the EDIFACT HANMOV message when the handling instruction triggers a transport movement.
IFTSTA (Status Update)Used in multimodal operations as a status update message.
INVRPT (Inventory / Stock Level Feedback)Confirms one or more inventory positions after handling instruction has been completed.
HANMOV (Response Message)Used as a response, in some implementations with a different message function code.

The EDIFACT CONTRL (Functional Acknowledgments) message which confirms the delivery of information and documents any formatting errors or loss of data. 

The UN/EDIFACTEDIFACT APERAK (Operational Acceptance / Confirmation) message is used to confirm acceptance or rejection of the handling instruction at the business level. May also report errors. 

The EDIFACT IFTMIN / IFTMCS (Transport / Movement Confirmation) message, used in response to the EDIFACT HANMOV message when the handling instruction triggers a transport movement. 

The EDIFACT IFTSTA (Status Update) message is typically used in multimodal operations like port, customs, and rail systems as a status update message to describe a container/pallet's entry and exit from a terminal or port (e.g., gate-in’, ‘gate-out’) while loading or unloading, assigning equipment or transport units (cranes, trucks, forklifts, containers), confirming milestones (e.g., unloading complete, unloading, loading in progress, goods repacked, re-labeled, etc.). 

The EDIFACT INVRPT (Inventory / Stock Level Feedback) message, which confirms one or more inventory positions after handling instruction has been completed (e.g., embargo, quarantine, blocked, repack, consolidation, after kitting). 

The EDIFACT HANMOV (Response Message). Used in some implementations, the HANMOV is also used as a response, with a different message function code (e.g., BGM030 = 29 = “Accepted” or 27 = “Not Accepted,” etc.). 
 

What does the EDIFACT HANMOV message support?  

The3rd Party Logistics EDIFACT HANMOV message supports the handling and movement of goods within Logistics Service Provider (LSP) warehouses or distribution centers. A scope limited to activities under the control of a single distribution center and applicable to both national and international trade. The EDIFACT HANMOV message purposefully excludes manufacturing processes and direct transport outside the center's jurisdiction (e.g., seller-to-buyer delivery), it requests or confirms handling activities like loading, unloading, consolidation, kitting, relabeling, special storage instructions, and reporting. 

Instructions: The EDIFACT HANMOV message is sent from an ordering party (e.g., customer or supplier) to a warehouse or logistics provider, specifying required handling services and goods movements. 

Responses (Status Report): The EDIFACT HANMOV message is sent from the warehouse or provider back to the ordering party, confirming execution, progress, exceptions, or completion of requested/required services. 
 

What are the Key Features of the EDIFACT HANMOV message? 

The message supports explicit handling instructions, qualified dates and periods, party and location context, item identification, package hierarchy, and identity numbers such as SSCC. Guidance includes service segments, qualifiers, and partner additions for operational precision.  
 

What is the Purpose of the HANMOV? 

TheValue Added Network message standardizes communication of warehouse and terminal handling requirements so receivers can execute actions consistently and confirm compliance across partners, sites, and systems.  
 

What Information is Included in the HANMOV? 

Typical content includes message control numbers, document function, dates and times, parties and references, item and package details, identity numbers, locations, handling instructions, *(including free‑text clarifications where agreed), and a message trailer with control information. 
 

What are the Essential Components of the HANMOV? 

While not always mandatory, essential components cover service segments, headers, dates, handling instructions, party and reference groups, item and description, packaging hierarchy, identity numbers, locations, and trailer controls. Segment notes follow based on D.96A usage. 
 

SegmentEssential Notes
UNH – Message HeaderHeader that identifies the message and reference control type = HANMOV.
BGM – Beginning of MessageIndicates type, number, and function.
DTM – Date/Time/PeriodSpecifies document dates/times, ISO formats supported.
HAN – Handling InstructionsSpecifies coded or textual instructions for how goods should be handled, moved, stored, or transported.
FTX – Free TextNot recommended - provides agreed freeform notes, grading codes, or local statuses; controlled use.
NAD – Name and AddressIdentifies relevant parties, including Logistics Service Provider (LSP) warehouse and delivery locations.
RFF – ReferenceCarries handling or movement reference numbers; partner qualifiers may extend codes.
LIN – Line ItemIdentifies the item being handled or the resulting item after assembly/disassembly.
IMD – Item DescriptionDescribes product where codes are insufficient.
CPS – Consignment Packing SequenceDefines hierarchical packing relationships. Used to model physical structure.
PAC – PackageProvides the count and type of packages under CPS.
PCI – Package IdentificationSpecifies marks and labels used on packages.
GIN – Goods Identity NumberProvides identifiers such as SSCC, serial, and batch for handled packages.
LOC – Place/Location IdentificationIndicates site, warehouse, zone, or bin for handling activities.
UNT – Message TrailerEnds the message and provides control totals and reference.

 

What are the Common Segments Included in the HANMOV? 

Common header segments include UNH, BGM, and DTM. Common operational segments include HAN for instructions, FTX for agreed notes, NAD and RFF for context, LIN and IMD for items, CPS/PAC/PCI/GIN for hierarchical packages and identities, LOC for locations, and UNT for control.  

Common Segment use cases reflect typical warehouse and terminal handling processes documented in PartnerLinQ guidance, reflect D.96A usage and include larger dairy and food products use cases.  
 

TagLevelPurposeUsageRep
UNHHeaderIdentify message as HANMOV; set referenceMandatoryOnce
BGMHeaderDocument number and functionMandatoryOnce
DTMHeaderDocument date/time and periodsMust use1..9
HANDetailCoded handling instructionsConditional (often required)0..9
FTXDetailAgreed free text (grading/local status)Conditional0..9
NADPartyLSP and ship/deliver partiesMandatory in SG3Per party
RFFParty RefHandling/movement referenceMandatory in SG4Per ref
LINItemItem being handledMandatory in SG7Per item
IMDItemItem descriptionConditional0..99
CPSPackPacking hierarchy linkUsedPer hierarchy
PACPackPackage count/typeMandatory in SG11Per hierarchy
PCIPackMarks/labelsMandatory in SG12Per package
GINPackSSCC/serial/batch IDsConditional0..9
LOCLocHandling location/binConditionalAs needed
UNTTrailerSegment count/controlMandatoryOnce

 

What Status Codes are used with the HANMOV? 

Status information travels primarily through handling qualifiers, local status notes, and condition codes carried by HAN, STS (where applicable), and FTX subject qualifiers. Examples include damaged, quarantine, customs refusal, or local warehouse statuses communicated for action.  
 

What Reason Codes are used with the HANMOV? 

Reason codes qualify handling actions or variances: why a rework occurred, why a package was relabeled, or why a move was refused. Trading partners define code lists in guidelines; Danone‑specific qualifiers appear in BGM, DTM, NAD, RFF, and FTX.  
 

What Use Cases does the EDIFACT HANMOV Message support? 

Use cases reflect typical warehouse and terminal handling processes documented in PartnerLinQ guidance. 

Use CaseDescription
Loading/Unloading OperationsCarriers and terminals receive instructions for safe loading or unloading with location and time qualifiers.
Consolidation/DeconsolidationWarehouse teams consolidate packages under CPS and PAC; SSCCs tracked with GIN.
Rework/RelabelHandlers perform rework steps or apply new labels; marks and labels described with PCI and identities with GIN.
Kitting/Assembly/DisassemblyOperations convert or assemble items; resulting items identified under LIN with descriptions under IMD.
Hazard‑Aware HandlingSpecial handling and storage instructions transmitted under HAN and supported by FTX subject and free text.

 

What are the Benefits of the HANMOV? 

Benefits for Operations: Business to BusinessOperations gain standardized instructions, improved safety, faster execution, reduced mis‑handling, and traceable package identities across partners and sites.  

Benefits for Senders: Senders gain operational efficiency through automation. Automation that can be used by WMS/ERP triggers in the generation of the EDIFACT HANMOV messages to send instructions to Logistics Service Provider (LSP) warehouse operators while preserving sender specific instructions as might be required.  

Benefits for Receivers: The EDIFACT HANMOV message standardizes communication of warehouse and terminal handling requirements so receivers can execute actions consistently and confirm compliance across partners, sites, and systems in the form of a response message. 
 

How Efficient is the EDIFACT HANMOV? 

Efficiency comes with increased use, the EDIFACT HANMOV message improves operations for senders and receivers when event‑driven messages are aligned with WMS and operational tasking. CONTRL documents, acknowledgments, response transactions, and exception reporting (dashboards) ensure visibility and control.  
 

How Compliant is the HANMOV? 

Compliance strengthens when code lists and qualifiers drive actionable intelligence (handling), while service segments and MDN/CONTRL documents provide auditability for exchange integrity.  
 

What is the Format of the EDIFACT HANMOV (Cargo/Goods Handling and Movement Message)? 

The EDIFACT HANMOV (Cargo/Goods Handling and Movement Message) conforms to UN/EDIFACT D.96A with service segments UNB/UNZ and UNH/UNT; PartnerLinQ uses UNA:+.?' and generates CONTRL functional acknowledgments.  


How Accurate is the EDIFACT HANMOV? 

Accuracy depends on the sender’s ability to provide clear and concise instruction made possible by reliable identities such as SSCC in GIN, precise locations in LOC, correct party identifiers in NAD, and through handling qualifiers in HAN.  
 

What are the Limitations of the EDIFACT HANMOV? 

The4th Party Logistics EDIFACT HANMOV standard does not define business acceptance or confirmation; partners tend to use a mix of complementary messages or APIs to confirm receipt and activity. Local code lists and free‑text usage is widespread and requires internal governance to avoid ambiguity and compliance issues.  
 

Are Guidelines & Sample Files for the EDIFACT HANMOV (Cargo/Goods Handling and Movement Message) available? 

Yes. PartnerLinQ provides sample EDIFACT HANMOV Transaction and implementation guides are available through its Support and Guideline Management Team

Sample implementation guides illustrate both inbound and outbound flows, segment layouts, and valid data examples and support testing and partner onboarding. Customized specification documents for use in on boarding and technical development are available upon request.  

PartnerLinQ provides: 

  • Transaction implementation guide
  • Sample payloads
  • Qualification and testing maps
  • Error handling and best-practice notes 

Contact our experts
 

Sample

 

What are the Basic Questions for EDI Integration with the EDIFACT HANMOV message? 

Use cases reflect typical warehouse and terminal handling processes documented in PartnerLinQ guidance and executed with the EDIFACT HANMOV (Cargo/Goods Handling and Movement Message) 

  1. Are there Samples and Specs available?
  2. What EDI version and standard will be used?
  3. What is the general direction of the transaction?
  4. Are they Inbound from or outbound to another party?
  5. Which acknowledgments (MDN/CONTRL) are required?
  6. What response is expected or sent in response to the transaction?
  7. Are there samples and specs of the response transaction available?
  8. Are there other parties interested in the EDIFACT HANMOV Message?
  9. What transactions might these interested parties be a party to?
  10. Are there distinct types of EDIFACT HANMOV messages that need to be tracked or handled differently?
  11. Are there any business rules that should be considered when processing an EDIFACT HANMOV message? (e.g., invalid/missing item or customer identification number)
  12. Do Batch or Lot numbers need to be tracked?
  13. Is there product serialization?
  14. Are products consolidated and presented as single line items, or are sublines involved?
  15. How are changes to the EDIFACT HANMOV business message managed today?
  16. Is there automation? (an internal systems trigger) Or are EDIFACT HANMOV messages triggered manually?
  17. Are responses and changes automatically triggered? (an internal systems trigger) Or do transactions require human intervention?
  18. Which handling instructions and code lists will be supported?
  19. Which parties and locations are required for execution?
  20. Which identity numbers (SSCC, serial, batch) must be included?
  21. Which references must be echoed to reconcile tasks?
  22. Which schedules or events will trigger messages? 
     

What Business Level Workflow does the HANMOV support? 

The typical workflow begins as a planned event or event‑driven trigger, proceeds through instruction preparation in a WMS/ERP, maps to D.96A segments, transmits via AS2 or API, generates CONTRL, and posts tasks and exceptions to dashboards for execution and reconciliation.  

 

Workflow

 

What are the Best Practices for using the HANMOV? 

Best Practices reflect PartnerLinQ implementation guidance for handling operations.  

PracticeRecommendation
Use precise qualifiersAlign handling codes and subjects to partner code lists.
Minimize free‑textPrefer coded instructions; use FTX only by agreement.
Model hierarchyRepresent package structures with CPS/PAC and label with PCI.
Track identitiesInclude SSCC and serials with GIN wherever applicable.
Governance (codes)Publish local code lists and responsibilities.
Control exchangesEnable MDN/CONTRL and monitor dashboards.

 

What Transactions are associated with the HANMOV?  

Associations vary by party and flow; CONTRL and MDN support exchange integrity.  

TransactionRole
CONTRLEDIFACT functional acknowledgment of syntax/receipt.
APERAKConfirm acceptance or rejection at the business level.
IFTMIN / IFTMCSUsed when the HANMOV instruction triggers transport movement.
IFTSTAA status update message used in multimodal operations.
INVRPTInventory visibility before/after handling operations where relevant.
DESADVDespatch advice is used when movement results in shipment.
ORDERS/ORDRSPOrdering and response context around work creation.
HANMOV (Response)The HANMOV used as a response, with a different message function code.

Explore Our Integration Solutions

PartnerLinQ Integration Solutions

PartnerLinQ Integration Solutions

Connect Everything. Integrate Intelligently.

Future-Proof Your Business with Composable, AI Powered Connectivity.

×