34
VERMAS Verified Gross Mass D16A - Customer Version: 1.0 Company: GT Nexus Modified: 10/21/2016

Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

  • Upload
    lamtu

  • View
    216

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

VERMAS Verified Gross Mass D16A - Customer

Version: 1.0

Company: GT Nexus

Modified: 10/21/2016

Page 2: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020
Page 3: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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.

Page 4: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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)

Page 5: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

Page 6: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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’

Page 7: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

Page 8: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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’

Page 9: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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

Page 10: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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

Page 11: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

Page 12: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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

Page 13: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

Page 14: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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’

Page 15: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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

Page 16: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

Page 17: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

Page 18: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

Page 19: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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

Page 20: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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"

Page 21: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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

Page 22: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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

Page 23: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

Page 24: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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

Page 25: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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

Page 26: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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.

Page 27: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

Page 28: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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"

Page 29: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

Page 30: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

[email protected]:EM'

Page 31: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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.

Page 32: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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

Page 33: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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'

[email protected]:EM'

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>

Page 34: Version: 1 - GT Nexusmktforms.gtnexus.com/rs/979-MCL-531/images/GTN_VERMAS_D16A... · The message type code for the ... Instruction messages conforming to this document must ... 0/0020

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.