Tracelink University

Table of contents

Ocean Shipment Arrival Notice, is an electronic message used by ocean carriers or freight forwarders to notify the shipper, manufacturer or, consignee when an ocean freight shipment is nearing or has arrived at its destination port. An Ocean Shipment Arrival Notice typically includes the estimated arrival date and time, details of the vessel and voyage, the port of arrival, and shipment and container identifiers. It also outlines customs clearance requirements and specifies any charges due before cargo arrival.

The Ocean Shipment Status X12 message enables proactive supply chain management by alerting stakeholders to key events like vessel departures, port arrivals, customs updates, and potential disruptions.

Contact your TraceLink Services representative for more information about integrating with this message.

  • Message Type: MPC_OCEAN_SHIPMENT_ARRIVAL_NOTICE

  • X12 Format: OCEANSHIPMENTARRIVALNOTICE

  • Transform Names:

    • B2B_EDI_X12_312_OceanShipmentArrivalNotice_IB_V1

    • B2B_EDI_X12_312_OceanShipmentArrivalNotice_OB_V1

Input Element Occurs Length Description Example
312 1…1 – Required. X12 312 Ocean shipment arrival notice –
  ISA 1…1 – Required. ISA interchange envelope. –
    ISA01 1…1 2/2 Required. Qualifier for authorization control number in ISA02. 00
    ISA02 1…1 10/10 Required. Information used for additional identification or authorization of the interchange sender or the data in the interchange/ 10 spaces a valid entry. –
    ISA03 1…1 2/2 Required. Qualifier for security information in ISA04. 00
    ISA04 1…1 10/10 Required. Identifies security information about the interchange sender or data. –
    ISA05 1…1 2/2

Required. Interchange sender partner ID qualifier.

  • 01 – Duns (Dun & Bradstreet).
  • 02 – Standard Carrier Alpha Code.
  • 03 – Federal Maritime Commission.
  • 04 – International Air Transport Association.
  • 07 – Global Location Number (GLN).
  • 08 – UCC EDI Communications ID (Comm ID).
  • 09 – X.121 (CCITT).
  • 10 – Department of Defense (DoD) Activity Address Code.
  • 11 – Drug Enforcement Administration identifier.
  • 12 – Telephone Companies.
  • 13 – Used for UCS Transmissions. Includes Area Code and Telephone Number of a Modem.
  • 14 – Duns Plus Suffix.
  • 15 – Petroleum Accountants Society of Canada Company Code.
  • 16 – DINS Number With 4-Character Suffix.
  • 17 – American Bankers Association (ABA) Transit Routing Number (Including Check Digit, 9 Digit).
  • 18 – Association of American Railroads (AAR) Standard Distribution Code.
  • 19 – EDI Council of Australia (EDICA) Communications ID Number (COMM ID).
  • 20 – Health Industry Number (HIN).
  • 21 – Integrated Postsecondary Education Data System.
  • 22 – Federal Interagency Commission on Education, or FICE.
  • 23 – National Center for Education Statistics Common Core of Data 12-Digit Number for Pre-K-Grade 12 Institutes.
  • 24 – The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP.
  • 25 – 4-Digit Code of Postsecondary Institutions.
  • 26 – Statistics of Canada List of Postsecondary Institutions.
  • 27 – Carrier Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 28 – Fiscal Intermediary Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 29 – Medicare Provider and Supplier Identification Number assigned by Health Care Financing Administration (HCFA).
  • 30 – U.S. Federal Tax Identification Number.
  • 31 – Jurisdiction Identification Number Plus 4 assigned by the International Association of Industrial Accident Boards and Commissions (IAIABC).
  • 32 – U.S. Federal Employer Identification Number (FEIN).
  • 33 – National Association of Insurance Commissioners Company Code (NAIC).
  • 34 – Medicaid Provider and Supplier Identification Number as assigned by individual State Medicaid Agencies in conjunction with Health Care Financing Administration (HCFA).
  • 35 – Statistics Canada Canadian College Student Information System Institution Codes
  • 36 – Statistics Canada University Student Information System Institution Codes.
  • 37 – Society of Property Information Compilers and Analysts (SPICA).
  • 38 – The College Board and ACT, Inc. 6-Digit Code List of Secondary Institutions.
  • AM – Association Mexicana del Codigo de Producto (AMECOP) Communication ID.
  • NR – National Retail Merchants Association (NRMA) - Assigned.
  • SA – User Identification Number as assigned by the Safety and the Fitness Electronic Records (SAFER) System.
  • SN – Standard Address Number.
  • ZZ – Mutually Defined.
 07
    ISA06 1…1 15/15 Required. Interchange sender identification mapping to fileSenderNumber with party type defined in ISA05. 7777776067344
    ISA07 1…1 2/2

Required. Interchange receiver partner ID qualifier.

  • 01 – Duns (Dun & Bradstreet).
  • 02 – Standard Carrier Alpha Code.
  • 03 – Federal Maritime Commission.
  • 04 – International Air Transport Association.
  • 07 – Global Location Number (GLN).
  • 08 – UCC EDI Communications ID (Comm ID).
  • 09 – X.121 (CCITT).
  • 10 – Department of Defense (DoD) Activity Address Code.
  • 11 – Drug Enforcement Administration identifier.
  • 12 – Telephone Companies.
  • 13 – Used for UCS Transmissions. Includes Area Code and Telephone Number of a Modem.
  • 14 – Duns Plus Suffix.
  • 15 – Petroleum Accountants Society of Canada Company Code.
  • 16 – DINS Number With 4-Character Suffix.
  • 17 – American Bankers Association (ABA) Transit Routing Number (Including Check Digit, 9 Digit).
  • 18 – Association of American Railroads (AAR) Standard Distribution Code.
  • 19 – EDI Council of Australia (EDICA) Communications ID Number (COMM ID).
  • 20 – Health Industry Number (HIN).
  • 21 – Integrated Postsecondary Education Data System.
  • 22 – Federal Interagency Commission on Education, or FICE.
  • 23 – National Center for Education Statistics Common Core of Data 12-Digit Number for Pre-K-Grade 12 Institutes.
  • 24 – The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP.
  • 25 – 4-Digit Code of Postsecondary Institutions.
  • 26 – Statistics of Canada List of Postsecondary Institutions.
  • 27 – Carrier Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 28 – Fiscal Intermediary Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 29 – Medicare Provider and Supplier Identification Number assigned by Health Care Financing Administration (HCFA).
  • 30 – U.S. Federal Tax Identification Number.
  • 31 – Jurisdiction Identification Number Plus 4 assigned by the International Association of Industrial Accident Boards and Commissions (IAIABC).
  • 32 – U.S. Federal Employer Identification Number (FEIN).
  • 33 – National Association of Insurance Commissioners Company Code (NAIC).
  • 34 – Medicaid Provider and Supplier Identification Number as assigned by individual State Medicaid Agencies in conjunction with Health Care Financing Administration (HCFA).
  • 35 – Statistics Canada Canadian College Student Information System Institution Codes
  • 36 – Statistics Canada University Student Information System Institution Codes.
  • 37 – Society of Property Information Compilers and Analysts (SPICA).
  • 38 – The College Board and ACT, Inc. 6-Digit Code List of Secondary Institutions.
  • AM – Association Mexicana del Codigo de Producto (AMECOP) Communication ID.
  • NR – National Retail Merchants Association (NRMA) - Assigned.
  • SA – User Identification Number as assigned by the Safety and the Fitness Electronic Records (SAFER) System.
  • SN – Standard Address Number.
  • ZZ – Mutually Defined.
 01
    ISA08 1…1 15/15 Required. Instance 1 EDI receiver ID mapping to file control header and to ServiceLinkId. 888888404358877
    ISA09 1…1 6/6 Required. Interchange date in 6 char YYMMDD format. 231020
    ISA10 1…1 4/4 Required. Interchange time in 4 char HHMM format. 1420
    ISA11 1…1 1/1

Required. This value is dependent on X12 version.

  • Version 4012 and earlier – Interchange control standards identifier. The valid value is U.
  • Version 004020 and later – Repetition separator, a delimiter that separates repeated occurrences of a data element or composite data structure, which must be different from the data element separator, component separator, and segment terminator.
 ^
    ISA12 1…1 5/5 Required. Interchange control version number. This could be any X12 version. 00501
    ISA13 1…1 9/9 Required. Interchange Control Number mapping to file control header 0000000000619827
    ISA14 1…1 1/1

Interchange level acknowledgment requested.

Valid values:

  • 0- No acknowledgment requested

  • 1 - Interchange level acknowledgment requested

 0
    ISA15 1…1 1/1

Required. Indicates whether the interchange is for production, test, or information purposes.

Valid values:

  • I - Information

  • P - Production data

  • T- Test data

 P
    ISA16 1…1 1/1 Required. Component element separator. Delimiter that separates data elements within a composite data structure. Must be different than the data element separator and segment terminator >
  GS 1…* – GS group functional envelope. Child of ISA. Only one GS group expected per interchange. –
    GS01 1…1 2/2 Required. GS group function code. The valid value IO – Ocean shipment arrival notice Information. QO
    GS02 1…1 2/15 Required. Application Sender's Code. 2222224043588
    GS03 1…1 2/15 Required. Application Receiver's Code. TRACELINK
    GS04 1…1 8/8 Required.Current date stamp in 8 char X12 date format YYYYMMDD. 20241020
    GS05 1…1 4/8 Required. Current time stamp in 6 char X12 time format HHMMSS. 142000
    GS06 1…1 1/9 Required. Group control ID number. 619827
    GS07 1…1 1/2

