Cargo Smart
/
Shipping Instructions
  • Specification
  • EDI Inspector
Stedi maintains this guide based on public documentation from Cargo Smart. Contact Cargo Smart for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
Cargo Smart logo

X12 304 Shipping Instructions

X12 Release 4010

This Draft Standard for Trial Use provides the format and establishes the data contents of the Shipment Instructions Transaction Set (304) for use within the context of an Electronic Data Interchange (EDI) environment.

When this transaction set is transmitted to an ocean carrier, it provides all the information necessary to prepare and distribute a contract of carriage such as an ocean bill of lading, sea waybill, and other shipping documents. When this transaction set is transmitted to a freight forwarder or customs broker, it provides for the transmission of shipping and financial information required by the forwarder or customs broker to move cargo and provide the services requested.

Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI samples
  • None included
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/cargo-smart/shipping-instructions/01H5N50B7QTGGJ8S371HQ40T3A
Powered by
Build EDI implementation guides at stedi.com
Overview
ISA
-
Interchange Control Header
Max use 1
Required
GS
-
Functional Group Header
Max use 1
Required
heading
ST
010
Transaction Set Header
Max use 1
Required
B2
020
Beginning Segment for Shipment Information Transaction
Max use 1
Required
B2A
030
Set Purpose
Max use 1
Required
N9
080
Reference Identification
Max use 100
Optional
V1
090
Vessel Identification
Max use 2
Required
N1 Loop
R4 Loop
R2
220
Route Information
Max use 13
Optional
GE
-
Functional Group Trailer
Max use 1
Required
IEA
-
Interchange Control Trailer
Max use 1
Required
ISA

Interchange Control Header

RequiredMax use 1

To start and identify an interchange of zero or more functional groups and interchange-related control segments

Example
ISA-01
I01
Authorization Information Qualifier
Required
Identifier (ID)

Code to identify the type of information in the Authorization Information

00
No Authorization Information Present (No Meaningful Information in I02)
ISA-02
I02
Authorization Information
Required
String (AN)
Min 10Max 10

Information used for additional identification or authorization of the interchange sender or the data in the interchange; the type of information is set by the Authorization Information Qualifier (I01)

ISA-03
I03
Security Information Qualifier
Required
Identifier (ID)

Code to identify the type of information in the Security Information

00
No Security Information Present (No Meaningful Information in I04)
ISA-04
I04
Security Information
Required
String (AN)
Min 10Max 10

This is used for identifying the security information about the interchange sender or the data in the interchange; the type of information is set by the Security Information Qualifier (I03)

ISA-05
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-06
I06
Interchange Sender ID
Required
String (AN)
Min 15Max 15

Identification code published by the sender for other parties to use as the receiver ID to route data to them; the sender always codes this value in the sender ID element

ISA-07
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-08
I07
Interchange Receiver ID
Required
String (AN)
Min 15Max 15

Identification code published by the receiver of the data; When sending, it is used by the sender as their sending ID, thus other parties sending to them will use this as a receiving ID to route data to them

ISA-09
I08
Interchange Date
Required
Date (DT)
YYMMDD format

Date of the interchange

ISA-10
I09
Interchange Time
Required
Time (TM)
HHMM format

Time of the interchange

ISA-11
I10
Interchange Control Standards Identifier
Required
Identifier (ID)

Code to identify the agency responsible for the control standard used by the message that is enclosed by the interchange header and trailer

U
U.S. EDI Community of ASC X12, TDCC, and UCS
ISA-12
I11
Interchange Control Version Number
Required
Identifier (ID)

This version number covers the interchange control segments

00401
Draft Standards for Trial Use Approved for Publication by ASC X12 Procedures Review Board through October 1997
ISA-13
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

ISA-14
I13
Acknowledgment Requested
Required
Identifier (ID)
Min 1Max 1

Code sent by the sender to request an interchange acknowledgment (TA1)

0
No Acknowledgment Requested
1
Interchange Acknowledgment Requested
ISA-15
I14
Usage Indicator
Required
Identifier (ID)
Min 1Max 1

Code to indicate whether data enclosed by this interchange envelope is test, production or information

I
Information
P
Production Data
T
Test Data
ISA-16
I15
Component Element Separator
Required
String (AN)
Min 1Max 1

Type is not applicable; the component element separator is a delimiter and not a data element; this field provides the delimiter used to separate component data elements within a composite data structure; this value must be different than the data element separator and the segment terminator

>
Component Element Separator

Functional Group Header

RequiredMax use 1

To indicate the beginning of a functional group and to provide control information

Example
GS-01
479
Functional Identifier Code
Required
Identifier (ID)

Code identifying a group of application related transaction sets

SO
Ocean Shipment Information (304, 306, 309, 311, 317, 319, 321, 322, 323, 324, 325, 350, 352, 353, 354, 355, 356, 357, 358, 361)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15

