PARTIN — EDIFACT Party Information Message (D.21B)
The PARTIN message conveys the master data of a trade partner: commercial identifiers, contact details, billing and shipping addresses, banking and tax information. It is used to initialise or update EDI partner directories. This page summarises the segment structure as published by UN/CEFACT for directory D.21B.
Purpose
The PARTIN message conveys the master data of a trade partner: commercial identifiers, contact details, billing and shipping addresses, banking and tax information. It is used to initialise or update EDI partner directories.
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 partin_c.htm hosted on service.unece.org.
Segment structure
The PARTIN D.21B message has 13 header entries, 52 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 | DTM | Date/time/period | M | ×5 |
00040 | FII | Financial institution information | C | ×10 |
00050 | FTX | Free text | C | ×5 |
00060 | SG1 | Group (×5) | C | ×5 |
00070 | RFF | Reference | M | 1 |
00080 | DTM | Date/time/period | C | 1 |
00090 | SG2 | Group (×2) | C | ×2 |
00100 | NAD | Name and address | M | 1 |
00110 | SG3 | Group (×5) | C | ×5 |
00120 | CTA | Contact information | M | 1 |
00130 | COM | Communication contact | C | ×5 |
Detail
| Pos. | Tag | Name | S | Rep. |
|---|---|---|---|---|
00140 | UNS | Section control | M | 1 |
00150 | SG4 | Group (×200000) | C | ×200000 |
00160 | NAD | Name and address | M | 1 |
00170 | DTM | Date/time/period | C | ×5 |
00180 | FII | Financial institution information | C | ×10 |
00190 | IDE | Identity | C | ×9 |
00200 | FTX | Free text | C | ×9 |
00210 | TAX | Duty/tax/fee details | C | ×9 |
00220 | HYN | Hierarchy information | C | ×9 |
00230 | SG5 | Group (×99) | C | ×99 |
00240 | LOC | Place/location identification | M | 1 |
00250 | DTM | Date/time/period | C | ×2 |
00260 | SG6 | Group (×15) | C | ×15 |
00270 | RFF | Reference | M | 1 |
00280 | DTM | Date/time/period | C | 1 |
00290 | SG7 | Group (×5) | C | ×5 |
00300 | CTA | Contact information | M | 1 |
00310 | COM | Communication contact | C | ×5 |
00320 | SG8 | Group (×10) | C | ×10 |
00330 | SCC | Scheduling conditions | M | 1 |
00340 | DTM | Date/time/period | C | ×2 |
00350 | SG9 | Group (×1) | C | 1 |
00360 | TOD | Terms of delivery or transport | M | 1 |
00370 | LOC | Place/location identification | C | 1 |
00380 | SG10 | Group (×999) | C | ×999 |
00390 | PAI | Payment instructions | M | 1 |
00400 | PYT | Payment terms | C | 1 |
00410 | CUX | Currencies | C | ×2 |
00420 | DTM | Date/time/period | C | ×9 |
00430 | PCD | Percentage details | C | ×9 |
00440 | MOA | Monetary amount | C | ×9 |
00450 | SG11 | Group (×999) | C | ×999 |
00460 | RCS | Requirements and conditions | M | 1 |
00470 | MOA | Monetary amount | C | ×9 |
00480 | QTY | Quantity | C | ×9 |
00490 | SG12 | Group (×999) | C | ×999 |
00500 | CCI | Characteristic/class id | M | 1 |
00510 | MOA | Monetary amount | C | ×9 |
00520 | QTY | Quantity | C | ×9 |
00530 | CAV | Characteristic value | C | ×9 |
00540 | DTM | Date/time/period | C | ×9 |
00550 | MEA | Measurements | C | ×9 |
00560 | SG13 | Group (×999) | C | ×999 |
00570 | PRC | Process identification | M | 1 |
00580 | DTM | Date/time/period | C | ×9 |
00590 | SG14 | Group (×999) | C | ×999 |
00600 | LIN | Line item | M | 1 |
00610 | NAD | Name and address | M | 1 |
00620 | SG15 | Group (×99) | M | ×99 |
00630 | DOC | Document/message details | M | 1 |
00640 | DTM | Date/time/period | C | ×9 |
00650 | UNT | Message trailer | M | 1 |
Summary
No segment in this section.
Changes vs D.96A
Top-level differences between D.96A and D.21B for the PARTIN 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
IDEin the detail section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.FTXin the detail section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.TAXin the detail section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.HYNin the detail section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.PYTin the detail section (status C, 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.MOAin the detail section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.RCSin the detail section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.QTYin the detail section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.CCIin the detail section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.CAVin the detail section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.MEAin the detail section (status C, repeat ×9) — not present at the top of the corresponding D.96A section.PRCin the detail section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.LINin the detail section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.DOCin the detail section (status M, repeat ×1) — not present at the top of the corresponding D.96A section.
Segments removed vs D.96A
PATin the detail section — present in D.96A but missing in D.21B at the same level.
Structural example
Minimal example of an PARTIN D.21B message with mandatory segments only. The goal is to show the exact version declared in UNH (PARTIN:D:21B:UN) — not to replicate a full business case (see the PARTIN D.96A page for an annotated example).
UNB+UNOC:3+5410000000123:14+5410000000456:14+260514:1430+CTRL021001'
UNH+1+PARTIN:D:21B:UN'
BGM+23+PARTIN-2026-0301+9'
DTM+137:20260514:102'
NAD+BY+5410000000123::9++EDIVERSE SAS+10 RUE DE PARIS+PARIS++75001+FR'
CTA+IC+:Pierre Martin'
COM+pierre.martin@example.com:EM'
FII+BF+FR7630001007941234567890185:CCBPFRPPVER:25'
UNT+7+1'
UNZ+1+CTRL021001' Common errors
- Misaligned UNH tokens — The
UNH+...+PARTIN: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: PARTIN D.96A, PARTIN D.01B, PARTIN D.10A, PARTIN D.16B, PARTIN D.24A, PARTIN D.97A, PARTIN D.99B, PARTIN D.00B, PARTIN D.02B, PARTIN D.05A, PARTIN D.08A, PARTIN D.13B, PARTIN D.18B, PARTIN D.20B.
X12 functional equivalent: X12 838.