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.
ORDERS D.97A

ORDERS — EDIFACT Purchase Order (D.97A)

The ORDERS message conveys a buyer’s intent to purchase goods or services from a seller under terms agreed upstream. It supports spot orders, call-offs against blanket contracts, and replenishment flows alike. This page summarises the segment structure as published by UN/CEFACT for directory D.97A.

Purpose

The ORDERS message conveys a buyer’s intent to purchase goods or services from a seller under terms agreed upstream. It supports spot orders, call-offs against blanket contracts, and replenishment flows alike.

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 orders_s.htm hosted on service.unece.org.

Segment structure

The ORDERS D.97A message has 100 header entries, 125 detail entries and 8 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/periodM×35
0040PAIPayment instructionsC1
0050ALIAdditional informationC×5
0060IMDItem descriptionC×999
0070FTXFree textC×99
0080  SG1Group (×9999)C×9999
0090  RFFReferenceM1
0100  DTMDate/time/periodC×5
0110    SG2Group (×99)C×99
0120    NADName and addressM1
0130    LOCPlace/location identificationC×25
0140    FIIFinancial institution informationC×5
0150      SG3Group (×99)C×99
0160      RFFReferenceM1
0170      DTMDate/time/periodC×5
0180        SG4Group (×5)C×5
0190        DOCDocument/message detailsM1
0200        DTMDate/time/periodC×5
0210          SG5Group (×5)C×5
0220          CTAContact informationM1
0230          COMCommunication contactC×5
0240            SG6Group (×5)C×5
0250            TAXDuty/tax/fee detailsM1
0260            MOAMonetary amountC1
0270            LOCPlace/location identificationC×5
0280              SG7Group (×5)C×5
0290              CUXCurrenciesM1
0300              PCDPercentage detailsC×5
0310              DTMDate/time/periodC×5
0320                SG8Group (×10)C×10
0330                PATPayment terms basisM1
0340                DTMDate/time/periodC×5
0350                PCDPercentage detailsC1
0360                  SG9Group (×9999)C×9999
0370                  MOAMonetary amountM1
0380                  GIRRelated identification numbersC×9
0390                    SG10Group (×10)C×10
0400                    TDTDetails of transportM1
0410                      SG11Group (×10)C×10
0420                      LOCPlace/location identificationM1
0430                      DTMDate/time/periodC×5
0440                        SG12Group (×5)C×5
0450                        TODTerms of delivery or transportM1
0460                        LOCPlace/location identificationC×2
0470                          SG13Group (×10)C×10
0480                          PACPackageM1
0490                          MEAMeasurementsC×5
0500                            SG14Group (×5)C×5
0510                            PCIPackage identificationM1
0520                            RFFReferenceC1
0530                            DTMDate/time/periodC×5
0540                            GINGoods identity numberC×10
0550                              SG15Group (×10)C×10
0560                              EQDEquipment detailsM1
0570                              HANHandling instructionsC×5
0580                              MEAMeasurementsC×5
0590                              FTXFree textC×5
0600                                SG16Group (×10)C×10
0610                                SCCScheduling conditionsM1
0620                                FTXFree textC×5
0630                                RFFReferenceC×5
0640                                  SG17Group (×10)C×10
0650                                  QTYQuantityM1
0660                                  DTMDate/time/periodC×5
0670                                    SG18Group (×25)C×25
0680                                    APRAdditional price informationM1
0690                                    DTMDate/time/periodC×5
0700                                    RNGRange detailsC1
0710                                      SG19Group (×99)C×99
0720                                      ALCAllowance or chargeM1
0730                                      ALIAdditional informationC×5
0740                                      DTMDate/time/periodC×5
0750                                        SG20Group (×1)C1
0760                                        QTYQuantityM1
0770                                        RNGRange detailsC1
0780                                          SG21Group (×1)C1
0790                                          PCDPercentage detailsM1
0800                                          RNGRange detailsC1
0810                                            SG22Group (×2)C×2
0820                                            MOAMonetary amountM1
0830                                            RNGRange detailsC1
0840                                              SG23Group (×1)C1
0850                                              RTERate detailsM1
0860                                              RNGRange detailsC1
0870                                                SG24Group (×5)C×5
0880                                                TAXDuty/tax/fee detailsM1
0890                                                MOAMonetary amountC1
0900                                                  SG25Group (×999)C×999
0910                                                  RCSRequirements and conditionsM1
0920                                                  RFFReferenceC×5
0930                                                  DTMDate/time/periodC×5
0940                                                  FTXFree textC×99999
0950                                                    SG26Group (×999)C×999
0960                                                    DGSDangerous goodsM1
0970                                                    FTXFree textC×5
0980                                                      SG27Group (×99)C×99
0990                                                      CTAContact informationM1
1000                                                      COMCommunication contactC×5