Code identifying party sending transmission; codes agreed to by trading partners

GS-03
124
Application Receiver's Code
Required
String (AN)
Min 2Max 15

Code identifying party receiving transmission. Codes agreed to by trading partners

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)

GS-06
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

GS-07
455
Responsible Agency Code
Required
Identifier (ID)
Min 1Max 2

Code used in conjunction with Data Element 480 to identify the issuer of the standard

T
Transportation Data Coordinating Committee (TDCC)
X
Accredited Standards Committee X12
GS-08
480
Version / Release / Industry Identifier Code
Required
String (AN)

Code indicating the version, release, subrelease, and industry identifier of the EDI standard being used, including the GS and GE segments; if code in DE455 in GS segment is X, then in DE 480 positions 1-3 are the version number; positions 4-6 are the release and subrelease, level of the version; and positions 7-12 are the industry or trade association identifiers (optionally assigned by user); if code in DE455 in GS segment is T, then other formats are allowed

004010
Draft Standards Approved for Publication by ASC X12 Procedures Review Board through October 1997

Heading

ST
010
Heading > ST

Transaction Set Header

RequiredMax use 1

To indicate the start of a transaction set and to assign a control number

Example
ST-01
143
Transaction Set Identifier Code
Required
Identifier (ID)

Code uniquely identifying a Transaction Set

  • The transaction set identifier (ST01) used by the translation routines of the interchange partners to select the appropriate transaction set definition (e.g., 810 selects the Invoice Transaction Set).
304
Shipping Instructions
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

B2
020
Heading > B2

Beginning Segment for Shipment Information Transaction

RequiredMax use 1

To transmit basic data relating to shipment information

Usage notes

Example: B2PPSCACCIX01925PP~

Example
B2-01
375
Tariff Service Code
Optional
Identifier (ID)

Code specifying the types of services for rating purposes

DD
Door-to-Door
DP
Door-to-Pier
PD
Pier-to-Door
PP
Pier-to-Pier
B2-02
140
Standard Carrier Alpha Code
Required
Identifier (ID)
Min 2Max 4

Standard Carrier Alpha Code

  • B202 contains the Standard Carrier Alpha Code (SCAC) of the carrier that will receive the bill of lading.
  • B202 is mandatory for transaction set 204.
Usage notes

Carrier's SCAC should be provided to fulfill EDI requirement. N1_02_93 with N1_01_98 ="CA" will be used for carrier identification.

B2-04
145
Shipment Identification Number
Required
String (AN)
Min 1Max 30

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)

Usage notes

Shipment Identification Number will be the key / identifier of a Shipping Instruction for Amendment.

If N902 (with qualifier N901= SI) is used, same value as B204 should be
provided.

B2-06
146
Shipment Method of Payment
Required
Identifier (ID)

Code identifying payment terms for transportation charges

CC
Collect
MX
Mixed
PP
Prepaid (by Seller)
B2-08
86
Total Equipment
Optional
Numeric (N0)
Min 1Max 3

Total pieces of equipment

B2A
030
Heading > B2A

Set Purpose

RequiredMax use 1

To allow for positive identification of transaction set purpose

Usage notes

Example: B2A*00~

Example
B2A-01
353
Transaction Set Purpose Code
Required
Identifier (ID)

Code identifying purpose of transaction set

Usage notes

For any unrecognized value, CargoSmart will default to Original transaction.

00
Original
05
Replace
N9
080
Heading > N9

Reference Identification

OptionalMax use 100

To transmit identifying information as specified by the Reference Identification Qualifier

Usage notes

Booking Number should always be provided.

Example: N9BN1001801570~

Example
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

BM
Bill of Lading Number
BN
Booking Number

Mandatory.

CEC
Enterprise Code for Consignee

For custom manifest purpose.

CG
Consignee's Order Number
CR
Customer Reference Number
CS
Condition of Sale Document Number
CT
Contract Number
EP
Export Permit Number
FI
File Identifier
FN
Forwarder's/Agent's Reference Number
HB
Bill & Hold Invoice Number

House Bill of Lading Number.

IK
Invoice Number
NEC
Enterprise Code for Notify Party

For custom manifest purpose.

PO
Purchase Order Number
Q1
Quote Number
RF
Export Reference Number
SEC
Enterprise Code for Shipper

For custom manifest purpose.

SI
Shipper's Identifying Number for Shipment (SID)

Please provide the same value in B2_04_145 to uniquely identify Shipping Instruction. If different values are provided, B2_04_145 will be used to submit to carrier.

SO
Shipper's Order (Invoice Number)
TN
Transaction Reference Number

Used to provide ITN (Internal Transaction Number), or NDR (No Declaration Required) if ITN is not required for AES (Automated Export Systems).

N9-02
127
Reference Identification
Required
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

V1
090
Heading > V1

