ediverse Explore the platform

Spotlight PEPPOL BIS Billing 3.0 The EU e-invoicing mandate is here — France Sept 2026, Belgium Jan 2026, Germany 2025.
HANMOV D.97A

HANMOV — EDIFACT Cargo / Goods Handling and Movement Message (D.97A)

The HANMOV message describes the cargo handling and movement operations within a logistics site — terminal, warehouse, port or airport hub: lifting orders, internal moves, inter-terminal transfers. It bridges WMS / TOS systems with their operational resources. This page summarises the segment structure as published by UN/CEFACT for directory D.97A.

Purpose

The HANMOV message describes the cargo handling and movement operations within a logistics site — terminal, warehouse, port or airport hub: lifting orders, internal moves, inter-terminal transfers. It bridges WMS / TOS systems with their operational resources.

This page focuses on the structure published by UN/CEFACT for directory D.97A. The segments listed, their status (M / C), position and repetition factor are extracted from the official file hanmov_s.htm hosted on service.unece.org.

Segment structure

The HANMOV D.97A message has 87 header entries, 0 detail entries and 0 summary entries (segments and groups combined). Groups are shown in bold and their members are indented by actual nesting depth.

Pos.TagNameSRep.
0010UNHMessage headerM1
0020BGMBeginning of messageM1
0030DTMDate/time/periodC×9
0040HANHandling instructionsC×9
0050FTXFree textC×9
0060CNTControl totalC×9
0070  SG1Group (×9)C×9
0080  TCCTransport charge/rate calculationsM1
0090  LOCPlace/location identificationC×9
0100  FTXFree textC×9
0110  CUXCurrenciesC×9
0120    SG2Group (×9)C×9
0130    RFFReferenceM1
0140    DTMDate/time/periodC×9
0150      SG3Group (×9)C×9
0160      NADName and addressM1
0170      LOCPlace/location identificationC×9
0180      DOCDocument/message detailsC×9
0190        SG4Group (×9)C×9
0200        RFFReferenceM1
0210        DTMDate/time/periodC×9
0220          SG5Group (×9)C×9
0230          CTAContact informationM1
0240          COMCommunication contactC×9
0250            SG6Group (×9)C×9
0260            TDTDetails of transportM1
0270            DTMDate/time/periodC×9
0280            LOCPlace/location identificationC×9
0290            RFFReferenceC×9
0300              SG7Group (×99)C×99
0310              LINLine itemM1
0320              PIAAdditional product idC×9
0330              IMDItem descriptionC×99
0340              HANHandling instructionsC×9
0350              TCCTransport charge/rate calculationsC×9
0360                SG8Group (×9)C×9
0370                NADName and addressM1
0380                  SG9Group (×1)C1
0390                  CTAContact informationM1
0400                  COMCommunication contactC×9
0410                  MEAMeasurementsC×9
0420                  QTYQuantityC×9
0430                  GINGoods identity numberC×99
0440                  GIRRelated identification numbersC×99
0450                  DTMDate/time/periodC×9
0460                  FTXFree textC×9
0470                    SG10Group (×9)C×9
0480                    RFFReferenceM1
0490                    DTMDate/time/periodC1
0500                    LOCPlace/location identificationC×9
0510                      SG11Group (×99)C×99
0520                      PACPackageM1
0530                      MEAMeasurementsC×9
0540                      QTYQuantityC×9
0550                        SG12Group (×9)C×9
0560                        PCIPackage identificationM1
0570                        GINGoods identity numberC×9
0580                          SG13Group (×99)C×99
0590                          GIDGoods item detailsM1
0600                          HANHandling instructionsC1
0610                          CSTCustoms status of goodsC1
0620                          TMPTemperatureC1
0630                          RNGRange detailsC1
0640                          LOCPlace/location identificationC×9
0650                          MOAMonetary amountC×9
0660                          PIAAdditional product idC×9
0670                          FTXFree textC×9
0680                          NADName and addressC×9
0690                          MEAMeasurementsC×9
0700                          DIMDimensionsC×9
0710                          RFFReferenceC×9
0720                          PCIPackage identificationC×9
0730                            SG14Group (×9)C×9
0740                            DOCDocument/message detailsM1
0750                            DTMDate/time/periodC×9
0760                            SGPSplit goods placementC×9
0770                            TCCTransport charge/rate calculationsC×9
0780                              SG15Group (×9)C×9
0790                              DGSDangerous goodsM1
0800                              FTXFree textC×9
0810                              MEAMeasurementsC×9
0820                                SG16Group (×9)C×9
0830                                EQDEquipment detailsM1
0840                                EQNNumber of unitsC1
0850                                SELSeal numberC1
0860                                EQAAttached equipmentC×99
0870UNTMessage trailerM1

Detail

No segment in this section.

Summary

No segment in this section.

Changes vs D.96A

Top-level differences between D.96A and D.97A for the HANMOV message (segments directly inside header / detail / summary, ignoring nested groups). The comparison is indicative: a given tag may have evolved inside nested groups without showing up in this synthesis.

No top-level differences detected between D.96A and D.97A for this message. Differences are then limited to nested groups and code lists.

Structural example

Minimal example of an HANMOV D.97A message with mandatory segments only. The goal is to show the exact version declared in UNH (HANMOV:D:97A:UN) — not to replicate a full business case (see the HANMOV D.96A page for an annotated example).

edifact hanmov-d97a-example.edi
UNB+UNOC:3+5410000000123:14+5410000000456:14+260514:1430+CTRL097001'
UNH+1+HANMOV:D:97A:UN'
BGM+266+HANMOV-2026-1004+9'
DTM+137:202605141430:203'
HAN+L:::Lifting and inland transfer'
FTX+AAI+++Move 24 containers from yard Block A to rail siding R2'
LOC+5+FRLEH::6'
LOC+11+FRTGV::6'
UNT+8+1'
UNZ+1+CTRL097001'

Common errors

  • Misaligned UNH tokens — The UNH+...+HANMOV:D:97A:UN token must reflect exactly the directory in use — a mismatch between the UNH release and the release agreed with the partner is rejected by every strict validator.
  • Wrong UNT segment count — The value after UNT+ must include UNH and UNT themselves. By far the most common sender-side error, regardless of the directory in use.
  • Stale code lists — Between D.96A and D.97A, several code lists received new qualifiers (DTM status, RFF qualifier, NAD codes…). Reusing an older directory’s code tables triggers warnings or even rejections depending on the partner’s strict-conformance mode.

Other versions of this message available on ediverse.io: HANMOV D.96A, HANMOV D.01B, HANMOV D.10A, HANMOV D.16B, HANMOV D.21B, HANMOV D.24A, HANMOV D.99B, HANMOV D.00B, HANMOV D.02B, HANMOV D.05A, HANMOV D.08A, HANMOV D.13B, HANMOV D.18B, HANMOV D.20B.

← All EDIFACT versions