DOCADV — EDIFACT Document/Message Advice Message (D.16B)
The DOCADV message is the advice sent by a trade partner regarding a previously received document: it indicates its status (accepted, accepted with reservations, rejected), the discrepancies detected, the related references and the actions required. It is one of the three EDIFACT business-feedback channels alongside APERAK and CONTRL. This page summarises the segment structure as published by UN/CEFACT for directory D.16B.
Purpose
The DOCADV message is the advice sent by a trade partner regarding a previously received document: it indicates its status (accepted, accepted with reservations, rejected), the discrepancies detected, the related references and the actions required. It is one of the three EDIFACT business-feedback channels alongside APERAK and CONTRL.
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 docadv_c.htm hosted on service.unece.org.
Segment structure
The DOCADV D.16B message has 74 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.
Header
| Pos. | Tag | Name | S | Rep. |
|---|---|---|---|---|
00010 | UNH | Message header | M | 1 |
00020 | BGM | Beginning of message | M | 1 |
00030 | RFF | Reference | M | 1 |
00040 | BUS | Business function | M | 1 |
00050 | INP | Parties and instruction | M | ×10 |
00060 | FCA | Financial charges allocation | M | ×3 |
00070 | DTM | Date/time/period | M | ×3 |
00080 | FTX | Free text | C | ×20 |
00090 | SG1 | Group (×9) | M | ×9 |
00100 | FII | Financial institution information | M | 1 |
00110 | RFF | Reference | C | ×2 |
00120 | CTA | Contact information | C | 1 |
00130 | COM | Communication contact | C | ×5 |
00140 | SG2 | Group (×9) | M | ×9 |
00150 | NAD | Name and address | M | 1 |
00160 | RFF | Reference | C | 1 |
00170 | CTA | Contact information | C | 1 |
00180 | COM | Communication contact | C | ×5 |
00190 | SG3 | Group (×1) | M | 1 |
00200 | DTM | Date/time/period | M | 1 |
00210 | LOC | Place/location identification | M | 1 |
00220 | SG4 | Group (×5) | M | ×5 |
00230 | MOA | Monetary amount | M | 1 |
00240 | SG5 | Group (×1) | C | 1 |
00250 | ALC | Allowance or charge | M | 1 |
00260 | PCD | Percentage details | C | ×2 |
00270 | SG6 | Group (×3) | M | ×3 |
00280 | LOC | Place/location identification | M | 1 |
00290 | DTM | Date/time/period | C | 1 |
00300 | SG7 | Group (×1) | M | 1 |
00310 | PAI | Payment instructions | M | 1 |
00320 | FII | Financial institution information | C | 1 |
00330 | LOC | Place/location identification | C | 1 |
00340 | SG8 | Group (×5) | M | ×5 |
00350 | PYT | Payment terms | M | 1 |
00360 | FII | Financial institution information | C | 1 |
00370 | DTM | Date/time/period | C | 1 |
00380 | MOA | Monetary amount | C | 1 |
00390 | PCD | Percentage details | C | 1 |
00400 | FTX | Free text | C | 1 |
00410 | SG9 | Group (×1) | C | 1 |
00420 | TOD | Terms of delivery or transport | M | 1 |
00430 | LOC | Place/location identification | C | 1 |
00440 | SG10 | Group (×1) | C | 1 |
00450 | TSR | Transport service requirements | M | 1 |
00460 | LOC | Place/location identification | C | ×5 |
00470 | SG11 | Group (×5) | C | ×5 |
00480 | INP | Parties and instruction | M | 1 |
00490 | FTX | Free text | C | 1 |
00500 | DTM | Date/time/period | C | ×2 |
00510 | SG12 | Group (×9) | M | ×9 |
00520 | RFF | Reference | M | 1 |
00530 | DTM | Date/time/period | C | 1 |
00540 | FTX | Free text | C | ×2 |
00550 | SG13 | Group (×20) | M | ×20 |
00560 | DOC | Document/message details | M | 1 |
00570 | MOA | Monetary amount | C | 1 |
00580 | PCD | Percentage details | C | 1 |
00590 | LOC | Place/location identification | C | 1 |
00600 | FTX | Free text | C | 1 |
00610 | SG14 | Group (×20) | C | ×20 |
00620 | ICD | Insurance cover description | M | 1 |
00630 | DTM | Date/time/period | C | 1 |
00640 | FTX | Free text | C | ×9 |
00650 | SG15 | Group (×9) | C | ×9 |
00660 | ALI | Additional information | M | 1 |
00670 | SG16 | Group (×3) | C | ×3 |
00680 | NAD | Name and address | M | 1 |
00690 | CTA | Contact information | C | 1 |
00700 | COM | Communication contact | C | ×5 |
00710 | SG17 | Group (×1) | C | 1 |
00720 | AUT | Authentication result | M | 1 |
00730 | DTM | Date/time/period | C | 1 |
00740 | UNT | Message trailer | M | 1 |
Detail
No segment in this section.
Summary
No segment in this section.
Changes vs D.96A
Top-level differences between D.96A and D.16B for the DOCADV 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
PYTin the header section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.ICDin the header section (status M, repeat ×1) — 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.TAXin the header section — present in D.96A but missing in D.16B at the same level.
Status changes (M ↔ C)
LOC(header): status C in D.96A → M in D.16B.
Max-repeat changes
INP(header): repeat ×5 in D.96A → ×10 in D.16B.FCA(header): repeat ×1 in D.96A → ×3 in D.16B.FTX(header): repeat ×9 in D.96A → ×20 in D.16B.
Structural example
Minimal example of an DOCADV D.16B message with mandatory segments only. The goal is to show the exact version declared in UNH (DOCADV:D:16B:UN) — not to replicate a full business case (see the DOCADV D.96A page for an annotated example).
UNB+UNOC:3+5410000000123:14+5410000000456:14+260514:1430+CTRL016001'
UNH+1+DOCADV:D:16B:UN'
BGM+700+DOCADV-2026-0099+9'
RFF+ON:ORDER789'
BUS++17'
INP+27'
FCA+1'
DTM+137:20260514:102'
NAD+MS+5410000000123::9'
NAD+MR+5410000000456::9'
DOC+380+INV-2026-7811'
UNT+11+1'
UNZ+1+CTRL016001' Common errors
- Misaligned UNH tokens — The
UNH+...+DOCADV: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: DOCADV D.96A, DOCADV D.01B, DOCADV D.10A, DOCADV D.21B, DOCADV D.24A, DOCADV D.97A, DOCADV D.99B, DOCADV D.00B, DOCADV D.02B, DOCADV D.05A, DOCADV D.08A, DOCADV D.13B, DOCADV D.18B, DOCADV D.20B.
X12 functional equivalent: X12 824.