Vessel Identification

RequiredMax use 2

To provide vessel details and voyage number

Usage notes

CargoSmart supports ONLY 1 V1 segment.

Example: V19301794Jakarta ExpressHK021WOOLU**L~

Example
At least one of Vessel Code (V1-01) or Vessel Name (V1-02) is required
If Vessel Code Qualifier (V1-08) is present, then Vessel Code (V1-01) is required
V1-01
597
Vessel Code
Optional
Identifier (ID)
Min 1Max 8

Code identifying vessel

V1-02
182
Vessel Name
Optional
String (AN)
Min 2Max 28

Name of ship as documented in "Lloyd's Register of Ships"

V1-04
55
Flight/Voyage Number
Optional
String (AN)
Min 2Max 10

Identifying designator for the particular flight or voyage on which the cargo travels

V1-05
140
Standard Carrier Alpha Code
Optional
Identifier (ID)
Min 2Max 4

Standard Carrier Alpha Code

  • V105 identifies the ocean carrier.
Usage notes

Carrier's SCAC should be provided to fulfill EDI requirement. N1_02_93 with N1_01_98="CA" will be used for carrier identification.

V1-08
897
Vessel Code Qualifier
Optional
Identifier (ID)

Code specifying vessel code source

C
Ship's Radio Call Signal
L
Lloyd's Register of Shipping
N1 Loop
RequiredMax >1
N1
160
Heading > N1 Loop > N1

Name

RequiredMax use 1

To identify a party by type of organization, name, and code

Usage notes

For SOLAS VGM (Verified Gross Mass), weighing party can be provided in N1 with N101 = R1. If VGM are obtained by multiple weighing parties, N1_04_67 should be used to specify the container number with check digit and N1_03_66 = "ZZ".

Examples:
N1N1SHANGHAI HAOYUN INTL LOGISTICS CO LTD~
N1CAOOLU~
N1R1LOADING CO PTEZZCNTR1234567~

Example
At least one of Name (N1-02) or Identification Code Qualifier (N1-03) is required
If either Identification Code Qualifier (N1-03) or Identification Code (N1-04) is present, then the other is required
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

CA
Carrier

CargoSmart Required.

CN
Consignee

CargoSmart Required.

FW
Forwarder
N1
Notify Party no. 1

Notify Party.

N2
Notify Party no. 2

Additional Notify Party.

R1
Party to Receive Scale Ticket

For SOLAS VGM (Verified Gross Mass) weighing party.

SH
Shipper

CargoSmart Required.

SI
Shipping Schedule Issuer

CargoSmart Required.

Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

This is mandatory for N1_01_98="CA",this field must be SCAC of the carrier. In case Consignee is pending to confirm, "TO ORDER" (case sensitive) must be provided in this element.

N1-03
66
Identification Code Qualifier
Optional
Identifier (ID)

Code designating the system/method of code structure used for Identification Code (67)

25
Carrier's Customer Code
ZZ
Mutually Defined

Used when multiple weighing parties in 1 shipment.

N1-04
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

  • This segment, used alone, provides the most efficient method of providing organizational identification. To obtain this efficiency the "ID Code" (N104) must provide a key to the table maintained by the transaction processing party.
Usage notes

If N1_01_98 = "R1", this element is container number with check digit. For other cases, carrier customer code can be provided. REQUIRED when N1_01_98="SI".

N2
170
Heading > N1 Loop > N2

Additional Name Information

OptionalMax use 2

To specify additional names or those longer than 35 characters in length

Usage notes

If N101 = R1 (Weighing party), N2 should be provided as the signature (name in capitals of the person authorized) to sign the document declaring the verified gross mass.

Examples:
N2Canning Company Limited~
N2
CHRIS WONG~

Example
Required
String (AN)
Min 1Max 60

Free-form name

Optional
String (AN)
Min 1Max 60

Free-form name

N3
180
Heading > N1 Loop > N3

Address Information

OptionalMax use 2

To specify the location of the named party

Usage notes

Customer is required to preserve their Party information format in EDI. CargoSmart recommends to preserve a complete word in the same data element. The Party information will be truncated if exceeds maximum length supported by carrier

Example:
N3300 Park Blvd. Suite 350Itasca, IL 60143 (USA)~ (Correct)
N3300 Park Blvd. Suite 350, Itasca, IL 60143 (USA)~ (Incorrect)

Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 55

Address information

N3-02
166
Address Information
Optional
String (AN)
Min 1Max 55

Address information

N4
190
Heading > N1 Loop > N4

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

Usage notes

Example: N4SAN PEDROCA90731US~

Example
If Location Identifier (N4-06) is present, then Location Qualifier (N4-05) is required
N4-01
19
City Name
Optional
String (AN)
Min 2Max 30

Free-form text for city name

  • A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
