Ryder
/
Freight Receipt and Invoice (Ocean)
  • Specification
  • EDI Inspector
Stedi maintains this guide based on public documentation from Ryder. Contact Ryder for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
Ryder logo

X12 310 Freight Receipt and Invoice (Ocean)

X12 Release 4010

This Draft Standard for Trial Use contains the format and establishes the data contents of the Freight Receipt and Invoice (Ocean) Transaction Set (310) for use within the context of an Electronic Data Interchange (EDI) environment. The transaction set can be used to provide ocean bill of lading information. It is sent by ocean carriers to interested parties and can be used as the receipt for the shipment; to substitute for a paper bill of lading where the parties have agreed that a paper bill of lading is not necessary; to allow shipper or forwarder to verify bill of lading information before an original is printed and released; for information purposes, i.e., as a bill of lading copy; by the carrier to convey manifest information to a terminal operator; and as an invoice for freight.

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/ryder/freight-receipt-and-invoice-ocean/01GWA2595679EBNVVYJYF94RDX
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
B3
020
Beginning Segment for Carrier's Invoice
Max use 1
Required
B2A
030
Set Purpose
Max use 1
Optional
N9
060
Reference Identification
Max use 15
Required
V1
070
Vessel Identification
Max use 2
Required
C2
100
Bank ID
Max use 1
Optional
C3
110
Currency
Max use 1
Required
Y2
120
Container Details
Max use 10
Required
N1 Loop
R2
200
Route Information
Max use 13
Optional
L5
230
Description, Marks and Numbers
Max use 1
Required
detail
LX Loop
LX
010
Assigned Number
Max use 1
Required
N7 Loop
N7
020
Equipment Details
Max use 1
Required
M7
050
Seal Numbers
Max use 5
Required
L7
090
Tariff Reference
Max use 1
Optional
N9
120
Reference Identification
Max use 3
Optional
H1 Loop
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

IO
Ocean Shipment Billing Details (310, 312, 980)
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).
310
Freight Receipt and Invoice (Ocean)
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

B3
020
Heading > B3

Beginning Segment for Carrier's Invoice

RequiredMax use 1

To transmit basic data relating to the carrier's invoice

Example
B3-02
76
Invoice Number
Required
String (AN)
Min 1Max 22

Identifying number assigned by issuer

B3-03
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)

B3-04
146
Shipment Method of Payment
Required
Identifier (ID)

Code identifying payment terms for transportation charges

CC
Collect
PP
Prepaid (by Seller)
TP
Third Party Pay
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • B306 is the billing date.
B3-07
193
Net Amount Due
Required
Numeric (N2)
Min 1Max 12

Total charges to be paid by the receiver of this transaction set expressed in the standard monetary denomination for the currency specified

B3-08
202
Correction Indicator
Optional
Identifier (ID)

Code used to indicate that the transaction set contains information which corrects previous information

BD
Balance Due Billing

To be used only for short paid or supplemental invoice.

B3-09
32
Delivery Date
Required
Date (DT)
CCYYMMDD format

Date for delivery of cargo to final consignee or to next mode expressed in format CCYYMMDD

  • On collect freight bills the data in B309 will be the actual delivery date. For the shipments invoiced prior to delivery, the B309 will be the estimated date of delivery.
B3-10
374
Date/Time Qualifier
Required
Identifier (ID)

Code specifying type of date or time, or both date and time

035
Delivered
B3-11
140
Standard Carrier Alpha Code
Required
Identifier (ID)
Min 2Max 4

Standard Carrier Alpha Code

Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

B3-13
375
Tariff Service Code
Optional
Identifier (ID)
Min 2Max 2

Code specifying the types of services for rating purposes

B3-14
335
Transportation Terms Code
Optional
Identifier (ID)
Min 3Max 3

Code identifying the trade terms which apply to the shipment transportation responsibility

  • If B314 is used, B304 will indicate the party or parties responsible for payment of the transportation terms identified in B314.
B2A
030
Heading > B2A

Set Purpose

OptionalMax use 1

To allow for positive identification of transaction set purpose

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

Code identifying purpose of transaction set