Detail

Pos.TagNameSRep.
1010  SG28Group (×200000)C×200000
1020  LINLine itemM1
1030  PIAAdditional product idC×25
1040  IMDItem descriptionC×99
1050  MEAMeasurementsC×99
1060  QTYQuantityC×99
1070  PCDPercentage detailsC×5
1080  ALIAdditional informationC×5
1090  DTMDate/time/periodC×35
1100  MOAMonetary amountC×10
1110  GINGoods identity numberC×1000
1120  GIRRelated identification numbersC×1000
1130  QVRQuantity variancesC1
1140  DOCDocument/message detailsC×99
1150  PAIPayment instructionsC1
1160  FTXFree textC×99
1170    SG29Group (×999)C×999
1180    CCICharacteristic/class idM1
1190    CAVCharacteristic valueC×10
1200    MEAMeasurementsC×10
1210      SG30Group (×10)C×10
1220      PATPayment terms basisM1
1230      DTMDate/time/periodC×5
1240      PCDPercentage detailsC1
1250        SG31Group (×9999)C×9999
1260        MOAMonetary amountM1
1270        GIRRelated identification numbersC×9
1280          SG32Group (×25)C×25
1290          PRIPrice detailsM1
1300          CUXCurrenciesC1
1310          APRAdditional price informationC1
1320          RNGRange detailsC1
1330          DTMDate/time/periodC×5
1340            SG33Group (×9999)C×9999
1350            RFFReferenceM1
1360            DTMDate/time/periodC×5
1370              SG34Group (×10)C×10
1380              PACPackageM1
1390              MEAMeasurementsC×5
1400              QTYQuantityC×5
1410              DTMDate/time/periodC×5
1420                SG35Group (×1)C1
1430                RFFReferenceM1
1440                DTMDate/time/periodC×5
1450                  SG36Group (×5)C×5
1460                  PCIPackage identificationM1
1470                  RFFReferenceC1
1480                  DTMDate/time/periodC×5
1490                  GINGoods identity numberC×10
1500                    SG37Group (×9999)C×9999
1510                    LOCPlace/location identificationM1
1520                    QTYQuantityC1
1530                    PCDPercentage detailsC1
1540                    DTMDate/time/periodC×5
1550                      SG38Group (×10)C×10
1560                      TAXDuty/tax/fee detailsM1
1570                      MOAMonetary amountC1
1580                      LOCPlace/location identificationC×5
1590                        SG39Group (×999)C×999
1600                        NADName and addressM1
1610                        LOCPlace/location identificationC×5
1620                          SG40Group (×99)C×99
1630                          RFFReferenceM1
1640                          DTMDate/time/periodC×5
1650                            SG41Group (×5)C×5
1660                            DOCDocument/message detailsM1
1670                            DTMDate/time/periodC×5
1680                              SG42Group (×5)C×5
1690                              CTAContact informationM1
1700                              COMCommunication contactC×5
1710                                SG43Group (×99)C×99
1720                                ALCAllowance or chargeM1
1730                                ALIAdditional informationC×5
1740                                DTMDate/time/periodC×5
1750                                  SG44Group (×1)C1
1760                                  QTYQuantityM1
1770                                  RNGRange detailsC1
1780                                    SG45Group (×1)C1
1790                                    PCDPercentage detailsM1
1800                                    RNGRange detailsC1
1810                                      SG46Group (×2)C×2
1820                                      MOAMonetary amountM1
1830                                      RNGRange detailsC1
1840                                        SG47Group (×1)C1
1850                                        RTERate detailsM1
1860                                        RNGRange detailsC1
1870                                          SG48Group (×5)C×5
1880                                          TAXDuty/tax/fee detailsM1
1890                                          MOAMonetary amountC1
1900                                            SG49Group (×10)C×10
1910                                            TDTDetails of transportM1
1920                                              SG50Group (×10)C×10
1930                                              LOCPlace/location identificationM1
1940                                              DTMDate/time/periodC×5
1950                                                SG51Group (×5)C×5
1960                                                TODTerms of delivery or transportM1
1970                                                LOCPlace/location identificationC×2
1980                                                  SG52Group (×10)C×10
1990                                                  EQDEquipment detailsM1
2000                                                  HANHandling instructionsC×5
2010                                                  MEAMeasurementsC×5
2020                                                  FTXFree textC×5
2030                                                    SG53Group (×100)C×100
2040                                                    SCCScheduling conditionsM1
2050                                                    FTXFree textC×5
2060                                                    RFFReferenceC×5
2070                                                      SG54Group (×10)C×10
2080                                                      QTYQuantityM1
2090                                                      DTMDate/time/periodC×5
2100                                                        SG55Group (×999)C×999
2110                                                        RCSRequirements and conditionsM1
2120                                                        RFFReferenceC×5
2130                                                        DTMDate/time/periodC×5
2140                                                        FTXFree textC×99999
2150                                                          SG56Group (×10)C×10
2160                                                          STGStagesM1
2170                                                            SG57Group (×3)C×3
2180                                                            QTYQuantityM1
2190                                                            MOAMonetary amountC1
2200                                                              SG58Group (×999)C×999
2210                                                              DGSDangerous goodsM1
2220                                                              FTXFree textC×5
2230                                                                SG59Group (×99)C×99
2240                                                                CTAContact informationM1
2250                                                                COMCommunication contactC×5

