X12 310 Freight Receipt and Invoice (Ocean)
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.
- ~ Segment
- * Element
- > Component
- None included
Interchange Control Header
To start and identify an interchange of zero or more functional groups and interchange-related control segments
Code to identify 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 to identify 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)
Qualifier to designate 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
Qualifier to designate 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
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
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
A control number assigned by the interchange sender
Code sent by the sender to request an interchange acknowledgment (TA1)
- 0
- No Acknowledgment Requested
- 1
- Interchange Acknowledgment Requested
Code to indicate 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 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
- IO
- Ocean Shipment Billing Details (310, 312, 980)
Code identifying party sending transmission; codes agreed to by trading partners
Code identifying party receiving transmission. Codes agreed to by trading partners
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 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
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
Transaction Set Header
To indicate the start of a transaction set and to assign a control number
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)
Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set
Beginning Segment for Carrier's Invoice
To transmit basic data relating to the carrier's invoice
Example:
B3B12312345645645678MX20140725*3062220140802139OOLU20140713PP~
Code defining relationship of this shipment with respect to other shipments given to the carrier at the same time
- 2
- Sea Waybill
- B
- Bill of Lading for Individual Shipment
Identifying number assigned by issuer
BL Number.
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 payment terms for transportation charges
- CC
- Collect
- MX
- Mixed
For rated Bill with mixed charges or non-rated Bill, MX will be used.
- PP
- Prepaid (by Seller)
Date expressed as CCYYMMDD
- B306 is the billing date.
On-board date in GMT.
Total charges to be paid by the receiver of this transaction set expressed in the standard monetary denomination for the currency specified
Total amount of Prepaid and Collect charges within the transaction.
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.
Code specifying type of date or time, or both date and time
- 139
- Estimated
- 140
- Actual
Standard Carrier Alpha Code
CargoSmart will send carrier's SCAC.
Date expressed as CCYYMMDD
BL Issue Date in GMT.
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
Set Purpose
To allow for positive identification of transaction set purpose
Example: B2A*00~
Code identifying purpose of transaction set
- 00
- Original
- 01
- Cancellation
- 05
- Replace
Reference Identification
To transmit identifying information as specified by the Reference Identification Qualifier
Examples:
N9BN123123456~
N9CTC325V3~
Code qualifying the Reference Identification
- BM
- Bill of Lading Number
- BN
- Booking Number
- CR
- Customer Reference Number
- CT
- Contract Number
- FI
- File Identifier
- FN
- Forwarder's/Agent's Reference Number
- IK
- Invoice Number
- PO
- Purchase Order Number
- RF
- Export Reference Number
- SI
- Shipper's Identifying Number for Shipment (SID)
Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier
Vessel Identification
To provide vessel details and voyage number
For more than 2 ocean legs, vessel information for first and last ocean leg should be provided.
Example: V19367205OOCL ITALY001EastOOLUL~
Name of ship as documented in "Lloyd's Register of Ships"
Identifying designator for the particular flight or voyage on which the cargo travels
Standard Carrier Alpha Code
- V105 identifies the ocean carrier.
Code specifying vessel code source
- C
- Ship's Radio Call Signal
- L
- Lloyd's Register of Shipping
Name
To identify a party by type of organization, name, and code
Cargosmart will always provide at least one legal party.
Example: N1SHShipper Name251234516000~
Code identifying an organizational entity, a physical location, property or an individual
- CA
- Carrier
- CN
- Consignee
- FW
- Forwarder
- N1
- Notify Party no. 1
Notify Party.
- N2
- Notify Party no. 2
1st additional Notify Party.
- SH
- Shipper
Free-form name
This element is carrier SCAC code when N1_01 = CA.
Code designating the system/method of code structure used for Identification Code (67)
- 25
- Carrier's Customer Code
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.
Address Information
To specify the location of the named party
Example: N3*Shipper Address Shipper Address~
Geographic Location
To specify the geographic place of the named party
Example: N4Katunayake*LKUN*LKKAT~
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 (Standard State/Province) as defined by appropriate government agency
- N402 is required only if city name (N401) is in the U.S. or Canada.
Code defining international postal zone code excluding punctuation and blanks (zip code for United States)
Code identifying type of location
- UN
- United Nations Location Code (UNLOCODE)
Contact
To identify a person or office to whom communications should be directed
Please refer to G6101_366 for party type association with N101_98.
Example: G61CNContact NameTE852-21984563~
Code identifying the major duty or responsibility of the person or group named
- CA
- Customer Contact Granting Appointment
- CN
- General Contact
- FW
- N1
- N2
- SH
- Shipper Contact
Code identifying the type of communication number
- G6103 qualifies G6104.
- EM
- Electronic Mail
- TE
- Telephone
Complete communications number including country or area code when applicable
Port or Terminal
Contractual or operational port or point relevant to the movement of the cargo
CargoSmart will send UN/ECE Location Code to present location
Example: R4DUNUSLGBLONG BEACHUS**CA~
Code defining function performed at the port or terminal with respect to a shipment
- D
- Port of Discharge (Operational)
- E
- Place of Delivery (Contractual)
- L
- Port of Loading (Operational)
- R
- Place of Receipt (Contractual)
Code identifying type of location
- UN
- United Nations Location Code (UNLOCODE)
Free-form name for the place at which an offshore carrier originates or terminates (by transshipment or otherwise) its actual ocean carriage of property
Code (Standard State/Province) as defined by appropriate government agency
Actual
To specify pertinent dates and times
All in GMT timezone.
Example: DTM36920140803*1700~
Code specifying type of date or time, or both date and time
- 140
- Actual
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 specifying type of date or time, or both date and time
- 139
- Estimated
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)
Route Information
To specify carrier and routing sequences and details
Example: R2OOLUO**********03~
Standard Carrier Alpha Code
CargoSmart will send carrier's SCAC.
Code describing the relationship of a carrier to a specific shipment movement
- O
- Origin Carrier (Air, Motor, or Ocean)
Code specifying extent of transportation service requested
- 02
- LCL/LCL
- 03
- FCL/FCL
- 04
- FCL/LCL
- 05
- LCL/FCL
Certifications and Clauses
To specify applicable certifications and clauses
Example: C8*20No Shipper's Export Declaration Required~
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
Free-form description of commercial invoice certification/clause
Certifications Clauses Continuation
To specify additional applicable certifications and clauses
Example: C8C*No Shipper's Export Declaration Required~
Free-form description of commercial invoice certification/clause
Free-form description of commercial invoice certification/clause
Free-form description of commercial invoice certification/clause
Detail
Assigned Number
To reference a line number in a transaction set
Example: LX*1~
Number assigned for differentiation within a transaction set
Equipment Details
To identify the equipment
Only 1 container information will be presented in each LX. For multiple containers, different LX Loop should be used.
Example: N7OOLU90424015000G*********K5*22G0~
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)
Numeric value of weight
Decimal point should be explicitly defined and excluded from the number of characters counted.
Number which designates the check digit applied to a piece of equipment
Code identifying equipment type
Refer to Appendix for full list from CargoSmart. For customized code list, please contact CargoSmart for more details.
Quantity
To specify quantity information
Example: QTY3949~
Seal Numbers
To record seal numbers used and the organization that applied the seals
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: M7OOLM123449***CA~
Code identifying an organizational entity, a physical location, property or an individual
- M705 indicates the name of the organization which applied the seal(s).
Required for carrier and shipper as seal issuer.
- CA
- Carrier
- SH
- Shipper
Equipment and Temperature
To relate equipment type and required temperatures
Example: W09CZ0CE***E~
Code identifying type of equipment used for shipment
- CZ
- Refrigerated Container
Temperature
- W0902 is the minimum allowable temperature condition for shipment; (the qualifying temperature scale is specified in W0903).
Negative sign and decimal point should be explicitly defined and excluded from the number of characters counted.
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
Code describing the setting on the air vents on ocean-type containers
- A
- Vent 25% Open
- B
- Vent 50% Open
- C
- Vent 75% Open
- D
- Vent 100% Open
- E
- Closed
Percent expressed as 0 to 100
- W0908 is the humidity percentage.
Numeric value of quantity
- W0909 is the number of air exchanges per hour.
Rate and Charges
To specify rate and charges detail relative to a line item including freight charges, advances, special charges, and entitlements
This section will be provided subject to carrier capability for containerized freight information.
Example: L113022PA302200COFEOcean Freight~
Sequential line number for a lading item
Code qualifying how to extend charges or interpret value
- PA
- Per Container
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
Collect Charge.
Money paid at point of origin (usually by shipper) expressed in the standard monetary denomination for the currency specified
Prepaid Charge.
Code identifying type of special charge or allowance
Code defining method of payment
- E
- Collect
- P
- Prepaid
Identification of special charge; this data element is used whenever an applicable code cannot be found in data element 150
Currency
To specify the currency being used in the transaction set
Example: C3USD0001~
Code (Standard ISO) for country in whose currency the charges are specified
- C301 is the billing currency.
Value to be used as a multiplier conversion factor to convert monetary value from one currency to another
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: L01992.98G3.87X49*CTNK~
Sequential line number for a lading item
Numeric value of weight
Decimal point should be explicitly defined and excluded from the number of characters counted.
Code defining the type of weight
- G
- Gross Weight
- N
- Actual Net Weight
Value of volumetric measure
Decimal point should be explicitly defined and excluded from the number of characters counted.
Code identifying the volume unit
- E
- Cubic Feet
- X
- Cubic Meters
Number of units (pieces) of the lading commodity
- L008 is the number of handling units of the line item tendered to the carrier.
Code for packaging form of the lading quantity
Refer to Appendix for full list from CargoSmart. For customized code list,
please contact CargoSmart for more details.
Description, Marks and Numbers
To specify the line item in terms of description, quantity, packaging, and marks and numbers
Example: L51COTTON WOVEN SHORTS****P.O. NO :~
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.
Marks and numbers used to identify a shipment or parts of a shipment
Hazardous Material
To specify information relative to hazardous material
H1 Loop will be provided for Dangerous Cargo.
Example: H112633IPAINT604-986-4617**15FA*III~
Code relating to hazardous material code qualifier for regulated hazardous materials
Code specifying the kind of hazard for a material
Code which qualifies the Hazardous Material Class Code (209)
- I
- Intergovernmental Maritime Organization (IMO) Code
Material name, special instructions, and phone number if any
Phone number and name of person or department to contact in case of emergency
The flashpoint temperature for hazardous material
- H107 is the lowest temperature for hazardous materials.
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
Code indicating degree of danger in terms of Roman number I, II or III
Additional Hazardous Material Description
To specify free-form hazardous material descriptive data in addition to the information provided in the H1 segment
Example: H2*PAINT~
Summary
Total Weight and Charges
To specify the total shipment in terms of weight, volume, rates, charges, advances, and prepaid amounts applicable to one or more line items
Example: L32085G34940025X12K~
Code defining the type of weight
- G
- Gross Weight
- N
- Actual Net Weight
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.
Sum of Collect charges.
Money paid at point of origin (usually by shipper) expressed in the standard monetary denomination for the currency specified
Sum of Prepaid charges.
Code identifying the volume unit
- E
- Cubic Feet
- X
- Cubic Meters
Number of units (pieces) of the lading commodity
Rate and Charges
To specify rate and charges detail relative to a line item including freight charges, advances, special charges, and entitlements
If containerized freights are provided in L1 segments under N7 loop, only non-containerized charges will be supplemented. Otherwise, all charges will be provided here.
Example: L113022LS302200DOCCDocument Fee~
Sequential line number for a lading item
Code qualifying how to extend charges or interpret value
- LS
- Lump Sum
- PA
- Per Container
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
Collect Charge.
Money paid at point of origin (usually by shipper) expressed in the standard monetary denomination for the currency specified
Prepaid Charge.
Code identifying type of special charge or allowance
Code defining method of payment
- E
- Collect
- P
- Prepaid
Identification of special charge; this data element is used whenever an applicable code cannot be found in data element 150
Currency
To specify the currency being used in the transaction set
Example: C3USD0001~
Code (Standard ISO) for country in whose currency the charges are specified
- C301 is the billing currency.
Value to be used as a multiplier conversion factor to convert monetary value from one currency to another
Remarks
To transmit information in a free-form format for comment or special instruction
Example:
K1*FCL/FCL Shippers Weight, Load,*Stowage and Count Non Negotia~
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
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.