00
Original
B2A-02
346
Application Type
Optional
Identifier (ID)
Min 2Max 2

Code identifying an application

N9
060
Heading > N9

Reference Identification

RequiredMax use 15

To transmit identifying information as specified by the Reference Identification Qualifier

Example
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)
Min 2Max 3

Code qualifying the Reference Identification

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

V1
070
Heading > V1

Vessel Identification

RequiredMax use 2

To provide vessel details and voyage number

Example
At least one of Vessel Code (V1-01) or Vessel Name (V1-02) 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"

C2
100
Heading > C2

Bank ID

OptionalMax use 1

To specify data required for electronic payment

Example
C2-01
8
Bank Client Code
Optional
Identifier (ID)
Min 1Max 1

Code identifying payee or payer

C2-02
66
Identification Code Qualifier
Optional
Identifier (ID)
Min 1Max 2

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

C2-03
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

C3
110
Heading > C3

Currency

RequiredMax use 1

To specify the currency being used in the transaction set

Example
C3-01
100
Currency Code
Required
Identifier (ID)
Min 3Max 3

Code (Standard ISO) for country in whose currency the charges are specified

  • C301 is the billing currency.
C3-02
280
Exchange Rate
Optional
Decimal number (R)
Min 4Max 10

Value to be used as a multiplier conversion factor to convert monetary value from one currency to another

C3-03
100
Currency Code
Optional
Identifier (ID)
Min 3Max 3

Code (Standard ISO) for country in whose currency the charges are specified

  • C303 is the payment currency.
C3-04
100
Currency Code
Optional
Identifier (ID)
Min 3Max 3

Code (Standard ISO) for country in whose currency the charges are specified

  • C304 is the rated currency.
Y2
120
Heading > Y2

Container Details

RequiredMax use 10

To specify container information and transportation service to be used

Example
Y2-01
95
Number of Containers
Required
Numeric (N0)
Min 1Max 4

Number of shipping containers

Y2-02
78
Container Type Request Code
Optional
Identifier (ID)
Min 1Max 1

Code indicating type of container equipment requested

Y2-03
56
Type of Service Code
Optional
Identifier (ID)
Min 2Max 2

Code specifying extent of transportation service requested

Y2-04
24
Equipment Type
Required
Identifier (ID)
Min 4Max 4

Code identifying equipment type

Y2-05
91
Transportation Method/Type Code
Optional
Identifier (ID)
Min 1Max 2

Code specifying the method or type of transportation for the shipment

Y2-06
177
Intermodal Service Code
Optional
Identifier (ID)
Min 1Max 2

Code identifying the Intermodal Service Plan

Y2-07
140
Standard Carrier Alpha Code
Optional
Identifier (ID)
Min 2Max 4

Standard Carrier Alpha Code

Y2-08
464
Container Terms Code
Optional
Identifier (ID)
Min 3Max 3

Code indicating origin and destination of transportation and type of container

Y2-09
465
Container Terms Code Qualifier
Optional
Identifier (ID)
Min 1Max 1

Code indicating container terms reference

Y2-10
466
Total Stopoffs
Optional
Numeric (N0)
Min 1Max 2

Total number of stopoffs specified for a shipment

N1 Loop
RequiredMax >1
N1
130
Heading > N1 Loop > N1

Name

RequiredMax use 1

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

Example
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)
Min 2Max 3

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

Required
String (AN)
Min 1Max 60

Free-form name

N1-03
66
Identification Code Qualifier
Optional
Identifier (ID)
Min 1Max 2

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

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.
N2
140
Heading > N1 Loop > N2

Additional Name Information

OptionalMax use 1

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

Example
Required
String (AN)
Min 1Max 60

Free-form name

Optional
String (AN)
Min 1Max 60

Free-form name

N3
150
Heading > N1 Loop > N3

Address Information

RequiredMax use 2

To specify the location of the named party

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
160
Heading > N1 Loop > N4

Geographic Location

RequiredMax use 1

To specify the geographic place of the named party

Example
N4-01
19
City Name
Required
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
Required
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
Required
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
Required
Identifier (ID)
Min 2Max 3

Code identifying the country

