EDI Specifications

Overview of Master Bill of Lading EDI

RS exchanges EDI/XML with Agents/Clients by FTP. The file is structured into below sections:

MasterBillNumber is mandatory in this EDI.

BillOfLading: This section contains important data, including BookingNumber, HouseBillNumber, MasterBillNumber, ETD, ETA and other relevant details.
PartyInfo: This section contains different party information including Shipper, Consignee, Notify and OverseaAgent information, such as CustomerName, CustomerAddress, CustomerCityName and other relevant details can check in the xsd.
Container: This section contains basic information of the related container, including the EquipmentNum, EquipmentTypeCode, TypeOfServiceCode, SealNum1, SealNum2 and ContainerContent.
ContainerContent: This section includes container details, such as Quantity and UnitOfMeasure etc.

XSD Schema

This section displays the BillOfLading schema, representing a key part of the overall EDI structure. The complete XSD schema, including all elements and attributes, is available for download at the bottom of this page.


	...
	...
        <xs:element name="BillOfLading">
        <xs:complexType>
            <xs:sequence>
                ...
                ...
                <xs:element ref="HouseBillNumber"/>
                <xs:element ref="MasterBillNumber"/>
                <xs:element ref="BookingNumber"/>
                <xs:element ref="AgentStationCode"/>
                <xs:element ref="CustomerRefNumber"/>
                <xs:element ref="TypeOfServiceLevel"/>
                <xs:element ref="TypeOfServiceCode"/>
                <xs:element ref="OTILicense"/>
                <xs:element ref="SCAC_Carrier"/>
                <xs:element ref="VesselName"/>
                <xs:element ref="VoyageNumber"/>
                <xs:element ref="ETD"/>
                <xs:element ref="ETA"/>
                <xs:element ref="ETADest"/>
                <xs:element ref="PlaceOfReceiptCode"/>
                <xs:element ref="PlaceOfReceiptName"/>
                <xs:element ref="PortOfLoadingCode"/>
                <xs:element ref="PortOfLoadingName"/>
                <xs:element ref="PortOfDischargeCode"/>
                <xs:element ref="PortOfDischargeName"/>
                <xs:element ref="PlaceOfDeliveryCode"/>
                <xs:element ref="PlaceOfDeliveryName"/>
                ...
                ...
            </xs:sequence>
        </xs:complexType>
    </xs:element>

    ...
    ...

    <xs:element name="HouseBillNumber" nillable="true">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="20"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="MasterBillNumber" nillable="true">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="50"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="BookingNumber" nillable="true">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="30"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="AgentStationCode">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="20"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="CustomerRefNumber">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="100"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="OTILicense">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="10"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="SCAC_Carrier" nillable="false">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="10"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="VesselName" nillable="false">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="50"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="VoyageNumber" nillable="false">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="50"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="ETD" nillable="false">
        <xs:annotation>
            <xs:documentation>Format = YYYYMMDD</xs:documentation>
        </xs:annotation>
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="8"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="ETA" nillable="false">
        <xs:annotation>
            <xs:documentation>Format = YYYYMMDD (Port of Discharge)</xs:documentation>
        </xs:annotation>
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="8"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="ETADest" nillable="false">
        <xs:annotation>
            <xs:documentation>Format = YYYYMMDD (Destination)</xs:documentation>
        </xs:annotation>
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="8"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="PlaceOfReceiptCode" nillable="false">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="10"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="PlaceOfReceiptName" nillable="false">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="50"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="PortOfLoadingCode" nillable="false">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="10"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="PortOfLoadingName" nillable="false">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="50"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="PortOfDischargeCode" nillable="false">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="10"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="PortOfDischargeName" nillable="false">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="50"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="PlaceOfDeliveryCode" nillable="false">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="10"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>

    <xs:element name="PlaceOfDeliveryName" nillable="false">
        <xs:simpleType>
            <xs:restriction base="xs:string">
                <xs:maxLength value="50"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:element>
    ...
    ...

Sample XML File

This example highlights the BillOfLading. For the complete XML structure and all data elements, please download the full sample file.


    <BillOfLading>
        ...
        ...
        <HouseBillNumber>HKHF2502001A</HouseBillNumber>
        <MasterBillNumber>RHKS25020001A</MasterBillNumber>
        <BookingNumber></BookingNumber>
        <AgentStationCode>AGENT01</AgentStationCode>
        <CustomerRefNumber>CUSTREF123</CustomerRefNumber>
        <TypeOfServiceLevel>FCL</TypeOfServiceLevel>
        <TypeOfServiceCode>CY/CY</TypeOfServiceCode>
        <OTILicense>OTI1234567</OTILicense>
        <SCAC_Carrier>SCAC1234</SCAC_Carrier>
        <VesselName>MV Example</VesselName>
        <VoyageNumber>VY1234</VoyageNumber>
        <ETD>20250701</ETD>
        <ETA>20250710</ETA>
        <ETADest>20250712</ETADest>
        <PlaceOfReceiptCode>POR01</PlaceOfReceiptCode>
        <PlaceOfReceiptName>Port of Receipt</PlaceOfReceiptName>
        <PortOfLoadingCode>POL01</PortOfLoadingCode>
        <PortOfLoadingName>Port of Loading</PortOfLoadingName>
        <PortOfDischargeCode>POD01</PortOfDischargeCode>
        <PortOfDischargeName>Port of Discharge</PortOfDischargeName>
        <PlaceOfDeliveryCode>PODL01</PlaceOfDeliveryCode>
        <PlaceOfDeliveryName>Place of Delivery</PlaceOfDeliveryName>
        ...
        ...
    </BillOfLading>

Downloadable Files

Download Sample XML Download XSD Schema

FAQs

How can I get the EDI file?
The EDI file can be transferred using FTP or SFTP. For enhanced security, we strongly recommend using SFTP, which supports both password and key-based authentication.

How do I validate the XML?
You can use the provided XSD (XML Schema Definition) file to validate the XML file. An XSD defines the structure and rules for the XML.