Frames | No Frames

Return to Stylus Studio EDIFACT home page.
Return to Stylus Studio EDIFACT D00A Messages page.
UN/EDIFACT
UNITED NATIONS STANDARD MESSAGE (UNSM)

Container announcement message

Version:D
Release:00A
Contr. Agency:UN
Revision:7
Date:2000-01-27
SOURCE:Joint Transport Group (JM4)

CONTENTS
Container announcement message
  1. INTRODUCTION
  2. SCOPE
    1. Functional definition
    2. Field of application
    3. Principles
  3. REFERENCES
  4. TERMS AND DEFINITIONS
    1. Standard terms and definitions
  5. MESSAGE DEFINITION
    1. Segment clarification
    2. Segment index (alphabetical sequence)
    3. Message structure
      1. Segment table

For general information on UN standard message types see UN Trade Data Interchange Directory, UNTDID, Part 4, Section 2.3, UN/ECE UNSM General Introduction


This message also occurs in the following versions of this standard:
D95A, D95B, D96A, D96B, D97A, D97B, D98A, D98B, D99A, D99B, D00A, D00B, D01A, D01B, D01C, D02A, D02B, D03A, D03B, D04A, D04B

0. INTRODUCTION

This specification provides the definition of the Container announcement message (COPARN) to be used in Electronic Data Interchange (EDI) between trading partners involved in administration, commerce and transport.


1. SCOPE


1.1. Functional definition

The message contains an order to release, to make available, to accept or to call down containers or to announce the impending arrival of containers.

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 order may pertain to cargo related containers (full container load and less than container load), the arrangement of empty containers prior to loading and after stripping, as well as the arrangements for leasing the empty containers (on- hire and off-hire of containers).


1.2. Field of application

The Container announcement 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.


1.3. | Principles

Business area: Pre- and on-carriage transport of containers/equipment

Sending functions include: Shipper, Freight forwarder, Shipping agent, Container freight station, Consignee

Receiving functions include: Freight forwarder, Shipping agent, Container terminal, Inland terminal, Container depot, Container freight station, Container lessor

In the context of the 'Guide to the scenario of EDIFACT container messages' (as referred to at the start of section 1) the following guidelines, rules and functionality apply to this Container announcement message:

  • The message contents can normally be uniquely identified by a combination of the following data elements:
  • ordering customer, coded (NAD)
  • ordering customer agent, coded (NAD)
  • container announcement reference number (being the container release order reference, acceptance order reference, disposition order reference) (RFF)
  • related container announcement reference (reference to container disposition order) (RFF)

In case the COPARN is used as an empty container notice the identification is normally achieved by:

  • carrier agent, coded (shipping agent) (EQD/NAD)
  • carrier, coded (shipping line) (TDT)
  • carrier agent's reference number (EQD/RFF)

In case the COPARN is used as an on-hire request or order the identification is normally achieved by:

  • message sender (NAD)
  • lessee's reference (RFF)
  • indication on-hire request or order (BGM)

In case the Container announcement message is used as an off- hire request or notice the identification is normally achieved by:

  • message sender (NAD)
  • return reference (RFF)
  • indication off-hire request or notice (BGM)

