USER GUIDE for CONTAINER GATE ACTIVITY MESSAGE (CODECO) · 2016. 2. 10. · 4.2 Sample message structures ... The message generated from the relevant Gate Activity will depend on

USER GUIDE

for

CONTAINER GATE ACTIVITY MESSAGE

(CODECO)

Version 1.7

25th January 2016 Any comments on the content or construction of this document should be referred to: Maritime Cargo Processing Plc The Chapel Phone +44 (0)1394 600200 Maybush Lane Felixstowe Fax +44 (0)1394 600222 Suffolk IP11 7LL United Kingdom Email [email protected]

Destin8 CODECO D95B 2 Version 1.7 February 9, 2016

Contents 1 Introduction.................................................................................. ....3 2 Message Scenario.............................................................................3 3 Notification Scenario........................................................................3 4 CODECO Message Structure, Destin8 subset..................... ..........5 4.1 Segment Table.........................................................................5 4.2 Sample message structures.....................................................6 4.3 Detailed segment information...................................................8


1 Introduction Detailed in this document are the segments used to satisfy the requirements for Ingate and Outgate Activity messages being sent by the Community Inventory Control System known as Destin8 . The data structure for the messages has been based on the ITIGG documents Principles & Rules for Transport Equipment Movements (Reference JM4/ITIGG/96.101/v.131) and D95B CODECO Message Guideline (Reference JM4/ITIGG/96.105/v.11). 2 Message Scenario Ingate Activity messages will be generated for Export Units and Breakbulk consignments. Outgate Activity messages will be generated for Import Units and Devanned and Breakbulk cargo. In addition, Outgate messages will be generated for frustrated Export Units and Breakbulk consignments. The message generated from the relevant Gate Activity will depend on the constitution of the Unit and/or Consignment. There will never be more than one Unit per message and, for breakbulk, devanned or consolidation cargo there will be one message per gate activity. However, it will be possible for a single message to report multiple DG details within the same unit, as long as these are available. Only Message Function (BGM:1225) values 9 (Create) and 5 (Replace) will be used. 3 Notification Scenario The Community Inventory Control System, known as Destin8, provides customs clearance facilities for both import, export and transhipment cargo handled in the UK ports of Felixstowe, Harwich, Teesport, Thamesport, Grangemouth and Liverpool as well as Inland Clearance Depots (ICD), Airfreight handled through East Midlands Airport and Enhanced Remote Transit Sheds (ERTS) located in the various port community areas. The system provides a real time interface for all parties involved in the movement of cargo including Port/Airport/Depot operators, UK Customs, Port Health, Line Agents, Forwarding/Customs Agents and Hauliers. Facilities are also provided to enable related dangerous cargo consignment information to be recorded on the Inventory System for use by Port Authority and Harbour Authority Dangerous Goods Controllers. It is expected that the Coastguard Authority will also have access to information held on the system. CODECO messages will be generated by Destin8 as a result of a Gate Activity being reported to the Inventory System by the Port/Depot/Airport Operator. Once the user environment has been configured, the delivery of message output is controlled by the user entitled to receive the information by use of an Destin8 Output Control transaction (COR). This VDU transaction enables the user to select an output to be delivered to a printer, by Destin8 local message format or EDIFACT message format. If particular outputs are not required they can be switched off by use of the same transaction.


CHANGES IN THIS VERSION

To handle the new SOLAS requirements on Gross Mass Verification, DMR (Data Maintenance Request) for new codes,

to handle the new entities, has been submitted to UN/CEFACT. Until these DMR’s have been accepted this MIG will

include the temporary changes indicated in red based on these requests, once the new codes have been assigned by

UN/CEFACT then an updated version of this MIG will be published,

The changes to the Unitised In-gate message to cater for the SOLAS requirement are as follows:

EQD group segments additions:

MEA - Measurements

D VGM – Verified Gross Mass (weight)

NAD – Name and Address

D AM – Authorized official: name in capitals of person signing for VGM = EDI Signature

O SPC – SOLAS Packed Container Verified Gross Mass Responsible party