N1 Loop end
R4 Loop
RequiredMax >1
R4
180
Heading > R4 Loop > R4

Port or Terminal

RequiredMax use 1

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

Example
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)

Port at which cargo is unloaded from vessel

E
Place of Delivery (Contractual)

Place at which cargo leaves its care and custody of carrier

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

R4-02
309
Location Qualifier
Required
Identifier (ID)
Min 1Max 2

Code identifying type of location

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

Code which identifies a specific location

R4-04
114
Port Name
Required
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-06
174
Terminal Name
Optional
String (AN)
Min 2Max 30

Free-form field for terminal name

R4-07
113
Pier Number
Optional
String (AN)
Min 1Max 4

Identifying number for the pier

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

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

DTM
190
Heading > R4 Loop > DTM

Date/Time Reference

RequiredMax use 15

To specify pertinent dates and times

Example
If Time Code (DTM-04) is present, then Time (DTM-03) is required
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)

Code specifying type of date or time, or both date and time

011
Shipped
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

Optional
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)

DTM-04
623
Time Code
Optional
Identifier (ID)
Min 2Max 2

Code identifying the time. In accordance with International Standards Organization standard 8601, time can be specified by a + or - and an indication in hours in relation to Universal Time Coordinate (UTC) time; since + is a restricted character, + and - are substituted by P and M in the codes that follow

R4 Loop end
R2
200
Heading > R2

Route Information

OptionalMax use 13

To specify carrier and routing sequences and details

Example
If Intermediate Switch Carrier (R2-08) is present, then Intermediate Switch Carrier (R2-07) is required
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)
Min 1Max 2

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

R2-03
19
City Name
Optional
String (AN)
Min 2Max 30

Free-form text for city name

  • R203 is the station or city name at which carriers interchange shipments.
R2-04
154
Standard Point Location Code
Optional
Identifier (ID)
Min 6Max 9

Code (Standard Point Location) defined by NMFTA point development group as the official code assigned to a city or point (for ratemaking purposes) within a city

R2-05
177
Intermodal Service Code
Optional
Identifier (ID)
Min 1Max 2

Code identifying the Intermodal Service Plan

R2-06
91
Transportation Method/Type Code
Optional
Identifier (ID)
Min 1Max 2

Code specifying the method or type of transportation for the shipment

R2-07
296
Intermediate Switch Carrier
Optional
Identifier (ID)
Min 2Max 4

Code defining a road which neither originates nor terminates the shipment but provides a switching service between two roadhaul rail carriers (SCAC code for rail switch carrier)

R2-08
296
Intermediate Switch Carrier
Optional
Identifier (ID)
Min 2Max 4

Code defining a road which neither originates nor terminates the shipment but provides a switching service between two roadhaul rail carriers (SCAC code for rail switch carrier)

R2-09
76
Invoice Number
Optional
String (AN)
Min 1Max 22

Identifying number assigned by issuer

Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • R210 is the billing date.
R2-11
369
Free-form Description
Optional
String (AN)
Min 1Max 45

Free-form descriptive text

R2-12
56
Type of Service Code
Optional
Identifier (ID)
Min 2Max 2

Code specifying extent of transportation service requested

R2-13
742
Route Description
Optional
String (AN)
Min 1Max 35

Point to point routing description

L5
230
Heading > L5

Description, Marks and Numbers

RequiredMax use 1

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

Example
If either Commodity Code (L5-03) or Commodity Code Qualifier (L5-04) is present, then the other is required
If Marks and Numbers Qualifier (L5-07) is present, then Marks and Numbers (L5-06) is required
If either Commodity Code Qualifier (L5-08) or Commodity Code (L5-09) is present, then the other is required
L5-01
213
Lading Line Item Number
Required
Numeric (N0)
Min 1Max 3

Sequential line number for a lading item

L5-02
79
Lading Description
Required
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)
Min 1Max 1

Code identifying the commodity coding system used for Commodity Code

L5-05
103
Packaging Code
Optional
String (AN)
Min 3Max 5

Code identifying the type of packaging; Part 1: Packaging Form, Part 2: Packaging Material; if the Data Element is used, then Part 1 is always required

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

