X12 417 Rail Carrier Waybill Interchange (8030)
This X12 Transaction Set contains the format and establishes the data contents of the Rail Carrier Waybill Interchange Transaction Set (417) for use within the context of an Electronic Data Interchange (EDI) environment. The transaction set can be used to provide the rail carrier with detailed movement instructions pertinent to a rail carrier shipment and is used by all Class I rail carriers in the United States and Canada.
- ~ Segment
- * Element
- > Component
- ^ Repetition
Interchange Control Header
To start and identify an interchange of zero or more functional groups and interchange-related control segments
Code identifying the type of information in the Authorization Information
- 00
- No Authorization Information Present (No Meaningful Information in I02)
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)
Code identifying the type of information in the Security Information
- 00
- No Security Information Present (No Meaningful Information in I04)
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)
Code indicating the system/method of code structure used to designate the sender or receiver ID element being qualified
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
Code indicating the system/method of code structure used to designate the sender or receiver ID element being qualified
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
Type is not applicable; the repetition separator is a delimiter and not a data element; this field provides the delimiter used to separate repeated occurrences of a simple data element or a composite data structure; this value must be different than the data element separator, component element separator, and the segment terminator
- ^
- Repetition Separator
Code specifying the version number of the interchange control segments, the version of the data elements within the control segments, and the code values within those data elements.
- 00803
- 00803 Standards Approved for Publication by ASC X12 Procedures Review Board through December 2021
A control number assigned by the interchange sender
Code indicating sender's request for an interchange acknowledgment
- 0
- No Interchange Acknowledgment Requested
- 1
- Interchange Acknowledgment Requested (TA1)
- 2
- Interchange Acknowledgment Requested only when Interchange is "Rejected Because Of Errors"
- 3
- Interchange Acknowledgment Requested only when Interchange is "Rejected Because Of Errors" or "Accepted but Errors are Noted"
Code indicating whether data enclosed by this interchange envelope is test, production or information
- I
- Information
- P
- Production Data
- T
- Test Data
Type is not applicable; the component data 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
To indicate the beginning of a functional group and to provide control information
Code identifying a group of application related transaction sets
- WB
- Rail Carrier Waybill Interchange (417)
Code identifying party sending transmission; codes agreed to by trading partners
Code identifying party receiving transmission; codes agreed to by trading partners
Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year
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)
Assigned number originated and maintained by the sender
Code identifying the issuer of the standard; this code is used in conjunction with Data Element 480
- T
- Transportation Data Coordinating Committee (TDCC)
- X
- Accredited Standards Committee X12
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
- 008030
- 008030 Standards Approved for Publication by ASC X12 Procedures Review Board through December 2021
Heading
Transaction Set Header
To indicate the start of a transaction set and to assign a control number
Code identifying a Transaction Set
- The transaction set identifier (ST01) is used by the translation routines of the interchange partners to select the appropriate transaction set definition (e.g., 810 selects the Invoice Transaction Set).
- 417
- Rail Carrier Waybill Interchange
Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set
Beginning Segment for Data Correction or Change
To transmit identifying numbers, dates, and other basic data relating to the transaction set
Example: ZC11257CN12345611111120230710COCNR
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)
Prefix or alphabetic part of an equipment unit's identifying number
- For any rail shipment, ZC102 is required.
Must be identical to the previous shipping instructions.
Sequencing or serial part of an equipment unit's identifying number (pure numeric form for equipment number is preferred)
Must be identical to the previous shipping instructions.
Sender's assigned number for referenced transaction set
Waybill number.
Date of referenced transaction set expressed in format CCYYMMDD where CC represents the first two digits of the calendar year
Code indicating that the transaction set contains information which corrects previous information
- CA
- Cancelled Bill
- CO
- Correction
- D1
- Diversion or Reconsignment
Code identifying the Standard Carrier Alpha Code
SCAC of origin roadhaul carrier.
Code specifying the method or type of transportation for the shipment
- If ZC108 is "R" (Rail), then ZC102 is required.
- R
- Rail
- X
- Intermodal (Piggyback)
General Shipment Information
To transmit identification numbers and other basic shipment data
- BX05 contains the Standard Carrier Alpha Code (SCAC) of the original roadhaul carrier receiving the shipment.
Example: BX00RPP1257CNLBN****N
Code identifying purpose of transaction set
- 00
- Original
Code specifying the method or type of transportation for the shipment
- R
- Rail
Code identifying payment terms for transportation charges
- CC
- Collect
- PP
- Prepaid (by Seller)
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)
Code identifying the Standard Carrier Alpha Code
- CN
- CN Rail
Code specifying relationship of this shipment with respect to other shipments given to the carrier at the same time
- B
- Bill of Lading for Individual Shipment
Code indicating applicability of section seven option (if not transmitted assume not in effect)
- N
- Not in Effect
- S
- In Effect
Code indicating that the the shipper requests that the carrier inhibit origin identification information from the invoice transaction sets and/or rate and charges from waybill documents and transaction sets when shipment moves under confidential contract rates
- N
- Not Applicable
Rail Shipment Information
To transmit rail-specific shipment data
Example: BNX*R**S
Code indicating the way by which weights are obtained for a particular shipment
- A
- Shipper's Weight Agreement
- N
- No Wt. Req., Ship. Moving on Contract or per car rate
- R
- Carrier Scale Weight
Extended Reference Information
To transmit identifying information as specified by the Reference Identification Qualifier
At least one N9 containing a Bill of Lading number must be included. This number will be included on all other documents such as Freight Invoice and Remittance/Payment.
Example: N9BM1257*202307101336*ET
Code identifying the Reference Identification
- BM
- Bill of Lading Number
Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier
Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year
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)
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
- N906 reflects the time zone which the time reflects.
- AT
- Atlantic Time
- CT
- Central Time
- ET
- Eastern Time
- MT
- Mountain Time
- PT
- Pacific Time
Date/Time Reference
To specify pertinent dates and times
Example: DTM168202307101336ET
Code specifying type of date or time, or both date and time
- 168
- Release
Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year
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)
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
- AT
- Atlantic Time
- CT
- Central Time
- ET
- Eastern Time
- MT
- Mountain Time
- PT
- Pacific Time
Equipment Details
To identify the equipment
Example: N7CN123456213360N66700*RR6711M186128*C214
Prefix or alphabetic part of an equipment unit's identifying number
- N701 is mandatory for rail transactions.
Sequencing or serial part of an equipment unit's identifying number (pure numeric form for equipment number is preferred)
Code specifying the type of weight
- E
- Estimated Net Weight
- N
- Actual Net Weight
Code identifying type of equipment used for shipment
- RR
- Rail Car
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)
Vertical dimension of an object measured when the object is in the upright position
- N720 and N721 are expressed in inches.
Shorter measurement of the two horizontal dimensions measured with the object in the upright position
Code specifying type of rail car or intermodal equipment type and its general characteristics
AAR Equipment Type code.
Seal Numbers
To record seal numbers used and the organization that applied the seals
Example: M7*12345
Waybill Reference
To identify the waybill and to specify the equipment used and the destination details
Example: N811111120230710
Origin Station
To identify the rail origin of the shipment
Indicates the origin of the shipment, the point from which it is shipped. The spelling should be in accordance with that listed in the Standard Point Location Code (SPLC) standard available from the National Motor Freight Tariff Association (USA) or the National Transportation Agency (Canada). CN can provide spellings for your stations.
Example: F9070112WATSONSK*****071511S0K4V0
Code specifying the Freight Station Accounting code assigned for AAR Managed Codes for Locations
Free-form text for city name
- F902 is the origin station for movement.
Code specifying the Standard State/Province as defined by appropriate government agency
Code specifying the Standard Point Location code defined by National Motor Freight Tariff Association (NMFTA) or the Canadian Transportation Agency (CTA) point development group as the official code assigned to a city or point (for ratemaking purposes) within a city
- F908 is the Standard Point Location Code (SPLC) for the city named in the F902.
Code specifying international postal zone code excluding punctuation and blanks (zip code for United States)
- F909 is the postal code for the city named in the F902.
Destination Station
To identify the rail destination of the shipment
Indicates the destination of the shipment, the point at which it will be unloaded or where the transportation responsibility reverts to the consignee. The spelling should be in accordance with that listed in the Standard Point Location Code (SPLC) standard available from the National Motor Freight Tariff Association (USA) or the National Transportation Agency (Canada). CN can provide spellings for your stations.
Example: D9093390VANCOUVERBC*****0093900V5T1E1
Code specifying the Freight Station Accounting code assigned for AAR Managed Codes for Locations
Free-form text for city name
- D902 is the destination station of movement.
Code specifying the Standard State/Province as defined by appropriate government agency
Code specifying the Standard Point Location code defined by National Motor Freight Tariff Association (NMFTA) or the Canadian Transportation Agency (CTA) point development group as the official code assigned to a city or point (for ratemaking purposes) within a city
- D908 is the Standard Point Location Code (SPLC) for the city named in the D902.
Code specifying international postal zone code excluding punctuation and blanks (zip code for United States)
- D909 is the postal code for the city names in the D902.
Party Identification
To identify a party by type of organization, name, and code
Associated to the N3 and N4 segments below. N1, N3 and N4 segments are required for the Consignee and any other Additional Parties to the shipment.
Examples:
N1SHGENERIC CARLOAD INCC51111111111111
N3123 FIRST ROAD
N4WATSONSKS0K 4V0CA
N1CNGENERIC CONSIGNEE COC52222222222222
N312 SMITH STREET
N4VANCOUVERBCV5K 1P7CA
N1PFGENERIC CARLOAD INCC51111111111111
N3123 FIRST ROAD
N4WATSONSKS0K 4V0*CA
Code identifying an organizational entity, a physical location, property or an individual
- C1
- In Care Of Party no. 1
- CN
- Consignee
- PF
- Party to Receive Freight Bill
- SH
- Shipper
Code specifying the system/method of code structure used for Identification Code (67)
- C5
- Customer Identification File
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.
This field should contain the full 13-character CIF format including leading zeros.
Party Location
To specify the location of the named party
Geographic Location
To specify the geographic place of the named party
Free-form text for city name
- A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
Code specifying the Standard State/Province as defined by appropriate government agency
Code specifying international postal zone code excluding punctuation and blanks (zip code for United States)
- N403 contains the postal code in an unstructured format. N408 contains the postal code in a structured format. When a postal code data field is used, the parties shall agree as to which data element (N403 or N408) shall be used in the transaction set.
Administrative Communications Contact
To identify a person or office to whom administrative communications should be directed
Example: PERICCONTACT NAMETE123-123-1234
Code identifying the major duty or responsibility of the person or group named
- IC
- Information Contact
Code identifying the type of communication number
- EM
- Electronic Mail
- TE
- Telephone
Complete communications number including country or area code when applicable
Route Information
To specify carrier and routing sequences and details
One R2 segment for each railroad in the route. CN can provide route information for your shipments. (i.e.: Railroad SCAC's and junctions)
Example: R2CNS****R
Code identifying the Standard Carrier Alpha Code
- CN
- Canadian National etc.
Code specifying the relationship of a carrier to a specific shipment movement
- S
- Origin Carrier, Shipper's Routing (Rail)
Code specifying the method or type of transportation for the shipment
- R
- Rail
Transaction Set Line Number
To reference a line number in a transaction set
Example: LX*1
Number assigned for differentiation within a transaction set
Description, Marks and Numbers
To specify the line item in terms of description, quantity, packaging, and marks and numbers
CN can provide Standard Transportation Commodity Codes (STCC) for your commodities. The commodity code is required only on the first L5 segment. Additional L5 segments can be used to provide additional description of lading.
Example: L51WALLBOARD3275440T
Sequential line number for a lading item
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.
Code describing a commodity or group of commodities
7-digit Standard Transportation Commodity Code (STCC).
Code identifying the commodity coding system used for Commodity Code
- T
- Standard Transportation Commodity Code (STCC)
Line Item - Quantity and Weight
To specify quantity, weight, volume, and type of service for a line item including applicable "quantity/rate-as" data
Example: L01213360N1*CLD
Sequential line number for a lading item
Code specifying the type of weight
- E
- Estimated Net Weight
- N
- Actual Net Weight
Number of units (pieces) of the lading commodity
- L008 is the number of handling units of the line item tendered to the carrier.
Code specifying the packaging form of the lading quantity
- CLD
- Car Load, Rail
Transaction Set Trailer
To indicate the end of the transaction set and provide the count of the transmitted segments (including the beginning (ST) and ending (SE) segments)
Total number of segments included in a transaction set including ST and SE segments
Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set
Functional Group Trailer
To indicate the end of a functional group and to provide control information
Total number of transaction sets included in the functional group or interchange (transmission) group terminated by the trailer containing this data element
Assigned number originated and maintained by the sender
Interchange Control Trailer
To define the end of an interchange of zero or more functional groups and interchange-related control segments
sample 1
GS*WB*CN*GENERIC*20230710*1336*98826*X*008030
ST*417*988260001
ZC1*1257*CN*123456*111111*20230710*CO*CN*R
BX*00*R*PP*1257*CN*L*B*N****N
BNX*R**S
N9*BM*1257**20230710*1336*ET
DTM*168*20230710*1336*ET
N7*CN*123456*213360*N*66700******RR****6711*M****186*128***C214
M7*12345
N8*111111*20230710
F9*70112*WATSON*SK*****071511*S0K4V0
D9*93390*VANCOUVER*BC*****0093900*V5T1E1
N1*SH*GENERIC CARLOAD INC*C5*1111111111111
N3*123 FIRST ROAD
N4*WATSON*SK*S0K 4V0*CA
PER*IC*CONTACT NAME*TE*123-123-1234
N1*CN*GENERIC CONSIGNEE CO*C5*2222222222222
N3*12 SMITH STREET
N4*VANCOUVER*BC*V5K 1P7*CA
N1*PF*GENERIC CARLOAD INC*C5*1111111111111
N3*123 FIRST ROAD
N4*WATSON*SK*S0K 4V0*CA
R2*CN*S****R
LX*1
L5*1*WALLBOARD*3275440*T
L0*1***213360*N***1*CLD
SE*26*988260001
GE*1*98826
IEA*1*006298413
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.