DTM – Date/Time

O 798 - Ascertainment of verified gross mass 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

FTX – Free text (ABS) container condition

D SM1 – Solas Method 1 – Verified Gross Mass ascertained by weighing

D SM2 – Solas Method 2 – Verified Gross Mass ascertained by calculation

RFF References

O VGR – Verified Gross Mass Reference – link to VGM information

O VOR – Verified Gross Mass Order Reference – response to instruction for VGM ascertainment

The following additional data will be included if the VGM has been entered by the Terminal Operator.

BGM – Beginning of message

M 999 – Verified Gross Mass Declaration – Document type code if the VGM has been entered by the Terminal

NAD – Name and Address

M WPA – Weighing party – The Terminal Party designated (legally accepted) to ascertain the VGM

CTA – Contact

O BN – Certification Contact – Terminal Department/Person responsible for obtaining the VGM


4.1 Destin8 CODECO SEGMENT TABLE M 1 UNH Message header M 1 Mandatory

M 1 BGM Beginning of message M 1 Mandatory

X FTX Free text C 9 Not Used

R 3 RFF Reference C 9 Required

M 1 Segment group 1 C 1 Mandatory

M 1 TDT Details of transport M 1 Mandatory

R 2 RFF Reference C 9 Required

R 1 LOC Place/location identification C 9 Required

R 1 DTM Date/time/period C 9 Required

M 4 Segment group 2 M 9 Mandatory

M 1 NAD Name and address M 1 Mandatory

O 1 CTA Contact information C 9 Optional

M 1 Segment group 3 C 999 Mandatory

M 1 GID Goods item details M 1 Mandatory

X HAN Handling instructions C 9 Not Used

D 2 FTX Free text C 9 Dependant

X PIA Additional product id C 9 Not Used

R 2 MEA Measurements C 9 Required

D 1 TMP Temperature C 9 Dependant

D 1 RNG Range details C 9 Dependant

R 1 SGP Split goods placement C 999 Required

D 9 Segment group 4 C 9 Dependant

M 1 DGS Dangerous goods M 1 Mandatory

R 1 FTX Free text C 9 Required

M 1 Segment group 5 M 999 Mandatory

M 1 EQD Equipment details M 1 Mandatory

M 4 RFF Reference C 9 Mandatory

O 1 TMD Transport movement details C 9 Optional

R 2 DTM Date/time/period C 9 Required

R 2 LOC Place/location identification C 9 Required

R 4 MEA Measurements C 9 Required

O 5 DIM Dimensions C 9 Optional

O 7 SEL Seal number C 9 Optional

D 3 FTX Free text C 9 Dependent

X EQA Attached equipment C 9 Not used

X Segment group 6 C 9 Not Used

X DAM Damage M 1 Not used

X COD Component details C 1 Not Used

R 1 Segment group 7 C 9 Required

M 1 TDT Details of transport M 1 Mandatory

O 1 LOC Place/location identification C 1 Optional

X DTM Date/time/period C 1 Not Used

D 2 NAD Name and address C 9 Dependent

M 1 CNT Control total M 1 Mandatory

M 1 UNT Message trailer M 1 Mandatory


4.2 Destin8 CODECO SAMPLE MESSAGE STRUCTURES Unitised UNH BGM RFF RFF TDT RFF RFF LOC DTM NAD NAD NAD NAD (In-gates only) CTA (In-gates only) GID TMP RNG SGP DGS (x9) FTX (x9) EQD RFF RFF (Exports only) RFF (In-gates only) RRF (In-gates only) TMD DTM DTM (In-gates only) LOC LOC MEA MEA MEA MEA (In-gates only) DIM (x5) SEL (x7) FTX FTX FTX (In-gates only) TDT LOC (Import Out-gate Only) NAD (In-gates only) NAD (In-gates only) CNT UNT


Breakbulk/General Cargo UNH BGM RFF RFF TDT RFF RFF LOC DTM NAD NAD NAD GID FTX FTX MEA MEA TMP RNG SGP DGS FTX EQD RFF RFF (Exports only) TMD DTM LOC LOC TDT LOC (Imports Outgate Only) CNT UNT