Required. Responsible agency code.

Valid values:

  • T – Transportation Data Coordinating Committee (TDCC)

  • X – Accredited Standards Committee X12

 X
    GS08 1…1 1/12 Required. X12 message version code. This could be any X12 version. 005010
  ST 1…* – ST transaction set envelope. Child of GS group. Only one ST transaction expected. –
    ST01 1…1 3/3 Required. Transaction set identifier code. 312
    ST02 1…1 4/9 Required. Transaction set ID number. Counter for each ST segment beginning with 1. 0001
    B3 1…1 – Required. Ocean shipment arrival notice beginning segment for Inquiry or Reply. –
      B301 0…1 1/1

Shipment type, specifying relationship of this shipment with other shipments handed over to carrier at the same time.

Valid values:

  • 2 – Sea Waybill
  • 3 – Intermodal/Combined Transport Bill of Lading
  • 6 – First Bill for Split Shipment
  • 7 – Subordinate Bill for a Split Shipment
  • B – Bill of Lading for Individual Shipment
  • C – Consolidated Shipment
  • M – Master Bill of Lading with Multiple Delivery Locations
  • R – Supplemental billing, Refers to additional or corrected billing related to a shipment, not necessarily to movement or splits.
  • U – A special type of continuous movement in which carrier load at A, deliver at B, reload at B, return to A (roundtrip)
  • V – Void bill
 2
      B302 1…1 1/22 Required. Invoice number. 12321
      B303 0…1 1/30 Shipment Identification number assigned to the shipment by the shipper that uniquely identifies the shipment from origin to ultimate destination and is not subject to modification, Does not contain blanks or special characters. SH12312
      B304 1…1 2/2

Required. Transportation charges payment method type.

Valid values:

  • CA – Advance collect
  • PA – Advance prepaid
  • BP – Paid by buyer
  • DF – Defined by buyer and seller
  • CC – Collect
  • PO – Prepaid only
  • PP – Prepaid seller
  • PS – Paid by seller
  • TP – Third party pay.
 CA
      B306 1…1 8/8 Required. Document date in YYYYMMDD format 20070609
      B307 1…1 1/15 Required. Net amount due in ANSI implied decimal format with 2 decimals , for example due amount is 10$, value is 1000 (with two decimals) 1000
      B308 0…1 2/2

Type of correction to previously received arrival notification.

Valid values:

  • AD – Adjustment of Previous Freight Bill Charges
  • AI – Supply Additional Information
  • AR – Adding Revenue
  • BD – Balance Due Billing
  • BE – Billing Error Correction
  • BO – Bad Order Setback/Bill Cancelled
 AD
      B309 0…1 8/8 Delivery date in YYYYMMDD format, If either B3-09 or B3-10 is present, then the other is required 20070609
      B310 0…1 3/3

Date type qualifier.

Valid values:

  • 139 – Estimated
  • 140 – Actual
  • 369 – Estimated Departure Date
  • 370 – Actual Departure date
  • 371 – Estimated Arrival date
  • 372 – Actual Arrival date
  • 058 – Customs Clearance date
  • 161 – Loaded on vessel date
  • 813 – Customs entry date
  • 510 – Date packed
  • 999 – Document date
  • 003 – Invoice date
  • 017 – Estimated delivery date
  • 035 – Delivery date
 035
      B311 1…1 2/4 Required.Carrier SCAC code. SC01
      B313 0…1 2/2

Type of service providing for charging / rating purpose.

Valid values:

  • BB – Rate for shipments for barge-to-barge carrier terminal service.
  • BD – Rate for shipments for barge-to-door service.
  • BM – Rate for shipments for barge-to-motor service.
  • BR – Rate for shipments for barge-to-rail service.
  • BO – Rate for shipments for barge-to-ocean terminal service.
  • DD – Rate applies for shipments in door-to-door service
  • DM – Rate applies for shipments in door-to-motor service
  • DO – Rate applies for shipments in door-to-ocean terminal service.
  • DR – Rate applies for shipments in door-to-rail service.
  • DP – Rate applies for shipments in door-to-ocean carrier's port service.
  • PD – Rate applies for shipments in pier-to-door service.
  • MM – Rate applies for shipments in one stage motor carrier terminal-to- next stage motor carrier terminal service.
  • MO – Rate applies for shipments in motor carrier terminal-to-ocean carriers port/terminal service.
  • MP – Rate applies for shipments in motor carrier terminal-to-ocean carrier's port/terminal pier service.
  • MR – Rate applies for shipments in motor carrier terminal-to-rail carrier terminal service.
  • OM – Rate applies for shipments in ocean carrier's terminal-to-motor carrier's terminal.
 BB
      B314 0…1 3/3 Delivery term code, if this is used, B304 indicates responsible party for payment. CPT
    Q3 0…1 – Estimated arrival date and payment details –
      Q301 1…1 8/8 Required.Estimated arrival date in YYYYMMDD format at port of discharge 20070609
      Q302 1…1 2/2

Required. Transportation charges payment method type.

Valid values:

  • CA – Advance collect

  • PA – Advance prepaid

  • BP – Paid by buyer

  • DF – Defined by buyer and seller

  • CC – Collect

  • PO – Prepaid only

  • PP – Prepaid seller
  • PS – Paid by seller

  • TP – Third party pay

 CA
    C3 0…1 – Currency code info for ocean shipment arrival notice –
      C301 1…1 3/3 Required. Standard ISO currency code for the country in which the payments are specified. USD
    R2 0…13 – Carrier routing and providing service information through out the shipment –
      R201 1…1 2/4 Required. Standard carrier alpha code (SCAC code) SCAC
      R202 1…1 1/2

Required. Carrier sequence code during this end to end delivery of the shipment.

Valid values:

  • 0 – Original carrier
  • 1 – First carrier after original
  • 2 – Second carrier after original
  • 3 – Third carrier after original
  • 4 – Fourth carrier after original
  • 5 – Fifth carrier after original
O
      R203 0…1 2/30 Station or city name at which carriers interchange shipments City
      R206 0…1 1/2

Transport method type.

Valid values:

  • J – Truck

  • SR – Supplier truck

  • 7 – By Mail

  • R – Shipped by train

  • S – By sea

  • A – By air

 J
      R212 0…1 2/2

Type of service providing for charging / rating purpose.

  • CFR – Rate of shipments for barge-to-barge carrier terminal service
  • CIF – Rate of shipments for barge-to-door service
  • CIP – Rate of shipments for barge-to-motor service
  • CPT – Rate of shipments for barge-to-rail service
  • DAP – Rate of shipments for barge-to-ocean terminal service
  • DAT – Rate of shipments for freight station to freight station service
  • DDP – Rate of shipments for freight station to door service
  • EXW – Buyer bears all costs and risks in taking the goods from the seller's premises to the desired location
  • FAS – Buyer bears all costs and risks, after goods are placed on vessel
  • FCA – Free carrier for buyer, because shipment costs are taken care by seller
  • FOB – Free on board, costs and risks are owned by seller
 RE
      R213 0…1 1/35 Descriptive information about Route –
    N9 0…30 – Reference segment for mapping to the transaction references. –
      N901 1…1 2/3

Required. Reference identification qualifier for the contract class.

  • FN – Freight forwarder reference identifier
  • ZZ – Mutually defined number
  • OC – Ocean container number
  • 8X – Transaction Type
  • BN – Booking number
  • SE – Serial number
  • EQ – Equipment number
  • SCA – SCAC code
  • P8 – Pickup reference number
  • 1J – Facility ID Number
  • 4F – Carrier-assigned Shipper Number
  • CT – Contract number
  • BM – Bill of Lading Number
  • PO – Purchase Order Number
  • VN – Vendor order number
  • IV – Seller invoice number
  • MB – Master BOL
  • SN – Seal number
  • AG – Agent shipment number
  • CN – Carrier reference number
  • CG – Conginees order number
  • PR – Price quote number
 FN
      N902 0…1 1/80 Reference identifier value. 123456
    V1 1…2 – Vessel details. –
      V101 0…1 1/8 Vessel unique identifier, at least one of V1-01 or V1-02 is required. 9399193
      V102 0…1 2/28 Vessel registered name. Flora
      V103 0…1 2/3 Vessel registered country code. UK
      V104 0…1 2/30 Voyage identifier on which the cargo travels. 12345
      V105 0…1 2/4 Ocean carrier SCAC code. SC01
      V108 0…1 1/1

Vessel code qualifier, organization provides vessel unique identifier, if this is present V101 is required.

Valid values:

  • B – U.S. Bureau of Census

  • C – Ship's Radio Call Signal

  • L – Lloyd's Register of Shipping

  • Z – Mutually defined number

 B
    R4 1…20 – Port or terminal details –
      R401 1…1 1/1

