ORDERS — EDIFACT Purchase Order (D.16B)
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.16B.
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.16B. The segments listed, their status (M / C), position and repetition factor are extracted from the official file orders_c.htm hosted on service.unece.org.
Segment structure
The ORDERS D.16B message has 109 header entries, 139 detail entries and 8 summary entries (segments and groups combined). Groups are shown in bold and their members are indented by actual nesting depth.
Header
| Pos. | Tag | Name | S | Rep. |
|---|---|---|---|---|
00010 | UNH | Message header | M | 1 |
00020 | BGM | Beginning of message | M | 1 |
00030 | DTM | Date/time/period | M | ×35 |
00040 | PAI | Payment instructions | C | 1 |
00050 | ALI | Additional information | C | ×5 |
00060 | IMD | Item description | C | ×999 |
00070 | FTX | Free text | C | ×99 |
00080 | GIR | Related identification numbers | C | ×10 |
00090 | SG1 | Group (×9999) | C | ×9999 |
00100 | RFF | Reference | M | 1 |
00110 | DTM | Date/time/period | C | ×5 |
00120 | SG2 | Group (×99) | C | ×99 |
00130 | NAD | Name and address | M | 1 |
00140 | LOC | Place/location identification | C | ×99 |
00150 | FII | Financial institution information | C | ×5 |
00160 | SG3 | Group (×99) | C | ×99 |
00170 | RFF | Reference | M | 1 |
00180 | DTM | Date/time/period | C | ×5 |
00190 | SG4 | Group (×5) | C | ×5 |
00200 | DOC | Document/message details | M | 1 |
00210 | DTM | Date/time/period | C | ×5 |
00220 | SG5 | Group (×5) | C | ×5 |
00230 | CTA | Contact information | M | 1 |
00240 | COM | Communication contact | C | ×5 |
00250 | SG6 | Group (×5) | C | ×5 |
00260 | TAX | Duty/tax/fee details | M | 1 |
00270 | MOA | Monetary amount | C | 1 |
00280 | LOC | Place/location identification | C | ×9 |
00290 | SG7 | Group (×5) | C | ×5 |
00300 | CUX | Currencies | M | 1 |
00310 | PCD | Percentage details | C | ×5 |
00320 | DTM | Date/time/period | C | ×5 |
00330 | SG8 | Group (×10) | C | ×10 |
00340 | PYT | Payment terms | M | 1 |
00350 | DTM | Date/time/period | C | ×5 |
00360 | PCD | Percentage details | C | 1 |
00370 | SG9 | Group (×9999) | C | ×9999 |
00380 | MOA | Monetary amount | M | 1 |
00390 | GIR | Related identification numbers | C | ×9 |
00400 | RJL | Accounting journal identification | C | ×99 |
00410 | SG10 | Group (×10) | C | ×10 |
00420 | TDT | Transport information | M | 1 |
00430 | SG11 | Group (×10) | C | ×10 |
00440 | LOC | Place/location identification | M | 1 |
00450 | DTM | Date/time/period | C | ×5 |
00460 | SG12 | Group (×5) | C | ×5 |
00470 | TOD | Terms of delivery or transport | M | 1 |
00480 | LOC | Place/location identification | C | ×2 |
00490 | SG13 | Group (×99) | C | ×99 |
00500 | PAC | Package | M | 1 |
00510 | MEA | Measurements | C | ×5 |
00520 | SG14 | Group (×5) | C | ×5 |
00530 | PCI | Package identification | M | 1 |
00540 | RFF | Reference | C | 1 |
00550 | DTM | Date/time/period | C | ×5 |
00560 | GIN | Goods identity number | C | ×10 |
00570 | SG15 | Group (×10) | C | ×10 |
00580 | EQD | Equipment details | M | 1 |
00590 | HAN | Handling instructions | C | ×5 |
00600 | MEA | Measurements | C | ×5 |
00610 | FTX | Free text | C | ×5 |
00620 | SG16 | Group (×10) | C | ×10 |
00630 | SCC | Scheduling conditions | M | 1 |
00640 | FTX | Free text | C | ×5 |
00650 | RFF | Reference | C | ×5 |
00660 | SG17 | Group (×10) | C | ×10 |
00670 | QTY | Quantity | M | 1 |
00680 | DTM | Date/time/period | C | ×5 |
00690 | SG18 | Group (×25) | C | ×25 |
00700 | APR | Additional price information | M | 1 |
00710 | DTM | Date/time/period | C | ×5 |
00720 | RNG | Range details | C | 1 |
00730 | SG19 | Group (×99) | C | ×99 |
00740 | ALC | Allowance or charge | M | 1 |
00750 | ALI | Additional information | C | ×5 |
00760 | DTM | Date/time/period | C | ×5 |
00770 | SG20 | Group (×1) | C | 1 |
00780 | QTY | Quantity | M | 1 |
00790 | RNG | Range details | C | 1 |
00800 | SG21 | Group (×1) | C | 1 |
00810 | PCD | Percentage details | M | 1 |
00820 | RNG | Range details | C | 1 |
00830 | SG22 | Group (×2) | C | ×2 |
00840 | MOA | Monetary amount | M | 1 |
00850 | RNG | Range details | C | 1 |
00860 | SG23 | Group (×1) | C | 1 |
00870 | RTE | Rate details | M | 1 |
00880 | RNG | Range details | C | 1 |
00890 | SG24 | Group (×5) | C | ×5 |
00900 | TAX | Duty/tax/fee details | M | 1 |
00910 | MOA | Monetary amount | C | 1 |
00920 | SG25 | Group (×999) | C | ×999 |
00930 | RCS | Requirements and conditions | M | 1 |
00940 | RFF | Reference | C | ×5 |
00950 | DTM | Date/time/period | C | ×5 |
00960 | FTX | Free text | C | ×99999 |
00970 | SG26 | Group (×999) | C | ×999 |
00980 | DGS | Dangerous goods | M | 1 |
00990 | FTX | Free text | C | ×5 |
01000 | SG27 | Group (×99) | C | ×99 |
01010 | CTA | Contact information | M | 1 |
01020 | COM | Communication contact | C | ×5 |
01030 | SG28 | Group (×99) | C | ×99 |
01040 | EFI | External file link identification | M | 1 |
01050 | CED | Computer environment details | C | ×99 |
01060 | COM | Communication contact | C | ×9 |
01070 | RFF | Reference | C | ×9 |
01080 | DTM | Date/time/period | C | ×9 |
01090 | QTY | Quantity | C | ×9 |
Detail
| Pos. | Tag | Name | S | Rep. |
|---|---|---|---|---|
01100 | SG29 | Group (×200000) | C | ×200000 |
01110 | LIN | Line item | M | 1 |
01120 | PIA | Additional product id | C | ×25 |
01130 | IMD | Item description | C | ×99 |
01140 | MEA | Measurements | C | ×99 |
01150 | QTY | Quantity | C | ×99 |
01160 | PCD | Percentage details | C | ×5 |
01170 | ALI | Additional information | C | ×5 |
01180 | DTM | Date/time/period | C | ×35 |
01190 | MOA | Monetary amount | C | ×10 |
01200 | GEI | Processing information | C | ×99 |
01210 | GIN | Goods identity number | C | ×1000 |
01220 | GIR | Related identification numbers | C | ×1000 |
01230 | QVR | Quantity variances | C | 1 |
01240 | DOC | Document/message details | C | ×99 |
01250 | PAI | Payment instructions | C | 1 |
01260 | MTD | Maintenance operation details | C | ×99 |
01270 | FTX | Free text | C | ×99 |
01280 | SG30 | Group (×999) | C | ×999 |
01290 | CCI | Characteristic/class id | M | 1 |
01300 | CAV | Characteristic value | C | ×10 |
01310 | MEA | Measurements | C | ×10 |
01320 | SG31 | Group (×10) | C | ×10 |
01330 | PYT | Payment terms | M | 1 |
01340 | DTM | Date/time/period | C | ×5 |
01350 | PCD | Percentage details | C | 1 |
01360 | SG32 | Group (×9999) | C | ×9999 |
01370 | MOA | Monetary amount | M | 1 |
01380 | GIR | Related identification numbers | C | ×9 |
01390 | SG33 | Group (×25) | C | ×25 |
01400 | PRI | Price details | M | 1 |
01410 | CUX | Currencies | C | 1 |
01420 | APR | Additional price information | C | ×99 |
01430 | RNG | Range details | C | 1 |
01440 | DTM | Date/time/period | C | ×5 |
01450 | SG34 | Group (×9999) | C | ×9999 |
01460 | RFF | Reference | M | 1 |
01470 | DTM | Date/time/period | C | ×5 |
01480 | GEI | Processing information | C | ×99 |
01490 | MOA | Monetary amount | C | ×99 |
01500 | SG35 | Group (×99) | C | ×99 |
01510 | PAC | Package | M | 1 |
01520 | MEA | Measurements | C | ×5 |
01530 | QTY | Quantity | C | ×5 |
01540 | DTM | Date/time/period | C | ×5 |
01550 | SG36 | Group (×1) | C | 1 |
01560 | RFF | Reference | M | 1 |
01570 | DTM | Date/time/period | C | ×5 |
01580 | SG37 | Group (×5) | C | ×5 |
01590 | PCI | Package identification | M | 1 |
01600 | RFF | Reference | C | 1 |
01610 | DTM | Date/time/period | C | ×5 |
01620 | GIN | Goods identity number | C | ×10 |
01630 | SG38 | Group (×9999) | C | ×9999 |
01640 | LOC | Place/location identification | M | 1 |
01650 | PCD | Percentage details | C | 1 |
01660 | DTM | Date/time/period | C | ×5 |
01670 | SG39 | Group (×99) | C | ×99 |
01680 | QTY | Quantity | M | 1 |
01690 | STS | Status | C | ×99 |
01700 | SG40 | Group (×10) | C | ×10 |
01710 | TAX | Duty/tax/fee details | M | 1 |
01720 | MOA | Monetary amount | C | 1 |
01730 | LOC | Place/location identification | C | ×5 |
01740 | SG41 | Group (×999) | C | ×999 |
01750 | NAD | Name and address | M | 1 |
01760 | LOC | Place/location identification | C | ×5 |
01770 | FII | Financial institution information | C | ×5 |
01780 | SG42 | Group (×99) | C | ×99 |
01790 | RFF | Reference | M | 1 |
01800 | DTM | Date/time/period | C | ×5 |
01810 | SG43 | Group (×5) | C | ×5 |
01820 | DOC | Document/message details | M | 1 |
01830 | DTM | Date/time/period | C | ×5 |
01840 | SG44 | Group (×5) | C | ×5 |
01850 | CTA | Contact information | M | 1 |
01860 | COM | Communication contact | C | ×5 |
01870 | SG45 | Group (×99) | C | ×99 |
01880 | ALC | Allowance or charge | M | 1 |
01890 | ALI | Additional information | C | ×5 |
01900 | DTM | Date/time/period | C | ×5 |
01910 | SG46 | Group (×1) | C | 1 |
01920 | QTY | Quantity | M | 1 |
01930 | RNG | Range details | C | 1 |
01940 | SG47 | Group (×1) | C | 1 |
01950 | PCD | Percentage details | M | 1 |
01960 | RNG | Range details | C | 1 |
01970 | SG48 | Group (×2) | C | ×2 |
01980 | MOA | Monetary amount | M | 1 |
01990 | RNG | Range details | C | 1 |
02000 | SG49 | Group (×1) | C | 1 |
02010 | RTE | Rate details | M | 1 |
02020 | RNG | Range details | C | 1 |
02030 | SG50 | Group (×5) | C | ×5 |
02040 | TAX | Duty/tax/fee details | M | 1 |
02050 | MOA | Monetary amount | C | 1 |
02060 | SG51 | Group (×10) | C | ×10 |
02070 | TDT | Transport information | M | 1 |
02080 | SG52 | Group (×10) | C | ×10 |
02090 | LOC | Place/location identification | M | 1 |
02100 | DTM | Date/time/period | C | ×5 |
02110 | SG53 | Group (×5) | C | ×5 |
02120 | TOD | Terms of delivery or transport | M | 1 |
02130 | LOC | Place/location identification | C | ×2 |
02140 | SG54 | Group (×10) | C | ×10 |
02150 | EQD | Equipment details | M | 1 |
02160 | HAN | Handling instructions | C | ×5 |
02170 | MEA | Measurements | C | ×5 |
02180 | FTX | Free text | C | ×5 |
02190 | SG55 | Group (×100) | C | ×100 |
02200 | SCC | Scheduling conditions | M | 1 |
02210 | FTX | Free text | C | ×5 |
02220 | RFF | Reference | C | ×5 |
02230 | SG56 | Group (×10) | C | ×10 |
02240 | QTY | Quantity | M | 1 |
02250 | DTM | Date/time/period | C | ×5 |
02260 | SG57 | Group (×999) | C | ×999 |
02270 | RCS | Requirements and conditions | M | 1 |
02280 | RFF | Reference | C | ×5 |
02290 | DTM | Date/time/period | C | ×5 |
02300 | FTX | Free text | C | ×99999 |
02310 | SG58 | Group (×10) | C | ×10 |
02320 | STG | Stages | M | 1 |
02330 | SG59 | Group (×3) | C | ×3 |
02340 | QTY | Quantity | M | 1 |
02350 | MOA | Monetary amount | C | 1 |
02360 | SG60 | Group (×999) | C | ×999 |
02370 | DGS | Dangerous goods | M | 1 |
02380 | FTX | Free text | C | ×5 |
02390 | SG61 | Group (×99) | C | ×99 |
02400 | CTA | Contact information | M | 1 |
02410 | COM | Communication contact | C | ×5 |
02420 | SG62 | Group (×99) | C | ×99 |
02430 | EFI | External file link identification | M | 1 |
02440 | CED | Computer environment details | C | ×99 |
02450 | COM | Communication contact | C | ×99 |
02460 | RFF | Reference | C | ×9 |
02470 | DTM | Date/time/period | C | ×9 |
02480 | QTY | Quantity | C | ×9 |
Summary
| Pos. | Tag | Name | S | Rep. |
|---|---|---|---|---|
02490 | UNS | Section control | M | 1 |
02500 | MOA | Monetary amount | C | ×99 |
02510 | CNT | Control total | C | ×10 |
02520 | SG63 | Group (×10) | C | ×10 |
02530 | ALC | Allowance or charge | M | 1 |
02540 | ALI | Additional information | C | 1 |
02550 | MOA | Monetary amount | M | ×2 |
02560 | UNT | Message trailer | M | 1 |
Changes vs D.96A
Top-level differences between D.96A and D.16B 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
GIRin the header section (status C, repeat ×10) — not present at the top of the corresponding D.96A section.PYTin the header section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.RJLin the header section (status C, repeat ×99) — not present at the top of the corresponding D.96A section.DGSin the header section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.EFIin the header section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.CEDin the header section (status C, repeat ×99) — not present at the top of the corresponding D.96A section.GEIin the detail section (status C, repeat ×99) — not present at the top of the corresponding D.96A section.MTDin the detail section (status C, repeat ×99) — not present at the top of the corresponding D.96A section.PYTin the detail section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.STSin the detail section (status C, repeat ×99) — not present at the top of the corresponding D.96A section.FIIin the detail section (status C, repeat ×5) — not present at the top of the corresponding D.96A section.DGSin the detail section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.EFIin the detail section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.CEDin the detail section (status C, repeat ×99) — not present at the top of the corresponding D.96A section.
Segments removed vs D.96A
PATin the header section — present in D.96A but missing in D.16B at the same level.PATin the detail section — present in D.96A but missing in D.16B at the same level.
Max-repeat changes
IMD(header): repeat ×1 in D.96A → ×999 in D.16B.LOC(header): repeat ×25 in D.96A → ×99 in D.16B.MEA(detail): repeat ×5 in D.96A → ×99 in D.16B.QTY(detail): repeat ×10 in D.96A → ×99 in D.16B.DOC(detail): repeat ×5 in D.96A → ×99 in D.16B.APR(detail): repeat ×1 in D.96A → ×99 in D.16B.MOA(summary): repeat ×12 in D.96A → ×99 in D.16B.
Structural example
Minimal example of an ORDERS D.16B message with mandatory segments only. The goal is to show the exact version declared in UNH (ORDERS:D:16B:UN) — not to replicate a full business case (see the ORDERS D.96A page for an annotated example).
UNB+UNOC:3+5410000000123:14+5410000000456:14+260514:1430+CTRL016001'
UNH+1+ORDERS:D:16B: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+CTRL016001' Common errors
- Misaligned UNH tokens — The
UNH+...+ORDERS:D:16B:UNtoken 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.16B, 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.
Related messages
Other versions of this message available on ediverse.io: ORDERS D.96A, ORDERS D.01B, ORDERS D.10A, ORDERS D.21B, ORDERS D.24A, ORDERS D.97A, 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.