4.3 Destin8 CODECO Detailed Segment Information

0 Header Group : Header Level

0.1 UNH : Message Header - MANDATORY

Element Comment Status Codes

0062 MESSAGE REFERENCE NO MANDATORY

S009 MESSAGE IDENTIFIER MANDATORY

0065 Message type identifier Mandatory CODECO

0052 Message type version number Mandatory D

0054 Message type release number Mandatory 95B

0051 Controlling agency Mandatory UN

0057 Association assigned code Required ITG12

0.2 BGM : Message Details - MANDATORY


C002 MESSAGE NAME DETAILS REQUIRED

1001 Message name, coded Required 34=Gate In Report

36=Gate Out Report

999=VGM details entered by the

Terminal Operator

1004 MESSAGE REFERENCE NO. REQUIRED

1225 MESSAGE FUNCTION REQUIRED 9=Original

5=Replace (Gate In ONLY)

0.3 FTX : Free Text - NOT USED

0.4 RFF : Reference - MANDATORY


C506 REFERENCE MANDATORY

1153 Type of reference Mandatory BN=Booking Reference No

(for Exports)

BM=Bill of Lading Reference No

(for Imports)

ADN=Inland Transport Order No

UCN=Unique Consignment Number

(Destin8 System Reference)

1154 Actual reference number Required

1 Main Transport Details Group : Top level - REQUIRED

1.1 TDT : Transport details - MANDATORY


8051 THE TRANSPORT LEG MANDATORY 20=Main leg

8028 THE VOYAGE NUMBER REQUIRED Lead Agent Voyage Number

C220 MODE OF TRANSPORT REQUIRED

8067 The method of transport Required 1=Sea


C228 TRANSPORT MEANS NOT USED

C040 CARRIER REQUIRED

3127 Carrier code Required Lead Agent code

1131 Code list type Required 172=Carrier Code

3055 Code List Agency Optional 20=BIC

166=SCAC (US)

ZZZ=Mutually agreed (Destin8 Code)

8101 TRANSIT DIRECTION NOT USED

C401 EXCESS TRANSPORTATION NOT USED

C222 VESSEL IDENTIFICATION REQUIRED

8213 Call Sign or Lloyd’s (IMO) No. Required

1131 Code list type Required 146=Lloyds (IMO) No.

103=Call sign directory

3055 Code list agency Not Used

8212 The Vessel Name Required

1.2 RFF : Reference - OPTIONAL



1153 Type of reference Mandatory VON=Alternative Voyage Number

(Consortia Agent’s Voyage No)

[SSX]=Ships Stay Reference.

(Destin8 UVI)


1.3 LOC : Transport Locations - REQUIRED

Element Comments Status Codes

3227 TYPE OF LOCATION MANDATORY 172=Reporting Location

C517 LOCATION ID REQUIRED

3225 Location code Required UNLOCODE

1131 Code list type Required 139=Port

3055 Code list qualifier Required 6=UN/ECE

C519 RELATED LOCATION ONE REQUIRED

3223 Related place/location one Required Terminal / Berth Code

1131 Code list type Required [BER]=Berth

[TER]=Terminal

3055 Code list qualifier Required ZZZ=Mutually agreed

1.4 DTM : Transport Dates & Times - REQUIRED


C507 DATE/TIME DETAILS MANDATORY

2005 The type of date/time Mandatory 178=Actual date/time of arrival

(Import)

133=Estimated date/time of departure

(Export)

2380 The actual date/time Required

2379 The date/time format Required 303=CCYYMMDDHHMMZZZ

2 Parties/Contacts Group : Top Level - REQUIRED

2.1 NAD : Party details - MANDATORY



3035 TYPE OF PARTY MANDATORY MS=Message Sender (Always

Destin8)

MANDATORY MR=Message Recipient

DEPNDENT CA= Carrier (If different to that of )

Message Recipient)

DEPENDENT WPA= The Terminal Party designated