N4-02
156
State or Province Code
Optional
Identifier (ID)
Min 2Max 2

Code (Standard State/Province) as defined by appropriate government agency

  • N402 is required only if city name (N401) is in the U.S. or Canada.
N4-03
116
Postal Code
Optional
Identifier (ID)
Min 3Max 15

Code defining international postal zone code excluding punctuation and blanks (zip code for United States)

N4-04
26
Country Code
Optional
Identifier (ID)
Min 2Max 3

Code identifying the country

N4-05
309
Location Qualifier
Optional
Identifier (ID)

Code identifying type of location

D
Census Schedule D
K
Census Schedule K
UN
United Nations Location Code (UNLOCODE)
N4-06
310
Location Identifier
Optional
String (AN)
Min 1Max 30

Code which identifies a specific location

G61
195
Heading > N1 Loop > G61

Contact

OptionalMax use 3

To identify a person or office to whom communications should be directed

Usage notes

Example:
G61ICLOS ANGELES OCEAN CARGO EXPORTTE(310) 241-1600~

Example
If either Communication Number Qualifier (G61-03) or Communication Number (G61-04) is present, then the other is required
G61-01
366
Contact Function Code
Required
Identifier (ID)

Code identifying the major duty or responsibility of the person or group named

IC
Information Contact
Required
String (AN)
Min 1Max 60

Free-form name

G61-03
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

  • G6103 qualifies G6104.
EM
Electronic Mail
FX
Facsimile
TE
Telephone
G61-04
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

N1 Loop end
R4 Loop
OptionalMax >1
R4
200
Heading > R4 Loop > R4

Port or Terminal

RequiredMax use 1

Contractual or operational port or point relevant to the movement of the cargo

Usage notes

CargoSmart recommends using UN/ECE location Code to present location, where some carriers request it as mandatory information.

Example: R4RUNUSLAXLOS ANGELES, CA, USA*US~

Example
If either Location Qualifier (R4-02) or Location Identifier (R4-03) is present, then the other is required
R4-01
115
Port or Terminal Function Code
Required
Identifier (ID)

Code defining function performed at the port or terminal with respect to a shipment

D
Port of Discharge (Operational)

Mandatory.

E
Place of Delivery (Contractual)

CargoSmart recommends to provide Place of Delivery as required by some carriers to avoid SI rejection from carrier.

F
Freight Payable At (Contractual)
L
Port of Loading (Operational)

Mandatory.

Q
Bill of Lading Origin of Goods (Contractual)
R
Place of Receipt (Contractual)

CargoSmart recommends to provide Place of Receipt as required by some carriers to avoid SI rejection from carrier.

W
Bill of Lading Release Office (Operational)
R4-02
309
Location Qualifier
Optional
Identifier (ID)

Code identifying type of location

D
Census Schedule D
K
Census Schedule K
UN
United Nations Location Code (UNLOCODE)

CargoSmart highly recommends UN/ECE code, which generally accepted by carriers.

R4-03
310
Location Identifier
Optional
String (AN)
Min 1Max 30

Code which identifies a specific location

Usage notes

This field is mandatory for R401="L" and R401="D".

R4-04
114
Port Name
Optional
String (AN)
Min 2Max 24

Free-form name for the place at which an offshore carrier originates or terminates (by transshipment or otherwise) its actual ocean carriage of property

R4-05
26
Country Code
Optional
Identifier (ID)
Min 2Max 3

Code identifying the country

R4-08
156
State or Province Code
Optional
Identifier (ID)
Min 2Max 2

Code (Standard State/Province) as defined by appropriate government agency

R4 Loop end
R2
220
Heading > R2

Route Information

OptionalMax use 13

To specify carrier and routing sequences and details

Usage notes

Example: R2OOLUO**********02~

Example
R2-01
140
Standard Carrier Alpha Code
Required
Identifier (ID)
Min 2Max 4

Standard Carrier Alpha Code

R2-02
133
Routing Sequence Code
Required
Identifier (ID)

Code describing the relationship of a carrier to a specific shipment movement

O
Origin Carrier (Air, Motor, or Ocean)
R2-12
56
Type of Service Code
Optional
Identifier (ID)

Code specifying extent of transportation service requested

02
FCL/FCL
03
LCL/LCL
82
FCL/LCL
83
LCL/FCL
C8 Loop
OptionalMax >1
C8
290
Heading > C8 Loop > C8

Certifications and Clauses

RequiredMax use 1

To specify applicable certifications and clauses

Usage notes

Example: C8*20No Shipper's Export Declaration Required~

Example
At least one of Certification/Clause Code (C8-02) or Certification/Clause Text (C8-03) is required
C8-02
246
Certification/Clause Code
Optional
Identifier (ID)

Code identifying certification/clause information