L5-07
88
Marks and Numbers Qualifier
Optional
Identifier (ID)
Min 1Max 2

Code specifying the application or source of Marks and Numbers (87)

L5-08
23
Commodity Code Qualifier
Optional
Identifier (ID)
Min 1Max 1

Code identifying the commodity coding system used for Commodity Code

L5-09
22
Commodity Code
Optional
String (AN)
Min 1Max 30

Code describing a commodity or group of commodities

L5-10
595
Compartment ID Code
Optional
Identifier (ID)
Min 1Max 1

Code identifying the compartment in a compartmentalized tank car

Heading end

Detail

LX Loop
RequiredMax >1
LX
010
Detail > LX Loop > LX

Assigned Number

RequiredMax use 1

To reference a line number in a transaction set

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

Number assigned for differentiation within a transaction set

N7 Loop
RequiredMax >1
N7
020
Detail > LX Loop > N7 Loop > N7

Equipment Details

RequiredMax use 1

To identify the equipment

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
If either Tare Weight (N7-05) or Tare Qualifier Code (N7-16) 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)
Min 1Max 2

Code defining the type of weight

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

Weight of the equipment

N7-06
232
Weight Allowance
Optional
Numeric (N0)
Min 2Max 6

Allowance made for increased weight due to such factors as snow

N7-07
205
Dunnage
Optional
Numeric (N0)
Min 1Max 6

Weight of material used to protect lading (even bracings, false floors, etc.)

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

Value of volumetric measure

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

Code identifying the volume unit

N7-10
102
Ownership Code
Optional
Identifier (ID)
Min 1Max 1

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

N7-11
40
Equipment Description Code
Required
Identifier (ID)
Min 2Max 2

Code identifying type of equipment used for shipment

N7-12
140
Standard Carrier Alpha Code
Optional
Identifier (ID)
Min 2Max 4

Standard Carrier Alpha Code

  • N712 is the owner of the equipment.
N7-13
319
Temperature Control
Optional
String (AN)
Min 3Max 6

Free-form abbreviation of temperature range or flash-point temperature

N7-14
219
Position
Optional
String (AN)
Min 1Max 3

Relative position of shipment in car, trailer, or container (mutually defined)

N7-15
567
Equipment Length
Optional
Numeric (N0)
Min 4Max 5

Length (in feet and inches) of equipment ordered or used to transport shipment (The format is FFFII where FFF is feet and II is inches; the range for II is 00 through 11)

N7-16
571
Tare Qualifier Code
Optional
Identifier (ID)
Min 1Max 1

Code identifying the type of tare

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

Code specifying the weight unit

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-19
56
Type of Service Code
Optional
Identifier (ID)
Min 2Max 2

Code specifying extent of transportation service requested

N7-20
65
Height
Optional
Decimal number (R)
Min 1Max 8

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

  • N720 and N721 are expressed in inches.
Optional
Decimal number (R)
Min 1Max 8

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

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

Code identifying equipment type

N7-23
140
Standard Carrier Alpha Code
Optional
Identifier (ID)
Min 2Max 4

Standard Carrier Alpha Code

  • N723 is the operator or carrier of the rights of the equipment.
N7-24
301
Car Type Code
Optional
Identifier (ID)
Min 1Max 4

Code specifying type of rail car or intermodal equipment type and its general characteristics

M7
050
Detail > LX Loop > N7 Loop > M7

Seal Numbers

RequiredMax use 5

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

Usage notes

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

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-04
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)
Min 2Max 3

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

  • M705 indicates the name of the organization which applied the seal(s).
L1 Loop
RequiredMax >1
L1
070
Detail > LX Loop > N7 Loop > L1 Loop > L1

Rate and Charges

RequiredMax use 1

To specify rate and charges detail relative to a line item including freight charges, advances, special charges, and entitlements

Example
If either Freight Rate (L1-02) or Rate/Value Qualifier (L1-03) is present, then the other is required
L1-01
213
Lading Line Item Number
Required
Numeric (N0)
Min 1Max 3

Sequential line number for a lading item

L1-02
60
Freight Rate
Optional
Decimal number (R)
Min 1Max 9

Rate that applies to the specific commodity