(legally accepted) to obtain

the VGM

C082 PARTY ID CODE REQUIRED

3039 The party code Required

1131 Code list type Required 172=Carrier Code

72=Container Terminal


166=SCAC (US)


SMD=SMDG

2.2 CTA : Contact Information – OPTIONAL for NAD (WPA), not used for others


3139 CONTACT FUNCTION, CODED MANDATORY BN=Department/Employee

responsible

for obtaining the VGM

C056 DEPT or EMPLOYEE DETAILS REQUIRED

3413 Department or employee id Not Used

3412 Department or employee name Required

3 Goods Item Details Group : Top level - REQUIRED

3.1 GID : Goods Item Details - MANDATORY


1496 GOODS ITEM LINE NUMBER REQUIRED 1, 2, 3..

C213 OUTER PACKAGES REQUIRED

7224 The number of outer packages Required (e.g. no. of pallets)

3.2 HAN : Handling Instructions - NOT USED

3.3 FTX : Free Text - REQUIRED

This segment will be used to provide the Goods Description and Marks & Numbers information for

Breakbulk/General, Consolidation and Devanned Cargo consignments ONLY.


4451 TYPE OF FREE TEXT MANDATORY AAA=Goods description

MKS=Marks & Numbers

4453 TEXT FUNCTION, CODED NOT USED

C107 TEXT REFERENCE NOT USED

C108 TEXT LITERAL REQUIRED

4440 Free text line 1 Mandatory

4440 Free text line 2 Optional


3.4 PIA : Additional Product Id - NOT USED

3.5 MEA : Item Measurements - REQUIRED

This segment will be used to provide Measurement information for Breakbulk/General, Consolidation

and Devanned Cargo consignments ONLY.


6311 MEASUREMENT MANDATORY AAE=Measurement Values

APPLICATION QUALIFIER

C502 MEASUREMENT DETAILS REQUIRED

6313 To specify type of measurement Required G=Gross weight

AAW=Gross volume (Cube)

C174 VALUE/RANGE REQUIRED

6411 Measure Unit qualifier Mandatory KGM=Kilograms(for weight)

MTQ=Cubic Metres(for cube)

6314 Measurement value Required

3.6 TMP : Temperature - DEPENDANT

This segment will only appear for running reefers. The temperature details for exports consignments

will show any details entered at the ingate if present, otherwise the maximum temperature entered as

part of the booking if no minimum details were entered. If both maximum and minimum temperatures

were entered on the booking then the details will be found in the RNG segment detailed below.


6245 TYPE OF TEMPERATURE MANDATORY 2=Transport

C239 TEMPERATURE SETTING REQUIRED

6246 Temperature setting value Required

6411 Units of the setting value Required CEL=Celsius

FAH=Fahrenheit

3.7 RNG : Range Details - DEPENDANT

This segment will only be for export running reefers where minimum and maximum temperatures

have been entered on the booking and no ingate temperature has been provided.


6167 THE TYPE OF RANGE MANDATORY 5=Temp range

C280 RANGE VALUES REQUIRED

6411 The temperature values units Mandatory CEL=Celsius

FAH=Fahrenheit

6162 Minimum value of temperature Required

6152 Maximum value of temperature Required

3.8 SGP : Split Goods Details - REQUIRED


C237 EQUIPMENT ID MANDATORY

8260 Equipment ID number Required (BB for Breakbulk)

7224 NUMBER OF PACKAGES REQUIRED

4 Dangerous Goods Group : Goods Level - DEPENDANT - REQUIRED for hazardous cargo

- NOT USED for non-hazardous cargo


4.1 DGS : Dangerous Goods Details - MANDATORY

This segment is for information only and is not a legal declaration of hazardous cargo.


8273 THE REGULATION REQUIRED IMD=Sea

C205 HAZARD CODE REQUIRED

8351 IMO Class No Mandatory

C234 UNDG INFORMATION REQUIRED

7124 UN DG number Required

4.2 FTX : Free Text - REQUIRED

This segment is required and used to supply the DG Technical Name for each DG item reported in the

