310 – Freight Receipt and Invoice

What is an EDI 310?

EDI 310, also referred to as a Freight Receipt and Invoice (Ocean), is an electronic document used to request payment for ocean freight shipments. It functions similarly to the EDI 210 Motor Carrier Freight Details and Invoice, which is used for freight shipments, and the more general EDI 810 Invoice.

Specifications and Key Data Elements:

  • Purchase Order Number(s) 
  • Shipment and invoice number 
  • Item quantities, weights, dimensions, and descriptions 
  • Delivery details 
  • Ship from/to addresses 
  • Total amount due 
  • Payment terms 

M = Mandatory, O = Optional, X = Not Needed

ElementRefDescriptionElement IDTypeReqFixed ValuesSample SegmentComments
Start Header LOOP
ST Transaction Set HeaderST01Transaction Set ID Code143ST3100001~

(Maximum Use = 1)
ST02Transaction Set Control Number329
B3 Beginning Segment for Carrier DocumentsB301Shipment Qualifier147
B3*B*123456*987654*TP**20140912*325600****ABCD*20140910~

B3**1300017544*1091*CC**20230329*770000**20230324*035*KHNN*20230301**FOB~  (KN)
B3**FLEX-572799-2**CC**20190917*32100****FLXT**OT*FOB  (FLX)

(Maximum Use = 1)		Code specifying relationship of this shipment with respect to other shipments given to the carrier at the same time.
B302Invoice Number76Identifying number assigned by issuer
B303Shipment Identification Number145Identification 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).
B304Shipment Method of Payment146Code identifying payment terms for transportation charges.

CC = Collect
B305Weight Unit Code188Code specifying the weight unit
B306Invoice Date373Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year.
B307Net Amount Due193Total charges to be paid by the receiver of this transaction set expressed in the standard monetary denomination for the currency specified.
B308Correction Indicator


Code indicating that the transaction set contains information which corrects previous information.


Not required for Original Invoices.		202CodeList Summary


BD
– Balance Due Billing

Only to be used for short paid or supplemental invoice.

AD
– Adjustment of Previous Freight Bill Charges
B309Delivery Date32Date for delivery of cargo to final consignee or to next mode expressed in format CCYYMMDD, where CC represents the first two digits of the calendar year.

If either B3-09 or B3-10 is present, then the other is required.

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.
B310Date/Time Qualifier374Code specifying type of date or time, or both date and time.


035

Delivered
B311Standard Carrier Alpha Code140Carrier SCAC
B312Date373Payment Due Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year.
B313Tariff Service375Code specifying the types of services for rating purposes.

Code Name
DD Door-to-Door
DO Door-to-Terminal
OD Terminal-to-Door
OT Terminal-to-Terminal
“
B314Transportation Terms Code335Code 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.


EXW
Ex Works

FOB
Free on Board
B2A Set PurposeB2A01Transaction Set Purpose Code353B2A00ZZ~

(Maximum Use = 1)		Code identifying purpose of transaction set


Code Name

00 Original
01 Cancellation
04 Change
B2A02Application Type346Code identifying an application.


BN – Booking Level Invoice
ZZ – Booking Invoice at the Container Level
N9 Reference IdentificationN901Reference Identification Qualifier128
N9*BM*BL123456~
N9*OC*APL123456X~

(Maximum Use = 15)		Code identifying the Reference Identification:

BM = Bill of Lading Number

OB = Ocean Bill of Lading

BN
= Booking Number
MB = Master Bill of Lading
CR = Customer Reference Number

X9
= TM Booking Number

OC
= Ocean Container

FN
= Forwarder’s Reference

VX
= VAT Number

EQ
= Equipment Number


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

At least one of N9-02 or N9-03 is required
N903Free-Form Description369Not Used
N904Date373Not Used
N905Time337Not Used
N906Time Code623Not Used
N907Reference IdentifierC040Not Used
V1 Vessel IdentificationV101Vessel Code

Code identifying vessel
At least one of V1-01 or V1-02 is required		V19199268OOCL SAN FRANCISCOHK164E***LO

V19456769MAERSK EMDEN926NMAEUL*S

(Maximum Use = 2)		Not Used
V102Vessel Name

Name of ship as documented in “Lloyd’s Register of Ships”.		No Special Characters
Main Vessel/Mother Vessel
V103Country Code


Code identifying the country.

V103 is the code identifying the country in which the ship (vessel) is registered.		26Not Used
V104Flight/Voyage NumberIdentifying designator for the particular flight or voyage on which the cargo travels
V105Standard Carrier Alpha CodeCode identifying the Standard Carrier Alpha Code.

V105 identifies the ocean carrier.

No Special Characters

Main Voyage/Mother Voyage
V106Vessel Requirement Code249Not Used
V107Vessel Type Code854Not Used
V108Vessel Code QualifierCode specifying vessel code source