L1-03
122
Rate/Value Qualifier
Optional
Identifier (ID)
Min 2Max 2

Code qualifying how to extend charges or interpret value

L1-04
58
Charge
Required
Numeric (N2)
Min 1Max 12

For a line item: freight or special charge; for the total invoice: the total charges -- expressed in the standard monetary denomination for the currency specified

L1-08
150
Special Charge or Allowance Code
Required
Identifier (ID)
Min 3Max 3

Code identifying type of special charge or allowance

C3
080
Detail > LX Loop > N7 Loop > L1 Loop > C3

Currency

OptionalMax use 1

To specify the currency being used in the transaction set

Example
C3-01
100
Currency Code
Required
Identifier (ID)
Min 3Max 3

Code (Standard ISO) for country in whose currency the charges are specified

  • C301 is the billing currency.
C3-02
280
Exchange Rate
Optional
Decimal number (R)
Min 4Max 10

Value to be used as a multiplier conversion factor to convert monetary value from one currency to another

C3-03
100
Currency Code
Optional
Identifier (ID)
Min 3Max 3

Code (Standard ISO) for country in whose currency the charges are specified

  • C303 is the payment currency.
C3-04
100
Currency Code
Optional
Identifier (ID)
Min 3Max 3

Code (Standard ISO) for country in whose currency the charges are specified

  • C304 is the rated currency.
L1 Loop end
L7
090
Detail > LX Loop > N7 Loop > L7

Tariff Reference

OptionalMax use 1

To reference details of the tariff used to arrive at applicable rates or charge

Example
L7-01
213
Lading Line Item Number
Required
Numeric (N0)
Min 1Max 3

Sequential line number for a lading item

L7-07
59
Freight Class Code
Optional
String (AN)
Min 2Max 5

Code indicating generalized classification that applies to one or more items in the shipment, i.e., class 70, 77.5, etc.

N9
120
Detail > LX Loop > N7 Loop > N9

Reference Identification

OptionalMax use 3

To transmit identifying information as specified by the Reference Identification Qualifier

Example
At least one of Reference Identification (N9-02) or Free-form Description (N9-03) is required
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)
Min 2Max 3

Code qualifying the Reference Identification

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

N9-03
369
Free-form Description
Optional
String (AN)
Min 1Max 45

Free-form descriptive text

H1 Loop
OptionalMax >1
H1
130
Detail > LX Loop > N7 Loop > H1 Loop > H1

Hazardous Material

RequiredMax use 1

To specify information relative to hazardous material

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)
Min 1Max 1

Code which qualifies the Hazardous Material Class Code (209)

H1-04
64
Hazardous Material Description
Optional
String (AN)
Min 2Max 30

Material name, special instructions, and phone number if any

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)
Min 2Max 2

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

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
140
Detail > LX Loop > N7 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

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
N7 Loop end
L0 Loop
RequiredMax >1
L0
150
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

Example
If either Billed/Rated-as Quantity (L0-02) or Billed/Rated-as Qualifier (L0-03) 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 either Lading Quantity (L0-08) or Packaging Form Code (L0-09) is present, then the other is required
L0-01
213
Lading Line Item Number
Required
Numeric (N0)
Min 1Max 3

Sequential line number for a lading item

L0-02
220
Billed/Rated-as Quantity
Optional
Decimal number (R)
Min 1Max 11

Basis for rating (miles, value, volume, etc.); Note: Weight may be defined by either data element 220 or 81

L0-03
221
Billed/Rated-as Qualifier
Optional
Identifier (ID)
Min 2Max 2

Code identifying the type of quantity or value on which the rate or item pricing is based

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

Numeric value of weight

L0-05
187
Weight Qualifier
Required
Identifier (ID)
Min 1Max 2

Code defining the type of 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)
Min 1Max 1

Code identifying the volume unit

L0-08
80
Lading Quantity
Optional
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
Optional
Identifier (ID)
Min 3Max 3

Code for packaging form of the lading quantity

L0-11
188
Weight Unit Code
Required
Identifier (ID)
Min 1Max 1

Code specifying the weight unit

L5
160
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

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
Required
Numeric (N0)
Min 1Max 3