previous DGS segment. Where the technical name includes NOS (Not Otherwise Specified) then the

actual substance name is also included enclosed in round brackets after the technical name.


4451 TYPE OF FREE TEXT MANDATORY AAD=Dangerous Goods Technical

Name

4453 TEXT FUNCTION, CODED NOT USED


C108 TEXT LITERAL REQUIRED




5 Equipment Group : Top level - REQUIRED

5.1 EQD : Equipment Details - MANDATORY


8053 EQUIPMENT TYPE MANDATORY CN=Container

TE=Trailer

SW=Swap body

[TR]=Truck (SPV)

[BB]=Breakbulk

C237 EQUIPMENT ID REQUIRED

8260 Actual equipment number Required (BB for Breakbulk)

C224 EQUIPMENT SIZE & TYPE DEPENDENT

8155 Size & type of the equipment Dependent ISO 6346 for equipment or

mutually agreed code

1131 Code list type Optional 102=Size & Type

3055 Code list agency Optional 5=ISO

ZZZ=Mutually defined

8077 EQUIPMENT SUPPLIER NOT USED

8249 EQUIPMENT STATUS OPTIONAL 2=Export

3=Import


8169 FULL/EMPTY INDICATOR OPTIONAL 4=Empty

5=Full

[T75]=Full Reefer (Running)

[T76]=Full Non-Running Reefer

[T77]=Empty Reefer (Running)

[T78]=Empty Non-Running Reefer

5.2 RFF : Reference - REQUIRED



1153 Type of reference Mandatory BN=Booking Reference (for Exports)

Optional SQ=Booking Ref Suffix (for Exports)

Mandatory BM=Bill of Lading (for Imports)

Optional VGR=VGM Reference

Optional VOR=VGM Order Reference

Response


5.3 TMD : Transport Movement Details - OPTIONAL


C219 MOVEMENT TYPE NOT USED

8332 EQUIPMENT PLAN Not used

8341 HAULAGE ARRANGEMENTS

, CODED Optional 1=Carrier Haulage

2=Merchant Haulage

5.4 DTM : Transport Dates/times - REQUIRED


C507 DATE/TIME DETAILS MANDATORY

2005 The type of date/time Mandatory 415=Activity Reporting Date

Optional 798=VGM Date & Time

2380 The actual date/time Required

2379 The date/time format Required 203=CCYYMMDDHHMM for WAT

303=CCYYMMDDHHMMZZZ for

415

5.5 LOC : Locations - REQUIRED


3227 TYPE OF LOCATION MANDATORY 11=Port of destination (Export)

164=Final Port of destination (Export)

9=Port of Loading (Import)

76=Original Port of Loading (Import)


3225 Location code Required UNLOCODE



5.6 MEA : Equipment Measurements - DEPENDENT This segment will be used to provide Measurement information for Unitised Cargo only.


6311 MEASUREMENT MANDATORY AAE=Measurement Values


APPLICATION QUALIFIER

C502 MEASUREMENT DETAILS REQUIRED

6313 To specify type of measurement Required G=Gross weight (excluding transport

unit)

T=Tare weight (transport unit)

AAW=Gross volume (Cube)

VGM=Verified Gross Mass

C174 VALUE/RANGE REQUIRED

6411 Measure Unit qualifier Mandatory KGM=Kilograms(for weight)

MTQ=Cubic Metres(for cube)

6314 Measurement value. Required

5.7 DIM : Out of Gauge Equipment Dimensions - OPTIONAL The dimensions of the equipment will ONLY be specified for EXPORT out of gauge cargo items in which

cases the appropriate dimensions will be expressed as the excess beyond the standard.


6145 DIMENSION TYPE MANDATORY 5=Off-standard dim front

6=Off-standard dim back

7=Off-standard dim right

8=Off-standard dim left

9=Off-standard dim general (height)

C211 DIMENSIONS MANDATORY

6411 The dimension units Mandatory CMS= Centimetres

6168 The excess length Optional

6140 The excess width Optional

6008 The excess height Optional