The ordering customer agent, coded is needed to supplement the unique identification only in the next situation: the agent acts on behalf of several ordering customers issuing the same range of reference numbers for each customer. E.g. the ship's agent acts on behalf of several shipping lines issuing for each shipping line the same range of numbers.

  • One shipping line, one seagoing vessel, one sea voyage number and one shipping agent can be specified on message top level.
  • An indicator for the transport status (i.e., export, import, transhipment or continental) can be completed on container level (EQD-segment).
  • One message may contain several containers identified by their prefix and number or several equipment guidelines for groups of (empty) containers.
  • If the container prefix and number is unknown (in the Empty container disposition order or Container release order), a supplementary container reference number (Container sequence number) is used to identify a container group in the message to be able to refer to this information of the container(s) in e.g. the Container release order or the Container gate-in/gate- out message.
  • In case of an Empty container disposition order several equipment guidelines can be specified in the message in order to load (empty) containers that cannot be identified by their full prefix and serial numbers. In case of a guideline a combination of size and type and/or a certain range of equipment serial numbers (container prefix and numbers) can be given for a group of one or several containers.
  • Inland transport details can be specified for each individual container or can be specified on message level (for all containers in the message); the two options must not be used simultaneously.
  • An inland transport charges reference or a sea booking reference can be specified either on message level (related to all containers in the message) or for each individual container; the two options must not be used simultaneously.
  • In case of an Empty container disposition order or a Call down order the place of positioning, related reference and date/time of positioning of the containers can be specified either on message level (related to all goods items in the message) or for each individual goods item (as the place where the goods item is to be stuffed or stripped); the two options must not be used simultaneously. In the latter case up to 10 places of positioning for each goods item to be stripped from or stuffed in the container(s) can be included in the message.
  • In case of an Acceptance order the date and time of positioning of the containers at the place of positioning can be specified for each individual container.
  • The final place of positioning can be included in case of routing via an inland terminal or several container freight stations (for stacking purposes).
  • For each container up to 3 communication addresses can be specified to which a copy of the Container gate-in/gate-out report message is to be sent.
  • For each container details can be specified such as container prefix and number, size/type, loading instructions, special instructions, seals, temperature, dangerous goods and off-dimensions details.
  • In case of export the port of discharge and a port of transhipment can be specified for each individual container.
  • A goods item may be detailed, such as number and type of packages, goods description, gross weight, dangerous goods information and special instruction.
  • Goods item information can be related to the corresponding containers by linking the goods item group (GID) to the container details group(s) (EQD) by means of the SGP-segment.
  • In case of export for each goods item up to 9 declarant's reference numbers can be given; in case of goods declaration (Customs) at the place of stuffing also 9 accompanying (Customs) documents can be given.
  • The return address (in case of an off-hire notice) can be given on message level or on container level, but not simultaneously. The region for the empty equipment return (in the request) can be given on message level. The reference at the return address or region of return can be given at the same level.

The transport sub-working group (D4) has developed recommendations for a harmonised implementation of this message through its subgroup ITIGG (International Transport Implementation Guidelines Group). Users implementing the message are strongly advised to apply these recommendations, which may be obtained from the D4 secretariat.


2. REFERENCES

See UNTDID, Part 4, Chapter 2.3 UN/ECE UNSM - General Introduction, Section 1.


3. TERMS AND DEFINITIONS


3.1. Standard terms and definitions

See UNTDID, Part 4, Chapter 2.3 UN/ECE UNSM - General Introduction, Section 2.


4. MESSAGE DEFINITION


4.1. Segment clarification

This section should be read in conjunction with the segment table which indicates mandatory, conditional and repeating requirements.

0010 UNH, Message header

A service segment starting and uniquely identifying a message. The message type code for the Container announcement message is COPARN.

Note: Container announcement messages conforming to this document must contain the following data in segment UNH, composite S009:

Data element0065COPARN
0052D
005400A
0051UN

0020 BGM, Beginning of message

A segment to indicate the beginning of a message and to transmit identifying number and the further specification of the message type (in data element 1001: Document name code), such as Empty container disposition order, Release order, Pre-arrival notice, Acceptance order, Empty container notice, Call-down order, On-hire request, On-hire order, Off-hire request, Off-hire notice.

0030 TMD, Transport movement details

A segment to specify the haulage arrangement for the containers in the message, such as carrier haulage or merchant haulage.

0040 DTM, Date/time/period

A segment to indicate a date and time applying the message as a whole: - requested equipment positioning date and/or time - expected on-hire date and/or time - expected return period

0050 TSR, Transport service requirements

A segment to identify whether arrangements for the inland transport are to be made, whether equipment guidelines are applicable, whether Customs clearance is to be arranged and pick-up/delivery instructions.

0060 FTX, Free text

A segment to specify free form or processable supplementary information, such as: - change information - special instructions

0070 LOC, Place/location identification

A segment to identify a location applying to the entire message: - region of availability - empty equipment return region

0080 Segment Group 1: RFF-DTM

A group of segments to specify a reference relating to the whole message, and its date and/or time.

0090 RFF, Reference

