United Nations Directories  for Electronic Data Interchange for
Administration, Commerce and Transport



UN/EDIFACT






                                           Message Type : CODECO
                                           Version      : D
                                           Release      : 01C
                                           Contr. Agency: UN

                                           Revision     : 8
                                           Date         : 2001-11-07






SOURCE: D4 Transport (SWG)



                               CONTENTS

              Container gate-in/gate-out report message

0.     INTRODUCTION

1.     SCOPE

       1.1   Functional definition

       1.2   Field of application

       1.3   Principles

2.     REFERENCES

3.     TERMS AND DEFINITIONS

       3.1   Standard terms and definitions

4.     MESSAGE DEFINITION

       4.1   Segment clarification

       4.2   Segment index (alphabetical sequence by tag)

       4.3   Message structure
             4.3.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
----------------------------------------------------------------------



0.     INTRODUCTION

       This specification provides the definition of the Container
       gate-in/gate-out report message (CODECO) to be used in
       Electronic Data Interchange (EDI) between trading partners
       involved in administration, commerce and transport.

1.     SCOPE

1.1    Functional definition

       A message by which a terminal, depot, etc. confirms that the
       containers specified have been delivered or picked up by the
       inland carrier (road, rail or barge). This message can also be
       used to report internal terminal container movements (excluding
       loading and discharging the vessel) and to report the change in
       status of container(s) without those containers having
       physically been moved.
       
       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'.

1.2    Field of application

       The Container gate-in/gate-out report 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:
       Container depot, Inland terminal, Container freight station
       
       Receiving functions include:
       Shipping agent, Logistic center, Shipper (copy), Freight
       forwarder (copy) and Inland carrier (copy)
       
       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 gate-in/gate-out report message:
       
       *   The message contents can be uniquely identified by a
       combination of the following data elements:
       - ordering customer, coded (NAD)
       - ordering customer agent, coded (NAD)
       - container announcement reference (being the release order
       reference number or the acceptance order reference number)
       (RFF)
       
       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.
       
       *   A copy of this message may be sent e.g. to the shipper,
       freight forwarder, the inland waterways and rail carriers,
       according to the communication addresses as mentioned in the
       Container announcement.
       
       *   One message may contain several containers.
       
       *   A supplementary container reference (container sequence
       number) is used to refer to the information of the container(s)
       in the Container announcement, if the container prefix and
       number was not completed in that message.
       
       *   An indicator for the transport status (i.e. export, import,
       transhipment or continental) is to be completed on container
       level (EQD-segment).
       
       *   One shipping line can be specified on message level.
       
       *   The seagoing vessel and sea voyage number can be specified
       on message level.
       
       *   Inland transport details can be specified for each
       individual container.
       
       *   For each container its place of discharge or its position
       of loading (stowage cell) in/on the means of inland transport
       can be specified.
       
       *   In case of export the port of discharge and any port of
       transhipment can be specified for each individual container.
       
       *   The date/time of pick-up and final address of positioning
       or the date/time of delivery must be given for each container.
       
       *   For each container seals can be specified affixed by the
       shipper, container freight station, terminal, sea carrier and
       Customs.
       
       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 gate-in/gate-out report
       message is CODECO.

       Note: Container gate-in/gate-out report messages conforming to
       this document must contain the following data in segment UNH,
       composite S009:

       Data element  0065 CODECO
                     0052 D
                     0054 01C
                     0051 UN

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 Gate-in report, Gate-out report.

0030   DTM, Date/time/period
       A segment to indicate a date and/or time applying to the whole
       message, such as date and time of document or message issue.

0040   FTX, Free text
       A segment to specify free form or processable supplementary
       information, such as:
       -   change information


0050   Segment group 1:  RFF-DTM
       A group of segments to specify a reference relating to the
       whole message, and its date and/or time.

0060      RFF, Reference
          A segment to express a reference which applies to the entire
          message, such as: 
          -   reference to previous message 
          -   container announcement reference number
          -   release order reference
          -   acceptance order reference

0070      DTM, Date/time/period
          A segment to indicate date and/or time related to the
          reference.


0080   Segment group 2:  TDT-DTM-RFF-SG3
       A group of segments to indicate information relating to the
       main carriage stage of the transport (sea).

0090      TDT, Details of transport
          A segment to indicate transport details related to the main
          carriage stage of the transport (sea), such as carrier/liner
          service.

0100      DTM, Date/time/period
          A segment to specify a date and time relating to main
          carriage stage.

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


0120      Segment group 3:  LOC-DTM
          A segment group to indicate places and ports related to the
          main carriage stage.

0130         LOC, Place/location identification
             A segment to specify a location related to the main
             carriage stage such as place of arrival and place of
             departure.

0140         DTM, Date/time/period
             A segment to specify the date(s) and time(s) related to a
             location.


0150   Segment group 4:  NAD-SG5
       A group of segments to identify a party and/or addresses and
       related contacts.

0160      NAD, Name and address
          A segment to identify the party's name and address, and
          function, such as: 
          -   message recipient 
          -   message sender 
          -   ordering customer 
          -   ordering customer agent