L = Lloyd’s Register of Shipping

If V1-08 is present, then V1-01 is required
V109Transportation Methods/Type Code91Not Used
C3 CurrencyC301Currency Code100C3*USD~

(Maximum Use = 1)		Code specifying the Standard ISO code for country in whose currency the charges are specified.

C301 is the billing currency.
C302Exchange RateNot Used
Y2 Container DetailsY201Number of Shipping Containers95Y2*1***40HC~

(Maximum Use = 1)
Y202Container Type Request Code


Code indicating type of container equipment requested.

R – Containers only		78Not Used
Y203Type of Service Code


Code specifying extent of transportation service requested.		56Not Used
Y204Equipment Type Code


Code identifying equipment type.		24Not Used
LOOP ID N1
N1 NameN101Entity Identifier Code98N1BTTHE BRICK~

N1BTThe Brick Warehouse LpZZB803344~		Code identifying an organizational entity, a physical location, property or an individual

BT = Bill To (The Brick or Leon’s)
N102Name93Free form name.

At least one of N1-02 or N1-03 is required

If N1-01 = BT
, then this element will contain either “The Brick Warehouse Lp” or “Leon’s Furniture Ltd.”.  N3 & N4 will not be populated.
N103Identification Code Qualifier66Code specifying the system/method of code structure used for Identification Code (67)

If either N1-03 or N1-04 is present, then the other is required.


93
– Code assigned by the organization originating the transaction set


ZZ
– Mutually defined
N104Identification Code67Code 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.
N105Entity Relationship CodeNot Used
N106Entity Identifier CodeNot Used
N2 NameN201Name93Not Used
N202Name93Not Used
N3 Address InformationN301Address Information166
N302Address Information166
N4 Geographic LocationN401City Name19
N402State of Province Code156Standard State/Province Code as defined by appropriate government agency.
N402 is required only if City Name (N401) is in the U.S. or Canada.
N403Postal Code116Code defining international postal zone code excluding punctuation and blanks. Postal Code if Canada.
N404Country Code26Code identifying the country (ISO Code)
N405Location Qualifier309Not Used
N406Location Qualifier310Not Used
END LOOP N1
LOOP ID R4 
R4 Port or TerminalR401Port or Terminal Function Code115
R4*D*UN*CAVAN*Vancouver*CA~

R4*R*UN*CNYTN*Yantian*CN~

(Maximum Use = 1)		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
R402Location Identifier309Code which identifies a specific location

UN = UNLOCODE
R403Location Identifier310Code which identifies a specific location
R404City or Port Name114Free-form name for the place at which an offshore carrier originates or
terminates (by transshipment or otherwise) its actual ocean carriage of property
R405Country Code262 digit ISO
R406Terminal Name174Not Used
R407Pier Number113Not Used
R408State or Province Code156State Code as defined by appropriate government agency
DTM Date/Time ReferenceDTM01Date/Time Qualifier374DTM14020220906*1159~

(Maximum Use = 15)		Code Name


139
– Estimated

140
– Actual

369
– Estimated Departure Date

370
– Actual Departure Date from Origin

371
– Estimated Arrival Date

372
– Actual Arrival Date at Destination
DTM02Date expressed as CCYYMMDD373Date
DTM03Time337Time expressed in HHMM format
DTM04Time Code623Not Used
DTM05Date Time Period Format Qualifier1250Not Used
DTM06
Date Time Period 		1251Not Used
END Loop R4
R2 Route InformationR201Standard Carrier Alpha Code140R2CMDUO~

(Maximum Use = 13)		Ocean Carrier SCAC
R202Routing Sequence Code


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


O
– Origin Carrier (Air, Motor or Ocean)		133
K1 RemarksK101Free-form Information61(Maximum Use = 12)30 long
K102Free-form Information6130 long
H3 Special Handling InstructionsH301Special Handling Code

Code specifying special transportation handling instructions.
CF Container, Factory Load		152H3*CF~

(Maximum Use = 1)
Stop Header LOOP 
LOOP ID LX
LX – Assigned NumberLX01Assigned Number554
LX*1~

(Maximum Use = 1)		Number assigned for differentiation within a transaction set.
LOOP ID N7
N7 Equipment DetailsN701Equipment Initial206N7*123456*APL*10000*G*9999**40*E*T2B***20*A*L*X*HH*10*1234~
N7*OOCU*7908602*6960*G****66.3*X**S1******K**HH***45GP~
N7*FCIU*8608682*5640*G****69*X**S1******K**PP***45GP~
N7*SUSU*8605790*3161.3*G****45*X**CN******K*****45GP**FCL
N7*TCNU*7048887*2254*G****67.5*X**S1******K**PP***45GP~

