DESADV — EDIFACT Despatch Advice (ASN) (D.21B)
The DESADV (Despatch Advice) message announces the shipment of goods to a delivery point, including pack, pallet and SSCC details. It is the universal Advance Shipping Notice outside North America. This page summarises the segment structure as published by UN/CEFACT for directory D.21B.
Purpose
The DESADV (Despatch Advice) message announces the shipment of goods to a delivery point, including pack, pallet and SSCC details. It is the universal Advance Shipping Notice outside North America.
This page focuses on the structure published by UN/CEFACT for directory D.21B. The segments listed, their status (M / C), position and repetition factor are extracted from the official file desadv_c.htm hosted on service.unece.org.
Segment structure
The DESADV D.21B message has 45 header entries, 90 detail entries and 2 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 | C | ×10 |
00040 | ALI | Additional information | C | ×5 |
00050 | MEA | Measurements | C | ×5 |
00060 | MOA | Monetary amount | C | ×5 |
00070 | CUX | Currencies | C | ×9 |
00080 | SG1 | Group (×99) | C | ×99 |
00090 | RFF | Reference | M | 1 |
00100 | DTM | Date/time/period | C | ×9 |
00110 | SG2 | Group (×99) | C | ×99 |
00120 | NAD | Name and address | M | 1 |
00130 | LOC | Place/location identification | C | ×10 |
00140 | SG3 | Group (×99) | C | ×99 |
00150 | RFF | Reference | M | 1 |
00160 | DTM | Date/time/period | C | ×99 |
00170 | SG4 | Group (×10) | C | ×10 |
00180 | CTA | Contact information | M | 1 |
00190 | COM | Communication contact | C | ×5 |
00200 | SG5 | Group (×10) | C | ×10 |
00210 | TOD | Terms of delivery or transport | M | 1 |
00220 | LOC | Place/location identification | C | ×9999 |
00230 | FTX | Free text | C | ×5 |
00240 | SG6 | Group (×10) | C | ×10 |
00250 | TDT | Transport information | M | 1 |
00260 | PCD | Percentage details | C | ×6 |
00270 | TMD | Transport movement details | C | 1 |
00280 | SG7 | Group (×10) | C | ×10 |
00290 | LOC | Place/location identification | M | 1 |
00300 | DTM | Date/time/period | C | ×10 |
00310 | SG8 | Group (×10) | C | ×10 |
00320 | EQD | Equipment details | M | 1 |
00330 | MEA | Measurements | C | ×5 |
00340 | SEL | Seal number | C | ×25 |
00350 | EQA | Attached equipment | C | ×5 |
00360 | SG9 | Group (×10) | C | ×10 |
00370 | HAN | Handling instructions | M | 1 |
00380 | FTX | Free text | C | ×10 |
00390 | SG10 | Group (×99) | C | ×99 |
00400 | EFI | External file link identification | M | 1 |
00410 | CED | Computer environment details | C | ×99 |
00420 | COM | Communication contact | C | ×9 |
00430 | RFF | Reference | C | ×9 |
00440 | DTM | Date/time/period | C | ×9 |
00450 | QTY | Quantity | C | ×9 |
Detail
| Pos. | Tag | Name | S | Rep. |
|---|---|---|---|---|
00460 | SG11 | Group (×9999) | C | ×9999 |
00470 | CPS | Consignment packing sequence | M | 1 |
00480 | FTX | Free text | C | ×5 |
00490 | QVR | Quantity variances | C | ×9 |
00500 | SG12 | Group (×9999) | C | ×9999 |
00510 | PAC | Package | M | 1 |
00520 | MEA | Measurements | C | ×10 |
00530 | QTY | Quantity | C | ×10 |
00540 | SG13 | Group (×10) | C | ×10 |
00550 | HAN | Handling instructions | M | 1 |
00560 | FTX | Free text | C | ×10 |
00570 | SG14 | Group (×1000) | C | ×1000 |
00580 | PCI | Package identification | M | 1 |
00590 | RFF | Reference | C | 1 |
00600 | DTM | Date/time/period | C | ×5 |
00610 | SG15 | Group (×99) | C | ×99 |
00620 | GIR | Related identification numbers | M | 1 |
00630 | DTM | Date/time/period | C | ×5 |
00640 | SG16 | Group (×99) | C | ×99 |
00650 | GIN | Goods identity number | M | 1 |
00660 | DLM | Delivery limitations | C | ×10 |
00670 | SG17 | Group (×99) | C | ×99 |
00680 | COD | Component details | M | 1 |
00690 | MEA | Measurements | C | ×9 |
00700 | QTY | Quantity | C | ×9 |
00710 | PCD | Percentage details | C | ×9 |
00720 | SG18 | Group (×99) | C | ×99 |
00730 | EFI | External file link identification | M | 1 |
00740 | CED | Computer environment details | C | ×99 |
00750 | COM | Communication contact | C | ×9 |
00760 | RFF | Reference | C | ×9 |
00770 | DTM | Date/time/period | C | ×9 |
00780 | QTY | Quantity | C | ×9 |
00790 | SG19 | Group (×9999) | C | ×9999 |
00800 | LIN | Line item | M | 1 |
00810 | PIA | Additional product id | C | ×10 |
00820 | IMD | Item description | C | ×99 |
00830 | MEA | Measurements | C | ×10 |
00840 | QTY | Quantity | C | ×10 |
00850 | ALI | Additional information | C | ×10 |
00860 | GIN | Goods identity number | C | ×100 |
00870 | GIR | Related identification numbers | C | ×100 |
00880 | DLM | Delivery limitations | C | ×100 |
00890 | DTM | Date/time/period | C | ×5 |
00900 | NAD | Name and address | C | ×99 |
00910 | TDT | Transport information | C | 1 |
00920 | TMD | Transport movement details | C | 1 |
00930 | HAN | Handling instructions | C | ×20 |
00940 | FTX | Free text | C | ×99 |
00950 | MOA | Monetary amount | C | ×5 |
00960 | PAC | Package | C | ×9 |
00970 | SG20 | Group (×99) | C | ×99 |
00980 | RFF | Reference | M | 1 |
00990 | NAD | Name and address | C | 1 |
01000 | CTA | Contact information | C | 1 |
01010 | DTM | Date/time/period | C | 1 |
01020 | SG21 | Group (×9999) | C | ×9999 |
01030 | DGS | Dangerous goods | M | 1 |
01040 | QTY | Quantity | C | 1 |
01050 | FTX | Free text | C | ×5 |
01060 | SG22 | Group (×100) | C | ×100 |
01070 | LOC | Place/location identification | M | 1 |
01080 | NAD | Name and address | C | 1 |
01090 | DTM | Date/time/period | C | 1 |
01100 | QTY | Quantity | C | ×10 |
01110 | SG23 | Group (×1000) | C | ×1000 |
01120 | SGP | Split goods placement | M | 1 |
01130 | QTY | Quantity | C | ×10 |
01140 | SG24 | Group (×9999) | C | ×9999 |
01150 | PCI | Package identification | M | 1 |
01160 | DTM | Date/time/period | C | ×5 |
01170 | MEA | Measurements | C | ×10 |
01180 | QTY | Quantity | C | 1 |
01190 | SG25 | Group (×10) | C | ×10 |
01200 | GIN | Goods identity number | M | 1 |
01210 | DLM | Delivery limitations | C | ×100 |
01220 | SG26 | Group (×10) | C | ×10 |
01230 | HAN | Handling instructions | M | 1 |
01240 | FTX | Free text | C | ×5 |
01250 | GIN | Goods identity number | C | ×1000 |
01260 | SG27 | Group (×10) | C | ×10 |
01270 | QVR | Quantity variances | M | 1 |
01280 | DTM | Date/time/period | C | ×5 |
01290 | SG28 | Group (×99) | C | ×99 |
01300 | EFI | External file link identification | M | 1 |
01310 | CED | Computer environment details | C | ×99 |
01320 | COM | Communication contact | C | ×9 |
01330 | RFF | Reference | C | ×9 |
01340 | DTM | Date/time/period | C | ×9 |
01350 | QTY | Quantity | C | ×9 |
Summary
| Pos. | Tag | Name | S | Rep. |
|---|---|---|---|---|
01360 | CNT | Control total | C | ×5 |
01370 | UNT | Message trailer | M | 1 |
Changes vs D.96A
Top-level differences between D.96A and D.21B for the DESADV 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
CUXin the header section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.TMDin the header section (status C, 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.QTYin the header section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.CODin the detail section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.PCDin the detail section (status C, repeat ×9) — 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.COMin the detail section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.TDTin the detail section (status C, repeat ×1) — not present at the top of the corresponding D.96A section.TMDin the detail section (status C, repeat ×1) — not present at the top of the corresponding D.96A section.CTAin the detail section (status C, repeat ×1) — not present at the top of the corresponding D.96A section.
Status changes (M ↔ C)
QVR(detail): status M in D.96A → C in D.21B.GIR(detail): status C in D.96A → M in D.21B.
Max-repeat changes
QVR(detail): repeat ×1 in D.96A → ×9 in D.21B.GIR(detail): repeat ×99 in D.96A → ×1 in D.21B.IMD(detail): repeat ×25 in D.96A → ×99 in D.21B.NAD(detail): repeat ×1 in D.96A → ×99 in D.21B.
Structural example
Minimal example of an DESADV D.21B message with mandatory segments only. The goal is to show the exact version declared in UNH (DESADV:D:21B:UN) — not to replicate a full business case (see the DESADV D.96A page for an annotated example).
UNB+UNOC:3+5410000000123:14+5410000000456:14+260514:1430+CTRL021001'
UNH+1+DESADV:D:21B:UN'
BGM+351+ASN9001+9'
DTM+137:20260514:102'
DTM+11:20260515:102'
NAD+SU+5410000000456::9'
NAD+BY+5410000000123::9'
CPS+1'
PAC+1++201'
PCI+33E'
GIN+BJ+340000000000000001'
LIN+1++3520000001234:EN'
QTY+12:10'
UNT+13+1'
UNZ+1+CTRL021001' Common errors
- Misaligned UNH tokens — The
UNH+...+DESADV:D:21B: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.21B, 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: DESADV D.96A, DESADV D.01B, DESADV D.10A, DESADV D.16B, DESADV D.24A, DESADV D.97A, DESADV D.99B, DESADV D.00B, DESADV D.02B, DESADV D.05A, DESADV D.08A, DESADV D.13B, DESADV D.18B, DESADV D.20B.
X12 functional equivalent: X12 856.