01
Shipper's Load and Count
02
Shipper's Load, Stowage and Count
03
Laden on Board
04
Laden on Board Vessel
11
Memo Bill of Lading Only
20
No Shipper's Export Declaration Required (Section 30.39)
22
On Board Rail
24
On Board Vessel
25
Received For Shipment
34
Laden on Board Named Vessel
CC
Custom
C8-03
247
Certification/Clause Text
Optional
String (AN)
Min 2Max 60

Free-form description of commercial invoice certification/clause

C8C
295
Heading > C8 Loop > C8C

Certifications Clauses Continuation

OptionalMax use 5

To specify additional applicable certifications and clauses

Usage notes

Example: C8C*CERT CLAUSE TEXT~

Example
C8C-01
247
Certification/Clause Text
Required
String (AN)
Min 2Max 60

Free-form description of commercial invoice certification/clause

C8C-02
247
Certification/Clause Text
Optional
String (AN)
Min 2Max 60

Free-form description of commercial invoice certification/clause

C8C-03
247
Certification/Clause Text
Optional
String (AN)
Min 2Max 60

Free-form description of commercial invoice certification/clause

C8 Loop end
Heading end

Detail

LX Loop
OptionalMax >1
LX
010
Detail > LX Loop > LX

Assigned Number

RequiredMax use 1

To reference a line number in a transaction set

Usage notes

Example: LX*1~

Example
LX-01
554
Assigned Number
Required
Numeric (N0)
Min 1Max 6

Number assigned for differentiation within a transaction set

N7 Loop
OptionalMax >1
N7
030
Detail > LX Loop > N7 Loop > N7

Equipment Details

RequiredMax use 1

To identify the equipment

Usage notes

CargoSmart accepts only one L0 loop in each LX loop, while N7 loop can be multiple. Please refer the detailed container load plan in N7 and L0 loop at the end of implementation guideline.

Example:
N7XXXX8516627616.21G*58.825X*N*K3*42G0~

Example
If either Weight (N7-03) or Weight Qualifier (N7-04) is present, then the other is required
If either Volume (N7-08) or Volume Unit Qualifier (N7-09) is present, then the other is required
N7-01
206
Equipment Initial
Optional
String (AN)
Min 1Max 4

Prefix or alphabetic part of an equipment unit's identifying number

  • N701 is mandatory for rail transactions.
N7-02
207
Equipment Number
Required
String (AN)
Min 1Max 10

Sequencing or serial part of an equipment unit's identifying number (pure numeric form for equipment number is preferred)

N7-03
81
Weight
Optional
Decimal number (R)
Min 1Max 10

Numeric value of weight

N7-04
187
Weight Qualifier
Optional
Identifier (ID)

Code defining the type of weight

G
Gross Weight
N7-05
167
Tare Weight
Optional
Numeric (N0)
Min 3Max 8

Weight of the equipment

N7-08
183
Volume
Optional
Decimal number (R)
Min 1Max 8

Value of volumetric measure

N7-09
184
Volume Unit Qualifier
Optional
Identifier (ID)

Code identifying the volume unit

E
Cubic Feet
X
Cubic Meters
N7-10
102
Ownership Code
Optional
Identifier (ID)

Code indicating the relationship of equipment to carrier or ownership of equipment

N
Not Customer Owned or Leased

Carrier Provided Container.

S
Customer Owned or Leased

Shipper Owned Container (SOC).

N7-17
188
Weight Unit Code
Optional
Identifier (ID)

Code specifying the weight unit

E
Metric Ton
K
Kilograms
L
Pounds
N7-18
761
Equipment Number Check Digit
Optional
Numeric (N0)
Min 1Max 1

Number which designates the check digit applied to a piece of equipment

N7-22
24
Equipment Type
Required
Identifier (ID)
Min 4Max 4

Code identifying equipment type

QTY
035
Detail > LX Loop > N7 Loop > QTY

Quantity

OptionalMax use 1

To specify quantity information

Usage notes

To indicate the number of outer package of the commodity that is loaded into the container.

Example: QTY3920~

Example
QTY-01
673
Quantity Qualifier
Required
Identifier (ID)

Code specifying the type of quantity

39
Shipped Quantity
QTY-02
380
Quantity
Required
Decimal number (R)
Min 1Max 15

Numeric value of quantity

Usage notes

Number of Outer package which the cargo packed into the container. Must be valid whole number with no decimal and commas.

M7
050
Detail > LX Loop > N7 Loop > M7

Seal Numbers

OptionalMax use 5

To record seal numbers used and the organization that applied the seals

Usage notes

Maximum 35 characters for the seal number can be used. M702 and M703 will be used if seal number is longer than 15 characters.

Example: M7284520***CA~

Example
M7-01
225
Seal Number
Required
String (AN)
Min 2Max 15

Unique number on seal used to close a shipment

M7-02
225
Seal Number
Optional
String (AN)
Min 2Max 15

Unique number on seal used to close a shipment