Sequential line number for a lading item

L5-02
79
Lading Description
Required
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)
Min 1Max 1

Code identifying the commodity coding system used for Commodity Code

L5-05
103
Packaging Code
Optional
String (AN)
Min 3Max 5

Code identifying the type of packaging; Part 1: Packaging Form, Part 2: Packaging Material; if the Data Element is used, then Part 1 is always required

L1 Loop
RequiredMax >1
L1
170
Detail > LX Loop > L0 Loop > L1 Loop > L1

Rate and Charges

RequiredMax use 1

To specify rate and charges detail relative to a line item including freight charges, advances, special charges, and entitlements

Example
If either Freight Rate (L1-02) or Rate/Value Qualifier (L1-03) is present, then the other is required
If either Declared Value (L1-14) or Rate/Value Qualifier (L1-15) is present, then the other is required
L1-01
213
Lading Line Item Number
Required
Numeric (N0)
Min 1Max 3

Sequential line number for a lading item

L1-02
60
Freight Rate
Optional
Decimal number (R)
Min 1Max 9

Rate that applies to the specific commodity

L1-03
122
Rate/Value Qualifier
Optional
Identifier (ID)
Min 2Max 2

Code qualifying how to extend charges or interpret value

L1-04
58
Charge
Required
Numeric (N2)
Min 1Max 12

For a line item: freight or special charge; for the total invoice: the total charges -- expressed in the standard monetary denomination for the currency specified

L1-05
191
Advances
Optional
Numeric (N2)
Min 1Max 9

Incidental charges occurring during transportation which are not generally considered to be freight charges (examples - stop charges, diversion and reconsignment, icing) expressed in the standard monetary denomination for the currency specified

L1-06
117
Prepaid Amount
Optional
Numeric (N2)
Min 1Max 9

Money paid at point of origin (usually by shipper) expressed in the standard monetary denomination for the currency specified

L1-07
120
Rate Combination Point Code
Optional
String (AN)
Min 3Max 9

The code denoting the connecting station for a joint rate obtained by combining two or more published rates which are used for the calculation of transportation charges

L1-08
150
Special Charge or Allowance Code
Required
Identifier (ID)
Min 3Max 3

Code identifying type of special charge or allowance

L1-09
121
Rate Class Code
Optional
Identifier (ID)
Min 1Max 3

Code identifying specifically designated class of goods; Note: For international air shipments, see IATA Resolution 600k

L1-13
257
Tariff Application Code
Optional
Identifier (ID)
Min 1Max 1

Code indicating to which traffic a tariff applies

L1-14
74
Declared Value
Optional
Numeric (N2)
Min 2Max 12

Monetary assigned value expressed in the standard monetary denomination for the currency specified

L1-15
122
Rate/Value Qualifier
Optional
Identifier (ID)
Min 2Max 2

Code qualifying how to extend charges or interpret value

C3
180
Detail > LX Loop > L0 Loop > L1 Loop > C3

Currency

OptionalMax use 1

To specify the currency being used in the transaction set

Example
C3-01
100
Currency Code
Required
Identifier (ID)
Min 3Max 3

Code (Standard ISO) for country in whose currency the charges are specified

  • C301 is the billing currency.
C3-02
280
Exchange Rate
Optional
Decimal number (R)
Min 4Max 10

Value to be used as a multiplier conversion factor to convert monetary value from one currency to another

C3-03
100
Currency Code
Optional
Identifier (ID)
Min 3Max 3

Code (Standard ISO) for country in whose currency the charges are specified

  • C303 is the payment currency.
C3-04
100
Currency Code
Optional
Identifier (ID)
Min 3Max 3

Code (Standard ISO) for country in whose currency the charges are specified

  • C304 is the rated currency.
L1 Loop end
L0 Loop end
LX Loop end
Detail end

Summary

L3
010
Summary > 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

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

Numeric value of weight

L3-02
187
Weight Qualifier
Required
Identifier (ID)
Min 1Max 2

Code defining the type of weight

L3-05
58
Charge
Required
Numeric (N2)
Min 1Max 12