Required. Port or Terminal function codes.

  • 1 – Final Port of Discharge (Operational) - Last port at which cargo is unloaded from vessel.
  • 5 – Activity Location (Operational) - Place at which the activity being reported is occurring.
  • B – Reconsolidation Point (Operational).
  • C – De-Consolidation Point (Operational).
  • D – Port of Discharge (Operational) - Port at which cargo is unloaded from vessel.
  • E – Place of Delivery (Contractual) - Place at which cargo leaves its care and custody of carrier.
  • I – Interim Point (Operational) - Place at which cargo is transferred from one inland means of transport to another.
  • L – Port of Loading (Operational) - Port at which cargo is loaded on vessel.
  • R – Place of Receipt (Contractual) - Place at which cargo enters the care and custody of carrier.
  • T – Transshipment Port (Contractual) - Place at which cargo is transferred to another carrier.
  • M – Destination (Operational) - Place at which carrier actually turns cargo to consignee or his agent.
  • S – Return Pool (Operational) - Place at which equipment is returned.
  • Y – Relay Port (Operational).
  • N – Final Destination (Operational) - Consignee's facility at which shipment ends its movement at cargo's expense.
  • G – Port of Entry (Operational) - Place at which cargo actually enters a country where the cargo is not part of its commerce.
  • O – Origin (Operational) - Shipper's facility at which shipment begins its movement at cargo's expense.
  • H – Port of exit.
 O
      R402 0…1 1/2

Port Location qualifier, indicating type of location.

  • 18 – Marker identifier location.
  • CI – City code.
  • D – Domestic U.S. ports (Schedule D).
  • L – Local address.
  • K – Foreign ports (Schedule K), and international.
  • UN – United Nations Location Code.
  • OV – On Vessel (Free On Board [FOB] point)
  • CY – Container Yard - Area designated for container storage.
  • DC – Distribution Center Number.
  • DE – Destination - Shipping.
  • DO – District Office.
  • FR – U.S. Customs Facilities Information and Resource Management Systems (FIRMS) — Identifies U.S. Customs facilities related to the shipment.
  • FT – Foreign Trade Zone - A designated area where goods can be stored without being subject to customs duties.
  • KE – Port of Embarkation - The port where the cargo is loaded onto the vessel.
  • KL – Port of Loading - Another term for the port where the cargo is loaded.
  • LO – Local Office.
  • OR – Origin (Shipping Point).
  • PA – Port of Arrival - The port where the cargo arrives in the destination country.
  • PB –Port of Discharge - The port where the cargo is unloaded from the vessel.
  • PD – Place of Delivery.
  • PE – Port of Entry - The port where customs clearance is performed.
  • PL – Plant - Facility where goods are manufactured or processed.
  • TL – Terminal Cargo Location - The specific terminal within a port where the cargo is handled.
  • TM – Terminal - Specific terminal facility within a port.
  • WF – Wharf - The dock or quay where the vessel is moored.
  • ZZ – Mutually Defined - Custom qualifier defined by trading partners.
 CI
      R403 0…1 1/30 Port Location Identifier, if R402 is present R403 is required. USLGB
      R404 0…1 2/24 Port name. USPort
      R405 0…1 2/3 Port located country code. US
      R406 0…1 2/20 Terminal name. Terminal
      R408 0…1 2/2 State or Province code. TX
      DTM 0…15 – Dates relevant to shipments events at port. –
        DTM01 1…1 3/3

Required. Date type qualifier for shipment events in R4-DTM loop.

Valid values:

  • 139 – Estimated
  • 140 – Actual
  • 369 – Estimated Departure Date
  • 370 – Actual Departure date
  • 371 – Estimated Arrival date
  • 372 – Actual Arrival date
  • 058 – Customs Clearance date
  • 161 – Loaded on vessel date
  • 813 – Customs entry date
  • 510 – Date packed
  • 999 – Document date
  • 003 – Invoice date
  • 017 – Estimated delivery date
  • 035 – Delivery date
 '139
        DTM02 0…1 8/8 Contract date in date format YYYYMMDD, if DTM01 present DTM02 or DTM03 is required. 20240628
        DTM03 0…1 4/8 Contract time in time format HHMMSS. 123422
        DTM04 0…1 2/2 Time zone code. CT
    H3 0…6 – Special handling instructions. –
      H301 0…1 2/3

Special handling instruction code.

Valid values:

  • EP – Expedite

  • DM – Domestic

  • DA – Goods categorized as dangerous goods

  • CH – Carrier

 DA
      H302 0…1 2/30 Descriptive information of handling instruction. –
      H303 0…1 1/4 Protective service for perishable goods. –
      H304 0…1 1/7 Equipment vent setting code X12 pass through. V40
      H305 0…1 1/1

Traffic tariff application code.

Valid values:

  • N – Interstate
  • S – Intrastate
  • R – Regional
  • I – International
  • D – Reciprocal
N
    L5 0…1 – Lading items packaging, description details. –
      L501 0…1 1/6 Lading item number. 01
      L502 0…1 1/50 Lading item description. Item description
      L503 0…1 1/30 Commodity code, describes commodity or group of commodities. 123H1
      L504 0…1 1/1

Commodity coding system used for commodity.

Valid values:

  • 2 – Dun's SIC 2+2, Dun & Bradstreet
  • 5 – National Drug Code
  • C – Canadian Freight
  • N – Motor Freight Classification
  • P – Bulk Codes
  • Q – Quota Category
  • S – Standard International Trade Classification
  • T – Standard Transportation Commodity Code
  • Z – Mutually defined
 5
      L505 0…1 3/5

Packaging material used for inner level packing.

  • CAS – Case
  • CTN – Carton
  • PLT – Pallet
  • RCK – Rack
  • UNT – Unit
  • BAG - Bag
  • BAL - Bale
  • BBL - Barrel
  • BGD – Banding to bind/tie package to secure it
  • BDL – Bundle
  • BLS – Blister packaging between dome and carrier
  • BOT – Bottle
  • CAN – Can
  • DRM –Drum
  • ENV – Envelope
  • FSK – Flask
  • JAR – Jar
  • JUG – Jug
  • KEG – Keg
  • MUL – Multipack - consumer bundle
  • ROL – Roll
  • SAH – Sachet
  • SAK – Sack
  • SPI – Spin Cylinders
  • SPL – Spool
  • TBE – Tube
  • TBN – Tote Bin
  • TRY – Tray
  • TUB – Tub
  • VIL – Vial
  • WRP – Wrapped
 ENV
    N1 1…10   Segment loop for Party idenfitiers, like Carrier, notifying party, shipper..etc, at least one party details is required. –
      N101 1…1 2/3

Required. Entity qualifier for the party identifier and address information.

Valid values:

  • N1 - Notify party

  • SH - Shipper party

  • CA - Carrier party

  • BT - Bill To party

  • CN - Consignee party

  • CI - Consignorr

  • FW - freight forwarder party

N1
      N102 0…1 1/60 Name Pharma customer
      N103 0…1 1/2

Identifier code qualifier.

Valid values:

  • 1- DUNS

  • 2 - SCAC

  • 9 - DUNS+4

  • 11 - Drug Enforcement Agency registration number

  • 21 - Health Industry Number

  • 91 - Company identifier

  • 92 - Company location identifier

  • UL - Global Location Number

 UL
      N104 0…1 2/80 notify party identifier as qualified by N103 mapping to companyIdentifierValue. 3333331013655
      N3 0…1 – N3: Address: Child of purchasing group (notify party) N1 name segment. –
        N301 1…1 1/55 Required. Street address 1. 555 Neelan Road
        N302 0…1 1/55 Street address 2. Suite 123
      N4 0…1 – N4: Geographic Location. Child of notify party N1 name segment. –
        N401 0…1 2/30 City name. Sacramento
        N402 0…1 2/2 State or province code. Code (Standard state/province) as defined by appropriate government agency. CA
        N403 0…1 3/15 Postal code. Code defining international postal zone code excluding punctuation and blanks. 95833
        N404 0…1 2/3 Country code. US
    LX 1…999 – Arrival notice line item details, at least one iteration is required. –
      LX01 1…1 1/6 Required. Transaction set line number. 1
      N7 0…999 – Equipment details using for this shipment, if N7 Loop present at least one iteration of N7 segment.. –
        N701 0…1 1/4 Equipment prefix. SC
        N702 1…1 1/15 Required. Equipment unique identifier. 1234
        N703 0…1 1/10 Equipment weight value. If either N7-03 or N7-04 is present, then the other is required. 10
        N704 0…1 1/2

Equipment weight qualifier.

  • A5 - Average weight

  • A4 - Average weight per load

  • B - Billed weight

  • CE - Certified weight of cargo

  • A - Consolidated weight

  • F - Deficit weight

  • E - Estimated net weight

  • O - Excess weight over maximum

  • FR - Freight weight

  • G - Gross weight

  • L - Legal weight

  • LC - Maximum lading capacity

  • M - Minimum weight for rate

  • N - Actual net weight

  • ND - Non-chargeable dunnage

  • V - Non transit weight - transit bills only

  • PA - Pallet weight

  • U - Weight per unit

  • A3 - Shipper's weight

  • SK - Skid weight

  • T - Tare weight

  • W - Transit weight - transit bills only

  • SO - Storage in transit out

 B
        N705 0…1 1/8 Tare weight value 2
        N706 0…1 1/6 Weight allowance provided for increased weight during transport such as snow –
        N707 0…1 1/6 Lading protected material weight –
        N708 0…1 1/8 Equipment volume value, If either N7-08 or N7-09 is present, then the other is required 100
        N709 0…1 1/1