M7-03
225
Seal Number
Optional
String (AN)
Min 2Max 15

Unique number on seal used to close a shipment

M7-05
98
Entity Identifier Code
Optional
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

  • M705 indicates the name of the organization which applied the seal(s).
Usage notes

Required for carrier and shipper as seal issuer.

CA
Carrier
SH
Shipper
W09
060
Detail > LX Loop > N7 Loop > W09

Equipment and Temperature

OptionalMax use 1

To relate equipment type and required temperatures

Usage notes

Example: W09CZ0CE4V*10~

Example
If either Temperature (W09-02) or Unit or Basis for Measurement Code (W09-03) is present, then the other is required
W09-01
40
Equipment Description Code
Required
Identifier (ID)

Code identifying type of equipment used for shipment

CZ
Refrigerated Container
W09-02
408
Temperature
Optional
Decimal number (R)
Min 1Max 4

Temperature

  • W0902 is the minimum allowable temperature condition for shipment; (the qualifying temperature scale is specified in W0903).
W09-03
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

CE
Centigrade, Celsius
FA
Fahrenheit
W09-05
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

Usage notes

For reefer container air flow unit.

2L
Cubic Feet Per Minute
4V
Cubic Meter Per Hour
W09-06
3
Free Form Message
Optional
String (AN)
Min 1Max 60

Free-form text

  • W0906 is used to describe the environment required within an ocean-type, refrigerated container when other than normal air is required.
Usage notes

Remarks for Reefer Containers.

W09-09
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

  • W0909 is the number of air exchanges per hour.
Usage notes

For reefer container air flow value.

N9
130
Detail > LX Loop > N7 Loop > N9

Verified Gross Mass Measurement Method

OptionalMax use 100

To transmit identifying information as specified by the Reference Identification Qualifier

Usage notes

To specify the SOLAS VGM (Verified Gross Mass) value, unit and measurement method. If SOLAS VGM value is provided, VGM unit and measurement method should also be provided.

Example:
N9VGD1~

Example
Variants (all may be used)
N9Verified Gross Mass UnitN9Verified Gross Mass Value
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

VGD
Verified Gross Mass Measurement Method
N9-02
127
Reference Identification
Optional
String (AN)

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

1
Method 1
2
Method 2
N9
130
Detail > LX Loop > N7 Loop > N9

Verified Gross Mass Unit

OptionalMax use 100

To transmit identifying information as specified by the Reference Identification Qualifier

Usage notes

To specify the SOLAS VGM (Verified Gross Mass) value, unit and measurement method. If SOLAS VGM value is provided, VGM unit and measurement method should also be provided.

Example:
N9VGUK~

Example
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

VGU
Verified Gross Mass Unit
N9-02
127
Reference Identification
Optional
String (AN)

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

K
Kilograms
L
Pounds
N9
130
Detail > LX Loop > N7 Loop > N9

Verified Gross Mass Value

OptionalMax use 100

To transmit identifying information as specified by the Reference Identification Qualifier

Usage notes

To specify the SOLAS VGM (Verified Gross Mass) value, unit and measurement method. If SOLAS VGM value is provided, VGM unit and measurement method should also be provided.

Example:
N9VGM5212.6~

Example
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

VGM
Verified Gross Mass Value
N9-02
127
Reference Identification
Optional
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

N7 Loop end
L0 Loop
OptionalMax >1
L0
170
Detail > LX Loop > L0 Loop > L0

Line Item - Quantity and Weight

RequiredMax use 1

To specify quantity, weight, volume, and type of service for a line item including applicable "quantity/rate-as" data

Usage notes

CargoSmart accepts only one L0 loop in each LX loop, while N7 loop can be multiple. Please refer the detailed container load plan in N7 and L0 loop at the end of implementation guideline.

Example: L0119136G16.550X17*PCSL~

Example
If either Weight (L0-04) or Weight Qualifier (L0-05) is present, then the other is required
If either Volume (L0-06) or Volume Unit Qualifier (L0-07) is present, then the other is required
If Weight Unit Code (L0-11) is present, then Weight (L0-04) is required
L0-01
213
Lading Line Item Number
Optional
Numeric (N0)
Min 1Max 3

Sequential line number for a lading item

L0-04
81
Weight
Optional
Decimal number (R)
Min 1Max 10

Numeric value of weight

L0-05
187
Weight Qualifier
Optional
Identifier (ID)

Code defining the type of weight

G
Gross Weight
N
Actual Net Weight
L0-06
183
Volume
Optional
Decimal number (R)
Min 1Max 8

Value of volumetric measure

L0-07
184
Volume Unit Qualifier
Optional
Identifier (ID)

Code identifying the volume unit

E
Cubic Feet
X
Cubic Meters
L0-08
80
Lading Quantity
Required
Numeric (N0)
Min 1Max 7