0170      Segment group 5:  CTA-COM
          A group of segments to identify a contact and its
          communications related to the party.

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

0190         COM, Communication contact
             A segment to identify a communication number of a person
             or department to whom communication should be directed.


0200   Segment group 6:  GID-HAN-FTX-PIA-MEA-SG7-SGP-SG8
       A group of segments to describe the goods items (to be) stuffed
       in or (to be) stripped from the containers.

0210      GID, Goods item details
          A segment to identify a goods item (to be) stuffed in or (to
          be) stripped from the containers.

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

0230      FTX, Free text
          A segment to describe the goods item or to provide special
          instructions.

0240      PIA, Additional product id
          A segment to identify a commodity code.

0250      MEA, Measurements
          A segment to specify a measurement, other than dimensions,
          for the goods item.


0260      Segment group 7:  TMP-RNG
          A segment group to identify transport related temperature
          settings.

0270         TMP, Temperature
             A segment to specify a temperature setting for a goods
             item.

0280         RNG, Range details
             A segment to specify a temperature range setting for a
             goods item.

0290      SGP, Split goods placement
          A segment to identify a container in which goods are
          transported.


0300      Segment group 8:  DGS-FTX-MEA-SG9
          A group of segments to specify dangerous goods details
          related to the goods item. One goods item may be in
          different dangerous goods classes.

0310         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.

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

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


0340         Segment group 9:  CTA-COM
             A segment group to specify contact information including
             communication details regarding the dangerous goods.

0350            CTA, Contact information
                A segment to identify a person or department to be
                contacted regarding the dangerous goods.

0360            COM, Communication contact
                A segment to specify communication details of the
                contact specified in the CTA segment.


0370   Segment group 10: EQD-RFF-TMD-DTM-LOC-MEA-DIM-SEL-FTX-PCD-EQA-
                         COD-HAN-SG11-SG12-NAD-SG14-SG16
       A group of segments to specify containers in which goods are
       transported.

0380      EQD, Equipment details
          A segment to specify a container, container size and type
          used in the transport, and full/empty indication.

0390      RFF, Reference
          A segment to specify the identifying number associated with
          the container, such as:
          -   container sequence number 
          -   booking reference number (sea)

0400      TMD, Transport movement details
          A segment to indicate a Full Container Load (FCL) or a Less
          than Full Container Load (LCL).

0410      DTM, Date/time/period
          A segment to indicate date and time relating to the delivery
          of a container:
          -   actual equipment positioning date and/or time

0420      LOC, Place/location identification
          A segment to specify ports/locations associated with the
          transport of a container, such as:
          -   stowage cell 
          -   place of discharge

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

0440      DIM, Dimensions
          A segment to specify dimensions applicable to the container,
          such as:
          -   external equipment dimensions

0450      SEL, Seal number
          A segment to identify seal and seal issuer associated with
          the container, such as shipper, consolidator, carrier (sea),
          Customs or terminal operator.

0460      FTX, Free text
          A segment to specify processable supplementary information
          associated with the container, such as:
          -   damage remarks

0470      PCD, Percentage details
          A segment to specify percentages related to the equipment
          such as percentage humidity.

0480      EQA, Attached equipment
          A segment to identify related container and means of
          transport details (rail), such as:
          -   rail car

0490      COD, Component details
          A segment to specify the details of the components of
          transport equipment.

0500      HAN, Handling instructions
          A segment to specify handling instructions related to the
          container equipment.


0510      Segment group 11: DAM-COD
          A group of segments to specify damage details related to the
          equipment.

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

0530         COD, Component details
             A segment to specify component details of the damaged
             equipment.


0540      Segment group 12: TDT-DTM-SG13
          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.

0550         TDT, Details of transport
             A segment to indicate information related to the inland
             transport stage (road, rail or inland water), such as
             mode of transport, identification of the means of
             transport and inland carrier.

0560         DTM, Date/time/period
             A segment to specify a date and time related to the
             transport details such as date and time of arrival or
             departure.


0570         Segment group 13: LOC-DTM
             A segment group to specify ports and other locations
             associated with the inland transport of containers.

0580            LOC, Place/location identification
                A segment to specify ports/locations associated with
                inland transport of a container, such as:
                -   place of departure 
                -   place of arrival

0590            DTM, Date/time/period
                A segment to specify date(s) and time(s) related to a
                location.

0600      NAD, Name and address
          A segment to specify the actual address where a piece of
          equipment is to be delivered finally (final place of
          positioning).


0610      Segment group 14: DGS-FTX-MEA-SG15
          A group of segments to specify dangerous goods.

0620         DGS, Dangerous goods
             A segment to indicate the dangerous goods regulations
             which apply, the class of dangerous goods, additional
             dangerous goods codes, the United Nations Dangerous Goods
             (UNDG) number and the shipment flash point.

0630         FTX, Free text
             A segment to specify supplementary details regarding the
             dangerous goods such as dangerous goods technical name
             and dangerous goods additional information.

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