A segment to express a reference which applies to the entire message, such as: - container announcement reference number - booking reference number - reference to previous message - lessee's reference - lessor's reference - lease contract reference - return reference (of the party returning on hire equipment) - collect reference (of party collecting specified leased equipment) - carrier's agent reference number

0100 DTM, Date/time/period

A segment to indicate date and/or time related to the reference.

0110 Segment Group 2: TDT-DTM-RFF-SG3

A group of segments to indicate details of the movement of containers by sea and by inland carriers, such as mode and means of transport, and locations.

0120 TDT, Details of transport

A segment to indicate information related to the main carriage stage of the transport (sea), such as voyage number or indication sea transport, vessel and carrier or liner. Information on related inland transport stage(s) can also be included, such as mode of inland transport, means of transport, and inland carrier, such as: - main-carriage transport (sea) - pre- or on-carriage transport - second pre- or on-carriage transport

0130 DTM, Date/time/period

A segment to indicate the arrival date and time of an inland means of transport such as a place or port of discharge or loading.

0140 RFF, Reference

A segment to provide a reference for the liner service, such as: - conference - marketing organization - syndicate - vessel sharing agreement

0150 Segment Group 3: LOC-DTM

A segment group to indicate places and ports corresponding to a transport stage.

0160 LOC, Place/location identification

A segment to specify a location associated with a transport stage such as final port or place of discharge or loading.

0170 DTM, Date/time/period

A segment to specify date(s) and time(s) related to a location.

0180 Segment Group 4: NAD-SG5-RFF-DTM

A group of segments to identify a party and/or addresses and a related contact and references.

0190 NAD, Name and address

A segment to identify the party's name and address, and function, and other addresses, such as: - ordering customer - ordering customer agent - message recipient - message sender - place of positioning - place of collection - final place of positioning - carrier agent (sea) - charges payer - place of acceptance name and address - invoicee - stripping address - return address - on hire party direct interchange - off hire party direct interchange - container survey agency

0200 Segment Group 5: CTA-COM

A group of segments to identify a contact and its communications related to the party.

0210 CTA, Contact information

A segment to identify a person or department of a message sender and/or message recipient, such as: - information contact

0220 COM, Communication contact

A segment to identify a communication number of a person or department to whom communication should be directed.

0230 RFF, Reference

A segment to identify a reference used by a party or at an address, such as: - reference at place of collection - reference at place of positioning - related container announcement reference (reference to Container disposition order) - transport costs reference number - reference at stripping address - reference at return address - reference at place of acceptance

0240 DTM, Date/time/period

A segment to indicate a date and time applying to the party, such as: - ultimate equipment positioning date/time - requested equipment positioning date/time

0250 Segment Group 6: GID-HAN-FTX-RFF-PIA-SG7-MEA-DIM-SG8-SG9-SG10

A group of segments to describe the goods items (to be) stuffed in or (to be) stripped from the containers.

0260 GID, Goods item details

A segment to identify a goods item (to be) stuffed in or (to be) stripped from the containers. A goods item can be identified by a goods item number.

0270 HAN, Handling instructions

A segment to specify handling instructions relating to the goods item, such as: - hazardous cargo - off-dimensions - Customs clearance

0280 FTX, Free text

A segment to describe the goods item or to provide special instructions.

0290 RFF, Reference

A segment to identify a reference to a goods item in case of export, such as: - shipowner's authorization number - declarant's reference number

0300 PIA, Additional product id

A segment to identify a commodity code.

0310 Segment Group 7: NAD-DTM-RFF

A group of segments to describe the address, reference and date/time for the stuffing or the stripping of the goods item in the containers.

0320 NAD, Name and address

A segment to identify the address applicable to the particular goods item, such as: - place of positioning (as the stuffing or stripping address for the goods item) - Customs clearance place - place of acceptance name and address - stripping address

0330 DTM, Date/time/period

A segment to indicate a date and time when the container is to be positioned, such as: - requested equipment positioning date/time - ultimate equipment positioning date/time

0340 RFF, Reference

A segment to identify a reference used by a party or at an address, such as: - reference at place of positioning - reference at place of acceptance - reference at stripping address

0350 MEA, Measurements

A segment to specify measurements, other than dimensions, applicable to a goods item, such as: - gross weight