Number of units (pieces) of the lading commodity

  • L008 is the number of handling units of the line item tendered to the carrier.
L0-09
211
Packaging Form Code
Required
Identifier (ID)
Min 3Max 3

Code for packaging form of the lading quantity

Usage notes

Please refer to the Appendix for the full list.

L0-11
188
Weight Unit Code
Optional
Identifier (ID)

Code specifying the weight unit

E
Metric Ton
K
Kilograms
L
Pounds
L4
177
Detail > LX Loop > L0 Loop > L4

Measurement

OptionalMax use 1

To describe physical dimensions and quantities

Usage notes

Required for Awkward Cargo.

Example: L4111X*7~

Example
L4-01
82
Length
Required
Decimal number (R)
Min 1Max 8

Largest horizontal dimension of an object measured when the object is in the upright position

Required
Decimal number (R)
Min 1Max 8

Shorter measurement of the two horizontal dimensions measured with the object in the upright position

L4-03
65
Height
Required
Decimal number (R)
Min 1Max 8

Vertical dimension of an object measured when the object is in the upright position

L4-04
90
Measurement Unit Qualifier
Required
Identifier (ID)

Code specifying the linear dimensional unit

C
Centimeters
N
Inches
L5
185
Detail > LX Loop > L0 Loop > L5

Description, Marks and Numbers

RequiredMax use 999

To specify the line item in terms of description, quantity, packaging, and marks and numbers

Usage notes

Each L503 supports only 1 HS code. For multiple HS codes within same L0 group, multiple L5 segments should be provided.

Example: L52BIO-CHLOR IN 25KG BAGS~

Example
If either Commodity Code (L5-03) or Commodity Code Qualifier (L5-04) is present, then the other is required
L5-01
213
Lading Line Item Number
Optional
Numeric (N0)
Min 1Max 3

Sequential line number for a lading item

L5-02
79
Lading Description
Optional
String (AN)
Min 1Max 50

Description of an item as required for rating and billing purposes

  • L502 may be used to send quantity information as part of the product description.
L5-03
22
Commodity Code
Optional
String (AN)
Min 1Max 30

Code describing a commodity or group of commodities

L5-04
23
Commodity Code Qualifier
Optional
Identifier (ID)

Code identifying the commodity coding system used for Commodity Code

J
Harmonized System-Based Schedule B
L5-06
87
Marks and Numbers
Optional
String (AN)
Min 1Max 48

Marks and numbers used to identify a shipment or parts of a shipment

N9
195
Detail > LX Loop > L0 Loop > N9

Reference Identification

OptionalMax use 100

To transmit identifying information as specified by the Reference Identification Qualifier

Example
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

IX
Item Number
PO
Purchase Order Number
SKU
Stock Keeping Unit
TN
Transaction Reference Number
TS
Tariff Number
N9-02
127
Reference Identification
Optional
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

H1 Loop
OptionalMax >1
H1
270
Detail > LX Loop > L0 Loop > H1 Loop > H1

Hazardous Material

RequiredMax use 1

To specify information relative to hazardous material

Usage notes

H1 Loop is required for Dangerous Cargo.

Example: H112633IPAINT604-986-4617***III~

Example
If either Flashpoint Temperature (H1-07) or Unit or Basis for Measurement Code (H1-08) is present, then the other is required
H1-01
62
Hazardous Material Code
Required
String (AN)
Min 4Max 10

Code relating to hazardous material code qualifier for regulated hazardous materials

H1-02
209
Hazardous Material Class Code
Optional
String (AN)
Min 1Max 4

Code specifying the kind of hazard for a material

H1-03
208
Hazardous Material Code Qualifier
Optional
Identifier (ID)

Code which qualifies the Hazardous Material Class Code (209)

I
Intergovernmental Maritime Organization (IMO) Code
H1-05
63
Hazardous Material Contact
Optional
String (AN)
Min 1Max 24

Phone number and name of person or department to contact in case of emergency

H1-06
200
Hazardous Materials Page
Optional
String (AN)
Min 1Max 6

The United Nations page number as required for the international transport of hazardous materials

H1-07
77
Flashpoint Temperature
Optional
Numeric (N)
Min 1Max 3

The flashpoint temperature for hazardous material

  • H107 is the lowest temperature for hazardous materials.
H1-08
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

CE
Centigrade, Celsius
FA
Fahrenheit
H1-09
254
Packing Group Code
Optional
Identifier (ID)
Min 1Max 3

Code indicating degree of danger in terms of Roman number I, II or III

H2
280
Detail > LX Loop > L0 Loop > H1 Loop > H2

Additional Hazardous Material Description

OptionalMax use 10

To specify free-form hazardous material descriptive data in addition to the information provided in the H1 segment

Usage notes

H2_02 will be handled as supplement information for related hazard material if below qualifier is provided in H2_01.
EMS: EMS number
PSN: Proper Shipping Name