0650         Segment group 15: CTA-COM
             A group of segments to specify contact information.

0660            CTA, Contact information
                A segment to identify a person or department to be
                contacted regarding dangerous goods.

0670            COM, Communication contact
                A segment to specify communication details of the
                dangerous goods contact.


0680      Segment group 16: TMP-RNG
          A segment group to identify transport related temperature
          settings.

0690         TMP, Temperature
             A segment to specify the type of transport related
             temperature such as storage, transport or operating
             temperature and also to optionally specify a single value
             temperature setting.

0700         RNG, Range details
             A segment to optionally specify the transport related
             temperature as a range of values.

0710   CNT, Control total
       A segment to specify the number of containers in the message.

0720   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 by tag)

          BGM Beginning of message
          CNT Control total
          COD Component details
          COM Communication contact
          CTA Contact information
          DAM Damage
          DGS Dangerous goods
          DIM Dimensions
          DTM Date/time/period
          EQA Attached equipment
          EQD Equipment details
          FTX Free text
          GID Goods item details
          HAN Handling instructions
          LOC Place/location identification
          MEA Measurements
          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
          UNH Message header
          UNT Message trailer

4.3 Message structure 4.3.1 Segment table Pos Tag Name S R 0010 UNH Message header M 1 0020 BGM Beginning of message M 1 0030 DTM Date/time/period C 9 0040 FTX Free text C 9 0050 ----- Segment group 1 ------------------ C 9-----------+ 0060 RFF Reference M 1 | 0070 DTM Date/time/period C 9-----------+ 0080 ----- Segment group 2 ------------------ C 1-----------+ 0090 TDT Details of transport M 1 | 0100 DTM Date/time/period C 9 | 0110 RFF Reference C 9 | | 0120 ----- Segment group 3 ------------------ C 9----------+| 0130 LOC Place/location identification M 1 || 0140 DTM Date/time/period C 9----------++ 0150 ----- Segment group 4 ------------------ M 9-----------+ 0160 NAD Name and address M 1 | | 0170 ----- Segment group 5 ------------------ C 9----------+| 0180 CTA Contact information M 1 || 0190 COM Communication contact C 9----------++ 0200 ----- Segment group 6 ------------------ C 999---------+ 0210 GID Goods item details M 1 | 0220 HAN Handling instructions C 9 | 0230 FTX Free text C 9 | 0240 PIA Additional product id C 9 | 0250 MEA Measurements C 9 | | 0260 ----- Segment group 7 ------------------ C 9----------+| 0270 TMP Temperature M 1 || 0280 RNG Range details C 1----------+| 0290 SGP Split goods placement C 999 | | 0300 ----- Segment group 8 ------------------ C 99---------+| 0310 DGS Dangerous goods M 1 || 0320 FTX Free text C 9 || 0330 MEA Measurements C 9 || || 0340 ----- Segment group 9 ------------------ C 9---------+|| 0350 CTA Contact information M 1 ||| 0360 COM Communication contact C 9---------+++ 0370 ----- Segment group 10 ------------------ M 9999--------+ 0380 EQD Equipment details M 1 | 0390 RFF Reference C 99 | 0400 TMD Transport movement details C 9 | 0410 DTM Date/time/period C 99 | 0420 LOC Place/location identification C 9 | 0430 MEA Measurements C 99 | 0440 DIM Dimensions C 99 | 0450 SEL Seal number C 9 | 0460 FTX Free text C 99 | 0470 PCD Percentage details C 9 | 0480 EQA Attached equipment C 9 | 0490 COD Component details C 1 | 0500 HAN Handling instructions C 9 | | 0510 ----- Segment group 11 ------------------ C 9----------+| 0520 DAM Damage M 1 || 0530 COD Component details C 1----------+| | 0540 ----- Segment group 12 ------------------ C 9----------+| 0550 TDT Details of transport M 1 || 0560 DTM Date/time/period C 9 || || 0570 ----- Segment group 13 ------------------ C 9---------+|| 0580 LOC Place/location identification M 1 ||| 0590 DTM Date/time/period C 9---------++| 0600 NAD Name and address C 9 | | 0610 ----- Segment group 14 ------------------ C 99---------+| 0620 DGS Dangerous goods M 1 || 0630 FTX Free text C 9 || 0640 MEA Measurements C 9 || || 0650 ----- Segment group 15 ------------------ C 9---------+|| 0660 CTA Contact information M 1 ||| 0670 COM Communication contact C 9---------++| | 0680 ----- Segment group 16 ------------------ C 9----------+| 0690 TMP Temperature M 1 || 0700 RNG Range details C 1----------++ 0710 CNT Control total C 1 0720 UNT Message trailer M 1

Copyright United Nations, all rights reserved
 
UN Economic Commission for Europe
Palais des Nations, CH-1211 Geneva 10, Switzerland
Tel: +41-22 917 2016 Fax: +41-22 917 0037 E-mail: TradeMaster@unece.org
 
UN/EDIFACT Directories