5.8 SEL : Seal Numbers - DEPENDENT The sealing party will be shown if known, otherwise it will be reported as UNKNOWN.


9308 The actual seal number Mandatory

C215 SEAL ISSUER OPTIONAL

9303 The sealing party code Required CA=Carrier

SH=Shipper

CU=Customs

TO=Terminal Operator

AB=Unknown

5.9 FTX : Free Text - REQUIRED This segment is optional and used to supply wharfinger remarks and damage information. The damage

information will be formatted as a maximum of 6 codes each one separated by comma and space. The

first character of each code will identify the area of damage as follows: L – Left Side R – Right Side

F – Front T – Top D – Door. The second and third characters will identify the type of damage as

follows: DT – Dented and Bulged HO – Holed/Breached NI – Structural Damage WT – Wear and

Tear. The segment can also be used to supply the SOLAS Method used to ascertain the Verified Gross

Mass.


4451 TYPE OF FREE TEXT MANDATORY AAI=Wharfinger Remarks

OPTIONAL DAR=Damage Information

DEPENDENT ABS=SOLAS Method

4453 TEXT FUNCTION, CODED DEPENDENT Only used for ABS:

SM1=SOLAS Method 1


SM2=SOLAS Method 2


C108 Wharfinger Remarks or REQUIRED Not used for ABS

Damage Information




5.10 EQA : Attached Equipment - NOT USED

6 Damage Group : below Equipment Group - NOT USED

7 Pre/On-carriage Transport Details Group : below Equipment Group -

OPTIONAL

This group will be used to provide mode of transport details of the Pre-carriage (Export) or On-

carriage (Import or frustrated Export) of the unit/consignment.

7.1 TDT : Transport details - MANDATORY


8051 THE TRANSPORT LEG MANDATORY 1=Inland Transport

8028 THE VOYAGE NUMBER NOT USED

C220 MODE OF TRANSPORT REQUIRED

8067 The method of transport Required 2=Rail

3=Road

C228 TRANSPORT MEANS NOT USED

C040 CARRIER OPTIONAL

3127 Carrier Identification, coded Optional Haulier Code

1131 Code list type Optional 172=Carrier Code


166=SCAC (US)


3128 Carrier (Haulier) Name Optional Free Text

8101 TRANSIT DIRECTION, CODED NOT USED

C401 EXCESS TRANSPORT INFO NOT USED

C222 TRANSPORT IDENTIFICATION OPTIONAL

8213 Id of Means of Transport Optional Truck Registration

(if 8067=3)

Train Reference (if 8067=2)

7.2 LOC : Transport Locations - OPTIONAL


3227 TYPE OF LOCATION MANDATORY 8=Place of Destination (Import)



3225 Location code Required UNLOCODE or Destin8 Location

Code



ZZZ=Mutually Agreed

3224 Place/Location Required Location Name

7.3 DTM : Transport Dates/times - NOT USED

7.4 NAD : Name & Address – DEPENDENT


3035 TYPE OF PARTY MANDATORY AM=VGM Authorised Person

SPC=VGM Responsible Party or MCA

Authorisation Number

C082 PARTY ID CODE NOT USED

C058 NAME AND ADRESS NOT USED

C080 PARTY NAME MANDATORY

3036 Party name Mandatory

3036 Party name Not Used




3045 Party name format, coded Not Used

0.5 CNT : Control Totals : Summary Level - MANDATORY

This segment is included for completeness to comply with EDIFACT rules hence the use of dummy

values.


C270 CONTROL INFORMATION MANDATORY

6069 The type of control total Mandatory 1=Dummy Value

6066 The actual control total Mandatory 1=Dummy value

0.6 UNT : Message Trailer - MANDATORY


0074 NUMBER OF SEGMENTS MANDATORY

inc. UNH & UNT

0062 MESSAGE REFERENCE NO MANDATORY

Documents

USER GUIDE for CONTAINER GATE ACTIVITY MESSAGE (CODECO) · 2016. 2. 10. · 4.2 Sample message structures ... The message generated from the relevant Gate Activity will depend on