Upload
lamtu
View
216
Download
0
Embed Size (px)
Citation preview
VERMAS Verified Gross Mass D16A - Customer
Version: 1.0
Company: GT Nexus
Modified: 10/21/2016
GT Nexus
1 10/21/2016
VERMAS Verified Gross Mass
Message Status=0
Definition:
Not Defined: Pos Tag Segment Name Status Rep Notes Usage
UNB INTERCHANGE HEADER M 1 GTN Required
0010 UNH MESSAGE HEADER M 1 N0/0010 GTN Required
0020 BGM BEGINNING OF MESSAGE M 1 N0/0020 GTN Required
0030 DTM DATE/TIME/PERIOD M 1 N0/0030 GTN Required
0070 Segment Group 2 C 2 N0/0070 GTN Required
0080 NAD NAME AND ADDRESS M 1 GTN Required
0090 Segment Group 3 C 9 N0/0090 GTN Optional
0100 CTA CONTACT INFORMATION M 1 GTN Required
0110 COM COMMUNICATION CONTACT C 9 GTN Optional
0120 Segment Group 4 C 99999 N0/0120 GTN Required
0130 EQD EQUIPMENT DETAILS M 1 N0/0130 GTN Required
0140 RFF REFERENCE C 5 GTN Required
0160 SEL SEAL NUMBER C 9 GTN Optional
0170 Segment Group 5 C 9 N0/0170 GTN Required
0180 MEA MEASUREMENTS M 1 GTN Required
0190 DTM DATE/TIME/PERIOD C 1 GTN Optional
0230 Segment Group 7 C 1 N0/0230 GTN Required
0240 DOC DOCUMENT/MESSAGE DETAILS M 1 GTN Required
0250 DTM DATE/TIME/PERIOD C 1 GTN Optional
0260 Segment Group 8 C 9 N0/0260 GTN Required
0270 NAD NAME AND ADDRESS M 1 GTN Required
0280 Segment Group 9 C 2 GTN Optional
0290 CTA CONTACT INFORMATION M 1 GTN Required
0300 COM COMMUNICATION CONTACT C 9 GTN Optional
0310 UNT MESSAGE TRAILER M 1 N0/0310 GTN Required
UNZ INTERCHANGE TRAILER M 1 GTN Required
Clarification: 0/0010 A service segment starting and uniquely identifying a message. The message type code for the Instruction message is VERMAS.
Note: Instruction messages conforming to this document must contain the following data in segment UNH, composite S009: Data element 0065 VERMAS 0052 D 0054 15A 0051 UN
0/0020 A segment to indicate the beginning of a message and to transmit identifying number and type of the message.
0/0030 A segment to indicate a date and time applying to the whole message, e.g., date and time of document issue.
0/0070 A group of segments to identify a party for the entire message including the message sender and related contacts.
0/0090 A group of segments to identify contacts and communication information related to the party.
0/0120 A group of segments containing information about one packed container.
0/0130 A segment to identify a unit of equipment or uncontainerised cargo.
0/0170 A group to specify specify the gross mass of transport equipment and date/time when it was determined.
0/0230 A group specifying a documents and details related to it.
0/0260 A group to qualify and specify name and address information in VGM documentation.
0/0310 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.
GT Nexus
2 10/21/2016
UNB INTERCHANGE HEADER Pos: Max: 1
Mandatory
Group: N/A Elements: 11
User Option (Usage): GTN Required Function: To start, identify and specify an interchange.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
UNB010 S001 SYNTAX IDENTIFIER M Comp GTN Required
Description: Identification of the agency controlling the syntax and indication of syntax level.
UNB010-010 0001 Syntax identifier M a 4/4 GTN Required
Description: Coded identification of the agency controlling a syntax and syntax level used in an interchange. Information:
GTNEXUS accepted Values:
UNOA UN/ECE level A
UNOC UN/ECE level C
UNB010-020 0002 Syntax version number M n 1/1 GTN Required
Description: Version number of the syntax identified in the syntax identifier (0001).
UNB020 S002 INTERCHANGE SENDER M Comp GTN Required
Description: Identification of the sender of the interchange.
UNB020-010 0004 Sender identification M an 1/35 GTN Required
Description: Name or coded representation of the sender of a data interchange. Information:
<SENDER ID>
UNB020-020 0007 Partner identification code qualifier C an 1/4 GTN Optional
Description: Qualifier referring to the source of codes for the identifiers of interchanging partners. Information:
Accepted value
ZZZ Mutually Defined
UNB030 S003 INTERCHANGE RECIPIENT M Comp GTN Required
Description: Identification of the recipient of the interchange.
UNB030-010 0010 Recipient identification M an 1/35 GTN Required
Description: Name or coded representation of the recipient of a data interchange. Information:
Set to ‘GTNEXUS’
UNB030-020 0007 Partner identification code qualifier C an 1/4 GTN Optional
Description: Qualifier referring to the source of codes for the identifiers of interchanging partners. Information:
Accepted value
ZZZ Mutually Defined
UNB040 S004 DATE/TIME OF PREPARATION M Comp GTN Required
Description: Date/time of preparation of the interchange.
UNB040-010 0017 Date of preparation M n 6/6 GTN Required
Description: Local date when an interchange or a functional group was prepared. Information:
<interchange date> (in format YYMMDD)
GT Nexus
3 10/21/2016
UNB040-020 0019 Time of preparation M n 4/4 GTN Required
Description: Local time of day when an interchange or a functional group was prepared. Information:
<interchange time> (in format HHMM)
UNB050 0020 Interchange control reference M an 1/14 GTN Required
Description: Unique reference assigned by the sender to an interchange.
UNB090 0031 Acknowledgement request C n 1/1 GTN Optional
Description: Code determined by the sender for acknowledgement of the interchange. Information:
1 Acknowledgement requested
Note 1: Sample Segment:
UNA:+.? '
UNB+UNOC:3+CARRIER_ID:ZZZ+GTNEXUS:ZZZ+160402:2356+349200517'
GT Nexus
4 10/21/2016
UNH MESSAGE HEADER Pos: 0010 Max: 1
Mandatory
Group: N/A Elements: 7
User Option (Usage): GTN Required Function: To head, identify and specify a message.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
UNH010 0062 Message reference number M an 1/14 GTN Required
Description: Unique message reference assigned by the sender.
UNH020 S009 MESSAGE IDENTIFIER M Comp GTN Required
Description: Identification of the type, version, etc. of the message being interchanged.
UNH020-010 0065 Message type M an 1/6 GTN Required
Description: Code identifying a type of message and assigned by its controlling agency. Note 1: In UNSMs
(United Nations Standard Messages), the representation is a6. Information:
Set to ‘VERMAS’
UNH020-020 0052 Message version number M an 1/3 GTN Required
Description: Version number of a message type. Information:
Set to ‘D’
UNH020-030 0054 Message release number M an 1/3 GTN Required
Description: Release number within the current message version number. Information:
Set to ‘16A’
UNH020-040 0051 Controlling agency, coded M an 1/3 GTN Required
Description: Code identifying a controlling agency. Information:
UN UN/CEFACT
Note 1: Sample Segment:
UNH+1+VERMAS:D:16A:UN’
GT Nexus
5 10/21/2016
BGM BEGINNING OF MESSAGE Pos: 0020 Max: 1
Mandatory
Group: N/A Elements: 6
User Option (Usage): GTN Required Function: To indicate the type and function of a message and to transmit the identifying number.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
BGM010 C002 DOCUMENT/MESSAGE NAME C Comp GTN Required
Description: Identification of a type of document/message by code or name. Code preferred.
BGM010-010 1001 Document name code C an 1/3 GTN Required
Description: Code specifying the document name. Information:
749 Transport equipment gross mass verification message
BGM020 C106 DOCUMENT/MESSAGE IDENTIFICATION C Comp GTN Required
Description: Identification of a document/message by its number and eventually its version or revision.
BGM020-010 1004 Document identifier C an 1/70 GTN Required
Description: To identify a document. Information:
Transaction unique identifier (TBD)
BGM030 1225 Message function code C an 1/3 GTN Optional
Description: Code indicating the function of the message. Information:
GTNEXUS accepted values:
1 Cancellation
4 Change
5 Replace
9 Original
Note 1: Sample Segment:
BGM+749+SHIPMENT_ID+9'
GT Nexus
6 10/21/2016
DTM DATE/TIME/PERIOD Pos: 0030 Max: 1
Mandatory
Group: N/A Elements: 1
User Option (Usage): GTN Required Function: To specify date, and/or time, or period.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
DTM010 C507 DATE/TIME/PERIOD M Comp GTN Required
Description: Date and/or time, or period relevant to the specified date/time/period type.
DTM010-010 2005 Date or time or period function code qualifier M an 1/3 GTN Required
Description: Code qualifying the function of a date, time or period. Information:
137 Document / message date / time
DTM010-020 2380 Date or time or period text C an 1/35 GTN Required
Description: The value of a date, a date and time, a time or of a period in a specified representation. Information:
<interchange date / time>
DTM010-030 2379 Date or time or period format code C an 1/3 GTN Required
Description: Code specifying the representation of a date, time or period. Information:
203 CCYYMMDDHHMM
Note 1: Sample Segment:
DTM+137:201204181552:203’
GT Nexus
7 10/21/2016
Segment Group 2 Pos: 0070 Repeat: 2
Conditional
Group: 2 Elements: N/A
User Option (Usage): GTN Required Function:
Segment Group Summary: Pos Tag Segment Name Status Rep Usage
0080 NAD NAME AND ADDRESS M 1 GTN Required
0090 Segment Group 3 C 9 GTN Optional
GT Nexus
8 10/21/2016
NAD NAME AND ADDRESS Pos: 0080 Max: 1
Mandatory
Group: 2 Elements: 9
Loop Path: Group 2 User Option (Usage): GTN Required Function: To specify the name/address and their related function, either by C082 only and/or unstructured by C058 or structured by C080 thru
3207.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
NAD010 3035 Party function code qualifier M an 1/3 GTN Required
Description: Code giving specific meaning to a party. Information:
TB Submitter (To specify the party submitting the VERMAS, not the party responsible for the VGM)
CA Carrier (Party undertaking or arranging transport of goods between named points.)
Note 2:
NAD Segment with NAD010 = "CA" should be used either in the Segment Group 2 or Segment Group 8, but not both
NAD020 C082 PARTY IDENTIFICATION DETAILS C Comp GTN Optional
Description: Identification of a transaction party by code. Information:
Used with NAD010 = "CA"
NAD020-010 3039 Party identifier M an 1/35 GTN Required
Description: Code specifying the identity of a party. Information:
Carrier SCAC recognized by Shipper and GT Nexus
NAD020-020 1131 Code list identification code C an 1/17 GTN Optional
Description: Code identifying a user or association maintained code list. Note: 1 The codes for this data
element are provided by the code list responsible agency defined in data element 3055. Information:
160 Party identification (Identification of parties, corporates, etc.)
NAD020-030 3055 Code list responsible agency code C an 1/3 GTN Optional
Description: Code specifying the agency responsible for a code list. Information:
86 Assigned by party originating the message (Codes assigned by the party originating the message).
NAD030 C058 NAME AND ADDRESS C Comp GTN Optional
Description: Unstructured name and address: one to five lines.
NAD030-010 3124 Name and address description M an 1/35 GTN Required
Description: Free form description of a name and address line.
NAD030-020 3124 Name and address description C an 1/35 GTN Optional
Description: Free form description of a name and address line.
NAD030-030 3124 Name and address description C an 1/35 GTN Optional
Description: Free form description of a name and address line.
NAD030-040 3124 Name and address description C an 1/35 GTN Optional
Description: Free form description of a name and address line.
NAD030-050 3124 Name and address description C an 1/35 GTN Optional
Description: Free form description of a name and address line.
NAD040 C080 PARTY NAME C Comp GTN Optional
GT Nexus
9 10/21/2016
Description: Identification of a transaction party by name, one to five lines. Party name may be formatted.
NAD040-010 3036 Party name M an 1/70 GTN Required
Description: Name of a party.
NAD040-020 3036 Party name C an 1/70 GTN Optional
Description: Name of a party.
NAD050 C059 STREET C Comp GTN Optional
Description: Street address and/or PO Box number in a structured address: one to four lines.
NAD050-010 3042 Street and number or post office box identifier
M an 1/35 GTN Required
Description: To identify a street and number and/or Post Office box number.
NAD050-020 3042 Street and number or post office box identifier
C an 1/35 GTN Optional
Description: To identify a street and number and/or Post Office box number.
NAD050-030 3042 Street and number or post office box identifier
C an 1/35 GTN Optional
Description: To identify a street and number and/or Post Office box number.
NAD050-040 3042 Street and number or post office box identifier
C an 1/35 GTN Optional
Description: To identify a street and number and/or Post Office box number.
NAD060 3164 City name C an 1/35 GTN Optional
Description: Name of a city.
NAD070 C819 COUNTRY SUBDIVISION DETAILS C Comp GTN Optional
Description: To specify a country subdivision, such as state, canton, county, prefecture.
NAD070-010 3229 Country subdivision identifier C an 1/9 GTN Optional
Description: To identify a country subdivision, such as state, canton, county, prefecture. Note: 1
Recommended use ISO 3166-2. If not applicable, use appropriate code set defined by appropriate national authority.
NAD080 3251 Postal identification code C an 1/17 GTN Optional
Description: Code specifying the postal zone or address. Note: 1 Use code defined by appropriate national
authority.
NAD090 3207 Country identifier C an 1/3 GTN Optional
Description: Identification of the name of the country or other geographical entity as defined in ISO 3166-1
and UN/ECE Recommendation 3. Note: 1 Use ISO 3166-1 two alpha country code.
Notes: 1. It is recommended to transmit name/address data in structured form by C080 through 3207. Transmission in coded form in C082
requires agreement between communication partners.
Note 1: Sample Segment:
NAD+TB+111111:ZZZ++VGM SUBMITTER NAME+ADDRESS+CITY+NY+10038+US'
NAD+CA+APLU:160:86'
GT Nexus
10 10/21/2016
Segment Group 3 Pos: 0090 Repeat: 9
Conditional
Group: 3 Elements: N/A
Loop Path: Group 2 User Option (Usage): GTN Optional Function:
Segment Group Summary: Pos Tag Segment Name Status Rep Usage
0100 CTA CONTACT INFORMATION M 1 GTN Required
0110 COM COMMUNICATION CONTACT C 9 GTN Optional
GT Nexus
11 10/21/2016
CTA CONTACT INFORMATION Pos: 0100 Max: 1
Mandatory
Group: 3 Elements: 2
Loop Path: Group 2-Group 3 User Option (Usage): GTN Required Function: To identify a person or a department to whom communication should be directed.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
CTA010 3139 Contact function code C an 1/3 GTN Optional
Description: Code specifying the function of a contact (e.g. department or person). Information:
IC Information contact
CTA020 C056 CONTACT DETAILS C Comp GTN Optional
Description: Code and/or name of a contact such as a department or employee. Code preferred.
CTA020-020 3412 Contact name C an 1/256 GTN Optional
Description: Name of a contact, such as a department or employee.
Note 1: Sample Segment:
CTA+IC+:SUBMITTER CONTACT NAME'
GT Nexus
12 10/21/2016
COM COMMUNICATION CONTACT Pos: 0110 Max: 9
Conditional
Group: 3 Elements: 1
Loop Path: Group 2-Group 3 User Option (Usage): GTN Optional Function: To identify a communication number of a department or a person to whom communication should be directed.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
COM010 C076 COMMUNICATION CONTACT M Comp GTN Required
Description: Communication number of a department or employee in a specified channel.
COM010-010 3148 Communication address identifier M an 1/512 GTN Required
Description: To identify a communication address.
COM010-020 3155 Communication means type code M an 1/3 GTN Required
Description: Code specifying the type of communication address. Information:
EM Electronic Mail
FX Telefax
TE Telephone
Notes: 1. Example(s):
2. COM+NAME(A)LINE.COM:EM'
Note 1: Sample Segment
COM+SUBMITTER EMAIL:EM’
COM+555 555 5555:TE’
GT Nexus
13 10/21/2016
Segment Group 4 Pos: 0120 Repeat: 99999
Conditional
Group: 4 Elements: N/A
User Option (Usage): GTN Required Function:
Segment Group Summary: Pos Tag Segment Name Status Rep Usage
0130 EQD EQUIPMENT DETAILS M 1 GTN Required
0140 RFF REFERENCE C 5 GTN Required
0160 SEL SEAL NUMBER C 9 GTN Optional
0170 Segment Group 5 C 9 GTN Required
0230 Segment Group 7 C 1 GTN Required
Notes: 1. Group transmitting VGM information about a container:
2. - identification information
3. - gross mass (status verified or not)
4. - DOC group for documention of VGM
GT Nexus
14 10/21/2016
EQD EQUIPMENT DETAILS Pos: 0130 Max: 1
Mandatory
Group: 4 Elements: 7
Loop Path: Group 4 User Option (Usage): GTN Required Function: To identify a unit of equipment.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
EQD010 8053 Equipment type code qualifier M an 1/3 GTN Required
Description: Code qualifying a type of equipment. Information:
CN Container
EQD020 C237 EQUIPMENT IDENTIFICATION C Comp GTN Required
Description: Marks (letters/numbers) identifying equipment.
EQD020-010 8260 Equipment identifier C an 1/17 GTN Optional
Description: To identify equipment. Information:
<equipment number>
Equipment Number Format: <(4 char equip. prefix) + (6 digit equip. number) + (1 digit equip. number check digit)>
EQD030 C224 EQUIPMENT SIZE AND TYPE C Comp GTN Optional
Description: Code and or name identifying size and type of equipment. Code preferred.
EQD030-010 8155 Equipment size and type description code C an 1/10 GTN Optional
Description: Code specifying the size and type of equipment. Note: 1 May use codes specified in ISO 6346
for seagoing containers. Information:
See Appendix A for the list of codes accepted by GT Nexus
Note 1: Sample Segment:
EQD+CN+HJSC1234560+22GP'
GT Nexus
15 10/21/2016
RFF REFERENCE Pos: 0140 Max: 5
Conditional
Group: 4 Elements: 1
Loop Path: Group 4 User Option (Usage): GTN Required Function: To specify a reference.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
RFF010 C506 REFERENCE M Comp GTN Required
Description: Identification of a reference.
RFF010-010 1153 Reference code qualifier M an 1/3 GTN Required
Description: Code qualifying a reference. Information:
BM Bill of lading number
BN Consignment identifier, carrier assigned - Carrier Booking Number
VGR Transport equipment gross mass verification reference number
FF Freight forwarder assigned reference number
SI Shipper's identifying number for shipment
AOW Submitter's VGM transaction reference
RFF010-020 1154 Reference identifier C an 1/70 GTN Required
Description: Identifies a reference.
Note 1: Either BN (Carrier Booking Number) or BM (Bill of Lading Number) must be provided. Only one can be sent per EQD.
Only one of each type of reference may be provide per EQD.
Sample Segment
RFF+BN:12345678'
RFF+VGR:AB111111'
GT Nexus
16 10/21/2016
SEL SEAL NUMBER Pos: 0160 Max: 9
Conditional
Group: 4 Elements: 5
Loop Path: Group 4 User Option (Usage): GTN Optional Function: To specify the seal number or a range of seal numbers.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
SEL010 9308 Transport unit seal identifier C an 1/35 GTN Optional
Description: The identification number of a seal affixed to a transport unit.
Note 1: Sample Segment
SEL+12345'
GT Nexus
17 10/21/2016
Segment Group 5 Pos: 0170 Repeat: 9
Conditional
Group: 5 Elements: N/A
Loop Path: Group 4 User Option (Usage): GTN Required Function:
Segment Group Summary: Pos Tag Segment Name Status Rep Usage
0180 MEA MEASUREMENTS M 1 GTN Required
0190 DTM DATE/TIME/PERIOD C 1 GTN Optional
GT Nexus
18 10/21/2016
MEA MEASUREMENTS Pos: 0180 Max: 1
Mandatory
Group: 5 Elements: 4
Loop Path: Group 4-Group 5 User Option (Usage): GTN Required Function: To specify physical measurements, including dimension tolerances, weights and counts.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
MEA010 6311 Measurement purpose code qualifier M an 1/3 GTN Required
Description: Code qualifying the purpose of the measurement. Information:
AAE Measurement
MEA020 C502 MEASUREMENT DETAILS C Comp GTN Required
Description: Identification of measurement type.
MEA020-010 6313 Measured attribute code C an 1/3 GTN Required
Description: Code specifying the attribute measured. Information:
VGM Transport equipment verified gross mass (weight)
(The gross mass (weight) of the transport equipment verified according to SOLAS Chapter VI, Regulation 2,
paragraphs 4-6)
MEA030 C174 VALUE/RANGE C Comp GTN Required
Description: Measurement value and relevant minimum and maximum values of the measurement range.
MEA030-010 6411 Measurement unit code M an 1/8 GTN Required
Description: Code specifying the unit of measurement. Note: 1 Recommend use UN/ECE Recommendation
20, Common code. Information:
KGM Kilograms
LBR Pounds
MEA030-020 6314 Measure C an 1/18 GTN Required
Description: To specify the value of a measurement.
Note 1: Sample Segment:
MEA+AAE+VGM+KGM:1234.5'
Weight must conform to below rules:
- Decimal must be represented using the dot ('.')
- Group separators are invalid
- Weight: Maximum 3 bytes of precision allowed.
Examples:
valid - "1234.567" invalid - "1,234.567", "1.234,567"
GT Nexus
19 10/21/2016
DTM DATE/TIME/PERIOD Pos: 0190 Max: 1
Conditional
Group: 5 Elements: 1
Loop Path: Group 4-Group 5 User Option (Usage): GTN Optional Function: To specify date, and/or time, or period.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
DTM010 C507 DATE/TIME/PERIOD M Comp GTN Required
Description: Date and/or time, or period relevant to the specified date/time/period type.
DTM010-010 2005 Date or time or period function code qualifier M an 1/3 GTN Required
Description: Code qualifying the function of a date, time or period. Information:
798 Verified gross mass determination date/time
DTM010-020 2380 Date or time or period text C an 1/35 GTN Required
Description: The value of a date, a date and time, a time or of a period in a specified representation.
DTM010-030 2379 Date or time or period format code C an 1/3 GTN Required
Description: Code specifying the representation of a date, time or period. Information:
203 CCYYMMDDHHMM
Note 1: Date and time when VGM was determined.
Sample Segment:
DTM+798:201604141100:203
GT Nexus
20 10/21/2016
Segment Group 7 Pos: 0230 Repeat: 1
Conditional
Group: 7 Elements: N/A
Loop Path: Group 4 User Option (Usage): GTN Required Function:
Segment Group Summary: Pos Tag Segment Name Status Rep Usage
0240 DOC DOCUMENT/MESSAGE DETAILS M 1 GTN Required
0250 DTM DATE/TIME/PERIOD C 1 GTN Optional
0260 Segment Group 8 C 9 GTN Required
GT Nexus
21 10/21/2016
DOC DOCUMENT/MESSAGE DETAILS Pos: 0240 Max: 1
Mandatory
Group: 7 Elements: 5
Loop Path: Group 4-Group 7 User Option (Usage): GTN Required Function: To identify documents and details directly related to it.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
DOC010 C002 DOCUMENT/MESSAGE NAME M Comp GTN Required
Description: Identification of a type of document/message by code or name. Code preferred.
DOC010-010 1001 Document name code C an 1/3 GTN Optional
Description: Code specifying the document name. Information:
749 Transport equipment gross mass verification message
DOC010-020 1131 Code list identification code C an 1/17 GTN Optional
Description: Code identifying a user or association maintained code list. Note: 1 The codes for this data
element are provided by the code list responsible agency defined in data element 3055. Information:
SM1 SOLAS gross mass verification method 1
SM2 SOLAS gross mass verification method 2
DOC010-030 3055 Code list responsible agency code C an 1/3 GTN Optional
Description: Code specifying the agency responsible for a code list. Information:
306 SMDG (Ship-planning Message Design Group)
Note 1: Sample Segment
DOC+749:SM2:306'
GT Nexus
22 10/21/2016
DTM DATE/TIME/PERIOD Pos: 0250 Max: 1
Conditional
Group: 7 Elements: 1
Loop Path: Group 4-Group 7 User Option (Usage): GTN Optional Function: To specify date, and/or time, or period.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
DTM010 C507 DATE/TIME/PERIOD M Comp GTN Required
Description: Date and/or time, or period relevant to the specified date/time/period type.
DTM010-010 2005 Date or time or period function code qualifier M an 1/3 GTN Required
Description: Code qualifying the function of a date, time or period. Information:
225 Certification of weight date/time
DTM010-020 2380 Date or time or period text C an 1/35 GTN Required
Description: The value of a date, a date and time, a time or of a period in a specified representation.
DTM010-030 2379 Date or time or period format code C an 1/3 GTN Required
Description: Code specifying the representation of a date, time or period. Information:
203 CCYYMMDDHHMM
Note 1: Date/Time when the Verified Gross Mass was determined or Date/Time when the document/certificate was issued
Sample Segment
DTM+225:201604141100:203
GT Nexus
23 10/21/2016
Segment Group 8 Pos: 0260 Repeat: 9
Conditional
Group: 8 Elements: N/A
Loop Path: Group 4-Group 7 User Option (Usage): GTN Required Function:
Segment Group Summary: Pos Tag Segment Name Status Rep Usage
0270 NAD NAME AND ADDRESS M 1 GTN Required
0280 Segment Group 9 C 2 GTN Optional
GT Nexus
24 10/21/2016
NAD NAME AND ADDRESS Pos: 0270 Max: 1
Mandatory
Group: 8 Elements: 9
Loop Path: Group 4-Group 7-Group 8 User Option (Usage): GTN Required Function: To specify the name/address and their related function, either by C082 only and/or unstructured by C058 or structured by C080 thru
3207.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
NAD010 3035 Party function code qualifier M an 1/3 GTN Required
Description: Code giving specific meaning to a party. Information:
SPC SOLAS verified gross mass responsible party
CA Carrier (Party undertaking or arranging transport of goods between named points.)
Note 2:
NAD Segment with NAD010 = "CA" should be used either in the Segment Group 2 or Segment Group 8, but not both
NAD020 C082 PARTY IDENTIFICATION DETAILS C Comp GTN Optional
Description: Identification of a transaction party by code. Information:
Used with NAD010 = "CA"
NAD020-010 3039 Party identifier M an 1/35 GTN Required
Description: Code specifying the identity of a party. Information:
Carrier SCAC recognized by Shipper and GT Nexus
NAD020-030 3055 Code list responsible agency code C an 1/3 GTN Optional
Description: Code specifying the agency responsible for a code list. Information:
86 Assigned by party originating the message (Codes assigned by the party originating the message).
NAD030 C058 NAME AND ADDRESS C Comp GTN Optional
Description: Unstructured name and address: one to five lines.
NAD030-010 3124 Name and address description M an 1/35 GTN Required
Description: Free form description of a name and address line.
NAD030-020 3124 Name and address description C an 1/35 GTN Optional
Description: Free form description of a name and address line.
NAD030-030 3124 Name and address description C an 1/35 GTN Optional
Description: Free form description of a name and address line.
NAD030-040 3124 Name and address description C an 1/35 GTN Optional
Description: Free form description of a name and address line.
NAD030-050 3124 Name and address description C an 1/35 GTN Optional
Description: Free form description of a name and address line.
NAD040 C080 PARTY NAME C Comp GTN Optional
Description: Identification of a transaction party by name, one to five lines. Party name may be formatted.
NAD040-010 3036 Party name M an 1/70 GTN Required
Description: Name of a party.
GT Nexus
25 10/21/2016
NAD040-020 3036 Party name C an 1/70 GTN Optional
Description: Name of a party.
NAD050 C059 STREET C Comp GTN Optional
Description: Street address and/or PO Box number in a structured address: one to four lines.
NAD050-010 3042 Street and number or post office box identifier
M an 1/35 GTN Required
Description: To identify a street and number and/or Post Office box number.
NAD050-020 3042 Street and number or post office box identifier
C an 1/35 GTN Optional
Description: To identify a street and number and/or Post Office box number.
NAD050-030 3042 Street and number or post office box identifier
C an 1/35 GTN Optional
Description: To identify a street and number and/or Post Office box number.
NAD050-040 3042 Street and number or post office box identifier
C an 1/35 GTN Optional
Description: To identify a street and number and/or Post Office box number.
NAD060 3164 City name C an 1/35 GTN Optional
Description: Name of a city.
NAD070 C819 COUNTRY SUBDIVISION DETAILS C Comp GTN Optional
Description: To specify a country subdivision, such as state, canton, county, prefecture.
NAD070-010 3229 Country subdivision identifier C an 1/9 GTN Optional
Description: To identify a country subdivision, such as state, canton, county, prefecture. Note: 1
Recommended use ISO 3166-2. If not applicable, use appropriate code set defined by appropriate national authority.
NAD080 3251 Postal identification code C an 1/17 GTN Optional
Description: Code specifying the postal zone or address. Note: 1 Use code defined by appropriate national
authority.
NAD090 3207 Country identifier C an 1/3 GTN Optional
Description: Identification of the name of the country or other geographical entity as defined in ISO 3166-1
and UN/ECE Recommendation 3. Note: 1 Use ISO 3166-1 two alpha country code.
Note 1: Sample Segment
NAD+SPC+222222::ZZZ++VGM RESPONSIBLE PARTY+ADDRESS+CITY+NY+10016+US'
NAD+CA+APLU:160:86'
GT Nexus
26 10/21/2016
Segment Group 9 Pos: 0280 Repeat: 2
Conditional
Group: 9 Elements: N/A
Loop Path: Group 4-Group 7-Group 8 User Option (Usage): GTN Optional Function:
Segment Group Summary: Pos Tag Segment Name Status Rep Usage
0290 CTA CONTACT INFORMATION M 1 GTN Required
0300 COM COMMUNICATION CONTACT C 9 GTN Optional
Note 1: Used within NAD loop where NAD010 = "SPC"
GT Nexus
27 10/21/2016
CTA CONTACT INFORMATION Pos: 0290 Max: 1
Mandatory
Group: 9 Elements: 2
Loop Path: Group 4-Group 7-Group 8-Group 9 User Option (Usage): GTN Required Function: To identify a person or a department to whom communication should be directed.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
CTA010 3139 Contact function code C an 1/3 GTN Required
Description: Code specifying the function of a contact (e.g. department or person). Information:
RP Authorized Responsible Person
CTA020 C056 CONTACT DETAILS C Comp GTN Optional
Description: Code and/or name of a contact such as a department or employee. Code preferred.
CTA020-020 3412 Contact name C an 1/256 GTN Required
Description: Name of a contact, such as a department or employee.
Note 1: With the function code "RP", this segment is used for transmission of a signature (person's name must be in CAPITAL letters).
Sample Segment
CTA+RP+:RESPONSIBLE PERSON NAME'
GT Nexus
28 10/21/2016
COM COMMUNICATION CONTACT Pos: 0300 Max: 9
Conditional
Group: 9 Elements: 1
Loop Path: Group 4-Group 7-Group 8-Group 9 User Option (Usage): GTN Optional Function: To identify a communication number of a department or a person to whom communication should be directed.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
COM010 C076 COMMUNICATION CONTACT M Comp GTN Required
Description: Communication number of a department or employee in a specified channel.
COM010-010 3148 Communication address identifier M an 1/512 GTN Required
Description: To identify a communication address.
COM010-020 3155 Communication means type code M an 1/3 GTN Required
Description: Code specifying the type of communication address. Information:
EM Electronic mail
FX Telefax
TE Telephone
Note 1: Sample Segment:
COM+111-123-4567:TE'
GT Nexus
29 10/21/2016
UNT MESSAGE TRAILER Pos: 0310 Max: 1
Mandatory
Group: N/A Elements: 2
User Option (Usage): GTN Required Function: To end and check the completeness of a message.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
UNT010 0074 Number of segments in a message M n 1/6 GTN Required
Description: The number of segments in a message body, plus the message header segment and message
trailer segment.
UNT020 0062 Message reference number M an 1/14 GTN Required
Description: Unique message reference assigned by the sender.
Notes: 1. 0062, the value shall be identical to the value in 0062 in thecorresponding UNH segment.
GT Nexus
30 10/21/2016
UNZ INTERCHANGE TRAILER Pos: Max: 1
Mandatory
Group: N/A Elements: 2
User Option (Usage): GTN Required Function: To end and check the completeness of an interchange.
Element Summary: Ref Tag Element Name Status Type Min/Max Usage
UNZ010 0036 Interchange control count M n 1/6 GTN Required
Description: The number of messages and packages in an interchange or, if used, the number of groups in
an interchange.
UNZ020 0020 Interchange control reference M an 1/14 GTN Required
Description: Unique reference assigned by the sender to an interchange.
Notes: 1. 0020, the value shall be identical to the value in 0020 in the corresponding UNB segment.
Note 1: Sample Segment
UNZ+1+349200517'
Appendix A: ***************************************************************************************************************************
Code Description
22GP 20' Standard Dry
42GP 40' Standard Dry
L2GP 45' Standard Dry
M2GP 48' Standard Dry
P2GP 53' Standard Dry
25GP 20' High Cube Dry
45GP 40' High Cube Dry
L5GP 45' High Cube Dry
M5GP 48' High Cube Dry
P5GP 53' High Cube Dry
22RE 20' Reefer
42RE 40' Reefer
L5RE 45' High Cube Reefer
45RE 40' High Cube Reefer
22PL 20' Flat Rack
42PL 40' Flat Rack
22UT 20' Open Top
42UT 40' Open Top
22TN 20' Tank
42TN 40' Tank
22HR 20' Non-Operating Reefer
42HR 40' Non-Operating Reefer
45HR 40' High Cube Non Operating Reefer
L5HR 40' High Cube Non-Operating Reefer
9V13 45' Trailer
9V17 48' Trailer
9V24 53' Trailer
9V05 45' Insulated Trailer
4F09 40' Flatbed Trailer
9F25 45' Flatbed Trailer
4F06 40' Expandable Flatbed
9F18 45' Expandable Flatbed
GT Nexus
31 10/21/2016
LS40 40' Low Boy Flatbed
LF60 45' Low Boy Flatbed
4T01 40' Tank Trailer
22RD 20' Dual Reefer
22GH 20' Standard GOH
42GH 40' Standard GOH
L2GH 45' Standard GOH
45GH 40' High Cube GOH
L5GH 45' High Cube GOH
M5GH 48' High Cube GOH
22BK 20' Bulk pressurized
22BU 20' Bulk non-pressurized
22PC 20' Flat Rack Collapsible
22TD 20' Isotank dangerous liquid
22TG 20' Isotank Gas
22VH 20' Vented
42BU 40' Bulk non-pressurized
42PC 40’ Flat Rack Collapsible
42VH 40' Vented
29PO 20’ Artificial Tweendeck
49PO 40’ Artificial Tweendeck
22U3 20’ Open Side Open Top
***************************************************************************************************************************
Appendix B: ***************************************************************************************************************************
Common Scenarios and Sample Files
UNA:+.? '
UNB+UNOC:1+CARRIER_ID:ZZZ+GTNEXUS:ZZZ+160402:2356+349200517'
UNH+1+VERMAS:D:16A:UN'
BGM+749+SHIPMENT_ID+9'
DTM+137:201204181552:203'
NAD+TB+111111::ZZZ++VGM SUBMITTER NAME+ADDRESS+CITY+NY+10038+US'
CTA+IC+:SUBMITTER CONTACT NAME'
COM+SUBMITTER EMAIL:EM'
COM+555 555 5555:TE'
NAD+CA+APLU:160:86'
EQD+CN+HJSC1234560+22GP'
RFF+BN:12345678'
RFF+VGR:AA1111
SEL+12345'
MEA+AAE+VGM+KGM:1234.5'
DTM+798:201604141100:203'
DOC+749:SM2:306'
DTM+225:201604141100:203'
NAD+SPC+222222::ZZZ++VGM RESPONSIBLE PARTY+ADDRESS+CITY+NY+10016+US'
CTA+RP+:RESPONSIBLE PERSON NAME'
COM+111-123-4567:TE'
UNT+20+1'
UNZ+1+349200517'
***************************************************************************************************************************
Appendix C: ***************************************************************************************************************************
File Naming Convention
To facilitate our mutual support efforts for your integration to multiple customers through this integration, please follow the following file naming
convention when transmitting the file.
<Sender ID>_<Receiver ID>_<Message Type>_<Transmission ID>_<Trans Date Time>.<EXT>
GT Nexus
32 10/21/2016
Where for EDIFACT EDI...
· Sender ID = Interchange Sender ID UNB020-0004
· Receiver ID = Functional Application Receiver ID UNB030-0010
· Message Type = Functional Identifier Code UNH020-0065
· Transmission ID = Interchange Control Number UNB050-0020
· Trans Date Time = UNB040-0017 + UNB040-0019 + file generation seconds.milliseconds in YYMMDDTHHMMSSms format
· EXT = .EDIFACT
For example: SENDERID_GTNEXUS_VERMAS_000001046_20081222T14102926.EDIFACT
***************************************************************************************************************************
Appendix D:
Change Log
Version Date Author(s) Summary Of Changes
V_1.0_Draft 04/15/2016 Zdravko Belicajevic Initial Draft Document
V_1.0_Draft 05/30/2016 Zdravko Belicajevic
As per Tom Galinski's comments,
added Carrier as a Party (Segment
Group 2 / Segment Group 8), several
corrections done
V_1.0_Final 05/28/2016 Zdravko Belicajevic
Updated the BGM010-010, RFF010-
010, and DOC010-010 / DOC010-
020 codes as per
UN/UNECE officially published
VERMAS 16A
V_1.0_Final 09/13/2016 Zdravko Belicajevic
- Replaced the UNB Header Syntax
Version 4 with the UNB Header
Syntax version 3 (noticable difference
is the format of the date: YYMMDD
instead of YYYYMMDD)
- Changed EQD030 (Equipment Size
and Type) from GTN Required to
GTN Optional
V_1.0_Final 10/21/2016 Zdravko Belicajevic
- Reinroduced the REF segment with
REF01 = "AOW" (Submitter's VGM
transaction reference)
- Removed the note that VGR
(Transport equipment gross mass
verification reference number) is
mandatory.