0360 DIM, Dimensions

A segment to specify dimensions applicable to a goods item, such as: - gross dimensions

0370 Segment Group 8: DOC-DTM-LOC

A group of segments to specify documents related to the goods item.

0380 DOC, Document/message details

A segment to indicate a document related to the goods item.

0390 + DTM, Date/time/period

A segment to specify the date/time related to the document, such as: - document/message date/time - expiry date.

0400 + LOC, Place/location identification

A segment to identify a location related to the document, such as: - place of document issue

0410 Segment Group 9: SGP-MEA

A group of segments to specify the distribution of a goods item among the containers.

0420 SGP, Split goods placement

A segment to identify a container in which goods are transported.

0430 MEA, Measurements

A segment to specify the gross weight of that portion of the goods item in the container, such as: - gross weight - net net weight (dangerous goods)

0440 Segment Group 10: DGS-FTX-MEA

A group of segments to specify dangerous goods details related to the goods item. One goods item may be in different dangerous goods classes.

0450 DGS, Dangerous goods

A segment to indicate the dangerous goods regulations for the corresponding mode of transport, class of dangerous goods, additional dangerous goods code, UN-number and shipment flash point.

0460 FTX, Free text

A segment to specify supplementary details related to the dangerous goods, such as: - dangerous goods technical name - dangerous goods additional information

0470 MEA, Measurements

A segment to specify measurements of the dangerous goods, such as: - net net weight

0480 Segment Group 11: EQD-RFF-EQN-TMD-DTM-TSR-LOC-MEA-DIM-TMP-RNG-

SEL-FTX-PCD-SG12-MOA-GOR-EQA-COD-HAN-SG14- SG15-SG17 A group of segments to specify (groups of) containers (with guidelines) in which goods are transported or which are taken on-hire or off-hire.

0490 EQD, Equipment details

A segment to specify a container, container size and type, and full/empty indication; also to specify the type of rail car on which a related container is transported.

0500 RFF, Reference

A segment to express a reference which applies to the particular container, such as: - container sequence number - lower equipment serial number of range - upper equipment serial number of range - referring sequence number - reference at place of positioning - reference at place of collection - related container announcement reference (reference to Empty container disposition order) - transport costs reference number - carrier agent's reference number - freight forwarder's reference

0510 EQN, Number of units

A segment to specify the number of containers of the same size and type in case of equipment guidelines.

0520 TMD, Transport movement details

A segment to indicate a Full Container Load (FCL) or a Less than Full Container Load (LCL).

0530 DTM, Date/time/period

A segment to indicate a date and time relating to the container, such as: - estimated positioning date/time - ultimate release date/time - expected on-hire date and/or time

0540 TSR, Transport service requirements

A segment to specify special instructions and/or services regarding the container, such as: fork lift holes required, off-dimensions, ship's agent's counter by terminal, seals to be checked, damage to be inspected, Customs clearance.

0550 LOC, Place/location identification

A segment to specify ports/locations associated with the sea transport of a container in case of export, such as: - place of discharge - transhipment place

0560 MEA, Measurements

A segment to specify measurement, other than dimensions, associated with the container, such as: - tare weight - gross weight

0570 DIM, Dimensions

- off-standard dimensions, general - off-standard dimensions, front - off-standard dimensions, rear - off-standard dimensions, right - off-standard dimensions, left - off-standard dimensions, height - external equipment dimensions - dimensions equipment door - net dimensions

0580 TMP, Temperature

A segment to specify the transport temperature setting of a container.

0590 RNG, Range details

A segment to specify the transport temperature range or the pre-tripping range of a container.

0600 SEL, Seal number

A segment to identify seal and seal issuer associated with the container, such as shipper, consolidator, carrier (sea) and Customs.

0610 FTX, Free text

A segment to specify processable supplementary information associated with the container, such as: - loading instructions (seagoing vessel) - special instructions (related to inland transport) - container order information (conditions to be checked) - remarks

0620 PCD, Percentage details

A segment to specify percentages related to the equipment such as percentage humidity.

0630 Segment Group 12: DGS-FTX-SG13

A segment group to identify dangerous goods.

0640 DGS, Dangerous goods

A segment to specify dangerous goods.