Example: H2PSNPROPER SHIPPING NAME~

Example
H2-01
64
Hazardous Material Description
Required
String (AN)
Min 2Max 30

Material name, special instructions, and phone number if any

H2-02
274
Hazardous Material Classification
Optional
String (AN)
Min 1Max 30

Free-form description of hazardous material classification or division or label requirements

H1 Loop end
L0 Loop end
LX Loop end
Detail end

Summary

L3 Loop
OptionalMax >1
L3
010
Summary > L3 Loop > L3

Total Weight and Charges

RequiredMax use 1

To specify the total shipment in terms of weight, volume, rates, charges, advances, and prepaid amounts applicable to one or more line items

Usage notes

Example: L323276.65G*****16X*1K~

Example
If either Volume (L3-09) or Volume Unit Qualifier (L3-10) is present, then the other is required
If Weight Unit Code (L3-12) is present, then Weight (L3-01) is required
L3-01
81
Weight
Optional
Decimal number (R)
Min 1Max 10

Numeric value of weight

L3-02
187
Weight Qualifier
Optional
Identifier (ID)

Code defining the type of weight

G
Gross Weight
L3-09
183
Volume
Optional
Decimal number (R)
Min 1Max 8

Value of volumetric measure

L3-10
184
Volume Unit Qualifier
Optional
Identifier (ID)

Code identifying the volume unit

E
Cubic Feet
X
Cubic Meters
L3-11
80
Lading Quantity
Optional
Numeric (N0)
Min 1Max 7

Number of units (pieces) of the lading commodity

L3-12
188
Weight Unit Code
Optional
Identifier (ID)

Code specifying the weight unit

K
Kilograms
L
Pounds
PWK
020
Summary > L3 Loop > PWK

Paperwork

OptionalMax use 50

To identify the type or transmission or both of paperwork or supporting information

Usage notes

Only 1 of document type (BL, SW or ZZ) should be provided. ZZ is supported by some carriers only with specific usage and not for BL print purpose, e.g. custom manifest purpose.

Example: PWKBLEI*0~

Example
PWK-01
755
Report Type Code
Required
Identifier (ID)

Code indicating the title or contents of a document, report or supporting item

Usage notes

CargoSmart supports all 4 types below, while only few carriers extends support for House Bill of lading (ZZ).

BC
Bill of Lading Copy
BL
Bill of Lading

For Original Bill of Lading, please use BL.

SW
Sea Waybill
ZZ
Mutually Defined

House Bill of Lading.

PWK-02
756
Report Transmission Code
Optional
Identifier (ID)

Code defining timing, transmission method or format by which reports are to be sent

CS
CargoSmart Online BL
EI
EDI Transmission
EL
Electronically Only
FX
By Fax
OT
Others
PO
Printed Original Required
PWK-03
757
Report Copies Needed
Optional
Numeric (N0)
Min 1Max 2

The number of copies of a report that should be sent to the addressee

PWK-07
352
Description
Optional
String (AN)
Min 1Max 80

A free-form description to clarify the related data elements and their content

  • PWK07 may be used to indicate special information to be shown on the specified report.
Usage notes

For freighted bill of lading, please provide FREIGHTED.

K1
060
Summary > L3 Loop > K1

Remarks

OptionalMax use 999

To transmit information in a free-form format for comment or special instruction

Usage notes

Example:
K1*FCL/FCL Shippers Weight, Load,*Stowage and Count Non Negotia~

Example
K1-01
61
Free-Form Message
Required
String (AN)
Min 1Max 30

Free-form information

K1-02
61
Free-Form Message
Optional
String (AN)
Min 1Max 30

Free-form information

L3 Loop end
SE
080
Summary > SE

Transaction Set Trailer

RequiredMax use 1

To indicate the end of the transaction set and provide the count of the transmitted segments (including the beginning (ST) and ending (SE) segments)

Example
SE-01
96
Number of Included Segments
Required
Numeric (N0)
Min 1Max 10

Total number of segments included in a transaction set including ST and SE segments

SE-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

Summary end

Functional Group Trailer

RequiredMax use 1

To indicate the end of a functional group and to provide control information

Example
GE-01
97
Number of Transaction Sets Included
Required
Numeric (N0)
Min 1Max 6

Total number of transaction sets included in the functional group or interchange (transmission) group terminated by the trailer containing this data element

GE-02
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

Interchange Control Trailer

RequiredMax use 1

To define the end of an interchange of zero or more functional groups and interchange-related control segments

Example
IEA-01
I16
Number of Included Functional Groups
Required
Numeric (N0)
Min 1Max 5

A count of the number of functional groups included in an interchange

IEA-02
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

Stedi is a registered trademark of Stedi, Inc. All names, logos, and brands of third parties listed on this page are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.