Version History

Version 0.1 - 2016-11-04
Draft, for demonstration purposes
Version 0.2 - 2016-11-08
2nd draft version
Version 0.3 - 2016-12-12
3rd draft
Version 0.4 - 2017-01-27
4th draft

General

Subset definition

Message subset which covers despatch advice messages sent to Company X using EDIFACT DESADV D.00A message format.

Functional definition

A message specifying details for goods despatched or ready for despatch under agreed conditions.

The United Nations Despatch Advice Message serves both as a specification for Delivery Despatch Advice and also as a Returns Despatch Advice message. Throughout this document, the reference to 'Despatch Advice' may be interpreted as conveying the wider meaning of 'Delivery Despatch Advice/Returns Despatch Advice'.

Field of application

The Despatch advice message may be used for both national and international applications. It is based on universal practice related to administration, commerce and transport, and is not dependent on the type of business or industry.

Subset abbreviations

Default statuses:

M
Mandatory
C
Conditional

Custom statuses for items with default status "Conditional":

R
Required (= Mandatory)
A
Advised / Recommended
D
Depending (= Mandatory in certain conditions)
O
Optional
X
Excluded / Not used
F
Forbidden

Item status & max repeat:

M 1
Mandatory, must be repeated exactly once
C 99
Conditional, can be repeated at most 99 times
R 5
Required, must be repeated atleast once and at most 5 times

Item data types:

an..35
alphanumeric value, at most 35 characters
an3
alphanumeric value, exactly 3 characters
n..9
numeric value, at most 9 numbers
n3
numeric value, exactly 3 numbers
a1
alphabetic characters, exactly 1 character

Message Structure

Tag St Rp Name
UNH M 1 MESSAGE HEADER
BGM M 1 BEGINNING OF MESSAGE
DTM R 2 DATE/TIME/PERIOD
GRP1 C 10 RFF-DTM
|--RFF M 1 REFERENCE
|--DTM C 1 DATE/TIME/PERIOD
GRP2 R 99 NAD
|--NAD M 1 NAME AND ADDRESS
GRP10 R 9999 CPS-GRP11-GRP17
|--CPS M 1 CONSIGNMENT PACKING SEQUENCE
|-- GRP11 R 9999 PAC-MEA
|--|--PAC M 1 PACKAGE
|--|--MEA R 10 MEASUREMENTS
|-- GRP17 R 9999 LIN-QTY-GRP18
|--|--LIN M 1 LINE ITEM
|--|--QTY R 10 QUANTITY
|--|-- GRP18 A 99 RFF-DTM
|--|--|--RFF M 1 REFERENCE
|--|--|--DTM C 1 DATE/TIME/PERIOD
UNT M 1 MESSAGE TRAILER

Message Segments

UNH M 1 MESSAGE HEADER

A service segment starting and uniquely identifying a message. The message type code for the Despatch advice message is DESADV.

TagNameStTypeNotes
0062 MESSAGE REFERENCE NUMBER M an..14
S009 MESSAGE IDENTIFIER M
0065 Message type M an..6
DESADV
Despatch advice message
Other codes are forbidden.
0052 Message version number M an..3
D
Draft version/UN/EDIFACT Directory
Other codes are forbidden.
0054 Message release number M an..3
00A
Release 2000 - A
Other codes are forbidden.
0051 Controlling agency, coded M an..3
UN
UN/CEFACT
Other codes are forbidden.
Example
UNH+1+DESADV:D:00A:UN'

BGM M 1 BEGINNING OF MESSAGE

A segment for unique identification of the Despatch Advice document, by means of its name and its number.

TagNameStTypeNotes
C002 DOCUMENT/MESSAGE NAME R
1001 Document name code R an..3
351
Despatch advice
Other codes are forbidden.
C106 DOCUMENT/MESSAGE IDENTIFICATION R
1004 Document identifier R an..35
Example
BGM+351+123456'

DTM R 2 DATE/TIME/PERIOD

Date/time/period related to the whole message. The DTM segment must be specified at least once to identify the Despatch Advice date.

TagNameStTypeNotes
C507 DATE/TIME/PERIOD M
2005 Date or time or period function code qualifier M an..3
137
Document/message date/time
Other codes are skipped.
2380 Date or time or period value R an..35 Pattern: [0-9]{8}
Example: 20161101
2379 Date or time or period format code R an..3
102
CCYYMMDD
Other codes are forbidden.
Example
DTM+137:20150515:102'

GRP1 C 10 RFF-DTM

A group of segments giving references where necessary, their dates relating to the whole message, e.g. contract number.

Remarks
Provide references primarily on a header level.

RFF M 1 REFERENCE

A segment for referencing documents relating to the whole despatch advice message, e.g. purchase orders, delivery instructions, import/export license.

TagNameStTypeNotes
C506 REFERENCE M
1153 Reference function code qualifier M an..3
CO
Buyers order number
Other codes are skipped.
1154 Reference identifier R an..25

GRP1 C 10 RFF-DTM

DTM C 1 DATE/TIME/PERIOD

Date/time/period from the referred document.

TagNameStTypeNotes
C507 DATE/TIME/PERIOD M
2005 Date or time or period function code qualifier M an..3
2380 Date or time or period value R an..35 Pattern: [0-9]{8}
Example: 20161101
2379 Date or time or period format code R an..3
102
CCYYMMDD
Other codes are forbidden.

GRP2 R 99 NAD

A group of segments identifying names, addresses, locations, and required supporting documents relevant to the whole Despatch Advice.