For a line item: freight or special charge; for the total invoice: the total charges -- expressed in the standard monetary denomination for the currency specified

  • L305 is the total charges.
L3-09
183
Volume
Optional
Decimal number (R)
Min 1Max 8

Value of volumetric measure

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

Code identifying the volume unit

L3-11
80
Lading Quantity
Required
Numeric (N0)
Min 1Max 7

Number of units (pieces) of the lading commodity

L3-12
188
Weight Unit Code
Required
Identifier (ID)
Min 1Max 1

Code specifying the weight unit

L3-13
171
Tariff Number
Optional
String (AN)
Min 1Max 7

Standard tariff number for the tariff which governs the rates applied to the commodity item(s)

L3-14
74
Declared Value
Optional
Numeric (N2)
Min 2Max 12

Monetary assigned value expressed in the standard monetary denomination for the currency specified

V9
050
Summary > V9

Event Detail

OptionalMax use 10

To specify information about a specific event

Example
If either Quantity (V9-10) or Train Delay Reason Code (V9-11) is present, then the other is required
If Time Code (V9-13) is present, then Time (V9-04) is required
If Standard Point Location Code (V9-15) is present, then Standard Point Location Code (V9-09) is required
V9-01
304
Event Code
Required
Identifier (ID)
Min 3Max 3

Code identifying the event about which a report is made

Optional
String (AN)
Min 1Max 25

Free-form description of event

Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • V903 is the event date.
Optional
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)

  • V904 is the event time.
V9-05
19
City Name
Optional
String (AN)
Min 2Max 30

Free-form text for city name

V9-06
156
State or Province Code
Optional
Identifier (ID)
Min 2Max 2

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

V9-07
26
Country Code
Optional
Identifier (ID)
Min 2Max 3

Code identifying the country

V9-08
641
Status Reason Code
Optional
Identifier (ID)
Min 3Max 3

Code indicating the status reason

V9-09
154
Standard Point Location Code
Optional
Identifier (ID)
Min 6Max 9

Code (Standard Point Location) defined by NMFTA point development group as the official code assigned to a city or point (for ratemaking purposes) within a city

  • V909 is the Standard Point Location Code (SPLC) of the event shown in the V901.
V9-10
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

  • V910 is the length of the time delay expressed in hours.
V9-11
1274
Train Delay Reason Code
Optional
String (AN)
Min 2Max 2

Code specifying reason for train delay

V9-12
61
Free-Form Message
Optional
String (AN)
Min 1Max 30

Free-form information

V9-13
623
Time Code
Optional
Identifier (ID)
Min 2Max 2

Code identifying the time. In accordance with International Standards Organization standard 8601, time can be specified by a + or - and an indication in hours in relation to Universal Time Coordinate (UTC) time; since + is a restricted character, + and - are substituted by P and M in the codes that follow

  • V913 reflects the time zone which the event time reflects.
V9-14
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

  • V914 is the quantity of the fuel in gallons.
V9-15
154
Standard Point Location Code
Optional
Identifier (ID)
Min 6Max 9

Code (Standard Point Location) defined by NMFTA point development group as the official code assigned to a city or point (for ratemaking purposes) within a city

  • V915 is the Standard Point Location Code (SPLC) of the secondary point of the delay indicated in the V911.
V9-16
86
Total Equipment
Optional
Numeric (N0)
Min 1Max 3

Total pieces of equipment

  • V916 is the total number of rail cars associated with the event code in V901.
V9-17
86
Total Equipment
Optional
Numeric (N0)
Min 1Max 3

Total pieces of equipment

  • V917 is the total number of loaded cars associated with the event code in V901.
V9-18
86
Total Equipment
Optional
Numeric (N0)
Min 1Max 3

Total pieces of equipment

  • V918 is the total number of empty cars associated with the event code in V901.
V9-19
81
Weight
Optional
Decimal number (R)
Min 1Max 10

Numeric value of weight

  • V919 is the total Gross Tons of the cars identified in V916. Includes the gross weight of the loads and the tare weight of the empties.
V9-20
82
Length
Optional
Decimal number (R)
Min 1Max 8

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

  • V920 is the total outside foot length of the cars identified in V916, rounded off to the nearest foot.
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.