(Maximum Use = 1)		Prefix or alphabetic part of an equipment unit’s identifying number.
N702Equipment number207Sequencing or serial part of an equipment unit’s identifying number (Pure numeric form for equipment number is preferred).


Should
contain Numeric Characters only. 

No spaces or dashes
N703Weight81Numeric value of weight.

If either N7-03 or N7-04 is present, then the other is required.
N704Weight Qualifier187Code specifying the type of weight.

G  Gross Weight
N705Tare Weight167Not Used
N706Weight Allowance232Not Used
N707Dunnage205Not Used
N708Volume183Value of volumetric measure.

If either N7-08 or N7-09 is present, then the other is required
N709Volume Unit Qualifier184Code identifying the volume unit

E
– Cubic Feet

X
–  Cubic Meters
N710Ownership Code102Not Used
N711Equipment Description Code40Code identifying type of equipment used for shipment.
N712Standard Carrier Alpha Code140Not Used
N713Temperature Control319Not Used
N714Position219Not Used
N715Equipment Length567Not Used
N716Tare Qualifier Code571Not Used
N717Weight Unit Code188Weight Unit Code
N718Equipment Number Check Digit


Number which designates the check digit applied to a piece of equipment		761Check digit of container
(If check digit is included in the value of N7-02 above, OMIT)
N719Type of Service Code53Code specifying extent of transportation service requested

HH
  House-to-House
HP  House-to-Pier
PH  Pier-to-House

PP
  Pier-to-Pier
N720Height65Not Used
N721Width189Not Used
N722Equipment Type25Code identifying equipment type

See Tab ISO Equipment Types for acceptable values
N723Standard Carrier Alpha Code140Not Used
N724Car Type Code301Flexport uses
LCL – Less Than Container Load
FCL – Full Container Load
QTY QuantityQTY01Quantity Qualifier


Code specifying the type of quantity		67339
= Shipped Quantity
QTY02Quantity380“QTY392105~
QTY39120*CH~”

(Maximum Use = 1)		Numeric value of quantity (Whole Number).

At least one of QTY-02 or QTY-04 is required.
Only one of QTY-02 or QTY-04 may be present.
QTY03-01Composite Unit of Measure
 
The structure of composite data element C001 permits reporting a unit of measurement that does not appear in the DE355 code list, but is composed of entries from the DE355 code list. For example, if DE355 does not contain a code for “pounds per square foot,” but does contain codes for “pound” and “foot,” the composite data element C001 permits the reporting of “pounds per square foot” without requesting an addition to DE355. Therefore, use of this composite data element structure reduces the need for additional codes in DE355.

For codes already existing in DE355, composite data element C001 equates to DE355 and no subelement delimiter is used.


Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken.		C001Not Used
CH = Container
Flex uses CT – Carton
PCS – Pieces
QTY04Free-Form Message61Not Used
Nested LOOP ID L1 in Loop N7(Maximum Use = 20)
END Nested LOOP ID L1 in Loop N7
END Nested LOOP ID L1 in Loop N7
N9 Reference IdentificationN901Reference Identification Qualifier128
N9*OL*123456~
N9*OL*1247~

(Maximum Use = 3)		Code identifying the Reference Identification


OL
= TM Load ID number (
MANDATORY
)
N902Reference Identification127Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier.

At least one of N9-02 or N9-03 is required.
N903369Free-Form Description


Free-form descriptive text		Not Used
N904373DateNot Used
N905337TimeNot Used
N906623Time CodeNot Used
N907C040Reference IdentifierNot Used
END Nested LOOP ID H1 in Loop N7
END Loop N7
LOOP ID L0(Maximum Use = 120)
L0 Line Item – Quantity and WeightL001Lading Line Item number213L015640KG5640G69X1PCS*K~

(Maximum Use = 1)
L002Billed/Rated-as Quantity220
L003Billed/Rated-as Qualifier221
L004Weight81
L005Weight Qualifier187Code defining the type of weight


Code Name

A=Shipper’s Weight
G=Gross Weight
L006Volume183
L007Volume Unit Qualifier184Code Name

E=Cubic Feet

X=Cubic Meters
L008Lading Quantity80Number of units (pieces) of the lading commodity.

If either L0-08 or L0-09 is present, then the other is required.

L008 is the number of handling units of the line item tendered to the carrier.
L009Packaging Form Code211
L010Dunnage Description458Not Used
L011Weight Unit Code188K
= Kilograms

L
= Pounds
L012Type of Service Code56Not Used
L013Quantity380Not Used
L014Packaging Form Code211Not Used
L015Yes/No Condition or Response Code1073Not Used
L5 Description, Marks and NumbersL501Lading Line item Number

Sequential line number for a lading item		213L51FREIGHT OF ALL KINDSFAKN*PL~

