Coarri: User Manual
Coarri: User Manual
Coarri: User Manual
(Implementation Guide)
UN/EDIFACT MESSAGE
COARRI
(Container discharge/loading order)
Version 1.6 - 2
D.95B
Version: 1.6 - 2
Date: June 2016
Source: SMDG User Group for Shipping Lines and Container Terminals
SMDG User Group for Shipping Lines and Container Terminals 2
© SMDG
The SMDG claims full copyright to this manual and its contents, however, the manual may be copied and
used by anyone, without the consent of SMDG.
Revision History
Version Date Author(s) Revision Notes
1.2 March 2003 SMDG Created version
1.6 October 2015 Paul Wauters Extended for Gross Weight Verification
1.6-1 January 2016 Paul Wauters Updated UNECE official codes/qualifiers
1.6-2 June 2016 Paul Wauters Aligned VGM additions with existing info
CONTENTS
0. Introduction ............................. 4
1. General ................................. 4
3. Document Maintenance...................... 6
4. Versions ............................... 7
0. INTRODUCTION
This User Manual has been developed by the SMDG User Group for Shipping Lines and Container
Terminals, a “Global User Group“ under the auspices of UN/CEFACT.
This User Manual is based upon the UN/EDIFACT D.95B directory and the ITIGG document “Principles
and Rules for the implementation of transport EDI messages – Transport Equipment Movements –
Maritime-related container messages”, version 1.3.1, dated September 1996.
This User Manual provides guidance as to the recommended usage of codes, qualifiers, data elements,
composites, segments and groups of segments in the D.95B COARRI message. The intention is to assist
developers to ensure consistent use of the COARRI message throughout the worldwide trade and
transport community.
Syntax identifier: alway 'UNOA', indicating the use of level 'A' character set. Syntax version number:
always '2'.
1. GENERAL
Formal Definition
"A message by which the container terminal reports that the containers specified have been discharged
from a seagoing vessel (discharged as ordered, overlanded or shortlanded), or have been loaded into a
seagoing vessel. This message is part of a total set of container-related messages. These messages serve
to facilitate the intermodal handling of containers by streamlining the information exchange. The business
scenario for the container messages is clarified in a separate document, called “Guide to the scenario of
EDIFACT container messages”.
The COARRI message is used to transmit a confirmation that containers have been loaded onto or have
been discharged from a seagoing vessel. This message is commonly sent by the terminal operator
handling the vessel to the shipping line (or it’s agent).
A message contains a report for either discharged or loaded containers or other equipment from or into
the vessel. The term equipment in this manual includes not only supporting items (e.g. reefer
generator) but also uncontainerised cargo.
A message contains information on only one conveyance of a seagoing con¬tainer vessel either arrived
or departed.
One report does not necessarily cover all containers being discharged/loaded, this being the case if two
or more liner agents or shipowners supplied orders to the terminal referring to one vessel conveyance.
The COARRI message may also be used to confirm that containers have been shifted on board the vessel
or that containers have been discharged and reloaded (re-stowed) onto the vessel.
The COARRI message as discharge report can also include information relating to transhipment (=
import of transhipment containers): on the same terminal containers have been discharged from vessel
X for loading into vessel Y.
Status Indicators (“M” and “C”) form part of the UN/EDIFACT standard and indicate a minimum
requirement to fulfil the needs of the message structure. They are not adequate for implementation
purposes. The Status Indicators are :
Value Description
M Mandatory
The entity marked as such must appear in all messages, and apply to
these messages as well as to any associated implementation guidelines
(and consequently is also a Usage Indicator).
C Conditional
The entity is used by agreement between trading partners.
Usage Indicators
Usage Indicators are implementation–related indicators that further detail the use of “Conditional”
Status Indicators. Usage Indicators are applied at all levels of the guidelines and shown adjacent to data
items such as segment groups, segments, composite data elements and simple data elements. They
dictate the agreed usage of the data items or entities. The Usage Indicators are :
Value Description
M Mandatory
Indicates the item is mandatory in the UN/EDIFACT message.
R Required
Indicates the item must be transmitted in this implementation.
D Dependent
Indicates that the use of the item is depending on a well-defined condition
or set of conditions. These conditions must be clearly specified in the
relevant implementation guideline.
O Optional
Indicates that this item is at the need or discretion of both trading
partners.
X Not Used
Indicates that this item is not to be used in this implementation.
Where an item within a segment group, segment or composite data element is marked with Usage
Indicators “M” or “R”, but the segment group, segment or composite data element has been marked “O”
or “D” (or for that matter “X”), the item is only to be transmitted when the segment group, segment or
composite of which it is a part, is used.
3. DOCUMENT MAINTENANCE
The data content of this document has been prepared and approved by SMDG and no alteration may be
made to the content of this document without reference to and approval of SMDG.
Any remarks, questions, amendments or requested alterations to this document are to be addressed to :
SMDG Secretariat
Seattleweg 7
3195 ND Rotterdam – Pernis
The Netherlands
Paul Wauters
c/o PSA Antwerp / Cosmos NV.
Napelsstraat 79
2000 Antwerp
Belgium
4. VERSIONS
SMDG16.
Version 1.6 (SMDG16), first released October 2015, is the successor of version 1.2 (ITIG12), released
October 1996, includes amendments for transmission of data specifying a container’s verified gross mass
(VGM) according to SOLAS regulation 2, chapter VI, paragraphs 4 to 6.
With a short deadline (July 2016) it was decided to do minimum changes - what was considered as an
absolute (legal) minimum - to limit the impact on EDI and backend systems of different organizations.
It was decided to make additions in the current version without structure changes via existing segments
and data elements. Only necessary new qualifiers and/or codes will be requested via DMR.
To handle the new SOLAS requirements on Gross Mass Verification, DMR (Data Maintenance Request)
for new codes, to handle the new entities, will be submitted to UN/CEFACT.
The acceptance of these DMR’s are available as from version D.15B The Message Implementation
Guides can use ‘Temporary’ codes indicated between square brackets [xxx] and codes only available in
a later version.
Changes for SOLAS in this manual: (codes used as available from UN/EDIFACT version D.15B.)
MEA – Measurements
VGM – Verified Gross Mass (weight)
DTM – Date/Time
798 - Verified gross mass determination date/time - Date/Time when a gross mass (weight) of a
packed container was obtained according to SOLAS chapter VI, regulation 2, paragraphs 4-6
RFF – References
VGR – Verified Gross Mass Reference – link to VGM information
Introduction:
A message by which the container terminal reports that the containers specified have been discharged
from a seagoing vessel (discharged as ordered, overlanded or shortlanded), or have been loaded into a
seagoing vessel.
This message is part of a total set of container-related messages. These messages serve to facilitate the
intermodal handling of containers by streamlining the information exchange. The business scenario for
the container messages is clarified in a separate document, called: 'Guide to the scenario of EDIFACT
container messages'.
9
TMD
C
9999
9
EQD
RFF
3M
C
9
9
NAD
CTA
2M
C
9
DTM
C
9
LOC
C
1
9
TDT
RFF
1M
C
9
RFF
C
9
FTX
C
1
BGM
M
1
UNH
M
LEVEL
9
EQA
C
9
DGS
C
9
FTX
C
9
SEL
C
9
RNG
C
9
TMP
C
9
DIM
C
9
MEA
C
9
LOC
C
9
DTM
C
LEVEL
1
UNT
M
1
CNT
M
1
NAD
C
9
DTM
C
1
9
LOC
TDT
5C
C
9
1
DAM
COD
4C
C
9
PIA
C
LEVEL
N.B. If in element 1225 the code values 2,3,4 or 5 are used the top level RFF (ACW) shall indicate the
relation to a previous message.
Segment Summary
User Pos. Seg. Req. Max. Group:
Attribute No. ID Name Des. Use Repeat
0060 TDT Details of Transport M 1
0070 RFF Reference C 9
0080 LOC Place/Location Identification C 9
0090 DTM Date/Time/Period C 9
Association/SCAC
X 3128 Carrier name C an..35
Name of party undertaking or arranging transport of goods between
named points.
X 8101 TRANSIT DIRECTION, CODED C an..3
Identification of the point of origin and point of direction.
X C401 EXCESS TRANSPORTATION INFORMATION C
X 8457 Excess transportation reason, coded M an..3
X 8459 Excess transportation responsibility, coded M an..3
X 7130 Customer authorization number C an..17
R C222 TRANSPORT IDENTIFICATION C
Code and/or name identifying the means of transport.
R 8213 Id. of means of transport identification C an..9
Identification of the means of transport by name or number.
Vessel code
1. international radio call sign (recommended)
2. Lloyd's number
R 1131 Code list qualifier C an..3
Identification of a code list.
103 Radio Call sign directory
146 Lloyd's register of ships
X 3055 Code list responsible agency, coded C an..3
Code identifying the agency responsible for a code list.
O 8212 Id. of the means of transport C an..35
Identification of the means of transport by name or number.
Name of the vessel
X 8453 Nationality of means of transport, coded C an..3
Coded name of the country in which a means of transport is registered.
X 8281 TRANSPORT OWNERSHIP, CODED C an..3
Segment Summary
User Pos. Seg. Req. Max. Group:
Attribute No. ID Name Des. Use Repeat
0110 NAD Name and Address M 1
0120 CTA Contact Information C 9
Segment Summary
User Pos. Seg. Req. Max. Group:
Attribute No. ID Name Des. Use Repeat
0140 EQD Equipment Details M 1
0150 RFF Reference C 9
0160 TMD Transport Movement Details C 9
0170 DTM Date/Time/Period C 9
0180 LOC Place/Location Identification C 9
0190 MEA Measurements C 9
0200 DIM Dimensions C 9
0210 TMP Temperature C 9
0220 RNG Range Details C 9
0230 SEL Seal Number C 9
0240 FTX Free Text C 9
0250 DGS Dangerous Goods C 9
0260 EQA Attached Equipment C 9
0270 PIA Additional Product Id C 9
0280 Segment Group 4: Damage C 9
0310 Segment Group 5: Details of Transport C 1
0350 NAD Name and Address C 1
Referring to the use of data elements 8053, 8260, 8155, 8154 (EQD), of RFF segment, of EQN segment, of
FTX segment and of EQA segment two cases have to be taken into consideration:
1. Reporting one container or swapbody where prefix and serial number are known:
N.B. C237 and C224 are required except in the case of break bulk.
N.B. The use of 8249 code ‘5' (Shifter/Restow) has to be agreed between partners.
N.B. Inspite of the given field length of element e6245 (format N3) decimal marks and negative values
preceded by a minus sign can be transmitted. Generally numeric data element values shall be
regarded as positive unless they are preceded by a minus sign. Decimal mark and minus sign
shall, however, not be counted as a character of the value when computing the maximum field
length.
Tenth degrees have to be separated by a decimal point from full degrees (e.g. 18.5).
Temperatures below zero have to be preceded by a minus sign (e.g. -18.5). The same applies for
elements e6152 and e6162 in the RNG segment.
For further explanation please refer to ISO 9735 'EDIFACT Application Level Syntax Rules', par. 10
'Representation of numeric data element values'.
If 4451=‘ABS’: codes
61 Unpacking (LCL delivery)
62 Positioning by third party
63 To be inspected
64 Requires special service
65 Requires pre-trip
66 Requires steam clean
67 Clean
68 Dirty
69 For unpacking
70 Under bond
71 Free store
72 Customs stop
73 Customs stop removed
74 Quarantine stop
75 Quarantine stop removed
76 Storage/other stop
7 Repaired
8 Damaged
9 Unknown
10 Not available
If 4451=‘HAN’: codes
AB Away from boiler
AF Away from foodstuff
AL Away from living quarters
BC Block stowage
EO Except on decktop
KC Keep cool
NO No overstow
OD On deck stowage
OP On deck protected
OT On decktop
TS Top stowage
UD Under deck stowage
UT Under deck top stowage
UW Under waterline
RF Equipment off-repair
RN Equipment on-repair
SP Equipment put aside for inspection
SQ Equipment stuff on quay
UQ Equipment unstuff on quay
TF Equipment transfer from shipping line
TT Equipment transfer to shipping line
IN Equipment receival
IO Equipment left and received
CVE Set clear for verification
CAP Set clear for appraisal
CFU Set clear for fumigation
CSP Set clear for inspection
COR Set clear for other reasons
BRS Block order - reserved for specific order
BSO Block order - shipper owned container
BSU Block order - unit sold
BNC Block order - no use for commercial announcement
RCT Reefer order - to connect to terminal electric means and control
temperature
RCD Reefer order - to connect to diesel group and control temperature
RCO Reefer order - to connect to clip on and control temperature
RPT Reefer order - pre-trip inspection
RTA Reefer order - to tank a reefer container
LLO Load
LDI Discharge
LBU To be bundled
LGO General order
LLA Lash
LME To be measured
LSH Shift on the same means of transport
LST Stick
LWE To be weighed
N.B. This segment is not generally machine processable. Use of this segment must be agreed between partners!
transport.
Segment Summary
User Pos. Seg. Req. Max. Group:
Attribute No. ID Name Des. Use Repeat
0290 DAM Damage M 1
0300 COD Component Details C 1
Segment Summary
User Pos. Seg. Req. Max. Group:
Attribute No. ID Name Des. Use Repeat
0320 TDT Details of Transport M 1
0330 LOC Place/Location Identification C 9
0340 DTM Date/Time/Period C 9
8. SAMPLE MESSAGE
Keeping in mind that an EDIFACT message is an uninterrupted character string every segment in this
example is printed in a new line in order to obtain better readability.
Example #1: LOADING report for one standard and one DG container
UNB+UNOA:2+DEHAMHLOFEPLAN+DEHAMHHLBUKAI1+950725:1122+1'
UNH+2+COARRI:D:95B:UN:ITG12' Header information
BGM+270+19950000003+9' COARRI loading report
TDT+20+4321+1++HLC:172:20+++DHEE:103::ESSEN XPR' Vessel
LOC+9+DEHAM:139:6+BK8:BER:ZZZ' Port and berth of loading
DTM+132:199507252000:203' Arrival date/time
NAD+CA+HLC:160:20' Carrier
CNT+1:1' dummy
UNT+33+2' Reference to UNH
UNZ+1+1' Reference to UNB
Example #2: LOADING report for two break bulk pieces where piece #1 shall be
stowed on a platform and piece #2 shall be stowed without supporting equipment
UNB+UNOA:2+DEHAMTCSSTCENT+DEHAMHHLBUKAI1+950725:1122+1'
UNH+2+COARRI:D:95B:UN:ITG12' Header information
BGM+270+19950000004+9' COARRI loading report
TDT+20+4444+1++BSC:172:20+++UJDB:103:' Vessel
RFF+VON+3333' Alternative voyage number
LOC+9+DEHAM:139:6' Port of loading
DTM+132:199507252000:203' Arrival date/time
DTM+133:199507260830:203' Departure date/time
NAD+CA+BCL:160:20' Carrier
Example #3: DISCHARGE report for one overheight and one reefer container
UNB+UNOA:2+DEHAMHLOFEPLAN+DEHAMHHLBUKAI1+950725:1122+1'
UNH+2+COARRI:D:95B:UN:ITG12' Header information
BGM+98+19950000003+9' COARRI discharge report
TDT+20++1++HLC:172:20+++DHEE:103::ESSEN XPR' Vessel
LOC+11+DEHAM:139:6+BK6:BER:ZZZ' Port and berth of discharge
DTM+132:199507252000:203' Arrival date/time
DTM+133:199507260830:203' Departure date/time
NAD+CA+HLC:160:20' Carrier
Example #2: DISCHARGE report for two break bulk pieces where piece #1 is
stowed on two platforms and piece #2 is stowed without supporting equipment
UNB+UNOA:2+DEHAMTCSSTCENT+DEHAMHHLBUKAI1+950725:1122+1'
UNH+2+COARRI:D:95B:UN:ITG12' Header information
BGM+98+19950000004+9' COARRI discharge report
TDT+20+4444+1++BSC:172:20+++UJDB:103' Vessel
LOC+11+DEHAM:139:6' Port of discharge
DTM+132:199507252000:203' Arrival date/time
DTM+133:199507260830:203' Departure date/time
NAD+CA+BCL:160:20' Carrier