Summary

Pos.TagNameSRep.
2260UNSSection controlM1
2270MOAMonetary amountC×12
2280CNTControl totalC×10
2290  SG60Group (×10)C×10
2300  ALCAllowance or chargeM1
2310  ALIAdditional informationC1
2320  MOAMonetary amountM×2
2330UNTMessage trailerM1

Changes vs D.96A

Top-level differences between D.96A and D.97A for the ORDERS 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.

Segments added vs D.96A

  • GIR in the header section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.
  • DGS in the header section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.
  • DGS in the detail section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.

Max-repeat changes

  • IMD (header): repeat ×1 in D.96A → ×999 in D.97A.
  • MEA (detail): repeat ×5 in D.96A → ×99 in D.97A.
  • QTY (detail): repeat ×10 in D.96A → ×99 in D.97A.
  • DOC (detail): repeat ×5 in D.96A → ×99 in D.97A.

Structural example

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

edifact orders-d97a-example.edi
UNB+UNOC:3+5410000000123:14+5410000000456:14+260514:1430+CTRL097001'
UNH+1+ORDERS:D:97A:UN'
BGM+220+ORDER789+9'
DTM+137:20260514:102'
DTM+2:20260520:102'
NAD+BY+5410000000123::9'
NAD+SU+5410000000456::9'
LIN+1++3520000001234:EN'
QTY+21:10'
PRI+AAA:42.00'
UNS+S'
CNT+2:1'
UNT+11+1'
UNZ+1+CTRL097001'

Common errors

  • Misaligned UNH tokens — The UNH+...+ORDERS: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: ORDERS D.96A, ORDERS D.01B, ORDERS D.10A, ORDERS D.16B, ORDERS D.21B, ORDERS D.24A, ORDERS D.99B, ORDERS D.00B, ORDERS D.02B, ORDERS D.05A, ORDERS D.08A, ORDERS D.13B, ORDERS D.18B, ORDERS D.20B.

X12 functional equivalent: X12 850.

← All EDIFACT versions