USER GUIDE. for CONTAINER GATE ACTIVITY MESSAGE (CODECO)

Transcription

1 USER GUIDE for CONTAINER GATE ACTIVITY MESSAGE (CODECO) Version th 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) Maybush Lane Felixstowe Fax +44 (0) Suffolk IP11 7LL United Kingdom

2 Contents 1 Introduction Message Scenario Notification Scenario CODECO Message Structure, Destin8 subset Segment Table Sample message structures Detailed segment information...8 Destin8 CODECO D95B 2

3 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. Destin8 CODECO D95B 3

4 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 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 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 Destin8 CODECO D95B 4

5 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 Reference C 9 Required M 1 Segment group 1 C 1 Mandatory M 1 TDT Details of transport M 1 Mandatory R 2 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 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 Destin8 CODECO D95B 5

6 4.2 Destin8 CODECO SAMPLE MESSAGE STRUCTURES Unitised UNH BGM TDT LOC DTM NAD NAD NAD NAD (In-gates only) CTA (In-gates only) GID TMP RNG SGP DGS (x9) FTX (x9) EQD (Exports only) (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 Destin8 CODECO D95B 6

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

8 4.3 Destin8 CODECO Detailed Segment Information 0 Header Group : Header Level 0.1 UNH : Message Header - MANDATORY 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 ITG 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 : 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 Destin8 CODECO D95B 8

9 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 : Reference - OPTIONAL C506 REFERENCE MANDATORY 1153 Type of reference Mandatory VON=Alternative Voyage Number (Consortia Agent s Voyage No) [SSX]=Ships Stay Reference. (Destin8 UVI) 1154 Actual reference number Required 1.3 LOC : Transport Locations - REQUIRED 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 Destin8 CODECO D95B 9

10 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 C082 PARTY ID CODE REQUIRED 3039 The party code Required WPA= The Terminal Party designated (legally accepted) to obtain the VGM 1131 Code list type Required 172=Carrier Code 72=Container Terminal 3055 Code List Agency Optional 20=BIC 166=SCAC (US) ZZZ=Mutually agreed (Destin8 Code) 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 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 Destin8 CODECO D95B 10

11 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 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 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 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 Destin8 CODECO D95B 11

12 4.1 DGS : Dangerous Goods Details - MANDATORY This segment is for information only and is not a legal declaration of hazardous cargo 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 TYPE OF FREE TEXT MANDATORY AAD=Dangerous Goods Technical Name 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 4440 Free text line 3 Optional 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 Destin8 CODECO D95B 12

13 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 : Reference - REQUIRED C506 REFERENCE MANDATORY 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 Optional 1154 Actual reference number Required 5.3 TMD : Transport Movement Details - OPTIONAL C219 MOVEMENT TYPE NOT USED 8332 EQUIPMENT PLAN Not used VGR=VGM Reference VOR=VGM Order Reference Response 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 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) C517 LOCATION ID REQUIRED 3225 Location code Required UNLOCODE 1131 Code list type Required 139=Port 3055 Code list qualifier Required 6=UN/ECE 5.6 MEA : Equipment Measurements - DEPENDENT This segment will be used to provide Measurement information for Unitised Cargo only MEASUREMENT MANDATORY AAE=Measurement Values Destin8 CODECO D95B 13

14 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 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 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 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 Destin8 CODECO D95B 14

15 SM2=SOLAS Method 2 C107 TEXT REFERENCE NOT USED C108 Wharfinger Remarks or REQUIRED Not used for ABS Damage Information 4440 Free text line 1 Mandatory 4440 Free text line 2 Optional 4440 Free text line 3 Optional 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 Oncarriage (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 3055 Code List Agency Optional 20=BIC 166=SCAC (US) ZZZ=Mutually agreed (Destin8 Code) 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) Destin8 CODECO D95B 15

16 Code C517 LOCATION ID REQUIRED 3225 Location code Required UNLOCODE or Destin8 Location 1131 Code list type Required 139=Port 3055 Code list qualifier Required 6=UN/ECE 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 3036 Party name Not Used 3036 Party name Not Used 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 Destin8 CODECO D95B 16