Equipment volume unit type.

  • B – Volume of barge
  • T – Volume of container
  • C – Cubic centimeters
  • M – Cubic decimeters
  • E – Cubic feet
  • N – Cubic inches
  • X – Cubic meters
  • G – Gallons
  • V – Liter
  • L – Total volume of load
 B
        N710 0…1 1/1 Equipment owner ship code or relationship with equipment –
        N711 0…1 2/2

Type of equipment used in delivery.

Valid values:

  • AP – Aircraft

  • CN – Container

  • RR – Railcar

  • TL – Trailer

  • VT – Ship

  • TO – Truck

 CN
        N712 0…1 2/4 Equipment owner Standard carrier alpha code (SCAC code). SCAC
        N713 0…1 3/6 Temperature control free form description, like range or flash point.  
        N714 0…1 1/3 Position of equipment in trailer or car or container.  
        N715 0…1 4/5 Length in feet and inches of equipment used in shipment format is FFFII (FFF= feet's, II = Inches. If value is 1211 = 12 feet 11 inches. 1211
        N716 0…1 1/1

Code identifying the type of tare.

Valid values

  • A – Actual

  • M – Marked

 –
        N717 0…1 1/1

Weight unit type code

Valid values:

  • E – Metric ton
  • G – Grams
  • K – Kilograms
  • L – Pounds
  • M– Measurement ton
  • O – Ounces
  • S – Short ton
  • T – Long ton
 E
        N718 0…1 1/1 Equipment number check digit number. 2
        N719 0…1 2/2 Extent of transportation service requested type. –
        N720 0…1 1/8 Equipment height used in transport , in inches, can include up to 5 decimals. 12.234
        N721 0…1 1/8 Shorter measurement of the two horizontal dimensions measured with the object in the upright position , in inches, can include up to 5 decimals. 12.234
        QTY 0…1 – Equipment quantity –
          QTY01 1…1 2/2 Required. Quantity type for return. The valid value is 39 – Shipped 39
          QTY02 0…1 1/15 Quantity of product 25.00
          QTY03.1 1…1 2/2

Required. Unit of measure used for pricing.

  • 02 – Statute Mile
  • 4G – Microliter
  • AM – Ampoule
  • AV – Capsule
  • BD – Bundle
  • BG – Bag
  • BO – Bottle
  • BX – Box
  • C3 – Centiliter
  • C8 – Cubic decimeters
  • CA – Case
  • CC – Cubic Centimeter
  • CF – Cubic Feet
  • CG – Card Blister
  • CH – Container
  • CI – Cubic Inches
  • CL – Cylinder
  • CM – Centimeter
  • CN – Can
  • CP – Crate
  • CQ – Cartridge
  • CR – Cubic Meters
  • CT – Carton
  • DA – Day
  • DI – Dispenser
  • DK – Kilometers
  • DL – Deciliter
  • DM – Decimeter
  • DR – Drum
  • DS – Display
  • DZ – Dozen
  • EA – Each
  • FO – US Fluid Ounce
  • FT – Foot
  • GA – US Gallon
  • GL – Gram/Liter
  • GR – Gram
  • GS – Gross
  • H4 – Hectoliter
  • HF – Hundred Feet
  • HR – Hours
  • IN – Inch
  • K6 – Kiloliters
  • KG – Kilogram
  • KT – Kit
  • LB – US Pound
  • LF – Linear Foot
  • LO – Lot (unit of procurement)
  • LT – Liter
  • LY – Linear Yard
  • MC – Microgram
  • ME – Milligram
  • ML – Milliliter
  • MM – Millimeter
  • MO – Months
  • MQ – Cubic millimeter
  • MR – Meter
  • OZ – Ounce
  • P1 – Percent
  • PC – Piece
  • PF – Pallet
  • PK – Pack (Only supported Outbound)
  • PK – Package
  • PR – Pair
  • PT – Pint
  • QT – Quart
  • RL – Roll
  • SC – Square Centimeter
  • SF – Square Foot
  • SH – Sheet
  • SI – Square Inch
  • SM – Square Meter
  • SP – Self Package
  • ST – Set
  • SY – Square Yard
  • SZ – Syringe
  • T3 – Thousand Pieces
  • TB – Tube
  • TH – Thousands
  • TN – Tonne
  • TS – Thousands
  • TY – Tray
  • U2 – Tablet
  • UM – Million
  • UN – Unit
  • US – Dosage Form
  • V2 – Pouch
  • VI – Vial
  • WK – Week
  • YD – Yard
  • YR – Years
 UN
        M7 0…5 – Equipment seal numbers, organization. –
          M701 1…1 2/15 Required. Seal number given for equipment. 3212312
          M702 0…1 2/3

Seal number applied entity, it could be an organization or location or an individual.

Valid values:

  • CA – Carrier

  • SH – Shipper

  • CM – Customs

  • T6 – Terminal operator

 CA
        W09 0…1 – Equipment type wise temperature details –
          W0901 1…1 2/2

Required. Type of equipment used in delivery.

Valid values:

  • AP – Aircraft

  • CN – Container

  • RR – Railcar

  • TL – Trailer

  • VT – Ship

  • TO – Truck

 CN
          W0902 0…1 1/4 Minimum allowable temperature condition for shipment, based on the scale given on W0903. -12
          W0903 0…1 2/2

Temperature scale.

Valid values:

  • CE – Celsius

  • FA – Fahrenheit

 CE
          W0904 0…1 1/4 Maximum allowable temperature condition for shipment, based on the scale given on W0903. 1
          W0906 0…1 1/60 Free form information. –
          W0907 0…1 1/1

Air vent setting on ocean type containers.

Valid values:

  • A – Open25percent
  • B – Open50percent
  • C – Open75percent
  • D – Open100percent
  • F – Open10percent
  • E – Closed
  • Z – Carrier set
 A
          W0908 0…1 1/3 Humidity percent. For example: 50% required, value is 50. 15
      L0 0…120   Arrival notice line item details, like quantity, measurements, packing details. If L0 loop present, at least one iteration of L0 segment is required.  
        L001 0…1 1/6 Line item number. 1
        L002 0…1 1/11 Billed quantity for the shipment, max 8 digits, included up to 5 decimal places. If either L0-02 or L0-03 is present, then the other is required. –
        L003 0…1 2/2

Billed quantity type, basis for rating.

  • BA – Barrels
  • BX – Box
  • EA – Identifies a billable unit as a single item.
  • KG – Metric weight unit used in international shipping.
  • LR – Liter
  • TN – Billing unit expressed as short tons (2,000 lbs).
  • CF – Volume unit used for dimensional rating.
  • MT – Often used in ocean freight, usually equals 1 cubic meter or 1,000 kg.
  • VA – Actual volume of the cargo.
  • VC – Volume used for billing after dimensional adjustments.
  • PK – Common billing unit for boxed or grouped goods.
  • TD – Billing unit based on number of days.
  • TH – Billing unit based on number of hours.
  • SP – Number of stops authorized as part of a shipment.
  • EA – Identifies a billable unit as a single item.
  • LB – Common weight unit in ocean freight billing.
  • NR – A standard shipping container unit.
  • NU – Generic unit of measure for shipment rating.
 EA
        L004 0…1 1/10 Item weight value , max 10 digits, included up to 5 decimal places. If either L0-04 or L0-05 is present, then the other is required 10
        L005 0…1 1/2

Item weight qualifier.

  • A5 - Average weight

  • A4 - Average weight per load

  • B - Billed weight

  • CE - Certified weight of cargo

  • A - Consolidated weight

  • F - Deficit weight

  • E - Estimated net weight

  • O - Excess weight over maximum

  • FR - Freight weight

  • G - Gross weight

  • L - Legal weight

  • LC - Maximum lading capacity

  • M - Minimum weight for rate

  • N - Actual net weight

  • ND - Non-chargeable dunnage

  • V - Non transit weight - transit bills only

  • PA - Pallet weight

  • U - Weight per unit

  • A3 - Shipper's weight

  • SK - Skid weight

  • T - Tare weight

  • W - Transit weight - transit bills only

  • SO - Storage in transit out

 B
        L006 0…1 1/8 Item volume value , max 8 digits, included up to 5 decimal places. If either L0-06 or L0-07 is present, then the other is required 100
        L007 0…1 1/1

Item volume unit type.

  • B – Volume of barge
  • T – Volume of container
  • C – Cubic centimeters
  • M – Cubic decimeters
  • E – Cubic feet
  • N – Cubic inches
  • X – Cubic meters
  • G – Gallons
  • V – Liter
  • L – Total volume of load
 B
        L008 0…1 1/7 Number of handling units of the line item tendered to carrier. 10
        L009 0…1 3/3

Packing form of lading quantity

  • PLL – 463L Air Pallet
  • BAG - Bag
  • BAL - Bale
  • BRG - Barge
  • BBL - Barrel
  • BSK - Basket or hamper
  • BEM - Beam
  • BIN - Bin
  • BOB - Bobbin
  • BOT - A bottle
  • BOX - Box
  • BXI - Box, with inner container
  • BXT - Bucket
  • BLK - Bulk
  • BKG - Large fabric bulk container that takes the shape of whever is inside it.
  • BDL - Bundle
  • CAB – Cabinet
  • CAG – Cage
  • CAN – Can
  • CCS – Can Case
  • CBC – Containers of Bulk Cargo
  • CAR – Carrier
  • CTN – Carton
  • CAS – Case
  • CSK – Cask
  • CHS – Chest
  • COL – Coil
  • CND – Container, Commercial Highway Lift
  • CNT – Container
  • CRD – Cradle
  • CRT – Crate
  • CUB – A cube
  • CYL – Cylinder
  • CNX – 8x8x8-foot container for packaging and shipping military material
  • CNF – Multiwall Container Secured to Warehouse Pallet
  • CNE –Engine Container
  • CNA – Household Goods Containers, Wood
  • CLD – Car Load, Rail
  • DBK – Dry Bulk
  • DRK – Double-length Rack
  • DRM – Drum container.
  • DSK - Double-length Skid
  • DTB – Double-length Tote Bin
  • DUF – Duffle Bag
  • ENV – Envelope
  • FLX – A rubber liner used in a standard container for liquid material
  • FRM – Frame
  • FSK – Flask
  • FWR – Forward Reel
  • HPR – Hamper
  • HPT – Hopper Truck
  • HRB - On Hanger or Rack in Boxes
  • HRK – Half-standard Rack
  • HTB – Half-Standard Tote Bin
  • JAR – Jar
  • JUG – JugA bottle (usually 1/2 gallon or larger) fitted with a handle
  • KEG – Keg
  • KIT – Kit
  • KRK – Knockdown Rack
  • KTB – Knockdown Tote Bin
  • LBK – Liquid Bulk
  • LIF – Lifts
  • LOG – Log
  • LSE – Loose
  • LUG – Lug
  • LVN – Lift Van
  • MLV – 20-foot transportation van that conforms to ISO standards
  • MRP – Multi-Roll Pack
  • MXD - Mixed Type Pack
  • OVW – Over wrap - A cardboard wrapping around a pallet.
  • PCS – Pieces
  • PIR – Pims
  • PKG – Package
  • PLF – Platform
  • PLL – 463L Air Pallet
  • PLN – Pipeline
  • PLT – Pallet
  • PRK – Pipe Rack
  • RCK - Rack
  • REL – Reel
  • ROL – Roll
  • RVR – Reverse Reel
  • SAK – Sack
  • SBC – A plastic liner in a container to protect dry free-flowing material during transport.
  • SHT –Sheet
  • SKD – Skid
  • SLP – Cardboard platforms that hold product for storage or transportation
  • SLV – Sleeve
  • SPI – Spin Cylinders
  • SPL – Spool
  • SVN – 40-foot container that conforms to ISO standards for sea transport
  • TBE – Tube
  • TBN – Tote Bin
  • TKR – Tank Car
  • TKT – Tank Truck
  • TLD - Intermodal Trailer/Container Load (Rail)
  • TNK – Tank
  • TRC – Tierce
  • TRI – Box made from three-ply cardboard
  • TRK – Trunk and Chest
  • TRU –Truck
  • TRY – Tray
  • TSS – Trunk, Salesmen Sample
  • TTC – Tote Can. A reusable stainless steel container with handles; used for liquid material
  • TUB – Tub
  • UNP – Unpacked
  • UNT – Unit
  • VEH – Vehicles
  • VPK – Van Pack
  • WHE – On Own Wheel
  • WLC – Wheeled Carrier
  • WRP – Wrapped
 CNT
        L010 0…1 2/35 Descriptive information of materials used for protection of lading goods Rubber
        L011 0…1 1/1

Weight unit type code.

Valid values:

  • E – Metric ton
  • G – Grams
  • K – Kilograms
  • L – Pounds
  • M– Measurement ton
  • O – Ounces
  • S – Short ton
  • T – Long ton
 E
        L012 0…1 2/2

Type of service providing for charging / rating purpose.

  • CFR – Rate of shipments for barge-to-barge carrier terminal service
  • CIF – Rate of shipments for barge-to-door service
  • CIP – Rate of shipments for barge-to-motor service
  • CPT – Rate of shipments for barge-to-rail service
  • DAP – Rate of shipments for barge-to-ocean terminal service
  • DAT – Rate of shipments for freight station to freight station service
  • DDP – Rate of shipments for freight station to door service
  • EXW – Buyer bears all costs and risks in taking the goods from the seller's premises to the desired location
  • FAS – Buyer bears all costs and risks, after goods are placed on vessel
  • FCA – Free carrier for buyer, because shipment costs are taken care by seller
  • FOB – Free on board, costs and risks are owned by seller
 RE
        L013 0…1 1/15 Represent the total number of boxes, cartons, or pieces contained on a pallet, skid, or slip sheet for the line item., this only be used if L009 is PLT or SKD or SLP. 10
        L014 0…1 3/3

Packing form of lading quantity that should be verified.

Valid values:

  • PLT – Pallet

  • SKD – Skid

  • SLP – Slip

 PLT
        L015 0…1 1/1

Boolean indicates carrier required to verify number of units contained on a pallet, slip sheet, skid.

Valid values:

  • Y – true, carrier needs to verify

  • N – false, carrier does not need to verify.

 Y
      L5 0…1 – Lading items packaging, description details. –
        L501 0…1 1/6 Lading item number. –
        L502 0…1 1/50 Lading item description. –
        L503 0…1 1/30 Commodity code, describes commodity or group of commodities. If either L5-03 or L5-04 is present, then the other is required. –
        L504 0…1 1/1

Commodity coding system used for commodity.

Valid values:

  • 2 – Dun's SIC 2+2, Dun & Bradstreet
  • 5 – National Drug Code
  • C – Canadian Freight
  • N – Motor Freight Classification
  • P – Bulk Codes
  • Q – Quota Category
  • S – Standard International Trade Classification
  • T – Standard Transportation Commodity Code
  • Z – Mutually defined
 5
        L505 0…1 3/5

Packaging material used for inner level packing.

  • CAS – Case
  • CTN – Carton
  • PLT – Pallet
  • RCK – Rack
  • UNT – Unit
  • BAG - Bag
  • BAL - Bale
  • BBL - Barrel
  • BGD – Banding to bind/tie package to secure it
  • BDL – Bundle
  • BLS – Blister packaging between dome and carrier
  • BOT – Bottle
  • CAN – Can
  • DRM –Drum
  • ENV – Envelope
  • FSK – Flask
  • JAR – Jar
  • JUG – Jug
  • KEG – Keg
  • MUL – Multipack - consumer bundle
  • ROL – Roll
  • SAH – Sachet
  • SAK – Sack
  • SPI – Spin Cylinders
  • SPL – Spool
  • TBE – Tube
  • TBN – Tote Bin
  • TRY – Tray
  • TUB – Tub
  • VIL – Vial
  • WRP – Wrapped
 CAS
      L1 0…20 – Lading items rates and charges at line level, if L1 loop present then at least one L1 segment is required. –
        L101 0…1 1/6 Lading item number. –
        L102 0…1 1/15 Rate for commodity in shipment, max 15 digits, included up to 5 decimal places. If either L1-02 or L1-03 is present, then the other is required. –
        L103 0…1 2/2

Charge rate type.

  • 150 –Canadian Currency Exchange.
  • 170 – Certificate Origin.
  • 295 – Special Discount.
  • 360 – Export Customs Clearance.
  • 405 – Fuel Surcharge Destination.
  • 495 – Miscellaneous - Destination
  • 585 – Document Origin.
  • 730 – Terminal Service Fee.
  • 750 – Value Added tax.
  • AAT – Handling Charge Tax.
  • AMS –Automated Manifest System.
  • ARB – Arbitrary (In Addition to Through Rates and Charges).
  • BAS – Base charge.
  • BLC – Bill of Lading Charge.
  • BRD – Bridge Charge (PEI Confederation).
  • BSC – Bunker Surcharge.
  • BUA – Bunker Adjustment.
  • CAC – Cash discount .
  • CBX – City sales tax.
  • CHG – Forward / Advance Charges.
  • CLN – Cleaning Charges.
  • COF – Container freight charges.
  • CON – Congestion Surcharge.
  • CSE – Customs Entry.
  • CTF – Chassis Destination.
  • CUF – Currency Adjustment Factor.
  • CUS – Customs Charge.
  • DDF – Destination Document.
  • DEL – Delivery Charge.
  • DIV – Diversion and Re-consignment.
  • DRC – Drayage Base-origin.
  • DSC – Discount.
  • DTC – Destination Charge.
  • EMS – Emergency Surcharge.
  • ENS – Energy Surcharge (Fuel Adjustment Factor).
  • EPC – Emergency Port Charge.
  • EXP – Expedited Service Charge.
  • FLT – Ferry Service.
  • GSS – Greater Security Service.
  • GST –Goods and Services Tax Charge.
  • HAZ – Hazardous Cargo Charge.
  • HDF – Heavy Duty Flat Car Charge.
  • HET – Heat in Transit Charges.
  • HHB – Handling Origin.
  • HST – Harmonized Sales Tax.
  • IIA – Invoice Adjustment.
  • LDG – Loading.
  • LLS – "Local Sales Tax (All Applicable Sales Taxes by Taxing Authorities Below the State Level)
  • MMT – Metropolitan Transit Tax.
  • NBH – N.H. D Wharfage.
  • ODF – Collect on Delivery Deletion Charge.
  • PAD – Premium Charge.
  • PBL – Pier Charges Other Than Wharfage.
  • PUD – Pick-Up and Delivery.
  • PPT – Parish/County Sales Tax (only).
  • REF – Refrigeration.
  • SAJ – Surcharge - Dollar Value.
  • SEC – Equipment Origin.
  • SEG – Segregating (Sorting).
  • SOC – Stop-Off Charge.
  • SST – Sales Tax (State and Local).
  • SSX – Sales and Use Tax (State and Local).
  • STC – State Surcharge.
  • STF – Container stuffing.
  • STR – Storage in Transit.
  • SWC – Switching Charge.
  • TAD – Transportation tax.
  • TER – Terminal Charge.
  • TRF – Transfer fees.
  • TTL – Local Tax.
  • TTS – State Tax.
  • TTM – Tax on Miscellaneous Charges.
  • URC –Transload fees.
  • USF – Special Type Flat Car.
  • UUT – Use Tax.
  • WTV – VGM Free Origin.
  • ZZZ – Mutually Defined.
  • TAD – Carbon Tax – BC (Also available as default for all Carbon Tax).
  • ENC – Carbon Tax – Alberta (Specific to CN).
  • CSK – Carbon Tax – Saskatchewan (Specific to CN).
  • CMB –Carbon Tax – Manitoba (Specific to CN).
  • CQQ – Carbon Tax – Quebec (Specific to CN).
  • CNB – Carbon Tact – New Brunswick (Specific to CN).
  • CNS – Carbon Tax – Nova Scotia (Specific to CN).
 PF
        L104 0…1 1/15 Total charges for invoice. At least one of L1-04, L1-05 or L1-06 is required. 500
        L105 0…1 1/9 Advances payment for incidental charges occurring during transportation. 500
        L106 0…1 1/9 Prepaid amount paid by shipper at origin point. 2000
        L108 0…1 3/3

Special charge or allowance code.

Valid values:

  • DSC – Discount

  • 295 – Special discount

 DSC
        L109 0…1 1/3

Identifies specific & designated class of goods.

Valid values:

  • CTR – CONTRACT
  • E – EXCESS WEIGHT
  • M – MINIMUM
  • QUO – QUOTED
  • T – SENDER
  • X – CONTAINER
  • Y – EXCEPTION
 CTR
        L110 0…1 1/1

Charge entitle party, party who pays the bill.

Valid values:

  • S – Shipper

  • C – Consignee

  • I – Issuing carrier

  • D – Destination carrier

 S
        L111 0…1 1/1

Payment method for freight invoice charges.

Valid values:

  • A – Prepaid cash

  • B – Prepaid credit

  • C – Collect cash

  • D – Collect credit

  • P – Prepaid

 A
        L112 0…1 2/35 Special charge description. –
        L117 0…1 1/11 Billed quantity for the shipment, max 8 digits, included up to 5 decimal places. If either L0-02 or L0-03 is present, then the other is required. –
        L118 0…1 2/2

Billed quantity type, basis for rating.

  • BA – Barrels
  • BX – Box
  • EA – Identifies a billable unit as a single item.
  • KG – Metric weight unit used in international shipping.
  • LR – Liter
  • TN – Billing unit expressed as short tons (2,000 lbs).
  • CF – Volume unit used for dimensional rating.
  • MT – Often used in ocean freight, usually equals 1 cubic meter or 1,000 kg.
  • VA – Actual volume of the cargo.
  • VC – Volume used for billing after dimensional adjustments.
  • PK – Common billing unit for boxed or grouped goods.
  • TD – Billing unit based on number of days.
  • TH – Billing unit based on number of hours.
  • SP – Number of stops authorized as part of a shipment.
  • EA – Identifies a billable unit as a single item.
  • LB – Common weight unit in ocean freight billing.
  • NR – A standard shipping container unit.
  • NU – Generic unit of measure for shipment rating.
 DK
        L119 0…1 1/10 Rate percentage(e.g., 0.0 through 1.0 represents 0% through 100%). 0.1
        L120 0…1 3/3 Billed currency code info for charges. EUR
    V9 0…10 – Shipment event details. –
      V901 1…1 3/3

Required. Shipment event code.

  • ALV – Cargo has been loaded onto the vessel.
  • ARR – Shipment has arrived at the final destination.
  • APU – Expected date and time for pickup.
  • ARD – Actual date and time of arrival at the final destination.
  • ETA – Estimated time of arrival at the destination.
  • EAD – Estimated date of arrival at the destination.
  • ERD – Estimated date of arrival at the final destination.
  • VAR – Vessel has arrived at port.
  • VDP – Vessel has departed from port.
  • UFV – Cargo has been unloaded from the vessel.
  • CTD – Customs paperwork has been submitted.
  • CLR – Shipment has cleared customs.
  • ICD – Container dispatched from an inland location.
  • RCV – Cargo has been received at the port or terminal.
  • GIT – Shipment is currently en route to destination.
  • HLD – Shipment is currently on hold.
  • DOC – All shipment documentation is completed.
  • CUS – Shipment is currently at customs.
  • ARI – Shipment arrived at intermediate location
  • ZZZ – Custom event code
 APU
      V902 0…1 1/25 shipment Event descriptive information. Vessel arrived
      V903 0…1 8/8 Shipment event time stamp in YYYYMMDD format. 20070609
      V905 0…1 2/30 Event occurred city name. Texas
      V906 0…1 2/2 Event occurred state or province code. TX
      V907 0…1 2/3 Event occurred country code. UK
      V908 0…1 3/3

Reason indicating why a shipment status code was transmitted.

  • 029 –Transfer of ownership is pending.
  • 049 – The merchandise was damaged or destroyed.
  • 052 – Import container delay
  • A01 – An unsuccessful attempt has been made to deliver the shipment
  • A03 – The address for the shipment is incorrect.
  • A04 – Indirect Delivery
  • A05 – The transportation carrier cannot find the customer location
  • A06 – The address for the shipment is incorrect or an additional address is required before the delivery can be completed.
  • A07 – Shipment refused by consignee or delivery party.
  • A09 – Goods damaged delivery has been completed
  • A10 – Goods damaged delivery has not been completed
  • A11 – The shipment could not be delivered because the business was closed.
  • A12 – Delay caused by carrier sorting the shipment incorrectly.
  • A13 – Other undefined reason
  • A14 – Returned to shipper
  • A15 – Business on strike. The action was frustrated by an industrial dispute.
  • A17 – Delay in delivery due to a customer or consignee's request.
  • A18 – Missort
  • A19 – Restricted articles are incompatible
  • A20 – Restricted articles are unacceptable
  • A24 – Delay in the shipment because of an accident.
  • A26 – An unspecified delay caused by consignee
  • A27 – The driver returned the shipment to the terminal
  • A29 – Hold changed to delivery package
  • A30 – A mechanical breakdown in the means of transport or equipment that were moving the goods.
  • A31 – Arrived in station after courier dispatch
  • A33 – Delivery delay caused by a non-specified carrier related reason.
  • A34 – Package shipped from overgoods
  • A36 – Holding in overgoods
  • A37 – Damaged rewrapped In hub
  • A39 – The customer previous to this stop caused a delay
  • A40 – Unspecified delay caused by shipper.
  • A42 – Delivery party facilities closed for holiday.
  • A43 – Shipment is delayed by severe weather or natural disasters.
  • A45 – Delivery not completed
  • A46 – Recipient Unavailable -- Delivery Delayed. No information available concerning the responsible at the delivery address.
  • A49 – Out of Delivery Area (ODA) cartage agent
  • A50 – Improper international paperwork
  • A55 – The shipment is on hold or has not been refused because customs and/or documentation issues.
  • A59 – Further instructions are required. Hold at location.
  • A65 – Customs release
  • A95 – Past cutoff time. Delivery of the goods/consignments/equipment has been scheduled past or later than the cut-off time.
  • A96 – Insufficient pickup time
  • B01 – Anticipated delay caused by contractor
  • B08 – Shipment is on hold pending contract unloading facility or equipment
  • B14 – Shipment is being held because of missing documents. Complete and correct documentation is required.
  • B15 – Shipment is being held pending clearance at a border point.
  • D01 – The shipment has been delayed for delivery because of a carrier dispatch error.
  • D50 – Further action on the delivery is delayed or postponed.
  • P02 – Relevant authorities have ordered the goods/consisgnments/equipment be held for inspection.
  • T07 – Insufficient delivery time at the delivery location prevented the carrier from completing delivery of the goods.
  • THT – A consignment or goods have been stolen.
  • W15 – Wrong equipment
 A03
      V913 0…1 2/2 Time zone code. CT
    L3 1…1 – Required. Total shipment in terms of weight, volume, rates, charges, advances, and prepaid amounts applicable to one or more line items. –
      L301 0…1 1/10 total weight value , max 10 digits, included up to 5 decimal places. if either L3-01 or L3-02 is present, then the other is required. 1000
      L302 0…1 1/2

Item weight qualifier.

  • A5 - Average weight

  • A4 - Average weight per load

  • B - Billed weight

  • CE - Certified weight of cargo

  • A - Consolidated weight

  • F - Deficit weight

  • E - Estimated net weight

  • O - Excess weight over maximum

  • FR - Freight weight

  • G - Gross weight

  • L - Legal weight

  • LC - Maximum lading capacity

  • M - Minimum weight for rate

  • N - Actual net weight

  • ND - Non-chargeable dunnage

  • V - Non transit weight - transit bills only

  • PA - Pallet weight

  • U - Weight per unit

  • A3 - Shipper's weight

  • SK - Skid weight

  • T - Tare weight

  • W - Transit weight - transit bills only

  • SO - Storage in transit out

 G
      L303 0…1 1/15 Total rate for commodities in shipment, max 15 digits, included up to 5 decimal places. If either L3-03 or L3-04 is present, then the other is required. 12345.234
      L304 0…1 2/2

Charge rate type.

  • BL – Bill of Lading declared value (ocean cargo valuation)
  • CW – Per hundredweight (transportation rate per 100 lbs)
  • PF – Per cubic foot (volume-based rating)
  • PG – Per gallon (liquid shipments, marine/ocean bulk)
  • PH – Per hundred (of basic unit, flat hundred)
  • PM – Per mile (road, drayage, intermodal transport)
  • PW – Percentage of total charges (common in invoices)
  • SP – Per stop (accessorial charge qualifier)
  • FR – Flat rate (fixed dollar amount)
  • FC – Flat charge (similar to flat rate)
  • AV – Ad valorem (percent of cargo value, common in maritime)
  • PU – Per unit
  • PC – Per car
  • CR – Charges based on mentioned percentage
  • MN – Minimum charge
  • LB – Per pound
  • CM – Per cubic meter
  • ER – Per each request
  • GT – Per gross ton
  • PA – Per container
  • PD – Per day
  • PR – Per hour
  • PS – Per shipment
  • PZ – Per package charge
  • WM – Weight or Measurement
 PF
      L305 0…1 1/15 Total weight charges for invoice. 500
      L306 0…1 1/9 Total advances payment for incidental charges occurring during transportation. 500
      L307 0…1 1/9 Total prepaid amount paid by shipper at origin point. 2000
      L308 0…1 3/3

Special charge or allowance code.

  • 150 –Canadian Currency Exchange.
  • 170 – Certificate Origin.
  • 295 – Special Discount.
  • 360 – Export Customs Clearance.
  • 405 – Fuel Surcharge Destination.
  • 495 – Miscellaneous - Destination
  • 585 – Document Origin.
  • 730 – Terminal Service Fee.
  • 750 – Value Added tax.
  • AAT – Handling Charge Tax.
  • AMS –Automated Manifest System.
  • ARB – Arbitrary (In Addition to Through Rates and Charges).
  • BAS – Base charge.
  • BLC – Bill of Lading Charge.
  • BRD – Bridge Charge (PEI Confederation).
  • BSC – Bunker Surcharge.
  • BUA – Bunker Adjustment.
  • CAC – Cash discount .
  • CBX – City sales tax.
  • CHG – Forward / Advance Charges.
  • CLN – Cleaning Charges.
  • COF – Container freight charges.
  • CON – Congestion Surcharge.
  • CSE – Customs Entry.
  • CTF – Chassis Destination.
  • CUF – Currency Adjustment Factor.
  • CUS – Customs Charge.
  • DDF – Destination Document.
  • DEL – Delivery Charge.
  • DIV – Diversion and Re-consignment.
  • DRC – Drayage Base-origin.
  • DSC – Discount.
  • DTC – Destination Charge.
  • EMS – Emergency Surcharge.
  • ENS – Energy Surcharge (Fuel Adjustment Factor).
  • EPC – Emergency Port Charge.
  • EXP – Expedited Service Charge.
  • FLT – Ferry Service.
  • GSS – Greater Security Service.
  • GST –Goods and Services Tax Charge.
  • HAZ – Hazardous Cargo Charge.
  • HDF – Heavy Duty Flat Car Charge.
  • HET – Heat in Transit Charges.
  • HHB – Handling Origin.
  • HST – Harmonized Sales Tax.
  • IIA – Invoice Adjustment.
  • LDG – Loading.
  • LLS – "Local Sales Tax (All Applicable Sales Taxes by Taxing Authorities Below the State Level)
  • MMT – Metropolitan Transit Tax.
  • NBH – N.H. D Wharfage.
  • ODF – Collect on Delivery Deletion Charge.
  • PAD – Premium Charge.
  • PBL – Pier Charges Other Than Wharfage.
  • PUD – Pick-Up and Delivery.
  • PPT – Parish/County Sales Tax (only).
  • REF – Refrigeration.
  • SAJ – Surcharge - Dollar Value.
  • SEC – Equipment Origin.
  • SEG – Segregating (Sorting).
  • SOC – Stop-Off Charge.
  • SST – Sales Tax (State and Local).
  • SSX – Sales and Use Tax (State and Local).
  • STC – State Surcharge.
  • STF – Container stuffing.
  • STR – Storage in Transit.
  • SWC – Switching Charge.
  • TAD – Transportation tax.
  • TER – Terminal Charge.
  • TRF – Transfer fees.
  • TTL – Local Tax.
  • TTS – State Tax.
  • TTM – Tax on Miscellaneous Charges.
  • URC –Transload fees.
  • USF – Special Type Flat Car.
  • UUT – Use Tax.
  • WTV – VGM Free Origin.
  • ZZZ – Mutually Defined.
  • TAD – Carbon Tax – BC (Also available as default for all Carbon Tax).
  • ENC – Carbon Tax – Alberta (Specific to CN).
  • CSK – Carbon Tax – Saskatchewan (Specific to CN).
  • CMB –Carbon Tax – Manitoba (Specific to CN).
  • CQQ – Carbon Tax – Quebec (Specific to CN).
  • CNB – Carbon Tact – New Brunswick (Specific to CN).
  • CNS – Carbon Tax – Nova Scotia (Specific to CN).
 DSC
      L309 0…1 1/8 Total shipment volume value , max 8 digits, included up to 5 decimal places. If either L3-09 or L3-10 is present, then the other is required. 100
      L310 0…1 1/1

Total shipment volume unit type.

  • B – Volume of barge
  • T – Volume of container
  • C – Cubic centimeters
  • M – Cubic decimeters
  • E – Cubic feet
  • N – Cubic inches
  • X – Cubic meters
  • G – Gallons
  • V – Liter
  • L – Total volume of load
 B
      L311 0…1 1/7 Quantity units total tendered to carrier. 1011
      L312 0…1 1/1

Weight unit type code.

Valid values:

  • E – Metric ton
  • G – Grams
  • K – Kilograms
  • L – Pounds
  • M– Measurement ton
  • O – Ounces
  • S – Short ton
  • T – Long ton
 E
      L313 0…1 1/7 Specify the tariff number under which the rate(s) or charges are applied to a shipment. H123
    L1 0…20 – Lading items rates and charges at header or summary level. –
      L101 0…1 1/6 Lading item number. –
      L102 0…1 1/8 Rate for commodity in shipment, max 8 digits, included up to 5 decimal places. –
      L103 0…1 2/2

Charge rate type.

  • BL – Bill of Lading declared value (ocean cargo valuation)
  • CW – Per hundredweight (transportation rate per 100 lbs)
  • PF – Per cubic foot (volume-based rating)
  • PG – Per gallon (liquid shipments, marine/ocean bulk)
  • PH – Per hundred (of basic unit, flat hundred)
  • PM – Per mile (road, drayage, intermodal transport)
  • PW – Percentage of total charges (common in invoices)
  • SP – Per stop (accessorial charge qualifier)
  • FR – Flat rate (fixed dollar amount)
  • FC – Flat charge (similar to flat rate)
  • AV – Ad valorem (percent of cargo value, common in maritime)
  • PU – Per unit
  • PC – Per car
  • CR – Charges based on mentioned percentage
  • MN – Minimum charge
  • LB – Per pound
  • CM – Per cubic meter
  • ER – Per each request
  • GT – Per gross ton
  • PA – Per container
  • PD – Per day
  • PR – Per hour
  • PS – Per shipment
  • PZ – Per package charge
  • WM – Weight or Measurement
 PF
      L104 0…1 1/15 Total charges for invoice. 500
      L105 0…1 1/9 Advances payment for incidental charges occurring during transportation. 500
      L106 0…1 1/9 Prepaid amount paid by shipper at origin point. 2000
      L108 0…1 3/3

Special charge or allowance code.

  • 150 –Canadian Currency Exchange.
  • 170 – Certificate Origin.
  • 295 – Special Discount.
  • 360 – Export Customs Clearance.
  • 405 – Fuel Surcharge Destination.
  • 495 – Miscellaneous - Destination
  • 585 – Document Origin.
  • 730 – Terminal Service Fee.
  • 750 – Value Added tax.
  • AAT – Handling Charge Tax.
  • AMS –Automated Manifest System.
  • ARB – Arbitrary (In Addition to Through Rates and Charges).
  • BAS – Base charge.
  • BLC – Bill of Lading Charge.
  • BRD – Bridge Charge (PEI Confederation).
  • BSC – Bunker Surcharge.
  • BUA – Bunker Adjustment.
  • CAC – Cash discount .
  • CBX – City sales tax.
  • CHG – Forward / Advance Charges.
  • CLN – Cleaning Charges.
  • COF – Container freight charges.
  • CON – Congestion Surcharge.
  • CSE – Customs Entry.
  • CTF – Chassis Destination.
  • CUF – Currency Adjustment Factor.
  • CUS – Customs Charge.
  • DDF – Destination Document.
  • DEL – Delivery Charge.
  • DIV – Diversion and Re-consignment.
  • DRC – Drayage Base-origin.
  • DSC – Discount.
  • DTC – Destination Charge.
  • EMS – Emergency Surcharge.
  • ENS – Energy Surcharge (Fuel Adjustment Factor).
  • EPC – Emergency Port Charge.
  • EXP – Expedited Service Charge.
  • FLT – Ferry Service.
  • GSS – Greater Security Service.
  • GST –Goods and Services Tax Charge.
  • HAZ – Hazardous Cargo Charge.
  • HDF – Heavy Duty Flat Car Charge.
  • HET – Heat in Transit Charges.
  • HHB – Handling Origin.
  • HST – Harmonized Sales Tax.
  • IIA – Invoice Adjustment.
  • LDG – Loading.
  • LLS – "Local Sales Tax (All Applicable Sales Taxes by Taxing Authorities Below the State Level)
  • MMT – Metropolitan Transit Tax.
  • NBH – N.H. D Wharfage.
  • ODF – Collect on Delivery Deletion Charge.
  • PAD – Premium Charge.
  • PBL – Pier Charges Other Than Wharfage.
  • PUD – Pick-Up and Delivery.
  • PPT – Parish/County Sales Tax (only).
  • REF – Refrigeration.
  • SAJ – Surcharge - Dollar Value.
  • SEC – Equipment Origin.
  • SEG – Segregating (Sorting).
  • SOC – Stop-Off Charge.
  • SST – Sales Tax (State and Local).
  • SSX – Sales and Use Tax (State and Local).
  • STC – State Surcharge.
  • STF – Container stuffing.
  • STR – Storage in Transit.
  • SWC – Switching Charge.
  • TAD – Transportation tax.
  • TER – Terminal Charge.
  • TRF – Transfer fees.
  • TTL – Local Tax.
  • TTS – State Tax.
  • TTM – Tax on Miscellaneous Charges.
  • URC –Transload fees.
  • USF – Special Type Flat Car.
  • UUT – Use Tax.
  • WTV – VGM Free Origin.
  • ZZZ – Mutually Defined.
  • TAD – Carbon Tax – BC (Also available as default for all Carbon Tax).
  • ENC – Carbon Tax – Alberta (Specific to CN).
  • CSK – Carbon Tax – Saskatchewan (Specific to CN).
  • CMB –Carbon Tax – Manitoba (Specific to CN).
  • CQQ – Carbon Tax – Quebec (Specific to CN).
  • CNB – Carbon Tact – New Brunswick (Specific to CN).
  • CNS – Carbon Tax – Nova Scotia (Specific to CN).
 DSC
      L109 0…1 1/3

Identifies specific & designated class of goods.

Valid values:

  • CTR – CONTRACT
  • E – EXCESS WEIGHT
  • M – MINIMUM
  • QUO – QUOTED
  • T – SENDER
  • X – CONTAINER
  • Y – EXCEPTION
 CTR
      L110 0…1 1/1

Charge entitle party, party who pays the bill.

Valid values:

  • S – Shipper

  • C – Consignee

  • I – Issuing carrier

  • D – Destination carrier

 S
      L111 0…1 1/1

Payment method for freight invoice charges. Valid values:

  • A – Prepaid cash

  • B – Prepaid credit

  • C – Collect cash

  • D – Collect credit

  • E – Collect

  • P – Prepaid

 A
      L112 0…1 2/35 Special charge description. –
      L117 0…1 1/11 Billed quantity for the shipment, max 8 digits, included up to 5 decimal places. –
      L118 0…1 2/2

Billed quantity type, basis for rating.

  • BA – Barrels
  • BX – Box
  • EA – Identifies a billable unit as a single item.
  • KG – Metric weight unit used in international shipping.
  • LR – Liter
  • TN – Billing unit expressed as short tons (2,000 lbs).
  • CF – Volume unit used for dimensional rating.
  • MT – Often used in ocean freight, usually equals 1 cubic meter or 1,000 kg.
  • VA – Actual volume of the cargo.
  • VC – Volume used for billing after dimensional adjustments.
  • PK – Common billing unit for boxed or grouped goods.
  • TD – Billing unit based on number of days.
  • TH – Billing unit based on number of hours.
  • SP – Number of stops authorized as part of a shipment.
  • EA – Identifies a billable unit as a single item.
  • LB – Common weight unit in ocean freight billing.
  • NR – A standard shipping container unit.
  • NU – Generic unit of measure for shipment rating.
 DK
      L119 0…1 1/10 Rate percentage(e.g., 0.0 through 1.0 represents 0% through 100%). 0.1
      L120 0…1 3/3 Billed currency code info for charges. EUR
    K1 0…999 – Remarks or some other comments. –
      K101 0…1 1/30 Free form information. –
      K102 0…1 1/30 Free form information. –
  SE 1…1 – Required. ST … SE transaction set trailer envelope. Child of GS group. Only one ST transaction expected. –
    SE01 1…1 1/10 Required. Total count of segments in ST … SE transaction set including ST and SE segments. 10
    SE02 1…1 4/9 Required. Transaction set control number. 0001
  GE 1…1 – Required. GS … GE functional group trailer envelope. Child of ISA interchange. Only one GS group expected. –
    GE01 1…1 1/6 Required. Number of transaction sets in functional group. 5
    GE02 1…1 1/9 Required. Functional group control number. 619827
  IEA 1…1 – Required. ISA … IEA interchange control trailer envelope. Only one interchange expected per transmission. –
    IEA01 1…1 1/5 Required. Number of functional groups in interchange. 1
    IEA02 1…1 9/9 Required. Interchange control number. 0000000000619827 
ISA*00*ISA02ISA02*01*ISA04ISA04*07*7777776067344   
*01*888888404358877*250808*1141*^*00501*000619827*0*P*:  
GS*QO*2222224043588*TRACELINK*20250611*1420*619827*X*005010  
ST*312*0001  
B3*2*12321*SH13212*CA**20070609*1000*AD*20250730*035*SC01**BB*CPT  
Q3*20250730*CC  
C3*USD*3311*s34*s35  
R2*SCAC*O*City1*R204204*05*J******RE*DESC1  
N9*FN*123456*1  
N9*IV*Invoice1  
N9*BM*123457  
N9*SI*123458  
V1*9399193*Flora*AD*12345*SC01*F*BC*B  
N1*N1*N1_BusName*1*3333331013655  
N3*N1_address1*N1_address2  
N4*N1_city*CA*N1_postcd*US  
N1*SH*SH_BusName*9*3333331013666  
N3*SH_address1*SH_address2  
N4*SH_city*CA*SH_postcd*US  
N1*CA*CA_BusName*11*3333331013677  
N3*CA_address1*CA_address2  
N4*CA_city*CA*CA_postcd*US  
N1*BT*BT_BusName*21*3333331013688  
N3*BT_address1*BT_address2  
N4*BT_city*BT*BT_postcd*US  
N1*CN*CN_BusName*91*3333331013699  
N3*CN_address1*CN_address2  
N4*CN_city*CN*CN_postcd*US  
N1*CI*CI_BusName*92*3333331013600  
N3*CI_address1*CI_address2  
N4*CI_city*CI*CI_postcd*US  
N1*FW*FW_BusName*UL*3333331013611  
N3*FW_address1*FW_address2  
N4*FW_FWty*FW*FW_postcd*US  
R4*O*CI*USLGB*USPort*US*Terminal1*pier*TX  
DTM*139*20250730*150858*CT  
DTM*140*20240628**LT  
H3*DA*DESC1*HDNC*VS*I  
L5*01*Item Desc*123H1*5*ENV  
LX*0001  
N7*SC*1234*10*B*200*76*7*100*B*L*CN*SCAC*713*14*1211*M*E*2*19*12.234*14.45  
QTY*39*25.00*UN  
M7*3212312*CA  
W09*CN*-12*CE*1*CE*descA*A*15  
L0*001*100*NR*10*B*100*B*10*CNT*Rubber*E*RE*10*BOX*Y  
L5*1*desc1*cc*2*TBE  
L1*1*10*BL*100*186*187*FSAC*DSC*M*I*C*scd*A*114*BL*F*193*DM*0.1*EUR  
V9*APU*Vessel Arrived*20250730*150858*Texas*TX*US*A06*****ND  
L3*1000*G*12345.234*WM*100*209*210*DSC*212*G*1011*O*H123  
L1*001*10*PF*500*500*2000*FSAC*DSC*CTR*S*A*descA*A*114*PF*L*228*DK*0.1*EUR  
K1*FREEtEXTNOTE_1  
SE*233*0001  
GE*235*619827  
IEA*237*000619827
Review TraceLink's API: Terms of Use

Table of contents