Remarks
Here comes segment group specific remarks.

NAD M 1 NAME AND ADDRESS

A segment for identifying names, addresses, and their functions relevant to the whole Despatch Advice. Identification of the parties involved is recommended for the Despatch Advice message, and is to be given in the NAD segment. It is recommended that where possible, only the coded form of the party ID should be specified, e.g. the buyer and seller are known to each other, thus only the coded ID is required. The consignee or delivery address may vary and would have to be clearly specified, preferably in structured format.

TagNameStTypeNotes
3035 PARTY FUNCTION CODE QUALIFIER M an..3 Here comes element specific remarks.
CZ
Consignor
BY
BuyerHere comes qualifier BY specific remarks.
DP
Delivery party
ZZ
Bilaterally agreed party
Other codes are skipped.
C082 PARTY IDENTIFICATION DETAILS R Here comes composite specific remarks.
3039 Party identifier M an..15
1131 Code list identification code C an..3
100
Enhanced party identification
Other codes are forbidden.
3055 Code list responsible agency code C an..3
92
Assigned by buyer or buyer's agent
Other codes are forbidden.
C058 NAME AND ADDRESS X
C080 PARTY NAME R
3036 Party name M an..35
3036 Party name C an..35
Example
NAD+CZ+5678765::92++ZXC Consignor'
Remarks
Here comes segment specific remarks.

GRP10 R 9999 CPS-GRP11-GRP17

A group of segments providing details of all package levels and of the individual despatched items contained in the consignment. This segment group provides the capability to give the hierarchical packing relationships. The group defines a logical top-down order structure. The lowest level package information of the hierarchy is followed by the detail product information.

CPS M 1 CONSIGNMENT PACKING SEQUENCE

A segment identifying the sequence in which packing of the consignment occurs, e.g. boxes loaded onto a pallet.

TagNameStTypeNotes
7164 HIERARCHICAL STRUCTURE LEVEL IDENTIFIER M an..35
7166 HIERARCHICAL STRUCTURE PARENT IDENTIFIER X
7075 PACKAGING LEVEL CODE C an..3
1
Inner
Other codes are skipped.
Example
CPS+123456789987654321++1'

GRP11 R 9999 PAC-MEA

A group of segments identifying packaging, physical dimensions, marks and numbers, quantities, date and time information, handling information and information about packing at this level.

PAC M 1 PACKAGE

A segment specifying the number and type of the packages/physical units and the physical type of packaging for the despatched goods.

TagNameStTypeNotes
7224 PACKAGE QUANTITY R n..8
Example
PAC+1'

GRP11 R 9999 PAC-MEA

MEA R 10 MEASUREMENTS

A segment specifying physical measurements of the packages/physical units described in the PAC segment.

TagNameStTypeNotes
6311 MEASUREMENT ATTRIBUTE CODE M an..3
AAE
Measurement
Other codes are skipped.
C502 MEASUREMENT DETAILS R
6313 Measured attribute code R an..3
ABJ
Volume
Other codes are skipped.
C174 VALUE/RANGE R
6411 Measurement unit code M an..3
6314 Measurement value R an..18
Example
MEA+AAE+ABJ+LTR:500'

GRP17 R 9999 LIN-QTY-GRP18

A group of segments providing details of the individual despatched items.

LIN M 1 LINE ITEM

A segment identifying the product being despatched. All other segments in the detail section following the LIN segment refer to that line item.

TagNameStTypeNotes
1082 LINE ITEM IDENTIFIER R an..6
1229 ACTION REQUEST/NOTIFICATION DESCRIPTION CODE X
C212 ITEM NUMBER IDENTIFICATION R
7140 Item identifier R an..35
7143 Item type identification code R an..3
SA
Supplier's article number
VN
Vendor item number
Other codes are skipped.
Example
LIN+1++123456:SA'

GRP17 R 9999 LIN-QTY-GRP18

QTY R 10 QUANTITY

A segment to give quantity information concerning the product.

TagNameStTypeNotes
C186 QUANTITY DETAILS M
6063 Quantity type code qualifier M an..3
12
Despatch quantity
Other codes are skipped.
6060 Quantity M an..35
6411 Measurement unit code R an..3
Example
QTY+12:200:PC'

GRP18 A 99 RFF-DTM

A group of segments to give reference numbers and dates.

RFF M 1 REFERENCE

A segment identifying documents related to the line item.

TagNameStTypeNotes
C506 REFERENCE M
1153 Reference function code qualifier M an..3
CO
Buyers order number
Other codes are skipped.
1154 Reference identifier R an..35
1156 Document line identifier R an..6
Example
RFF+CO:1234:10'

GRP18 A 99 RFF-DTM

DTM C 1 DATE/TIME/PERIOD

A segment for date/time/period relative to the referred document.

TagNameStTypeNotes
C507 DATE/TIME/PERIOD M
2005 Date or time or period function code qualifier M an..3
171
Reference date/time
Other codes are forbidden.
2380 Date or time or period value R an..35 Pattern: [0-9]{8}
Example: 20161101
2379 Date or time or period format code R an..3
102
CCYYMMDD
Other codes are forbidden.
Example
DTM+171:20150513:102'

UNT M 1 MESSAGE TRAILER

A service segment ending a message, giving the total number of segments in the message (including the UNH & UNT) and the control reference number of the message.

TagNameStTypeNotes
0074 NUMBER OF SEGMENTS IN A MESSAGE M n..10
0062 MESSAGE REFERENCE NUMBER M an..14
Example
UNT+19+1'