0650 FTX, Free text

A segment to specify supplementary details regarding the dangerous goods such as the technical name of the dangerous goods etc.

0660 Segment Group 13: CTA-COM

A segment group to specify contact information including communication details regarding the dangerous goods.

0670 CTA, Contact information

A segment to identify a person or department to be contacted regarding the dangerous goods.

0680 COM, Communication contact

A segment to specify communication details of the contact specified in the CTA segment.

0690 MOA, Monetary amount

A segment to indicate a liability amount relating to the equipment.

0700 GOR, Governmental requirements

A segment to indicate if governmental inspection is required.

0710 EQA, Attached equipment

A segment to identify related container and means of transport details (rail), such as: - rail car (to relate to the 'rail-car'-qualified EQD-group)

0720 COD, Component details

A segment to specify the details of the components of transport equipment.

0730 HAN, Handling instructions

A segment to specify handling instructions related to the container equipment.

0740 Segment Group 14: DAM-COD

A group of segments to specify damage details related to the equipment.

0750 DAM, Damage

A segment to specify equipment damages, such as the point of the damage on the equipment, and the type of damage.

0760 COD, Component details

A segment to specify component details of the damaged equipment.

0770 Segment Group 15: TDT-DTM-SG16

A group of segments to indicate information related to the pre- or on-carriage transport stage of the equipment.

0780 TDT, Details of transport

A segment to specify pre- or on-carriage transport details, such as: * pre- or on-carriage transport * second pre- or on-carriage transport

0790 DTM, Date/time/period

A segment to specify a date and time related to the pre-or on-carriage transport such as arrival or departure date and time.

0800 Segment Group 16: LOC-DTM

A segment group to specify ports and other locations associated with pre- or on-carriage transport.

0810 LOC, Place/location identification

A segment to specify ports/locations associated with the pre- or on-carriage transport, such as: - place of departure - place of arrival

0820 DTM, Date/time/period

A segment to specify date(s) and time(s) related to a location.

0830 Segment Group 17: NAD-DTM-CTA-COM-RFF

A group of segments to identify different parties/places, and related dates/times.

0840 NAD, Name and address

A segment to specify a related address or party, such as: - charges payer - country/place of container stuffing - place of collection - final place of positioning - message to - next destination - release to party - carrier agent (sea) - return address

0850 DTM, Date/time/period

A segment to indicate a date and time relating to the container, such as: - earliest equipment collection date/time

0860 CTA, Contact information

A segment to identify a person or department for the specified party.

0870 COM, Communication contact

A segment to identify the communication number on the EDI-network (e.g. mailbox number) to whom a copy of the Container gate-in/gate-out report message should be sent.

0880 RFF, Reference

A segment to identify a reference used by a party or at an address: - reference at return address

0890 CNT, Control total

A segment to specify the number of containers in the message, explicitly given by the sender.

0900 UNT, 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.


4.2. Segment index (alphabetical sequence)

BGM Beginning of message
CNT Control total
COD Component details
COM Communication contact
CTA Contact information
DAM Damage
DGS Dangerous goods
DIM Dimensions
DOC Document/message details
DTM Date/time/period
EQA Attached equipment
EQD Equipment details
EQN Number of units
FTX Free text
GID Goods item details
GOR Governmental requirements
HAN Handling instructions
LOC Place/location identification
MEA Measurements
MOA Monetary amount
NAD Name and address
PCD Percentage details
PIA Additional product id
RFF Reference
RNG Range details
SEL Seal number
SGP Split goods placement
TDT Details of transport
TMD Transport movement details
TMP Temperature
TSR Transport service requirements
UNH Message header
UNT Message trailer

4.3. Message structure


4.3.1. Segment table