(Maximum Use = 999)
L502Lading Description

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.		79
L503Commodity Code

Code describing a commodity or group of commodities.

If either L5-03 or L5-04 is present, then the other is required		22
L504Commodity Code qualifier


Code describing a commodity or group of commodities.


If either L5-03 or L5-04 is present, then the other is required		23J
= Harmonized System-Based Schedule B

N
= NMFC 
L505Packaging Code


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.		103PCS
= Pieces

PCK
= Packed – not otherwise specified

PLT
= Pallets

MIX
= Mixed
L506Marks and Numbers87Not Used
L507Marks and Numbers Qualifier88Not Used
L508Commodity Code Qualifier23Not Used
L509Commodity Code22Not Used
L510Commodity ID Code595Not Used
Nested LOOP ID L1 in Loop L0(Maximum Use = 20)
L1 Rate and ChargesL101Lading Line item number


Sequential line number for a lading item		213L1212.5000FR1250495P1NU~

L11240FR24000DICDiversion Fee1FR~ (accessorial)

L113850PA770000COFSeafreight2NR~ (2 containers)

L111530FR153000COFFCL – 40′ Container-freig1PA

L1575FR7500585Origin Document-origin1BL

(Maximum Use = 1)		Sequential item number
L102Freight rate


Rate that applies to the specific commodity.

If either L1-02 or L1-03 is present, then the other is required.		60Freight Rate ($/per Container, Total Flat Rate, etc.)
L103Rate/value qualifier


Code identifying how to extend charges or interpret value		122FR = Flat Rate
PA = Per Container
L104Charge


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.

At least one of L1-04, L1-05 or L1-06 is required.		58Total amount for Detail Line Item
Should equal L102 * L117
L105Advances


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		191Not Used
L106Prepaid Amount (Discount)


Money paid at point of origin (usually by shipper) expressed in the standard monetary denomination for the currency specified.		117Not Used
L107Rate Combination Point Code


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		120Not Used
L108Special Charge or Allowance Code


Code identifying type of special charge or allowance		150COF
= Seafreight
L109Rate Class code121Not Used
L110Entitlement Code39Not Used
L111Charge Method of Payment


Code specifying method of payment		16Not Used
L112Special Charge Description


Identification of special charge; this data element is used whenever an applicable code cannot be found in data element 150		276
L113Tariff Application Code257Not Used
L114Declared Value75Not Used
L115Rate/Value Qualifier122Not Used
L116Lading Liability Code372Not Used
L117Billed/Rated-as Quantity


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

If either L1-17 or L1-18 is present, then the other is required.		220The number of charged units. 
If the L1-08 refers to a flat or BASE charge.
L118Billed/Rated-as Qualifier


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


Code Name

BL Bill of Lading
FR Flat Rate
KG Kilogram
LB Pound
LC 100 Pounds

NR Container

PL Pallet
SP Stops
TD Days
TH Hours
TN Tons		221
L119Percent954Not Used
L120Currency Code


Code specifying the Standard ISO code for country in whose currency the charges are specified.

L120, if used, indicates the currency for all monetary amounts in this L1 segment.		954Not Required as C3 is used.
C3 CurrencyC301Currency Code100Freight bill currency 
C302Exchange Rate280Not Used
C303Currency Code100Not Used
C304Currency Code100Not Used
END Nested LOOP ID L1 in Loop L0
L7 Tariff ReferenceL701Lading Line item number213L71CONTR*FAK~
L702Tariff Agency Code168Not Used
L703Tariff Number171Not Used
L704Tariff Section172Not Used
L705Tariff Item Number169Not Used
L706Tariff Item Part170Not Used
L707Freight Class Code59If sending class 77.5 or other with a decimal, we require “77.5” not “775” or “77”
L708Tariff Supplement IdentifierNot Used
L709Ex ParteNot Used
L710DateNot Used
L711Rate Basis NumberNot Used
L712Tariff ColumnNot Used
L713Tariff DistanceNot Used
L714Distance QualifierNot Used
L715City NameNot Used
L716State or Province CodeNot Used
END Loop ID L0
END Loop ID LX
L3 Total Weight and ChargesL301Weight81L36960B2400066.3X1K~

(Maximum Use = 1)
L302Weight qualifier187G
= Gross Weight

B
= Billed Weight
L303Freight Rate60Not Used
L304Rate/Value Qualifier122Not Used
L305Charge58
L306Advances191Not Used
L307Prepaid Amount117Not Used
L308Special Charge or Allowance Code150Not Used
L309Volume183
L310Volume Unit Qualifier184X
= Cubic Meters
L311Lading Quantity80
L312Weight Unit Code188K
= Kilograms

L
= Pounds
L313Tariff Number171Not Used
L314Declared Value74Not Used
L315Rate/Value Qualifier122Not Used