├─UNH Message header ×1 (M)
├─BGM Beginning of message ×1 (M)
├─TMD Transport movement details ×1 (C)
├─DTM Date/time/period ×9 (C)
├─TSR Transport service requirements ×9 (C)
├─FTX Free text ×99 (C)
├─LOC Place/location identification ×9 (C)
├─Segment Group 1 ×9 (C)
├─RFF Reference ×1 (M)
└─DTM Date/time/period ×9 (C)
├─Segment Group 2 ×9 (C)
├─TDT Details of transport ×1 (M)
├─DTM Date/time/period ×9 (C)
├─RFF Reference ×9 (C)
└─Segment Group 3 ×9 (C)
──├─LOC Place/location identification ×1 (M)
──└─DTM Date/time/period ×9 (C)
├─Segment Group 4 ×9 (M)
├─NAD Name and address ×1 (M)
├─Segment Group 5 ×9 (C)
├─CTA Contact information ×1 (M)
└─COM Communication contact ×9 (C)
├─RFF Reference ×9 (C)
└─DTM Date/time/period ×9 (C)
├─Segment Group 6 ×999 (C)
├─GID Goods item details ×1 (M)
├─HAN Handling instructions ×9 (C)
├─FTX Free text ×9 (C)
├─RFF Reference ×9 (C)
├─PIA Additional product id ×9 (C)
├─Segment Group 7 ×99 (C)
├─NAD Name and address ×1 (M)
├─DTM Date/time/period ×9 (C)
└─RFF Reference ×9 (C)
├─MEA Measurements ×9 (C)
├─DIM Dimensions ×9 (C)
├─Segment Group 8 ×9 (C)
├─DOC Document/message details ×1 (M)
├─DTM Date/time/period ×9 (C)
└─LOC Place/location identification ×9 (C)
├─Segment Group 9 ×999 (C)
├─SGP Split goods placement ×1 (M)
└─MEA Measurements ×9 (C)
└─Segment Group 10 ×99 (C)
──├─DGS Dangerous goods ×1 (M)
──├─FTX Free text ×9 (C)
──└─MEA Measurements ×9 (C)
├─Segment Group 11 ×9999 (M)
├─EQD Equipment details ×1 (M)
├─RFF Reference ×9 (C)
├─EQN Number of units ×1 (C)
├─TMD Transport movement details ×9 (C)
├─DTM Date/time/period ×9 (C)
├─TSR Transport service requirements ×9 (C)
├─LOC Place/location identification ×9 (C)
├─MEA Measurements ×9 (C)
├─DIM Dimensions ×9 (C)
├─TMP Temperature ×9 (C)
├─RNG Range details ×9 (C)
├─SEL Seal number ×9 (C)
├─FTX Free text ×9 (C)
├─PCD Percentage details ×9 (C)
├─Segment Group 12 ×99 (C)
├─DGS Dangerous goods ×1 (M)
├─FTX Free text ×9 (C)
└─Segment Group 13 ×9 (C)
──├─CTA Contact information ×1 (M)
──└─COM Communication contact ×9 (C)
├─MOA Monetary amount ×9 (C)
├─GOR Governmental requirements ×9 (C)
├─EQA Attached equipment ×1 (C)
├─COD Component details ×1 (C)
├─HAN Handling instructions ×9 (C)
├─Segment Group 14 ×9 (C)
├─DAM Damage ×1 (M)
└─COD Component details ×1 (C)
├─Segment Group 15 ×9 (C)
├─TDT Details of transport ×1 (M)
├─DTM Date/time/period ×9 (C)
└─Segment Group 16 ×9 (C)
──├─LOC Place/location identification ×1 (M)
──└─DTM Date/time/period ×9 (C)
└─Segment Group 17 ×9 (C)
──├─NAD Name and address ×1 (M)
──├─DTM Date/time/period ×1 (C)
──├─CTA Contact information ×1 (C)
──├─COM Communication contact ×1 (C)
──└─RFF Reference ×9 (C)
├─CNT Control total ×1 (C)
└─UNT Message trailer ×1 (M)

Return to Stylus Studio EDIFACT D00A Messages page.
EDI to XML Mapping for EDIFACT/X12 Convert EDIFACT/X12 Schemas to XML Schema Legacy Data Conversion Tools Access Relational Data as XML Visual XSLT and XQuery Mapping Tools EDIFACT to XML
Return to Stylus Studio EDIFACT home page.

Return to Stylus Studio home page.
Site Map | Privacy Policy | Terms of Use | Trademarks
Stylus Scoop XML Newsletter:
W3C Member
Stylus Studio® and DataDirect XQuery ™are from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2016 All Rights Reserved.