DEX Schemas (1.0.1 DRAFT)

Download OpenAPI specification:

Overview

This document describes the Schemas used for the various use cases.

For the full API specifications please CLICK HERE.

How To Use

  1. Look for the Use Case you are using on the left menu

  2. Check the API you are using to see if you need payload or parameters.
    The following APIs use payload:

    • PUSH /data/push
    • STORE /data/store
    • RECEIVE /data/receive

    The following APIs use parameters:

    • PULL /data/pull
    • FORWARD /data/forward
    • PROVIDE /data/provide
  3. For payload, look under the (Payload) section in the use case;
    for parameters, look under the (Parameters) section in the use case.

  4. Look for the Data Element you require under the appropriate Payload/Parameter section, and find the sample JSON format on the panel on the right-hand side.

  5. Copy the sample JSON format and insert it into the relevant payload or parameters attribute in your API request/response, along with the appropriate values in the JSON.

Example

For /data/push/bill_of_lading:

You would take the sample JSON from Use Case A (Payload) -> Oil Cargo Bill of Lading.

Sample JSON payload:


{
    "bl_doc_no": "string",
    "bl_dt": "2019-08-24",
    "bl_shipper_nm": "string",
    "bl_consignee_nm": "string",
    "bl_terminal_nm": "string",
    "bl_port_of_loading": "string",
    "bl_port_of_discharge": "string",
    "bl_vessel_nm": "string",
    "bl_country_of_origin": "string",
    "bl_country_of_destination": "string",
    "bl_goods_particulars": [
    {
        "bl_goods_nm": "string",
        "bl_goods_qty_amt": "string",
        "bl_goods_qty_uom": "string"
    }
    ],
    "attachments": [
    {
        "filename": "string",
        "file_content": "string"
    }
    ],
    "bl_order_no": "string",
    "bl_vessel_flag": "string",
    "bl_master_nm": "string",
    "bl_terms_and_condition_and_other_text": "string",
    "bl_vessel_imo_no": "string",
    "bl_notify_party_nm": "string"
}    



Final API request body would look something like this:


{
    "parent_node_id": "string",
    "parent_node_type": "FOLDER",
    "payload": [
    {
        "bl_doc_no": "BL_001",
        "bl_dt": "2019-08-24",
        "bl_shipper_nm": "string",
        "bl_consignee_nm": "string",
        "bl_terminal_nm": "string",
        "bl_port_of_loading": "string",
        "bl_port_of_discharge": "string",
        "bl_vessel_nm": "string",
        "bl_country_of_origin": "string",
        "bl_country_of_destination": "string",
        "bl_goods_particulars": [
        {
            "bl_goods_nm": "string",
            "bl_goods_qty_amt": "string",
            "bl_goods_qty_uom": "string"
        }
        ],
        "attachments": [
        {
            "filename": "string",
            "file_content": "string"
        }
        ],
        "bl_order_no": "string",
        "bl_vessel_flag": "string",
        "bl_master_nm": "string",
        "bl_terms_and_condition_and_other_text": "string",
        "bl_vessel_imo_no": "string",
        "bl_notify_party_nm": "string"
    }        
    ,
    {
        "bl_doc_no": "BL_002",
        "bl_dt": "2019-08-24",
        "bl_shipper_nm": "string",
        "bl_consignee_nm": "string",
        "bl_terminal_nm": "string",
        "bl_port_of_loading": "string",
        "bl_port_of_discharge": "string",
        "bl_vessel_nm": "string",
        "bl_country_of_origin": "string",
        "bl_country_of_destination": "string",
        "bl_goods_particulars": [
        {
            "bl_goods_nm": "string",
            "bl_goods_qty_amt": "string",
            "bl_goods_qty_uom": "string"
        }
        ],
        "attachments": [
        {
            "filename": "string",
            "file_content": "string"
        }
        ],
        "bl_order_no": "string",
        "bl_vessel_flag": "string",
        "bl_master_nm": "string",
        "bl_terms_and_condition_and_other_text": "string",
        "bl_vessel_imo_no": "string",
        "bl_notify_party_nm": "string"
    }        
    ],
    "requestId": "string",
    "participants": [
    {
        "request_id": "string",
        "id": "string",
        "name": "string",
        "system": {
        "id": "string",
        "name": "string",
        "sourceSystemId": "string"
        },
        "meta": {
        "data_ref_id": "string"
        }
    }
    ],
    "on_behalf_of": [
    "string"
    ]
}    

Use Case A (Payload)

Payload schemas for Use Case A

Certificate Of Quality

Data Element ID: certificate_of_quality

coq_job_no
string or null (Coq Job No)

:Job Number
:Job Number
:Job Number
:ISO 17025
:NA

coq_sample_no
required
string (Coq Sample No)

:Sample Number
:Sample Number
:Sample Number
:ISO 17025
:NA

coq_location_or_terminal
string or null (Coq Location Or Terminal)

:Location / Terminal
:Location/Terminal
:Location/Terminal
:ISO 17025
:NA

coq_sample_product_nm
string or null (Coq Sample Product Nm)

:Name of product sample
:Name of Product Sample
:Name of Product Sample
:ISO 17025
:NA

coq_source_of_sample
string or null (Coq Source Of Sample)

:Sample Source (e.g., shore tank)
:Sample Source
:Sample Source, for example- shore tank
:ISO 17025
:NA

coq_type_of_sample
string or null (Coq Type Of Sample)

:Type of Sample
:Type of Sample
:Type of Sample, for example- before loading
:ISO 17025
:NA

coq_summary_of_sample
string or null (Coq Summary Of Sample)

:Sample Summary
:Sample Summary
:Sample Summary
:ISO 17025
:NA

coq_sample_sampled_dt
string or null <date> (Coq Sample Sampled Dt)

:Sample Sampled Date
:Sample Sampled Date
:Sample Sampled Date
:ISO 17025
:date (YYYY-MM-DD)

coq_sample_received_dt
string or null <date> (Coq Sample Received Dt)

:Sample Date Received
:Sample Date Received
:Sample Date Received
:ISO 17025
:date (YYYY-MM-DD)

coq_sample_tested_dt
string or null <date> (Coq Sample Tested Dt)

:Sample Date Tested
:Sample Date Tested
:Sample Date Tested
:ISO 17025
:date (YYYY-MM-DD)

coq_sample_reported_dt
string or null <date> (Coq Sample Reported Dt)

:Sample Date Reported
:Sample Date Reported
:Sample Date Reported
:ISO 17025
:date (YYYY-MM-DD)

Array of objects or null (Coq Results)

:Certificate of Quality Results
:Certificate of Quality Results
:Certificate of Quality Results
:ISO 17025
:NA

coq_surveyor_company_nm
string or null (Coq Surveyor Company Nm)

:Surveyor Company Name
:Surveyor Company Name
:Surveyor Company Name
:ISO 17025
:NA

Array of objects or null (Attachments) non-empty

:Certificate of Quality Attachment
:Certificate of Quality Attachment
:Certificate of Quality Attachment
:ISO 17025
:.PDF format

{
  • "coq_job_no": "string",
  • "coq_sample_no": "string",
  • "coq_location_or_terminal": "string",
  • "coq_sample_product_nm": "string",
  • "coq_source_of_sample": "string",
  • "coq_type_of_sample": "string",
  • "coq_summary_of_sample": "string",
  • "coq_sample_sampled_dt": "2019-08-24",
  • "coq_sample_received_dt": "2019-08-24",
  • "coq_sample_tested_dt": "2019-08-24",
  • "coq_sample_reported_dt": "2019-08-24",
  • "coq_results": [
    ],
  • "coq_surveyor_company_nm": "string",
  • "attachments": [
    ]
}

Certificate Of Quantity

Data Element ID: certificate_of_quantity

cq_dt
string or null <date> (Cq Dt)

:Certificate of Quantity date
:Certificate of Quantity Date
:Certificate of Quantity Date
:ISO 8601
:ISO Date Format (YYYY-MM-DD)

cq_doc_no
required
string (Cq Doc No)

:Certificate of Quantity Number / Document Number
:Certificate of Quantity Number
:Certificate of Quantity Number
:NA
:NA

cq_seller_nm
string or null (Cq Seller Nm)

:Seller/Shipped By Name
:Seller/Shipped By Name
:Seller/Shipped By Name
:NA
:NA

cq_source
string or null (Source (Vessel/Barge/Tank Name))

:Source of goods (Vessel/Barge/Tank Name)
:Source (Vessel/Barge/Tank Name)
:Source of goods (Vessel/Barge/Tank Name)
:NA
:NA

cq_destination
string or null (Destination (Vessel/Barge/Tank Name))

:Destination of goods (Vessel/Barge/Tank Name)
:Source (Vessel/Barge/Tank Name)
:Destination of goods (Vessel/Barge/Tank Name)
:NA
:NA

cq_buyer_nm
string or null (Cq Buyer Nm)

:Buyer/Consignee Name
:Buyer/Consignee Name
:Buyer/Consignee Name
:NA
:NA

cq_port_of_loading
string or null (Cq Port Of Loading)

:Port of Loading
:Port of Loading
:Port of loading
:NA
:NA

cq_port_of_discharge
string or null (Cq Port Of Discharge)

:Port of Discharge
:Port of Discharge
:Port of discharge
:NA
:NA

cq_country_of_origin
string or null (Cq Country Of Origin)

:Country of Origin
:Country of Origin
:Country of Origin
:NA
:NA

cq_country_of_destination
string or null (Cq Country Of Destination)

:Country of Destination
:Country of Destination
:Country of Destination
:NA
:NA

Array of objects or null (Attachments)

:NA
:Certificate of Quantity Attachment
:Certificate of Quantity Attachment
:NA
:.PDF format

cq_terminal_nm
string or null (Cq Terminal Nm)

:Terminal Name
:Terminal Name
:Terminal Name
:NA
:NA

Array of objects or null (Cq Goods Particulars)

:NA
:Goods Particulars
:Particulars of goods
:NA
:NA

cq_order_no
string or null (Cq Order No)

:Order Number
:Order Number
:Order Number
:NA
:NA

cq_start_pump_dt
string or null <date-time> (Cq Start Pump Dt)

:Start time of pumping
:Start time of pumping
:Start time of pumping
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

cq_end_pump_dt
string or null <date-time> (Cq End Pump Dt)

:End time of pumping
:End time of pumping
:End time of pumping
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

cq_terminal_rep_nm
string or null (Cq Terminal Rep Nm)

:Name of Terminal Representative
:Name of Terminal Representative
:Name of Terminal Representative
:NA
:NA

cq_vessel_flag
string or null (Cq Vessel Flag)

:Name of country of flag the vessel is registered
:Name of country of flag the vessel is registered
:Name of country of flag the vessel is registered
:NA
:NA

cq_surveyor_nm
string or null (Cq Surveyor Nm)

:Surveyor Name
:Surveyor Name
:Surveyor Name
:NA
:NA

cq_terms_and_condition_and_other_text
string or null (Cq Terms And Condition And Other Text)

:Terms and Condition and any other text
:Terms and Condition and any other text
:Terms and Condition and any other text
:NA
:NA

{
  • "cq_dt": "2019-08-24",
  • "cq_doc_no": "string",
  • "cq_seller_nm": "string",
  • "cq_source": "string",
  • "cq_destination": "string",
  • "cq_buyer_nm": "string",
  • "cq_port_of_loading": "string",
  • "cq_port_of_discharge": "string",
  • "cq_country_of_origin": "string",
  • "cq_country_of_destination": "string",
  • "attachments": [
    ],
  • "cq_terminal_nm": "string",
  • "cq_goods_particulars": [
    ],
  • "cq_order_no": "string",
  • "cq_start_pump_dt": "2019-08-24T14:15:22Z",
  • "cq_end_pump_dt": "2019-08-24T14:15:22Z",
  • "cq_terminal_rep_nm": "string",
  • "cq_vessel_flag": "string",
  • "cq_surveyor_nm": "string",
  • "cq_terms_and_condition_and_other_text": "string"
}

Inter Tank Transfer Certificate

Data Element ID: inter_tank_transfer_certificate

ittc_certificate_number
required
string (Ittc Certificate Number)

:Certificate Number
:ITT Certificate Number
:Certificate Number
:NA
:NA

ittc_terminal_name
string or null (Ittc Terminal Name)

:Name of Terminal conducting transfer
:Terminal Name
:Terminal Name
:NA
:NA

ittc_terminal_address
string or null (Ittc Terminal Address)

:Address of Terminal conducting transfer
:Terminal Address
:Address of Terminal conducting transfer
:NA
:NA

ittc_datetime
string or null <date-time> (Ittc Datetime)

:Date Time of ITTC Issuance
:Datetime
:Date of Issuance
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

ittc_seller_name
string or null (Ittc Seller Name)

:Name of Cargo Seller
:Seller Name
:Name of Cargo Seller
:NA
:NA

ittc_seller_tank_number
string or null (Ittc Seller Tank Number)

:Tank Number Discharged From
:Seller Tank Number
:Tank Number Discharged From
:NA
:NA

ittc_buyer_name
string or null (Ittc Buyer Name)

:Name of Cargo Buyer
:Buyer Name
:Name of Cargo Buyer
:NA
:NA

ittc_buyer_tank_number
string or null (Ittc Buyer Tank Number)

:Tank Number Loaded To
:Buyer Tank Number
:Tank Number Loaded To
:NA
:NA

ittc_goods_quantity
number or null (Ittc Goods Quantity)

:Quantity of Goods
:Goods Quantity
:Quantity of Goods
:NA
:NA

ittc_goods_quantity_uom
string or null (Ittc Goods Quantity Uom)

:Units of measurement
:Goods Quantity UOM
:Units of measurement
:NA
:NA

Array of objects or null (Attachments) non-empty

:Attachment of Inter Tank Transfer Certificate
:Inter Tank Transfer Certificate Attachment
:Attachment of Inter Tank Transfer Certificate
:NA
:NA

ittc_goods_particulars
string or null (Ittc Goods Particulars)

:Type of Goods
:Goods Particulars
:Particulars of goods
:NA
:NA

{
  • "ittc_certificate_number": "string",
  • "ittc_terminal_name": "string",
  • "ittc_terminal_address": "string",
  • "ittc_datetime": "2019-08-24T14:15:22Z",
  • "ittc_seller_name": "string",
  • "ittc_seller_tank_number": "string",
  • "ittc_buyer_name": "string",
  • "ittc_buyer_tank_number": "string",
  • "ittc_goods_quantity": 0,
  • "ittc_goods_quantity_uom": "string",
  • "attachments": [
    ],
  • "ittc_goods_particulars": "string"
}

Last Vessel Arrival Declaration

Data Element ID: vessel_event

required
Array of objects (Vessel Particulars)

:Particulars of vessel
:Vessel Particulars
:Particulars of the vessel
:MPA
:NA

vessel_location
required
string (Vessel Location)

:Location of the vessel\r
:Vessel Location
:Location of the vessel
:MPA
:NA

vessel_arrived_dt
required
string <date-time> (Vessel Arrived Dt)

:Time which vessel arrives in Singapore port waters
:Arrived Time
:The reported arrival time of the vessel
:MPA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

vessel_grid
required
string (Vessel Grid)

:Grid of the vessel
:Grid
:Grid of the vessel
:MPA
:NA

vessel_purpose
required
string (Vessel Purpose)

:Purpose of the vessel entering the port. The purpose field is a comma-separate value (CSV) field, where each value is a Yes(Y)/No(N) indicator in the following sequence. /r/n#1 indicator – Loading / Unloading Cargo, /r/n#2 indicator – Loading / Unloading Passengers, /r/n#3 indicator – Taking Bunker, /r/n#4 indicator – Taking Ship Supplies, /r/n#5 indicator – Changing Crew, /r/n#6 indicator – Shipyard Repair, /r/n#7 indicator – Offshore Support, /r/n#8 indicator – Not Used, /r/n#9 indicator – Other Afloat Activities
:Purpose
:The purpose field is a comma-separated value (CSV) field, where each value is a Yes(Y)/No(N) indicator in the following sequence. /r/n#1 indicator – Loading / Unloading Cargo /r/n#2 indicator – Loading / Unloading Passengers /r/n#3 indicator – Taking Bunker /r/n#4 indicator – Taking Ship Supplies /r/n#5 indicator – Changing Crew /r/n#6 indicator – Shipyard Repair /r/n#7 indicator – Offshore Support /r/n#8 indicator – Not Used /r/n#9 indicator – Other Afloat Activities
:MPA
:NA

vessel_agent
required
string (Vessel Agent)

:Agent of the vessel
:Agent
:Agent of the vessel
:MPA
:NA

{
  • "vessel_particulars": [
    ],
  • "vessel_location": "string",
  • "vessel_arrived_dt": "2019-08-24T14:15:22Z",
  • "vessel_grid": "string",
  • "vessel_purpose": "string",
  • "vessel_agent": "string"
}

Lei Record

Data Element ID: lei_record

lei_code
required
string (LEI Code)

:A Legal Entity Identifier (LEI) code in the format specified by ISO 17442
:LEI Code
:A Legal Entity Identifier (LEI) code in the format specified by ISO 17442
:ISO 17442
:NA

legal_name
required
string (Legal Name)

:The Legal Name of the Entity
:Legal Name
:The Legal Name of the Entity
:NA
:NA

registration_status
required
string (Registration Status)

:The status of the Legal Entity's LEI Record registration with the Managing LOU
:Registration Status
:The status of the Legal Entity's LEI Record registration with the Managing LOU
:NA
:NA

managing_lou
required
string (Managing LOU)

:The LEI of the LEI Issuer that is responsible for administering this LEI Record. LOU refers to Local Operating Unit
:Managing LOU
:The LEI of the LEI Issuer that is responsible for administering this LEI Record. LOU refers to Local Operating Unit
:ISO 17442
:NA

initial_registration_date
required
string <date-time> (Initial Registration Date)

:The date at which the information was first collected by the Managing LOU
:Initial Registration Date
:The date at which the information was first collected by the Managing LOU
:ISO 8601
:NA

last_update_date
required
string <date-time> (Last Update Date)

:The date at which the information was most recently updated by the Managing LOU
:Last Update Date
:The date at which the information was most recently updated by the Managing LOU
:ISO 8601
:NA

Array of objects or null (LEI Record Attachment)

:Attachment version of LEI Record
:LEI Record Attachment
:Attachment version of LEI Record
:NA
:NA

{
  • "lei_code": "string",
  • "legal_name": "string",
  • "registration_status": "string",
  • "managing_lou": "string",
  • "initial_registration_date": "2019-08-24T14:15:22Z",
  • "last_update_date": "2019-08-24T14:15:22Z",
  • "attachments": [
    ]
}

Letter Of Credit

Data Element ID: letter_of_credit

lc_doc_lc_form
string or null (Form of Documentary Credit)

:SWIFT MT 700 Field 40A : Form of Documentary Credit
This field specifies the type of credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Form of Documentary Credit
:SWIFT MT 700 Field 40A : Form of Documentary Credit
This field specifies the type of credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_dt_of_issue
required
string <date> (Date Of Issue)

:SWIFT MT 700 Field 31C : Date Of Issue
This field specifies the date on which the issuing bank (Sender) considers the documentary credit as being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Date Of Issue
:SWIFT MT 700 Field 31C : Date Of Issue
This field specifies the date on which the issuing bank (Sender) considers the documentary credit as being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:date (YYYY-MM-DD)

lc_doc_lc_no
string or null (Documentary Credit Number)

:SWIFT MT 700 Field 20 : Documentary Credit Number
This field specifies the documentary credit number which has been assigned by the Sender.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Documentary Credit Number
:SWIFT MT 700 Field 20 : Documentary Credit Number
This field specifies the documentary credit number which has been assigned by the Sender.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_dt_and_place_of_expiry
string or null (Date and Place of Expiry)

:SWIFT MT 700 Field 31D : Date and Place of Expiry
This field specifies the latest date for presentation under the documentary credit and the place where documents may be presented.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Date and Place of Expiry
:SWIFT MT 700 Field 31D : Date and Place of Expiry
This field specifies the latest date for presentation under the documentary credit and the place where documents may be presented.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_applicant
string or null (Applicant)

:SWIFT MT 700 Field 50 : Applicant
This field specifies the party on behalf of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Applicant
:SWIFT MT 700 Field 50 : Applicant
This field specifies the party on behalf of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_beneficiary_nm_and_address
string or null (Beneficiary)

:SWIFT MT 700 Field 59 : Beneficiary
The field specifies the party in favour of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Beneficiary
:SWIFT MT 700 Field 59 : Beneficiary
The field specifies the party in favour of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_doc_lc_currency_cd_and_amount
string or null (Currency Code, Amount)

:SWIFT MT 700 Field 32B : Currency Code, Amount
This field contains the currency code and amount of the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Currency Code, Amount
:SWIFT MT 700 Field 32B : Currency Code, Amount
This field contains the currency code and amount of the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_available_with_by
string or null (Available with and by)

:SWIFT MT 700 Field 41a : Available with... by …
This field identifies the bank with which the credit is available (the place for presentation) and an indication of how the credit is available.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Available with and by
:SWIFT MT 700 Field 41a : Available with... by …
This field identifies the bank with which the credit is available (the place for presentation) and an indication of how the credit is available.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_negotiation_deferred_payment_details
string or null (Negotiation/Deferred Payment Details)

:SWIFT MT 700 Field 42P : Negotiation/Deferred Payment Details
This field specifies the payment date or method for its determination in a documentary credit which is available by deferred payment or negotiation only.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Negotiation/Deferred Payment Details
:SWIFT MT 700 Field 42P : Negotiation/Deferred Payment Details
This field specifies the payment date or method for its determination in a documentary credit which is available by deferred payment or negotiation only.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_partial_shipments
string or null (Partial Shipments)

:SWIFT MT 700 Field 43P : Partial Shipments
This field specifies whether or not partial shipments are allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Partial Shipments
:SWIFT MT 700 Field 43P : Partial Shipments
This field specifies whether or not partial shipments are allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_transhipment
string or null (Transhipment)

:SWIFT MT 700 Field 43T : Transhipment
This field specifies whether or not transhipment is allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Transhipment
:SWIFT MT 700 Field 43T : Transhipment
This field specifies whether or not transhipment is allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_latest_dt_of_shipment
string or null <date> (Latest Date of Shipment)

:SWIFT MT 700 Field 44C : Latest Date of Shipment
This field specifies the latest date for loading on board/dispatch/taking in charge.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Latest Date of Shipment
:SWIFT MT 700 Field 44C : Latest Date of Shipment
This field specifies the latest date for loading on board/dispatch/taking in charge.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:date (YYYY-MM-DD)

lc_confirmation_instructions
string or null (Confirmation Instructions)

:SWIFT MT 700 Field 49 : Confirmation Instructions
This field contains confirmation instructions for the requested confirmation party.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Confirmation Instructions
:SWIFT MT 700 Field 49 : Confirmation Instructions
This field contains confirmation instructions for the requested confirmation party.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_percentage_credit_amt_tolerance
string or null (Percentage Credit Amount Tolerance)

:SWIFT MT 700 Field 39A : Percentage Credit Amount Tolerance
This field specifies the tolerance relative to the documentary credit amount as a percentage plus and/or minus that amount.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Percentage Credit Amount Tolerance
:SWIFT MT 700 Field 39A : Percentage Credit Amount Tolerance
This field specifies the tolerance relative to the documentary credit amount as a percentage plus and/or minus that amount.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_mixed_payment_details
string or null (Mixed Payment Details)

:SWIFT MT 700 Field 42M : Mixed Payment Details
This field specifies the payment dates, amounts and/or method for their determination in a documentary credit which is available by mixed payment.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Mixed Payment Details
:SWIFT MT 700 Field 42M : Mixed Payment Details
This field specifies the payment dates, amounts and/or method for their determination in a documentary credit which is available by mixed payment.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_period_for_presentation_in_days
string or null (Period for Presentaton in Days)

:SWIFT MT 700 Field 48 : Period for Presentaton in Days
This field specifies the number of calendar days after the date of shipment within which the documents must be presented for payment, acceptance, or negotiation. Narrative must only be used to specify another type of date than a shipment date, for example invoice date, from which the period for presentation begins.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Period for Presentaton in Days
:SWIFT MT 700 Field 48 : Period for Presentaton in Days
This field specifies the number of calendar days after the date of shipment within which the documents must be presented for payment, acceptance, or negotiation. Narrative must only be used to specify another type of date than a shipment date, for example invoice date, from which the period for presentation begins.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

Array of objects or null (Letter of Credit Attachment)

:Letter of Credit Attachment
:Letter of Credit Attachment
:Letter of Credit Attachment
:NA
:NA

{
  • "lc_doc_lc_form": "string",
  • "lc_dt_of_issue": "2019-08-24",
  • "lc_doc_lc_no": "string",
  • "lc_dt_and_place_of_expiry": "string",
  • "lc_applicant": "string",
  • "lc_beneficiary_nm_and_address": "string",
  • "lc_doc_lc_currency_cd_and_amount": "string",
  • "lc_available_with_by": "string",
  • "lc_negotiation_deferred_payment_details": "string",
  • "lc_partial_shipments": "string",
  • "lc_transhipment": "string",
  • "lc_latest_dt_of_shipment": "2019-08-24",
  • "lc_confirmation_instructions": "string",
  • "lc_percentage_credit_amt_tolerance": "string",
  • "lc_mixed_payment_details": "string",
  • "lc_period_for_presentation_in_days": "string",
  • "attachments": [
    ]
}

Letter Of Credit Application

Data Element ID: letter_of_credit_application

lca_date
required
string <date> (Date)

:Date of document
:Date
:Date of document
:NA
:date (YYYY-MM-DD)

lca_applicant_name
string or null (Applicant's Name)

:Name of applicant
:Applicant's Name
:Name of applicant
:NA
:NA

lca_applicant_address
string or null (Applicant's Address)

:Address of applicant
:Applicant's Address
:Address of applicant
:NA
:NA

lca_contact_person_applicant
string or null (Contact Person (Applicant))

:Name of contact person for applicant
:Contact Person (Applicant)
:Name of contact person for applicant
:NA
:NA

lca_telephone_number_applicant
number or null <double> (Telephone Number (Applicant))

:Contact number of contact person
:Telephone Number (Applicant)
:Contact number of contact person
:NA
:NA

lca_fax_applicant
number or null <double> (Fax No (Applicant))

:Fax Number of Applicant
:Fax No (Applicant)
:Fax Number of Applicant
:NA
:NA

lca_debit_account_no
string or null (Debit Account No.)

:Debit account number of Applicant
:Debit Account No.
:Debit account number of Applicant
:NA
:NA

lca_beneficiary_type
string or null (Beneficiary Type (Local / Overseas))

:Local or Overseas Beneficiary type
:Beneficiary Type (Local / Overseas)
:Local or Overseas Beneficiary type
:NA
:NA

lca_beneficiary_name
string or null (Beneficiary's Name)

:Name of beneficiary
:Beneficiary's Name
:Name of beneficiary
:NA
:NA

lca_beneficiary_address
string or null (Beneficiary's Address)

:Address of beneficiary
:Beneficiary's Address
:Address of beneficiary
:NA
:NA

lca_contact_person_beneficiary
string or null (Contact Person (Beneficiary))

:Name of contact person for beneficiary
:Contact Person (Beneficiary)
:Name of contact person for beneficiary
:NA
:NA

lca_telephone_number_beneficiary
number or null <double> (Telephone Number (Beneficiary))

:Contact number of contact person
:Telephone Number (Beneficiary)
:Contact number of contact person
:NA
:NA

lca_fax_beneficiary
number or null <double> (Fax No (Beneficiary))

:Fax Number of Beneficiary
:Fax No (Beneficiary)
:Fax Number of Beneficiary
:NA
:NA

lca_third_party_name
string or null (Third Party Name)

:Name of Third Party (if applying on behalf of)
:Third Party Name
:Name of Third Party (if applying on behalf of)
:NA
:NA

lca_third_party_address
string or null (Third Party Address)

:Address of Third Party (if applying on behalf of)
:Third Party Address
:Address of Third Party (if applying on behalf of)
:NA
:NA

lca_advising_bank_name
string or null (Advising Bank Name)

:Registered company name of advising bank
:Advising Bank Name
:Registered company name of advising bank
:NA
:NA

lca_advising_bank_address
string or null (Advising Bank Address)

:Registered company address of advising bank
:Advising Bank Address
:Registered company address of advising bank
:NA
:NA

lca_advising_bank_swift_address
string or null (Advising Bank SWIFT Address)

:Registered company SWIFT address of advising bank
:Advising Bank SWIFT Address
:Registered company SWIFT address of advising bank
:NA
:NA

lca_currency
string or null (Currency)

:Currency Type to be used
:Currency
:Currency Type to be used
:NA
:NA

lca_amount
number or null <double> (Amount)

:Amount applicable
:Amount
:Amount applicable
:NA
:NA

lca_issuance_date
string or null <date> (LC Issuance Date)

:Issuance date of Letter of Credit
:LC Issuance Date
:Issuance date of Letter of Credit
:NA
:NA

lca_date_expiry_beneficiary_country
string or null <date> (Expiry Date (Beneficiary Country))

:Expiry date of Letter of Credit in country of beneficiary
:Expiry Date (Beneficiary Country)
:Expiry date of Letter of Credit in country of beneficiary
:NA
:NA

lca_date_expiry_applicant_country
string or null <date> (Expiry Date (Applicant Country))

:Expiry date of Letter of Credit in country of applicant
:Expiry Date (Applicant Country)
:Expiry date of Letter of Credit in country of applicant
:NA
:NA

lca_charges
string or null (Charges)

:Indicates reimburement charges to be charged to applicant / beneficiary
:Charges
:Indicates reimburement charges to be charged to applicant / beneficiary
:NA
:NA

lca_documents
string or null (Documents Required)

:Type of documents required
:Documents Required
:Type of documents required
:NA
:NA

lca_special_instructions
string or null (Special Instructions)

:Indicates if any special instructions are applicable
:Special Instructions
:Indicates if any special instructions are applicable
:NA
:NA

lca_special_type_credit_governing_rule
string or null (Special Type of Credit- Governing Rule)

:SBLC Subject to UCP600 or ISP 98 (if applicable)
:Special Type of Credit- Governing Rule
:SBLC Subject to UCP600 or ISP 98 (if applicable)
:NA
:NA

lca_tenor
string or null (Tenor )

:Tenor for trade financing (e.g. Sight / Term)
:Tenor
:Tenor for trade financing (e.g. Sight / Term)
:NA
:NA

lca_shipment_from
string or null (Shipment From)

:Details of shipment location of origin
:Shipment From
:Details of shipment location of origin
:NA
:NA

lca_shipment_to
string or null (Shipment To)

:Details of shipment location
:Shipment To
:Details of shipment location
:NA
:NA

lca_date_latest_shipment
string or null <date> (Latest Shipment Date)

:Date of latest shipment
:Latest Shipment Date
:Date of latest shipment
:NA
:NA

lca_present_documents_in_X_days_after_shipment_date_but_before_LC_expiry
number or null <double> (Present documents in X days after shipment date but before LC expiry)

:Present documents in X days after shipment date but before LC expiry
:Present documents in X days after shipment date but before LC expiry
:Present documents in X days after shipment date but before LC expiry
:NA
:NA

lca_issuance_mode
string or null (LC issuance mode)

:Mode of LC issuance
:LC issuance mode
:Mode of LC issuance
:NA
:NA

lca_lc_to_be_confirmed_by_advising_bank
string or null (LC To Be Confirmed by Advising Bank)

:Indicates whether LC is to be confirmed by Advising Bank
:LC To Be Confirmed by Advising Bank
:Indicates whether LC is to be confirmed by Advising Bank
:NA
:NA

lca_confirmation_charges
string or null (Confirmation Charges)

:Indicates confirmation charges to be charged to applicant / beneficiary
:Confirmation Charges
:Indicates confirmation charges to be charged to applicant / beneficiary
:NA
:NA

lca_tolerance
string or null (Tolerance)

:Tolerance on Credit Amount
:Tolerance
:Tolerance on Credit Amount
:NA
:NA

lca_goods_description
string or null (Goods description)

:Description of goods
:Goods description
:Description of goods
:NA
:NA

lca_transshipment_allowed
string or null (Transshipment Allowed)

:Indicates whether transshipment is allowed
:Transshipment Allowed
:Indicates whether transshipment is allowed
:NA
:NA

lca_partial_shipment_allowed
string or null (Partial Shipment Allowed)

:Indicates whether partial shipment is allowed
:Partial Shipment Allowed
:Indicates whether partial shipment is allowed
:NA
:NA

lca_incoterms
string or null (Incoterms)

:Applicable Incoterms
:Incoterms
:Applicable Incoterms
:NA
:NA

lca_insurance_to_be_covered_by
string or null (Insurance To Be Covered By)

:Indicates the party covering the insurance
:Insurance To Be Covered By
:Indicates the party covering the insurance
:NA
:NA

lca_cover_no
string or null (Cover No.)

:Insurance Policy cover number (if Insurance covered by Applicant)
:Cover No.
:Insurance Policy cover number (if Insurance covered by Applicant)
:NA
:NA

lca_insurance_company
string or null (Insurance Company)

:Insurance company (if Insurance covered by Applicant)
:Insurance Company
:Insurance company (if Insurance covered by Applicant)
:NA
:NA

Array of objects or null (Letter of Credit Application Attachment)

:Letter of Credit Application Attachment
:Letter of Credit Application Attachment
:Letter of Credit Application Attachment
:NA
:NA

{
  • "lca_date": "2019-08-24",
  • "lca_applicant_name": "string",
  • "lca_applicant_address": "string",
  • "lca_contact_person_applicant": "string",
  • "lca_telephone_number_applicant": 0.1,
  • "lca_fax_applicant": 0.1,
  • "lca_debit_account_no": "string",
  • "lca_beneficiary_type": "string",
  • "lca_beneficiary_name": "string",
  • "lca_beneficiary_address": "string",
  • "lca_contact_person_beneficiary": "string",
  • "lca_telephone_number_beneficiary": 0.1,
  • "lca_fax_beneficiary": 0.1,
  • "lca_third_party_name": "string",
  • "lca_third_party_address": "string",
  • "lca_advising_bank_name": "string",
  • "lca_advising_bank_address": "string",
  • "lca_advising_bank_swift_address": "string",
  • "lca_currency": "string",
  • "lca_amount": 0.1,
  • "lca_issuance_date": "2019-08-24",
  • "lca_date_expiry_beneficiary_country": "2019-08-24",
  • "lca_date_expiry_applicant_country": "2019-08-24",
  • "lca_charges": "string",
  • "lca_documents": "string",
  • "lca_special_instructions": "string",
  • "lca_special_type_credit_governing_rule": "string",
  • "lca_tenor": "string",
  • "lca_shipment_from": "string",
  • "lca_shipment_to": "string",
  • "lca_date_latest_shipment": "2019-08-24",
  • "lca_present_documents_in_X_days_after_shipment_date_but_before_LC_expiry": 0.1,
  • "lca_issuance_mode": "string",
  • "lca_lc_to_be_confirmed_by_advising_bank": "string",
  • "lca_confirmation_charges": "string",
  • "lca_tolerance": "string",
  • "lca_goods_description": "string",
  • "lca_transshipment_allowed": "string",
  • "lca_partial_shipment_allowed": "string",
  • "lca_incoterms": "string",
  • "lca_insurance_to_be_covered_by": "string",
  • "lca_cover_no": "string",
  • "lca_insurance_company": "string",
  • "attachments": [
    ]
}

Nominated Oil Terminal Instructions

Data Element ID: nominated_terminal

nt_nom_ref
string or null (Nomination Reference Number)

:Nomination Reference Number
:Nomination Reference Number
:Nomination Reference Number
:NA
:NA

nt_issuer_nm
string or null (Issuer of Nomination)

:Issuing Entity of Nomination
:Issuer of Nomination
:Issuing Entity of Nomination
:NA
:NA

nt_executor_nm
string or null (Executor of Nomination)

:Executor of Nomination
:Executor of Nomination
:Executor of Nomination
:NA
:NA

nt_receiver_nm
string or null (Receiver)

:Receiver of goods
:Receiver
:Receiver of goods
:NA
:NA

nt_start_dt
string or null <date-time> (Nomination Start Date)

:Start Date of Nomination
:Nomination Start Date
:Start Date of Nomination
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

nt_end_dt
string or null <date-time> (Nomination End Date)

:End Date of Nomination
:Nomination End Date
:End Date of Nomination
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

nt_vessel_nm
string or null (Vessel Name)

:Name of performing vessel
:Vessel Name
:Name of vessel
:NA
:NA

nt_vessel_est_arrived_dt
string or null <date-time> (Vessel Estimated Time of Arrival)

:Vessel expected arrival time
:Vessel Estimated Time of Arrival
:Vessel expected arrival time
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

Array of objects or null (Goods Particulars)

:Goods to load / discharge
:Goods Particulars
:Particulars of goods
:NA
:NA

nt_laycan
string or null (Laycan)

:Laycan duration
:Laycan
:Laycan duration
:NA
:NA

nt_doc_instruction
string or null (Document Instruction)

:Text of instructions
:Document Instruction
:Attachment/Text of instructions
:NA
:NA

nt_nom_desc
string or null (Nomination Description)

:Nomination Description
:Nomination Description
:Attachment/Nomination Description
:NA
:NA

Array of objects or null (Attachments)

:NA
:Nominated Terminal Attachment
:Attachment to share Operation Plan (if any)
:NA
:NA

{
  • "nt_nom_ref": "string",
  • "nt_issuer_nm": "string",
  • "nt_executor_nm": "string",
  • "nt_receiver_nm": "string",
  • "nt_start_dt": "2019-08-24T14:15:22Z",
  • "nt_end_dt": "2019-08-24T14:15:22Z",
  • "nt_vessel_nm": "string",
  • "nt_vessel_est_arrived_dt": "2019-08-24T14:15:22Z",
  • "nt_goods_particulars": [
    ],
  • "nt_laycan": "string",
  • "nt_doc_instruction": "string",
  • "nt_nom_desc": "string",
  • "attachments": [
    ]
}

Notice of Readiness

Data Element ID: notice_of_readiness

nor_charter_party
string or null (Nor Charter Party)

:Name of Charter Party
:Charter Party
:Name of Charter Party
:NA
:NA

nor_vessel_nm
required
string (Nor Vessel Nm)

:Name of Vessel
:Vessel Name
:Name of vessel
:NA
:NA

nor_vessel_flag
string or null (Nor Vessel Flag)

:Flag of Vessel
:Vessel Flag
:Flag of the vessel
:NA
:NA

nor_call_sign
string or null (Nor Call Sign)

:Call Sign of Vessel
:Call Sign
:Call Sign of Vessel
:NA
:NA

nor_arrival_time
required
string <date-time> (Nor Arrival Time)

:Arrival Time of Vessel
:Arrival Time
:Arrival Time of Vessel
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

nor_arrival_date
required
string <date> (Nor Arrival Date)

:Arrival Date of Vessel
:Arrival Date
:Arrival Date of Vessel
:NA
:date (YYYY-MM-DD)

nor_port
required
string (Nor Port)

:Arrival Port of Vessel
:Arrival Port
:Arrival Port of Vessel
:NA
:NA

nor_cargo
required
string (Nor Cargo)

:Cargo onboard Vessel
:Cargo
:Description of cargo on-board
:NA
:NA

nor_flow
required
string (Nor Flow)

:Readiness to commence Loading or Discharge
:Flow
:Readiness to commence Loading or Discharge
:NA
:NA

nor_issuance_place
required
string (Nor Issuance Place)

:Issuance Place of NOR
:Issuance Place
:Issuance Place of NOR
:NA
:NA

nor_issuance_time
required
string <date-time> (Nor Issuance Time)

:Issuance Time of NOR
:Issuance Time
:Issuance Time of NOR
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

nor_issuance_date
required
string <date> (Nor Issuance Date)

:Issuance Date of NOR
:Issuance Date
:Issuance Date of NOR
:NA
:date (YYYY-MM-DD)

nor_statement
string or null (Nor Statement)

:Official NOR Statement text
:NOR Statement
:Official NOR Statement text
:NA
:NA

Array of objects or null (Attachments) non-empty

:Attachment of Notice of Readiness
:Notice of Readiness Attachment
:Attachment of Notice of Readiness
:NA
:NA

{
  • "nor_charter_party": "string",
  • "nor_vessel_nm": "string",
  • "nor_vessel_flag": "string",
  • "nor_call_sign": "string",
  • "nor_arrival_time": "2019-08-24T14:15:22Z",
  • "nor_arrival_date": "2019-08-24",
  • "nor_port": "string",
  • "nor_cargo": "string",
  • "nor_flow": "string",
  • "nor_issuance_place": "string",
  • "nor_issuance_time": "2019-08-24T14:15:22Z",
  • "nor_issuance_date": "2019-08-24",
  • "nor_statement": "string",
  • "attachments": [
    ]
}

Oil Cargo Bill of Lading

Data Element ID: bill_of_lading

bl_doc_no
string or null (Bl Doc No)

:Document Number of Bill of Lading
:Oil Cargo Bill of Lading Document Number
:Document Number of Bill of Lading
:NA
:NA

bl_dt
required
string <date> (Bl Dt)

:Date when cargo is loaded on board the vessel / BL Date
:Date of Operation
:Date of Operation
:ISO 8601
:ISO Date Format (YYYY-MM-DD)

bl_shipper_nm
string or null (Bl Shipper Nm)

:Name of Shipper
:Name of Shipper
:Name of Shipper
:NA
:NA

bl_consignee_nm
string or null (Bl Consignee Nm)

:Name of Consignee
:Name of Consignee
:Name of Consignee
:NA
:NA

bl_terminal_nm
string or null (Bl Terminal Nm)

:Terminal Name
:Terminal Name
:Terminal Name
:NA
:NA

bl_port_of_loading
string or null (Bl Port Of Loading)

:Port which goods were loaded
:Port of Loading
:Port of loading
:NA
:NA

bl_port_of_discharge
string or null (Bl Port Of Discharge)

:Port which goods will be discharged
:Port of Discharge
:Port of discharge
:NA
:NA

bl_vessel_nm
string or null (Bl Vessel Nm)

:Name of Vessel
:Vessel Name
:Name of vessel
:NA
:NA

bl_country_of_origin
string or null (Bl Country Of Origin)

:Country of Origin
:Country of Origin
:Country of Origin
:NA
:NA

bl_country_of_destination
string or null (Bl Country Of Destination)

:Country of Destination
:Country of Destination
:Country of Destination
:NA
:NA

Array of objects or null (Bl Goods Particulars)

:NA
:Goods Particulars
:Particulars of goods
:NA
:NA

Array of objects or null (Attachments) non-empty

:NA
:Bill of Lading Attachment
:Bill of Lading Attachment
:NA
:NA

bl_order_no
string or null (Bl Order No)

:Order Number of Bill of Lading
:Oil Cargo Bill of Lading Order Number
:Order Number of Bill of Lading
:NA
:NA

bl_vessel_flag
string or null (Bl Vessel Flag)

:Flag of Vessel
:Vessel Flag
:Flag of the vessel
:NA
:NA

bl_master_nm
string or null (Bl Master Nm)

:Name of barge vessel master
:Name of Barge Vessel Master
:Name of Barge Vessel Master
:NA
:NA

bl_terms_and_condition_and_other_text
string or null (Bl Terms And Condition And Other Text)

:Terms and Condition and any other text
:Terms and Conditions and any other Text
:Terms and Conditions and any other Text
:NA
:NA

bl_vessel_imo_no
string or null (Bl Vessel Imo No)

:IMO Number of Vessel
:Vessel International Maritime Organisation Number
:International Maritime Organisation (IMO) Vessel Identification Number
:IHSM
:7 digit Numeric Characters Only

bl_notify_party_nm
string or null (Bl Notify Party Nm)

:Name of Notify Party
:Name of Notify Party
:Name of Notify Party
:NA
:NA

{
  • "bl_doc_no": "string",
  • "bl_dt": "2019-08-24",
  • "bl_shipper_nm": "string",
  • "bl_consignee_nm": "string",
  • "bl_terminal_nm": "string",
  • "bl_port_of_loading": "string",
  • "bl_port_of_discharge": "string",
  • "bl_vessel_nm": "string",
  • "bl_country_of_origin": "string",
  • "bl_country_of_destination": "string",
  • "bl_goods_particulars": [
    ],
  • "attachments": [
    ],
  • "bl_order_no": "string",
  • "bl_vessel_flag": "string",
  • "bl_master_nm": "string",
  • "bl_terms_and_condition_and_other_text": "string",
  • "bl_vessel_imo_no": "string",
  • "bl_notify_party_nm": "string"
}

Oil Cargo Contract

Data Element ID: contract

contract_no
string or null (Contract No)

:Sales/Purchase Contract Number
:Contract Number
:Identifier number of Sales/Purchase Contract
:NA
:NA

contract_trade_no
required
string (Contract Trade No)

:Trade Number of contract
:Oil Cargo Contract Trade Number
:Trade Number of contract
:NA
:NA

contract_trade_type
string or null (Contract Trade Type)

:Trade Type of contract (e.g. Spot Sale, Term Sale, Spot Purchase, Term Purchase)
:Trade Type
:Trade Type of contract (e.g. Spot Sale, Term Sale, Spot Purchase, Term Purchase)
:NA
:NA

contract_company_nm
string or null (Contract Company Nm)

:Name of company performing the trade
:Company Name
:Name of company performing the trade
:NA
:NA

contract_counterparty_nm
string or null (Contract Counterparty Nm)

:Name of counterparty performing the trade
:Counterparty Name
:Name of counterparty performing the trade
:NA
:NA

Array of objects or null (Contract Goods Particulars)

:Goods being transacted
:Goods Particulars
:Particulars of goods
:NA
:NA

contract_currency
string or null (Contract Currency)

:Currency used to calculate price being transacted
:Currency
:Currency used to calculate price being transacted
:NA
:NA

contract_payment_terms
string or null (Contract Payment Terms)

:Mode of payment and terms for purchase/sales
:Payment Terms
:Mode of payment and terms for purchase/sales
:NA
:NA

contract_credit_terms
string or null (Contract Credit Terms)

:Date when payment is due for sales made on account/credit
:Credit Terms
:Date when payment is due for sales made on account/credit
:NA
:NA

contract_inco_terms
string or null (Contract Inco Terms)

:Set of of instructions used in the global transportation of goods which define the division of responsibility between the Shipper (usually the supplier/consignor) and the Consignee (usually the buyer).
:Inco Terms
:Set of of instructions used in the global transportation of goods which define the division of responsibility between the Shipper (usually the supplier/consignor) and the Consignee (usually the buyer).
:NA
:NA

contract_quantity_tolerance
string or null (Contract Quantity Tolerance)

:Operational tolerance of quantity, ie +/-5% or “max/ min” amount
:Quantity Tolerance
:Operational tolerance of quantity, ie +/-5% or “max/ min” amount
:NA
:NA

contract_port_of_loading
string or null (Contract Port Of Loading)

:Port where goods being transacted will be loaded
:Port of Loading
:Port of loading
:NA
:NA

contract_port_of_discharge
string or null (Contract Port Of Discharge)

:Port where goods being transacted will be discharged
:Port of Discharge
:Port of discharge
:NA
:NA

Array of objects or null (Attachments) non-empty

:NA
:Contract Attachment
:Contract attachment version of Sales/Purchase Contract
:NA
:NA

{
  • "contract_no": "string",
  • "contract_trade_no": "string",
  • "contract_trade_type": "string",
  • "contract_company_nm": "string",
  • "contract_counterparty_nm": "string",
  • "contract_goods_particulars": [
    ],
  • "contract_currency": "string",
  • "contract_payment_terms": "string",
  • "contract_credit_terms": "string",
  • "contract_inco_terms": "string",
  • "contract_quantity_tolerance": "string",
  • "contract_port_of_loading": "string",
  • "contract_port_of_discharge": "string",
  • "attachments": [
    ]
}

Oil Cargo Discharge Certificate

Data Element ID: discharge_certificate

discharge_doc_no
required
string (Discharge Doc No)

:Identifier number of the Discharge Certificate
:Oil Terminal Discharge Certificate Document Number
:Identifier number of the Discharge Certificate
:NA
:NA

discharge_order_no
required
string (Discharge Order No)

:Order number from source system
:Oil Terminal Discharge Certificate Order Number
:Order number from source system
:NA
:NA

discharge_dt
required
string <date> (Discharge Dt)

:Date of discharge certificate
:Oil Terminal Discharge Certificate Date
:Date of discharge certificate
:ISO 8601
:date (YYYY-MM-DD)

discharge_customer_nm
required
string (Discharge Customer Nm)

:Name of Customer
:Customer Name
:Name of Buyer
:NA
:NA

discharge_started_dt
required
string <date-time> (Discharge Started Dt)

:Date and time when discharging of cargo started
:Cargo Started Time
:Date and time when discharging of cargo started
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

discharge_finished_dt
required
string <date-time> (Discharge Finished Dt)

:Date and time when discharging of cargo finished
:Cargo Finished Time
:Date and time when discharging of cargo finished
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

discharge_vessel_est_sailing_dt
required
string <date-time> (Discharge Vessel Est Sailing Dt)

:Estimated sailing time of vessel
:Vessel Estimated Sailing Time
:Estimated sailing time of vessel
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

discharge_address
required
string (Discharge Address)

:Address of port where cargo was discharged
:Discharge Address
:Address of port where cargo was discharged
:NA
:NA

discharge_city
required
string (Discharge City)

:City of port where cargo was discharged
:Discharge City
:City of port where cargo was discharged
:NA
:NA

discharge_country
required
string (Discharge Country)

:Country of port where cargo was discharged
:Discharge Country
:Country of port where cargo was discharged
:NA
:NA

discharge_vessel_nm
required
string (Discharge Vessel Nm)

:Name of vessel
:Vessel Name
:Name of vessel
:NA
:NA

discharge_vessel_flag
string or null (Discharge Vessel Flag)

:Flag of the vessel
:Vessel Flag
:Flag of the vessel
:NA
:NA

required
Array of objects (Discharge Goods Particulars)

:Particulars of goods
:Goods Particulars
:Particulars of goods
:NA
:NA

required
Array of objects (Attachments) non-empty

:Discharge Certificate Attachments
:Discharge Certificate Attachment
:Discharge Certificate Attachment
:NA
:NA

{
  • "discharge_doc_no": "string",
  • "discharge_order_no": "string",
  • "discharge_dt": "2019-08-24",
  • "discharge_customer_nm": "string",
  • "discharge_started_dt": "2019-08-24T14:15:22Z",
  • "discharge_finished_dt": "2019-08-24T14:15:22Z",
  • "discharge_vessel_est_sailing_dt": "2019-08-24T14:15:22Z",
  • "discharge_address": "string",
  • "discharge_city": "string",
  • "discharge_country": "string",
  • "discharge_vessel_nm": "string",
  • "discharge_vessel_flag": "string",
  • "discharge_goods_particulars": [
    ],
  • "attachments": [
    ]
}

Oil Cargo Holding Certificate

Data Element ID: holding_certificate

holding_customer_nm
string or null (Holding Customer Nm)

:Name of Customer
:Customer Name
:Name of Buyer
:NA
:NA

holding_dt
required
string <date> (Holding Dt)

:Date of Holding Certificate Issuance
:Holding Certificate Date
:Date of Holding Certificate Issuance
:ISO 8601
:date (YYYY-MM-DD)

holding_customer_address
string or null (Holding Customer Address)

:Address of Customer
:Customer Address
:Address of Buyer
:NA
:NA

holding_terminal_operator
string or null (Holding Terminal Operator)

:Name of terminal operator
:Terminal Operator
:Name of terminal operator
:NA
:NA

holding_terminal_operator_address
string or null (Holding Terminal Operator Address)

:Address of terminal operator
:Terminal Operator Address
:Address of terminal operator
:NA
:NA

holding_reference_no
string or null (Reference Number)

:Reference Number of the document
:Reference Number
:Reference Number of the document
:NA
:NA

Array of objects or null (Holding Goods Particulars)

:Goods being held
:Goods Particulars
:Particulars of goods
:NA
:NA

holding_financing_bank
string or null (Holding Financing Bank)

:Financing Bank that is addressed in Holding Certificate
:Financing Bank
:Holding certificate being addressed to Financing Bank
:NA
:NA

Array of objects or null (Attachments) non-empty

:NA
:Holding Certificate Attachment
:Holding Certificate Attachments
:NA
:NA

{
  • "holding_customer_nm": "string",
  • "holding_dt": "2019-08-24",
  • "holding_customer_address": "string",
  • "holding_terminal_operator": "string",
  • "holding_terminal_operator_address": "string",
  • "holding_reference_no": "string",
  • "holding_goods_particulars": [
    ],
  • "holding_financing_bank": "string",
  • "attachments": [
    ]
}

Oil Cargo Invoice

Data Element ID: invoice

invoice_no
string or null (Invoice No)

:Invoice Number
:Invoice Number
:Identifier number of invoice
:NA
:NA

invoice_trade_no
required
string (Invoice Trade No)

:Trade Number of invoice
:Oil Cargo Invoice Trade Number
:Trade Number of invoice
:NA
:NA

invoice_dt
string or null <date> (Invoice Dt)

:Date when invoice was issued
:Invoice Date
:Date where invoice was issued
:ISO 8601
:date (YYYY-MM-DD)

invoice_beneficiary_bank_nm
string or null (Invoice Beneficiary Bank Nm)

:Name of the beneficiary bank
:Beneficiary Bank Name
:Name of the beneficiary bank
:NA
:NA

invoice_beneficiary_bank_swift_cd
string or null (Invoice Beneficiary Bank Swift Cd)

:Swift code of the beneficiary bank
:Beneficiary Bank Swift Code
:Swift code of the beneficiary bank
:NA
:NA

Array of objects or null (Invoice Goods Particulars)

:Goods being transacted
:Goods Particulars
:Particulars of goods
:NA
:NA

invoice_total_payment_amt
number or null <double> (Invoice Total Payment Amt)

:Total amount of payment for goods being transacted
:Total Payment Amount
:Total amount of payment for goods being transacted
:NA
:NA

invoice_currency
string or null (Invoice Currency)

:Currency used to calculate price being transacted
:Currency
:Currency used to calculate price being transacted
:NA
:NA

Array of objects or null (Attachments) non-empty

:NA
:Invoice Attachment
:Attachment version of Purchase/Sales Invoice
:NA
:NA

{
  • "invoice_no": "string",
  • "invoice_trade_no": "string",
  • "invoice_dt": "2019-08-24",
  • "invoice_beneficiary_bank_nm": "string",
  • "invoice_beneficiary_bank_swift_cd": "string",
  • "invoice_goods_particulars": [
    ],
  • "invoice_total_payment_amt": 0.1,
  • "invoice_currency": "string",
  • "attachments": [
    ]
}

Oil Terminal Storage Transaction

Data Element ID: inventory_transaction

it_case_type
required
string (It Case Type)

:Type of Case
:Type of Case
:Type of case
:NA
:NA

it_transaction_type
required
string (It Transaction Type)

:Type of Transaction
:Type of Transaction
:Type of Transaction
:NA
:NA

it_case_title
required
string (It Case Title)

:Title of case
:Title of case
:Title of case
:NA
:NA

it_trade_no
required
string (It Trade No)

:Trade Number
:Oil Terminal Storage Transaction Trade Number
:Trade Number of storage transaction
:NA
:NA

it_transport_unit
required
string (It Transport Unit)

:Transport Unit
:Transport Unit
:Transport Unit
:NA
:NA

Array of objects or null (It Goods Particulars)

:Goods particulars
:Goods particulars
:Particulars of goods
:NA
:NA

Array of objects or null (Attachments)

:Inventory Transaction Attachment
:Inventory Transaction Attachment
:Attachment of Inventory Transaction
:NA
:NA

it_comments
string or null (It Comments)

:Comments
:Inventory Transaction Comments
:Inventory Transaction Attachment content stored in an encoded string format
:NA
:NA

it_financier_financing_line_info
string or null (It Financier Financing Line Info)

:Financier Financing Line Info
:Financier Financing Line Information
:Financing Line Information
:NA
:NA

it_financier_approval
string or null (It Financier Approval)

:Financier Approval
:Financier Approval
:Approval by financier
:NA
:NA

it_terminal_ack
string or null (It Terminal Ack)

:Terminal Acknowledgement
:Terminal Acknowledgement
:Acknowledgement by terminal
:NA
:NA

{
  • "it_case_type": "string",
  • "it_transaction_type": "string",
  • "it_case_title": "string",
  • "it_trade_no": "string",
  • "it_transport_unit": "string",
  • "it_goods_particulars": [
    ],
  • "attachments": [
    ],
  • "it_comments": "string",
  • "it_financier_financing_line_info": "string",
  • "it_financier_approval": "string",
  • "it_terminal_ack": "string"
}

On Board Quantity

Data Element ID: on_board_quantity

obq_vessel
required
string (Obq Vessel)

:Name of Vessel
:Vessel Name
:Name of Vessel
:NA
:NA

obq_cargo
required
string (Obq Cargo)

:Description of cargo on-board
:Cargo
:Description of cargo on-board
:NA
:NA

obq_port
required
string (Obq Port)

:Name of Port
:Port
:Name of Port
:NA
:NA

obq_datetime
required
string <date-time> (Obq Datetime)

:Date of Issuance
:Datetime
:Date of Issuance
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

Array of objects or null (Obq Particulars)

:Table containing tank measurements
:OBQ Particulars
:Table containing tank measurements
:NA
:NA

Array of objects or null (Obq Totals)

:Total volumes remaining on board
:Totals
:Total volumes remaining on board
:NA
:NA

Array of objects or null (Obq Draft)

:Draft
:Draft
:Draft
:NA
:NA

{
  • "obq_vessel": "string",
  • "obq_cargo": "string",
  • "obq_port": "string",
  • "obq_datetime": "2019-08-24T14:15:22Z",
  • "obq_particulars": [
    ],
  • "obq_totals": [
    ],
  • "obq_draft": [
    ]
}

Remaining On Board

Data Element ID: remaining_on_board

rob_vessel
required
string (Rob Vessel)

:Name of Vessel
:Vessel Name
:Name of Vessel
:NA
:NA

rob_cargo
required
string (Rob Cargo)

:Description of cargo on-board
:Cargo
:Description of cargo on-board
:NA
:NA

rob_port
required
string (Rob Port)

:Name of Port
:Port
:Name of Port
:NA
:NA

rob_datetime
required
string <date> (Rob Datetime)

:Date of Issuance
:Datetime
:Date of Issuance
:NA
:date (YYYY-MM-DD)

Array of objects or null (Rob Particulars)

:Table containing tank measurements
:ROB Particulars
:Table containing tank measurements
:NA
:NA

Array of objects or null (Rob Totals)

:Total volumes remaining on board
:Totals
:Total volumes remaining on board
:NA
:NA

Array of objects or null (Rob Draft)

:Draft
:Draft
:Draft
:NA
:NA

rob_statement
string or null (Rob Statement)

:Statement of ROB
:ROB Statement
:Statement of ROB
:NA
:NA

rob_quantity_in_lines
number or null (Rob Quantity In Lines)

:Quantity remaining in lines
:Quantity in Lines
:Quantity remaining in lines
:NA
:NA

rob_lines_to_tank
string or null (Rob Lines To Tank)

:Tanks that lines must discharge to
:Lines to Tank
:Tanks that lines must discharge to
:NA
:NA

rob_sample_tank
string or null (Rob Sample Tank)

:Tank for sampling
:Sample tank
:Tank for sampling
:NA
:NA

{
  • "rob_vessel": "string",
  • "rob_cargo": "string",
  • "rob_port": "string",
  • "rob_datetime": "2019-08-24",
  • "rob_particulars": [
    ],
  • "rob_totals": [
    ],
  • "rob_draft": [
    ],
  • "rob_statement": "string",
  • "rob_quantity_in_lines": 0,
  • "rob_lines_to_tank": "string",
  • "rob_sample_tank": "string"
}

Tank Levels

Data Element ID: tank_levels

tl_terminal_name
required
string (Oil Terminal Name)

:Oil Terminal Name
:Oil Terminal Name
:Oil Terminal Name
:NA
:NA

tl_effectivedate_time
required
string <date-time> (Effective Date and Time)

:Effective Date and Time
:Effective Date and Time
:Effective Date and Time
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDThh:mm:ssZ)

tl_tank_no
required
string (Tank Number/ID)

:Tank Number/ID
:Tank Number/ID
:Tank Number/ID
:NA
:NA

tl_product_type
string or null (Product Type)

:Product Type
:Product Type
:Product Type
:NA
:NA

tl_product_grade
string or null (Product Grade)

:Product Grade
:Product Grade
:Product Grade
:NA
:NA

tl_qty_amt
required
number (Quantity Amount)

:Quantity Amount
:Quantity Amount
:Quantity Amount
:NA
:NA

tl_qty_uom
required
string (Unit of Measurement of Goods)

:Unit of Measurement of Goods Quantity
:Unit of Measurement of Goods
:Unit of Measurement of Goods Quantity
:NA
:NA

tl_temp_comp_volume
string or null (Temperature Compensated Volume)

:Temperature Compensated Volume
:Temperature Compensated Volume
:Temperature Compensated Volume
:NA
:NA

tl_ambient_volume
string or null (Ambient Volume)

:Ambient Volume
:Ambient Volume
:Ambient Volume
:NA
:NA

tl_qty_temperature
string or null (Temperature of Goods)

:Temperature of Goods
:Temperature of Goods
:Temperature of Goods
:NA
:NA

tl_qty_density
string or null (Density of Goods)

:Density of Goods
:Density of Goods
:Density of Goods
:NA
:NA

tl_geo_latitude
number or null (Geographic Latitude)

:Latitude of the location
:Geographic Latitude
:Latitude of the location
:NA
:NA

tl_geo_longtitude
number or null (Geographic Longtitude)

:Longtitude of the location
:Geographic Longtitude
:Longtitude of the location
:NA
:NA

Array of objects or null (Tank Levels Attachment)

:Attachment version of Tank Levels
:Tank Levels Attachment
:Attachment version of Tank Levels
:NA
:NA

{
  • "tl_terminal_name": "string",
  • "tl_effectivedate_time": "2019-08-24T14:15:22Z",
  • "tl_tank_no": "string",
  • "tl_product_type": "string",
  • "tl_product_grade": "string",
  • "tl_qty_amt": 0,
  • "tl_qty_uom": "string",
  • "tl_temp_comp_volume": "string",
  • "tl_ambient_volume": "string",
  • "tl_qty_temperature": "string",
  • "tl_qty_density": "string",
  • "tl_geo_latitude": 0,
  • "tl_geo_longtitude": 0,
  • "attachments": [
    ]
}

Tank Movement Discharge

Data Element ID: tank_movement_discharge

tmd_terminal_name
required
string (Oil Terminal Name)

:Oil Terminal Name
:Oil Terminal Name
:Oil Terminal Name
:NA
:NA

tmd_discharge_date_time
required
string <date-time> (Discharge Start Date & Time)

:Start date and time for discharge of goods
:Discharge Start Date and Time
:Start date and time for discharge of goods
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

tmd_end_date_time
required
string <date-time> (Discharge End Date and Time)

:End date and time for discharge of goods
:Discharge End Date and Time
:End date and time for discharge of goods
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDThh:mm:ssZ)

tmd_destination
required
string (Destination)

:Destination of discharged goods (Tank Number/ID)
:Destination
:Destination of discharged goods (Tank Number/ID)
:NA
:NA

tmd_origin
required
string (Source)

:Source of discharged goods (Tank/Vessel/Barge)
:Source
:Source of discharged goods (Tank/Vessel/Barge)
:NA
:NA

tmd_product_grade
string or null (Product Grade)

:Product Grade
:Product Grade
:Product Grade
:NA
:NA

tmd_product_type
string or null (Product Type)

:Product Type
:Product Type
:Product Type
:NA
:NA

tmd_qty_amt
required
number (Quantity Amount)

:Quantity Amount
:Quantity Amount
:Quantity Amount
:NA
:NA

tmd_qty_uom
required
string (Unit of Measurement of Goods)

:Unit of Measurement of Goods Quantity
:Unit of Measurement of Goods
:Unit of Measurement of Goods Quantity
:NA
:NA

tmd_temp_comp_volume
string or null (Temperature Compensated Volume)

:Temperature Compensated Volume
:Temperature Compensated Volume
:Temperature Compensated Volume
:NA
:NA

tmd_ambient_volume
string or null (Ambient Volume)

:Ambient Volume
:Ambient Volume
:Ambient Volume
:NA
:NA

tmd_qty_temperature
string or null (Temperature of Goods)

:Temperature of Goods
:Temperature of Goods
:Temperature of Goods
:NA
:NA

tmd_qty_density
string or null (Density of Goods)

:Density of Goods
:Density of Goods
:Density of Goods
:NA
:NA

tmd_geo_latitude
number or null (Geographic Latitude)

:Latitude of the location
:Geographic Latitude
:Latitude of the location
:NA
:NA

tmd_geo_longtitude
number or null (Geographic Longtitude)

:Longtitude of the location
:Geographic Longtitude
:Longtitude of the location
:NA
:NA

Array of objects or null (Tank Discharge Attachment)

:Attachment version of Tank Movement (Discharge)
:Tank Discharge Attachment
:Attachment version of Tank Movement (Discharge)
:NA
:NA

{
  • "tmd_terminal_name": "string",
  • "tmd_discharge_date_time": "2019-08-24T14:15:22Z",
  • "tmd_end_date_time": "2019-08-24T14:15:22Z",
  • "tmd_destination": "string",
  • "tmd_origin": "string",
  • "tmd_product_grade": "string",
  • "tmd_product_type": "string",
  • "tmd_qty_amt": 0,
  • "tmd_qty_uom": "string",
  • "tmd_temp_comp_volume": "string",
  • "tmd_ambient_volume": "string",
  • "tmd_qty_temperature": "string",
  • "tmd_qty_density": "string",
  • "tmd_geo_latitude": 0,
  • "tmd_geo_longtitude": 0,
  • "attachments": [
    ]
}

Tank Movement Inter Tank Transfer

Data Element ID: tank_movement_inter_tank_transfer

tmt_terminal_name
required
string (Oil Terminal Name)

:Oil Terminal Name
:Oil Terminal Name
:Oil Terminal Name
:NA
:NA

tmt_transfer_date_time
required
string <date-time> (Transfer Start Date & Time)

:Start date and time for transfer of goods
:Transfer Start Date and Time
:Start date and time for transfer of goods
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

tmt_end_date_time
required
string <date-time> (Transfer End Date & Time)

:End date and time for transfer of goods
:Transfer End Date and Time
:End date and time for transfer of goods
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

tmt_destination
required
string (Destination)

:Destination of loaded goods (Tank Number/ID)
:Destination
:Destination of loaded goods (Tank Number/ID)
:NA
:NA

tmt_origin
required
string (Source)

:Source of loaded goods (Tank Number/ID)
:Source
:Source of loaded goods (Tank Number/ID)
:NA
:NA

tmt_product_type
string or null (Product Type)

:Product Type
:Product Type
:Product Type
:NA
:NA

tmt_product_grade
string or null (Product Grade)

:Product Grade
:Product Grade
:Product Grade
:NA
:NA

tmt_qty_amt
required
number (Quantity Amount)

:Quantity Amount
:Quantity Amount
:Quantity Amount
:NA
:NA

tmt_qty_uom
required
string (Unit of Measurement of Goods)

:Unit of Measurement of Goods Quantity
:Unit of Measurement of Goods
:Unit of Measurement of Goods Quantity
:NA
:NA

tmt_temp_comp_volume
string or null (Temperature Compensated Volume)

:Temperature Compensated Volume
:Temperature Compensated Volume
:Temperature Compensated Volume
:NA
:NA

tmt_ambient_volume
string or null (Ambient Volume)

:Ambient Volume
:Ambient Volume
:Ambient Volume
:NA
:NA

tmt_qty_temperature
string or null (Temperature of Goods)

:Temperature of Goods
:Temperature of Goods
:Temperature of Goods
:NA
:NA

tmt_qty_density
string or null (Density of Goods)

:Density of Goods
:Density of Goods
:Density of Goods
:NA
:NA

tmt_geo_latitude
number or null (Geographic Latitude)

:Latitude of the location
:Geographic Latitude
:Latitude of the location
:NA
:NA

tmt_geo_longtitude
number or null (Geographic Longtitude)

:Longtitude of the location
:Geographic Longtitude
:Longtitude of the location
:NA
:NA

Array of objects or null (ITT Movement Attachment)

:Attachment version of ITT
:ITT Movement Attachment
:Attachment version of ITT
:NA
:NA

{
  • "tmt_terminal_name": "string",
  • "tmt_transfer_date_time": "2019-08-24T14:15:22Z",
  • "tmt_end_date_time": "2019-08-24T14:15:22Z",
  • "tmt_destination": "string",
  • "tmt_origin": "string",
  • "tmt_product_type": "string",
  • "tmt_product_grade": "string",
  • "tmt_qty_amt": 0,
  • "tmt_qty_uom": "string",
  • "tmt_temp_comp_volume": "string",
  • "tmt_ambient_volume": "string",
  • "tmt_qty_temperature": "string",
  • "tmt_qty_density": "string",
  • "tmt_geo_latitude": 0,
  • "tmt_geo_longtitude": 0,
  • "attachments": [
    ]
}

Tank Movement Loading

Data Element ID: tank_movement_loading

tml_terminal_name
required
string (Oil Terminal Name)

:Oil Terminal Name
:Oil Terminal Name
:Oil Terminal Name
:NA
:NA

tml_loading_date_time
required
string <date-time> (Loading Start Date and Time)

:Start date and time for loading of goods
:Loading Start Date and Time
:Start date and time for loading of goods
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDThh:mm:ssZ)

tml_end_date_time
required
string <date-time> (Loading End Date and Time)

:End date and time for loading of goods
:Loading End Date and Time
:End date and time for loading of goods
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDThh:mm:ssZ)

tml_destination
required
string (Destination)

:Destination of loaded goods (Tank/Vessel/Barge)
:Destination
:Destination of loaded goods (Tank/Vessel/Barge)
:NA
:NA

tml_origin
required
string (Source)

:Source of loaded goods (Tank Number/ID)
:Source
:Source of loaded goods (Tank Number/ID)
:NA
:NA

tml_product_type
string or null (Product Type)

:Product Type
:Product Type
:Product Type
:NA
:NA

tml_product_grade
string or null (Product Grade)

:Product Grade
:Product Grade
:Product Grade
:NA
:NA

tml_qty_amt
required
number (Quantity Amount)

:Quantity Amount
:Quantity Amount
:Quantity Amount
:NA
:NA

tml_qty_uom
required
string (Unit of Measurement of Goods)

:Unit of Measurement of Goods Quantity
:Unit of Measurement of Goods
:Unit of Measurement of Goods Quantity
:NA
:NA

tml_temp_comp_volume
string or null (Temperature Compensated Volume)

:Temperature Compensated Volume
:Temperature Compensated Volume
:Temperature Compensated Volume
:NA
:NA

tml_ambient_volume
string or null (Ambient Volume)

:Ambient Volume
:Ambient Volume
:Ambient Volume
:NA
:NA

tml_qty_temperature
string or null (Temperature of Goods)

:Temperature of Goods
:Temperature of Goods
:Temperature of Goods
:NA
:NA

tml_qty_density
string or null (Density of Goods)

:Density of Goods
:Density of Goods
:Density of Goods
:NA
:NA

tml_geo_latitude
number or null (Geographic Latitude)

:Latitude of the location
:Geographic Latitude
:Latitude of the location
:NA
:NA

tml_geo_longtitude
number or null (Geographic Longtitude)

:Longtitude of the location
:Geographic Longtitude
:Longtitude of the location
:NA
:NA

Array of objects or null (Tank Loading Attachment)

:Attachment version of Tank Movement (Loading)
:Tank Loading Attachment
:Attachment version of Tank Movement (Loading)
:NA
:NA

{
  • "tml_terminal_name": "string",
  • "tml_loading_date_time": "2019-08-24T14:15:22Z",
  • "tml_end_date_time": "2019-08-24T14:15:22Z",
  • "tml_destination": "string",
  • "tml_origin": "string",
  • "tml_product_type": "string",
  • "tml_product_grade": "string",
  • "tml_qty_amt": 0,
  • "tml_qty_uom": "string",
  • "tml_temp_comp_volume": "string",
  • "tml_ambient_volume": "string",
  • "tml_qty_temperature": "string",
  • "tml_qty_density": "string",
  • "tml_geo_latitude": 0,
  • "tml_geo_longtitude": 0,
  • "attachments": [
    ]
}

Ullage Report

Data Element ID: ullage_report

ullage_vessel
required
string (Ullage Vessel)

:Name of Vessel
:Vessel Name
:Name of Vessel
:NA
:NA

ullage_cargo
required
string (Ullage Cargo)

:Description of cargo on-board
:Cargo
:Description of cargo on-board
:NA
:NA

ullage_port
required
string (Ullage Port)

:Name of Port
:Port
:Name of Port
:NA
:NA

ullage_date
required
string <date-time> (Ullage Date)

:Date of Issuance
:Date
:Date of Issuance
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

ullage_terminal_berth
required
string (Ullage Terminal Berth)

:Name of terminal/berth
:Terminal/ Berth
:Name of terminal/berth
:NA
:NA

Array of objects or null (Ullage Draft)

:NA
:Draft
:Draft
:NA
:NA

ullage_before
required
string (Ullage Before)

:Ullage report for before or after loading or discharging
:Before
:Ullage report for before or after loading or discharging
:NA
:NA

ullage_after
required
string (Ullage After)

:Ullage report for before or after loading or discharging
:After
:Ullage report for before or after loading or discharging
:NA
:NA

ullage_loading
required
string (Ullage Loading)

:Ullage report for before or after loading or discharging
:Loading
:Ullage report for before or after loading or discharging
:NA
:NA

ullage_discharging
required
string (Ullage Discharging)

:Ullage report for before or after loading or discharging
:Discharging
:Ullage report for before or after loading or discharging
:NA
:NA

Array of objects or null (Ullage Particulars)

:Table containing tank measurements
:Ullage Particulars
:Table containing tank measurements
:NA
:NA

ullage_total_observed_volume
number or null (Ullage Total Observed Volume)

:Total observed ullage in all tanks
:Total observed volume (all tanks)
:Total observed ullage in all tanks
:NA
:NA

ullage_less_free_water
number or null (Ullage Less Free Water)

:Less free water in all tanks
:Less free water
:Less free water in all tanks
:NA
:NA

ullage_free_total_observed_volume
required
number (Ullage Free Total Observed Volume)

:Gross observed volume in all tanks
:Gross observed volume (all tanks)
:Gross observed volume in all tanks
:NA
:NA

ullage_avg_temp
number or null (Ullage Avg Temp)

:Average temperature across all tanks
:Average temp. deg F/C
:Average temperature across all tanks
:NA
:NA

ullage_avg_api_den
number or null (Ullage Avg Api Den)

:Average API/ Density for all tanks
:API (60 deg F) / DEN (15 deg C) (all tanks)
:Average API/ Density for all tanks
:NA
:NA

ullage_gross_standard_volume
required
number (Ullage Gross Standard Volume)

:Gross standard volume in all tanks
:Gross standard volume (all tanks)
:Gross standard volume in all tanks
:NA
:NA

ullage_plus_free_water
number or null (Ullage Plus Free Water)

:Plus free water in all tanks
:Plus free water
:Plus free water in all tanks
:NA
:NA

ullage_total_calculated_volume
number or null (Ullage Total Calculated Volume)

:Total calculated ullage in all tanks
:Total calculated volume (all tanks)
:Total calculated ullage in all tanks
:NA
:NA

ullage_less_OBQ
number or null (Ullage Less OBQ)

:Less OBQ in all tanks
:Less OBQ
:Less OBQ in all tanks
:NA
:NA

ullage_total_received_volume
number or null (Ullage Total Received Volume)

:Total received volume in all tanks
:Total received volume (all tanks)
:Total received volume in all tanks
:NA
:NA

ullage_weight_metric_tonnes
required
number (Ullage Weight Metric Tonnes)

:Total weight in all tanks
:Weight (metric tonnes)
:Total weight in all tanks
:NA
:NA

ullage_weight_long_tonnes
required
number (Ullage Weight Long Tonnes)

:Total weight in all tanks
:Weight (long tonnes)
:Total weight in all tanks
:NA
:NA

ullage_remarks
string or null (Ullage Remarks)

:Remarks
:Remarks
:Remarks
:NA
:NA

ullage_location of reference gauge point
string or null (Ullage Location of reference gauge point)

:Measurement Reference- Centre/ Aft/ Fwd
:Location of Reference Gauge
:Measurement Reference- Centre/ Aft/ Fwd
:NA
:NA

ullage_vef
number or null (Ullage Vef)

:Vessel Experience Factor
:VEF
:Vessel Experience Factor
:NA
:NA

{
  • "ullage_vessel": "string",
  • "ullage_cargo": "string",
  • "ullage_port": "string",
  • "ullage_date": "2019-08-24T14:15:22Z",
  • "ullage_terminal_berth": "string",
  • "ullage_draft": [
    ],
  • "ullage_before": "string",
  • "ullage_after": "string",
  • "ullage_loading": "string",
  • "ullage_discharging": "string",
  • "ullage_particulars": [
    ],
  • "ullage_total_observed_volume": 0,
  • "ullage_less_free_water": 0,
  • "ullage_free_total_observed_volume": 0,
  • "ullage_avg_temp": 0,
  • "ullage_avg_api_den": 0,
  • "ullage_gross_standard_volume": 0,
  • "ullage_plus_free_water": 0,
  • "ullage_total_calculated_volume": 0,
  • "ullage_less_OBQ": 0,
  • "ullage_total_received_volume": 0,
  • "ullage_weight_metric_tonnes": 0,
  • "ullage_weight_long_tonnes": 0,
  • "ullage_remarks": "string",
  • "ullage_location of reference gauge point": "string",
  • "ullage_vef": 0
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

:Note
:Note
:Note
:NA
:NA

Array of objects or null (Other Documents Attachment)

:Other Documents Attachment
:Other Documents Attachment
:Other Documents Attachment
:NA
:NA

{
  • "note": "string",
  • "attachments": [
    ]
}

Use Case A (Parameters)

Parameter schemas for Use Case A

Certificate Of Quality

Data Element ID: certificate_of_quality

coq_sample_no
required
Array of strings (Coq Sample No)

Sample Number

{
  • "coq_sample_no": [
    ]
}

Certificate Of Quantity

Data Element ID: certificate_of_quantity

cq_order_no
required
Array of strings (Cq Order No)

Order Number

cq_doc_no
required
Array of strings (Cq Doc No)

Certificate of Quantity / Document Number

{
  • "cq_order_no": [
    ],
  • "cq_doc_no": [
    ]
}

Inter Tank Transfer Certificate

Data Element ID: inter_tank_transfer_certificate

ittc_certificate_number
required
string (Ittc Certificate Number)

Certificate Number

{
  • "ittc_certificate_number": "string"
}

Last Vessel Arrival Declaration

Data Element ID: vessel_event

vessel_nm
required
string (Vessel Nm)

Name of vessel

{
  • "vessel_nm": "string"
}

Letter Of Credit

Data Element ID: letter_of_credit

lc_dt_of_issue
required
string <date> (Lc Doc Lc No)
{
  • "lc_dt_of_issue": "2019-08-24"
}

Lei Record

Data Element ID: lei_record

lei_code
required
string (LEI Code)

A Legal Entity Identifier (LEI) code in the format specified by ISO 17442

{
  • "lei_code": "string"
}

Letter Of Credit Application

Data Element ID: letter_of_credit_application

lca_date
required
string <date> (Date)

Date of document

{
  • "lca_date": "2019-08-24"
}

Nominated Oil Terminal Instructions

Data Element ID: nominated_terminal

requestId
string

Optional field. Include if you know the requestId for your resource.
requestId - Unique ID generated for the request

sourceSystemId
string (Source System Id)

Optional field. Own Source System's Id for Notification. Participant can ignore it when flow is anything other than PUSH or PULL.

Array of objects (participant)
Array of objects
{
  • "requestId": "string",
  • "sourceSystemId": "string",
  • "participants": [
    ],
  • "on_behalf_of": [
    ]
}

Notice of Readiness

Data Element ID: notice_of_readiness

nor_vessel_nm
required
string (Nor Vessel Nm)

Name of Vessel

nor_issuance_place
required
string (Nor Issuance Place)

Issuance Place of NOR

nor_issuance_time
required
string <date-time> (Nor Issuance Time)

Issuance Time of NOR

nor_issuance_date
required
string <date> (Nor Issuance Date)

Issuance Date of NOR

{
  • "nor_vessel_nm": "string",
  • "nor_issuance_place": "string",
  • "nor_issuance_time": "2019-08-24T14:15:22Z",
  • "nor_issuance_date": "2019-08-24"
}

Oil Cargo Bill of Lading

Data Element ID: bill_of_lading

bl_doc_no
string or null (Bl Doc No)
bl_dt
required
string <date> (Bl Doc No)
{
  • "bl_doc_no": "string",
  • "bl_dt": "2019-08-24"
}

Oil Cargo Contract

Data Element ID: contract

contract_trade_no
required
string (Contract Trade No)

Trade Number of contract

{
  • "contract_trade_no": "string"
}

Oil Cargo Discharge Certificate

Data Element ID: discharge_certificate

discharge_doc_no
required
string (Discharge Doc No)

Identifier number of discharge cert

discharge_order_no
required
string (Discharge Order No)

Order No. from source system

{
  • "discharge_doc_no": "string",
  • "discharge_order_no": "string"
}

Oil Cargo Holding Certificate

Data Element ID: holding_certificate

holding_dt
required
string <date> (Holding Dt)
{
  • "holding_dt": "2019-08-24"
}

Oil Cargo Invoice

Data Element ID: invoice

invoice_trade_no
required
string (Invoice Trade No)

Trade Number of invoice

{
  • "invoice_trade_no": "string"
}

Oil Terminal Storage Transaction

Data Element ID: inventory_transaction

requestId
string

Optional field. Include if you know the requestId for your resource.
requestId - Unique ID generated for the request

sourceSystemId
string (Source System Id)

Optional field. Own Source System's Id for Notification. Participant can ignore it when flow is anything other than PUSH or PULL.

Array of objects (participant)
Array of objects
{
  • "requestId": "string",
  • "sourceSystemId": "string",
  • "participants": [
    ],
  • "on_behalf_of": [
    ]
}

On Board Quantity

Data Element ID: on_board_quantity

requestId
string

Optional field. Include if you know the requestId for your resource.
requestId - Unique ID generated for the request

sourceSystemId
string (Source System Id)

Optional field. Own Source System's Id for Notification. Participant can ignore it when flow is anything other than PUSH or PULL.

Array of objects (participant)
Array of objects
{
  • "requestId": "string",
  • "sourceSystemId": "string",
  • "participants": [
    ],
  • "on_behalf_of": [
    ]
}

Remaining On Board

Data Element ID: remaining_on_board

requestId
string

Optional field. Include if you know the requestId for your resource.
requestId - Unique ID generated for the request

sourceSystemId
string (Source System Id)

Optional field. Own Source System's Id for Notification. Participant can ignore it when flow is anything other than PUSH or PULL.

Array of objects (participant)
Array of objects
{
  • "requestId": "string",
  • "sourceSystemId": "string",
  • "participants": [
    ],
  • "on_behalf_of": [
    ]
}

Tank Levels

Data Element ID: tank_levels

tl_terminal_name
required
string (Oil Terminal Name)
tl_effectivedate_time
string or null <date-time> (Effective Date and Time)
tl_tank_no
required
string (Tank Number/ID)
{
  • "tl_terminal_name": "string",
  • "tl_effectivedate_time": "2019-08-24T14:15:22Z",
  • "tl_tank_no": "string"
}

Tank Movement Discharge

Data Element ID: tank_movement_discharge

tmd_terminal_name
required
string (Oil Terminal Name)
tmd_discharge_date_time
string or null <date-time> (Start date and time for discharge of goods)
tmd_end_date_time
string or null <date-time> (End date and time for discharge of goods)
tmd_destination
string or null (Destination of discharged goods (Tank Number/ID))
tmd_origin
string or null (Source of discharged goods (Tank/Vessel/Barge))
{
  • "tmd_terminal_name": "string",
  • "tmd_discharge_date_time": "2019-08-24T14:15:22Z",
  • "tmd_end_date_time": "2019-08-24T14:15:22Z",
  • "tmd_destination": "string",
  • "tmd_origin": "string"
}

Tank Movement Inter Tank Transfer

Data Element ID: tank_movement_inter_tank_transfer

tmt_terminal_name
required
string (Oil Terminal Name)
tmt_transfer_date_time
string or null <date-time> (Transfer Start Date & Time)
tmt_end_date_time
string or null <date-time> (Transfer End Date & Time)
tmt_destination
string or null (Destination )
tmt_origin
string or null (Source)
{
  • "tmt_terminal_name": "string",
  • "tmt_transfer_date_time": "2019-08-24T14:15:22Z",
  • "tmt_end_date_time": "2019-08-24T14:15:22Z",
  • "tmt_destination": "string",
  • "tmt_origin": "string"
}

Tank Movement Loading

Data Element ID: tank_movement_loading

tml_terminal_name
required
string (Oil Terminal Name)
tml_loading_date_time
string or null <date-time> (Start date and time for loading of goods)
tml_end_date_time
string or null <date-time> (End date and time for loading of goods)
tml_destination
string or null (Destination of loaded goods (Tank/Vessel/Barge))
tml_origin
string or null (Source of loaded goods (Tank Number/ID))
{
  • "tml_terminal_name": "string",
  • "tml_loading_date_time": "2019-08-24T14:15:22Z",
  • "tml_end_date_time": "2019-08-24T14:15:22Z",
  • "tml_destination": "string",
  • "tml_origin": "string"
}

Ullage Report

Data Element ID: ullage_report

requestId
string

Optional field. Include if you know the requestId for your resource.
requestId - Unique ID generated for the request

sourceSystemId
string (Source System Id)

Optional field. Own Source System's Id for Notification. Participant can ignore it when flow is anything other than PUSH or PULL.

Array of objects (participant)
Array of objects
{
  • "requestId": "string",
  • "sourceSystemId": "string",
  • "participants": [
    ],
  • "on_behalf_of": [
    ]
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

Note

{
  • "note": "string"
}

Use Case B (Payload)

Payload schemas for Use Case B

Depot Timeslot Booking

Data Element ID: depot_timeslot_booking

depot_booking_no
required
string (Depot Booking No)

:Unique ID for timeslots booked at depot
:Depot Booking Number
:Unique ID for timeslots booked at depot
:NA
:Min characters = 15, Max characters = 16 Alphanumeric. Each set of 4 characters separated by "-" (dash) Depot code could be 3 characters instead of 4 eg PSA. eg XXXX-PSA-XXXX-XXXX

depot_booking_type
required
string (Depot Booking Type)

:Consignee Return (R) / Shipper Collection (C) / Local MT Import (I) / Local MT Export (E)
:Depot Booking Type
:Consignee Return (R) / Shipper Collection (C) / Local MT Import (I) / Local MT Export (E)
:Custom
:Min characters = 1, Max characters = 1 Alpha, equal to "C", "R", "I" or "E"

depot_booking_ref
required
string (Depot Booking Ref)

:Booking Reference - For Consignee Return, provide Container Number - For Shipper Collection (Release Order), provide Unique Cargo Reference - For Local MT Import, provide EDO Number - For Local MT Export, provide ESN Number
:Depot Booking Reference
:Booking Reference - For Consignee Return, provide Container Number - For Shipper Collection (Release Order), provide Unique Cargo Reference - For Local MT Import, provide EDO Number - For Local MT Export, provide ESN Number
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

depot_country_cd
required
string (Depot Country Cd)

:Code for country/location of depot facility (UN/ECE definition) - Example- SGSIN, INNSA
:Depot Country Code
:Code for country/location of depot facility as per UN/ECE definition. Sample values- SGSIN, INNSA
:UN/ECE, ISO3166
:Min characters = 5, Max characters = 5 Alphanumeric, excluding 0 and 1

depot_yard_cd
required
string (Depot Yard Cd)

:Code for depot yard (PSA definition) - Example- ACS2, CWT1, CGC4
:Depot Yard Code
:Code for depot yard as per Port of Singapore Authority definition. Sample value- ACS2, CWT1, CGC4
:PSA
:Min characters = 4, Max characters = 5 3 Alpha and 1-2 Digits

depot_uen
string or null (Depot Uen)

:Unique Entity Number for depot
:Depot Unique Entity Number
:Unique Entity Number for depot
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

container_operator_cd
required
string (Container Operator Cd)

:Container operator code (PSA definition) - Example- CC, OR, PI
:Container Operator Code
:Container operator code as per Port of Singapore Authority definition. Sample values- CC, OR, PI
:PSA
:Min characters = 2, Max characters = 3 Alpha

container_operator_uen
string or null (Container Operator Uen)

:Unique Entity Number for container operator
:Container Operator Unique Entity Number
:Unique Entity Number for container operator
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

haulier_nm
required
string (Haulier Nm)

:Abbreviated name of haulier (PSA definition) - Example- ACS, CWT, COGENT
:Haulier Name
:Abbreviated name of haulier as per Port of Singapore Authority definition. Sample values- ACS, CWT, COGENT
:PSA
:Min characters = 1, Max characters = 255 Alpha

haulier_uen
string or null (Haulier Uen)

:Unique Entity Number for haulier
:Haulier Unique Entity Number
:Unique Entity Number for haulier
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

vehicle_no
string or null (Vehicle No)

:Registration number of prime mover / towhead
:Vehicle Number
:Registration number of prime mover / towhead
:LTA
:Min characters = 1, Max characters = 255 Alphanumeric

container_iso
required
string (Container Iso)

:Size/Type (ISO6346:1995) of container - Example- 22G1
:Container Size/Type
:Size/Type of container as per ISO6346. Sample value- 22G1
:ISO6346
:Min characters = 4, Max characters = 4 Alphanumeric

booking_window_start_dt
required
string <date-time> (Booking Window Start Dt)

:Start time of booked depot timeslot window (ISO8601)
:Booking Window Start Date-Time
:Start time of booked depot timeslot window
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is the future

booking_window_end_dt
required
string <date-time> (Booking Window End Dt)

:End time of booked depot timeslot window (ISO8601)
:Booking Window End Date-Time
:End time of booked depot timeslot window
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is the future

snapshot_dt
required
string <date-time> (Snapshot Dt)

:Timestamp of this record being captured (ISO8601)
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

{
  • "depot_booking_no": "string",
  • "depot_booking_type": "string",
  • "depot_booking_ref": "string",
  • "depot_country_cd": "string",
  • "depot_yard_cd": "string",
  • "depot_uen": "string",
  • "container_operator_cd": "string",
  • "container_operator_uen": "string",
  • "haulier_nm": "string",
  • "haulier_uen": "string",
  • "vehicle_no": "string",
  • "container_iso": "string",
  • "booking_window_start_dt": "2019-08-24T14:15:22Z",
  • "booking_window_end_dt": "2019-08-24T14:15:22Z",
  • "snapshot_dt": "2019-08-24T14:15:22Z"
}

Electronic Delivery Order

Data Element ID: electronic_delivery_order

container_operator_cd
required
string (Container Operator Code)

:Container operator code as per Port of Singapore Authority definition. Sample values: CC, OR, PI
:Container Operator Code
:Container operator code as per Port of Singapore Authority definition. Sample values: CC, OR, PI
:PSA
:Min characters = 2, Max characters = 3
Alpha

container_operator_uen
string or null (Container Operator Unique Entity Number)

:Unique Entity Number for container operator
:Container Operator Unique Entity Number
:Unique Entity Number for container operator
:ACRA
:Min characters = 9, Max characters = 10
Alphanumeric. Final character is an alpha

authorization_cd
string or null (Authorization Code)

:Authorization code
:Authorization Code
:Authorization code
:PSA
:NA

haulier_nm
required
string (Haulier Name)

:Name of haulier as per Port of Singapore Authority definition.

One of Haulier Name (Haulier Org Code) or Haulier Code must be provided for this query
:Haulier Name
:Name of haulier as per Port of Singapore Authority definition.

One of Haulier Name (Haulier Org Code) or Haulier Code must be provided for this query
:PSA
:Min characters = 1, Max characters = 255
Alpha

haulier_cd
string or null (Haulier Code)

:Code of haulier as per Port of Singapore Authority definition.

One of Haulier Name (Haulier Org Code) or Haulier Code must be provided for this query
:Haulier Code
:Code of haulier as per Port of Singapore Authority definition.

One of Haulier Name (Haulier Org Code) or Haulier Code must be provided for this query
:PSA
:NA

process_delivery_dt
string or null <date-time> (Process Delivery Confirm Time)

:Process Delivery Confirm Time

No data return in this field if query by vessel name and voyage number
:Process Delivery Confirm Time
:Process Delivery Confirm Time

No data return in this field if query by vessel name and voyage number
:PSA
:NA

pregate_status
string or null (Pregate Status)

:Pregate Status. For history Pregate record, it indicate transaction SUCCESS or ABORTED or NULL

No data return in this field if query by vessel name and voyage number
:Pregate Status
:Pregate Status. For history Pregate record, it indicate transaction SUCCESS or ABORTED or NULL

No data return in this field if query by vessel name and voyage number
:NA
:NA

pregate_dt
string or null <date-time> (Pregate Date-Time)

:Pregate Time

No data return in this field if query by vessel name and voyage number
:Pregate Date-Time
:Pregate Time

No data return in this field if query by vessel name and voyage number
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vehicle_no
string or null (Vehicle Number)

:Registration number of prime mover / towhead

No data return in this field if query by vessel name and voyage number
:Vehicle Number
:Registration number of prime mover / towhead

No data return in this field if query by vessel name and voyage number
:LTA
:Min characters = 1, Max characters = 255
Alphanumeric

trailer_no
string or null (Trailer Number)

:Registration number of container trailer

No data return in this field if query by vessel name and voyage number
:Trailer Number
:Registration number of container trailer

No data return in this field if query by vessel name and voyage number
:LTA
:Min characters = 1, Max characters = 255
Alphanumeric

company_reg_no
string or null (Company Registered Number)

:Company Registered Number
:Company Registered Number
:Company Registered Number
:NA
:NA

company_nm
string or null (Company Name)

:Company Name
:Company Name
:Company Name
:NA
:NA

lolo_acc
string or null (LOLO Acconut Number)

:LOLO account where the charges for PSA Lift On/Lift Off services are charged
:LOLO Acconut Number
:LOLO account where the charges for PSA Lift On/Lift Off services are charged
:PSA
:NA

free_period_days
string or null (Free Period Days)

:Free Period Days
:Free Period Days
:Free Period Days
:NA
:NA

boxcare_indicator
string or null (Boxcare)

:Boxcare indicator. E - exclude Sunday and Public holiday, B - include Sunday and Public holiday while calculating free days, C - Special Rate
:Boxcare
:Boxcare indicator. E - exclude Sunday and Public holiday, B - include Sunday and Public holiday while calculating free days, C - Special Rate
:PSA
:NA

depot_yard_cd
string or null (Depot Yard Code)

:Code for depot yard as per Port of Singapore Authority definition. Sample value: ACS2, CWT1, CGC4
:Depot Yard Code
:Code for depot yard as per Port of Singapore Authority definition. Sample value: ACS2, CWT1, CGC4
:PSA
:Min characters = 4, Max characters = 5
3 Alpha and 1-2 Digits

conference_cd
string or null (Conference Code)

:Conference Code. Example ‘TW00’
:Conference Code
:Conference Code. Example ‘TW00’
:NA
:NA

special_conference
string or null (Special Conference)

:Special Conference Indicator. Y - Yes, N - No or null
:Special Conference
:Special Conference Indicator. Y - Yes, N - No or null
:NA
:NA

creator_user_id
string or null (Creator User ID)

:Portnet user ID of the user creates the record
:Creator User ID
:Portnet user ID of the user creates the record
:PSA
:NA

updater_user_id
string or null (Updater User ID)

:Portnet user ID of the user updates the record
:Updater User ID
:Portnet user ID of the user updates the record
:PSA
:NA

exit_dt
string or null <date-time> (Exit Date-Time)

:Exit Time
:Exit Date-Time
:Exit Time
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

discharge_dt
string or null <date-time> (Discharge Date-Time)

:Discharge Time
:Discharge Date-Time
:Discharge Time
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

haulier_uen
required
string (Haulier Unique Entity Number)

:Unique Entity Number for haulier
:Haulier Unique Entity Number
:Unique Entity Number for haulier
:ACRA
:Min characters = 9, Max characters = 10
Alphanumeric. Final character is an alpha

bill_lading_no
string or null (Bill of Lading Number)

:Bill of lading number
:Bill of Lading Number
:Bill of lading number
:NA
:Min characters = 1, Max characters = 255
Alphanumeric

container_no
required
string (Container Number)

:Identification number of container. Sample value: CBHU4398907
:Container Number
:Identification number of container. Sample value: CBHU4398907
:ISO6346
:Min characters = 11, Max characters = 11
4 Alphas (4th Alpha is U/J/Z) and 7 digits

edo_created_dt
required
string <date-time> (Electronic Delivery Order Created Date-Time)

:Timestamp that Electronic Delivery Order is created

No data return in this field if query by vessel name and voyage number
:Electronic Delivery Order Created Date-Time
:Timestamp that Electronic Delivery Order is created

No data return in this field if query by vessel name and voyage number
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

edo_updated_dt
required
string <date-time> (Electronic Delivery Order Updated Date-Time)

:Timestamp that Electronic Delivery Order is last updated

No data return in this field if query by vessel name and voyage number
:Electronic Delivery Order Updated Date-Time
:Timestamp that Electronic Delivery Order is last updated

No data return in this field if query by vessel name and voyage number
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

edo_deleted_dt
string or null <date-time> (Electronic Delivery Order Deleted Date-Time)

:Timestamp that Electronic Delivery Order is deleted, if applicable

No data return in this field if query by vessel name and voyage number
:Electronic Delivery Order Deleted Date-Time
:Timestamp that Electronic Delivery Order is deleted, if applicable

No data return in this field if query by vessel name and voyage number
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

vessel_nm
required
string (Vessel Name)

:Name of the discharge vessel
:Vessel Name
:Name of the discharge vessel
:NA
:Min characters = 1, Max characters = 255
Alphanumeric
No Special Characters

inward_voyage_no
required
string (Inward Voyage Number)

:Loader full inward voyage number
:Inward Voyage Number
:Loader full inward voyage number
:NA
:Min characters = 1, Max characters = 8
Alphanumeric

delivery_status_cd
required
string (Delivery Status Code)

:Delivery status - Pending (P), Approved (A), Processed (E)
:Delivery Status Code
:Delivery status - Pending (P), Approved (A), Processed (E)
:Custom
:Min characters = 1, Max characters = 1
Alpha, equal to "P", "A" or "E"

snapshot_dt
required
string <date-time> (Snapshot Date-Time)

:Timestamp of this record being captured
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

{
  • "container_operator_cd": "string",
  • "container_operator_uen": "string",
  • "authorization_cd": "string",
  • "haulier_nm": "string",
  • "haulier_cd": "string",
  • "process_delivery_dt": "2019-08-24T14:15:22Z",
  • "pregate_status": "string",
  • "pregate_dt": "2019-08-24T14:15:22Z",
  • "vehicle_no": "string",
  • "trailer_no": "string",
  • "company_reg_no": "string",
  • "company_nm": "string",
  • "lolo_acc": "string",
  • "free_period_days": "string",
  • "boxcare_indicator": "string",
  • "depot_yard_cd": "string",
  • "conference_cd": "string",
  • "special_conference": "string",
  • "creator_user_id": "string",
  • "updater_user_id": "string",
  • "exit_dt": "2019-08-24T14:15:22Z",
  • "discharge_dt": "2019-08-24T14:15:22Z",
  • "haulier_uen": "string",
  • "bill_lading_no": "string",
  • "container_no": "string",
  • "edo_created_dt": "2019-08-24T14:15:22Z",
  • "edo_updated_dt": "2019-08-24T14:15:22Z",
  • "edo_deleted_dt": "2019-08-24T14:15:22Z",
  • "vessel_nm": "string",
  • "inward_voyage_no": "string",
  • "delivery_status_cd": "string",
  • "snapshot_dt": "2019-08-24T14:15:22Z"
}

Haulier Depot Entry/Exit

Data Element ID: haulier_depot_entry_exit

depot_country_cd
required
string (Depot Country Cd)

:Code for country/location of depot facility (UN/ECE definition) - Example- SGSIN, INNSA
:Depot Country Code
:Code for country/location of depot facility as per UN/ECE definition. Sample values- SGSIN, INNSA
:UN/ECE
:Min characters = 5, Max characters = 5 Alphanumeric, excluding 0 and 1

depot_yard_cd
required
string (Depot Yard Cd)

:Code for depot yard (PSA definition) - Example- ACS2, CWT1, CGC4
:Depot Yard Code
:Code for depot yard as per Port of Singapore Authority definition. Sample value- ACS2, CWT1, CGC4
:PSA
:Min characters = 4, Max characters = 53 Alpha and 1-2 Digits

depot_uen
string or null (Depot Uen)

:Unique Entity Number for depot
:Depot Unique Entity Number
:Unique Entity Number for depot
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

haulier_nm
required
string (Haulier Nm)

:Abbreviated name of haulier (PSA definition) - Example- ACS, CWT, COGENT
:Haulier Name
:Abbreviated name of haulier as per Port of Singapore Authority definition. Sample values- ACS, CWT, COGENT
:PSA
:Min characters = 1, Max characters = 255 Alpha

haulier_uen
string or null (Haulier Uen)

:Unique Entity Number for haulier
:Haulier Unique Entity Number
:Unique Entity Number for haulier
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

vehicle_no
required
string (Vehicle No)

:Registration number of prime mover / towhead
:Vehicle Number
:Registration number of prime mover / towhead
:LTA
:Min characters = 1, Max characters = 255 Alphanumeric

vehicle_depotgate_in_dt
string or null <date-time> (Vehicle Depotgate In Dt)

:Actual time of vehicle entering depot gate (ISO8601)
:Vehicle Depot Gate In Date-Time
:Actual time of vehicle entering depot gate
:ISO8601
:ISO8601 date-time format Date is not in the future

vehicle_depotgate_out_dt
string or null <date-time> (Vehicle Depotgate Out Dt)

:Actual time of vehicle exiting depot gate (ISO8601)
:Vehicle Depot Gate Out Date-Time
:Actual time of vehicle exiting depot gate
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

required
Array of objects (Depot Booking)
snapshot_dt
required
string <date-time> (Snapshot Dt)
{
  • "depot_country_cd": "string",
  • "depot_yard_cd": "string",
  • "depot_uen": "string",
  • "haulier_nm": "string",
  • "haulier_uen": "string",
  • "vehicle_no": "string",
  • "vehicle_depotgate_in_dt": "2019-08-24T14:15:22Z",
  • "vehicle_depotgate_out_dt": "2019-08-24T14:15:22Z",
  • "depot_booking": [
    ],
  • "snapshot_dt": "2019-08-24T14:15:22Z"
}

Haulier Gps

Data Element ID: haulier_gps

vehicle_speed
string or null (Vehicle Speed) [ 0 .. 120 ]

:Speed of vehicle in km/hr
:Speed of vehicle in km/hr
:Speed of vehicle in km/hr
: LTA
:Min decimal precision = 0, Max decimal precision = 2

haulier_nm
required
string (Haulier Name)

Abbreviated name of haulier as per Port of Singapore Authority definition. Sample values: ACS, CWT, COGENT.

haulier_uen
string or null (Haulier Uen)

:Unique Entity Number for haulier
:Haulier Unique Entity Number
:Unique Entity Number for haulier
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alph

vehicle_no
string or null (Vehicle Number)

:Speed of vehicle in km/hr. This field has a commonly agreed minimum decimal precision = 0 and maximum decimal precision = 2
:Vehicle Number
:Registration number of prime mover / towhead. This field will be set to Mandatory by Mar 2023
:Decimal Degrees
:Min value = 0, Max value = 2

position_latitude
required
number <double> (Position Latitude)

Latitude coordinates of vehicle. Additional validation will be performed by Mar 2023

position_longitude
required
number <double> (Position Longtitude) [ -180 .. 180 ]

Longitude coordinates of vehicle. Additional validation will be performed by Mar 2023

position_altitude
number or null <double> (Position Altitude)

:Elevation coordinates of position
:Position Altitude
:Elevation coordinates of vehicle
:Decimal Degrees
:Min value = -500, Max value = 1000

heading
required
number <double> (Heading)

Direction in which vehicle is pointing. Additional validation will be performed by Mar 2023

snapshot_dt
required
string <date-time> (Snapshot Dt)

:Timestamp of this record being captured (ISO8601)
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO8601
:ISO 8601 date-time format Date is not in the future

geofence_of_interest
string or null (Geofence Of Interest)

:Geofence of interest
:Geofence of Interest
:Geofence of Interest that vehicle coordinates (Latitude, Longitude, Altitude (Optional)) fall within
:NA
:Min characters = 1, Max characters = 255 Alpha

{
  • "vehicle_speed": "string",
  • "haulier_nm": "string",
  • "haulier_uen": "string",
  • "vehicle_no": "string",
  • "position_latitude": 0.1,
  • "position_longitude": -180,
  • "position_altitude": 0.1,
  • "heading": 0.1,
  • "snapshot_dt": "2019-08-24T14:15:22Z",
  • "geofence_of_interest": "string"
}

Haulier Port Entry/Exit

Data Element ID: haulier_port_entry_exit

port_country_cd
required
string (Port Country Cd)

:Code for country/location of port (UN/ECE definition) - Example- SGSIN, INNSA
:Port Country Code
:Code for country/location of port as per UN/ECE definition. Sample values- SGSIN, INNSA
:UN/ECE
:Min characters = 5, Max characters = 5 Alphanumeric, excluding 0 and 1

port_operator_cd
required
string (Port Operator Cd)

:Organisation code for port operator - Example- PSA
:Port Operator Code
:Organisation code for port operator. Sample value- PSA
:PSA
:NA

port_operator_uen
required
string (Port Operator Uen)

:Unique Entity Number for port operator
:Port Operator Unique Entity Number
:Unique Entity Number for port operator
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

port_terminal_cd
string or null (Port Terminal Cd)

:Code for port terminal location (SMDG definition) - Example- PSAKT, PSAPP1, PSATPT
:Port Terminal Code
:Code for port terminal facility as per SMDG definition. Sample values- PSAKT, PSAPP1, PSATPT
:SMDG
:Min characters = 3, Max characters = 6 Alpha

haulier_nm
required
string (Haulier Nm)

:Abbreviated name of haulier (PSA definition) - Example- ACS, CWT, COGENT
:Haulier Name
:Abbreviated name of haulier as per Port of Singapore Authority definition. Sample values- ACS, CWT, COGENT
:PSA
:Min characters = 1, Max characters = 255 Alpha

haulier_uen
required
string (Haulier Uen)

:Unique Entity Number for haulier
:Haulier Unique Entity Number
:Unique Entity Number for haulier
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

vehicle_no
required
string (Vehicle No)

:Registration number of prime mover / towhead
:Vehicle Number
:Registration number of prime mover / towhead
:LTA
:Min characters = 1, Max characters = 255 Alphanumeric

vehicle_portgate_dt
required
string <date-time> (Vehicle Portgate Dt)

:Actual time of vehicle entering/exiting port gate (ISO8601)
:Vehicle Port Gate Date-Time
:Actual time of vehicle entering/exiting port gate
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

unique_cargo_ref
string or null (Unique Cargo Ref)

:Unique Cargo Reference / Booking Confirmation number
:Unique Cargo Reference
:Unique Cargo Reference / Booking Confirmation number
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

container_movement_type
required
string (Container Movement Type)

:Indicator of whether container is entering (N) or exiting (X) port
:Container Movement Type
:Indicator of whether container is entering (N) or exiting (X) port
:Custom
:Min characters = 1, Max characters = 1 Alpha, equal to "N" or "X"

container_operator_cd
required
string (Container Operator Cd)

:Container operator code (PSA definition) - Example- CC, OR, PI
:Container Operator Code
:Container operator code as per Port of Singapore Authority definition. Sample values- CC, OR, PI
:PSA
:Min characters = 2, Max characters = 3 Alpha

container_operator_uen
required
string (Container Operator Uen)

:Unique Entity Number for container operator
:Container Operator Unique Entity Number
:Unique Entity Number for container operator
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

container_no
required
string (Container No)

:Identification number of container (ISO6346) - Example- CBHU4398907
:Container Number
:Identification number of container. Sample value- CBHU4398907
:ISO6346
:Min characters = 11, Max characters = 11 4 Alphas (4th Alpha is U/J/Z) and 7 digits

container_iso
required
string (Container Iso)

:Size/Type (ISO6346:1995) of container - Example- 22G1
:Container Size/Type
:Size/Type of container as per ISO6346. Sample value- 22G1
:ISO6346
:Min characters = 4, Max characters = 4 Alphanumeric

container_content
required
string (Container Content)

:Indicator of whether container is Empty (E) or Full (F)
:Container Content
:Indicator of whether container is Empty (E) or Full (F)
:Custom
:Min characters = 1, Max characters = 1 Alpha, equal to "E" or "F"

snapshot_dt
required
string <date-time> (Snapshot Dt)

:Timestamp of this record being captured (ISO8601)
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

{
  • "port_country_cd": "string",
  • "port_operator_cd": "string",
  • "port_operator_uen": "string",
  • "port_terminal_cd": "string",
  • "haulier_nm": "string",
  • "haulier_uen": "string",
  • "vehicle_no": "string",
  • "vehicle_portgate_dt": "2019-08-24T14:15:22Z",
  • "unique_cargo_ref": "string",
  • "container_movement_type": "string",
  • "container_operator_cd": "string",
  • "container_operator_uen": "string",
  • "container_no": "string",
  • "container_iso": "string",
  • "container_content": "string",
  • "snapshot_dt": "2019-08-24T14:15:22Z"
}

Haulier Trip Details

Data Element ID: haulier_trip_details

haulier_nm
required
string (Haulier Nm)

:Abbreviated name of haulier (PSA definition) - Example- ACS, CWT, COGENT
:Haulier Name
:Abbreviated name of haulier as per Port of Singapore Authority definition. Sample values- ACS, CWT, COGENT
:PSA
:Min characters = 1, Max characters = 255 Alpha

haulier_uen
string or null (Haulier Uen)

:Unique Entity Number for haulier
:Haulier Unique Entity Number
:Unique Entity Number for haulier
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

customer_nm
required
string (Customer Nm)

:Name of Customer giving transport job to Haulier
:Customer Name
:Name of Customer giving transport job to Haulier
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

customer_uen
string or null (Customer Uen)

:Unique Entity Number for Customer giving transport job to Haulier
:Customer Unique Entity Number
:Unique Entity Number for Customer giving transport job to Haulier
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

bco_nm
string or null (Bco Nm)

:Name of Beneficial Cargo Owner(s), if known
:Beneficial Cargo Owner Name
:Name of Beneficial Cargo Owner(s), if known
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

bco_uen
string or null (Bco Uen)

:Unique Entity Number for Beneficial Cargo Owner(s), if known
:Beneficial Cargo Owner Unique Entity Number
:Unique Entity Number for Beneficial Cargo Owner(s), if known
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

job_booking_ref
required
string (Job Booking Ref)

:Booking Reference for transport job - For Consignee Import, provide Container No.- For Shipper Export, provide Booking Confirmation No- For Local MT Import, provide EDO Number / NMT Number - For Local MT Export, provide ESN Number
:Job Booking Reference
:Booking Reference for transport job - For Consignee Import, provide Container No.- For Shipper Export, provide Booking Confirmation No - For Local MT Import, provide EDO Number / NMT Number - For Local MT Export, provide ESN Number
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

job_no
string or null (Job No)

:Unique identifier for job, provided by Customer
:Job Number
:Unique identifier for job, provided by Customer
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

container_no
required
string (Container No)

:Identification number of container (ISO6346) - Example- CBHU4398907
:Container Number
:Identification number of container. Sample value- CBHU4398907
:ISO6346
:Min characters = 11, Max characters = 11 4 Alphas (4th Alpha is U/J/Z) and 7 digits

Array of objects or null (Trip Details)
snapshot_dt
required
string <date-time> (Snapshot Dt)

:Unique identifier for job, provided by Customer
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

{
  • "haulier_nm": "string",
  • "haulier_uen": "string",
  • "customer_nm": "string",
  • "customer_uen": "string",
  • "bco_nm": "string",
  • "bco_uen": "string",
  • "job_booking_ref": "string",
  • "job_no": "string",
  • "container_no": "string",
  • "trip_details": [
    ],
  • "snapshot_dt": "2019-08-24T14:15:22Z"
}

Release Depot

Data Element ID: release_depot

container_operator_cd
required
string (Container Operator Code)

:Container operator code as per Port of Singapore Authority definition. Sample values - CC, OR, PI
:Container Operator Code
:Container operator code as per Port of Singapore Authority definition. Sample values - CC, OR, PI
:NA

container_operator_uen
string or null (Container Operator Unique Entity Number)

:Unique Entity Number for container operator
:Container Operator Unique Entity Number
:Unique Entity Number for container operator
:NA

depot_uen
string or null (Depot Unique Entity Number)

:Unique Entity Number for depot
:Depot Unique Entity Number
:Unique Entity Number for depot
:NA

depot_country_cd
required
string (Depot Country Code)

:Code for country/location of depot facility as per UN/ECE definition. Sample values - SGSIN, INNSA
:Depot Country Code
:Code for country/location of depot facility as per UN/ECE definition. Sample values - SGSIN, INNSA
:NA

unique_cargo_ref
required
string (Unique Cargo Reference)

:Unique Cargo Reference / Booking Confirmation number
:Unique Cargo Reference
:Unique Cargo Reference / Booking Confirmation number
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

vessel_nm
required
string (Vessel Name)

:Loader full vessel name
:Vessel Name
:Name of vessel
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

outward_voyage_no
required
string (Outward Voyage Number)

:Loader full outward voyage number
:Outward Voyage Number
:Loader full outward voyage number
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

release_created_dt
string or null <date-time> (Release Created Date-Time)

:Timestamp that release order is created (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:Release Created Date-Time
:Timestamp that release order is created
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

release_updated_dt
string or null <date-time> (Release Updated Date-Tme)

:Timestamp that release order is last updated (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:Release Updated Date-Tme
:Timestamp that release order is last updated
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

release_cancelled_dt
string or null <date-time> (Release Cancelled Date-Time)

:Timestamp that release order is cancelled, if applicable (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:Release Cancelled Date-Time
:Timestamp that release order is cancelled, if applicable
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

snapshot_dt
required
string <date-time> (Snapshot Date-Time)

:Timestamp of this record being captured (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

required
Array of objects (Depot Details)

:Details of depot yard(s) for a particular release order
:Depot Details
:Details of depot yard(s) for a particular release order
:NA
:NA

container_total_qty
required
string (Container Total Quantity)

:Quantity of total container for release
:Container Total Quantity
:Quantity of total container for release
:NA

container_release_dt
required
string <date-time> (Container Release Date-Time)

:Starting date that container can be released
:Container Release Date-Time
:Starting date that container can be released
:NA

{
  • "container_operator_cd": "string",
  • "container_operator_uen": "string",
  • "depot_uen": "string",
  • "depot_country_cd": "string",
  • "unique_cargo_ref": "string",
  • "vessel_nm": "string",
  • "outward_voyage_no": "string",
  • "release_created_dt": "2019-08-24T14:15:22Z",
  • "release_updated_dt": "2019-08-24T14:15:22Z",
  • "release_cancelled_dt": "2019-08-24T14:15:22Z",
  • "snapshot_dt": "2019-08-24T14:15:22Z",
  • "depot_detail": [
    ],
  • "container_total_qty": "string",
  • "container_release_dt": "2019-08-24T14:15:22Z"
}

Release Order

Data Element ID: release_order

container_operator_cd
required
string (Container Operator Cd) [ 1 .. 8 ] characters

:Container operator code (PSA definition) - Example- CC, OR, PI
:Container Operator Code
:Container operator code as per Port of Singapore Authority definition. Sample values- CC, OR, PI
:PSA
:Min characters = 2, Max characters = 32 Alphas

container_operator_uen
string or null (Container Operator Uen)

:Unique Entity Number for container operator
:Container Operator Unique Entity Number
:Unique Entity Number for container operator
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

depot_country_cd
required
string (Depot Country Cd)

:Code for country/location of depot facility (UN/ECE definition) - Example- SGSIN, INNSA
:Depot Country Code
:Code for country/location of depot facility as per UN/ECE definition. Sample values- SGSIN, INNSA
:UN/ECE, ISO3166
:Min characters = 5, Max characters = 5 Alphanumeric, excluding 0 and 1

depot_uen
string or null (Depot Uen)

:Unique Entity Number for depot
:Depot Unique Entity Number
:Unique Entity Number for depot
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

unique_cargo_ref
required
string (Unique Cargo Ref)

:Unique Cargo Reference / Booking Confirmation number
:Unique Cargo Reference
:Unique Cargo Reference / Booking Confirmation number
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

vessel_nm
required
string (Vessel Nm)

:Loader full vessel name
:Vessel Name
:Name of vessel
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

outward_voyage_no
required
string (Outward Voyage No)

:Loader full outward voyage number
:Outward Voyage Number
:Loader full outward voyage number
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

shipper_nm
required
string (Shipper Nm)

:Name of shipper
:Shipper Name
:Name of shipper
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

shipper_uen
string or null (Shipper Uen)

:Unique Entity Number for shipper
:Shipper Unique Entity Number
:Unique Entity Number for shipper
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

forwarder_nm
string or null (Forwarder Nm)

:Name of forwarder
:Forwarder Name
:Name of forwarder
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

forwarder_uen
string or null (Forwarder Uen)

:Unique Entity Number for forwarder
:Forwarder Unique Entity Number
:Unique Entity Number for forwarder
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

release_created_dt
string or null <date-time> (Release Created Dt)

:Timestamp that release order is created (ISO8601)
:Release Created Date-Time
:Timestamp that release order is created
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

release_updated_dt
string or null <date-time> (Release Updated Dt)

:Timestamp that release order is last updated (ISO8601)
:Release Updated Date-Tme
:Timestamp that release order is last updated
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

release_cancelled_dt
string or null <date-time> (Release Cancelled Dt)

:Timestamp that release order is cancelled, if applicable (ISO8601)
:Release Cancelled Date-Time
:Timestamp that release order is cancelled, if applicable
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

required
Array of objects (Container Detai)

:NA
:Container Detail
:Details of container(s) for a particular release order
:NA
:NA

snapshot_dt
required
string <date-time> (Snapshot Dt)

:Timestamp of this record being captured (ISO8601)
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

{
  • "container_operator_cd": "string",
  • "container_operator_uen": "string",
  • "depot_country_cd": "string",
  • "depot_uen": "string",
  • "unique_cargo_ref": "string",
  • "vessel_nm": "string",
  • "outward_voyage_no": "string",
  • "shipper_nm": "string",
  • "shipper_uen": "string",
  • "forwarder_nm": "string",
  • "forwarder_uen": "string",
  • "release_created_dt": "2019-08-24T14:15:22Z",
  • "release_updated_dt": "2019-08-24T14:15:22Z",
  • "release_cancelled_dt": "2019-08-24T14:15:22Z",
  • "container_detail": [
    ],
  • "snapshot_dt": "2019-08-24T14:15:22Z"
}

Storing Depot

Data Element ID: storing_depot

depot_uen
string or null (Depot Unique Entity Number)

Unique Entity Number for depot

depot_yard_cd
required
string (Depot Yard Code)

:Code for depot yard (PSA definition) - Example- ACS2, CWT1, CGC4
:Depot Yard Code
:Code for depot yard as per Port of Singapore Authority definition. Sample values= ACS2, CWT1, CGC4
:PSA
:Min characters = 4, Max characters = 53 Alpha and 1-2 Digits

bill_lading_no
required
string (Bill of Lading Number)

Bill of lading number

container_operator_cd
required
string (Container Operator Code)

Container operator code as per Port of Singapore Authority definition. Sample values: CC, OR, PI

depot_country_cd
required
string (Depot Country Code)

Code for country/location of depot facility as per UN/ECE definition. Sample values: SGSIN, INNSA

vessel_nm
required
string (Vessel Name)

:Loader full vessel name
:Vessel Name
:Name of vessel
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

inward_voyage_no
required
string (Inward Voyage Number)

:Loader full inward voyage number
:Inward Voyage Number
:Loader full inward voyage number
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

container_no
required
string (Container Number)

:Identification number of container (ISO6346) - Example- CBHU4398907
:Container Number
:Identification number of container (ISO6346) - Example- CBHU4398907
:ISO6346
:Min characters = 11, Max characters = 11 4 Alphas (4th Alpha is U/J/Z) and 7 digits

container_iso
required
string (Container Size/Type)

:Size/Type (ISO6346:1995) of container for storing - Example- 22G1
:Container ISO
:Size/Type (ISO6346:1995) of container for storing - Example- 22G1
:ISO6346
:Min characters = 4, Max characters = 4 Alphanumeric

storing_created_dt
string or null <date-time> (Storing Created date)

:Timestamp that storing order is created (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:Storing Created date
:Timestamp that storing order is created (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:ISO8601
:ISO 8601 date format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

container_operator_uen
string or null (Container Operator Unique Entity Number)

Unique Entity Number for container operator

storing_updated_dt
string or null <date-time> (Storing Updated date)

:Timestamp that storing order is last updated (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:Storing Updated date
:Timestamp that storing order is last updated (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:ISO8601
:ISO 8601 date format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

storing_cancelled_dt
string or null <date-time> (Storing Cancelled date)

:Timestamp that storing order is cancelled, if applicable (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:Storing Cancelled date
:Timestamp that storing order is cancelled, if applicable (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:ISO8601
:ISO 8601 date format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

container_must_return_dt
string or null <date-time> (Container Must Return date)

:Date that container must be returned to depot by, i.e. last free use date (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:Container Must Return date
:Date that container must be returned to depot by, i.e. last free use date (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:ISO8601
:ISO 8601 date format (YYYY-MM-DDThh:mm:ssZ) Date is in the future

snapshot_dt
required
string <date-time> (Snapshot date)

:Timestamp of this record being captured (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:Snapshot date
:Timestamp of this record being captured (ISO8601) - Example- 2021-05-14T16:50:00.000Z
:ISO8601
:ISO 8601 date format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

{
  • "depot_uen": "string",
  • "depot_yard_cd": "string",
  • "bill_lading_no": "string",
  • "container_operator_cd": "string",
  • "depot_country_cd": "string",
  • "vessel_nm": "string",
  • "inward_voyage_no": "string",
  • "container_no": "string",
  • "container_iso": "string",
  • "storing_created_dt": "2019-08-24T14:15:22Z",
  • "container_operator_uen": "string",
  • "storing_updated_dt": "2019-08-24T14:15:22Z",
  • "storing_cancelled_dt": "2019-08-24T14:15:22Z",
  • "container_must_return_dt": "2019-08-24T14:15:22Z",
  • "snapshot_dt": "2019-08-24T14:15:22Z"
}

Storing Order

Data Element ID: storing_order

container_operator_cd
required
string (Container Operator Cd)

:Container operator code (PSA definition) - Example- CC, OR, PI
:Container Operator Code
:Container operator code as per Port of Singapore Authority definition. Sample values- CC, OR, PI
:PSA
:Min characters = 2, Max characters = 3 Alpha

container_operator_uen
string or null (Container Operator Uen)

:Unique Entity Number for container operator
:Container Operator Unique Entity Number
:Unique Entity Number for container operator
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

depot_country_cd
required
string (Depot Country Cd)

:Code for country/location of depot facility (UN/ECE definition) - Example- SGSIN, INNSA
:Depot Country Code
:Code for country/location of depot facility as per UN/ECE definition. Sample values- SGSIN, INNSA
:UN/ECE, ISO3166
:Min characters = 5, Max characters = 5 Alphanumeric, excluding 0 and 1

depot_yard_cd
required
string (Depot Yard Cd)

:Code for depot yard (PSA definition) - Example- ACS2, CWT1, CGC4
:Depot Yard Code
:Code for depot yard as per Port of Singapore Authority definition. Sample values- ACS2, CWT1, CGC4
:PSA
:Min characters = 4, Max characters = 53 Alpha and 1-2 Digits

depot_uen
string or null (Depot Uen)

:Unique Entity Number for depot
:Depot Unique Entity Number
:Unique Entity Number for depot
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

bill_lading_no
required
string (Bill Lading No)

:Bill of lading number
:Bill of Lading Number
:Bill of lading number
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

vessel_nm
required
string (Vessel Nm)

:Loader full vessel name
:Vessel Name
:Name of vessel
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

inward_voyage_no
required
string (Inward Voyage No)

:Loader full inward voyage number
:Inward Voyage Number
:Loader full inward voyage number
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

consignee_nm
required
string (Consignee Nm)

:Name of consignee
:Consignee Name
:Name of consignee
:NA
:Min characters = 1, Max characters = 255 Alphanumeric

consignee_uen
string or null (Consignee Uen)

:Unique Entity Number for consignee
:Consignee Unique Entity Number
:Unique Entity Number for consignee
:ACRA
:Min characters = 9, Max characters = 10 Alphanumeric. Final character is an alpha

storing_created_dt
string or null <date-time> (Storing Created Dt)

:Timestamp that storing order is created (ISO8601)
:Storing Created Date-Time
:Timestamp that storing order is created
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

storing_updated_dt
string or null <date-time> (Storing Updated Dt)

:Timestamp that storing order is last updated (ISO8601)
:Storing Updated Date-Time
:Timestamp that storing order is last updated
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

storing_cancelled_dt
string or null <date-time> (Storing Cancelled Dt)

:Timestamp that storing order is cancelled, if applicable (ISO8601)
:Storing Cancelled Date-Time
:Timestamp that storing order is cancelled, if applicable
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

container_no
required
string (Container No)

:Identification number of container (ISO6346) - Example- CBHU4398907
:Container Number
:Identification number of container. Sample value- CBHU4398907
:ISO6346
:Min characters = 11, Max characters = 11 4 Alphas (4th Alpha is U/J/Z) and 7 digits

container_iso
required
string (Container Iso)

:Size/Type (ISO6346:1995) of container for storing - Example- 22G1
:Container Size/Type
:Size/Type of container as per ISO6346. Sample value- 22G1
:(ISO6346:1995)
:Min characters = 4, Max characters = 4 Alphanumeric

container_must_return_dt
string or null <date-time> (Container Must Return Date-Time)

Date that container must be returned to depot by, i.e. last free use date.

snapshot_dt
required
string <date-time> (Snapshot Dt)

:Timestamp of this record being captured (ISO8601)
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

{
  • "container_operator_cd": "string",
  • "container_operator_uen": "string",
  • "depot_country_cd": "string",
  • "depot_yard_cd": "string",
  • "depot_uen": "string",
  • "bill_lading_no": "string",
  • "vessel_nm": "string",
  • "inward_voyage_no": "string",
  • "consignee_nm": "string",
  • "consignee_uen": "string",
  • "storing_created_dt": "2019-08-24T14:15:22Z",
  • "storing_updated_dt": "2019-08-24T14:15:22Z",
  • "storing_cancelled_dt": "2019-08-24T14:15:22Z",
  • "container_no": "string",
  • "container_iso": "string",
  • "container_must_return_dt": "2019-08-24T14:15:22Z",
  • "snapshot_dt": "2019-08-24T14:15:22Z"
}

Vessel Journey

Data Element ID: vessel_journey

container_no
Array of strings or null or null (Container Number)

:Identification number of container. Sample value: CBHU4398907
:Container Number
:Identification number of container. Sample value: CBHU4398907
:ISO6346
:Min characters = 11, Max characters = 11
4 Alphas (4th Alpha is U/J/Z) and 7 digits

bill_lading_no
string or null (Bill of Lading Number)

:Bill of lading number / booking number
:Bill of Lading Number
:Bill of lading number / booking number
:NA
:Min characters = 1, Max characters = 255
Alphanumeric

carrier_no
string or null (Carrier Code)

:Code of the carrier issued the booking confirmation to shipper/consignee/ 3PL/4PL for their shipment as per SCAC definition.
Sample: CMDU
:Carrier Code
:Code of the carrier issued the booking confirmation to shipper/consignee/ 3PL/4PL for their shipment as per SCAC definition.
Sample: CMDU
:SCAC
:Min characters = 2, Max characters = 4 Alpha

Array of objects or null (Port of Discharge Details)

:Details for vessel activity at port of discharge
:Port of Discharge Details
:Details for vessel activity at port of discharge
:NA
:NA

Array of objects or null (Port of Loading Details)

:Details for vessel activity at port of loading
:Port of Loading Details
:Details for vessel activity at port of loading
:NA
:NA

Array of objects or null (Container Event List)

:Container event list for the tracked shipment
:Container Event List
:Container event list for the tracked shipment
:NA
:NA

Array of objects or null (Carbon Dioxide Emissions)

:Details of Carbon Dioxide Emmissions
:Carbon Dioxide Emissions
:Details of Carbon Dioxide Emmissions
:NA
:NA

Array of objects or null (Delay Lists)

:List of delay incidents summary
:Delay Lists
:List of delay incidents summary
:NA
:0

Array of objects or null (Sailing Info Tracking)

:Detailed tracking Information for each leg of the journey
:Sailing Info Tracking
:Detailed tracking Information for each leg of the journey
:NA
:0

error_code
string or null (Error Code)

:Reason for invalid or incomplete results
:Error Code
:Reason for invalid or incomplete results
:NA
:0

shipment_tracking
string or null (Shipment Tracking)

:ID/URL to track the shipment
:Shipment Tracking
:ID/URL to track the shipment
:NA
:NA

update_timestamp
required
string or null <date-time> (Snapshot Date-Time)

:Updated Date-Time for this record
:Snapshot Date-Time
:Updated Date-Time for this record
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is in the future

{
  • "container_no": [
    ],
  • "bill_lading_no": "string",
  • "carrier_no": "string",
  • "port_of_discharge": [
    ],
  • "port_of_loading": [
    ],
  • "container_event": [
    ],
  • "co2_emissions": [
    ],
  • "delay_list": [
    ],
  • "sailing_info_tracking": [
    ],
  • "error_code": "string",
  • "shipment_tracking": "string",
  • "update_timestamp": "2019-08-24T14:15:22Z"
}

Vessel Voyage Schedule

Data Element ID: vessel_activity

Any of
container_no
string or null (Container Number)

:Identification number of container. Sample value: CBHU4398907
:Container Number
:Identification number of container. Sample value: CBHU4398907
:ISO6346
:Min characters = 11, Max characters = 11
4 Alphas (4th Alpha is U/J/Z) and 7 digits

unique_cargo_ref
string or null (Unique Cargo Reference)

:Unique Cargo Reference / Booking Confirmation number
:Unique Cargo Reference
:Unique Cargo Reference / Booking Confirmation number
:NA
:Min characters = 1, Max characters = 255
Alphanumeric

vessel_imo
string or null (IMO Number)

:IMO number of the vessel
:IMO Number
:IMO number of the vessel
:NA
:NA

abbr_vessel_nm
string or null (Abbreviated Vessel Name)

:Abbreviated vessel name
:Abbreviated Vessel Name
:Abbreviated vessel name
:NA
:NA

vessel_nm
required
string (Full Vessel Name)

:Full name of the vessel
:Full Vessel Name
:Full name of the vessel
:NA
:Min characters = 1, Max characters = 255
Alphanumeric
No Special Characters

abbr_inward_voy
string or null (Abbreviated Inward Voyage Number)

:Abbreviated inward voyage number
:Abbreviated Inward Voyage Number
:Abbreviated inward voyage number
:NA
:NA

inward_voyage_no
required
string (Inward Voyage Number)

:Full inward voyage number
:Inward Voyage Number
:Full inward voyage number
:NA
:Min characters = 1, Max characters = 8
Alphanumeric

abbr_outward_voy
string or null (Abbreviated Outward Voyage Number)

:Abbreviated outward voyage number
:Abbreviated Outward Voyage Number
:Abbreviated outward voyage number
:NA
:NA

outward_voyage_no
required
string (Outward Voyage Number)

:Full outward voyage number
:Outward Voyage Number
:Full outward voyage number
:NA
:Min characters = 1, Max characters = 8
Alphanumeric

vessel_btr_dt
required
string <date-time> (Berthing Time Request Date-Time)

:Requested time of vessel berthing at Singapore terminal, submitted by Carrier (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z.
:Berthing Time Request Date-Time
:Requested time of vessel berthing at Singapore terminal, submitted by Carrier (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z.
:NA
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is in the future

vessel_etb_dt
string or null <date-time> (Vessel Estimated Time of Berthing Date-Time)

:Estimated time of vessel berth at terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:Vessel Estimated Time of Berthing Date-Time
:Estimated time of vessel berth at terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is in the future

vessel_etu_dt
string or null <date-time> (Vessel Estimated Time of Unberthing Date-Time)

:Estimated time of vessel unberth at terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:Vessel Estimated Time of Unberthing Date-Time
:Estimated time of vessel unberth at terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is in the future

abbr_terminal_nm
string or null (Abbreviated Terminal Name)

:Abbreviated Terminal Name
:Abbreviated Terminal Name
:Abbreviated Terminal Name
:NA
:Min characters = 3, Max characters = 3. First character is an alpha and 2 digits

vessel_etd_dt
string or null <date-time> (Vessel Estimated Time of Departure Date-Time)

:Declared time of vessel unberthing at Singapore terminal, submitted by Carrier (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z.
:Vessel Estimated Time of Departure Date-Time
:Declared time of vessel unberthing at Singapore terminal, submitted by Carrier (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z.
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

terminal_berth
required
string (Terminal and Berth)

:Vessel berthing terminal and berth number (terminal prefix and berth number e.g. P01, B05).
:Terminal and Berth
:Vessel berthing terminal and berth number (terminal prefix and berth number e.g. P01, B05).
:NA
:Min characters = 3, Max characters = 3. First character is an alpha and 2 digits

vessel_consortium_nm
string or null (Consortium Name)

:Shipping consortium/alliance name
:Consortium Name
:Shipping consortium/alliance name
:NA
:NA

vessel_consortium_cd
string or null (Consortium Code)

:Shipping consortium/alliance code
:Consortium Code
:Shipping consortium/alliance code
:NA
:NA

vessel_operator_cd
required
string (Vessel Operator Code)

:Organisation code for vessel operator as per SMDG definition. Sample values: COS, OOL, PIL
:Vessel Operator Code
:Organisation code for vessel operator as per SMDG definition. Sample values: COS, OOL, PIL
:SMDG
:Min characters = 3, Max characters = 3
Alpha

vessel_operator_uen
string or null (Vessel Operator Unique Entity Number)

:Unique Entity Number for vessel operator
:Vessel Operator Unique Entity Number
:Unique Entity Number for vessel operator
:ACRA
:Min characters = 9, Max characters = 10
Alphanumeric. Final character is an alpha

vessel_operator_nm
string or null (Vessel Operator Name)

:Organisation name for vessel operator
:Vessel Operator Name
:Organisation name for vessel operator
:NA
:NA

vessel_psa_service
string or null (PSA Service Code)

:Shipping service code used by PSA
:PSA Service Code
:Shipping service code used by PSA
:NA
:NA

vessel_psa_service_desc
string or null (PSA Service Description)

:Description of shipping service used by PSA
:PSA Service Description
:Description of shipping service used by PSA
:NA
:NA

vessel_cust_service
string or null (Customer Service Code)

:Shipping service code used by carriers
:Customer Service Code
:Shipping service code used by carriers
:NA
:NA

vessel_cust_service_desc
string or null (Customer Service Description)

:Description of service code used by carriers
:Customer Service Description
:Description of service code used by carriers
:NA
:NA

vessel_status
required
string (Vessel Status)

:Status of vessel - Berthing, Alongside, Unberthing
:Vessel Status
:Status of vessel - Berthing, Alongside, Unberthing
:Custom
:Min characters = 8, Max characters = 10
Alpha, equal to "Berthing", "Alongside" or "Unberthing"

vessel_shift_seq
string or null (Shift Sequence Number)

:Number of the shift sequence
:Shift Sequence Number
:Number of the shift sequence
:NA
:NA

vessel_atb_dt
string or null <date-time> (Vessel Actual Time of Berthing Date-Time)

:Actual time of berthing at terminal
:Vessel Actual Time of Berthing Date-Time
:Actual time of berthing at terminal
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

vessel_atu_dt
string or null <date-time> (Vessel Actual Time of Unberthing Date-Time)

:Actual time of unberthing from terminal
:Vessel Actual Time of Unberthing Date-Time
:Actual time of unberthing from terminal
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

vessel_cod_dt
string or null <date-time> (Vessel Completion Of Discharge Date-Time)

:Actual time of completion of discharge for all containers
:Vessel Completion Of Discharge Date-Time
:Actual time of completion of discharge for all containers
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

vessel_col_dt
string or null <date-time> (Vessel Completion Of Loading Date-Time)

:Actual time of completion of loading for all containers
:Vessel Completion Of Loading Date-Time
:Actual time of completion of loading for all containers
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

vessel_cob_dt
string or null <date-time> (Vessel Completion Of Bunker Date-Time)

:Actual time of completion of bunker
:Vessel Completion Of Bunker Date-Time
:Actual time of completion of bunker
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

snapshot_dt
required
string <date-time> (Snapshot Date-Time)

:Timestamp of this record being captured
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

Example
{
  • "container_no": "string",
  • "unique_cargo_ref": "string",
  • "vessel_imo": "string",
  • "abbr_vessel_nm": "string",
  • "vessel_nm": "string",
  • "abbr_inward_voy": "string",
  • "inward_voyage_no": "string",
  • "abbr_outward_voy": "string",
  • "outward_voyage_no": "string",
  • "vessel_btr_dt": "2019-08-24T14:15:22Z",
  • "vessel_etb_dt": "2019-08-24T14:15:22Z",
  • "vessel_etu_dt": "2019-08-24T14:15:22Z",
  • "abbr_terminal_nm": "string",
  • "vessel_etd_dt": "2019-08-24T14:15:22Z",
  • "terminal_berth": "string",
  • "vessel_consortium_nm": "string",
  • "vessel_consortium_cd": "string",
  • "vessel_operator_cd": "string",
  • "vessel_operator_uen": "string",
  • "vessel_operator_nm": "string",
  • "vessel_psa_service": "string",
  • "vessel_psa_service_desc": "string",
  • "vessel_cust_service": "string",
  • "vessel_cust_service_desc": "string",
  • "vessel_status": "string",
  • "vessel_shift_seq": "string",
  • "vessel_atb_dt": "2019-08-24T14:15:22Z",
  • "vessel_atu_dt": "2019-08-24T14:15:22Z",
  • "vessel_cod_dt": "2019-08-24T14:15:22Z",
  • "vessel_col_dt": "2019-08-24T14:15:22Z",
  • "vessel_cob_dt": "2019-08-24T14:15:22Z",
  • "snapshot_dt": "2019-08-24T14:15:22Z"
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

:Note
:Note
:Note
:NA
:NA

Array of objects or null (Other Documents Attachment)

:Other Documents Attachment
:Other Documents Attachment
:Other Documents Attachment
:NA
:NA

{
  • "note": "string",
  • "attachments": [
    ]
}

Use Case B (Parameters)

Parameter schemas for Use Case B

Depot Timeslot Booking

Data Element ID: depot_timeslot_booking

depot_booking_ref
required
Array of strings (Depot Booking Ref)

Provide list of booking references

depot_booking_type
required
string (Depot Booking Type)

Container Return (R) / Collection (C) / Import (I) / Export (E)

required
object (Snapshot Dt)
{
  • "depot_booking_ref": [
    ],
  • "depot_booking_type": "string",
  • "snapshot_dt": {
    }
}

Electronic Delivery Order

Data Element ID: electronic_delivery_order

One of
haulier_nm
string or null (Haulier Name)

Name of haulier as per Port of Singapore Authority definition.

One of Haulier Name (Haulier Org Code) or Haulier Code must be provided for this query

haulier_cd
string or null (Haulier Code)

Code of haulier as per Port of Singapore Authority definition.

One of Haulier Name (Haulier Org Code) or Haulier Code must be provided for this query

delivery_type_cd
string or null (Delivery Type Code)

Delivery Type (Blank, I or M). Where I is FCL & Commercial Empty and M is Nominated Empty. No imput will default to blank and return both FCL and Nominated Empty

Example
{
  • "haulier_nm": "string",
  • "haulier_cd": "string",
  • "delivery_type_cd": "string"
}

Haulier Depot Entry/Exit

Data Element ID: haulier_depot_entry_exit

depot_booking_ref
required
Array of strings (Depot Booking Ref)

Provide list of booking references (comma delimited)

depot_booking_type
required
string (Depot Booking Type)

Container Return (R) / Collection (C) / Import (I) / Export (E)

required
object (Snapshot Dt)
{
  • "depot_booking_ref": [
    ],
  • "depot_booking_type": "string",
  • "snapshot_dt": {
    }
}

Haulier Gps

Data Element ID: haulier_gps

One of
position_latitude
required
number <double> (Position Latitude)

Latitude coordinates of vehicle

position_longitude
required
number <double> (Position Longtitude)

Longitude coordinates of vehicle

position_radius_metres
required
string (Position Radius Metres)

Range of geofence

Example
{
  • "position_latitude": 0.1,
  • "position_longitude": 0.1,
  • "position_radius_metres": "string"
}

Haulier Port Entry/Exit

Data Element ID: haulier_port_entry_exit

One of
unique_cargo_ref
required
Array of strings (Unique Cargo Ref)

Provide list of UCR

Example
{
  • "unique_cargo_ref": [
    ]
}

Haulier Trip Details

Data Element ID: haulier_trip_details

One of
job_booking_ref
required
Array of strings (Job Booking Ref)

Job Booking Reference / Booking Confirmation number

Example
{
  • "job_booking_ref": [
    ]
}

Release Depot

Data Element ID: release_depot

unique_cargo_ref
required
Array of strings (Unique Cargo Reference)

Unique Cargo Reference / Booking Confirmation number

{
  • "unique_cargo_ref": [
    ]
}

Release Order

Data Element ID: release_order

unique_cargo_ref
required
Array of strings (Unique Cargo Ref)

Provide list of UCR (comma delimited)

{
  • "unique_cargo_ref": [
    ]
}

Storing Depot

Data Element ID: storing_depot

container_no
required
Array of strings (Container Number)

Identification number of container (ISO6346) - Example: CBHU4398907

required
object (Snapshot Dt)
{
  • "container_no": [
    ],
  • "snapshot_dt": {
    }
}

Storing Order

Data Element ID: storing_order

container_no
required
Array of strings (Container No)

Provide list of container numbers

required
object (Snapshot Dt)
{
  • "container_no": [
    ],
  • "snapshot_dt": {
    }
}

Vessel Journey

Data Element ID: vessel_journey_in

One of
container_no
string or null (Container Number)

Identification number of container. Sample value: CBHU4398907

bill_lading_no
required
string (Bill of Lading Number)

Bill of lading number / booking number

carrier_no
string or null (Carrier Code)

Code of the carrier issued the booking confirmation to shipper/consignee/ 3PL/4PL for their shipment as per SCAC definition.
Sample: CMDU

{
  • "container_no": "string",
  • "bill_lading_no": "string",
  • "carrier_no": "string"
}

Vessel Voyage Schedule

Data Element ID: vessel_activity

One of
vessel_nm
required
string (Full Vessel Name)

Full name of the vessel

voyage_no
required
string (Voyage Number)

Full inward/ outward voyage number

Example
{
  • "vessel_nm": "string",
  • "voyage_no": "string"
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

Note

{
  • "note": "string"
}

Use Case C (Payload)

Payload schemas for Use Case C

Barge Bunkering Event

Data Element ID: barge_event_data

barge_bunker_barge_actual_arrival_dt
required
string <date-time> (Barge Bunker Barge Actual Arrival Dt)

:Bunker Barge Actual Arrival Date And Time
:Bunker Barge Actual Arrival Date and Time
:Bunker Barge Actual Arrival Date and Time
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

barge_bunkering_hose_connect_dt
required
string <date-time> (Barge Bunkering Hose Connect Dt)

:Bunkering Hose connect time
:Bunkering Hose Connect Time
:Bunkering Hose Connect Time
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

barge_bunkering_hose_disconnect_dt
required
string <date-time> (Barge Bunkering Hose Disconnect Dt)

:Bunkering Hose Disconnect Time
:Bunkering Hose Disconnect Time
:Bunkering Hose Disconnect Time
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

barge_bunker_barge_actual_departure_dt
required
string <date-time> (Barge Bunker Barge Actual Departure Dt)

:Bunker Barge Actual Departure Date And Time
:Bunker Barge Actual Departure Date and Time
:Bunker Barge Actual Departure Date and Time
:ISO 8601
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

barge_bdn_no
required
string (Barge Bdn No)

:BDN number
:Bunker Delivery Note Number
:Bunker Delivery Note Number
:NA
:NA

barge_bunker_supplier_company_nm
required
string (Barge Bunker Supplier Company Nm)

:Bunker Supplier Company Name
:Bunker Supplier Company Name
:Bunker Supplier Company Name
:NA
:NA

barge_bunker_supplier_contact_no
required
string (Barge Bunker Supplier Contact No)

:Bunker Supplier Contact Number
:Bunker Supplier Contact Number
:Bunker Supplier Contact Number
:NA
:NA

Array of objects or null (Attachments)

:NA
:Barge Bunkering Event Attachment
:Barge Bunkering Event Attachment
:NA
:NA

{
  • "barge_bunker_barge_actual_arrival_dt": "2019-08-24T14:15:22Z",
  • "barge_bunkering_hose_connect_dt": "2019-08-24T14:15:22Z",
  • "barge_bunkering_hose_disconnect_dt": "2019-08-24T14:15:22Z",
  • "barge_bunker_barge_actual_departure_dt": "2019-08-24T14:15:22Z",
  • "barge_bdn_no": "string",
  • "barge_bunker_supplier_company_nm": "string",
  • "barge_bunker_supplier_contact_no": "string",
  • "attachments": [
    ]
}

Bunker Delivery Note

Data Element ID: bunker_delivery_note

bdn_bunker_tanker_seal_no
required
string (Master's/Chief Engineer's Acknowledgement - Seal No (Bunker Tanker))

:Master's/Chief Engineer's Acknowledgement - Seal No (Bunker Tanker)
:Master's/Chief Engineer's Acknowledgement - Seal No (Bunker Tanker)
:Master's/Chief Engineer's Acknowledgement - Seal No (Bunker Tanker)
:NA
:Alphanumeric Characters Only

bdn_surveyor_seal_no
required
string (Master's/Chief Engineer's Acknowledgement - Seal No (Surveyor))

:Master's/Chief Engineer's Acknowledgement - Seal No (Surveyor)
:Master's/Chief Engineer's Acknowledgement - Seal No (Surveyor)
:Master's/Chief Engineer's Acknowledgement - Seal No (Surveyor)
:NA
:Alphanumeric Characters Only

bdn_delivery_port
required
string (Port of Delivery)

:Port of Delivery
:Port of Delivery
:Port of Delivery
:NA
:Alphabetical Characters Only

bdn_delivery_location
required
string (Delivery Location)

:Delivery Location
:Delivery Location
:Delivery Location
:NA
:Alphanumeric Characters Only

bdn_bunker_tanker_nm
required
string (Bunker Tanker Name)

:Bunker Tanker Name
:Bunker Tanker Name
:Bunker Tanker Name
:NA
:Alphanumeric Characters Only

bdn_sb_no
required
string (Bunker Tanker License Number)

:Bunker Tanker License Number. The format for license number should be SB NNNNA
:Bunker Tanker License Number
:Bunker Tanker License Number. The format for license number should be SB NNNNA
:NA
:Alphanumeric Characters Only

bdn_alongside_vessel_dt
required
string <date-time> (Time of Alongside Receiving Vessel )

:Time of Alongside Receiving Vessel
:Time of Alongside Receiving Vessel
:Time of Alongside Receiving Vessel
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

bdn_commenced_pumping_dt
required
string <date-time> (Commencement of Pumping)

:Commencement of Pumping
:Commencement of Pumping
:Commencement of Pumping
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

bdn_completed_pumping_dt
required
string <date-time> (Completion of Pumping)

:Completion of Pumping
:Completion of Pumping
:Completion of Pumping
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

bdn_no
required
string (Bunker Delivery Note Number)

:Bunker Delivery Note Number
:Bunker Delivery Note Number
:Bunker Delivery Note Number
:NA
:Alphanumeric Characters Only

bdn_bunker_metering_ticket_no
integer or null <int64> (Bunker Metering Ticket Number (BTN))

:Bunker Metering Ticket Number (BTN)
:Bunker Metering Ticket Number (BTN)
:Bunker Metering Ticket Number (BTN)
:NA
:Numerical digits only

bdn_dt
required
string <date> (Date of Operation)

:Date of Operation
:Date of Operation
:Date of Operation
:NA
:date (YYYY-MM-DD)

bdn_vessel_nm
required
string (Vessel Name)

:Name of vessel
:Vessel Name
:Name of vessel
:NA
:Alphanumeric Characters Only

bdn_vessel_imo_no
required
string (Vessel International Maritime Organisation Number)

:International Maritime Organisation (IMO) Vessel Identification Number
:Vessel International Maritime Organisation Number
:International Maritime Organisation (IMO) Vessel Identification Number
:International
:7 digit Numeric Characters Only

bdn_gross_tonnage
required
integer <int64> (Gross Tonnage )

:Gross Tonnage
:Gross Tonnage
:Gross Tonnage
:NA
:Numerical digits only

bdn_owner_operator_nm
required
string (Owner/Operator)

:Owner/Operator
:Owner/Operator
:Owner/Operator
:NA
:Alphanumeric Characters Only

bdn_etd_dt
required
string <date> (Estimated Date of Departure)

:Estimated Date of Departure
:Estimated Date of Departure
:Estimated Date of Departure
:NA
:date (YYYY-MM-DD)

bdn_next_port
required
string (Next Port of Call)

:Next Port of Call
:Next Port of Call
:Next Port of Call
:NA
:Alphabetical Characters Only

bdn_supplied_product_nm
required
string (Supplied Product Name)

:Supplied Product Name
:Supplied Product Name
:Supplied Product Name
:NA
:Alphabetical Characters Only

bdn_supplied_product_viscosity
required
number <double> (Product Viscosity)

:Product Viscosity
:Product Viscosity
:Product Viscosity
:International
:Numerical digits only with up to 4 decimal

bdn_supplied_product_coq_density
required
number <double> (Product Density)

:Product Density
:Product Density
:Product Density
:International
:Numerical digits only with up to 4 decimal

bdn_supplied_product_water_content
required
number <double> (Product Water Content)

:Product Water Content
:Product Water Content
:Product Water Content
:International
:Numerical digits only with up to 3 decimal

bdn_supplied_product_flash_point
required
number <double> (Product Flash Point)

:Product Flash Point
:Product Flash Point
:Product Flash Point
:International
:Numerical digits only with up to 1 decimal

bdn_supplied_product_sulphur_content
required
number <double> (Product Sulphur Content)

:Product Sulphur Content
:Product Sulphur Content
:Product Sulphur Content
:International
:Numerical digits only with up to 3 decimal

bdn_supplied_product_metric_tons_delivered
required
number <double> (Product Metric Tons Delivered )

:Product Metric Tons Delivered
:Product Metric Tons Delivered
:Product Metric Tons Delivered
:NA
:Numerical digits only with up to 3 decimal

bdn_declaration_reg_14_1_of_annex
required
boolean (Supplier's Declaration Reg14.1 of Annex)

:Supplier's Declaration Reg14.1 of Annex
:Supplier's Declaration Reg14.1 of Annex
:Supplier's Declaration Reg14.1 of Annex
:NA
:NA

bdn_declaration_reg_14_4_of_annex
required
boolean (Supplier's Declaration Reg14.4 of Annex)

:Supplier's Declaration Reg14.4 of Annex
:Supplier's Declaration Reg14.4 of Annex
:Supplier's Declaration Reg14.4 of Annex
:NA
:NA

bdn_declaration_specified_limit_value_of_annex
required
boolean (Supplier's Declaration Specified Limit Value of Annex)

:Supplier's Declaration Specified Limit Value of Annex
:Supplier's Declaration Specified Limit Value of Annex
:Supplier's Declaration Specified Limit Value of Annex
:NA
:NA

bdn_supplier_confirmation_company_nm
required
string (Bunker Supplier Company Name)

:Bunker Supplier Company Name
:Bunker Supplier Company Name
:Bunker Supplier Company Name
:NA
:Alphanumeric Characters Only

bdn_cargo_officer_nm
required
string (Cargo Officer's Full Name in Block Letters)

:Cargo Officer's Full Name in Block Letters
:Cargo Officer's Full Name in Block Letters
:Cargo Officer's Full Name in Block Letters
:NA
:Alphabetical Characters Only

bdn_remarks
string or null (Additional Remarks)

:Additional Remarks
:Additional Remarks
:Additional Remarks
:NA
:Alphanumeric Characters Only

bdn_vessel_seal_no
required
string (Master's/Chief Engineer's Acknowledgement - Seal No. (Vessel))

:Master's/Chief Engineer's Acknowledgement - Seal Number (Vessel)
:Master's/Chief Engineer's Acknowledgement - Seal No. (Vessel)
:Master's/Chief Engineer's Acknowledgement - Seal Number (Vessel)
:NA
:Alphanumeric Characters Only

bdn_marpol_seal_no
required
string (Master's/Chief Engineer's Acknowledgement - Seal No. (MARPOL))

:Master's/Chief Engineer's Acknowledgement - Seal Number (MARPOL)
:Master's/Chief Engineer's Acknowledgement - Seal No. (MARPOL)
:Master's/Chief Engineer's Acknowledgement - Seal Number (MARPOL)
:NA
:Alphanumeric Characters Only

bdn_others_seal_no
required
string (Master's/Chief Engineer's Acknowledgement - Seal No. (Others))

:Master's/Chief Engineer's Acknowledgement - Seal Number (Others)
:Master's/Chief Engineer's Acknowledgement - Seal No. (Others)
:Master's/Chief Engineer's Acknowledgement - Seal Number (Others)
:NA
:Alphanumeric Characters Only

bdn_vessel_counter_seal_no
string or null (Master's/Chief Engineer's Acknowledgement - Counter Seal No. (Vessel))

:Master's/Chief Engineer's Acknowledgement - Counter Seal Number (Vessel)
:Master's/Chief Engineer's Acknowledgement - Counter Seal No. (Vessel)
:Master's/Chief Engineer's Acknowledgement - Counter Seal Number (Vessel)
:NA
:Alphanumeric Characters Only

bdn_marpol_counter_seal_no
string or null (Master's/Chief Engineer's Acknowledgement - Counter Seal No. (MARPOL))

:Master's/Chief Engineer's Acknowledgement - Counter Seal Number (MARPOL)
:Master's/Chief Engineer's Acknowledgement - Counter Seal No. (MARPOL)
:Master's/Chief Engineer's Acknowledgement - Counter Seal Number (MARPOL)
:NA
:Alphanumeric Characters Only

bdn_bunker_tanker_counter_seal_no
string or null (Master's/Chief Engineer's Acknowledgement - Counter Seal No. (Bunker Tanker))

:Master's/Chief Engineer's Acknowledgement - Counter Seal Number (Bunker Tanker)
:Master's/Chief Engineer's Acknowledgement - Counter Seal No. (Bunker Tanker)
:Master's/Chief Engineer's Acknowledgement - Counter Seal Number (Bunker Tanker)
:NA
:Alphanumeric Characters Only

bdn_surveyor_counter_seal_no
string or null (Master's/Chief Engineer's Acknowledgement - Counter Seal No. (Surveyor))

:Master's/Chief Engineer's Acknowledgement - Counter Seal Number (Surveyor)
:Master's/Chief Engineer's Acknowledgement - Counter Seal No. (Surveyor)
:Master's/Chief Engineer's Acknowledgement - Counter Seal Number (Surveyor)
:NA
:Alphanumeric Characters Only

bdn_others_counter_seal_no
string or null (Master's/Chief Engineer's Acknowledgement - Counter Seal No. (Others))

:Master's/Chief Engineer's Acknowledgement - Counter Seal Number (Others)
:Master's/Chief Engineer's Acknowledgement - Counter Seal No. (Others)
:Master's/Chief Engineer's Acknowledgement - Counter Seal Number (Others)
:NA
:Alphanumeric Characters Only

bdn_protest_issued_note
required
boolean (Note of Protest Issued)

:Whether a note of protest has been issued
Accepted value is ‘Y’ or ‘N’
:Note of Protest Issued
:Whether a note of protest has been issue
Accepted value is ‘Y’ or ‘N’
:NA
:NA

bdn_customer_feedback
required
integer <int64> (Customer Rating )

:Customer Rating
Accepted value from 1 to 5.
1 - very unsatisfied, 5 - very satisfied
:Customer Rating
:Customer Rating
Accepted value from 1 to 5.
1 - very unsatisfied, 5 - very satisfied
:NA
:1 Numeric Characters Only (Between 1 to 5)

bdn_master_or_chief_enginer_nm
required
string (Full Name of Master/Chief Engineer)

:Full Name of Master/Chief Engineer
:Full Name of Master/Chief Engineer
:Full Name of Master/Chief Engineer
:NA
:Alphabetical Characters Only

required
Array of objects (Attachments) non-empty

:NA
:Bunker Delivery Note Attachment
:Bunker Delivery Note Attachment
:NA
:.PDF format

bdn_specified_limit_value
number or null <double> (Supplier's Declaration (if declarationSpecifiedLimitValueofAnnex is TRUE))

:Supplier's Declaration (if declarationSpecifiedLimitValueofAnnex is TRUE)
:Supplier's Declaration (if declarationSpecifiedLimitValueofAnnex is TRUE)
:Supplier's Declaration (if declarationSpecifiedLimitValueofAnnex is TRUE)
:NA
:Numerical digits only

bdn_sds_copy
boolean or null (Was a copy of SDS received)

:Was a copy of Safety Data Sheet (SDS) received
:Was a copy of SDS received
:Was a copy of Safety Data Sheet (SDS) received
:NA
:NA

bdn_license_no
required
string (Bunker Supplier License Number)

:Bunker Supplier License Number
:Bunker Supplier License Number
:Bunker Supplier License Number
:NA
:Numerical digits only

bunkerMeteringTicketNo
string or null (Bunker Metering Ticket (BMT) No.)

:Mass flow metering ticket number for each bunker delivery
:Bunker Metering Ticket (BMT) No.
:Mass flow metering ticket number for each bunker delivery
:NA
:Alphanumeric Characters Only

{
  • "bdn_bunker_tanker_seal_no": "string",
  • "bdn_surveyor_seal_no": "string",
  • "bdn_delivery_port": "string",
  • "bdn_delivery_location": "string",
  • "bdn_bunker_tanker_nm": "string",
  • "bdn_sb_no": "string",
  • "bdn_alongside_vessel_dt": "2019-08-24T14:15:22Z",
  • "bdn_commenced_pumping_dt": "2019-08-24T14:15:22Z",
  • "bdn_completed_pumping_dt": "2019-08-24T14:15:22Z",
  • "bdn_no": "string",
  • "bdn_bunker_metering_ticket_no": 0,
  • "bdn_dt": "2019-08-24",
  • "bdn_vessel_nm": "string",
  • "bdn_vessel_imo_no": "string",
  • "bdn_gross_tonnage": 0,
  • "bdn_owner_operator_nm": "string",
  • "bdn_etd_dt": "2019-08-24",
  • "bdn_next_port": "string",
  • "bdn_supplied_product_nm": "string",
  • "bdn_supplied_product_viscosity": 0.1,
  • "bdn_supplied_product_coq_density": 0.1,
  • "bdn_supplied_product_water_content": 0.1,
  • "bdn_supplied_product_flash_point": 0.1,
  • "bdn_supplied_product_sulphur_content": 0.1,
  • "bdn_supplied_product_metric_tons_delivered": 0.1,
  • "bdn_declaration_reg_14_1_of_annex": true,
  • "bdn_declaration_reg_14_4_of_annex": true,
  • "bdn_declaration_specified_limit_value_of_annex": true,
  • "bdn_supplier_confirmation_company_nm": "string",
  • "bdn_cargo_officer_nm": "string",
  • "bdn_remarks": "string",
  • "bdn_vessel_seal_no": "string",
  • "bdn_marpol_seal_no": "string",
  • "bdn_others_seal_no": "string",
  • "bdn_vessel_counter_seal_no": "string",
  • "bdn_marpol_counter_seal_no": "string",
  • "bdn_bunker_tanker_counter_seal_no": "string",
  • "bdn_surveyor_counter_seal_no": "string",
  • "bdn_others_counter_seal_no": "string",
  • "bdn_protest_issued_note": true,
  • "bdn_customer_feedback": 0,
  • "bdn_master_or_chief_enginer_nm": "string",
  • "attachments": [
    ],
  • "bdn_specified_limit_value": 0.1,
  • "bdn_sds_copy": true,
  • "bdn_license_no": "string",
  • "bunkerMeteringTicketNo": "string"
}

Bunker Delivery Note (SCIC)

Data Element ID: scic_bunker_delivery_note

bunkerSupplierName
string or null (supplierCompanyName)

:Supplier name which is licensed by implementing authority
:supplierCompanyName
:Supplier name which is licensed by implementing authority
:NA
:NA

supplierLicenceNumber
string or null (supplierLicenceNumber)

:Supplier's licence number issued by local authority (MPA)
:supplierLicenceNumber
:Supplier's licence number issued by local authority (MPA)
:NA
:NA

port
string or null (Port)

:Port of bunker delivery
:Port
:Port of bunker delivery
:NA
:NA

deliveryLocationName
string or null (deliveryLocation)

:Location of bunker delivery
:deliveryLocation
:Location of bunker delivery
:NA
:NA

bunkerTankerName
string or null (bunkerTankerName)

:Delivery bunker tanker name
:bunkerTankerName
:Delivery bunker tanker name
:NA
:NA

bunkerTankerLicenceNo
string or null (SB No.)

:Local license number of delivery bunker tanker
:SB No.
:Local license number of delivery bunker tanker
:NA
:NA

bdnNo
integer or null (BDN NO.)

:BDN number, issued by Supplier's system
:BDN NO.
:BDN number, issued by Supplier's system
:NA
:NA

operationDate
string or null (Date)

:Date of BDN issued
:Date
:Date of BDN issued
:NA
:yyyy-MM-dd HH:mm:ss

receivingVesselName
string or null (Vessel's Name)

:Name of receiving vessel
:Vessel's Name
:Name of receiving vessel
:NA
:NA

receiveVesselImoNo
string or null (Vessel's IMO No.)

:International Maritime Organisation number of the receiving vessel
:Vessel's IMO No.
:International Maritime Organisation number of the receiving vessel
:NA
:NA

receiveVesselGST
string or null (grossTonnage)

:Receiving vessel's gross tonnage
:grossTonnage
:Receiving vessel's gross tonnage
:NA
:NA

ownerOperator
string or null (Owner/Operator)

:Owner/Operator name for receiving vessel
:Owner/Operator
:Owner/Operator name for receiving vessel
:NA
:NA

nextPort
string or null (Next Port)

:Next port of call for receiving vessel
:Next Port
:Next port of call for receiving vessel
:NA
:NA

alongsideTime
string or null (Along Vessel)

:Date/time when delivery bunker tanker alongside receiving vessel
:Along Vessel
:Date/time when delivery bunker tanker alongside receiving vessel
:NA
:yyyy-MM-dd HH:mm:ss

pumpingCommencedDatetime
string or null (Commence Pumping)

:Date and time of start of delivery (pump start)
:Commence Pumping
:Date and time of start of delivery (pump start)
:NA
:yyyy-mm-dd hh:mm

pumpingCompletedDatetime
string or null (Completed Pumping)

:Date and time of end of delivery (pump stop)
:Completed Pumping
:Date and time of end of delivery (pump stop)
:NA
:yyyy-mm-dd hh:mm

expectedReceivingVesselDepartureDatetime
string or null (ETD)

:Estimated date of receiving vessel departure
:ETD
:Estimated date of receiving vessel departure
:NA
:yyyy-mm-dd hh:mm

productNameQTR
string or null (productName)

:Commercial or trade name of bunkers
:productName
:Commercial or trade name of bunkers
:NA
:NA

productType
string or null (productType)

:Product type as listed in ISO8217
:productType
:Product type as listed in ISO8217
:NA
:NA

flashPoint
number or null (flashPoint)

:Flash Point of the bunker supplied as from COQ of bunker cargo loaded (ISO2719)
:flashPoint
:Flash Point of the bunker supplied as from COQ of bunker cargo loaded (ISO2719)
:NA
:NA

density15Degc
number or null (density15Degc)

:Density of bunker at 15 degree Celsius as from COQ of bunker cargo loaded (ISO 3675 or ISO 12185)
:density15Degc
:Density of bunker at 15 degree Celsius as from COQ of bunker cargo loaded (ISO 3675 or ISO 12185)
:NA
:NA

viscosity40Degc50Degc
number or null (viscosity40Degc50Degc)

: Viscosity of bunker at 40 degree Celsius or 50 degree Celsius as from COQ of bunker cargo loaded (ISO 3104)
:viscosity40Degc50Degc
: Viscosity of bunker at 40 degree Celsius or 50 degree Celsius as from COQ of bunker cargo loaded (ISO 3104)
:NA
:NA

waterContent
number or null (waterContent)

:Water content, in percentage, of the bunker delivered as from COQ (ISO 3733)
:waterContent
:Water content, in percentage, of the bunker delivered as from COQ (ISO 3733)
:NA
:NA

sulfurContent
number or null (date)

:Sulphur content, in percentage, of the bunker delivered as from COQ of bunker cargo loaded (ISO 14596 or ISO8754)
:date
:Sulphur content, in percentage, of the bunker delivered as from COQ of bunker cargo loaded (ISO 14596 or ISO8754)
:NA
:NA

sulphurDoesNotExceedPurchaserLimit
boolean or null (sulphurDoesNotExceedPurchaserLimit)

:Declaration that the bunker supplied conforms with MARPOL Annex VI
:sulphurDoesNotExceedPurchaserLimit
:Declaration that the bunker supplied conforms with MARPOL Annex VI
:NA
:NA

sulphurPurchaserLimit
number or null (sulphurPurchaserLimit)

:Specific sulphur limit of the bunker fuel required by purchaser
:sulphurPurchaserLimit
:Specific sulphur limit of the bunker fuel required by purchaser
:NA
:NA

bunkerMeteringTicketNo
string or null (bunkerMeteringTicketNo)

:Mass flow metering ticket number for each bunker delivery
:bunkerMeteringTicketNo
:Mass flow metering ticket number for each bunker delivery
:NA
:NA

quantityDelivered
number or null (Metric Tons Delivered)

:The total quantity delivered is the cumulative mass quantity measured between the start of delivery and end of delivery, and transferred to the vessel.
:Metric Tons Delivered
:The total quantity delivered is the cumulative mass quantity measured between the start of delivery and end of delivery, and transferred to the vessel.
:NA
:NA

bunkerTanker RetainedSampleCounterSeal
string or null (bunkerTanker RetainedSampleCounterSeal)

:3rd party (e.g. surveyor) counter seal numbers applied on the sample bottles, retained by bunker tanker.
:bunkerTanker RetainedSampleCounterSeal
:3rd party (e.g. surveyor) counter seal numbers applied on the sample bottles, retained by bunker tanker.
:NA
:NA

bunkerTankerRetainedSampleSeal
string or null (bunkerTankerRetainedSampleSeal)

:Supplier seal numbers applied on the sample bottles, retained by bunker tanker.
:bunkerTankerRetainedSampleSeal
:Supplier seal numbers applied on the sample bottles, retained by bunker tanker.
:NA
:NA

otherRetainedSampleCounterSeal
string or null (otherRetainedSampleCounterSeal)

:3rd party (e.g. surveyor) counter seal numbers applied on the sample bottles, retained by others
:otherRetainedSampleCounterSeal
:3rd party (e.g. surveyor) counter seal numbers applied on the sample bottles, retained by others
:NA
:NA

otherRetainedSampleSeal
string or null (otherRetainedSampleSeal)

:Supplier seal numbers applied on the sample bottles, retained by others
:otherRetainedSampleSeal
:Supplier seal numbers applied on the sample bottles, retained by others
:NA
:NA

nameParty
string or null (nameParty)

:Name of party sample collected for.
:nameParty
:Name of party sample collected for.
:NA
:NA

surveyorRetainedSampleCounterSeal
string or null (surveyorRetainedSampleCounterSeal)

:3rd party (e.g. surveyor) counter seal numbers applied on the sample bottles, retained by surveyor
:surveyorRetainedSampleCounterSeal
:3rd party (e.g. surveyor) counter seal numbers applied on the sample bottles, retained by surveyor
:NA
:NA

surveyorRetainedSampleSeal
string or null (surveyorRetainedSampleSeal)

:Supplier seal numbers applied on the sample bottles, retained by surveyor.
:surveyorRetainedSampleSeal
:Supplier seal numbers applied on the sample bottles, retained by surveyor.
:NA
:NA

vesselRetainedSampleCounterSeal
string or null (vesselRetainedSampleCounterSeal)

:3rd party (e.g. surveyor) counter seal numbers applied on the sample bottles, retained by vessel
:vesselRetainedSampleCounterSeal
:3rd party (e.g. surveyor) counter seal numbers applied on the sample bottles, retained by vessel
:NA
:NA

vesselRetainedSampleSeal
string or null (vesselRetainedSampleSeal)

:Supplier seal numbers applied on the sample bottles, retained by vessel.
:vesselRetainedSampleSeal
:Supplier seal numbers applied on the sample bottles, retained by vessel.
:NA
:NA

marpolSampleCounterSealNo
string or null (marpolSampleCounterSealNo)

:3rd party (e.g. surveyor) counter seal numbers applied on the sample bottles, retained as MARPOL sample
:marpolSampleCounterSealNo
:3rd party (e.g. surveyor) counter seal numbers applied on the sample bottles, retained as MARPOL sample
:NA
:NA

marpolSampleSealNo
string or null (marpolSampleSealNo)

:Supplier seal numbers applied on the sample bottles, retained as MARPOL sample.
:marpolSampleSealNo
:Supplier seal numbers applied on the sample bottles, retained as MARPOL sample.
:NA
:NA

cargoOfficerNameEnd
string or null (cargoOfficerName)

:Name of licenced cargo officer on duty.
:cargoOfficerName
:Name of licenced cargo officer on duty.
:NA
:NA

signatureOfCargoOfficerEnd
string or null (signatureOfCargoOfficer)

:Signature of licenced cargo officer on duty
:signatureOfCargoOfficer
:Signature of licenced cargo officer on duty
:NA
:NA

bunkerTanker''SStamp
string or null (bunkerTanker'SStamp)

:Official stamp of bunker tanker
:bunkerTanker''SStamp
:Official stamp of bunker tanker
:NA
:NA

chiefEngineerNameEnd
string or null (masterOrChiefEnginerName)

:Name of Captain or Chief Engineer onboard receiving vessel
:masterOrChiefEnginerName
:Name of Captain or Chief Engineer onboard receiving vessel
:NA
:NA

signatureOfMasterChiefEngineerEnd
string or null (signatureOfMasterChiefEngineer)

:Signature of receiving vessel Master or Chief Engineer
:signatureOfMasterChiefEngineer
:Signature of receiving vessel Master or Chief Engineer
:NA
:NA

ChiefEngineerDateTimeEnd
string or null (dateAndTimeOfSignature)

:Date and time of receiving vessel's Master's or Chief Engineer's signature
:dateAndTimeOfSignature
:Date and time of receiving vessel's Master's or Chief Engineer's signature
:NA
:yyyy-MM-dd HH:mm:ss

vesselStamp
string or null (vessel'SStamp)

:Receiving vessel stamp
:vessel'SStamp
:Receiving vessel stamp
:NA
:NA

remarks
string or null (remarks)

:remarks
:remarks
:remarks
:NA
:NA

customerRating
string or null (customerFeedback)

:Feedback by receiving vessel Master / Chief Engineer
:customerFeedback
:Feedback by receiving vessel Master / Chief Engineer
:NA
:NA

sdsCopyReceived
boolean or null (SDS)

:Safety Data Sheet given
:SDS
:Safety Data Sheet given
:NA
:NA

protestNote
boolean or null (protestNote)

:Note of protest given
:noteLetterOfProtestIssued
:Note of protest given
:NA
:NA

Array of objects or null (Attachments)

:NA
:Sales Invoice (Delivered) Attachment
:Sales Invoice (Delivered) Attachment
:NA
:.PDF format

{
  • "bunkerSupplierName": "string",
  • "supplierLicenceNumber": "string",
  • "port": "string",
  • "deliveryLocationName": "string",
  • "bunkerTankerName": "string",
  • "bunkerTankerLicenceNo": "string",
  • "bdnNo": 0,
  • "operationDate": "string",
  • "receivingVesselName": "string",
  • "receiveVesselImoNo": "string",
  • "receiveVesselGST": "string",
  • "ownerOperator": "string",
  • "nextPort": "string",
  • "alongsideTime": "string",
  • "pumpingCommencedDatetime": "string",
  • "pumpingCompletedDatetime": "string",
  • "expectedReceivingVesselDepartureDatetime": "string",
  • "productNameQTR": "string",
  • "productType": "string",
  • "flashPoint": 0,
  • "density15Degc": 0,
  • "viscosity40Degc50Degc": 0,
  • "waterContent": 0,
  • "sulfurContent": 0,
  • "sulphurDoesNotExceedPurchaserLimit": true,
  • "sulphurPurchaserLimit": 0,
  • "bunkerMeteringTicketNo": "string",
  • "quantityDelivered": 0,
  • "bunkerTanker RetainedSampleCounterSeal": "string",
  • "bunkerTankerRetainedSampleSeal": "string",
  • "otherRetainedSampleCounterSeal": "string",
  • "otherRetainedSampleSeal": "string",
  • "nameParty": "string",
  • "surveyorRetainedSampleCounterSeal": "string",
  • "surveyorRetainedSampleSeal": "string",
  • "vesselRetainedSampleCounterSeal": "string",
  • "vesselRetainedSampleSeal": "string",
  • "marpolSampleCounterSealNo": "string",
  • "marpolSampleSealNo": "string",
  • "cargoOfficerNameEnd": "string",
  • "signatureOfCargoOfficerEnd": "string",
  • "bunkerTanker''SStamp": "string",
  • "chiefEngineerNameEnd": "string",
  • "signatureOfMasterChiefEngineerEnd": "string",
  • "ChiefEngineerDateTimeEnd": "string",
  • "vesselStamp": "string",
  • "remarks": "string",
  • "customerRating": "string",
  • "sdsCopyReceived": true,
  • "protestNote": true,
  • "attachments": [
    ]
}

Bunker Delivery Report (B2G)

Data Element ID: bunker_delivery_report

vendorUen
required
string (Vendor UEN)

:Unique Entity Number (UEN) of the vendor registered with ACRA. Mandatory if interface is via Service Agent
:Vendor UEN
:Unique Entity Number (UEN) of the vendor registered with ACRA. Mandatory if interface is via Service Agent
:NA
:Min character = 1, max characters = 12
Alphanumeric

bunkerTankerLicenceNo
required
string (Bunker Tanker Licence Number)

:Bunker barge licence number in "SB NNNNA" format from MFM
:Bunker Tanker Licence Number
:Bunker barge licence number in "SB NNNNA" format from MFM
:NA
:Min character = 1, max characters = 8
Alphanumeric. First 3 characters = "SB"

bunkerTankerName
required
string (Bunker Tanker Name)

:Bunker barge name returned from the Bunker Barge Information API
:Bunker Tanker Name
:Bunker barge name returned from the Bunker Barge Information API
:NA
:Min character = 1, max characters = 35
Alphanumeric

bunkerMeteringTicketNo
string or null (Bunker Metering Ticket Number)

:Bunker metering ticket number from the MFM. Mandatory if the delivery type is "1"
:Bunker Metering Ticket Number
:Bunker metering ticket number from the MFM. Mandatory if the delivery type is "1"
:NA
:Min character = 1, max characters = 20
Alphanumeric

bunkerSupplierName
required
string (Bunker Supplier Name)

:Bunker Supplier Company name
:Bunker Supplier Name
:Bunker Supplier Company name
:NA
:Min character = 1, max characters = 150
Alphanumeric

bunkerSupplierUEN
required
string (Bunker Supplier UEN)

:Bunker Supplier UEN supplier
:Bunker Supplier UEN
:Bunker Supplier UEN supplier
:NA
:Min character = 1, max characters = 12
Alphanumeric

bdnNo
required
string (Bunker Delivery Note Number)

:Bunker Supplier BDN No
:Bunker Delivery Note Number
:Bunker Supplier BDN No
:NA
:Min character = 1, max characters = 20
Alphanumeric

receiveVesselName
required
string (Receiving Vessel Name)

:Receiving Vessel Name returned from the Receiving Vessel Information API
:Receiving Vessel Name
:Receiving Vessel Name returned from the Receiving Vessel Information API
:NA
:Min character = 1, max characters = 35
Alphanumeric

receiveVesselImoNo
string or null (Receiving Vessel IMO Number)

:Based on receiving Vessel IMO Number returned from the Receiving Vessel Information API
:Receiving Vessel IMO Number
:Based on receiving Vessel IMO Number returned from the Receiving Vessel Information API
:NA
:Min character = 1, max characters = 10
Alphanumeric

receiveVesselHarbourcraftNo
string or null (Receiving Vessel Harbourcraft License Number)

:Based on receiving Vessel Harbourcraft licence number returned from the Receiving Vessel Information API in format "SB NNNNA"
:Receiving Vessel Harbourcraft License Number
:Based on receiving Vessel Harbourcraft licence number returned from the Receiving Vessel Information API in format "SB NNNNA"
:NA
:Min character = 1, max characters = 8
Alphanumeric

receiveVesselGst
required
number <double> (Receiving Vessel GST)

:Receiving vessel GST returned from the Receiving Vessel Information API
:Receiving Vessel GST
:Receiving vessel GST returned from the Receiving Vessel Information API
:NA
:1-8 digits to the left of decimal place and 0-2 digits to the right of decimal place

deliveryLocationCode
required
string (Delivery Location Code)

:Delivery location code from Bunker Location Data API
:Delivery Location Code
:Delivery location code from Bunker Location Data API
:NA
:Min character = 1, max characters = 5
Alphanumeric

deliveryLocationName
required
string (Delivery Location Name)

:Delivery location name from Bunker Location Data API
:Delivery Location Name
:Delivery location name from Bunker Location Data API
:NA
:Min character = 1, max characters = 50
Alphanumeric

deliveryType
required
number <double> (Delivery Type (SS648 or SS600))

:Value "1" for SS648 delivery and "2" for SS600 delivery
:Delivery Type (SS648 or SS600)
:Value "1" for SS648 delivery and "2" for SS600 delivery
:NA
:Min character = 1, Max characters = 1
Value = "1" or "2"

supplyType
required
string (Supply Type)

:"I" for international delivery and "D" for domestic delivery.
:Supply Type
:"I" for international delivery and "D" for domestic delivery.
:NA
:Min character = 1, Max characters = 1
Value = "I" or "D"

fuelTypeCode
required
string (Fuel Type Code)

:Delivery fuel type code from Bunker Fuel Type API
:Fuel Type Code
:Delivery fuel type code from Bunker Fuel Type API
:NA
:Min character = 1, max characters = 10
Alphanumeric

startDeliveryMeterTotaliser
number or null <double> (Start Delivery Meter Totaliser)

:Start of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the delivery type is "1"
:Start Delivery Meter Totaliser
:Start of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the delivery type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

startLoadingMeterTotaliser
number or null <double> (Start Loading Meter Totaliser)

:Start of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the delivery type is "1"
:Start Loading Meter Totaliser
:Start of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the delivery type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

endDeliveryMeterTotaliser
number or null <double> (End Delivery Meter Totaliser)

:End of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the delivery type is "1"
:End Delivery Meter Totaliser
:End of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the delivery type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

endLoadingMeterTotaliser
number or null <double> (End Loading Meter Totaliser)

:End of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the delivery type is "1"
:End Loading Meter Totaliser
:End of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the delivery type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

suppliedQuantityMFM
number or null <double> (Supplied Quantity from MFM)

:Supplied quantity from MFM up to 4 decimal places
:Supplied Quantity from MFM
:Supplied quantity from MFM up to 4 decimal places
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

suppliedQuantityBDN
required
number <double> (Supplied Quantity from BDN)

:Supplied quantity as per BDN, calculated based on the formula
:Supplied Quantity from BDN
:Supplied quantity as per BDN, calculated based on the formula
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

operationDate
required
string <date> (Operation Date)

:Date of operation in "YYYY-MM-DD" format from MFM
:Operation Date
:Date of operation in "YYYY-MM-DD" format from MFM
:NA
:date (YYYY-MM-DD)

commencePumpingTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Commence Pumping Time)

:Bunker barge commence pumping date time in format of "YYYY-MM-DD HH:mm:ss" from MFM
:Commence Pumping Time
:Bunker barge commence pumping date time in format of "YYYY-MM-DD HH:mm:ss" from MFM
:NA
:Date-time format "YYYY-MM-DD HH:mm:ss"

completePumpingTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Complete Pumping Time)

:Bunker barge complete pumping date time in format of "YYYY-MM-DD HH:mm:ss" from MFM
:Complete Pumping Time
:Bunker barge complete pumping date time in format of "YYYY-MM-DD HH:mm:ss" from MFM
:NA
:Date-time format "YYYY-MM-DD HH:mm:ss"

alongsideTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Alongside Time)

:Bunker barge alongside date time in format of "YYYY-MM-DD HH:mm:ss"
:Alongside Time
:Bunker barge alongside date time in format of "YYYY-MM-DD HH:mm:ss"
:NA
:Date-time format "YYYY-MM-DD HH:mm:ss"

castOffTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Castoff Time)

:Bunker barge castoff date time in format of "YYYY-MM-DD HH:mm:ss"
:Castoff Time
:Bunker barge castoff date time in format of "YYYY-MM-DD HH:mm:ss"
:NA
:Date-time format "YYYY-MM-DD HH:mm:ss"

durationOfDelivery
required
string (Duration of Delivery (HH:mm:ss))

:Duration between commencePumping and completePumping in format of "HH:mm:ss"
:Duration of Delivery (HH:mm:ss)
:Duration between commencePumping and completePumping in format of "HH:mm:ss"
:NA
:Duration in format of HH:mm:ss

customerRating
integer or null <int64> (Customer Rating)

:Customer Rating:
1 (very unsatisfied) to 5 (very satisfied).
Mandatory for international supply.
:Customer Rating
:Customer Rating:
1 (very unsatisfied) to 5 (very satisfied).
Mandatory for international supply.
:NA
:Min character = 1, Max characters = 1
Value = "1", "2", "3", "4", "5"

protestNote
string or null (Protest Note)

:Protest Note issue in value "Y" for yes and "N" for no
:Protest Note
:Protest Note issue in value "Y" for yes and "N" for no
:NA
:Min character = 1, Max characters = 1
Value = "Y" or "N"

totalisersAutoPopulated
required
string (Totalisers Auto Populated)

:Whether all 4 totaliser readings and suppliedQuantityMFM were automatically populated from the MFM system or via meter ticket using OCR. "Y" for yes and "N" for no
:Totalisers Auto Populated
:Whether all 4 totaliser readings and suppliedQuantityMFM were automatically populated from the MFM system or via meter ticket using OCR. "Y" for yes and "N" for no
:NA
:Min character = 1, Max characters = 1
Value = "Y" or "N"

reasonNotAutoPopulated
string or null (Reason for totaliser not auto populated)

:To provide reason below if "N" for totaliserAutoPopulated, i.e.:
Function not implemented
Network issue
Data inconsistency
others
:Reason for totaliser not auto populated
:To provide reason below if "N" for totaliserAutoPopulated, i.e.:
Function not implemented
Network issue
Data inconsistency
others
:NA
:Min character = 1, max characters = 100
Alphanumeric

required
Array of objects (Bunker Delivery Note Attachment) non-empty

:Attachment version of Release Consent
:Bunker Delivery Note Attachment
:Attachment version of Release Consent
:NA
:NA

{
  • "vendorUen": "string",
  • "bunkerTankerLicenceNo": "string",
  • "bunkerTankerName": "string",
  • "bunkerMeteringTicketNo": "string",
  • "bunkerSupplierName": "string",
  • "bunkerSupplierUEN": "string",
  • "bdnNo": "string",
  • "receiveVesselName": "string",
  • "receiveVesselImoNo": "string",
  • "receiveVesselHarbourcraftNo": "string",
  • "receiveVesselGst": 0.1,
  • "deliveryLocationCode": "string",
  • "deliveryLocationName": "string",
  • "deliveryType": 0.1,
  • "supplyType": "string",
  • "fuelTypeCode": "string",
  • "startDeliveryMeterTotaliser": 0.1,
  • "startLoadingMeterTotaliser": 0.1,
  • "endDeliveryMeterTotaliser": 0.1,
  • "endLoadingMeterTotaliser": 0.1,
  • "suppliedQuantityMFM": 0.1,
  • "suppliedQuantityBDN": 0.1,
  • "operationDate": "2019-08-24",
  • "commencePumpingTime": "2023-01-01 13:00:00",
  • "completePumpingTime": "2023-01-01 13:00:00",
  • "alongsideTime": "2023-01-01 13:00:00",
  • "castOffTime": "2023-01-01 13:00:00",
  • "durationOfDelivery": "string",
  • "customerRating": 0,
  • "protestNote": "string",
  • "totalisersAutoPopulated": "string",
  • "reasonNotAutoPopulated": "string",
  • "attachments": [
    ]
}

Bunker Loading Report (B2G)

Data Element ID: bunker_loading_report

vendorUen
required
string (Vendor UEN)

:Unique Entity Number (UEN) of the vendor registered with ACRA. Mandatory if interface is via Service Agent
:Vendor UEN
:Unique Entity Number (UEN) of the vendor registered with ACRA. Mandatory if interface is via Service Agent
:NA
:Min character = 1, max characters = 12
Alphanumeric

bunkerTankerLicenceNo
required
string (Bunker Tanker Licence Number)

:Bunker barge licence number in "SB NNNNA" format from MFM
:Bunker Tanker Licence Number
:Bunker barge licence number in "SB NNNNA" format from MFM
:NA
:Min character = 1, max characters = 8
Alphanumeric. First 3 characters = "SB"

bunkerTankerName
required
string (Bunker Tanker Name)

:Bunker barge name returned from the Bunker Barge Information API
:Bunker Tanker Name
:Bunker barge name returned from the Bunker Barge Information API
:NA
:Min character = 1, max characters = 35
Alphanumeric

bunkerMeteringTicketNo
string or null (Bunker Metering Ticket Number)

:Bunker metering ticket number from the MFM. Mandatory if the load type is "1"
:Bunker Metering Ticket Number
:Bunker metering ticket number from the MFM. Mandatory if the load type is "1"
:NA
:Min character = 1, max characters = 20
Alphanumeric

loadNo
required
string (Load No)

:CQ No or Bill of Lading No
:Load No
:CQ No or Bill of Lading No
:NA
:Min character = 1, max characters = 20
Alphanumeric

terminalOplCode
required
string (Terminal Opl Code)

:Terminal location code from Bunker Location Data API
:Terminal Opl Code
:Terminal location code from Bunker Location Data API
:NA
:Min character = 1, max characters = 5
Alphanumeric

terminalOplName
required
string (Terminal Opl Name)

:Terminal location name from Bunker Location Data API
:Terminal Opl Name
:Terminal location name from Bunker Location Data API
:NA
:Min character = 1, max characters = 50
Alphanumeric

loadType
required
number (Load Type)

:Value "1" when MFM fields can be provided and "2" when MFM fields cannot be provided.
:Load Type
:Value "1" when MFM fields can be provided and "2" when MFM fields cannot be provided.
:NA
:Min character = 1, Max characters = 1
Value = "1", "2"

fuelTypeCode
required
string (Fuel Type Code)

:Delivery fuel type code from Bunker Fuel Type API
:Fuel Type Code
:Delivery fuel type code from Bunker Fuel Type API
:NA
:Min character = 1, max characters = 10
Alphanumeric

terminalLoadQuantity
required
number <double> (Terminal Load Quantity)

:Load quantity (mass in air), with up to 4 decimal places, based on CQ/BL as provided by the terminal.
:Terminal Load Quantity
:Load quantity (mass in air), with up to 4 decimal places, based on CQ/BL as provided by the terminal.
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

startDeliveryMeterTotaliser
number or null <double> (Start Delivery Meter Totaliser)

:Start of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the load type is "1"
:Start Delivery Meter Totaliser
:Start of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the load type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

startLoadingMeterTotaliser
number or null <double> (Start Loading Meter Totaliser)

:Start of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the load type is "1"
:Start Loading Meter Totaliser
:Start of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the load type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

endDeliveryMeterTotaliser
number or null <double> (End Delivery Meter Totaliser)

:End of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the load type is "1"
:End Delivery Meter Totaliser
:End of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the load type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

endLoadingMeterTotaliser
number or null <double> (End Loading Meter Totaliser)

:End of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the load type is "1"
:End Loading Meter Totaliser
:End of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the load type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

bmtLoadQuantity
required
number <double> (BMT Load Quantity)

:Load quantity with up to 4 decimal places, based on bunker metering ticket.
:BMT Load Quantity
:Load quantity with up to 4 decimal places, based on bunker metering ticket.
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

operationDate
required
string <date> (Operation Date)

:Date of operation in "YYYY-MM-DD" format
:Operation Date
:Date of operation in "YYYY-MM-DD" format
:NA
:date (YYYY-MM-DD)

berthingTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Berthing Time)

:Bunker barge berthing date time in format of "YYYY-MM-DD HH:mm:ss"
:Berthing Time
:Bunker barge berthing date time in format of "YYYY-MM-DD HH:mm:ss"
:NA
:Date-time format "YYYY-MM-DD HH:mm:ss"

loadingTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Loading Time)

:Bunker barge loading date time from the MFM in format of "YYYY-MM-DD HH:mm:ss"
:Loading Time
:Bunker barge loading date time from the MFM in format of "YYYY-MM-DD HH:mm:ss"
:NA
:Date-time format "YYYY-MM-DD HH:mm:ss"

completionTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Completion Time)

:Bunker barge completion date time from the MFM in format of "YYYY-MM-DD HH:mm:ss"
:Completion Time
:Bunker barge completion date time from the MFM in format of "YYYY-MM-DD HH:mm:ss"
:NA
:Date-time format "YYYY-MM-DD HH:mm:ss"

departureTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Departure Time)

:Bunker barge departure date time in format of "YYYY-MM-DD HH:mm:ss"
:Departure Time
:Bunker barge departure date time in format of "YYYY-MM-DD HH:mm:ss"
:NA
:Date-time format "YYYY-MM-DD HH:mm:ss"

durationAlongsideBerth
required
string (Duration Alongside Berth)

:Duration between Departure Time and Berthing Time in format of "HH:mm:ss"
:Duration Alongside Berth
:Duration between Departure Time and Berthing Time in format of "HH:mm:ss"
:NA
:Duration in format of HH:mm:ss

totalisersAutoPopulated
required
string (Totalisers Auto Populated)

:Whether all 4 totaliser readings and load quantity were automatically pre- populated from the MFM system or via the meter ticket using OCR. "Y" for yes and "N" for no
:Totalisers Auto Populated
:Whether all 4 totaliser readings and load quantity were automatically pre- populated from the MFM system or via the meter ticket using OCR. "Y" for yes and "N" for no
:NA
:Min character = 1, Max characters = 1
Value = "Y" or "N"

reasonNotAutoPopulated
string or null (Reason Not Auto Populated)

:To provide reason below if "N" for totaliserAutoPopulated, i.e.:
Function not implemented
Network issue
Data inconsistency
Others
:Reason Not Auto Populated
:To provide reason below if "N" for totaliserAutoPopulated, i.e.:
Function not implemented
Network issue
Data inconsistency
Others
:NA
:Min character = 1, max characters = 100
Alphanumeric

Array of objects (Bunker Loading Attachment) non-empty

:Attachment version of Release Consent
:Bunker Loading Attachment
:Attachment version of Release Consent
:NA
:NA

{
  • "vendorUen": "string",
  • "bunkerTankerLicenceNo": "string",
  • "bunkerTankerName": "string",
  • "bunkerMeteringTicketNo": "string",
  • "loadNo": "string",
  • "terminalOplCode": "string",
  • "terminalOplName": "string",
  • "loadType": 0,
  • "fuelTypeCode": "string",
  • "terminalLoadQuantity": 0.1,
  • "startDeliveryMeterTotaliser": 0.1,
  • "startLoadingMeterTotaliser": 0.1,
  • "endDeliveryMeterTotaliser": 0.1,
  • "endLoadingMeterTotaliser": 0.1,
  • "bmtLoadQuantity": 0.1,
  • "operationDate": "2019-08-24",
  • "berthingTime": "2023-01-01 13:00:00",
  • "loadingTime": "2023-01-01 13:00:00",
  • "completionTime": "2023-01-01 13:00:00",
  • "departureTime": "2023-01-01 13:00:00",
  • "durationAlongsideBerth": "string",
  • "totalisersAutoPopulated": "string",
  • "reasonNotAutoPopulated": "string",
  • "attachments": [
    ]
}

Bunker Quantity Survey

Data Element ID: bunker_quantity_survey

bqs_dt
required
string <date> (Bqs Dt)

:Date the survey is being conducted
:Survey/ Execution Date
:Date the survey is being conducted
:NA
:ISO Date Format (YYYY-MM-DD)

bqs_rp_dt
string or null <date> (Bqs Rp Dt)

:Date of the report being populated
:Report Date
:Date of the report being populated
:NA
:ISO Date Format (YYYY-MM-DD)

bqs_job_no
required
string (Bqs Job No)

:Unique report/ job number for the survey
:Report/Job Number
:Unique report/ job number for the survey
:NA
:NA

bqs_client_nm
required
string (Bqs Client Nm)

:Client of the surveyor
:Client
:Client of the surveyor
:NA
:NA

bqs_client_rf_no
string or null (Bqs Client Rf No)

:Client Reference Number
:Client Reference Number
:Client Reference Number
:NA
:NA

bqs_surveyor_company_nm
required
string (Bqs Surveyor Company Nm)

:Surveyor Company Name
:Surveyor Company Name
:Surveyor Company Name
:NA
:ISO 17025

bqs_vessel
required
string (Bqs Vessel)

:Vessel Name
:Vessel Name
:Vessel Name
:NA
:Alphanumeric Characters Only

bqs_total_hrs
string or null (Bqs Total Hrs)

:Total Hours (Accounts)
:Total Hours (Accounts)
:Total Hours (Accounts)
:NA
:NA

bqs_chief_engineer
string or null (Bqs Chief Engineer)

:Chief Engineer
:Chief Engineer
:Chief Engineer
:NA
:NA

bqs_capt
string or null (Bqs Capt)

:Captain
:Captain
:Captain
:NA
:NA

bqs_po_no
string or null (Bqs Po No)

:Order Number/Purchase Order Number
:Order Number/Purchase Order Number
:Order Number/Purchase Order Number
:NA
:NA

bqs_attending_surveyor
required
string (Bqs Attending Surveyor)

:Attending Surveyor
:Attending Surveyor
:Attending Surveyor
:NA
:NA

bqs_surveyor_license_no
string or null (Bqs Surveyor License No)

:Surveyor License Number
:Surveyor License Number
:Surveyor License Number
:NA
:NA

required
Array of objects (Bqs Results)

:Results
:Results
:Results
:NA
:NA

Array of objects or null (Bqs Logbook Comparison)

:Logbook Comparison
:Logbook Comparison
:Logbook Comparison
:NA
:NA

required
Array of objects (Attachments)

:Bunker Quantity Survey Attachment
:Bunker Quantity Survey Attachment
:Bunker Quantity Survey Attachment
:NA
:.PDF format

bqs_svy_comment
string or null (Bqs Svy Comment)

:Survey Comment (s)
:Survey Comment (s)
:Survey Comment (s)
:NA
:NA

bqs_terms_and_condition_and_other_text
string or null (Bqs Terms And Condition And Other Text)

:Terms and Conditions and any other Text
:Terms and Conditions and any other Text
:Terms and Conditions and any other Text
:NA
:NA

{
  • "bqs_dt": "2019-08-24",
  • "bqs_rp_dt": "2019-08-24",
  • "bqs_job_no": "string",
  • "bqs_client_nm": "string",
  • "bqs_client_rf_no": "string",
  • "bqs_surveyor_company_nm": "string",
  • "bqs_vessel": "string",
  • "bqs_total_hrs": "string",
  • "bqs_chief_engineer": "string",
  • "bqs_capt": "string",
  • "bqs_po_no": "string",
  • "bqs_attending_surveyor": "string",
  • "bqs_surveyor_license_no": "string",
  • "bqs_results": [
    ],
  • "bqs_logbook_comparison": [
    ],
  • "attachments": [
    ],
  • "bqs_svy_comment": "string",
  • "bqs_terms_and_condition_and_other_text": "string"
}

Bunker STS Delivery Report (B2G)

Data Element ID: bunker_sts_delivery_report

vendorUen
required
string (Vendor UEN)

:Unique Entity Number (UEN) of the vendor registered with ACRA. Mandatory if interface is via Service Agent
:Vendor UEN
:Unique Entity Number (UEN) of the vendor registered with ACRA. Mandatory if interface is via Service Agent
:NA
:Min character = 1, max characters = 12
Alphanumeric

bunkerTankerLicenceNo
required
string (Bunker Tanker Licence Number)

:Bunker barge licence number in "SB NNNNA" format from the MFM
:Bunker Tanker Licence Number
:Bunker barge licence number in "SB NNNNA" format from the MFM
:NA
:Min character = 1, max characters = 8
Alphanumeric. First 3 characters = "SB"

bunkerTankerName
required
string (Bunker Tanker Name)

:Bunker barge name returned from the Bunker Barge Information API
:Bunker Tanker Name
:Bunker barge name returned from the Bunker Barge Information API
:NA
:Min character = 1, max characters = 35
Alphanumeric

bunkerMeteringTicketNo
string or null (Bunker Metering Ticket Number)

:Bunker metering ticket number from the MFM. Mandatory if the transfer type is "1"
:Bunker Metering Ticket Number
:Bunker metering ticket number from the MFM. Mandatory if the transfer type is "1"
:NA
:Min character = 1, max characters = 20
Alphanumeric

receiveBunkerTankerLicenceNo
required
string (Receiving Bunker Tanker License Number)

:Receiving Bunker barge licence number in "SB NNNNA" format from the Bunker Barge Information API
:Receiving Bunker Tanker License Number
:Receiving Bunker barge licence number in "SB NNNNA" format from the Bunker Barge Information API
:NA
:Min character = 1, max characters = 8
Alphanumeric. First 3 characters = "SB"

deliveryLocationCode
required
string (Delivery Location Code)

:Delivery location code from Bunker Location Data API
:Delivery Location Code
:Delivery location code from Bunker Location Data API
:NA
:Min character = 1, max characters = 5
Alphanumeric

deliveryLocationName
required
string (Delivery Location Name)

:Delivery location name from Bunker Location Data API
:Delivery Location Name
:Delivery location name from Bunker Location Data API
:NA
:Min character = 1, max characters = 50
Alphanumeric

transferType
required
number (Transfer Type)

:Value "1" when MFM fields can be provided and "2" when MFM fields cannot be provided.
:Transfer Type
:Value "1" when MFM fields can be provided and "2" when MFM fields cannot be provided.
:NA
:Min character = 1, Max characters = 1
Value = "1", "2"

fuelTypeCode
required
string (Fuel Type Code)

:Delivery fuel type code from Bunker Fuel Type API
:Fuel Type Code
:Delivery fuel type code from Bunker Fuel Type API
:NA
:Min character = 1, max characters = 10
Alphanumeric

startDeliveryMeterTotaliser
number or null <double> (Start Delivery Meter Totaliser)

:Start of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the transfer type is "1"
:Start Delivery Meter Totaliser
:Start of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the transfer type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

startLoadingMeterTotaliser
number or null <double> (Start Loading Meter Totaliser)

:Start of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the transfer type is "1"
:Start Loading Meter Totaliser
:Start of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the transfer type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

endDeliveryMeterTotaliser
number or null <double> (End Delivery Meter Totaliser)

:End of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the transfer type is "1"
:End Delivery Meter Totaliser
:End of delivery – delivery meter totaliser reading up to 4 decimal places from MFM. Mandatory if the transfer type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

endLoadingMeterTotaliser
number or null <double> (End Loading Meter Totaliser)

:End of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the transfer type is "1"
:End Loading Meter Totaliser
:End of delivery – loading meter totaliser reading up to 4 decimal places from MFM. Mandatory if the transfer type is "1"
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

transferredQuantity
required
number <double> (Transferred Quantity)

:Transferred quantity with 4 decimal place, as per BDN
:Transferred Quantity
:Transferred quantity with 4 decimal place, as per BDN
:NA
:1-4 digits to the left of decimal place and 0-4 digits to the right of decimal place

operationDate
required
string <date> (Operation Date)

:Date of operation in "YYYY-MM-DD" format
:Operation Date
:Date of operation in "YYYY-MM-DD" format
:NA
:date (YYYY-MM-DD)

alongsideTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Alongside Date/Time)

:Receiving Bunker barge alongside date time in format of "YYYY-MM-DD HH:mm:ss"
:Alongside Date/Time
:Receiving Bunker barge alongside date time in format of "YYYY-MM-DD HH:mm:ss"
:ISO8601
:Date-time format "YYYY-MM-DD HH:mm:ss"

loadingTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Loading Date/Time)

:Bunker barge loading date time from the MFM in format of "YYYY-MM-DD HH:mm:ss"
:Loading Date/Time
:Bunker barge loading date time from the MFM in format of "YYYY-MM-DD HH:mm:ss"
:ISO8601
:Date-time format "YYYY-MM-DD HH:mm:ss"

completionTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Completion Date/Time)

:Bunker barge completion date time from the MFM in format of "YYYY-MM-DD HH:mm:ss"
:Completion Date/Time
:Bunker barge completion date time from the MFM in format of "YYYY-MM-DD HH:mm:ss"
:ISO8601
:Date-time format "YYYY-MM-DD HH:mm:ss"

departureTime
required
string <custom:date-time:YYYY-MM-DD HH:mm:ss> (Departure Date/Time)

:Bunker barge departure date time in format of "YYYY-MM-DD HH:mm:ss"
:Departure Date/Time
:Bunker barge departure date time in format of "YYYY-MM-DD HH:mm:ss"
:ISO8601
:Date-time format "YYYY-MM-DD HH:mm:ss"

durationAlongside
required
string (Duration Alongside)

:Duration between alongsideTime and departureTime in format of "HH:mm:ss"
:Duration Alongside
:Duration between alongsideTime and departureTime in format of "HH:mm:ss"
:NA
:Duration in format of HH:mm:ss

totalisersAutoPopulated
required
string (Totalisers Auto Populated)

:Whether all 4 totaliser readings and transferred quantity were automatically pre-populated from the MFM system or via the meter ticket using OCR. "Y" for yes and "N" for no
:Totalisers Auto Populated
:Whether all 4 totaliser readings and transferred quantity were automatically pre-populated from the MFM system or via the meter ticket using OCR. "Y" for yes and "N" for no
:NA
:Min character = 1, Max characters = 1
Value = "Y" or "N"

reasonNotAutoPopulated
string or null (Reason Not Auto Populated)

:To provide reason below if "N" for totaliserAutoPopulated, , i.e.:
Function not implemented
Network issue
Data inconsistency
Others
:Reason Not Auto Populated
:To provide reason below if "N" for totaliserAutoPopulated, , i.e.:
Function not implemented
Network issue
Data inconsistency
Others
:NA
:Min character = 1, max characters = 100
Alphanumeric

Array of objects or null (Bunker Delivery Note Attachment) non-empty

:Attachment version of Release Consent
:Bunker Delivery Note Attachment
:Attachment version of Release Consent
:NA
:NA

{
  • "vendorUen": "string",
  • "bunkerTankerLicenceNo": "string",
  • "bunkerTankerName": "string",
  • "bunkerMeteringTicketNo": "string",
  • "receiveBunkerTankerLicenceNo": "string",
  • "deliveryLocationCode": "string",
  • "deliveryLocationName": "string",
  • "transferType": 0,
  • "fuelTypeCode": "string",
  • "startDeliveryMeterTotaliser": 0.1,
  • "startLoadingMeterTotaliser": 0.1,
  • "endDeliveryMeterTotaliser": 0.1,
  • "endLoadingMeterTotaliser": 0.1,
  • "transferredQuantity": 0.1,
  • "operationDate": "2019-08-24",
  • "alongsideTime": "2023-01-01 13:00:00",
  • "loadingTime": "2023-01-01 13:00:00",
  • "completionTime": "2023-01-01 13:00:00",
  • "departureTime": "2023-01-01 13:00:00",
  • "durationAlongside": "string",
  • "totalisersAutoPopulated": "string",
  • "reasonNotAutoPopulated": "string",
  • "attachments": [
    ]
}

Bunkering Sales Confirmation

Data Element ID: bunkering_sales_confirmation

bsc_vessel_nm
required
string (Bsc Vessel Nm)

:Vessel Name
:Vessel Name
:Vessel Name
:NA
:NA

bsc_confirmation_no
required
string (Bsc Confirmation No)

:Bunkering Sales Confirmation Number
:Bunkering Sales Confirmation Number
:Bunkering Sales Confirmation Number
:NA
:NA

bsc_contract_ref
string or null (Bsc Contract Ref)

:Contract Reference
:Contract Reference
:Contract Reference
:NA
:NA

bsc_imo_no
number or null (Bsc Imo No)

:International Maritime Organization (IMO) Number
:International Maritime Organisation Number
:International Maritime Organisation (IMO) Vessel Identification Number Note: This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

bsc_buyer_nm
required
string (Bsc Buyer Nm)

:Buyer Name
:Buyer Name
:Buyer Name
:NA
:NA

bsc_buyer_address
string or null (Bsc Buyer Address)

:Buyer Address
:Buyer Address
:Buyer Address
:NA
:NA

bsc_seller_nm
required
string (Bsc Seller Nm)

:Seller Name
:Seller Name
:Seller Name
:NA
:NA

bsc_seller_address
string or null (Bsc Seller Address)

:Seller Address
:Seller Address
:Seller Address
:NA
:NA

bsc_physical_supplier
string or null (Bsc Physical Supplier)

:Physical Supplier's Name
:Physical Supplier's Name
:Physical Supplier's Name
:NA
:NA

bsc_port
required
string (Bsc Port)

:Port Name
:Port Name
:Port Name
:NA
:NA

bsc_supply_dt_from
required
string <date> (Bsc Supply Dt From)

:Estimated Time of Arrival (from)
:Estimated Time of Arrival (from)
:Estimated Time of Arrival (from)
:NA
:ISO Date Format (DD-MM-YYYY)

bsc_supply_dt_to
string or null <date> (Bsc Supply Dt To)

:Estimated Time of Arrival (to)
:Estimated Time of Arrival (to)
:Estimated Time of Arrival (to)
:NA
:ISO Date Format (DD-MM-YYYY)

bsc_agent
string or null (Bsc Agent)

:Ship Agent Details
:Ship Agent Details
:Ship Agent Details
:NA
:NA

bsc_surveyor
string or null (Bsc Surveyor)

:Surveyor Name
:Surveyor Name
:Surveyor Name
:NA
:NA

bsc_op_notes
string or null (Bsc Op Notes)

:Additional Notes
:Additional Notes
:Additional Notes
:NA
:NA

required
Array of objects (Bsc Grade Quantities)

:Goods Particulars
:Grades and Quantities
:Goods Particulars
:NA
:NA

bsc_qty_notes
string or null (Bsc Qty Notes)

:Additional Notes on Quantity
:Additional Notes on Quantity
:Additional Notes on Quantity
:NA
:NA

bsc_barging_fee
required
number (Bsc Barging Fee)

:Barging Fee
:Barging Fee
:Barging Fee
:NA
:NA

bsc_payment_terms
required
string (Bsc Payment Terms)

:Payment Terms
:Payment Terms
:Payment Terms
:NA
:NA

bsc_stem_dt
string or null <date> (Bsc Stem Dt)

:Date of Confirmation
:Date of Confirmation
:Date of Confirmation
:NA
:ISO Date Format (DD-MM-YYYY)

bsc_contact
string or null (Bsc Contact)

:Contact Information of Seller
:Contact Information of Seller
:Contact Information of Seller
:NA
:NA

bsc_buyer_terms_conditions
string or null (Bsc Buyer Terms Conditions)

:Buyer Terms and Conditions
:Buyer Terms and Conditions
:Buyer Terms and Conditions
:NA
:NA

bsc_assignment_clause
string or null (Bsc Assignment Clause)

:Assignment Clause
:Assignment Clause
:Assignment Clause
:NA
:NA

bsc_sanctioned_countries_clause
string or null (Bsc Sanctioned Countries Clause)

:Sanctioned Countries Clause
:Sanctioned Countries Clause
:Sanctioned Countries Clause
:NA
:NA

bsc_antibribery_corruption_clause
string or null (Bsc Antibribery Corruption Clause)

:Anti-Bribery and Corruption Clause
:Anti-Bribery and Corruption Clause
:Anti-Bribery and Corruption Clause
:NA
:NA

bsc_tax_tariffs_clause
string or null (Bsc Tax Tariffs Clause)

:Tax and Tariffs Clause
:Tax and Tariffs Clause
:Tax and Tariffs Clause
:NA
:NA

bsc_covid19_clause
string or null (Bsc Covid19 Clause)

:Covid-19
:Covid-19
:Covid-19
:NA
:NA

bsc_others_clause
string or null (Bsc Others Clause)

:Other Provisions Clause
:Other Provisions Clause
:Other Provisions Clause
:NA
:NA

bsc_bimco_bunker_terms
string or null (Bsc Bimco Bunker Terms)

:Bimco Bunker Terms 2018 Elections
:Bimco Bunker Terms 2018 Elections
:Bimco Bunker Terms 2018 Elections
:NA
:NA

bsc_delivery_notice
string or null (Bsc Delivery Notice)

:Delivery Notice
:Delivery Notice
:Delivery Notice
:NA
:NA

bsc_payment_clause
string or null (Bsc Payment Clause)

:Payment Clauses
:Payment Clauses
:Payment Clauses
:NA
:NA

bsc_gst_rate
string or null (Bsc Gst Rate)

:GST Chargeable Rate
:GST Chargeable Rate
:GST Chargeable Rate
:NA
:NA

bsc_commission
number or null (Bsc Commission)

:Commission
:Commission
:Commission
:NA
:NA

bsc_cancellation
string or null (Bsc Cancellation)

:Cancellation Terms
:Cancellation Terms
:Cancellation Terms
:NA
:NA

bsc_confidentiality_statement
string or null (Bsc Confidentiality Statement)

:Confidentiality Statement
:Confidentiality Statement
:Confidentiality Statement
:NA
:NA

bsc_surcharge
string or null (Bsc Surcharge)

:Surcharge
:Surcharge
:Surcharge
:NA
:NA

bsc_delivery_terms
string or null (Bsc Delivery Terms)

:Delivery Terms
:Delivery Terms
:Delivery Terms
:NA
:NA

bsc_delivery_mode
string or null (Bsc Delivery Mode)

:Mode of Delivery
:Mode of Delivery
:Mode of Delivery
:NA
:NA

bsc_delivery_org
string or null (Bsc Delivery Org)

:Name of delivery organization
:Name of delivery organization
:Name of delivery organization
:NA
:NA

Array of objects or null (Attachments) non-empty

:NA
:Bunkering Sales Confirmation Attachment
:Bunkering Sales Confirmation Attachment
:NA
:NA

{
  • "bsc_vessel_nm": "string",
  • "bsc_confirmation_no": "string",
  • "bsc_contract_ref": "string",
  • "bsc_imo_no": 0,
  • "bsc_buyer_nm": "string",
  • "bsc_buyer_address": "string",
  • "bsc_seller_nm": "string",
  • "bsc_seller_address": "string",
  • "bsc_physical_supplier": "string",
  • "bsc_port": "string",
  • "bsc_supply_dt_from": "2019-08-24",
  • "bsc_supply_dt_to": "2019-08-24",
  • "bsc_agent": "string",
  • "bsc_surveyor": "string",
  • "bsc_op_notes": "string",
  • "bsc_grade_quantities": [
    ],
  • "bsc_qty_notes": "string",
  • "bsc_barging_fee": 0,
  • "bsc_payment_terms": "string",
  • "bsc_stem_dt": "2019-08-24",
  • "bsc_contact": "string",
  • "bsc_buyer_terms_conditions": "string",
  • "bsc_assignment_clause": "string",
  • "bsc_sanctioned_countries_clause": "string",
  • "bsc_antibribery_corruption_clause": "string",
  • "bsc_tax_tariffs_clause": "string",
  • "bsc_covid19_clause": "string",
  • "bsc_others_clause": "string",
  • "bsc_bimco_bunker_terms": "string",
  • "bsc_delivery_notice": "string",
  • "bsc_payment_clause": "string",
  • "bsc_gst_rate": "string",
  • "bsc_commission": 0,
  • "bsc_cancellation": "string",
  • "bsc_confidentiality_statement": "string",
  • "bsc_surcharge": "string",
  • "bsc_delivery_terms": "string",
  • "bsc_delivery_mode": "string",
  • "bsc_delivery_org": "string",
  • "attachments": [
    ]
}

Bunkering Sales Contract (Delivered)

Data Element ID: sales_contract_lbs_bunkerbuyer

contract_lbsbb_contract_no
required
string (Contract Lbsbb Contract No)

:Sales Contract Number/ Agreement Number
:Sales Contract Number/Agreement Number (Delivered)
:Sales Contract Number/Agreement Number (Delivered)
:NA
:NA

contract_lbsbb_dt_of_contract
required
string <date> (Contract Lbsbb Dt Of Contract)

:Contract date
:Contract Date
:Contract Date
:NA
:date (YYYY-MM-DD)

contract_lbsbb_seller_name
required
string (Contract Lbsbb Seller Name)

:Seller name
:Seller Name
:Seller Name
:NA
:NA

contract_lbsbb_seller_address
required
string (Contract Lbsbb Seller Address)

:Seller address
:Seller Address
:Seller Address
:NA
:NA

contract_lbsbb_buyer_name
required
string (Contract Lbsbb Buyer Name)

:Buyer name
:Buyer Name
:Buyer Name
:NA
:NA

contract_lbsbb_buyer_address
required
string (Contract Lbsbb Buyer Address)

:Buyer address
:Buyer Address
:Buyer Address
:NA
:NA

contract_lbsbb_ship_agent
string or null (Contract Lbsbb Ship Agent)

:Ship agent details
:Ship Agent Details
:Ship Agent Details
:NA
:NA

contract_lbsbb_credit_terms
required
string (Contract Lbsbb Credit Terms)

:Credit Terms
:Credit Terms
:Credit Terms
:NA
:NA

contract_lbsbb_payment_details
required
string (Contract Lbsbb Payment Details)

:Payment Terms
:Payment Terms
:Payment Terms
:NA
:NA

required
Array of objects (Contract Lbsbb Goods Particulars)

:NA
:Goods Particulars
:Particulars of goods
:NA
:NA

Array of objects or null (Attachments)

:NA
:Bunkering Sales Contract (Delivered) Attachment
:Bunkering Sales Contract (Delivered) Attachment
:NA
:.PDF format

contract_lbsbb_contact_details
required
string (Contract Lbsbb Contact Details)

:Contact details
:Contact Details
:Contact Details
:NA
:NA

contract_lbsbb_vessel_nm
required
string (Contract Lbsbb Vessel Nm)

:Vessel Name
:Vessel Name
:Name of vessel
:NA
:Alphanumeric Characters Only

contract_lbsbb_port
string or null (Contract Lbsbb Port)

:Port
:Port
:Port
:NA
:NA

contract_lbsbb_eta
string or null <date> (Contract Lbsbb Eta)

:Estimated Date of Arrival
:Estimated Date of Arrival
:Estimated Date of Arrival
:NA
:date (YYYY-MM-DD)

contract_lbsbb_etd
string or null <date> (Contract Lbsbb Etd)

:Estimated Date of Departure
:Estimated Date of Departure
:Estimated Date of Departure
:NA
:date (YYYY-MM-DD)

contract_lbsbb_trade_no
string or null (Contract Lbsbb Trade No)

:Trade Number/ Trade ID
:Bunkering Sales Contract (Delivered) Trade Number/Trade ID
:Trade Number/Trade ID of Bunkering Sales Contract (Delivered)
:NA
:NA

{
  • "contract_lbsbb_contract_no": "string",
  • "contract_lbsbb_dt_of_contract": "2019-08-24",
  • "contract_lbsbb_seller_name": "string",
  • "contract_lbsbb_seller_address": "string",
  • "contract_lbsbb_buyer_name": "string",
  • "contract_lbsbb_buyer_address": "string",
  • "contract_lbsbb_ship_agent": "string",
  • "contract_lbsbb_credit_terms": "string",
  • "contract_lbsbb_payment_details": "string",
  • "contract_lbsbb_goods_particulars": [
    ],
  • "attachments": [
    ],
  • "contract_lbsbb_contact_details": "string",
  • "contract_lbsbb_vessel_nm": "string",
  • "contract_lbsbb_port": "string",
  • "contract_lbsbb_eta": "2019-08-24",
  • "contract_lbsbb_etd": "2019-08-24",
  • "contract_lbsbb_trade_no": "string"
}

Bunkering Sales Contract (Ex-Wharf)

Data Element ID: sales_contract_cargotrader_lbs

contract_ctlbs_dt_of_contract
required
string <date> (Contract Ctlbs Dt Of Contract)

:Contract date
:Contract Date
:Contract Date
:NA
:date (YYYY-MM-DD)

contract_ctlbs_contract_no
required
string (Contract Ctlbs Contract No)

:Sales Contract Number/ Agreement Number
:Sales Contract Number/Agreement Number (Ex-Wharf)
:Sales Contract Number/Agreement Number (Ex-Wharf)
:NA
:NA

contract_ctlbs_seller_name
required
string (Contract Ctlbs Seller Name)

:Seller name
:Seller Name
:Seller Name
:NA
:NA

contract_ctlbs_seller_address
required
string (Contract Ctlbs Seller Address)

:Seller address
:Seller Address
:Seller Address
:NA
:NA

contract_ctlbs_buyer_name
required
string (Contract Ctlbs Buyer Name)

:Buyer name
:Buyer Name
:Buyer Name
:NA
:NA

contract_ctlbs_buyer_address
required
string (Contract Ctlbs Buyer Address)

:Buyer address
:Buyer Address
:Buyer Address
:NA
:NA

required
Array of objects (Contract Ctlbs Goods Particulars) non-empty

:NA
:Goods Particulars
:Particulars of goods
:NA
:NA

contract_ctlbs_payment_details
required
string (Contract Ctlbs Payment Details)

:Payment details
:Payment Details
:Payment Details
:NA
:NA

Array of objects or null (Attachments)

:NA
:Bunkering Sales Contract (Ex-Wharf) Attachment
:Bunkering Sales Contract (Ex-Wharf) Attachment
:NA
:.PDF format

contract_ctlbs_determination_of_qty_and_quality_details
string or null (Contract Ctlbs Determination Of Qty And Quality Details)

:Determination of quantity and quality details
:Determination of Quantity and Quality Details
:Determination of Quantity and Quality Details
:NA
:NA

contract_ctlbs_sanctions
string or null (Contract Ctlbs Sanctions)

:Details of sanctions /boycotts
:Details of Sanctions/Boycotts
:Details of Sanctions/Boycotts
:NA
:NA

contract_ctlbs_contract_start
required
string <date> (Contract Ctlbs Contract Start)

:Contract Start Date
:Contract Start Date
:Contract Start Date
:NA
:date (YYYY-MM-DD)

contract_ctlbs_contract_through
string or null <date> (Contract Ctlbs Contract Through)

:Contract Through Date
:Contract Through Date
:Contract Through Date
:NA
:date (YYYY-MM-DD)

contract_ctlbs_trade_no
string or null (Contract Ctlbs Trade No)

:Trade Number/ Trade ID
:Bunkering Sales Contract (Ex-Wharf) Trade Number/Trade ID
:Trade Number/Trade ID of Bunkering Sales Contract (Ex-Wharf)
:NA
:NA

{
  • "contract_ctlbs_dt_of_contract": "2019-08-24",
  • "contract_ctlbs_contract_no": "string",
  • "contract_ctlbs_seller_name": "string",
  • "contract_ctlbs_seller_address": "string",
  • "contract_ctlbs_buyer_name": "string",
  • "contract_ctlbs_buyer_address": "string",
  • "contract_ctlbs_goods_particulars": [
    ],
  • "contract_ctlbs_payment_details": "string",
  • "attachments": [
    ],
  • "contract_ctlbs_determination_of_qty_and_quality_details": "string",
  • "contract_ctlbs_sanctions": "string",
  • "contract_ctlbs_contract_start": "2019-08-24",
  • "contract_ctlbs_contract_through": "2019-08-24",
  • "contract_ctlbs_trade_no": "string"
}

Bunkering Sales Invoice (Delivered)

Data Element ID: sales_invoice_lbs_bunkerbuyer

invoice_lbsbb_invoice_dt
required
string <date> (Invoice Lbsbb Invoice Dt)

:Date of Invoice
:Date of Invoice
:Date of Invoice
:NA
:date (YYYY-MM-DD)

invoice_lbsbb_invoice_no
required
string (Invoice Lbsbb Invoice No)

:Invoice Number
:Invoice Number
:Invoice Number
:NA
:NA

invoice_lbsbb_sales_contract_no
required
string (Invoice Lbsbb Sales Contract No)

:Sales Contract Number/ Agreement Number
:Sales Contract Number/Agreement Number (Delivered)
:Sales Contract Number/Agreement Number (Delivered)
:NA
:NA

invoice_lbsbb_delivered_dt
required
string <date> (Invoice Lbsbb Delivered Dt)

:BDN Date / Delivery Date
:Bunker Delivery Note Date/Delivery Date
:Bunker Delivery Note Date/Delivery Date
:NA
:date (YYYY-MM-DD)

invoice_lbsbb_buyer_nm
required
string (Invoice Lbsbb Buyer Nm)

:Buyer name
:Buyer Name
:Buyer Name
:NA
:NA

invoice_lbsbb_seller_nm
required
string (Invoice Lbsbb Seller Nm)

:Seller name
:Seller Name
:Seller Name
:NA
:NA

invoice_lbsbb_trade_no
string or null (Invoice Lbsbb Trade No)

:Trade Number/ Trade ID
:Trade ID
:Trade Number/Trade ID
:NA
:NA

required
Array of objects (Invoice Lbsbb Goods Particulars)

:NA
:Goods Particulars
:Particulars of goods
:NA
:NA

invoice_lbsbb_invoice_currency
string or null (Invoice Lbsbb Invoice Currency)

:Invoice Document Currency
:Invoice Document Currency
:Invoice Document Currency
:NA
:NA

invoice_lbsbb_invoice_amount
string or null (Invoice Lbsbb Invoice Amount)

:Invoice Document Amount
:Invoice Document Amount
:Invoice Document Amount
:NA
:NA

invoice_lbsbb_payment_terms
string or null (Invoice Lbsbb Payment Terms)

:Payment Terms
:Payment Terms
:Payment Terms
:NA
:NA

invoice_lbsbb_due_dt
required
string <date> (Invoice Lbsbb Due Dt)

:Payment Due Date
:Payment Due Date
:Payment Due Date
:NA
:date (YYYY-MM-DD)

invoice_lbsbb_bdn_no
string or null (Invoice Lbsbb Bdn No)

:BDN Number
:Bunker Delivery Note number
:Bunker Delivery Note Number
:NA
:NA

Array of objects or null (Attachments)

:NA
:Sales Invoice (Delivered) Attachment
:Sales Invoice (Delivered) Attachment
:NA
:.PDF format

invoice_lbsbb_load_port
string or null (Invoice Lbsbb Load Port)

:Load Port
:Load Port
:Load Port
:NA
:NA

invoice_lbsbb_discharge_port
string or null (Invoice Lbsbb Discharge Port)

:Discharge Port
:Discharge Port
:Discharge Port
:NA
:NA

invoice_lbsbb_account_no
required
string (Invoice Lbsbb Account No)

:Bank Account Number Payable
:Bank Account Number Payable
:Bank Account Number Payable
:NA
:NA

invoice_lbsbb_beneficiary_bank
required
string (Invoice Lbsbb Beneficiary Bank)

:Beneficiary Bank Name
:Beneficiary Bank Name
:Name of the beneficiary bank
:NA
:NA

invoice_lbsbb_beneficiary_bank_swift
required
string (Invoice Lbsbb Beneficiary Bank Swift)

:Beneficiary Bank Swift Code
:Beneficiary Bank Swift Code
:Swift code of the beneficiary bank
:NA
:NA

{
  • "invoice_lbsbb_invoice_dt": "2019-08-24",
  • "invoice_lbsbb_invoice_no": "string",
  • "invoice_lbsbb_sales_contract_no": "string",
  • "invoice_lbsbb_delivered_dt": "2019-08-24",
  • "invoice_lbsbb_buyer_nm": "string",
  • "invoice_lbsbb_seller_nm": "string",
  • "invoice_lbsbb_trade_no": "string",
  • "invoice_lbsbb_goods_particulars": [
    ],
  • "invoice_lbsbb_invoice_currency": "string",
  • "invoice_lbsbb_invoice_amount": "string",
  • "invoice_lbsbb_payment_terms": "string",
  • "invoice_lbsbb_due_dt": "2019-08-24",
  • "invoice_lbsbb_bdn_no": "string",
  • "attachments": [
    ],
  • "invoice_lbsbb_load_port": "string",
  • "invoice_lbsbb_discharge_port": "string",
  • "invoice_lbsbb_account_no": "string",
  • "invoice_lbsbb_beneficiary_bank": "string",
  • "invoice_lbsbb_beneficiary_bank_swift": "string"
}

Bunkering Sales Invoice (Ex-Wharf)

Data Element ID: sales_invoice_cargotrader_lbs

invoice_ctlbs_dt_of_invoice
required
string <date> (Invoice Ctlbs Dt Of Invoice)

:Date of Invoice
:Date of Invoice
:Date of Invoice
:NA
:date (YYYY-MM-DD)

invoice_ctlbs_invoice_no
required
string (Invoice Ctlbs Invoice No)

:Invoice Number
:Invoice Number
:Invoice Number
:NA
:NA

invoice_ctlbs_sales_contract_no
required
string (Invoice Ctlbs Sales Contract No)

:Sales Contract Number/ Agreement Number
:Sales Contract Number/Agreement Number (Ex-Wharf)
:Sales Contract Number/Agreement Number (Ex-Wharf)
:NA
:NA

invoice_ctlbs_buyer
required
string (Invoice Ctlbs Buyer)

:Buyer name
:Buyer Name
:Buyer Name
:NA
:NA

invoice_ctlbs_seller
required
string (Invoice Ctlbs Seller)

:Seller name
:Seller Name
:Seller Name
:NA
:NA

invoice_ctlbs_delivered_or_bl_dt
required
string <date> (Invoice Ctlbs Delivered Or Bl Dt)

:Bill of Lading Date / Delivery Date
:Bill of Lading Date/Delivery Date
:Bill of Lading Date/Delivery Date
:NA
:date (YYYY-MM-DD)

required
Array of objects (Invoice Ctlbs Invoice Goods Particulars) non-empty

:NA
:Goods Particulars
:Particulars of goods
:NA
:NA

invoice_ctlbs_invoice_currency
string or null (Invoice Ctlbs Invoice Currency)

:Invoice Document Currency
:Invoice Document Currency
:Invoice Document Currency
:NA
:NA

invoice_ctlbs_invoice_amount
string or null (Invoice Ctlbs Invoice Amount)

:Invoice Document Amount
:Invoice Document Amount
:Invoice Document Amount
:NA
:NA

invoice_ctlbs_payment_terms
required
string (Invoice Ctlbs Payment Terms)

:Payment Terms
:Payment Terms
:Payment Terms
:NA
:NA

invoice_ctlbs_due_dt
required
string <date> (Invoice Ctlbs Due Dt)

:Payment Due Date
:Payment Due Date
:Payment Due Date
:NA
:date (YYYY-MM-DD)

Array of objects or null (Attachments)

:NA
:Sales Invoice (Ex-Wharf) Attachment
:Sales Invoice (Ex-Wharf) Attachment
:NA
:.PDF format

invoice_ctlbs_gst_amount_usd
string or null (Invoice Ctlbs Gst Amount Usd)

:Total GST Price in USD
:Total GST Price in USD
:Total GST Price in USD
:NA
:NA

invoice_ctlbs_total_amount_usd
string or null (Invoice Ctlbs Total Amount Usd)

:Total Amount in USD
:Total Amount in USD
:Total Amount in USD
:NA
:NA

invoice_ctlbs_account_no
required
string (Invoice Ctlbs Account No)

:Account Number
:Account Number
:Account Number
:NA
:NA

invoice_ctlbs_favour_of_bank_nm
string or null (Invoice Ctlbs Favour Of Bank Nm)

:Favour of Bank Name
:Favour of Bank Name
:Favour of Bank Name
:NA
:NA

invoice_ctlbs_intermediary_bank_swift
string or null (Invoice Ctlbs Intermediary Bank Swift)

:Intermediary Bank Swift Number
:Intermediary Bank Swift Number
:Intermediary Bank Swift Number
:NA
:NA

invoice_ctlbs_ref_data
required
string (Invoice Ctlbs Ref Data)

:Reference Data to be included in payment instruction
:Reference Data to be included in payment instruction
:Reference Data to be included in payment instruction
:NA
:NA

invoice_ctlbs_total_amount_sgd
string or null (Invoice Ctlbs Total Amount Sgd)

:Total Amount in SGD
:Total Amount in SGD
:Total Amount in SGD
:NA
:NA

invoice_ctlbs_exchange_rate_sgd_to_usd
string or null (Invoice Ctlbs Exchange Rate Sgd To Usd)

:Exchange rate of SGD to USD
:Exchange Rate of SGD to USD
:Exchange Rate of SGD to USD
:NA
:NA

invoice_ctlbs_seller_vat_no
required
string (Invoice Ctlbs Seller Vat No)

:Seller's VAT Number
:Seller's VAT Number
:Seller's VAT Number
:NA
:NA

invoice_ctlbs_load_port
required
string (Invoice Ctlbs Load Port)

:Load Port Details
:Load Port Details
:Load Port Details
:NA
:NA

invoice_ctlbs_discharge_port
required
string (Invoice Ctlbs Discharge Port)

:Discharge Port Details
:Discharge Port Details
:Discharge Port Details
:NA
:NA

invoice_ctlbs_seller_tax_cd
required
string (Invoice Ctlbs Seller Tax Cd)

:Seller's tax code
:Seller's Tax Code
:Seller's Tax Code
:NA
:NA

invoice_ctlbs_tax_rate
string or null (Invoice Ctlbs Tax Rate)

:Percentage of tax applicable
:Percentage of Tax Applicable
:Percentage of Tax Applicable
:NA
:NA

invoice_ctlbs_beneficiary_nm
string or null (Invoice Ctlbs Beneficiary Nm)

:Beneficiary Name
:Beneficiary Name
:Beneficiary Name
:NA
:NA

invoice_ctlbs_beneficiary_bank
required
string (Invoice Ctlbs Beneficiary Bank)

:Beneficiary Bank
:Beneficiary Bank
:Beneficiary Bank
:NA
:NA

invoice_ctlbs_beneficiary_bank_swift
required
string (Invoice Ctlbs Beneficiary Bank Swift)

:Beneficiary Bank Swift number
:Beneficiary Bank Swift Number
:Beneficiary Bank Swift Number
:NA
:NA

invoice_ctlbs_trade_no
string or null (Invoice Ctlbs Trade No)

:Trade Number/ Trade ID
:Bunkering Sales Invoice (Ex-Wharf) Bunkering Sales Invoice (Ex-Wharf) Trade Number
:Trade Number/Trade ID of Bunkering Sales Invoice (Ex-Wharf)
:NA
:NA

{
  • "invoice_ctlbs_dt_of_invoice": "2019-08-24",
  • "invoice_ctlbs_invoice_no": "string",
  • "invoice_ctlbs_sales_contract_no": "string",
  • "invoice_ctlbs_buyer": "string",
  • "invoice_ctlbs_seller": "string",
  • "invoice_ctlbs_delivered_or_bl_dt": "2019-08-24",
  • "invoice_ctlbs_invoice_goods_particulars": [
    ],
  • "invoice_ctlbs_invoice_currency": "string",
  • "invoice_ctlbs_invoice_amount": "string",
  • "invoice_ctlbs_payment_terms": "string",
  • "invoice_ctlbs_due_dt": "2019-08-24",
  • "attachments": [
    ],
  • "invoice_ctlbs_gst_amount_usd": "string",
  • "invoice_ctlbs_total_amount_usd": "string",
  • "invoice_ctlbs_account_no": "string",
  • "invoice_ctlbs_favour_of_bank_nm": "string",
  • "invoice_ctlbs_intermediary_bank_swift": "string",
  • "invoice_ctlbs_ref_data": "string",
  • "invoice_ctlbs_total_amount_sgd": "string",
  • "invoice_ctlbs_exchange_rate_sgd_to_usd": "string",
  • "invoice_ctlbs_seller_vat_no": "string",
  • "invoice_ctlbs_load_port": "string",
  • "invoice_ctlbs_discharge_port": "string",
  • "invoice_ctlbs_seller_tax_cd": "string",
  • "invoice_ctlbs_tax_rate": "string",
  • "invoice_ctlbs_beneficiary_nm": "string",
  • "invoice_ctlbs_beneficiary_bank": "string",
  • "invoice_ctlbs_beneficiary_bank_swift": "string",
  • "invoice_ctlbs_trade_no": "string"
}

Certificate Of Quality

Data Element ID: certificate_of_quality

coq_job_no
string or null (Coq Job No)

:Job Number
:Job Number
:Job Number
:ISO 17025
:NA

coq_sample_no
required
string (Coq Sample No)

:Sample Number
:Sample Number
:Sample Number
:ISO 17025
:NA

coq_location_or_terminal
string or null (Coq Location Or Terminal)

:Location / Terminal
:Location/Terminal
:Location/Terminal
:ISO 17025
:NA

coq_sample_product_nm
string or null (Coq Sample Product Nm)

:Name of product sample
:Name of Product Sample
:Name of Product Sample
:ISO 17025
:NA

coq_source_of_sample
string or null (Coq Source Of Sample)

:Sample Source (e.g., shore tank)
:Sample Source
:Sample Source, for example- shore tank
:ISO 17025
:NA

coq_type_of_sample
string or null (Coq Type Of Sample)

:Type of Sample
:Type of Sample
:Type of Sample, for example- before loading
:ISO 17025
:NA

coq_summary_of_sample
string or null (Coq Summary Of Sample)

:Sample Summary
:Sample Summary
:Sample Summary
:ISO 17025
:NA

coq_sample_sampled_dt
string or null <date> (Coq Sample Sampled Dt)

:Sample Sampled Date
:Sample Sampled Date
:Sample Sampled Date
:ISO 17025
:date (YYYY-MM-DD)

coq_sample_received_dt
string or null <date> (Coq Sample Received Dt)

:Sample Date Received
:Sample Date Received
:Sample Date Received
:ISO 17025
:date (YYYY-MM-DD)

coq_sample_tested_dt
string or null <date> (Coq Sample Tested Dt)

:Sample Date Tested
:Sample Date Tested
:Sample Date Tested
:ISO 17025
:date (YYYY-MM-DD)

coq_sample_reported_dt
string or null <date> (Coq Sample Reported Dt)

:Sample Date Reported
:Sample Date Reported
:Sample Date Reported
:ISO 17025
:date (YYYY-MM-DD)

Array of objects or null (Coq Results)

:Certificate of Quality Results
:Certificate of Quality Results
:Certificate of Quality Results
:ISO 17025
:NA

coq_surveyor_company_nm
string or null (Coq Surveyor Company Nm)

:Surveyor Company Name
:Surveyor Company Name
:Surveyor Company Name
:ISO 17025
:NA

Array of objects or null (Attachments) non-empty

:Certificate of Quality Attachment
:Certificate of Quality Attachment
:Certificate of Quality Attachment
:ISO 17025
:.PDF format

{
  • "coq_job_no": "string",
  • "coq_sample_no": "string",
  • "coq_location_or_terminal": "string",
  • "coq_sample_product_nm": "string",
  • "coq_source_of_sample": "string",
  • "coq_type_of_sample": "string",
  • "coq_summary_of_sample": "string",
  • "coq_sample_sampled_dt": "2019-08-24",
  • "coq_sample_received_dt": "2019-08-24",
  • "coq_sample_tested_dt": "2019-08-24",
  • "coq_sample_reported_dt": "2019-08-24",
  • "coq_results": [
    ],
  • "coq_surveyor_company_nm": "string",
  • "attachments": [
    ]
}

Certificate Of Quantity

Data Element ID: certificate_of_quantity

cq_dt
string or null <date> (Cq Dt)

:Certificate of Quantity date
:Certificate of Quantity Date
:Certificate of Quantity Date
:ISO 8601
:ISO Date Format (YYYY-MM-DD)

cq_doc_no
required
string (Cq Doc No)

:Certificate of Quantity Number / Document Number
:Certificate of Quantity Number
:Certificate of Quantity Number
:NA
:NA

cq_seller_nm
string or null (Cq Seller Nm)

:Seller/Shipped By Name
:Seller/Shipped By Name
:Seller/Shipped By Name
:NA
:NA

cq_source
string or null (Source (Vessel/Barge/Tank Name))

:Source of goods (Vessel/Barge/Tank Name)
:Source (Vessel/Barge/Tank Name)
:Source of goods (Vessel/Barge/Tank Name)
:NA
:NA

cq_destination
string or null (Destination (Vessel/Barge/Tank Name))

:Destination of goods (Vessel/Barge/Tank Name)
:Source (Vessel/Barge/Tank Name)
:Destination of goods (Vessel/Barge/Tank Name)
:NA
:NA

cq_buyer_nm
string or null (Cq Buyer Nm)

:Buyer/Consignee Name
:Buyer/Consignee Name
:Buyer/Consignee Name
:NA
:NA

cq_port_of_loading
string or null (Cq Port Of Loading)

:Port of Loading
:Port of Loading
:Port of loading
:NA
:NA

cq_port_of_discharge
string or null (Cq Port Of Discharge)

:Port of Discharge
:Port of Discharge
:Port of discharge
:NA
:NA

cq_country_of_origin
string or null (Cq Country Of Origin)

:Country of Origin
:Country of Origin
:Country of Origin
:NA
:NA

cq_country_of_destination
string or null (Cq Country Of Destination)

:Country of Destination
:Country of Destination
:Country of Destination
:NA
:NA

Array of objects or null (Attachments)

:NA
:Certificate of Quantity Attachment
:Certificate of Quantity Attachment
:NA
:.PDF format

cq_terminal_nm
string or null (Cq Terminal Nm)

:Terminal Name
:Terminal Name
:Terminal Name
:NA
:NA

Array of objects or null (Cq Goods Particulars)

:NA
:Goods Particulars
:Particulars of goods
:NA
:NA

cq_order_no
string or null (Cq Order No)

:Order Number
:Order Number
:Order Number
:NA
:NA

cq_start_pump_dt
string or null <date-time> (Cq Start Pump Dt)

:Start time of pumping
:Start time of pumping
:Start time of pumping
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

cq_end_pump_dt
string or null <date-time> (Cq End Pump Dt)

:End time of pumping
:End time of pumping
:End time of pumping
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

cq_terminal_rep_nm
string or null (Cq Terminal Rep Nm)

:Name of Terminal Representative
:Name of Terminal Representative
:Name of Terminal Representative
:NA
:NA

cq_vessel_flag
string or null (Cq Vessel Flag)

:Name of country of flag the vessel is registered
:Name of country of flag the vessel is registered
:Name of country of flag the vessel is registered
:NA
:NA

cq_surveyor_nm
string or null (Cq Surveyor Nm)

:Surveyor Name
:Surveyor Name
:Surveyor Name
:NA
:NA

cq_terms_and_condition_and_other_text
string or null (Cq Terms And Condition And Other Text)

:Terms and Condition and any other text
:Terms and Condition and any other text
:Terms and Condition and any other text
:NA
:NA

{
  • "cq_dt": "2019-08-24",
  • "cq_doc_no": "string",
  • "cq_seller_nm": "string",
  • "cq_source": "string",
  • "cq_destination": "string",
  • "cq_buyer_nm": "string",
  • "cq_port_of_loading": "string",
  • "cq_port_of_discharge": "string",
  • "cq_country_of_origin": "string",
  • "cq_country_of_destination": "string",
  • "attachments": [
    ],
  • "cq_terminal_nm": "string",
  • "cq_goods_particulars": [
    ],
  • "cq_order_no": "string",
  • "cq_start_pump_dt": "2019-08-24T14:15:22Z",
  • "cq_end_pump_dt": "2019-08-24T14:15:22Z",
  • "cq_terminal_rep_nm": "string",
  • "cq_vessel_flag": "string",
  • "cq_surveyor_nm": "string",
  • "cq_terms_and_condition_and_other_text": "string"
}

Delivery Nomination

Data Element ID: delivery_nomination

dn_bunker_tanker_nm
required
string (Bunker Tanker Name)

:Bunker Tanker Name
:Bunker Tanker Name
:Bunker Tanker Name
:NA
:Alphanumeric Characters Only

dn_sb_no
required
string (Bunker Tanker License Number)

:Bunker Tanker License Number. The format for license number should be SB NNNNA
:Bunker Tanker License Number
:Bunker Tanker License Number. The format for license number should be SB NNNNA
:NA
:Min character = 1, max characters = 8, Alphanumeric. First 3 characters = "SB"

dn_vessel_nm
required
string (Vessel Name)

:Receiving Vessel Name
:Vessel Name
:Receiving Vessel Name
:NA
:Alphanumeric Characters Only

dn_imo_no
required
string (International Maritime Organisation Number)

:International Maritime Organisation (IMO) Vessel Identification Number of the Receiving Vessel
:International Maritime Organisation Number
:International Maritime Organisation (IMO) Vessel Identification Number of the Receiving Vessel
:NA
:Min character = 1, max characters = 10, Alphanumeric

dn_confirmation_no
required
string (Bunkering Sales Confirmation Number)

:Bunkering Sales Confirmation Number
:Bunkering Sales Confirmation Number
:Bunkering Sales Confirmation Number
:NA
:Alphanumeric Characters Only

dn_physical_supplier
required
string (Physical Supplier's Name)

:Physical Supplier's Name
:Physical Supplier's Name
:Physical Supplier's Name
:NA
:Alphanumeric Characters Only

dn_delivery_dt
required
string <date> (Delivery Date)

:Expected Delivery Date
:Delivery Date
:Expected Delivery Date
:NA
:ISO Date Format (YYYY-MM-DD)

dn_delivery_time
string or null (Estimated Time of Bunker Delivery)

:Estimated Time of Bunker Delivery
:Estimated Time of Bunker Delivery
:Estimated Time of Bunker Delivery
:NA
:Duration in format of HH:mm:ss

dn_product_name
required
string (Product Name)

:Product Grade Name
:Product Name
:Product Grade Name
:NA
:NA

dn_product_quantity
required
number <double> (Product Quantity)

:Quantity of product
:Product Quantity
:Quantity of product
:NA
:NA

dn_uom
required
string (Unit of Measurement)

:Unit of Measurement
:Unit of Measurement
:Unit of Measurement
:NA
:NA

dn_bunker_confirmation_dt
string or null <date> (Date of Confirmation)

:Date of Bunker Confirmation
:Date of Confirmation
:Date of Bunker Confirmation
:NA
:ISO Date Format (YYYY-MM-DD)

dn_port_name
string or null (Port Name)

:Port Name
:Port Name
:Port Name
:NA
:NA

dn_delivery_nomination_no
required
string (Delivery nomination number)

:Delivery nomination number unique to the supplier for tying the returning BDN to a particular order
:Delivery nomination number
:Delivery nomination number unique to the supplier for tying the returning BDN to a particular order
:NA
:NA

dn_owner_operator_nm
string or null (Owner/Operator)

:Owner/Operator of receiving vessel
:Owner/Operator
:Owner/Operator of receiving vessel
:NA
:NA

dn_ship_agent
string or null (Ship Agent Details)

:Ship Agent Details
:Ship Agent Details
:Ship Agent Details
:NA
:NA

dn_delete_delivery_nomination
required
boolean (Delete delivery nomination)

:To delete the delivery nominations
:Delete delivery nomination
:To delete the delivery nomination
:NA
:NA

{
  • "dn_bunker_tanker_nm": "string",
  • "dn_sb_no": "string",
  • "dn_vessel_nm": "string",
  • "dn_imo_no": "string",
  • "dn_confirmation_no": "string",
  • "dn_physical_supplier": "string",
  • "dn_delivery_dt": "2019-08-24",
  • "dn_delivery_time": "string",
  • "dn_product_name": "string",
  • "dn_product_quantity": 0.1,
  • "dn_uom": "string",
  • "dn_bunker_confirmation_dt": "2019-08-24",
  • "dn_port_name": "string",
  • "dn_delivery_nomination_no": "string",
  • "dn_owner_operator_nm": "string",
  • "dn_ship_agent": "string",
  • "dn_delete_delivery_nomination": true
}

Dlvd Sales Contract (Sales Confirmation)

Data Element ID: scic_dlvd_sales_contract

salesConfirmationNumber
string or null (Sales Confirmation Number)

:An unique identification number of the individual sales contract/agreement based on delivered basis
:Sales Confirmation Number
:An unique identification number of the individual sales contract/agreement based on delivered basis
:NA
:NA

typeOfContract
string or null (Type of Contract)

:Spot or term pricing
:Type of Contract
:Spot or term pricing
:NA
:NA

contractStartDate
string or null (Contract Start Date)

:The effective date of when the contract is signed/agreed upon by the Buyer and Seller for beginning the period of performance under the contract.
:Contract Start Date
:The effective date of when the contract is signed/agreed upon by the Buyer and Seller for beginning the period of performance under the contract.
:NA
:NA

tradeDate
string or null (Trade Date)

:The effective date that the contract is fixed/agreed between the parties
:Trade Date
:The effective date that the contract is fixed/agreed between the parties
:NA
:NA

sellerName
string or null (Seller Name)

:The Seller's company name, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:Seller Name
:The Seller's company name, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:NA
:NA

sellerAddress
string or null (Seller Address)

:The Seller's company address, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:Seller Address
:The Seller's company address, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:NA
:NA

buyerName
string or null (Buyer Name (Bunker Buyer))

:The Buyer's company name, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:Buyer Name (Bunker Buyer)
:The Buyer's company name, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:NA
:NA

buyerAddress
string or null (Buyer Address (Bunker Buyer))

:The Buyer's company address, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:Buyer Address (Bunker Buyer)
:The Buyer's company address, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:NA
:NA

shipAgentDetails
string or null (Ship Agent Details)

:Receiving vessel agent details (i.e. Agent company, Agent PIC, Agent contact number)
:Ship Agent Details
:Receiving vessel agent details (i.e. Agent company, Agent PIC, Agent contact number)
:NA
:NA

paymentTerms
string or null (Payment Terms)

:Terms which indicate when payments should be made and how to make the payments
:Payment Terms
:Terms which indicate when payments should be made and how to make the payments
:NA
:NA

productName
string or null (Product Name)

:Commercial or trade name of bunkers
:Product Name
:Commercial or trade name of bunkers
:NA
:NA

productType
string or null (Product Type)

:The specifications supplied to the Buyer's nominated receiving vessel (ISO 8217:2010, ISO 8217: 2017)
:Product Type
:The specifications supplied to the Buyer's nominated receiving vessel (ISO 8217:2010, ISO 8217: 2017)
:NA
:NA

productQuality
string or null (Product Quality)

:Product quality refers to Certificate of Quality - from terminal or after loading
:Product Quality
:Product quality refers to Certificate of Quality - from terminal or after loading
:NA
:NA

stemmedSuppliedQuantity
string or null (Stemmed Product Quantity)

:Product quantity refers to the stemmed quantity between the Buyer and Seller which was agreed in the sales contract/agreement
:Stemmed Product Quantity
:Product quantity refers to the stemmed quantity between the Buyer and Seller which was agreed in the sales contract/agreement
:NA
:NA

unitOfMeasurement
string or null (Unit of Measurement)

:Standard for measurement
:Unit of Measurement
:Standard for measurement
:NA
:NA

conversionFormulaForUnitOfMeasurement
string or null (Conversion Formula for Unit of Measurement)

:i.e. conversion from metric tonnes to litres of vice versa (i.e. conversion factor of 7.45)
:Conversion Formula for Unit of Measurement
:i.e. conversion from metric tonnes to litres of vice versa (i.e. conversion factor of 7.45)
:NA
:NA

productUnitPrice
number or null (Product Unit Price)

:The unit price of the product which is offered and agreed between the Buyer and Seller in the sales contract/agreement
:Product Unit Price
:The unit price of the product which is offered and agreed between the Buyer and Seller in the sales contract/agreement
:NA
:NA

pricingFormula
string or null (Pricing Forumla)

:The formula of how the pricing is derived
:Pricing Forumla
:The formula of how the pricing is derived
:NA
:NA

additionalFees
number or null (Additional Fees)

:Any additional fees which is not included in the product unit price (i.e. barging fees, surveyor fees etc)
:Additional Fees
:Any additional fees which is not included in the product unit price (i.e. barging fees, surveyor fees etc)
:NA
:NA

deliveryLocationName
string or null (Location of Bunker Delivery)

:The exact location of bunker delivery within the port mentioned in the Port of Bunker Delivery field (i.e. Anchorages or berths of bunker operations)
:Location of Bunker Delivery
:The exact location of bunker delivery within the port mentioned in the Port of Bunker Delivery field (i.e. Anchorages or berths of bunker operations)
:NA
:NA

contactDetails
string or null (Contact Details)

:The contact details of the bunker supplier
:Contact Details
:The contact details of the bunker supplier
:NA
:NA

receivingVesselName
string or null (Vessel Name)

:Name of receiving vessel
:Vessel Name
:Name of receiving vessel
:NA
:NA

receiveVesselImoNo
string or null (Vessel IMO Number)

:International Maritime Organisation number (IMO) of the receiving vessel
:Vessel IMO Number
:International Maritime Organisation number (IMO) of the receiving vessel
:NA
:NA

port
string or null (Port)

:The port of bunker delivery (i.e. Singapore Port)
:Port
:The port of bunker delivery (i.e. Singapore Port)
:NA
:NA

estimatedDateOfArrival
string or null (Estimated Date of Arrival)

:Estimated date of arrival to the Port of Bunker Delivery of the receiving vessel
:Estimated Date of Arrival
:Estimated date of arrival to the Port of Bunker Delivery of the receiving vessel
:NA
:NA

estimatedDateOfDeparture
string or null (Estimated Date of Departure)

:Estimated date of departure to the Port of Bunker Delivery of the receiving vessel
:Estimated Date of Departure
:Estimated date of departure to the Port of Bunker Delivery of the receiving vessel
:NA
:NA

Array of objects or null (Attachments)

:NA
:Sales Invoice (Delivered) Attachment
:Sales Invoice (Delivered) Attachment
:NA
:.PDF format

{
  • "salesConfirmationNumber": "string",
  • "typeOfContract": "string",
  • "contractStartDate": "string",
  • "tradeDate": "string",
  • "sellerName": "string",
  • "sellerAddress": "string",
  • "buyerName": "string",
  • "buyerAddress": "string",
  • "shipAgentDetails": "string",
  • "paymentTerms": "string",
  • "productName": "string",
  • "productType": "string",
  • "productQuality": "string",
  • "stemmedSuppliedQuantity": "string",
  • "unitOfMeasurement": "string",
  • "conversionFormulaForUnitOfMeasurement": "string",
  • "productUnitPrice": 0,
  • "pricingFormula": "string",
  • "additionalFees": 0,
  • "deliveryLocationName": "string",
  • "contactDetails": "string",
  • "receivingVesselName": "string",
  • "receiveVesselImoNo": "string",
  • "port": "string",
  • "estimatedDateOfArrival": "string",
  • "estimatedDateOfDeparture": "string",
  • "attachments": [
    ]
}

Dlvd Sales Invoice (Sales Invoice)

Data Element ID: scic_dlvd_sales_invoice

dateOfInvoice
string or null (Date of Invoice)

:Date of Invoice
:Date of Invoice
:Date of Invoice
:NA
:NA

invoiceNumber
string or null (Invoice Number)

:Invoice Number
:Invoice Number
:Invoice Number
:NA
:NA

salesConfirmationNumber
string or null (Sales Confirmation Number)

:Sales Confirmation Number
:Sales Confirmation Number
:Sales Confirmation Number
:NA
:NA

typeOfContract
string or null (Type of Contract)

:Type of Contract
:Type of Contract
:Type of Contract
:NA
:NA

bdnNo
string or null (Bunker Delivery Note (BDN) Number)

:BDN number, issued by suplier's system
:Bunker Delivery Note (BDN) Number
:BDN number, issued by suplier's system
:NA
:NA

operationDate
string or null (Bunker Delivery Note Date)

:Date of BDN issued.
:Bunker Delivery Note Date
:Date of BDN issued.
:NA
:NA

buyerName
string or null (Buyer Name)

:The Buyer's company name, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:Buyer Name
:The Buyer's company name, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:NA
:NA

sellerName
string or null (Seller Name)

:The Seller's company name, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:Seller Name
:The Seller's company name, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:NA
:NA

productName
string or null (Product Name)

:Commercial or trade name of bunkers
:Product Name
:Commercial or trade name of bunkers
:NA
:NA

productType
string or null (Product Type)

:The specifications supplied to the Buyer's nominated receiving vessel (ISO 8217:2010, ISO 8217: 2017)
:Product Type
:The specifications supplied to the Buyer's nominated receiving vessel (ISO 8217:2010, ISO 8217: 2017)
:NA
:NA

productQuality
string or null (Product Quality)

:Product quality refers to Certificate of Quality - from terminal or after loading
:Product Quality
:Product quality refers to Certificate of Quality - from terminal or after loading
:NA
:NA

suppliedQuantityBDN
number or null <double> (Product Quantity)

:Product quantity refers to the actual supplied quantity stated in the Bunker Delivery Note (BDN)
:Product Quantity
:Product quantity refers to the actual supplied quantity stated in the Bunker Delivery Note (BDN)
:NA
:NA

unitOfMeasurement
string or null (Unit of Measurement)

:Standard for measurement
:Unit of Measurement
:Standard for measurement
:NA
:NA

deliveryLocationName
string or null (Location of Bunker Delivery)

:The exact location of bunker delivery within the port mentioned in the Port of Bunker Delivery field (i.e. Anchorages or berths of bunker operations)
:Location of Bunker Delivery
:The exact location of bunker delivery within the port mentioned in the Port of Bunker Delivery field (i.e. Anchorages or berths of bunker operations)
:NA
:NA

receiveVesselName
string or null (Vessel Name)

:Name of receiving vessel
:Vessel Name
:Name of receiving vessel
:NA
:NA

receiveVesselImoNo
string or null (Vessel IMO Number)

:International Maritime Organisation number (IMO) of the receiving vessel
:Vessel IMO Number
:International Maritime Organisation number (IMO) of the receiving vessel
:NA
:NA

invoiceDocumentCurrency
string or null (Invoice Document Currency)

:The currency agreed upon the sales contract/agreement (i.e. USD)
:Invoice Document Currency
:The currency agreed upon the sales contract/agreement (i.e. USD)
:NA
:NA

invoiceDocumentAmount
number or null (Invoice Document Amount)

:The total invoice amount based on the Bunker Delivery Note (BDN) value. Including GST or any other taxes if applicable
:Invoice Document Amount
:The total invoice amount based on the Bunker Delivery Note (BDN) value. Including GST or any other taxes if applicable
:NA
:NA

paymentTerms
string or null (Payment Terms)

:Terms which indicate when payments should be made and how to make the payments
:Payment Terms
:Terms which indicate when payments should be made and how to make the payments
:NA
:NA

paymentDueDate
string or null (Payment Due Date)

:Date of payment counting from the date of loading completion or date of issuance of invoice, depending on the payment/credit terms listed in the invoice
:Payment Due Date
:Date of payment counting from the date of loading completion or date of issuance of invoice, depending on the payment/credit terms listed in the invoice
:NA
:NA

exchangeRate
number or null (Exchange Rate)

:Exchange rate of the month of when the invoice is issued
:Exchange Rate
:Exchange rate of the month of when the invoice is issued
:NA
:NA

bankAccountNumberPayable
string or null (Bank Account Number Payable)

:Bank Account Number Payable
:Bank Account Number Payable
:Bank Account Number Payable
:NA
:NA

beneficiaryName
string or null (Beneficiary Name)

:Account holder's name
:Beneficiary Name
:Account holder's name
:NA
:NA

beneficiaryBank
string or null (Beneficiary Bank)

:Name of beneficiary bank
:Beneficiary Bank
:Name of beneficiary bank
:NA
:NA

beneficiaryBankSwiftNumber
string or null (Beneficiary Bank Swift Number)

:Swift code of the beneficiary bank
:Beneficiary Bank Swift Number
:Swift code of the beneficiary bank
:NA
:NA

productUnitPrice
number or null <double> (Product Unit Price)

:The unit price of the product which is offered and agreed between the Buyer and Seller in the sales contract/agreement
:Product Unit Price
:The unit price of the product which is offered and agreed between the Buyer and Seller in the sales contract/agreement
:NA
:NA

Array of objects or null (Attachments)

:NA
:Sales Invoice (Delivered) Attachment
:Sales Invoice (Delivered) Attachment
:NA
:.PDF format

{
  • "dateOfInvoice": "string",
  • "invoiceNumber": "string",
  • "salesConfirmationNumber": "string",
  • "typeOfContract": "string",
  • "bdnNo": "string",
  • "operationDate": "string",
  • "buyerName": "string",
  • "sellerName": "string",
  • "productName": "string",
  • "productType": "string",
  • "productQuality": "string",
  • "suppliedQuantityBDN": 0.1,
  • "unitOfMeasurement": "string",
  • "deliveryLocationName": "string",
  • "receiveVesselName": "string",
  • "receiveVesselImoNo": "string",
  • "invoiceDocumentCurrency": "string",
  • "invoiceDocumentAmount": 0,
  • "paymentTerms": "string",
  • "paymentDueDate": "string",
  • "exchangeRate": 0,
  • "bankAccountNumberPayable": "string",
  • "beneficiaryName": "string",
  • "beneficiaryBank": "string",
  • "beneficiaryBankSwiftNumber": "string",
  • "productUnitPrice": 0.1,
  • "attachments": [
    ]
}

Ex-wharf sales contract (sales agreement)

Data Element ID: scic_exwharf_sales_contract

contractStartDate
string or null (Contract Start Date)

:The effective date of when the contract is signed/agreed upon by the Buyer and Seller for beginning the period of performance under the contract.
:Contract Start Date
:The effective date of when the contract is signed/agreed upon by the Buyer and Seller for beginning the period of performance under the contract.
:NA
:NA

contractThroughDate
string or null (Contract Through Date)

:Refers to the latest date in time for which all records have been entered into the information management system
:Contract Through Date
:Refers to the latest date in time for which all records have been entered into the information management system
:NA
:NA

salesAgreementNumber
string or null (Sales agreement Number)

:An unique identification number of the individual sales contract/agreement based on ex-wharf delivery
:Sales agreement Number
:An unique identification number of the individual sales contract/agreement based on ex-wharf delivery
:NA
:NA

sellerName
string or null (Seller Name)

:The Seller's company name, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:Seller Name
:The Seller's company name, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:NA
:NA

sellerAddress
string or null (Seller Address)

:The Seller's company address, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:Seller Address
:The Seller's company address, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:NA
:NA

buyerName
string or null (Buyer Name)

:The Buyer's company name, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:Buyer Name
:The Buyer's company name, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:NA
:NA

buyerAddress
string or null (Buyer Address)

:The Buyer's company address, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:Buyer Address
:The Buyer's company address, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:NA
:NA

productName
string or null (Product Name)

:Name of product supplied to the Buyer's nominated receiving bunker tanker
:Product Name
:Name of product supplied to the Buyer's nominated receiving bunker tanker
:NA
:NA

productType
string or null (Product Type)

:The specifications supplied to the Buyer's nominated receiving bunker tanker (ISO 8217:2010, ISO 8217: 2017)
:Product Type
:The specifications supplied to the Buyer's nominated receiving bunker tanker (ISO 8217:2010, ISO 8217: 2017)
:NA
:NA

productQuality
string or null (Product Quality)

:Product quality supplied to the Buyer's nominated receiving vessel, which will be reference to Seller's Certificate of Quality
:Product Quality
:Product quality supplied to the Buyer's nominated receiving vessel, which will be reference to Seller's Certificate of Quality
:NA
:NA

stemmedLoadProductQuantity
number or null <double> (Product Quantity)

:Product quantity refers to the stemmed quantity between the Buyer and Seller which was agreed in the sales contract/agreement
:Product Quantity
:Product quantity refers to the stemmed quantity between the Buyer and Seller which was agreed in the sales contract/agreement
:NA
:NA

productTolerance
string or null (Product Tolerance)

:Product tolerance- +/- operational tolerance
:Product Tolerance
:Product tolerance- +/- operational tolerance
:NA
:NA

unitOfMeasurement
string or null (Unit of Measurement)

:Standard for measurement
:Unit of Measurement
:Standard for measurement
:NA
:NA

productUnitPrice
number or null (Product Unit Price)

:The unit price of the product which is offered and agreed between the Buyer and Seller in the sales contract/agreement
:Product Unit Price
:The unit price of the product which is offered and agreed between the Buyer and Seller in the sales contract/agreement
:NA
:NA

terminalOplName
string or null (Terminal/Floating Storage/Tanker Name)

:Name of the terminal, floating storage or tanker from which the product is loaded
:Terminal/Floating Storage/Tanker Name
:Name of the terminal, floating storage or tanker from which the product is loaded
:NA
:NA

port
string or null (Port)

:Port or place the terminal, floating storage or tanker is located at for the loading
:Port
:Port or place the terminal, floating storage or tanker is located at for the loading
:NA
:NA

countryEWSC
string or null (Country)

:Country or location from which the terminal, floating storage or tanker is loading from
:Country
:Country or location from which the terminal, floating storage or tanker is loading from
:NA
:NA

paymentTerms
string or null (Payment Terms)

:Terms which indicate when payments should be made and how to make the payments
:Payment Terms
:Terms which indicate when payments should be made and how to make the payments
:NA
:NA

determinationOfQuantityAndQuality
string or null (Determination of Quantity and Quality Details)

:Referring to Certificate of Quantity and Quality
:Determination of Quantity and Quality Details
:Referring to Certificate of Quantity and Quality
:NA
:NA

detailsOfSanctions
string or null (Details of Sanctions)

:Referring to Sanction clause found in the contract
:Details of Sanctions
:Referring to Sanction clause found in the contract
:NA
:NA

Array of objects or null (Attachments)

:NA
:Sales Invoice (Delivered) Attachment
:Sales Invoice (Delivered) Attachment
:NA
:.PDF format

{
  • "contractStartDate": "string",
  • "contractThroughDate": "string",
  • "salesAgreementNumber": "string",
  • "sellerName": "string",
  • "sellerAddress": "string",
  • "buyerName": "string",
  • "buyerAddress": "string",
  • "productName": "string",
  • "productType": "string",
  • "productQuality": "string",
  • "stemmedLoadProductQuantity": 0.1,
  • "productTolerance": "string",
  • "unitOfMeasurement": "string",
  • "productUnitPrice": 0,
  • "terminalOplName": "string",
  • "port": "string",
  • "countryEWSC": "string",
  • "paymentTerms": "string",
  • "determinationOfQuantityAndQuality": "string",
  • "detailsOfSanctions": "string",
  • "attachments": [
    ]
}

Ex-wharf Sales Invoice (Sales Invoice)

Data Element ID: scic_exwharf_sales_invoice

salesAgreementNumber
string or null (Sales Agreement Number)

:An unique identification number of the individual sales contract/agreement based on ex-wharf delivery
:Sales Agreement Number
:An unique identification number of the individual sales contract/agreement based on ex-wharf delivery
:NA
:NA

dateOfInvoice
string or null (Date of Invoice)

:Date of which invoice is issued by the Seller under the sales contract/agreement
:Date of Invoice
:Date of which invoice is issued by the Seller under the sales contract/agreement
:NA
:NA

invoiceNumber
string or null (Invoice Number)

:A unique and sequential code that is systematically assigned to invoices issued
:Invoice Number
:A unique and sequential code that is systematically assigned to invoices issued
:NA
:NA

buyerName
string or null (Buyer Name)

:The Buyer's company name, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:Buyer Name
:The Buyer's company name, "party stated in the sales contract/agreement contracting to purchase, take delivery and pay for the marine fuels"
:NA
:NA

sellerName
string or null (Seller Name)

:The Seller's company name, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:Seller Name
:The Seller's company name, "party stated in the sales contract/agreement contracting to sell and arrange delivery of the marine fuels"
:NA
:NA

operationDate
string or null (Delivery Date)

:Date of which bunker tanker received/loaded from the terminal
:Delivery Date
:Date of which bunker tanker received/loaded from the terminal
:NA
:NA

productName
string or null (Product Name)

:Name of product supplied to the Buyer's nominated receiving bunker tanker
:Product Name
:Name of product supplied to the Buyer's nominated receiving bunker tanker
:NA
:NA

productType
string or null (Product Type)

:The specifications supplied to the Buyer's nominated receiving bunker tanker (ISO 8217:2010, ISO 8217: 2017)
:Product Type
:The specifications supplied to the Buyer's nominated receiving bunker tanker (ISO 8217:2010, ISO 8217: 2017)
:NA
:NA

acutalLoadProductQuantity
number or null <double> (Product Quantity of Certificate of Quantity (CQ))

:Product quantity refers to the actual quantity stated in the Certificate of Quantity (CQ)
:Product Quantity of Certificate of Quantity (CQ)
:Product quantity refers to the actual quantity stated in the Certificate of Quantity (CQ)
:NA
:NA

unitOfMeasurement
string or null (Unit of Measurement)

:Standard for measurement
:Unit of Measurement
:Standard for measurement
:NA
:NA

terminalOplName
string or null (Terminal/Floating Storage/Tanker Name)

:Name of the terminal, floating storage or tanker from which the product is loaded
:Terminal/Floating Storage/Tanker Name
:Name of the terminal, floating storage or tanker from which the product is loaded
:NA
:NA

port
string or null (Port)

:Port or place the terminal, floating storage or tanker is located at for the loading
:Port
:Port or place the terminal, floating storage or tanker is located at for the loading
:NA
:NA

countryEWSI
string or null (Country)

:Country or location from which the terminal, floating storage or tanker is loading from
:Country
:Country or location from which the terminal, floating storage or tanker is loading from
:NA
:NA

bunkerTankerName
string or null (Vessel Name)

:Name of receiving bunker tanker
:Vessel Name
:Name of receiving bunker tanker
:NA
:NA

bunkerTankerIMO
string or null (Bunker Tanker IMO Number)

:Unique number provided by the International Maritme Organisation (IMO)
:Bunker Tanker IMO Number
:Unique number provided by the International Maritme Organisation (IMO)
:NA
:NA

productUnitPrice
number or null (Product Unit Price)

:The unit price of the product which is offered and agreed between the Buyer and Seller in the sales contract/agreement
:Product Unit Price
:The unit price of the product which is offered and agreed between the Buyer and Seller in the sales contract/agreement
:NA
:NA

invoiceDocumentCurrency
string or null (Invoice Document Currency)

:The currency agreed upon the sales contract/agreement (i.e. USD)
:Invoice Document Currency
:The currency agreed upon the sales contract/agreement (i.e. USD)
:NA
:NA

invoiceDocumentAmount
number or null (Invoice Document Amount)

:The total invoice amount based on the Certificate of Quantity (CQ) value. Including GST or any other taxes if applicable
:Invoice Document Amount
:The total invoice amount based on the Certificate of Quantity (CQ) value. Including GST or any other taxes if applicable
:NA
:NA

totalAmount
number or null (Total Amount)

:Reflecting final price based on the Certificate of Quantity (CQ). Does not include GST or any other taxes
:Total Amount
:Reflecting final price based on the Certificate of Quantity (CQ). Does not include GST or any other taxes
:NA
:NA

totalGstPrice
number or null (Total GST Price (in applicable currency))

:Reflecting only tax price (i.e. 7% of total invoice amount before any taxations)
:Total GST Price (in applicable currency)
:Reflecting only tax price (i.e. 7% of total invoice amount before any taxations)
:NA
:NA

exchangeRate
number or null (Exchange Rate)

:Exchange rate of the month of when the invoice is issued
:Exchange Rate
:Exchange rate of the month of when the invoice is issued
:NA
:NA

paymentTerms
string or null (Payment Terms)

:Terms which indicate when payments should be made and how to make the payments
:Payment Terms
:Terms which indicate when payments should be made and how to make the payments
:NA
:NA

paymentDueDate
string or null (Payment Due Date)

:Date of payment counting for the issuance date of CQ, depending on the payment/credit terms listed in the invoice
:Payment Due Date
:Date of payment counting for the issuance date of CQ, depending on the payment/credit terms listed in the invoice
:NA
:NA

accountNumber
string or null (Account Number)

:Unique string of numbers, letters, other characters that identifies the owner of an account
:Account Number
:Unique string of numbers, letters, other characters that identifies the owner of an account
:NA
:NA

intermediaryBankCompanyName
string or null (Intermediary Bank Company Name)

:The name of the intermediary bank company name
:Intermediary Bank Company Name
:The name of the intermediary bank company name
:NA
:NA

intermediaryBankSwiftNumber
string or null (Intermediary Bank Swift Number)

:A standard format for codes, to be able to identify banks and financial institutions globally
:Intermediary Bank Swift Number
:A standard format for codes, to be able to identify banks and financial institutions globally
:NA
:NA

referenceData
string or null (Reference Data to be included in payment instruction)

:Can include payment instructions etc
:Reference Data to be included in payment instruction
:Can include payment instructions etc
:NA
:NA

sellerVatNumber
string or null (Seller's VAT Number)

:Value Added Tax Identification Number, an identifier used for value added tax purposes
:Seller's VAT Number
:Value Added Tax Identification Number, an identifier used for value added tax purposes
:NA
:NA

portOfLoading
string or null (Port of Loading)

:Loading port details
:Port of Loading
:Loading port details
:NA
:NA

portOfDischarge
string or null (Port of Discharge)

:Discharging port details
:Port of Discharge
:Discharging port details
:NA
:NA

sellerTaxCode
string or null (Seller's Tax Code)

:refers to: Zero rated, 7%, Not Applicable
:Seller's Tax Code
:refers to: Zero rated, 7%, Not Applicable
:NA
:NA

percentageOfTax
number or null (Percentage of Tax Applicable)

:i.e. 7%
:Percentage of Tax Applicable
:i.e. 7%
:NA
:NA

beneficiaryName
string or null (Beneficiary Name)

:Account holder's name
:Beneficiary Name
:Account holder's name
:NA
:NA

beneficiaryBank
string or null (Beneficiary Bank)

:Name of beneficiary bank
:Beneficiary Bank
:Name of beneficiary bank
:NA
:NA

beneficiaryBankSwiftNumber
string or null (Beneficiary Bank Swift Number)

:Swift code of the beneficiary bank
:Beneficiary Bank Swift Number
:Swift code of the beneficiary bank
:NA
:NA

Array of objects or null (Attachments)

:NA
:Sales Invoice (Delivered) Attachment
:Sales Invoice (Delivered) Attachment
:NA
:.PDF format

{
  • "salesAgreementNumber": "string",
  • "dateOfInvoice": "string",
  • "invoiceNumber": "string",
  • "buyerName": "string",
  • "sellerName": "string",
  • "operationDate": "string",
  • "productName": "string",
  • "productType": "string",
  • "acutalLoadProductQuantity": 0.1,
  • "unitOfMeasurement": "string",
  • "terminalOplName": "string",
  • "port": "string",
  • "countryEWSI": "string",
  • "bunkerTankerName": "string",
  • "bunkerTankerIMO": "string",
  • "productUnitPrice": 0,
  • "invoiceDocumentCurrency": "string",
  • "invoiceDocumentAmount": 0,
  • "totalAmount": 0,
  • "totalGstPrice": 0,
  • "exchangeRate": 0,
  • "paymentTerms": "string",
  • "paymentDueDate": "string",
  • "accountNumber": "string",
  • "intermediaryBankCompanyName": "string",
  • "intermediaryBankSwiftNumber": "string",
  • "referenceData": "string",
  • "sellerVatNumber": "string",
  • "portOfLoading": "string",
  • "portOfDischarge": "string",
  • "sellerTaxCode": "string",
  • "percentageOfTax": 0,
  • "beneficiaryName": "string",
  • "beneficiaryBank": "string",
  • "beneficiaryBankSwiftNumber": "string",
  • "attachments": [
    ]
}

Letter Of Credit

Data Element ID: letter_of_credit

lc_doc_lc_form
string or null (Form of Documentary Credit)

:SWIFT MT 700 Field 40A : Form of Documentary Credit
This field specifies the type of credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Form of Documentary Credit
:SWIFT MT 700 Field 40A : Form of Documentary Credit
This field specifies the type of credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_dt_of_issue
required
string <date> (Date Of Issue)

:SWIFT MT 700 Field 31C : Date Of Issue
This field specifies the date on which the issuing bank (Sender) considers the documentary credit as being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Date Of Issue
:SWIFT MT 700 Field 31C : Date Of Issue
This field specifies the date on which the issuing bank (Sender) considers the documentary credit as being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:date (YYYY-MM-DD)

lc_doc_lc_no
string or null (Documentary Credit Number)

:SWIFT MT 700 Field 20 : Documentary Credit Number
This field specifies the documentary credit number which has been assigned by the Sender.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Documentary Credit Number
:SWIFT MT 700 Field 20 : Documentary Credit Number
This field specifies the documentary credit number which has been assigned by the Sender.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_dt_and_place_of_expiry
string or null (Date and Place of Expiry)

:SWIFT MT 700 Field 31D : Date and Place of Expiry
This field specifies the latest date for presentation under the documentary credit and the place where documents may be presented.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Date and Place of Expiry
:SWIFT MT 700 Field 31D : Date and Place of Expiry
This field specifies the latest date for presentation under the documentary credit and the place where documents may be presented.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_applicant
string or null (Applicant)

:SWIFT MT 700 Field 50 : Applicant
This field specifies the party on behalf of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Applicant
:SWIFT MT 700 Field 50 : Applicant
This field specifies the party on behalf of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_beneficiary_nm_and_address
string or null (Beneficiary)

:SWIFT MT 700 Field 59 : Beneficiary
The field specifies the party in favour of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Beneficiary
:SWIFT MT 700 Field 59 : Beneficiary
The field specifies the party in favour of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_doc_lc_currency_cd_and_amount
string or null (Currency Code, Amount)

:SWIFT MT 700 Field 32B : Currency Code, Amount
This field contains the currency code and amount of the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Currency Code, Amount
:SWIFT MT 700 Field 32B : Currency Code, Amount
This field contains the currency code and amount of the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_available_with_by
string or null (Available with and by)

:SWIFT MT 700 Field 41a : Available with... by …
This field identifies the bank with which the credit is available (the place for presentation) and an indication of how the credit is available.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Available with and by
:SWIFT MT 700 Field 41a : Available with... by …
This field identifies the bank with which the credit is available (the place for presentation) and an indication of how the credit is available.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_negotiation_deferred_payment_details
string or null (Negotiation/Deferred Payment Details)

:SWIFT MT 700 Field 42P : Negotiation/Deferred Payment Details
This field specifies the payment date or method for its determination in a documentary credit which is available by deferred payment or negotiation only.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Negotiation/Deferred Payment Details
:SWIFT MT 700 Field 42P : Negotiation/Deferred Payment Details
This field specifies the payment date or method for its determination in a documentary credit which is available by deferred payment or negotiation only.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_partial_shipments
string or null (Partial Shipments)

:SWIFT MT 700 Field 43P : Partial Shipments
This field specifies whether or not partial shipments are allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Partial Shipments
:SWIFT MT 700 Field 43P : Partial Shipments
This field specifies whether or not partial shipments are allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_transhipment
string or null (Transhipment)

:SWIFT MT 700 Field 43T : Transhipment
This field specifies whether or not transhipment is allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Transhipment
:SWIFT MT 700 Field 43T : Transhipment
This field specifies whether or not transhipment is allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_latest_dt_of_shipment
string or null <date> (Latest Date of Shipment)

:SWIFT MT 700 Field 44C : Latest Date of Shipment
This field specifies the latest date for loading on board/dispatch/taking in charge.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Latest Date of Shipment
:SWIFT MT 700 Field 44C : Latest Date of Shipment
This field specifies the latest date for loading on board/dispatch/taking in charge.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:date (YYYY-MM-DD)

lc_confirmation_instructions
string or null (Confirmation Instructions)

:SWIFT MT 700 Field 49 : Confirmation Instructions
This field contains confirmation instructions for the requested confirmation party.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Confirmation Instructions
:SWIFT MT 700 Field 49 : Confirmation Instructions
This field contains confirmation instructions for the requested confirmation party.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_percentage_credit_amt_tolerance
string or null (Percentage Credit Amount Tolerance)

:SWIFT MT 700 Field 39A : Percentage Credit Amount Tolerance
This field specifies the tolerance relative to the documentary credit amount as a percentage plus and/or minus that amount.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Percentage Credit Amount Tolerance
:SWIFT MT 700 Field 39A : Percentage Credit Amount Tolerance
This field specifies the tolerance relative to the documentary credit amount as a percentage plus and/or minus that amount.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_mixed_payment_details
string or null (Mixed Payment Details)

:SWIFT MT 700 Field 42M : Mixed Payment Details
This field specifies the payment dates, amounts and/or method for their determination in a documentary credit which is available by mixed payment.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Mixed Payment Details
:SWIFT MT 700 Field 42M : Mixed Payment Details
This field specifies the payment dates, amounts and/or method for their determination in a documentary credit which is available by mixed payment.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_period_for_presentation_in_days
string or null (Period for Presentaton in Days)

:SWIFT MT 700 Field 48 : Period for Presentaton in Days
This field specifies the number of calendar days after the date of shipment within which the documents must be presented for payment, acceptance, or negotiation. Narrative must only be used to specify another type of date than a shipment date, for example invoice date, from which the period for presentation begins.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Period for Presentaton in Days
:SWIFT MT 700 Field 48 : Period for Presentaton in Days
This field specifies the number of calendar days after the date of shipment within which the documents must be presented for payment, acceptance, or negotiation. Narrative must only be used to specify another type of date than a shipment date, for example invoice date, from which the period for presentation begins.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

Array of objects or null (Letter of Credit Attachment)

:Letter of Credit Attachment
:Letter of Credit Attachment
:Letter of Credit Attachment
:NA
:NA

{
  • "lc_doc_lc_form": "string",
  • "lc_dt_of_issue": "2019-08-24",
  • "lc_doc_lc_no": "string",
  • "lc_dt_and_place_of_expiry": "string",
  • "lc_applicant": "string",
  • "lc_beneficiary_nm_and_address": "string",
  • "lc_doc_lc_currency_cd_and_amount": "string",
  • "lc_available_with_by": "string",
  • "lc_negotiation_deferred_payment_details": "string",
  • "lc_partial_shipments": "string",
  • "lc_transhipment": "string",
  • "lc_latest_dt_of_shipment": "2019-08-24",
  • "lc_confirmation_instructions": "string",
  • "lc_percentage_credit_amt_tolerance": "string",
  • "lc_mixed_payment_details": "string",
  • "lc_period_for_presentation_in_days": "string",
  • "attachments": [
    ]
}

Mass Flow Meter Receipt

Data Element ID: mfm

mfm_vessel_id
required
string (Mfm Vessel Id)

:Vessel ID
:Vessel ID
:Vessel ID
:NA
:Alphanumeric Characters Only

mfm_system_id
required
string (Mfm System Id)

:System ID
:System ID
:System ID
:NA
:Alphanumeric Characters Only

mfm_btn_no
required
number (Mfm Btn No)

:BTN Number
:Bunker Metering Ticket Number (BTN)
:Bunker Metering Ticket Number (BTN)
:NA
:Numerical digits only

mfm_print_out_dt
required
string <date-time> (Mfm Print Out Dt)

:Printout Time
:Printout Time
:Printout Time
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

mfm_start_dt
required
string <date-time> (Mfm Start Dt)

:Bunker Begin Time
:Bunker Begin Time
:Bunker Begin Time
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

mfm_end_dt
required
string <date-time> (Mfm End Dt)

:Bunker End Time
:Bunker End Time
:Bunker End Time
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

mfm_totalizer_loading_at_operation_start
required
string (Mfm Totalizer Loading At Operation Start)

:Totalizer Loading at Operation Start / Begin rev INV Air
:Totalizer Loading at Operation Start/Begin Rev Inv Air
:Totalizer Loading at Operation Start/Begin Rev Inv Air
:NA
:Numerical digits with up to 4 decimal

mfm_totalizer_loading_at_operation_end
required
string (Mfm Totalizer Loading At Operation End)

:Totalizer Loading at Operation End/ End rev INV Air
:Totalizer Loading at Operation End/End Rev Inv Air
:Totalizer Loading at Operation End/End Rev Inv Air
:NA
:Numerical digits with up to 4 decimal

mfm_totalizer_delivery_at_operation_start
required
string (Mfm Totalizer Delivery At Operation Start)

:Totalizer Delivery at Operation Start / Begin fwd INV Air
:Totalizer Delivery at Operation Start/Begin Fwd Inv Air
:Totalizer Delivery at Operation Start/Begin Fwd Inv Air
:NA
:Numerical digits with up to 4 decimal

mfm_totalizer_delivery_at_operation_end
required
string (Mfm Totalizer Delivery At Operation End)

:Totalizer Delivery at Operation End / End fwd INV Air
:Totalizer Delivery at Operation End/End Fwd Inv Air
:Totalizer Delivery at Operation End/End Fwd Inv Air
:NA
:Numerical digits with up to 4 decimal

required
Array of objects (Attachments) non-empty

:NA
:Mass Flow Meter Receipt Attachment
:Mass Flow Meter Receipt Attachment
:NA
:.PDF format

mfm_time_zone
string or null (Mfm Time Zone)

:Time zone used
:Time Zone Used
:Time Zone Used
:NA
:Alphanumeric Characters Only

mfm_reset_dt
string or null <date-time> (Mfm Reset Dt)

:Reset time
:Reset Time
:Reset Time
:NA
:ISO Date Time Format (YYYY-MM-DDTHH:mm:ssZ)

mfm_mass_delivered
string or null (Mfm Mass Delivered)

:Mass Delivered/Loaded
:Mass Delivered/Loaded
:Mass Delivered/Loaded
:NA
:Numerical digits with up to 3 decimal

mfm_mass_in_air
string or null (Mfm Mass In Air)

:Mass in Air
:Mass in Air
:Mass in Air
:NA
:Numerical digits followed by *

mfm_sb_no
string or null (Mfm Sb No)

:SB Number
:Bunker Tanker License Number
:Bunker Tanker License Number. The format for license number should be SB NNNNA
:NA
:Alphanumeric Characters Only

{
  • "mfm_vessel_id": "string",
  • "mfm_system_id": "string",
  • "mfm_btn_no": 0,
  • "mfm_print_out_dt": "2019-08-24T14:15:22Z",
  • "mfm_start_dt": "2019-08-24T14:15:22Z",
  • "mfm_end_dt": "2019-08-24T14:15:22Z",
  • "mfm_totalizer_loading_at_operation_start": "string",
  • "mfm_totalizer_loading_at_operation_end": "string",
  • "mfm_totalizer_delivery_at_operation_start": "string",
  • "mfm_totalizer_delivery_at_operation_end": "string",
  • "attachments": [
    ],
  • "mfm_time_zone": "string",
  • "mfm_reset_dt": "2019-08-24T14:15:22Z",
  • "mfm_mass_delivered": "string",
  • "mfm_mass_in_air": "string",
  • "mfm_sb_no": "string"
}

Oil Cargo Bill of Lading

Data Element ID: bill_of_lading

bl_doc_no
string or null (Bl Doc No)

:Document Number of Bill of Lading
:Oil Cargo Bill of Lading Document Number
:Document Number of Bill of Lading
:NA
:NA

bl_dt
required
string <date> (Bl Dt)

:Date when cargo is loaded on board the vessel / BL Date
:Date of Operation
:Date of Operation
:ISO 8601
:ISO Date Format (YYYY-MM-DD)

bl_shipper_nm
string or null (Bl Shipper Nm)

:Name of Shipper
:Name of Shipper
:Name of Shipper
:NA
:NA

bl_consignee_nm
string or null (Bl Consignee Nm)

:Name of Consignee
:Name of Consignee
:Name of Consignee
:NA
:NA

bl_terminal_nm
string or null (Bl Terminal Nm)

:Terminal Name
:Terminal Name
:Terminal Name
:NA
:NA

bl_port_of_loading
string or null (Bl Port Of Loading)

:Port which goods were loaded
:Port of Loading
:Port of loading
:NA
:NA

bl_port_of_discharge
string or null (Bl Port Of Discharge)

:Port which goods will be discharged
:Port of Discharge
:Port of discharge
:NA
:NA

bl_vessel_nm
string or null (Bl Vessel Nm)

:Name of Vessel
:Vessel Name
:Name of vessel
:NA
:NA

bl_country_of_origin
string or null (Bl Country Of Origin)

:Country of Origin
:Country of Origin
:Country of Origin
:NA
:NA

bl_country_of_destination
string or null (Bl Country Of Destination)

:Country of Destination
:Country of Destination
:Country of Destination
:NA
:NA

Array of objects or null (Bl Goods Particulars)

:NA
:Goods Particulars
:Particulars of goods
:NA
:NA

Array of objects or null (Attachments) non-empty

:NA
:Bill of Lading Attachment
:Bill of Lading Attachment
:NA
:NA

bl_order_no
string or null (Bl Order No)

:Order Number of Bill of Lading
:Oil Cargo Bill of Lading Order Number
:Order Number of Bill of Lading
:NA
:NA

bl_vessel_flag
string or null (Bl Vessel Flag)

:Flag of Vessel
:Vessel Flag
:Flag of the vessel
:NA
:NA

bl_master_nm
string or null (Bl Master Nm)

:Name of barge vessel master
:Name of Barge Vessel Master
:Name of Barge Vessel Master
:NA
:NA

bl_terms_and_condition_and_other_text
string or null (Bl Terms And Condition And Other Text)

:Terms and Condition and any other text
:Terms and Conditions and any other Text
:Terms and Conditions and any other Text
:NA
:NA

bl_vessel_imo_no
string or null (Bl Vessel Imo No)

:IMO Number of Vessel
:Vessel International Maritime Organisation Number
:International Maritime Organisation (IMO) Vessel Identification Number
:IHSM
:7 digit Numeric Characters Only

bl_notify_party_nm
string or null (Bl Notify Party Nm)

:Name of Notify Party
:Name of Notify Party
:Name of Notify Party
:NA
:NA

{
  • "bl_doc_no": "string",
  • "bl_dt": "2019-08-24",
  • "bl_shipper_nm": "string",
  • "bl_consignee_nm": "string",
  • "bl_terminal_nm": "string",
  • "bl_port_of_loading": "string",
  • "bl_port_of_discharge": "string",
  • "bl_vessel_nm": "string",
  • "bl_country_of_origin": "string",
  • "bl_country_of_destination": "string",
  • "bl_goods_particulars": [
    ],
  • "attachments": [
    ],
  • "bl_order_no": "string",
  • "bl_vessel_flag": "string",
  • "bl_master_nm": "string",
  • "bl_terms_and_condition_and_other_text": "string",
  • "bl_vessel_imo_no": "string",
  • "bl_notify_party_nm": "string"
}

Proof of Sustainability

Data Element ID: proof_of_sustainability

pos_unique_number_of_the_pos
required
string (Unique Number of the PoS)

:Unique number of the Proof of Sustainability
:Unique Number of the PoS
:Unique number of the Proof of Sustainability
:NA
:NA

pos_date_of_issuance_of_the_pos
required
string <date> (Date of Issuance of the PoS)

:Date of issuance of the Proof of Sustainability
:Date of Issuance of the PoS
:Date of issuance of the Proof of Sustainability
:NA
:date (YYYY-MM-DD)

pos_supplier_name
required
string (Supplier Name)

:Supplier - Name
:Supplier Name
:Supplier - Name
:NA
:NA

pos_supplier_address
required
string (Supplier Address)

:Supplier - Address
:Supplier Address
:Supplier - Address
:NA
:NA

pos_certification_system
required
string (Certification System)
Value: "ISCC EU"

:Supplier - Certification System
:Certfication System
:Supplier - Certification System
:NA
:Drop-down selection:
ISCC EU

pos_certificate_number
required
string (Certificate Number)

:Supplier - ISCC Certificate Number
:Certificate Number
:Supplier - ISCC Certificate Number
:NA
:NA

pos_recipient_name
required
string (Recipient Name)

:Recipient - Name
:Recipient Name
:Recipient - Name
:NA
:NA

pos_recipient_address
required
string (Recipient Address)

:Recipient - Address
:Recipient Address
:Recipient - Address
:NA
:NA

pos_contract_number
required
string (Contract Number)

:Recipient - Contract Number
:Contract Number
:Recipient - Contract Number
:NA
:NA

pos_address_of_dispatch_shipping_point_of_the_sustainable_material
required
string (Address of dispatch/shipping point of the sustainable material)

:Address of dispatch/shipping point of the sustainable material.
If address same as supplier address, input same value as Supplier Address.
:Address of dispatch/shipping point of the sustainable material
:Address of dispatch/shipping point of the sustainable material.
If address same as supplier address, input same value as Supplier Address.
:NA
:NA

pos_address_of_receipt_receiving_point_of_the_sustainable_material
required
string (Address of receipt/receiving point of the sustainable material)

:Address of receipt/receiving point of the sustainable material.
If address same as receipient address, input same value as Recipient Address.
:Address of receipt/receiving point of the sustainable material
:Address of receipt/receiving point of the sustainable material.
If address same as receipient address, input same value as Recipient Address.
:NA
:NA

pos_date_of_dispatch_of_the_sustainable_material
required
string <date> (Date of dispatch of the sustainable material)

:Date of dispatch of the sustainable material
:Date of dispatch of the sustainable material
:Date of dispatch of the sustainable material
:NA
:date (YYYY-MM-DD)

pos_type_of_product
required
string (Type of Product)

:General information - type of product supplied.
Input one type of product from the following selections:
Biodiesel
Bioethanol
Biogas / Biomethane
Biomethanol
Co-processed oil to be used for replacement of diesel
Co-processed oil to be used for replacement of marine fuel
Co-processed oil to be used for replacement of naptha
Co-processed oil to be used for replacement of petrol
Co-processed oil to be used for replacement of jet fuel
Co-processed oil to be used for replacement of liquefied petroleum gas
Co-processed oil for the replacement of diesel/petrol/jet fuel produced from biomethane
HVO - hydrotreated vegetable oil
Pure vegetable oil
Other: Specifiy if other
:Type of Product
:General information - type of product supplied.
Input one type of product from the following selections:
Biodiesel
Bioethanol
Biogas / Biomethane
Biomethanol
Co-processed oil to be used for replacement of diesel
Co-processed oil to be used for replacement of marine fuel
Co-processed oil to be used for replacement of naptha
Co-processed oil to be used for replacement of petrol
Co-processed oil to be used for replacement of jet fuel
Co-processed oil to be used for replacement of liquefied petroleum gas
Co-processed oil for the replacement of diesel/petrol/jet fuel produced from biomethane
HVO - hydrotreated vegetable oil
Pure vegetable oil
Other: Specifiy if other
:NA
:Input one type of product from the following selections:
Biodiesel
Bioethanol
Biogas / Biomethane
Biomethanol
Co-processed oil to be used for replacement of diesel
Co-processed oil to be used for replacement of marine fuel
Co-processed oil to be used for replacement of naptha
Co-processed oil to be used for replacement of petrol
Co-processed oil to be used for replacement of jet fuel
Co-processed oil to be used for replacement of liquefied petroleum gas
Co-processed oil for the replacement of diesel/petrol/jet fuel produced from biomethane
HVO - hydrotreated vegetable oil
Pure vegetable oil
Other: Specifiy if other

pos_type_of_raw_material
required
string (Type of Raw Material)

:General information - type of raw material used for blending of delivered product.
Input one type of raw material from the following selections:
Algae
Animal by-products (category 1)
Animal by-products (category 2)
Animal by-products (category 3)
Animal by-products (uncategorized)
Animal fats from rendering (category 1)
Animal fats from rendering (category 2)
Animal fats from rendering (category 3)
Animal fats from rendering (uncategorized)
Bagasse
Barley
Black liquor
Brown grease / grease trap fat
Brown liquor / spent sulphite liquor
Camelina
Cashew Nut Shell Liquid (CSNL)
Corn / Maize
Corn / Maize cobs
Cotton
Cotton seed
Crude glycerine
Crude tall oil (CTO)
Draff
Empty Palm Fruit Bunches (EFB) oil
Ethanol used in the cleaning/extraction of blood plasma
Ethanol used in the extraction of ingredients from medicinal plants
Fish Oil Ethyl Ester (FOEE)
Flower bulbs
Food waste
Forestry residues
Forestry processing residues
Fruit tree cuttings (from agriculture)
Giant cane
Grape marc
Grass
Husks
Jatropha
Manure
Municipal grass cuttings
Mustard / Carinata
Nut shells
Oat
Oil palm fresh fruit bunches (FFBs)
Olives
Organic municipal solid waste (MSW)
Palm Fatty Acid Distillate (PFAD)
Palm kernel shells (PKS)
Palm oil mill effluent (POME) oil
Pot ale
Poultry feather acid oil
Pressed palm fiber oil
Rapeseed / canola
Renewable component of end-of-life tyres
Residues from processing of corn/maize
Residue of FAME end distillation
Rye
Sewage sludge
Shea nuts
Short Rotation Coppice
Soapstock acid oil contaminated with sulphur
Sorghum
Soybean
Spent bleaching earth
Starch slurry (low grade)
Straw
Sugar beet
Sugar beet residues
Sugar beet betaine residues
Sugar cane
Sunflower
Tall oil pitch
Technical corn oil
Tiger nuts / Chuffa
Transesterification residues (TER)
Triticale
Used cooking oil (UCO) entirely of veg. origin
Used cooking oil (UCO)
Waste pressings (from production of vegetable oils)
Waste starch slurry
Waste starch slurry from distillation of grain mixtures
Wastewater from ship transport
Waste oil from sewage sludge treatment
Waste wood
Waste/residues from processing of alcohol
Waste/residues from processing of vegetable or animal oil
Wet manure
Wheat
Whey permeate
Wine lees
Woody biomass fraction of non-recycable industrial and municipal construction and demolition waste
Other: Specify if other
:Type of Raw Material
:General information - type of raw material used for blending of delivered product.
Input one type of raw material from the following selections:
Algae
Animal by-products (category 1)
Animal by-products (category 2)
Animal by-products (category 3)
Animal by-products (uncategorized)
Animal fats from rendering (category 1)
Animal fats from rendering (category 2)
Animal fats from rendering (category 3)
Animal fats from rendering (uncategorized)
Bagasse
Barley
Black liquor
Brown grease / grease trap fat
Brown liquor / spent sulphite liquor
Camelina
Cashew Nut Shell Liquid (CSNL)
Corn / Maize
Corn / Maize cobs
Cotton
Cotton seed
Crude glycerine
Crude tall oil (CTO)
Draff
Empty Palm Fruit Bunches (EFB) oil
Ethanol used in the cleaning/extraction of blood plasma
Ethanol used in the extraction of ingredients from medicinal plants
Fish Oil Ethyl Ester (FOEE)
Flower bulbs
Food waste
Forestry residues
Forestry processing residues
Fruit tree cuttings (from agriculture)
Giant cane
Grape marc
Grass
Husks
Jatropha
Manure
Municipal grass cuttings
Mustard / Carinata
Nut shells
Oat
Oil palm fresh fruit bunches (FFBs)
Olives
Organic municipal solid waste (MSW)
Palm Fatty Acid Distillate (PFAD)
Palm kernel shells (PKS)
Palm oil mill effluent (POME) oil
Pot ale
Poultry feather acid oil
Pressed palm fiber oil
Rapeseed / canola
Renewable component of end-of-life tyres
Residues from processing of corn/maize
Residue of FAME end distillation
Rye
Sewage sludge
Shea nuts
Short Rotation Coppice
Soapstock acid oil contaminated with sulphur
Sorghum
Soybean
Spent bleaching earth
Starch slurry (low grade)
Straw
Sugar beet
Sugar beet residues
Sugar beet betaine residues
Sugar cane
Sunflower
Tall oil pitch
Technical corn oil
Tiger nuts / Chuffa
Transesterification residues (TER)
Triticale
Used cooking oil (UCO) entirely of veg. origin
Used cooking oil (UCO)
Waste pressings (from production of vegetable oils)
Waste starch slurry
Waste starch slurry from distillation of grain mixtures
Wastewater from ship transport
Waste oil from sewage sludge treatment
Waste wood
Waste/residues from processing of alcohol
Waste/residues from processing of vegetable or animal oil
Wet manure
Wheat
Whey permeate
Wine lees
Woody biomass fraction of non-recycable industrial and municipal construction and demolition waste
Other: Specify if other
:NA
:Input one type of raw material from the following selections:
Algae
Animal by-products (category 1)
Animal by-products (category 2)
Animal by-products (category 3)
Animal by-products (uncategorized)
Animal fats from rendering (category 1)
Animal fats from rendering (category 2)
Animal fats from rendering (category 3)
Animal fats from rendering (uncategorized)
Bagasse
Barley
Black liquor
Brown grease / grease trap fat
Brown liquor / spent sulphite liquor
Camelina
Cashew Nut Shell Liquid (CSNL)
Corn / Maize
Corn / Maize cobs
Cotton
Cotton seed
Crude glycerine
Crude tall oil (CTO)
Draff
Empty Palm Fruit Bunches (EFB) oil
Ethanol used in the cleaning/extraction of blood plasma
Ethanol used in the extraction of ingredients from medicinal plants
Fish Oil Ethyl Ester (FOEE)
Flower bulbs
Food waste
Forestry residues
Forestry processing residues
Fruit tree cuttings (from agriculture)
Giant cane
Grape marc
Grass
Husks
Jatropha
Manure
Municipal grass cuttings
Mustard / Carinata
Nut shells
Oat
Oil palm fresh fruit bunches (FFBs)
Olives
Organic municipal solid waste (MSW)
Palm Fatty Acid Distillate (PFAD)
Palm kernel shells (PKS)
Palm oil mill effluent (POME) oil
Pot ale
Poultry feather acid oil
Pressed palm fiber oil
Rapeseed / canola
Renewable component of end-of-life tyres
Residues from processing of corn/maize
Residue of FAME end distillation
Rye
Sewage sludge
Shea nuts
Short Rotation Coppice
Soapstock acid oil contaminated with sulphur
Sorghum
Soybean
Spent bleaching earth
Starch slurry (low grade)
Straw
Sugar beet
Sugar beet residues
Sugar beet betaine residues
Sugar cane
Sunflower
Tall oil pitch
Technical corn oil
Tiger nuts / Chuffa
Transesterification residues (TER)
Triticale
Used cooking oil (UCO) entirely of veg. origin
Used cooking oil (UCO)
Waste pressings (from production of vegetable oils)
Waste starch slurry
Waste starch slurry from distillation of grain mixtures
Wastewater from ship transport
Waste oil from sewage sludge treatment
Waste wood
Waste/residues from processing of alcohol
Waste/residues from processing of vegetable or animal oil
Wet manure
Wheat
Whey permeate
Wine lees
Woody biomass fraction of non-recycable industrial and municipal construction and demolition waste
Other: Specify if other

pos_additional_information
string or null (Additional Information)

:General information - additional information if available
:Additional Information
:General information - additional information if available
:NA
:NA

pos_country_of_origin_of_the_raw_material
required
string (Country of Origin (of the raw material))

:General information - country of origin of raw material collection point
:Country of Origin (of the raw material)
:General information - country of origin of raw material collection point
:NA
:NA

pos_quantity
required
number <double> (Quantity)

:General information - quantity of goods
:Quantity
:General information - quantity of goods
:NA
:Numerical digits only

pos_quantity_unit
required
string (Quantity Unit (m3/mt))
Enum: "m3" "mt"

:General information - unit of quantity of goods.
Input 'm3' or 'mt', where m3 = m3/15°C and mt = metric tons.
:Quantity Unit
:General information - unit of quantity of goods.
Input 'm3' or 'mt', where m3 = m3/15°C and mt = metric tons.
:NA
:Drop-down selection:
m3
mt

pos_energy_content
required
number <double> (Energy content (MJ))

:General information - energy content in megajoules (MJ).
Multiplication of Quantity * Type of Product's Energy * 1000.
:Energy content (MJ)
:General information - energy content in megajoules (MJ).
Multiplication of Quantity * Type of Product's Energy * 1000.
:NA
:Numerical digits only

pos_eu_red_compliant_material
required
boolean (EU RED Compliant Material)

:General information - EU RED compliant material.
EU RED refers to European Renewable Energy Directive.
Explanations: The claim “EU RED Compliant” means that the entire upstream supply chain, including cultivation or collection of the raw material, is certified under a voluntary scheme that is recognised in the framework of the RED. Sustainable material has to be considered “EU RED Compliant” if the ISCC certified operator receives deliveries from suppliers that are certified under any recognised voluntary certification scheme. Please see ISCC EU System Document 203 for further information.
:EU RED Compliant Material
:General information - EU RED compliant material.
EU RED refers to European Renewable Energy Directive.
Explanations: The claim “EU RED Compliant” means that the entire upstream supply chain, including cultivation or collection of the raw material, is certified under a voluntary scheme that is recognised in the framework of the RED. Sustainable material has to be considered “EU RED Compliant” if the ISCC certified operator receives deliveries from suppliers that are certified under any recognised voluntary certification scheme. Please see ISCC EU System Document 203 for further information.
:NA
:NA

pos_iscc_compliant_material
required
boolean (ISCC Compliant Material)

:General information - ISCC compliant material.
ISCC refers to International Sustainability and Carbon Certification.
Explanations: The claim “ISCC Compliant” means that the entire upstream supply chain, including the cultivation or collection of the raw material is certified according to ISCC, and the material used in the supply chain consists entirely and solely of ISCC material, at least on a quantity bookkeeping basis. The statement “ISCC Compliant” can only be made if the ISCC certified operator has received an equivalent amount of incoming material with the statement “ISCC Compliant” on the Sustainability Declaration. Please see ISCC EU System. Document 203 for further information.
:ISCC Compliant Material
:General information - ISCC compliant material.
ISCC refers to International Sustainability and Carbon Certification.
Explanations: The claim “ISCC Compliant” means that the entire upstream supply chain, including the cultivation or collection of the raw material is certified according to ISCC, and the material used in the supply chain consists entirely and solely of ISCC material, at least on a quantity bookkeeping basis. The statement “ISCC Compliant” can only be made if the ISCC certified operator has received an equivalent amount of incoming material with the statement “ISCC Compliant” on the Sustainability Declaration. Please see ISCC EU System. Document 203 for further information.
:NA
:NA

pos_chain_of_custody_option
required
string (Chain of Custody Option (Mass Balance/Physical Segregation))
Enum: "Mass Balance" "Physical Segregation"

:General information - chain of custody option
:Chain of Custody Option
:General information - chain of custody option
:NA
:Drop-down selection:
Mass Balance
Physical Segregation

pos_the_raw_material_complies_with_the_relevant_sustainability_criteria
required
boolean (The raw material complies with the relevant sustainability criteria according to Art. 29 (2) - (7) RED II)

:Scope of certification of raw material - the raw material complies with the relevant sustainability criteria according to Art. 29 (2) - (7) RED II.
Explanations: Applicable to agricultural and forest biomass including residues from agricultural, aquaculture, fisheries and forestry.
:The raw material complies with the relevant sustainability criteria according to Art. 29 (2) - (7) RED II
:Scope of certification of raw material - the raw material complies with the relevant sustainability criteria according to Art. 29 (2) - (7) RED II.
Explanations: Applicable to agricultural and forest biomass including residues from agricultural, aquaculture, fisheries and forestry.
:NA
:NA

pos_the_agricultural_biomass_was_cultivated_as_intermediate_crop
required
boolean (The agricultural biomass was cultivated as intermediate crop (if applicable))

:Scope of certification of raw material - the agricultural biomass was cultivated as intermediate crop (if applicable)
:The agricultural biomass was cultivated as intermediate crop (if applicable)
:Scope of certification of raw material - the agricultural biomass was cultivated as intermediate crop (if applicable)
:NA
:NA

pos_the_agricultural_biomass_additionally_fulfills_the_measures_for_low_iluc_risk_feedstocks
required
boolean (The agricultural biomass additionally fulfills the measures for low ILUC risk feedstocks (if applicable))

:Scope of certification of raw material - the agricultural biomass additionally fulfills the measures for low ILUC risk feedstocks (if applicable)
:The agricultural biomass additionally fulfills the measures for low ILUC risk feedstocks (if applicable)
:Scope of certification of raw material - the agricultural biomass additionally fulfills the measures for low ILUC risk feedstocks (if applicable)
:NA
:NA

pos_the_raw_material_meets_the_definition_of_waste_or_residue_according_to_the_red_ii
required
boolean (The raw material meets the definition of waste or residue according to the RED II)

:Scope of certification of raw material - the raw material meets the definition of waste or residue according to the RED II4.
Explanations: Applicable to waste and residues and products produced from waste and residues.
:The raw material meets the definition of waste or residue according to the RED II
:Scope of certification of raw material - the raw material meets the definition of waste or residue according to the RED II4.
Explanations: Applicable to waste and residues and products produced from waste and residues.
:NA
:NA

pos_total_default_value_according_to_red_ii_applied
required
boolean (Total default value according to RED II applied)

:Greenhouse Gas (GHG) emission information - total default value according to RED II applied.
:Total default value according to RED II applied
:Greenhouse Gas (GHG) emission information - total default value according to RED II applied.
:NA
:NA

pos_e
required
number <double> (E (gCO2eq/MJ))

:Greenhouse Gas (GHG) emission information - E(gCO2eq/MJ).
E refers to total GHG emissions from supply and use of the fuel.

IF Total default value according to RED II applied = Yes
THEN input available value in gCO2eq/MJ
ELSE input value in gCO2eq/MJ base on calculation where E = Eec + El + Ep + Etd + Eu - Esca - Eccs - Eccr
:E (gCO2eq/MJ)
:Greenhouse Gas (GHG) emission information - E(gCO2eq/MJ).
E refers to total GHG emissions from supply and use of the fuel.

IF Total default value according to RED II applied = Yes
THEN input available value in gCO2eq/MJ
ELSE input value in gCO2eq/MJ base on calculation where E = Eec + El + Ep + Etd + Eu - Esca - Eccs - Eccr
:NA
:Numerical digits only

pos_eec
number or null <double> (Eec (gCO2eq/MJ))

:Greenhouse Gas (GHG) emission information - Eec (gCO2eq/MJ).
Eec refers to GHG emissions from the extraction or cultivation of raw materials.
:Eec (gCO2eq/MJ)
:Greenhouse Gas (GHG) emission information - Eec (gCO2eq/MJ).
Eec refers to GHG emissions from the extraction or cultivation of raw materials.
:NA
:Numerical digits only

pos_ei
number or null <double> (EI (gCO2eq/MJ))

:Greenhouse Gas (GHG) emission information - EI (gCO2eq/MJ).
EI refers to annualized (over 20 years) GHG emissions from carbon stock change due to land use change.
:EI (gCO2eq/MJ)
:Greenhouse Gas (GHG) emission information - EI (gCO2eq/MJ).
EI refers to annualized (over 20 years) GHG emissions from carbon stock change due to land use change.
:NA
:Numerical digits only

pos_ep
number or null <double> (Ep (gCO2eq/MJ))

:Greenhouse Gas (GHG) emission information - Ep (gCO2eq/MJ).
Ep refers to GHG emissions from processing.
:Ep (gCO2eq/MJ)
:Greenhouse Gas (GHG) emission information - Ep (gCO2eq/MJ).
Ep refers to GHG emissions from processing.
:NA
:Numerical digits only

pos_etd
number or null <double> (Etd (gCO2eq/MJ))

:Greenhouse Gas (GHG) emission information - Etd (gCO2eq/MJ).
Etd refers to GHG emissions from transport and distribution. Etd includes downstream emissions for distribution up to and including the filling station.
:Etd (gCO2eq/MJ)
:Greenhouse Gas (GHG) emission information - Etd (gCO2eq/MJ).
Etd refers to GHG emissions from transport and distribution. Etd includes downstream emissions for distribution up to and including the filling station.
:NA
:Numerical digits only

pos_eu
number or null <double> (Eu (gCO2eq/MJ))

:Greenhouse Gas (GHG) emission information - Eu (gCO2eq/MJ).
Eu refers to GHG emissions from the fuel in use.
Explanations: Emissions of non-CO2 greenhouse gases (N2O and CH4) of the fuel in use must be included in the Eu factor for bioliquids and biomass fuels.
:Eu (gCO2eq/MJ)
:Greenhouse Gas (GHG) emission information - Eu (gCO2eq/MJ).
Eu refers to GHG emissions from the fuel in use.
Explanations: Emissions of non-CO2 greenhouse gases (N2O and CH4) of the fuel in use must be included in the Eu factor for bioliquids and biomass fuels.
:NA
:Numerical digits only

pos_esca
number or null <double> (Esca (gCO2eq/MJ))

:Greenhouse Gas (GHG) emission information - Esca (gCO2eq/MJ).
Esca refers to GHG emissions savings from soil carbon accumulation via improved agricultural management.
:Esca (gCO2eq/MJ)
:Greenhouse Gas (GHG) emission information - Esca (gCO2eq/MJ).
Esca refers to GHG emissions savings from soil carbon accumulation via improved agricultural management.
:NA
:Numerical digits only

pos_eccs
number or null <double> (Eccs (gCO2eq/MJ))

:Greenhouse Gas (GHG) emission information - Eccs (gCO2eq/MJ).
Eccs refers to GHG emissions savings from carbon capture and geological storage.
:Eccs (gCO2eq/MJ)
:Greenhouse Gas (GHG) emission information - Eccs (gCO2eq/MJ).
Eccs refers to GHG emissions savings from carbon capture and geological storage.
:NA
:Numerical digits only

pos_eccr
number or null <double> (Eccr (gCO2eq/MJ))

:Greenhouse Gas (GHG) emission information - Eccr (gCO2eq/MJ)
Eccr refers to GHG emissions savings from carbon capture and replacement
:Eccr (gCO2eq/MJ)
:Greenhouse Gas (GHG) emission information - Eccr (gCO2eq/MJ)
Eccr refers to GHG emissions savings from carbon capture and replacement
:NA
:Numerical digits only

pos_date_when_the_final_biofuel_bioliquid_or_biomass_producer_started_operation
required
string <date> (Date when the final biofuel, bioliquid or biomass producer started operation)

:Greenhouse Gas (GHG) emission information - date when the final biofuel, bioliquid or biomass producer started operation.
Explanations: An installation shall be considered to be in operation once the physical production of fuel, heat or cooling, or electricity has started (i.e. once the production of fuels. including biofuels, biogas or bioliquids, or production of heat, cooling or electricity from biomass fuels has started). (see Article 29 (10) Renewable Energy Directive (EU) 2018/2001).
:Date when the final biofuel, bioliquid or biomass producer started operation
:Greenhouse Gas (GHG) emission information - date when the final biofuel, bioliquid or biomass producer started operation.
Explanations: An installation shall be considered to be in operation once the physical production of fuel, heat or cooling, or electricity has started (i.e. once the production of fuels. including biofuels, biogas or bioliquids, or production of heat, cooling or electricity from biomass fuels has started). (see Article 29 (10) Renewable Energy Directive (EU) 2018/2001).
:NA
:date (YYYY-MM-DD)

pos_for_biogas_supply_chains_were_incentives_subsidies_received_for_the_production_of_the_biogas
boolean or null (For biogas supply chains: Were incentives/subsidies received for the production of the biogas?)

:Greenhouse Gas (GHG) emission information - for biogas supply chains: were incentives/subsidies received for the production of the biogas?
:For biogas supply chains: Were incentives/subsidies received for the production of the biogas?
:Greenhouse Gas (GHG) emission information - for biogas supply chains: were incentives/subsidies received for the production of the biogas?
:NA
:NA

pos_for_biogas_supply_chains_if_subsidies_incentives_were_received_please_specify
string or null (For biogas supply chains: If subsidies/incentives were received, please specify)

:Greenhouse Gas (GHG) emission information - for biogas supply chains: if subsidies/incentives were received, please specify
:For biogas supply chains: If subsidies/incentives were received, please specify
:Greenhouse Gas (GHG) emission information - for biogas supply chains: if subsidies/incentives were received, please specify
:NA
:NA

required
Array of objects (Attachments)
{
  • "pos_unique_number_of_the_pos": "string",
  • "pos_date_of_issuance_of_the_pos": "2019-08-24",
  • "pos_supplier_name": "string",
  • "pos_supplier_address": "string",
  • "pos_certification_system": "ISCC EU",
  • "pos_certificate_number": "string",
  • "pos_recipient_name": "string",
  • "pos_recipient_address": "string",
  • "pos_contract_number": "string",
  • "pos_address_of_dispatch_shipping_point_of_the_sustainable_material": "string",
  • "pos_address_of_receipt_receiving_point_of_the_sustainable_material": "string",
  • "pos_date_of_dispatch_of_the_sustainable_material": "2019-08-24",
  • "pos_type_of_product": "string",
  • "pos_type_of_raw_material": "string",
  • "pos_additional_information": "string",
  • "pos_country_of_origin_of_the_raw_material": "string",
  • "pos_quantity": 0.1,
  • "pos_quantity_unit": "m3",
  • "pos_energy_content": 0.1,
  • "pos_eu_red_compliant_material": true,
  • "pos_iscc_compliant_material": true,
  • "pos_chain_of_custody_option": "Mass Balance",
  • "pos_the_raw_material_complies_with_the_relevant_sustainability_criteria": true,
  • "pos_the_agricultural_biomass_was_cultivated_as_intermediate_crop": true,
  • "pos_the_agricultural_biomass_additionally_fulfills_the_measures_for_low_iluc_risk_feedstocks": true,
  • "pos_the_raw_material_meets_the_definition_of_waste_or_residue_according_to_the_red_ii": true,
  • "pos_total_default_value_according_to_red_ii_applied": true,
  • "pos_e": 0.1,
  • "pos_eec": 0.1,
  • "pos_ei": 0.1,
  • "pos_ep": 0.1,
  • "pos_etd": 0.1,
  • "pos_eu": 0.1,
  • "pos_esca": 0.1,
  • "pos_eccs": 0.1,
  • "pos_eccr": 0.1,
  • "pos_date_when_the_final_biofuel_bioliquid_or_biomass_producer_started_operation": "2019-08-24",
  • "pos_for_biogas_supply_chains_were_incentives_subsidies_received_for_the_production_of_the_biogas": true,
  • "pos_for_biogas_supply_chains_if_subsidies_incentives_were_received_please_specify": "string",
  • "attachments": [
    ]
}

Purchase Order

Data Element ID: purchase_order_po

po_no
required
string (PO Number)

:PO Number
:PO Number
:PO Number
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

po_vessel_nm
required
string (Vessel Name)

:Name of Vessel
:Vessel Name
:Name of Vessel
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

po_vessel_imo
string or null (Vessel IMO)

:Vessel IMO
:Vessel IMO
:Vessel IMO
:IMO
:7 characters, Numeric

po_req_delivery_dt
string or null <date-time> (Requested Delivery Date)

:Requested Delivery Date
:Requested Delivery Date
:Requested Delivery Date
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

po_vessel_eta
string or null <date-time> (Vessel ETA)

:Estimated Time of Arrival (ETA) at vessel
:Vessel ETA
:Estimated Time of Arrival (ETA) at vessel
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

po_job_coordinator
string or null (Job Coordinator)

:Job Coordinator
:Job Coordinator
:Job Coordinator
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

po_job_coordinator_contact
string or null (Job Coordinator Contact)

:Job Coordinator Contact
:Job Coordinator Contact
:Job Coordinator Contact
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

po_supplier_nm
required
string (Supplier Name)

:Supplier Name
:Supplier Name
:Supplier Name
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

po_supplier_contact
string or null (Supplier Contact)

:Supplier Contact
:Supplier Contact
:Supplier Contact
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

Array of objects or null (Line Item)

:Line Item
:Line Item
:Line Item
:NA
:NA

po_dt
string or null <date-time> (PO Date)

:PO Date
:PO Date
:PO Date
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

po_total_price
number or null <double> (Total Price)

:Total price for the order
:Total Price
:Total price for the order
:NA
:Numeric Digits Only

po_payment_terms
number or null <double> (Payment Terms)

:Payment Terms in Days
:Payment Terms
:Payment Terms in Days
:NA
:Numeric Digits Only

po_delivery_instructions
string or null (Delivery Instructions)

:Additional delivery instructions or remarks
:Delivery Instructions
:Additional delivery instructions or remarks
:NA
:

po_req_delivery_port
string or null (Requested Delivery Port)

:Requested Delivery Port
:Requested Delivery Port
:Requested Delivery Port
:NA
:

Array of objects or null (Purchase Order (PO) Attachment)

:Purchase Order (PO) Attachment
:Purchase Order (PO) Attachment
:Purchase Order (PO) Attachment
:NA
:.JPEG/.PNG/.TIFF/.PDF

{
  • "po_no": "string",
  • "po_vessel_nm": "string",
  • "po_vessel_imo": "string",
  • "po_req_delivery_dt": "2019-08-24T14:15:22Z",
  • "po_vessel_eta": "2019-08-24T14:15:22Z",
  • "po_job_coordinator": "string",
  • "po_job_coordinator_contact": "string",
  • "po_supplier_nm": "string",
  • "po_supplier_contact": "string",
  • "po_lineitem": [
    ],
  • "po_dt": "2019-08-24T14:15:22Z",
  • "po_total_price": 0.1,
  • "po_payment_terms": 0.1,
  • "po_delivery_instructions": "string",
  • "po_req_delivery_port": "string",
  • "attachments": [
    ]
}

Standby Letter Of Credit

Data Element ID: standby_letter_of_credit

sblc_transaction_ref_no
required
string (Sblc Transaction Ref No)

:20 : Transaction Reference Number. When the message is sent to issue a guarantee, this field must specify the guarantee number. When the message is sent to request the Receiver to issue a guarantee, this field must contain the reference of the request, as assigned by the Sender.
:Transaction Reference Number
:SWIFT MT 760 Field Transaction Reference Number When the message is sent to issue a guarantee, this field must specify the guarantee number. When the message is sent to request the Receiver to issue a guarantee, this field must contain the reference of the request, as assigned by the Sender. This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

sblc_further_identification
required
string (Sblc Further Identification)

:23 : Further Identification. This field further identifies the purpose of the message.
:Further Identification
:SWIFT MT 760 Field 23 : Further Identification This field further identifies the purpose of the message. This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

sblc_dt
string or null <date> (Sblc Dt)

:30 : Date. When the message is sent to issue a guarantee, this field specifies the issue date of the guarantee. When the message is sent to request the Receiver to issue a guarantee, this field specifies the date of the request.
:Date
:SWIFT MT 760 Field 30 : Date When the message is sent to issue a guarantee, this field specifies the issue date of the guarantee. When the message is sent to request the Receiver to issue a guarantee, this field specifies the date of the request. This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:date (YYYY-MM-DD)

required
Array of objects (Attachments) non-empty

:NA
:Standby Letter of Credit Attachment
:Standby Letter of Credit Attachment
:NA
:NA

{
  • "sblc_transaction_ref_no": "string",
  • "sblc_further_identification": "string",
  • "sblc_dt": "2019-08-24",
  • "attachments": [
    ]
}

Test Certificate (Quality)

Data Element ID: test_certificate

tc_job_no
required
string (Tc Job No)

:Job Number
:Job Number
:Job Number
:ISO 17025
:NA

tc_sample_no
required
string (Tc Sample No)

:Sample Number
:Sample Number
:Sample Number
:ISO 17025
:NA

tc_location_or_terminal
required
string (Tc Location Or Terminal)

:Location / Terminal
:Location/Terminal
:Location/Terminal
:ISO 17025
:NA

tc_sample_product_nm
required
string (Tc Sample Product Nm)

:Name of product sample
:Name of Product Sample
:Name of Product Sample
:ISO 17025
:NA

tc_source_of_sample
required
string (Tc Source Of Sample)

:Sample Source (e.g., shore tank)
:Sample Source
:Sample Source, for example: shore tank
:ISO 17025
:NA

tc_type_of_sample
required
string (Tc Type Of Sample)

:Type of Sample
:Type of Sample
:Type of Sample, for example: before loading
:ISO 17025
:NA

tc_summary_of_sample
required
string (Tc Summary Of Sample)

:Sample Summary
:Sample Summary
:Sample Summary
:ISO 17025
:NA

tc_sample_sampled_dt
required
string <date> (Tc Sample Sampled Dt)

:Sample Sampled Date
:Sample Sampled Date
:Sample Sampled Date
:ISO 17025/ ISO 8601
:ISO Date Format (YYYY-MM-DD)

tc_sample_received_dt
required
string <date> (Tc Sample Received Dt)

:Sample Date Received
:Sample Date Received
:Sample Date Received
:ISO 17025/ ISO 8601
:ISO Date Format (YYYY-MM-DD)

tc_sample_tested_dt
required
string <date> (Tc Sample Tested Dt)

:Sample Date Tested
:Sample Date Tested
:Sample Date Tested
:ISO 17025/ ISO 8601
:ISO Date Format (YYYY-MM-DD)

tc_sample_reported_dt
required
string <date> (Tc Sample Reported Dt)

:Sample Date Reported
:Sample Date Reported
:Sample Date Reported
:ISO 17025/ ISO 8601
:ISO Date Format (YYYY-MM-DD)

required
Array of objects (Tc Results) non-empty

:NA
:Test Certificate (Quality) Results
:Test Certificate (Quality) Results
:ISO 17025
:NA

tc_surveyor_company_nm
required
string (Tc Surveyor Company Nm)

:Surveyor Company Name
:Surveyor Company Name
:Surveyor Company Name
:ISO 17025
:NA

required
Array of objects (Attachments) non-empty

:NA
:Test Certificate Quality Attachment
:Test Certificate (Quality) Attachment
:ISO 17025
:.PDF format

{
  • "tc_job_no": "string",
  • "tc_sample_no": "string",
  • "tc_location_or_terminal": "string",
  • "tc_sample_product_nm": "string",
  • "tc_source_of_sample": "string",
  • "tc_type_of_sample": "string",
  • "tc_summary_of_sample": "string",
  • "tc_sample_sampled_dt": "2019-08-24",
  • "tc_sample_received_dt": "2019-08-24",
  • "tc_sample_tested_dt": "2019-08-24",
  • "tc_sample_reported_dt": "2019-08-24",
  • "tc_results": [
    ],
  • "tc_surveyor_company_nm": "string",
  • "attachments": [
    ]
}

Vessel Current Position

Data Element ID: vessel_current_position

Array of objects or null (Vessel Particulars Information)

:Particulars of the vessel

Note: Only latest data is available where applicable.
:Vessel Particulars Information
:Particulars of the vessel

Note: Only latest data is available where applicable.
:NA
:NA

vessel_source
string or null (Source)

:Source of data

Note: Only latest data is available where applicable.
:Source
:Source of data

Note: Only latest data is available where applicable.
:NA
:NA

vessel_destination_code
string or null (Destination Code)

:International standard port code, also known as UN/LOCODE, e.g. SGSIN

Note: Only latest data is available where applicable.
:Destination Code
:International standard port code, also known as UN/LOCODE, e.g. SGSIN

Note: Only latest data is available where applicable.
:NA
:NA

vessel_destination
string or null (Destination)

:Destination, e.g. CHANGJIANGKOU

Note: Only latest data is available where applicable.
:Destination
:Destination, e.g. CHANGJIANGKOU

Note: Only latest data is available where applicable.
:NA
:NA

vessel_standardised_destination
string or null (Standardised Destination)

:Standardised Destination, e.g. CHANGJIANGKOU,CN

Note: Only latest data is available where applicable.
:Standardised Destination
:Standardised Destination, e.g. CHANGJIANGKOU,CN

Note: Only latest data is available where applicable.
:NA
:NA

vessel_eta_dt
string or null <date-time> (Vessel ETA)

:Estimated Time of Arrival (ETA)

Note: Only latest data is available where applicable.
:Vessel ETA
:Estimated Time of Arrival (ETA)

Note: Only latest data is available where applicable.
:NA
:0

vessel_length
integer or null <int64> (Length of the Vessel)

:Length of the Vessel

Note: Only latest data is available where applicable.
:Length of the Vessel
:Length of the Vessel

Note: Only latest data is available where applicable.
:0
:NA

vessel_depth
integer or null <int64> (Depth of the Vessel)

:Vertical distance measured from the top of the keel (the bottom-most part of the ship) to the top of the deck at the side of the vessel.
It indicates the overall height of the ship's hull.

Note: This field may return NULL or 0 as it is not a mandatory field.
:Depth of the Vessel
:Vertical distance measured from the top of the keel (the bottom-most part of the ship) to the top of the deck at the side of the vessel.
It indicates the overall height of the ship's hull.

Note: This field may return NULL or 0 as it is not a mandatory field.
:NA
:NA

vessel_draught
integer or null <int64> (Draught of the Vessel)

:Vertical distance from the waterline to the bottom of the keel.
It represents how deep the ship sits in the water and is crucial for determining the minimum depth of water a ship can safely navigate.

Note: This field may return NULL or 0 as it is not a mandatory field.
:Draught of the Vessel
:Vertical distance from the waterline to the bottom of the keel.
It represents how deep the ship sits in the water and is crucial for determining the minimum depth of water a ship can safely navigate.

Note: This field may return NULL or 0 as it is not a mandatory field.
:NA
:NA

vessel_type
string or null (Type of the Vessel)

:Type of the Vessel

Note: Only latest data is available where applicable.
:Type of the Vessel
:Type of the Vessel

Note: Only latest data is available where applicable.
:NA
:NA

vessel_grosstonnage
integer or null <int64> (Gross Tonnage of the Vessel)

:Gross Tonnage of the Vessel

Note: Only latest data is available where applicable.
:Gross Tonnage of the Vessel
:Gross Tonnage of the Vessel

Note: Only latest data is available where applicable.
:NA
:NA

vessel_nettonnage
integer or null <int64> (Net Tonnage of the Vessel)

:Net Tonnage of the Vessel

Note: Only latest data is available where applicable.
:Net Tonnage of the Vessel
:Net Tonnage of the Vessel

Note: Only latest data is available where applicable.
:NA
:NA

vessel_deadweight
integer or null <int64> (Dead Weight of the Vessel)

:Dead Weight of the Vessel

Note: Only latest data is available where applicable.
:Dead Weight of the Vessel
:Dead Weight of the Vessel

Note: Only latest data is available where applicable.
:NA
:NA

vessel_mmsi_number
integer or null <int64> (MMSI Number of the Vessel)

:Maritime Mobile Service Identity (MMSI) Vessel Identification Number

Note: This field may return NULL as it is not a mandatory field.
:MMSI Number of the Vessel
:Maritime Mobile Service Identity (MMSI) Vessel Identification Number

Note: This field may return NULL as it is not a mandatory field.
:NA
:9 characters, Numeric

vessel_year_built
integer or null <int64> (The year in which the vessel has been built)

:The year in which the vessel has been built

Note: Only latest data is available where applicable.
:The year in which the vessel has been built
:The year in which the vessel has been built

Note: Only latest data is available where applicable.
:NA
:NA

vessel_latitude
number or null <double> (Latitude)

:Latitude

Note: Only latest data is available where applicable.
:Latitude
:Latitude

Note: Only latest data is available where applicable.
:ISO 6709
:NA

vessel_longitude
number or null <double> (Longitude)

:Longitude

Note: Only latest data is available where applicable.
:Longitude
:Longitude

Note: Only latest data is available where applicable.
:ISO 6709
:NA

vessel_latitude_degrees
number or null <double> (Latitude Degrees)

:Latitude Degrees

Note: Only latest data is available where applicable.
:Latitude Degrees
:Latitude Degrees

Note: Only latest data is available where applicable.
:NA
:NA

vessel_longitude_degrees
number or null <double> (Longitude Degrees)

:Longitude Degrees

Note: Only latest data is available where applicable.
:Longitude Degrees
:Longitude Degrees

Note: Only latest data is available where applicable.
:NA
:NA

vessel_speed
number or null <double> (Speed)

:Speed

Note: Only latest data is available where applicable.
:Speed
:Speed

Note: Only latest data is available where applicable.
:NA
:NA

vessel_course
number or null <double> (Course)

:Course

Note: Only latest data is available where applicable.
:Course
:Course

Note: Only latest data is available where applicable.
:NA
:NA

vessel_heading
number or null <double> (Heading)

:Heading

Note: Only latest data is available where applicable.
:Heading
:Heading

Note: Only latest data is available where applicable.
:NA
:NA

vessel_navigation_status
string or null (Navigation Status)

:Navigation Status

Note: Only latest data is available where applicable.
:Navigation Status
:Navigation Status

Note: Only latest data is available where applicable.
:NA
:NA

vessel_time_stamp
string or null <date-time> (Last Update Time)

:Last Update Time

Note: Only latest data is available where applicable.
:Last Update Time
:Last Update Time

Note: Only latest data is available where applicable.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

{
  • "vessel_particulars": [
    ],
  • "vessel_source": "string",
  • "vessel_destination_code": "string",
  • "vessel_destination": "string",
  • "vessel_standardised_destination": "string",
  • "vessel_eta_dt": "2019-08-24T14:15:22Z",
  • "vessel_length": 0,
  • "vessel_depth": 0,
  • "vessel_draught": 0,
  • "vessel_type": "string",
  • "vessel_grosstonnage": 0,
  • "vessel_nettonnage": 0,
  • "vessel_deadweight": 0,
  • "vessel_mmsi_number": 0,
  • "vessel_year_built": 0,
  • "vessel_latitude": 0.1,
  • "vessel_longitude": 0.1,
  • "vessel_latitude_degrees": 0.1,
  • "vessel_longitude_degrees": 0.1,
  • "vessel_speed": 0.1,
  • "vessel_course": 0.1,
  • "vessel_heading": 0.1,
  • "vessel_navigation_status": "string",
  • "vessel_time_stamp": "2019-08-24T14:15:22Z"
}

Vessel Information

Data Element ID: vessel_information

required
Array of objects (Vessel Particulars Information) non-empty

:Particulars of the vessel, Note: For push, only latest data is available where applicable. For pull, only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Particulars Information
:Particulars of the vessel, Note: For push, only latest data is available where applicable. For pull, only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_ism_manager
string or null (ISM Manager (If vessel flag is 'SG'))

:International Safety Management Manager, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISM Manager (If vessel flag is 'SG')
:International Safety Management Manager, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_ship_manager
string or null (Ship Manager (if vessel flag is 'SG'))

:Ship Manager, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Ship Manager (if vessel flag is 'SG')
:Ship Manager, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_registered_ownership
string or null (Registered Ownership (if vessel flag is 'SG'))

:Registered Ownership, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Registered Ownership (if vessel flag is 'SG')
:Registered Ownership, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_classification_society
string or null (Classification Society (if vessel flag is 'SG'))

:Classification Society, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Classification Society (if vessel flag is 'SG')
:Classification Society, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_registration_status
string or null (Registration Status)

:Registration Status , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Registration Status
:Registration Status , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_registration_dt
string or null <date-time> (Registration Date)

:Registration Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Registration Date
:Registration Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_validity_dt
string or null <date-time> (Validity Date)

:Validity Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Validity Date
:Validity Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_date_of_closure
string or null <date-time> (Date of Closure)

:Date of Closure, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Date of Closure
:Date of Closure, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_vessel_certificate_no
string or null (Certificate Number)

:Certificate Number , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Certificate Number
:Certificate Number , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_issue_dt
string or null <date-time> (Issue Date)

:Issue Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Issue Date
:Issue Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_movement_start_dt
string or null <date-time> (Movement Start Date and Time)

:Movement Start Date and Time, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Start Date and Time
:Movement Start Date and Time, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_movement_end_dt
string or null <date-time> (Movement End Date and Time)

:Movement End Date and Time, Note: Business Exception Scenario #1: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'A', this field will return a NULL as vessel is due to arrive Business Exception Scenario #2: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'D', this field will return a NULL as vessel is due to depart Business Exception Scenario #3: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'I', this field will return a NULL as vessel is in port and moving For push, only latest data is available. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement End Date and Time
:Movement End Date and Time, Note: Business Exception Scenario #1: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'A', this field will return a NULL as vessel is due to arrive Business Exception Scenario #2: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'D', this field will return a NULL as vessel is due to depart Business Exception Scenario #3: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'I', this field will return a NULL as vessel is in port and moving For push, only latest data is available. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_movement_status
string or null (Movement Status)

:Movement Status, Note: This field will return 'C','O' where each where each letters indicates as follow: 'C' - Close, 'O' - Open., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Status
:Movement Status, Note: This field will return 'C','O' where each where each letters indicates as follow: 'C' - Close, 'O' - Open., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_movement_type
string or null (Movement Type)

:Movement Type, Note: This field will return 'A','D','I','T' where each letters indicates as follow: 'A' - Arrival, 'D' - Departure, 'I' - Intraport, 'T'- Transit., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Type
:Movement Type, Note: This field will return 'A','D','I','T' where each letters indicates as follow: 'A' - Arrival, 'D' - Departure, 'I' - Intraport, 'T'- Transit., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location_from_cd
required
string (Location From Code)

:Location Code of the location from data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location From Code
:Location Code of the location from data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location_to_cd
string or null (Location To Code)

:Location Code of the location to data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location To Code
:Location Code of the location to data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location_from
required
string (Location From)

:Location From , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location From
:Location From , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location_to
string or null (Location To)

:Location To, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location To
:Location To, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_movement_draft
number or null (Movement Draft)

:Movement Draft , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Draft
:Movement Draft , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_movement_height
number or null (Movement Height)

:Movement Height , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Height
:Movement Height , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_arrived_dt
string or null <date-time> (Vessel Arrived Time)

:The Reported Arrival Time, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if vessel is due to arrival OR is not in port. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Arrived Time
:The Reported Arrival Time, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if vessel is due to arrival OR is not in port. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_purpose
string or null (Vessel Purpose)

:The purpose field is a comma-separated value (CSV) field, where each value is a Yes(Y)/No(N) indicator in the following sequence. #1 indicator - Loading / Unloading Cargo #2 indicator - Loading / Unloading Passengers #3 indicator - Taking Bunker #4 indicator - Taking Ship Supplies #5 indicator - Changing Crew #6 indicator - Shipyard Repair #7 indicator - Offshore Support #8 indicator - Not Used #9 indicator - Other Afloat Activities , Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Purpose
:The purpose field is a comma-separated value (CSV) field, where each value is a Yes(Y)/No(N) indicator in the following sequence. #1 indicator - Loading / Unloading Cargo #2 indicator - Loading / Unloading Passengers #3 indicator - Taking Bunker #4 indicator - Taking Ship Supplies #5 indicator - Changing Crew #6 indicator - Shipyard Repair #7 indicator - Offshore Support #8 indicator - Not Used #9 indicator - Other Afloat Activities , Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location_cd
string or null (Location Code)

:Location Code of the location data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location Code
:Location Code of the location data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location
string or null (Vessel Location)

:Location of the vessel, Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Location
:Location of the vessel, Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_grid
string or null (Vessel Grid)

:Grid of the Vessel, Note: For push, only latest data is available where applicable. For pull, this field will return NULL unless vessel is at anchorage. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Grid
:Grid of the Vessel, Note: For push, only latest data is available where applicable. For pull, this field will return NULL unless vessel is at anchorage. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_arrival_agent
string or null (Agent of the Arrival Vessel)

:Agent of the Arrival Vessel, Note: For push, only latest data is available where applicable. For pull, this field returns results if vessel has arrived and vessel_arrived_dt is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Agent of the Arrival Vessel
:Agent of the Arrival Vessel, Note: For push, only latest data is available where applicable. For pull, this field returns results if vessel has arrived and vessel_arrived_dt is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_due_to_arrive_dt
string or null <date-time> (Vessel Due to Arrive Time)

:Vessel Due to Arrive Time , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_arrived_dt" is not NULL as vessel has arrived. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Due to Arrive Time
:Vessel Due to Arrive Time , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_arrived_dt" is not NULL as vessel has arrived. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_departed_dt
string or null <date-time> (Vessel Departed Time)

:Reported departed time , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if vessel is not in port. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Departed Time
:Reported departed time , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if vessel is not in port. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_departure_agent
string or null (Agent of the Departure Vessel)

:Agent of the Departure Vessel, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Agent of the Departure Vessel
:Agent of the Departure Vessel, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_due_to_depart_dt
string or null <date-time> (Vessel Due to Depart)

:Vessel Due to Depart , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Due to Depart
:Vessel Due to Depart , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_next_port
string or null (Next Port)

:Next Port, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Next Port
:Next Port, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_next_port_of_call_country
string or null (Next Port of Call Country)

:Next Port of Call Country, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Next Port of Call Country
:Next Port of Call Country, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_cargo
number or null (Cargo)

:Cargo, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Cargo
:Cargo, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_cert_issue_dt
string or null <date-time> (Date and Time of Certificate Issue)

:Date and Time of Certificate Issue, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Date and Time of Certificate Issue
:Date and Time of Certificate Issue, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_expiry_dt_of_port_certificate
string or null <date-time> (Expiry Date and Time of Port Certificate)

:Expiry Date and Time of Port Certificate , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Expiry Date and Time of Port Certificate
:Expiry Date and Time of Port Certificate , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_master_nm
string or null (Master Name)

:Master Name , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Master Name
:Master Name , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_datetime_of_querying
required
string <date-time> (Querying Date Time)

:This field is used only for querying of vessel event data
:Querying Date Time
:This field is used only for querying of vessel event data
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

{
  • "vessel_particulars": [
    ],
  • "vessel_ism_manager": "string",
  • "vessel_ship_manager": "string",
  • "vessel_registered_ownership": "string",
  • "vessel_classification_society": "string",
  • "vessel_registration_status": "string",
  • "vessel_registration_dt": "2019-08-24T14:15:22Z",
  • "vessel_validity_dt": "2019-08-24T14:15:22Z",
  • "vessel_date_of_closure": "2019-08-24T14:15:22Z",
  • "vessel_vessel_certificate_no": "string",
  • "vessel_issue_dt": "2019-08-24T14:15:22Z",
  • "vessel_movement_start_dt": "2019-08-24T14:15:22Z",
  • "vessel_movement_end_dt": "2019-08-24T14:15:22Z",
  • "vessel_movement_status": "string",
  • "vessel_movement_type": "string",
  • "vessel_location_from_cd": "string",
  • "vessel_location_to_cd": "string",
  • "vessel_location_from": "string",
  • "vessel_location_to": "string",
  • "vessel_movement_draft": 0,
  • "vessel_movement_height": 0,
  • "vessel_arrived_dt": "2019-08-24T14:15:22Z",
  • "vessel_purpose": "string",
  • "vessel_location_cd": "string",
  • "vessel_location": "string",
  • "vessel_grid": "string",
  • "vessel_arrival_agent": "string",
  • "vessel_due_to_arrive_dt": "2019-08-24T14:15:22Z",
  • "vessel_departed_dt": "2019-08-24T14:15:22Z",
  • "vessel_departure_agent": "string",
  • "vessel_due_to_depart_dt": "2019-08-24T14:15:22Z",
  • "vessel_next_port": "string",
  • "vessel_next_port_of_call_country": "string",
  • "vessel_cargo": 0,
  • "vessel_cert_issue_dt": "2019-08-24T14:15:22Z",
  • "vessel_expiry_dt_of_port_certificate": "2019-08-24T14:15:22Z",
  • "vessel_master_nm": "string",
  • "vessel_datetime_of_querying": "2019-08-24T14:15:22Z"
}

Meter Reading Record Form

Data Element ID: meter_reading_record_form

bunkerMeteringTicketNo
required
string (Bunker Metering Ticket (BMT) No.)

:Mass flow metering ticket number for each bunker delivery
:Bunker Metering Ticket (BMT) No.
:Mass flow metering ticket number for each bunker delivery
:NA
:Alphanumeric Characters Only

meterSerialNumber
required
integer <int64> (Meter Serial No.)

:Serial number on bunker meter
:Meter Serial No.
:Serial number on bunker meter
:NA
:

bunkerTankerName
required
string (Bunker Tanker Name)

:Name of the bunker tanker
:Bunker Tanker Name
:Name of the bunker tanker
:NA
:Min character = 1, max characters = 35 Alphanumeric

receiveVesselName
required
string (Receiving Vessel Name)

:Name of receiving vessel
:Receiving Vessel Name
:Name of receiving vessel
:NA
:Min character = 1, max characters = 35 Alphanumeric

vesselSufficientTankSpaceForPurging
required
boolean (Vessel sufficient tank space for purging)

:
:Vessel sufficient tank space for purging
:
:NA
:

required
object (Section A - Before Delivery)

:
:Section A - Before Delivery
:
:NA
:Nested Data Structure for data in Section A of MRRFD

required
object (Section B - After Delivery)

:
:Section B - After Delivery
:
:NA
:Nested Data Structure for data in Section B of MRRFD

Array of objects (Attachments)
{
  • "bunkerMeteringTicketNo": "string",
  • "meterSerialNumber": 0,
  • "bunkerTankerName": "string",
  • "receiveVesselName": "string",
  • "vesselSufficientTankSpaceForPurging": true,
  • "sectionA-BeforeDelivery": {
    },
  • "sectionB-AfterDelivery": {
    },
  • "attachments": [
    ]
}

Meter Totaliser Log

Data Element ID: meter_totaliser_log

required
Array of objects (Meter Totaliser Log) non-empty

:Meter Totaliser Log array
:Meter Totaliser Log
:Meter Totaliser Log array
:NA
:

Array of objects (Attachments)
{
  • "mtl": [
    ],
  • "attachments": [
    ]
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

:Note
:Note
:Note
:NA
:NA

Array of objects or null (Other Documents Attachment)

:Other Documents Attachment
:Other Documents Attachment
:Other Documents Attachment
:NA
:NA

{
  • "note": "string",
  • "attachments": [
    ]
}

Use Case C (Parameters)

Parameter schemas for Use Case C

Barge Bunkering Event

Data Element ID: barge_event_data

barge_bdn_no
required
Array of strings (Barge Bdn No)

BDN Number

barge_bunker_supplier_company_nm
required
Array of strings (Barge Bunker Supplier Company Nm)

Bunker Supplier Company Name

{
  • "barge_bdn_no": [
    ],
  • "barge_bunker_supplier_company_nm": [
    ]
}

Bunker Delivery Note

Data Element ID: bunker_delivery_note

bdn_sb_no
required
string (Bunker Tanker License Number)

Bunker Tanker License Number. The format for license number should be SB NNNNA

bdn_no
required
string (Bunker Delivery Note Number)

Bunker Delivery Note Number

bdn_bunker_metering_ticket_no
integer or null <int64> (Bunker Metering Ticket Number (BTN))

Bunker Metering Ticket Number (BTN)

bdn_dt
required
string <date> (Date of Operation)

Date of Operation

bunkerMeteringTicketNo
string or null (Bunker Metering Ticket (BMT) No.)

Mass flow metering ticket number for each bunker delivery

{
  • "bdn_sb_no": "string",
  • "bdn_no": "string",
  • "bdn_bunker_metering_ticket_no": 0,
  • "bdn_dt": "2019-08-24",
  • "bunkerMeteringTicketNo": "string"
}

Bunker Delivery Report (B2G)

Data Element ID: bunker_delivery_report

vendorUen
string or null (Vendor UEN)

Unique Entity Number (UEN) of the vendor registered with ACRA. Mandatory if interface is via Service Agent

bunkerTankerLicenceNo
string or null (Bunker Tanker Licence Number)

Bunker barge licence number in "SB NNNNA" format from MFM

bunkerTankerName
required
string (Bunker Tanker Name)

Bunker barge name returned from the Bunker Barge Information API

bunkerMeteringTicketNo
required
string (Bunker Metering Ticket Number)

Bunker metering ticket number from the MFM. Mandatory if the delivery type is "1"

bunkerSupplierName
string or null (Bunker Supplier Name)

Bunker Supplier Company name

bdnNo
string or null (Bunker Delivery Note Number)

Bunker Supplier BDN No

operationDate
required
string <date> (Operation Date)

Date of operation in "YYYY-MM-DD" format from MFM

{
  • "vendorUen": "string",
  • "bunkerTankerLicenceNo": "string",
  • "bunkerTankerName": "string",
  • "bunkerMeteringTicketNo": "string",
  • "bunkerSupplierName": "string",
  • "bdnNo": "string",
  • "operationDate": "2019-08-24"
}

Bunker Loading Report (B2G)

Data Element ID: bunker_loading_report

vendorUen
string or null (Vendor UEN)

Unique Entity Number (UEN) of the vendor registered with ACRA. Mandatory if interface is via Service Agent

bunkerTankerLicenceNo
string or null (Bunker Tanker Licence Number)

Bunker barge licence number in "SB NNNNA" format from MFM

bunkerTankerName
string or null (Bunker Tanker Name)

Bunker barge name returned from the Bunker Barge Information API

bunkerMeteringTicketNo
string or null (Bunker Metering Ticket Number)

Bunker metering ticket number from the MFM. Mandatory if the load type is "1"

operationDate
required
string <date> (Operation Date)

Date of operation in "YYYY-MM-DD" format

{
  • "vendorUen": "string",
  • "bunkerTankerLicenceNo": "string",
  • "bunkerTankerName": "string",
  • "bunkerMeteringTicketNo": "string",
  • "operationDate": "2019-08-24"
}

Bunker Quantity Survey

Data Element ID: bunker_quantity_survey

bqs_job_no
required
string (Bqs Job No)

Unique report/ job number for the survey

bqs_dt
string or null (Bqs Dt)

Date the survey is being conducted

{
  • "bqs_job_no": "string",
  • "bqs_dt": "string"
}

Bunker STS Delivery Report (B2G)

Data Element ID: bunker_sts_delivery_report

vendorUen
string or null (Vendor UEN)

Unique Entity Number (UEN) of the vendor registered with ACRA. Mandatory if interface is via Service Agent

bunkerTankerLicenceNo
string or null (Bunker Tanker Licence Number)

Bunker barge licence number in "SB NNNNA" format from the MFM

bunkerTankerName
string or null (Bunker Tanker Name)

Bunker barge name returned from the Bunker Barge Information API

bunkerMeteringTicketNo
string or null (Bunker Metering Ticket Number)

Bunker metering ticket number from the MFM. Mandatory if the transfer type is "1"

operationDate
required
string <date> (Operation Date)

Date of operation in "YYYY-MM-DD" format

{
  • "vendorUen": "string",
  • "bunkerTankerLicenceNo": "string",
  • "bunkerTankerName": "string",
  • "bunkerMeteringTicketNo": "string",
  • "operationDate": "2019-08-24"
}

Bunkering Sales Confirmation

Data Element ID: bunkering_sales_confirmation

bsc_confirmation_no
required
string (Bsc Confirmation No)

Bunkering Sales Confirmation Number

{
  • "bsc_confirmation_no": "string"
}

Bunkering Sales Contract (Delivered)

Data Element ID: sales_contract_lbs_bunkerbuyer

contract_lbsbb_contract_no
required
string (Contract Lbsbb Contract No)

Bunkering Sales Contract Number/Agreement Number (Delivered)

contract_lbsbb_trade_no
string or null (Contract Lbsbb Trade No)

Trade Number/Trade ID of Bunkering Sales Contract (Delivered)

{
  • "contract_lbsbb_contract_no": "string",
  • "contract_lbsbb_trade_no": "string"
}

Bunkering Sales Contract (Ex-Wharf)

Data Element ID: sales_contract_cargotrader_lbs

One of
contract_ctlbs_contract_no
required
Array of strings (Contract Ctlbs Contract No)

Sales Contract Number/ Agreement Number

Example
{
  • "contract_ctlbs_contract_no": [
    ]
}

Bunkering Sales Invoice (Delivered)

Data Element ID: sales_invoice_lbs_bunkerbuyer

invoice_lbsbb_sales_contract_no
required
string (Invoice Lbsbb Sales Contract No)

Bunkering Sales Contract Number/Agreement Number (Delivered)

invoice_lbsbb_trade_no
string or null (Invoice Lbsbb Trade No)

Trade Number/Trade ID of Bunkering Sales Invoice (Delivered)

{
  • "invoice_lbsbb_sales_contract_no": "string",
  • "invoice_lbsbb_trade_no": "string"
}

Bunkering Sales Invoice (Ex-Wharf)

Data Element ID: sales_invoice_cargotrader_lbs

invoice_ctlbs_invoice_no
required
Array of strings (Invoice Ctlbs Invoice No)

Invoice Number

invoice_ctlbs_trade_no
required
Array of strings (Invoice Ctlbs Trade No)

Trade Number/ Trade ID

{
  • "invoice_ctlbs_invoice_no": [
    ],
  • "invoice_ctlbs_trade_no": [
    ]
}

Certificate Of Quality

Data Element ID: certificate_of_quality

coq_sample_no
required
Array of strings (Coq Sample No)

Sample Number

{
  • "coq_sample_no": [
    ]
}

Certificate Of Quantity

Data Element ID: certificate_of_quantity

cq_order_no
required
Array of strings (Cq Order No)

Order Number

cq_doc_no
required
Array of strings (Cq Doc No)

Certificate of Quantity / Document Number

{
  • "cq_order_no": [
    ],
  • "cq_doc_no": [
    ]
}

Delivery Nomination

Data Element ID: delivery_nomination

dn_bunker_tanker_nm
required
string (Bunker Tanker Name)

Bunker Tanker Name

dn_sb_no
string or null (Bunker Tanker License Number)

Bunker Tanker License Number. The format for license number should be SB NNNNA

dn_delivery_dt
string or null <date> (Delivery Date)

Expected Delivery Date

{
  • "dn_bunker_tanker_nm": "string",
  • "dn_sb_no": "string",
  • "dn_delivery_dt": "2019-08-24"
}

Letter Of Credit

Data Element ID: letter_of_credit

lc_dt_of_issue
required
string <date> (Lc Doc Lc No)
{
  • "lc_dt_of_issue": "2019-08-24"
}

Mass Flow Meter Receipt

Data Element ID: mfm

mfm_sb_no
required
string (Mfm Sb No)

Bunker Tanker License Number. The format for license number should be SB NNNNA

mfm_btn_no
required
number (Mfm Btn No)

Bunker Metering Ticket Number (BTN)

mfm_print_out_dt
required
string <date-time> (Mfm Print Out Dt)

Printout Time

{
  • "mfm_sb_no": "string",
  • "mfm_btn_no": 0,
  • "mfm_print_out_dt": "2019-08-24T14:15:22Z"
}

Oil Cargo Bill of Lading

Data Element ID: bill_of_lading

bl_doc_no
string or null (Bl Doc No)
bl_dt
required
string <date> (Bl Doc No)
{
  • "bl_doc_no": "string",
  • "bl_dt": "2019-08-24"
}

Proof of Sustainability

Data Element ID: proof_of_sustainability

pos_supplier_name
required
string (Supplier Name)

Supplier - Name

{
  • "pos_supplier_name": "string"
}

Purchase Order

Data Element ID: purchase_order_po

po_no
required
string (PO Number)

PO Number

{
  • "po_no": "string"
}

Test Certificate (Quality)

Data Element ID: test_certificate

tc_sample_no
required
Array of strings (Tc Sample No)

Sample Number

{
  • "tc_sample_no": [
    ]
}

Vessel Current Position

Data Element ID: vessel_current_position

One of
vessel_nm
required
string (Receiving Vessel Name)

Name of the Vessel

Note: Only latest data is available where applicable.

Example
{
  • "vessel_nm": "string"
}

Vessel Information

Data Element ID: vessel_information

vessel_imo_no
required
string (International Maritime Organisation Number)

International Maritime Organisation (IMO) Vessel Identification Number, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).

vessel_datetime_of_querying
required
string <date-time> (Querying Date Time)

This field is used only for querying of vessel event data

{
  • "vessel_imo_no": "string",
  • "vessel_datetime_of_querying": "2019-08-24T14:15:22Z"
}

Meter Reading Record Form

Data Element ID: meter_reading_record_form

bdnNo
string (Bunker Delivery Note (BDN) Number)

Bunker Supplier BDN No

bunkerTankerName
required
string (Bunker Tanker Name)

Name of the bunker tanker

bunkerMeteringTicketNo
string (Bunker Metering Ticket (BMT) No.)

Mass flow metering ticket number for each bunker delivery

{
  • "bdnNo": "string",
  • "bunkerTankerName": "string",
  • "bunkerMeteringTicketNo": "string"
}

Meter Totaliser Log

Data Element ID: meter_totaliser_log

month
string (month)

month

bunkerTankerName
required
string (Bunker Tanker Name)

Name of the bunker tanker

bunkerMeteringTicketNo
string (Bunker Metering Ticket (BMT) No.)

Mass flow metering ticket number for each bunker delivery

{
  • "month": "string",
  • "bunkerTankerName": "string",
  • "bunkerMeteringTicketNo": "string"
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

Note

{
  • "note": "string"
}

Use Case D (Payload)

Payload schemas for Use Case D

Agrifood Purchase Order

Data Element ID: agrifood_purchase_order

apo_id
required
number (ID)

ID

apo_role
string or null (Role)

Role

apo_user_id
number or null (User ID)

User ID

apo_currency
string or null (Currency)

Currency

apo_buyer
number or null (Buyer)

Buyer

apo_buyer_reference_number
string or null (Buyer Reference Number)

Buyer Reference Number

apo_po_number_buyer
string or null (Purchase Order Number- Buyer)

Purchase Order Number- Buyer

apo_supplier
number or null (Supplier)

Supplier

apo_supplier_reference_number
string or null (Supplier Reference Number)

Supplier Reference Number

apo_po_number_supplier
string or null (Purchase Order Number- Supplier)

Purchase Order Number- Supplier

apo_trade_contract_number
string or null (Trade Contract Number)

Trade Contract Number

apo_pack_plan_name
string or null (Pack Plan Name)

Pack Plan Name

apo_payment_supplier
string or null (Payment-Supplier)

Payment-Supplier

apo_incoterms_supplier
string or null (Incoterms-Supplier)

Incoterms-Supplier

apo_payment_buyer
string or null (Payment-Buyer)

Payment-Buyer

apo_incoterms_buyer
string or null (Incoterms- Buyer)

Incoterms- Buyer

apo_status
required
string (Status)

Status

apo_serial_id
number or null (Serial ID)

Serial ID

apo_created_at
string or null <date-time> (Created At)

Created At

apo_updated_at
string or null <date-time> (Updated At)

Updated At

apo_company_id
number or null (Company ID)

Company ID

apo_notes
string or null (Notes)

Notes

apo_active
required
number (Active)

Active, 1= Active 0= Not Active

apo_usd_exchange_rate
number or null <double> (Exchange Rate to USD)

Exchange Rate to USD

apo_related_contract_id
number or null (Related Trade Contract ID)

Related Trade Contract ID

apo_group_id
number or null (Group ID)

Group ID

apo_trader_group_id
number or null (Trader Group ID)

Trader Group ID

apo_supplier_group_id
number or null (Supplier Group ID)

Supplier Group ID

apo_buyer_group_id
string or null (Buyer Group ID)

Buyer Group ID

apo_counterparty_email_buyer
string or null (Counterparty Email Buyer)

Counterparty Email Buyer

apo_counterparty_email_supplier
string or null (Counterparty Email Supplier)

Counterparty Email Supplier

Array of objects or null (Attachments)
{
  • "apo_id": 0,
  • "apo_role": "string",
  • "apo_user_id": 0,
  • "apo_currency": "string",
  • "apo_buyer": 0,
  • "apo_buyer_reference_number": "string",
  • "apo_po_number_buyer": "string",
  • "apo_supplier": 0,
  • "apo_supplier_reference_number": "string",
  • "apo_po_number_supplier": "string",
  • "apo_trade_contract_number": "string",
  • "apo_pack_plan_name": "string",
  • "apo_payment_supplier": "string",
  • "apo_incoterms_supplier": "string",
  • "apo_payment_buyer": "string",
  • "apo_incoterms_buyer": "string",
  • "apo_status": "string",
  • "apo_serial_id": 0,
  • "apo_created_at": "2019-08-24T14:15:22Z",
  • "apo_updated_at": "2019-08-24T14:15:22Z",
  • "apo_company_id": 0,
  • "apo_notes": "string",
  • "apo_active": 0,
  • "apo_usd_exchange_rate": 0.1,
  • "apo_related_contract_id": 0,
  • "apo_group_id": 0,
  • "apo_trader_group_id": 0,
  • "apo_supplier_group_id": 0,
  • "apo_buyer_group_id": "string",
  • "apo_counterparty_email_buyer": "string",
  • "apo_counterparty_email_supplier": "string",
  • "attachments": [
    ]
}

Delivery Order

Data Element ID: delivery_order

do_buyer_company_address
required
string (Buyer Company Address )

:Registered Company address of document Recipient
:Buyer Company Address
:Registered Company address of document Recipient
:NA
:NA

do_buyer_company_name
required
string (Buyer Company Name )

:Registered Company name of document Recipient
:Buyer Company Name
:Registered Company name of document Recipient
:NA
:NA

do_date
required
string <date> (Date )

:Date of issuance of delivery order
:Date
:Date of issuance of delivery order
:NA
:NA

do_delivery_address
required
string (Delivery Address )

:Delivery address of receiver
:Delivery Address
:Delivery address of receiver
:NA
:NA

required
Array of objects (Item Details)

:Item Details
:Item Details
:Item Details
:NA
:NA

do_number
required
string (Delivery Order Number)

:Unique identifier for delivery order
:Delivery Order Number
:Unique identifier for delivery order
:NA
:NA

do_seller_company_address
required
string (Seller’s Company Address )

:Registered Company address of document Issuer
:Seller’s Company Address
:Registered Company address of document Issuer
:NA
:NA

do_seller_company_name
required
string (Seller’s Company Name )

:Registered Company name of document Issuer
:Seller’s Company Name
:Registered Company name of document Issuer
:NA
:NA

do_seller_registration_number
required
string (Seller Registration)

:Registration number of Company
:Seller Registration
:Registration number of Company
:NA
:NA

do_delivery_from
string or null (Deliver From )

:Delivery address of sender
:Deliver From
:Delivery address of sender
:NA
:NA

do_invoice_number
string or null (Invoice Number )

:Unique identifier for invoice referred in delivery order
:Invoice Number
:Unique identifier for invoice referred in delivery order
:NA
:NA

do_lc_number
string or null (Letter Of Credit Number )

:Unique identifier for letter of credit applicable to delivery order
:Letter Of Credit Number
:Unique identifier for letter of credit applicable to delivery order
:NA
:NA

Array of objects or null (Delivery Order Attachment)

:Delivery Order Attachment
:Delivery Order Attachment
:Delivery Order Attachment
:NA
:NA

{
  • "do_buyer_company_address": "string",
  • "do_buyer_company_name": "string",
  • "do_date": "2019-08-24",
  • "do_delivery_address": "string",
  • "do_item_details": [
    ],
  • "do_number": "string",
  • "do_seller_company_address": "string",
  • "do_seller_company_name": "string",
  • "do_seller_registration_number": "string",
  • "do_delivery_from": "string",
  • "do_invoice_number": "string",
  • "do_lc_number": "string",
  • "attachments": [
    ]
}

Goods Receipt

Data Element ID: goods_receipt

gr_seller_company_name
required
string (Seller Company Name )

:Registered Company name of Supplier
:Seller Company Name
:Registered Company name of Supplier
:NA
:NA

gr_seller_company_address
required
string (Seller Company Address )

:Registered Company address of Supplier
:Seller Company Address
:Registered Company address of Supplier
:NA
:NA

gr_buyer_company_name
required
string (Buyer Company Name )

:Registered Company name of Buyer
:Buyer Company Name
:Registered Company name of Buyer
:NA
:NA

gr_procurement_type
required
string (Procurement Type )

:Procurement type e.g. Goods
:Procurement Type
:Procurement type e.g. Goods
:NA
:NA

gr_number
required
string (Goods Receipt No. )

:Unique Identifier for Goods Receipt
:Goods Receipt No.
:Unique Identifier for Goods Receipt
:NA
:NA

gr_delivery_address
required
string (Delivery Address )

:Delivery address of receiver
:Delivery Address
:Delivery address of receiver
:NA
:NA

gr_delivery_date
required
string <date> (Delivery Date )

:Date of delivery of goods
:Delivery Date
:Date of delivery of goods
:NA
:NA

required
Array of objects (Item Details)

:Line-level details within Goods Receipt
:Item Details
:Line-level details within Goods Receipt
:NA
:NA

Array of objects or null (Goods Receipt Attachment)

:Goods Receipt Attachment
:Goods Receipt Attachment
:Goods Receipt Attachment
:NA
:NA

{
  • "gr_seller_company_name": "string",
  • "gr_seller_company_address": "string",
  • "gr_buyer_company_name": "string",
  • "gr_procurement_type": "string",
  • "gr_number": "string",
  • "gr_delivery_address": "string",
  • "gr_delivery_date": "2019-08-24",
  • "gr_item_details": [
    ],
  • "attachments": [
    ]
}

Green Building Certification

Data Element ID: green_building_certification

gbc_name_certificate_issuer
required
string (Registered Name of Certification Issuer )

:Registered Name of Certification Issuer
:Registered Name of Certification Issuer
:Registered Name of Certification Issuer
:NA
:0

gbc_name_certified_company
required
string (Registered Name of Certified Company )

:Registered Name of Certified Company
:Registered Name of Certified Company
:Registered Name of Certified Company
:NA
:0

gbc_certified_project
required
string (Registered Name of Certified Project )

:Registered Name of Certified Project
:Registered Name of Certified Project
:Registered Name of Certified Project
:NA
:0

gbc_address_certified_location
required
string (Registered Address of Certified Location )

:Registered Address of Certified Location
:Registered Address of Certified Location
:Registered Address of Certified Location
:NA
:0

gbc_postcode_certified_location
string or null (Postcode of Certified Location)

:Postcode of Certified Location
:Postcode of Certified Location
:Postcode of Certified Location
:NA
:0

gbc_application_stage
required
string (Status of the application for certification)

:Status of the application for certification
:Status of the application for certification
:Status of the application for certification
:NA
:0

gbc_application_status
required
string (Status of the application for certification)

:Status of the application for certification
:Status of the application for certification
:Status of the application for certification
:NA
:0

gbc_certification_provisional_rating
required
string (Certification Provisional Rating / Rating )

:Certification Provisional Rating / Rating
:Certification Provisional Rating / Rating
:Certification Provisional Rating / Rating
:NA
:0

gbc_green_mark_sle_rating
string or null (Green Mark SLE Rating)

:Green Mark SLE Rating
:Green Mark SLE Rating
:Green Mark SLE Rating
:NA
:0

gbc_certification_score
string or null (Certification Score )

:Certification Score
:Certification Score
:Certification Score
:NA
:0

gbc_certification_number
string or null (Certification Number )

:Certification Number
:Certification Number
:Certification Number
:NA
:0

gbc_certification_issue_date
string or null (Certification Issue Date )

:Certification Issue Date
:Certification Issue Date
:Certification Issue Date
:NA
:0

gbc_certification_expiration_date
string or null <date> (Certification Expiration Date )

:Certification Expiration Date
:Certification Expiration Date
:Certification Expiration Date
:NA
:0

gbc_date_document_issue
string or null (Document Issue Date )

:Document Issue Date
:Document Issue Date
:Document Issue Date
:NA
:0

gbc_date_document_expiration
string or null (Document Expiration Date )

:Document Expiration Date
:Document Expiration Date
:Document Expiration Date
:NA
:0

gbc_certification_scheme
string or null (Certification Scheme )

:Certification Scheme
:Certification Scheme
:Certification Scheme
:NA
:0

gbc_project_description
string or null (Project Description )

:Project Description
:Project Description
:Project Description
:NA
:0

gbc_project_gross_floor_area
string or null (Project Gross Floor Area )

:Project Gross Floor Area
:Project Gross Floor Area
:Project Gross Floor Area
:NA
:0

gbc_building_type
string or null (Building Type )

:Building Type
:Building Type
:Building Type
:NA
:0

gbc_total_property_area
string or null (Total Property Area )

:Total Property Area
:Total Property Area
:Total Property Area
:NA
:0

gbc_name_developer
string or null (Name of Developer )

:Name of Developer
:Name of Developer
:Name of Developer
:NA
:0

gbc_name_main_contractor
string or null (Name of Main Contractor )

:Name of Main Contractor
:Name of Main Contractor
:Name of Main Contractor
:NA
:0

gbc_additional_detail
string or null (Additional Details)

:Additional Details
:Additional Details
:Additional Details
:NA
:0

Array of objects or null (Green Building Certification Attachment)

:Green Building Certification Attachment
:Green Building Certification Attachment
:Green Building Certification Attachment
:NA
:0

{
  • "gbc_name_certificate_issuer": "string",
  • "gbc_name_certified_company": "string",
  • "gbc_certified_project": "string",
  • "gbc_address_certified_location": "string",
  • "gbc_postcode_certified_location": "string",
  • "gbc_application_stage": "string",
  • "gbc_application_status": "string",
  • "gbc_certification_provisional_rating": "string",
  • "gbc_green_mark_sle_rating": "string",
  • "gbc_certification_score": "string",
  • "gbc_certification_number": "string",
  • "gbc_certification_issue_date": "string",
  • "gbc_certification_expiration_date": "2019-08-24",
  • "gbc_date_document_issue": "string",
  • "gbc_date_document_expiration": "string",
  • "gbc_certification_scheme": "string",
  • "gbc_project_description": "string",
  • "gbc_project_gross_floor_area": "string",
  • "gbc_building_type": "string",
  • "gbc_total_property_area": "string",
  • "gbc_name_developer": "string",
  • "gbc_name_main_contractor": "string",
  • "gbc_additional_detail": "string",
  • "attachments": [
    ]
}

Green Product Certification

Data Element ID: green_product_certification

gpc_name_certificate_issuer
required
string (Name Of Certification Issuer )

:Registered Name of Certification Issuer
:Name Of Certification Issuer
:Registered Name of Certification Issuer
:NA
:NA

gpc_name_certified_company
required
string (Name Of Certified Company )

:Registered Name of Certified Company
:Name Of Certified Company
:Registered Name of Certified Company
:NA
:NA

gpc_address_certified_location
required
string (Address Of Certified Location )

:Registered Address of Certified Location
:Address Of Certified Location
:Registered Address of Certified Location
:NA
:NA

gpc_product_category
required
string (Product Category/Type )

:Product Category/Type
:Product Category/Type
:Product Category/Type
:NA
:NA

gpc_certification_number
required
string (Certification Number )

:Certification Number
:Certification Number
:Certification Number
:NA
:NA

gpc_date_certification_start_date
required
string <date> (Certification Start Date )

:Certification Start Date
:Certification Start Date
:Certification Start Date
:NA
:NA

gpc_date_certification_expiration
required
string <date> (Certification Expiration Date )

:Certification Expiration Date
:Certification Expiration Date
:Certification Expiration Date
:NA
:NA

cs_certification_standards
required
string (Certification Standards )

:Certification Standards
:Certification Standards
:Certification Standards
:NA
:NA

cs_name_certification_body
required
string (Name Of Certification Body )

:Registered Name of Certification Body
:Name Of Certification Body
:Registered Name of Certification Body
:NA
:NA

gpc_product_model
string or null (Product Model )

:Product Model
:Product Model
:Product Model
:NA
:NA

gpc_brand_name
string or null (Product Brand Name )

:Product Brand Name
:Product Brand Name
:Product Brand Name
:NA
:NA

gpc_product_certificate_label
string or null (Product Certificate Label)

:Product certificate label
:Product Certificate Label
:Product certificate label
:NA
:NA

gpc_certification_rating
string or null (Certification Rating )

:Certification Rating
:Certification Rating
:Certification Rating
:NA
:NA

gpc_date_certification_first_issue
string or null <date> (Certification First Issue Date )

:Certification First Issue Date
:Certification First Issue Date
:Certification First Issue Date
:NA
:NA

gpc_licence_number
string or null (License Number )

:License Number
:License Number
:License Number
:NA
:NA

gpc_certification_scheme
string or null (Certification Scheme )

:Certification Scheme
:Certification Scheme
:Certification Scheme
:NA
:NA

gpc_applicable_standards
string or null (Applicable Standards )

:Applicable Standards
:Applicable Standards
:Applicable Standards
:NA
:NA

gpc_additional_detail
string or null (Additional Detail 1 – X )

:Additional Detail
:Additional Detail 1 – X
:Additional Detail
:NA
:NA

Array of objects or null (Green Product Certification Attachment)

:Green Product Certification Attachment
:Green Product Certification Attachment
:Green Product Certification Attachment
:NA
:NA

{
  • "gpc_name_certificate_issuer": "string",
  • "gpc_name_certified_company": "string",
  • "gpc_address_certified_location": "string",
  • "gpc_product_category": "string",
  • "gpc_certification_number": "string",
  • "gpc_date_certification_start_date": "2019-08-24",
  • "gpc_date_certification_expiration": "2019-08-24",
  • "cs_certification_standards": "string",
  • "cs_name_certification_body": "string",
  • "gpc_product_model": "string",
  • "gpc_brand_name": "string",
  • "gpc_product_certificate_label": "string",
  • "gpc_certification_rating": "string",
  • "gpc_date_certification_first_issue": "2019-08-24",
  • "gpc_licence_number": "string",
  • "gpc_certification_scheme": "string",
  • "gpc_applicable_standards": "string",
  • "gpc_additional_detail": "string",
  • "attachments": [
    ]
}

Interim Certificate

Data Element ID: interim_certificate

ic_project
required
string (Project )

:Name or description of Project
:Project
:Name or description of Project
:NA
:NA

ic_project_reference
required
string (Project Reference )

:Unique identifier of project
:Project Reference
:Unique identifier of project
:NA
:NA

ic_certificate_no
required
string (Certificate No )

:Unique identifier for interim certificate
:Certificate No
:Unique identifier for interim certificate
:NA
:NA

ic_contractor
required
string (Contractor )

:Name of Contractor
:Contractor
:Name of Contractor
:NA
:NA

ic_original_main_contract_sum
required
string (Original Main Contract Sum )

:Sum of Main Contract
:Original Main Contract Sum
:Sum of Main Contract
:NA
:NA

ic_date_commencement
required
string <date> (Date Of Commencement )

:Date of commencement of work done
:Date Of Commencement
:Date of commencement of work done
:NA
:NA

ic_date_completion
required
string <date> (Date Of Completion )

:Date of completion of work done
:Date Of Completion
:Date of completion of work done
:NA
:NA

ic_value_work_done
required
string (Value Of Work Done )

:Total value of work done
:Value Of Work Done
:Total value of work done
:NA
:NA

ic_amount_due
required
number <double> (Amount Due )

:Total amount due prior to certification
:Amount Due
:Total amount due prior to certification
:NA
:NA

ic_date_certificate
string or null <date> (Date Of Certificate )

:Date of certificate issuance
:Date Of Certificate
:Date of certificate issuance
:NA
:NA

ic_date_valuation
string or null <date> (Date Of Valuation )

:Date of valuation performed
:Date Of Valuation
:Date of valuation performed
:NA
:NA

ic_retention_limit
string or null (Limit Of Retention )

:Retention Limit
:Limit Of Retention
:Retention Limit
:NA
:NA

ic_date_revised_completion
string or null <date> (Revised Completion Date )

:Revised date of completion of work done
:Revised Completion Date
:Revised date of completion of work done
:NA
:NA

ic_retention_sum
string or null (Retention Sum )

:Retention sum applicable for work done
:Retention Sum
:Retention sum applicable for work done
:NA
:NA

ic_release_first_half_retention_monies
string or null (Release Of The First Half Retention Monies )

:Retention Sum release amount
:Release Of The First Half Retention Monies
:Retention Sum release amount
:NA
:NA

ic_sums_previously_deducted
string or null (Sums Previously Deducted )

:Deduction amount of cumulative contract sum previously billed
:Sums Previously Deducted
:Deduction amount of cumulative contract sum previously billed
:NA
:NA

Array of objects or null (Interim Certificate Attachment)

:Interim Certificate Attachment
:Interim Certificate Attachment
:Interim Certificate Attachment
:NA
:NA

{
  • "ic_project": "string",
  • "ic_project_reference": "string",
  • "ic_certificate_no": "string",
  • "ic_contractor": "string",
  • "ic_original_main_contract_sum": "string",
  • "ic_date_commencement": "2019-08-24",
  • "ic_date_completion": "2019-08-24",
  • "ic_value_work_done": "string",
  • "ic_amount_due": 0.1,
  • "ic_date_certificate": "2019-08-24",
  • "ic_date_valuation": "2019-08-24",
  • "ic_retention_limit": "string",
  • "ic_date_revised_completion": "2019-08-24",
  • "ic_retention_sum": "string",
  • "ic_release_first_half_retention_monies": "string",
  • "ic_sums_previously_deducted": "string",
  • "attachments": [
    ]
}

Invoice Finance Application

Data Element ID: invoice_finance_application

ifa_bank_name
string (Bank )

:Name of Bank providing Trade Financing
:Bank
:Name of Bank providing Trade Financing
:NA
:NA

ifa_date
string <date> (Date )

:Date of application
:Date
:Date of application
:NA
:NA

ifa_applicant_name
string (Applicant )

:Name of applicant
:Applicant
:Name of applicant
:NA
:NA

ifa_applicant_contact_person
string (Contact Person )

:Name of contact person for applicant
:Contact Person
:Name of contact person for applicant
:NA
:NA

ifa_applicant_telephone_no
string (Telephone )

:Contact number of contact person
:Telephone
:Contact number of contact person
:NA
:NA

ifa_product
string (Trade Financing Product Name )

:Trade financing product name e.g. Invoice Financing (Purchase) or Invoice Financing (Sales)
:Trade Financing Product Name
:Trade financing product name e.g. Invoice Financing (Purchase) or Invoice Financing (Sales)
:NA
:NA

ifa_application_id
string (Trade Financing Application Id)

:Unique application reference number
:Trade Financing Application Id
:Unique application reference number
:NA
:NA

ifa_invoice_currency
string (Invoice Currency )

Currency unit in Invoice

ifa_tenor
string (Tenor )

:Tenor for trade financing
:Tenor
:Tenor for trade financing
:NA
:NA

ifa_finance_date_start
string <date> (Finance Start Date)

:Financing start date
:Finance Start Date
:Financing start date
:NA
:NA

ifa_finance_date_due
string <date> (Finance Due Date )

:Financing due date
:Finance Due Date
:Financing due date
:NA
:NA

ifa_percentage_financing
number <double> (Percentage Of Financing)

:Percentage of financing applicable (%)
:Percentage Of Financing
:Percentage of financing applicable (%)
:NA
:NA

ifa_instruction_proceed
string (Instruction On Proceeds)

:Instructions for treatment of proceeds
:Instruction On Proceeds
:Instructions for treatment of proceeds
:NA
:NA

ifa_payment_type
string (Payment Type )

:Mode of payment used for trade financing
:Payment Type
:Mode of payment used for trade financing
:NA
:NA

ifa_bearer_charges
string (Bearer Of Charges)

:Bearer of charges
:Bearer Of Charges
:Bearer of charges
:NA
:NA

ifa_counterparty_name
string (Name Of Counterparty)

:Name of Counterparty
:Name Of Counterparty
:Name of Counterparty
:NA
:NA

ifa_tt_remmitance_currency
string (Remittance Currency (Tt) )

:Currency unit used for remittance
:Remittance Currency (Tt)
:Currency unit used for remittance
:NA
:NA

ifa_tt_amount
number <double> (Amount (Tt) )

:Amount to be remitted
:Amount (Tt)
:Amount to be remitted
:NA
:NA

ifa_tt_beneficiary_account_no
string (Beneficiary Account Number (Tt) )

:Bank Account number of beneficiary
:Beneficiary Account Number (Tt)
:Bank Account number of beneficiary
:NA
:NA

ifa_tt_beneficiary_bank_name
string (Name Of Beneficiary Bank (Tt) )

:Name of beneficiary bank
:Name Of Beneficiary Bank (Tt)
:Name of beneficiary bank
:NA
:NA

ifa_tt_beneficiary_bank_address
string (Address Of Beneficiary Bank (Tt) )

:Address of beneficiary bank
:Address Of Beneficiary Bank (Tt)
:Address of beneficiary bank
:NA
:NA

ifa_tt_beneficiary_receiving_agent
string (Receiving Agent Of Beneficiary Bank (Tt) )

:Receiving Agent of Beneficiary's bank
:Receiving Agent Of Beneficiary Bank (Tt)
:Receiving Agent of Beneficiary's bank
:NA
:NA

ifa_co_beneficiary_name
string (Beneficiary Name (Co) )

:Name of beneficiary
:Beneficiary Name (Co)
:Name of beneficiary
:NA
:NA

ifa_financing_currency
string or null (Financing Currency )

:Financing Currency Unit
:Financing Currency
:Financing Currency Unit
:NA
:NA

ifa_port_loading
string or null (Port Of Loading )

:Name of port where goods were loaded
:Port Of Loading
:Name of port where goods were loaded
:NA
:NA

ifa_port_discharge
string or null (Port Of Discharge )

:Name of port where goods were discharged
:Port Of Discharge
:Name of port where goods were discharged
:NA
:NA

ifa_vessel_number
string or null (Vessel Imo Number )

:Unique Identifier for vessel (IMO)
:Vessel Imo Number
:Unique Identifier for vessel (IMO)
:NA
:NA

ifa_fx_contract_number
string or null (Fx Contract Number )

:Unique identifier for exchange rate contracts
:Fx Contract Number
:Unique identifier for exchange rate contracts
:NA
:NA

ifa_fx_rate
string or null (Fx Rate )

:FX contract rate to be applied
:Fx Rate
:FX contract rate to be applied
:NA
:NA

ifa_counterparty_address
string or null (Address Of Counterparty)

:Address of Counterparty
:Address Of Counterparty
:Address of Counterparty
:NA
:NA

ifa_co_beneficiary_account_name
string or null (Account Name (Co) )

:Bank Account name of beneficiary
:Account Name (Co)
:Bank Account name of beneficiary
:NA
:NA

ifa_co_beneficiary_account_number
string or null (Account Number (Co) )

:Bank Account number of beneficiary
:Account Number (Co)
:Bank Account number of beneficiary
:NA
:NA

ifa_co_other_instructions
string or null (Other Instructions (Co) )

:Other applicable instructions for payment
:Other Instructions (Co)
:Other applicable instructions for payment
:NA
:NA

ifa_tt_beneficiary_bank_swift_code
string or null (Swift Code- Beneficiary Bank (Tt))

:Swift Code- Beneficiary Bank (Tt)
:Swift Code- Beneficiary Bank (Tt)
:Swift Code- Beneficiary Bank (Tt)
:NA
:NA

ifa_co_beneficiary_bank_swift_code
string or null

Swift Code- Beneficiary Bank (Co)

{
  • "ifa_bank_name": "string",
  • "ifa_date": "2019-08-24",
  • "ifa_applicant_name": "string",
  • "ifa_applicant_contact_person": "string",
  • "ifa_applicant_telephone_no": "string",
  • "ifa_product": "string",
  • "ifa_application_id": "string",
  • "ifa_invoice_currency": "string",
  • "ifa_tenor": "string",
  • "ifa_finance_date_start": "2019-08-24",
  • "ifa_finance_date_due": "2019-08-24",
  • "ifa_percentage_financing": 0.1,
  • "ifa_instruction_proceed": "string",
  • "ifa_payment_type": "string",
  • "ifa_bearer_charges": "string",
  • "ifa_counterparty_name": "string",
  • "ifa_tt_remmitance_currency": "string",
  • "ifa_tt_amount": 0.1,
  • "ifa_tt_beneficiary_account_no": "string",
  • "ifa_tt_beneficiary_bank_name": "string",
  • "ifa_tt_beneficiary_bank_address": "string",
  • "ifa_tt_beneficiary_receiving_agent": "string",
  • "ifa_co_beneficiary_name": "string",
  • "ifa_financing_currency": "string",
  • "ifa_port_loading": "string",
  • "ifa_port_discharge": "string",
  • "ifa_vessel_number": "string",
  • "ifa_fx_contract_number": "string",
  • "ifa_fx_rate": "string",
  • "ifa_counterparty_address": "string",
  • "ifa_co_beneficiary_account_name": "string",
  • "ifa_co_beneficiary_account_number": "string",
  • "ifa_co_other_instructions": "string",
  • "ifa_tt_beneficiary_bank_swift_code": "string",
  • "ifa_co_beneficiary_bank_swift_code": "string"
}

Invoice Finance Response

Data Element ID: invoice_finance_response

ifr_transaction_reference_number
required
string (Transaction Reference Number )

:Transaction Reference Number
:Transaction Reference Number
:Transaction Reference Number
:NA
:NA

ifr_finance_approved_date
string or null <date> (Finance Approved Date)

:Finance Approved Date
:Finance Approved Date
:Finance Approved Date
:NA
:NA

ifr_financing_start_date
string or null <date> (Financing Start Date)

:Financing Start Date
:Financing Start Date
:Financing Start Date
:NA
:NA

ifr_financing_maturity_date
string or null <date> (Financing Maturity Date)

:Financing Maturity Date
:Financing Maturity Date
:Financing Maturity Date
:NA
:NA

ifr_disbursement_date
string or null <date> (Disbursement Date)

:Disbursement Date
:Disbursement Date
:Disbursement Date
:NA
:NA

ifr_finance_status
required
string <date> (Finance Status)

:Finance Status
:Finance Status
:Finance Status
:NA
:NA

Array of objects or null (Invoice Finance Response Attachment)

:Invoice Finance Response Attachment
:Invoice Finance Response Attachment
:Invoice Finance Response Attachment
:NA
:NA

{
  • "ifr_transaction_reference_number": "string",
  • "ifr_finance_approved_date": "2019-08-24",
  • "ifr_financing_start_date": "2019-08-24",
  • "ifr_financing_maturity_date": "2019-08-24",
  • "ifr_disbursement_date": "2019-08-24",
  • "ifr_finance_status": "2019-08-24",
  • "attachments": [
    ]
}

Palm Oil Entity Certification

Data Element ID: palm_oil_entity_certification

poec_name_certified_entity
required
string (Name Of Certified Entity)

:Name of Certified Entity
:Name Of Certified Entity
:Name of Certified Entity
:NA
:NA

poec_address_certified_entity
required
string (Address Of Certified Entity )

:Address of Certified Entity
:Address Of Certified Entity
:Address of Certified Entity
:NA
:NA

poec_certification_number
required
string (Certification Number )

:Certification Number
:Certification Number
:Certification Number
:NA
:NA

poec_certificate_start_date
required
string (Certification Start Date )

:Certification Start Date
:Certification Start Date
:Certification Start Date
:NA
:NA

poec_certificate_expiration_date
required
string (Certification Expiration Date )

:Certification Expiration Date
:Certification Expiration Date
:Certification Expiration Date
:NA
:NA

poec_scope_certification
required
string (Scope Of Certification)

:Scope of Certification
:Scope Of Certification
:Scope of Certification
:NA
:NA

poec_certification_standards
required
string (Certification Standards )

:Certification Standards
:Certification Standards
:Certification Standards
:NA
:NA

poec_license_expiration_date
string or null <date> (License Expiration Date)

:License Expiration Date
:License Expiration Date
:License Expiration Date
:NA
:NA

poec_certificate_issue_date
string or null <date> (Certificate Issue Date)

:Certificate Issue Date
:Certificate Issue Date
:Certificate Issue Date
:NA
:NA

poec_license_number
string or null (License Number )

:License Number
:License Number
:License Number
:NA
:NA

poec_gps
string or null (Gps)

:GPS
:Gps
:GPS
:NA
:NA

poec_certified_area
string or null (Certified Area)

:Certified Area
:Certified Area
:Certified Area
:NA
:NA

poec_name_parent_company
string or null (Parent Company)

:Parent Company
:Parent Company
:Parent Company
:NA
:NA

poec_production_area
string or null (Production Area)

:Production Area
:Production Area
:Production Area
:NA
:NA

poec_date_first_certification
string or null <date> (Date Of First Certification)

:Date of First Certification
:Date Of First Certification
:Date of First Certification
:NA
:NA

poec_membership_number
string or null (Membership Number Of Certified Entity / Parent Company)

:Membership Number of Certified Entity / Parent Company
:Membership Number Of Certified Entity / Parent Company
:Membership Number of Certified Entity / Parent Company
:NA
:NA

poec_license_start_date
string or null <date> (License Start Date)

:License Start Date
:License Start Date
:License Start Date
:NA
:NA

poec_standards_process
string or null (Standards Process)

:Standards Process
:Standards Process
:Standards Process
:NA
:NA

poec_address_certified_site
string or null (Address Of Certified Site/ Facility)

:Address of Certified Site/ Facility
:Address Of Certified Site/ Facility
:Address of Certified Site/ Facility
:NA
:NA

poec_name_certified_site
string or null (Name Of Certified Site/ Facility)

:Name of Certified Site/ Facility
:Name Of Certified Site/ Facility
:Name of Certified Site/ Facility
:NA
:NA

poec_set_classification
string or null (Set(S) Classification)

:Set(s) Classification
:Set(S) Classification
:Set(s) Classification
:NA
:NA

poec_certificate_place_issue
string or null (Certificate Place Of Issue)

:Certificate Place of Issue
:Certificate Place Of Issue
:Certificate Place of Issue
:NA
:NA

poec_supply_chain_model
string or null (Supply Chain Model)

:Supply Chain Model
:Supply Chain Model
:Supply Chain Model
:NA
:NA

poec_other_sites_certified
string or null (Whether Other Sites Are Certified)

:Whether other sites are certified
:Whether Other Sites Are Certified
:Whether other sites are certified
:NA
:NA

poec_capacity
string or null (Capacity)

:Capacity
:Capacity
:Capacity
:NA
:NA

poec_status
string or null (Status)

:Status
:Status
:Status
:NA
:NA

poec_annual_tonnages
string or null (Annual Tonnages (Mt))

:Annual Tonnages (MT)
:Annual Tonnages (Mt)
:Annual Tonnages (MT)
:NA
:NA

Array of objects or null (Palm Oil Entity Certification Attachment)

:Palm Oil Entity Certification Attachment
:Palm Oil Entity Certification Attachment
:Palm Oil Entity Certification Attachment
:NA
:NA

{
  • "poec_name_certified_entity": "string",
  • "poec_address_certified_entity": "string",
  • "poec_certification_number": "string",
  • "poec_certificate_start_date": "string",
  • "poec_certificate_expiration_date": "string",
  • "poec_scope_certification": "string",
  • "poec_certification_standards": "string",
  • "poec_license_expiration_date": "2019-08-24",
  • "poec_certificate_issue_date": "2019-08-24",
  • "poec_license_number": "string",
  • "poec_gps": "string",
  • "poec_certified_area": "string",
  • "poec_name_parent_company": "string",
  • "poec_production_area": "string",
  • "poec_date_first_certification": "2019-08-24",
  • "poec_membership_number": "string",
  • "poec_license_start_date": "2019-08-24",
  • "poec_standards_process": "string",
  • "poec_address_certified_site": "string",
  • "poec_name_certified_site": "string",
  • "poec_set_classification": "string",
  • "poec_certificate_place_issue": "string",
  • "poec_supply_chain_model": "string",
  • "poec_other_sites_certified": "string",
  • "poec_capacity": "string",
  • "poec_status": "string",
  • "poec_annual_tonnages": "string",
  • "attachments": [
    ]
}

Payment Progress Certificate

Data Element ID: payment_progress_certificate

ppc_company_name
required
string (Company Name)

:Registered Company name of Issuer
:Company Name
:Registered Company name of Issuer
:NA
:NA

ppc_company_address
required
string (Company Address)

:Registered Company address of Issuer
:Company Address
:Registered Company address of Issuer
:NA
:NA

ppc_number
required
string (Document No.)

:Unique identifier for progress payment certificate
:Document No.
:Unique identifier for progress payment certificate
:NA
:NA

ppc_date
required
string <date> (Date)

:Date of document issuance (eg. dd - mm - yyyy)
:Date
:Date of document issuance (eg. dd - mm - yyyy)
:NA
:NA

ppc_customer_number
string or null (Customer No.)

:Unique Identifier for Customer
:Customer No.
:Unique Identifier for Customer
:NA
:NA

ppc_gst_registration_number
string or null (Gst Registration No.)

:Unique Identifier for issuer GST registered account
:Gst Registration No.
:Unique Identifier for issuer GST registered account
:NA
:NA

ppc_payment_number
string or null (Payment No.)

:Payment reference number
:Payment No.
:Payment reference number
:NA
:NA

ppc_project_number
required
string (Project No.)

:Unique Identifier for project
:Project No.
:Unique Identifier for project
:NA
:NA

ppc_contract_ref_or_work_order_no
string or null (Contract Ref. / Work Order No.)

:Unique Identifier for contract order or work order number
:Contract Ref. / Work Order No.
:Unique Identifier for contract order or work order number
:NA
:NA

ppc_contractor_company_name
required
string (Contractor Company Name)

:Registered Company name of Contractor
:Contractor Company Name
:Registered Company name of Contractor
:NA
:NA

ppc_contractor_company_address
required
string (Contractor Company Address)

:Registered Company address of Contractor
:Contractor Company Address
:Registered Company address of Contractor
:NA
:NA

ppc_contractor_gst_no
string or null (Contractor Gst No.)

:Unique Identifier for contractor GST registered account
:Contractor Gst No.
:Unique Identifier for contractor GST registered account
:NA
:NA

ppc_project_title
required
string (Project Title)

:Title of Project
:Project Title
:Title of Project
:NA
:NA

ppc_contractor_sum
string or null (Contractor Sum)

:Contractor Sum for Project
:Contractor Sum
:Contractor Sum for Project
:NA
:NA

ppc_variation_order_number
string or null (Variation Order No.)

:Unique identifier for variation order on project
:Variation Order No.
:Unique identifier for variation order on project
:NA
:NA

ppc_contract_title
required
string (Contract Title)

:Contract under which work was completed
:Contract Title
:Contract under which work was completed
:NA
:NA

Array of objects or null or null (Item Details)
ppc_item_reference
string or null (Reference)

:Reference number of item
:Reference
:Reference number of item
:NA
:NA

ppc_certified_amount
required
number <double> (Certified Amount)

:Certified amount
:Certified Amount
:Certified amount
:NA
:NA

ppc_amount_previously_certified
required
number <double> (Amount Previously Certified)

:Amount previously certified
:Amount Previously Certified
:Amount previously certified
:NA
:NA

ppc_variation_amount
required
number <double> (Variation Amount)

:Amount of variation applicable
:Variation Amount
:Amount of variation applicable
:NA
:NA

ppc_retention_sum
string or null (Retention Sum)

:Retention amount
:Retention Sum
:Retention amount
:NA
:NA

ppc_amount_gross
required
number <double> (Amount Due (Gross))

:Gross amount billed for progress payment certificate
:Amount Due (Gross)
:Gross amount billed for progress payment certificate
:NA
:NA

ppc_tax_amount
number or null <double> (Tax Amount)

:Total Tax amount incurred
:Tax Amount
:Total Tax amount incurred
:NA
:NA

ppc_back_charge_deduct
number or null <double> (Back Charge Deduction)

:Back Charge Deduction
:Back Charge Deduction
:Back Charge Deduction
:NA
:NA

ppc_back_charge_refund
number or null <double> (Bank Charge Refund)

:Bank Charge Refund
:Bank Charge Refund
:Bank Charge Refund
:NA
:NA

ppc_total_amount_excl_gst
number or null <double> (Total Amount Due (Nett) (excl GST))

:Total Amount Due (Nett) (excl GST)
:Total Amount Due (Nett) (excl GST)
:Total Amount Due (Nett) (excl GST)
:NA
:NA

ppc_amount_net_incl_gst
number or null <double> (Amount Due (Nett) (incl GST))

:Amount Due (Nett) (incl GST)
:Amount Due (Nett) (incl GST)
:Amount Due (Nett) (incl GST)
:NA
:NA

ppc_debit_note_number
string or null (Debit Note No.)

:Unique identifier for debit note issued related to this claim
:Debit Note No.
:Unique identifier for debit note issued related to this claim
:NA
:NA

ppc_debit_note_amount
number or null <double> (Debit Note Amount)

:Total amount of issued debit note
:Debit Note Amount
:Total amount of issued debit note
:NA
:NA

ppc_debit_note_remarks
string or null (Debit Note Remarks)

:Description for debit note
:Debit Note Remarks
:Description for debit note
:NA
:NA

ppc_payment_work_done_this_period
required
string (Payment Of Work Done This Period)

:Total amount payable for certified project period
:Payment Of Work Done This Period
:Total amount payable for certified project period
:NA
:NA

ppc_payment_terms
string or null (Payment Terms)

:Terms of payment
:Payment Terms
:Terms of payment
:NA
:NA

ppc_beneficiary_name
string or null (Beneficiary)

:Beneficiary of payment
:Beneficiary
:Beneficiary of payment
:NA
:NA

ppc_beneficiary_bank_name
string or null (Bank Name)

:Bank name of beneficiary
:Bank Name
:Bank name of beneficiary
:NA
:NA

ppc_beneficiary_bank_branch
string or null (Branch)

:Branch of beneficiary bank
:Branch
:Branch of beneficiary bank
:NA
:NA

ppc_beneficiary_bank_swift_code
string or null (Swift Code)

:Swift code of beneficiary bank
:Swift Code
:Swift code of beneficiary bank
:NA
:NA

ppc_beneficiary_bank_code
string or null (Bank Code)

:Bank code of beneficiary bank
:Bank Code
:Bank code of beneficiary bank
:NA
:NA

ppc_beneficiary_bank_account_number
string or null (Bank Account Number)

:Account Number of beneficiary bank
:Bank Account Number
:Account Number of beneficiary bank
:NA
:NA

Array of objects or null (Attachments)
{
  • "ppc_company_name": "string",
  • "ppc_company_address": "string",
  • "ppc_number": "string",
  • "ppc_date": "2019-08-24",
  • "ppc_customer_number": "string",
  • "ppc_gst_registration_number": "string",
  • "ppc_payment_number": "string",
  • "ppc_project_number": "string",
  • "ppc_contract_ref_or_work_order_no": "string",
  • "ppc_contractor_company_name": "string",
  • "ppc_contractor_company_address": "string",
  • "ppc_contractor_gst_no": "string",
  • "ppc_project_title": "string",
  • "ppc_contractor_sum": "string",
  • "ppc_variation_order_number": "string",
  • "ppc_contract_title": "string",
  • "ppc_item_details": [
    ],
  • "ppc_item_reference": "string",
  • "ppc_certified_amount": 0.1,
  • "ppc_amount_previously_certified": 0.1,
  • "ppc_variation_amount": 0.1,
  • "ppc_retention_sum": "string",
  • "ppc_amount_gross": 0.1,
  • "ppc_tax_amount": 0.1,
  • "ppc_back_charge_deduct": 0.1,
  • "ppc_back_charge_refund": 0.1,
  • "ppc_total_amount_excl_gst": 0.1,
  • "ppc_amount_net_incl_gst": 0.1,
  • "ppc_debit_note_number": "string",
  • "ppc_debit_note_amount": 0.1,
  • "ppc_debit_note_remarks": "string",
  • "ppc_payment_work_done_this_period": "string",
  • "ppc_payment_terms": "string",
  • "ppc_beneficiary_name": "string",
  • "ppc_beneficiary_bank_name": "string",
  • "ppc_beneficiary_bank_branch": "string",
  • "ppc_beneficiary_bank_swift_code": "string",
  • "ppc_beneficiary_bank_code": "string",
  • "ppc_beneficiary_bank_account_number": "string",
  • "attachments": [
    ]
}

Payment Response

Data Element ID: payment_response

pr_company_name
required
string (Company Name)

:Registered Company name of Issuer
:Company Name
:Registered Company name of Issuer
:NA
:NA

pr_company_address
required
string (Company Address)

:Registered Company address of Issuer
:Company Address
:Registered Company address of Issuer
:NA
:NA

pr_reference
required
string (Payment Response Reference)

:Unique identifier for payment response
:Payment Response Reference
:Unique identifier for payment response
:NA
:NA

pr_date
required
string <date> (Date)

:Date of document issuance (eg. dd - mm - yyyy)
:Date
:Date of document issuance (eg. dd - mm - yyyy)
:NA
:NA

pr_customer_number
string or null (Customer No.)

:Unique Identifier for Customer
:Customer No.
:Unique Identifier for Customer
:NA
:NA

pr_gst_registration_number
string or null (Gst Registration No.)

:Unique Identifier for issuer GST registered account
:Gst Registration No.
:Unique Identifier for issuer GST registered account
:NA
:NA

pr_claim_ref
required
string (Payment Claim Reference)

:Unique identifier for payment claim
:Payment Claim Reference
:Unique identifier for payment claim
:NA
:NA

pr_project_number
required
string (Project No.)

:Unique Identifier for project
:Project No.
:Unique Identifier for project
:NA
:NA

pr_contract_ref
string or null (Contract Ref. / Work Order No.)

:Unique Identifier for contract order or work order number
:Contract Ref. / Work Order No.
:Unique Identifier for contract order or work order number
:NA
:NA

pr_contractor_company
required
string (Contractor Company Name)

:Registered Company name of Contractor
:Contractor Company Name
:Registered Company name of Contractor
:NA
:NA

pr_contractor_company_address
required
string (Contractor Company Address)

:Registered Company address of Contractor
:Contractor Company Address
:Registered Company address of Contractor
:NA
:NA

pr_project_title
required
string (Project Title)

:Title of Project
:Project Title
:Title of Project
:NA
:NA

pr_contract_details
required
string (Contract Details)

:Contract detail of work done in payment progress certificate
:Contract Details
:Contract detail of work done in payment progress certificate
:NA
:NA

pr_certified_amount
required
number <double> (Certified Amount)

:PR Certified amount
:Certified Amount
:PR Certified amount
:NA
:NA

pr_amount_previously_certified
required
number <double> (Amount Previously Certified)

:Amount previously certified
:Amount Previously Certified
:Amount previously certified
:NA
:NA

pr_variation_amount
required
number <double> (Variation Amount)

:Amount of variation applicable
:Variation Amount
:Amount of variation applicable
:NA
:NA

pr_amount_gross
required
number <double> (Amount Due (Gross))

:Gross amount billed for progress payment certificate
:Amount Due (Gross)
:Gross amount billed for progress payment certificate
:NA
:NA

pr_back_charge_deduct
number or null <double> (Back Charge Deduction)

:Back Charge Deduction
:Back Charge Deduction
:Back Charge Deduction
:NA
:NA

pr_back_charge_refund
number or null <double> (Bank Charge Refund)

:Bank Charge Refund
:Bank Charge Refund
:Bank Charge Refund
:NA
:NA

pr_total_amount_excl_gst
number or null <double> (Total Amount Due (Nett) (excl GST))

:Total Amount Due (Nett) (excl GST)
:Total Amount Due (Nett) (excl GST)
:Total Amount Due (Nett) (excl GST)
:NA
:NA

pr_total_amount_incl_gst
number or null <double> (Total Amount Due (Nett) (incl GST))

:Total Amount Due (Nett) (incl GST)
:Total Amount Due (Nett) (incl GST)
:Total Amount Due (Nett) (incl GST)
:NA
:NA

pr_payment_work_done_this_period
required
string (Payment Of Work Done This Period)

:Total amount payable for certified project period
:Payment Of Work Done This Period
:Total amount payable for certified project period
:NA
:NA

Array of objects or null (Attachments)
{
  • "pr_company_name": "string",
  • "pr_company_address": "string",
  • "pr_reference": "string",
  • "pr_date": "2019-08-24",
  • "pr_customer_number": "string",
  • "pr_gst_registration_number": "string",
  • "pr_claim_ref": "string",
  • "pr_project_number": "string",
  • "pr_contract_ref": "string",
  • "pr_contractor_company": "string",
  • "pr_contractor_company_address": "string",
  • "pr_project_title": "string",
  • "pr_contract_details": "string",
  • "pr_certified_amount": 0.1,
  • "pr_amount_previously_certified": 0.1,
  • "pr_variation_amount": 0.1,
  • "pr_amount_gross": 0.1,
  • "pr_back_charge_deduct": 0.1,
  • "pr_back_charge_refund": 0.1,
  • "pr_total_amount_excl_gst": 0.1,
  • "pr_total_amount_incl_gst": 0.1,
  • "pr_payment_work_done_this_period": "string",
  • "attachments": [
    ]
}

Purchase Order

Data Element ID: purchase_order

po_additional_document_reference
string or null (Additional Document Reference)

:Field UID: ORD- 0034-An associative reference to Additional Document.
:Additional Document Reference
:Field UID: ORD- 0034-An associative reference to Additional Document.
:UN/CEFACT
:NA

po_allowance_and_charge
string or null (Allowance And Charge)

:Field UID: ORD- 0050-The entity contains the details of the allowance and charge valid for the order header.
:Allowance And Charge
:Field UID: ORD- 0050-The entity contains the details of the allowance and charge valid for the order header.
:UN/CEFACT
:NA

po_assets_expense_account
string or null (Assets Or Expenses Account)

:Field UID: ORD- 0136-The entity contains information related to the assets or expenses account where to record the debit or credit accounting amount, the code defining the type of account (e.g. general, secondary, cost accounting, budget, etc.)..
:Assets Or Expenses Account
:Field UID: ORD- 0136-The entity contains information related to the assets or expenses account where to record the debit or credit accounting amount, the code defining the type of account (e.g. general, secondary, cost accounting, budget, etc.)..
:UN/CEFACT
:NA

po_blanket_order_reference
string or null (Blanket Order Reference)

:Field UID: ORD- 0018-The unique identification assigned by the issuer to a blanket order.
:Blanket Order Reference
:Field UID: ORD- 0018-The unique identification assigned by the issuer to a blanket order.
:UN/CEFACT
:NA

po_buyer
required
string (Buyer)

:Field UID: ORD- 0011-The entity contains the details of the buyer.
:Buyer
:Field UID: ORD- 0011-The entity contains the details of the buyer.
:UN/CEFACT
:NA

po_carrier
string or null (Carrier)

:Field UID: ORD- 0035-The entity contains the details of the carrier.
:Carrier
:Field UID: ORD- 0035-The entity contains the details of the carrier.
:UN/CEFACT
:NA

po_confirmed_earliest_schedule_date
string or null <date> (Confirmed Earliest Schedule Date)

:Field UID: ORD- 0108-The earliest date/time on which the delivery is confirmed.
:Confirmed Earliest Schedule Date
:Field UID: ORD- 0108-The earliest date/time on which the delivery is confirmed.
:UN/CEFACT
:NA

po_confirmed_latest_schedule_date
string or null <date> (Confirmed Latest Schedule Date)

:Field UID: ORD- 0109-The latest date/time on which the delivery is confirmed.
:Confirmed Latest Schedule Date
:Field UID: ORD- 0109-The latest date/time on which the delivery is confirmed.
:UN/CEFACT
:NA

po_confirmed_schedule_date
string or null <date> (Confirmed Schedule Date)

:Field UID: ORD- 0107-The date, a date and time on which the delivery is confirmed.
:Confirmed Schedule Date
:Field UID: ORD- 0107-The date, a date and time on which the delivery is confirmed.
:UN/CEFACT
:NA

po_consignee
string or null (Consignee)

:Field UID: ORD- 0038-The entity contains the details of the consignee.
:Consignee
:Field UID: ORD- 0038-The entity contains the details of the consignee.
:UN/CEFACT
:NA

po_consignee_agent
string or null (Consignee Agent)

:Field UID: ORD- 0113-Associates the shipment with the consignee agent.
:Consignee Agent
:Field UID: ORD- 0113-Associates the shipment with the consignee agent.
:UN/CEFACT
:NA

po_consignee_order_reference
string or null (Consignee Order Reference)

:Field UID: ORD- 0019-The unique identification assigned by the consignee to an order.
:Consignee Order Reference
:Field UID: ORD- 0019-The unique identification assigned by the consignee to an order.
:UN/CEFACT
:NA

po_cost_assignment_reference
string or null (Cost Assignment Reference)

:Field UID: ORD- 0033-The Buyer's accounting code applied to the Order as a whole, expressed as text.
:Cost Assignment Reference
:Field UID: ORD- 0033-The Buyer's accounting code applied to the Order as a whole, expressed as text.
:UN/CEFACT
:NA

po_country_final_destination
string or null (Country Of Final Destination)

:Field UID: ORD- 0124-The code specifying the final country to which the goods are to be delivered.
:Country Of Final Destination
:Field UID: ORD- 0124-The code specifying the final country to which the goods are to be delivered.
:UN/CEFACT
:NA

po_customer_accountant
string or null (Customer Accountant)

:Field UID: ORD- 0012-The entity contains the details of the customer accountant.
:Customer Accountant
:Field UID: ORD- 0012-The entity contains the details of the customer accountant.
:UN/CEFACT
:NA

po_customer_reference
string or null (Customer Reference)

:Field UID: ORD- 0032-A supplementary reference for the Order, expressed as text.
:Customer Reference
:Field UID: ORD- 0032-A supplementary reference for the Order, expressed as text.
:UN/CEFACT
:NA

po_customs_certificate_reference
string or null (Customs Certificate Reference)

:Field UID: ORD- 0029-The unique identification assigned by the issuer to a customs certificate.
:Customs Certificate Reference
:Field UID: ORD- 0029-The unique identification assigned by the issuer to a customs certificate.
:UN/CEFACT
:NA

po_delivery_document_reference
string or null (Delivery Document Reference)

:Field UID: ORD- 0114-Associates the delivery Line with a Document.
:Delivery Document Reference
:Field UID: ORD- 0114-Associates the delivery Line with a Document.
:UN/CEFACT
:NA

po_delivery_instruction
string or null (Delivery Instruction)

:Field UID: ORD- 0120-The code specifying the delivery instruction.
:Delivery Instruction
:Field UID: ORD- 0120-The code specifying the delivery instruction.
:UN/CEFACT
:NA

po_delivery_instruction_description
string or null (Delivery Instruction Description)

:Field UID: ORD- 0121-The textual description of a delivery instruction.
:Delivery Instruction Description
:Field UID: ORD- 0121-The textual description of a delivery instruction.
:UN/CEFACT
:NA

po_despatch_document_note
string or null (Despatch Document Note)

:Field UID: ORD- 0078-The textual description to be provided on the despatch documents.
:Despatch Document Note
:Field UID: ORD- 0078-The textual description to be provided on the despatch documents.
:UN/CEFACT
:NA

po_despatch_period
string or null (Despatch Period)

:Field UID: ORD- 0039-The despatch period of the goods valid for the entire order.
:Despatch Period
:Field UID: ORD- 0039-The despatch period of the goods valid for the entire order.
:UN/CEFACT
:NA

po_document_information
string or null (Document Information)

:Field UID: ORD- 0007-Generic document.
:Document Information
:Field UID: ORD- 0007-Generic document.
:UN/CEFACT
:NA

po_document_purpose
string or null (Document Purpose/Function)

:Field UID: ORD- 0137-A code describing the purpose/function of the document.
:Document Purpose/Function
:Field UID: ORD- 0137-A code describing the purpose/function of the document.
:UN/CEFACT
:NA

po_earliest_schedule_date
string or null <date> (Earliest Schedule Date)

:Field UID: ORD- 0105-The value of the earliest scheduled date, a date and time in a specified representation.
:Earliest Schedule Date
:Field UID: ORD- 0105-The value of the earliest scheduled date, a date and time in a specified representation.
:UN/CEFACT
:NA

po_engineering_change_reference
string or null (Engineering Change Reference)

:Field UID: ORD- 0024-The unique identification assigned by the issuer to an engineering change.
:Engineering Change Reference
:Field UID: ORD- 0024-The unique identification assigned by the issuer to an engineering change.
:UN/CEFACT
:NA

po_export_license_reference
string or null (Export License Reference)

:Field UID: ORD- 0028-The unique identification assigned by the issuer to an export license.
:Export License Reference
:Field UID: ORD- 0028-The unique identification assigned by the issuer to an export license.
:UN/CEFACT
:NA

po_import_license_reference
string or null (Import License Reference)

:Field UID: ORD- 0027-The unique identification assigned by the issuer to an import license.
:Import License Reference
:Field UID: ORD- 0027-The unique identification assigned by the issuer to an import license.
:UN/CEFACT
:NA

po_invoice_currency
string or null (Invoice Currency)

:Field UID: ORD- 0044-The name or symbol of the monetary unit used for calculation in an invoice.
:Invoice Currency
:Field UID: ORD- 0044-The name or symbol of the monetary unit used for calculation in an invoice.
:UN/CEFACT
:NA

po_invoice_currency_exchange
string or null (Invoice Currency Exchange)

:Field UID: ORD- 0052-The exchange rate used for the conversion of the invoice currency from a source currency.
:Invoice Currency Exchange
:Field UID: ORD- 0052-The exchange rate used for the conversion of the invoice currency from a source currency.
:UN/CEFACT
:NA

po_invoicee
string or null (Invoicee)

:Field UID: ORD- 0042-The entity contains the details of the invoicee.
:Invoicee
:Field UID: ORD- 0042-The entity contains the details of the invoicee.
:UN/CEFACT
:NA

po_latest_schedule_date
string or null <date> (Latest Schedule Date)

:Field UID: ORD- 0106-The value of a latest scheduled date, a date and time in a specified representation.
:Latest Schedule Date
:Field UID: ORD- 0106-The value of a latest scheduled date, a date and time in a specified representation.
:UN/CEFACT
:NA

po_letter_of_credit_reference
string or null (Letter Of Credit Reference)

:Field UID: ORD- 0026-The unique identification assigned by the issuer to a letter of credit.
:Letter Of Credit Reference
:Field UID: ORD- 0026-The unique identification assigned by the issuer to a letter of credit.
:UN/CEFACT
:NA

po_minus_delivery_quantity
string or null (Minus Delivery Quantity)

:Field UID: ORD- 0111-The quantity tolerance in minus.
:Minus Delivery Quantity
:Field UID: ORD- 0111-The quantity tolerance in minus.
:UN/CEFACT
:NA

po_no_partial_delivery_allowed
string or null (No Partial Delivery Allowed)

:Field UID: ORD- 0122-The indicator that no partial delivery of the order is allowed.
:No Partial Delivery Allowed
:Field UID: ORD- 0122-The indicator that no partial delivery of the order is allowed.
:UN/CEFACT
:NA

po_order_change_header
string or null (Order Change Header)

:Field UID: ORD- 0001-Header information related to the ordering event and order document
:Order Change Header
:Field UID: ORD- 0001-Header information related to the ordering event and order document
:UN/CEFACT
:NA

po_order_currency
string or null (Order Currency)

:Field UID: ORD- 0045-The name or symbol of the monetary unit used for calculation in an order.
:Order Currency
:Field UID: ORD- 0045-The name or symbol of the monetary unit used for calculation in an order.
:UN/CEFACT
:NA

po_order_currency_exchange
string or null (Order Currency Exchange)

:Field UID: ORD- 0053-The exchange rate used for the conversion of the order currency from a source currency.
:Order Currency Exchange
:Field UID: ORD- 0053-The exchange rate used for the conversion of the order currency from a source currency.
:UN/CEFACT
:NA

Array of objects or null (Order Details)

:Line Level Order Details
:Order Details
:Line Level Order Details
:UN/CEFACT
:NA

po_order_number_marketplace
string or null (Order Number Marketplace)

:Field UID: ORD- 0030-The unique number given by the marketplace to identify an order.
:Order Number Marketplace
:Field UID: ORD- 0030-The unique number given by the marketplace to identify an order.
:UN/CEFACT
:NA

po_order_response_header
string or null (Order Response Header)

:Field UID: ORD- 0003-Header information related to the ordering event and order document
:Order Response Header
:Field UID: ORD- 0003-Header information related to the ordering event and order document
:UN/CEFACT
:NA

po_original_order_reference
string or null (Original Order Reference)

:Field UID: ORD- 0023-The unique identification assigned by the issuer to the original order.
:Original Order Reference
:Field UID: ORD- 0023-The unique identification assigned by the issuer to the original order.
:UN/CEFACT
:NA

po_payable_account
string or null (Payable Account)

:Field UID: ORD- 0051-The entity contains information related to the payable account where to record the debit or credit accounting amount, the code defining the type of account (e.g. general, secondary, cost accounting, budget, etc.)..
:Payable Account
:Field UID: ORD- 0051-The entity contains information related to the payable account where to record the debit or credit accounting amount, the code defining the type of account (e.g. general, secondary, cost accounting, budget, etc.)..
:UN/CEFACT
:NA

po_payee
string or null (Payee)

:Field UID: ORD- 0128-The entity contains the details of the payer.
:Payee
:Field UID: ORD- 0128-The entity contains the details of the payer.
:UN/CEFACT
:NA

po_payer
string or null (Payer)

:Field UID: ORD- 0043-The entity contains the details of the payer.
:Payer
:Field UID: ORD- 0043-The entity contains the details of the payer.
:UN/CEFACT
:NA

po_payment_instructions
string or null (Payment Instructions)

:Field UID: ORD- 0048-The entity contains the set of information describing the conditions and guarantee under which the payment will or should be made.
:Payment Instructions
:Field UID: ORD- 0048-The entity contains the set of information describing the conditions and guarantee under which the payment will or should be made.
:UN/CEFACT
:NA

po_payment_terms
string or null (Payment Terms)

:Field UID: ORD- 0049-The entity contains the details of the payment terms and date/time basis.
:Payment Terms
:Field UID: ORD- 0049-The entity contains the details of the payment terms and date/time basis.
:UN/CEFACT
:NA

po_place_destination
string or null (Place Of Destination)

:Field UID: ORD- 0119-The internal destination of the ship to location or address, of the products after discharging the transport means
:Place Of Destination
:Field UID: ORD- 0119-The internal destination of the ship to location or address, of the products after discharging the transport means
:UN/CEFACT
:NA

po_place_discharge
string or null (Place Of Discharge)

:Field UID: ORD- 0118-The internal location of the ship to location or address, were the products will be (are) discharged from the transport means.
:Place Of Discharge
:Field UID: ORD- 0118-The internal location of the ship to location or address, were the products will be (are) discharged from the transport means.
:UN/CEFACT
:NA

po_plus_delivery_quantity
string or null (Plus Delivery Quantity)

:Field UID: ORD- 0112-The quantity tolerance in plus.
:Plus Delivery Quantity
:Field UID: ORD- 0112-The quantity tolerance in plus.
:UN/CEFACT
:NA

po_price
string or null (Price)

:Field UID: ORD- 0134-The entity contains the price type, price amount, the allowance and charges and the validity period for the order line or delivery details specified in the depending scheduled lines.
:Price
:Field UID: ORD- 0134-The entity contains the price type, price amount, the allowance and charges and the validity period for the order line or delivery details specified in the depending scheduled lines.
:UN/CEFACT
:NA

po_price_list_reference
string or null (Price List Reference)

:Field UID: ORD- 0017-The unique identification assigned by the issuer to a price list.
:Price List Reference
:Field UID: ORD- 0017-The unique identification assigned by the issuer to a price list.
:UN/CEFACT
:NA

po_pricing_currency
string or null (Pricing Currency)

:Field UID: ORD- 0046-The name or symbol of the monetary unit used for all prices in an order.
:Pricing Currency
:Field UID: ORD- 0046-The name or symbol of the monetary unit used for all prices in an order.
:UN/CEFACT
:NA

po_pricing_currency_exchange
string or null (Pricing Currency Exchange)

:Field UID: ORD- 0055-The exchange rate used for the conversion of the pricing currency from a source currency.
:Pricing Currency Exchange
:Field UID: ORD- 0055-The exchange rate used for the conversion of the pricing currency from a source currency.
:UN/CEFACT
:NA

po_prior_order_change_reference
string or null (Prior Order Change Reference)

:Field UID: ORD- 0021-The unique identification assigned by the issuer to a prior order change.
:Prior Order Change Reference
:Field UID: ORD- 0021-The unique identification assigned by the issuer to a prior order change.
:UN/CEFACT
:NA

po_prior_order_reference
string or null (Prior Order Reference)

:Field UID: ORD- 0020-The unique identification assigned by the issuer to a prior order.
:Prior Order Reference
:Field UID: ORD- 0020-The unique identification assigned by the issuer to a prior order.
:UN/CEFACT
:NA

po_prior_order_response_reference
string or null (Prior Order Response Reference)

:Field UID: ORD- 0022-The unique identification assigned by the issuer to a prior order response.
:Prior Order Response Reference
:Field UID: ORD- 0022-The unique identification assigned by the issuer to a prior order response.
:UN/CEFACT
:NA

po_quote_reference
string or null (Quote Reference (Offer))

:Field UID: ORD- 0014-The unique identification assigned by the issuer to a quote (offer).
:Quote Reference (Offer)
:Field UID: ORD- 0014-The unique identification assigned by the issuer to a quote (offer).
:UN/CEFACT
:NA

po_release_period
string or null (Release Period)

:Field UID: ORD- 0040-The release period of the goods valid for the entire order.
:Release Period
:Field UID: ORD- 0040-The release period of the goods valid for the entire order.
:UN/CEFACT
:NA

po_report_reference
string or null (Sales Report Reference)

:Field UID: ORD- 0015-The unique identification assigned by the issuer to a sales report.
:Sales Report Reference
:Field UID: ORD- 0015-The unique identification assigned by the issuer to a sales report.
:UN/CEFACT
:NA

po_request_for_quote_reference
string or null (Request For Quote Reference)

:Field UID: ORD- 0013-The unique identification assigned by the issuer to a request for quote.
:Request For Quote Reference
:Field UID: ORD- 0013-The unique identification assigned by the issuer to a request for quote.
:UN/CEFACT
:NA

po_requisition_reference
string or null (Requisition Reference)

:Field UID: ORD- 0025-The unique identification assigned by the issuer to a requisition.
:Requisition Reference
:Field UID: ORD- 0025-The unique identification assigned by the issuer to a requisition.
:UN/CEFACT
:NA

po_requisitioner
string or null (Requisitioner)

:Field UID: ORD- 0083-The party who originated Order
:Requisitioner
:Field UID: ORD- 0083-The party who originated Order
:UN/CEFACT
:NA

po_response_reason_code
string or null (Response Reason Code)

:Field UID: ORD- 0138-A code describing the reason for a specific response such as a rejection. Used on both header and line.
:Response Reason Code
:Field UID: ORD- 0138-A code describing the reason for a specific response such as a rejection. Used on both header and line.
:UN/CEFACT
:NA

po_rounding_amount
string or null (Rounding Amount)

:Field UID: ORD- 0062-The rounding amount (positive or negative) added to the to be paid amount.
:Rounding Amount
:Field UID: ORD- 0062-The rounding amount (positive or negative) added to the to be paid amount.
:UN/CEFACT
:NA

po_scedule_period
string or null (Schedule Period)

:Field UID: ORD- 0041-The scheduled period of the goods valid for the entire order.
:Schedule Period
:Field UID: ORD- 0041-The scheduled period of the goods valid for the entire order.
:UN/CEFACT
:NA

po_schedule_date
string or null <date> (Schedule Date)

:Field UID: ORD- 0104-The value of the scheduled date, a date and time in a specified representation.
:Schedule Date
:Field UID: ORD- 0104-The value of the scheduled date, a date and time in a specified representation.
:UN/CEFACT
:NA

po_seller
string or null (Seller)

:Field UID: ORD- 0008-The entity contains the details of the seller.
:Seller
:Field UID: ORD- 0008-The entity contains the details of the seller.
:UN/CEFACT
:NA

po_ship_from
string or null (Ship From)

:Field UID: ORD- 0037-The entity contains the details of the party from whom the products are physically shipped..
:Ship From
:Field UID: ORD- 0037-The entity contains the details of the party from whom the products are physically shipped..
:UN/CEFACT
:NA

po_ship_from_location
string or null (Ship From Location)

:Field UID: ORD- 0116-Information directly relating to the address/location from which a delivery is shipped.
:Ship From Location
:Field UID: ORD- 0116-Information directly relating to the address/location from which a delivery is shipped.
:UN/CEFACT
:NA

po_ship_to
string or null (Ship To)

:Field UID: ORD- 0036-The entity contains the details of the party to whom the products will be physical delivered.
:Ship To
:Field UID: ORD- 0036-The entity contains the details of the party to whom the products will be physical delivered.
:UN/CEFACT
:NA

po_ship_to_location
string or null (Ship To Location Or Address)

:Field UID: ORD- 0117-The location or address to which a means of transport is destined for the delivery of goods.
:Ship To Location Or Address
:Field UID: ORD- 0117-The location or address to which a means of transport is destined for the delivery of goods.
:UN/CEFACT
:NA

po_shipping_grouping_identifier
string or null (Shipping Grouping Identifier)

:Field UID: ORD- 0125-The identifier of the shipping grouping of the order with the shipping of other orders.
:Shipping Grouping Identifier
:Field UID: ORD- 0125-The identifier of the shipping grouping of the order with the shipping of other orders.
:UN/CEFACT
:NA

po_supplier_order_identifier
string or null (Supplier Order Identifier)

:Field UID: ORD- 0031-An identifier for the Order assigned by the Supplier.
:Supplier Order Identifier
:Field UID: ORD- 0031-An identifier for the Order assigned by the Supplier.
:UN/CEFACT
:NA

po_tax_currency
string or null (Tax Currency)

:Field UID: ORD- 0047-The name or symbol of the monetary unit requested for tax amounts in invoices related to this order.
:Tax Currency
:Field UID: ORD- 0047-The name or symbol of the monetary unit requested for tax amounts in invoices related to this order.
:UN/CEFACT
:NA

po_tax_currency_exchange
string or null (Tax Currency Exchange)

:Field UID: ORD- 0054-The exchange rate used for the conversion of the tax currency from a source currency.
:Tax Currency Exchange
:Field UID: ORD- 0054-The exchange rate used for the conversion of the tax currency from a source currency.
:UN/CEFACT
:NA

po_tax_fee_totals
string or null (Tax Fee Totals)

:Field UID: ORD- 0064-The entity contains of the order the tax type, tax rate, the taxable amount and the tax amount for the tax type and rate.
:Tax Fee Totals
:Field UID: ORD- 0064-The entity contains of the order the tax type, tax rate, the taxable amount and the tax amount for the tax type and rate.
:UN/CEFACT
:NA

po_to_be_paid_amount
string or null (To Be Paid Amount)

:Field UID: ORD- 0063-The total amount to be paid.
:To Be Paid Amount
:Field UID: ORD- 0063-The total amount to be paid.
:UN/CEFACT
:NA

po_total_order_additional_allowance_amount
string or null (Total Order Additional Allowance Amount)

:Field UID: ORD- 0058-The sum of all the allowances at the order header before tax or fee.
:Total Order Additional Allowance Amount
:Field UID: ORD- 0058-The sum of all the allowances at the order header before tax or fee.
:UN/CEFACT
:NA

po_total_order_additional_charge_amount
string or null (Total Order Additional Charge Amount)

:Field UID: ORD- 0057-The sum of all the charges at the order header before tax or fee.
:Total Order Additional Charge Amount
:Field UID: ORD- 0057-The sum of all the charges at the order header before tax or fee.
:UN/CEFACT
:NA

po_total_order_amount
string or null (Total Order Amount)

:Field UID: ORD- 0061-The total amount of the order, being the sum of total order line amount, total additional amounts and total tax fee amount.
:Total Order Amount
:Field UID: ORD- 0061-The total amount of the order, being the sum of total order line amount, total additional amounts and total tax fee amount.
:UN/CEFACT
:NA

po_total_amount
string or null (Total Amount)

:Field UID: ORD- 0056-The value of the total order expressed in the order currency. Is also used as an alternative for the price.
:Total Amount
:Field UID: ORD- 0056-The value of the total order expressed in the order currency. Is also used as an alternative for the price.
:UN/CEFACT
:NA

po_total_quantity
string or null (Total Quantity)

:Field UID: ORD- 0132-The value of the total order line quantity.
:Total Quantity
:Field UID: ORD- 0132-The value of the total order line quantity.
:UN/CEFACT
:NA

po_total_tax_fee_amount
string or null (Total Tax Fee Amount)

:Field UID: ORD- 0060-The sum of all tax and fee amounts.
:Total Tax Fee Amount
:Field UID: ORD- 0060-The sum of all tax and fee amounts.
:UN/CEFACT
:NA

po_total_taxable_amount
string or null (Total Taxable Amount)

:Field UID: ORD- 0059-The total amount subject to tax or fee.
:Total Taxable Amount
:Field UID: ORD- 0059-The total amount subject to tax or fee.
:UN/CEFACT
:NA

po_transport_mode
string or null (Transport Mode)

:Field UID: ORD- 0126-The code specifying the mode of transport.
:Transport Mode
:Field UID: ORD- 0126-The code specifying the mode of transport.
:UN/CEFACT
:NA

Array of objects or null (Purchase Order Attachment)

:Purchase Order Attachment
:Purchase Order Attachment
:Purchase Order Attachment
:NA
:NA

{
  • "po_additional_document_reference": "string",
  • "po_allowance_and_charge": "string",
  • "po_assets_expense_account": "string",
  • "po_blanket_order_reference": "string",
  • "po_buyer": "string",
  • "po_carrier": "string",
  • "po_confirmed_earliest_schedule_date": "2019-08-24",
  • "po_confirmed_latest_schedule_date": "2019-08-24",
  • "po_confirmed_schedule_date": "2019-08-24",
  • "po_consignee": "string",
  • "po_consignee_agent": "string",
  • "po_consignee_order_reference": "string",
  • "po_cost_assignment_reference": "string",
  • "po_country_final_destination": "string",
  • "po_customer_accountant": "string",
  • "po_customer_reference": "string",
  • "po_customs_certificate_reference": "string",
  • "po_delivery_document_reference": "string",
  • "po_delivery_instruction": "string",
  • "po_delivery_instruction_description": "string",
  • "po_despatch_document_note": "string",
  • "po_despatch_period": "string",
  • "po_document_information": "string",
  • "po_document_purpose": "string",
  • "po_earliest_schedule_date": "2019-08-24",
  • "po_engineering_change_reference": "string",
  • "po_export_license_reference": "string",
  • "po_import_license_reference": "string",
  • "po_invoice_currency": "string",
  • "po_invoice_currency_exchange": "string",
  • "po_invoicee": "string",
  • "po_latest_schedule_date": "2019-08-24",
  • "po_letter_of_credit_reference": "string",
  • "po_minus_delivery_quantity": "string",
  • "po_no_partial_delivery_allowed": "string",
  • "po_order_change_header": "string",
  • "po_order_currency": "string",
  • "po_order_currency_exchange": "string",
  • "po_order_details": [
    ],
  • "po_order_number_marketplace": "string",
  • "po_order_response_header": "string",
  • "po_original_order_reference": "string",
  • "po_payable_account": "string",
  • "po_payee": "string",
  • "po_payer": "string",
  • "po_payment_instructions": "string",
  • "po_payment_terms": "string",
  • "po_place_destination": "string",
  • "po_place_discharge": "string",
  • "po_plus_delivery_quantity": "string",
  • "po_price": "string",
  • "po_price_list_reference": "string",
  • "po_pricing_currency": "string",
  • "po_pricing_currency_exchange": "string",
  • "po_prior_order_change_reference": "string",
  • "po_prior_order_reference": "string",
  • "po_prior_order_response_reference": "string",
  • "po_quote_reference": "string",
  • "po_release_period": "string",
  • "po_report_reference": "string",
  • "po_request_for_quote_reference": "string",
  • "po_requisition_reference": "string",
  • "po_requisitioner": "string",
  • "po_response_reason_code": "string",
  • "po_rounding_amount": "string",
  • "po_scedule_period": "string",
  • "po_schedule_date": "2019-08-24",
  • "po_seller": "string",
  • "po_ship_from": "string",
  • "po_ship_from_location": "string",
  • "po_ship_to": "string",
  • "po_ship_to_location": "string",
  • "po_shipping_grouping_identifier": "string",
  • "po_supplier_order_identifier": "string",
  • "po_tax_currency": "string",
  • "po_tax_currency_exchange": "string",
  • "po_tax_fee_totals": "string",
  • "po_to_be_paid_amount": "string",
  • "po_total_order_additional_allowance_amount": "string",
  • "po_total_order_additional_charge_amount": "string",
  • "po_total_order_amount": "string",
  • "po_total_amount": "string",
  • "po_total_quantity": "string",
  • "po_total_tax_fee_amount": "string",
  • "po_total_taxable_amount": "string",
  • "po_transport_mode": "string",
  • "attachments": [
    ]
}

Sales invoice

Data Element ID: sales_invoice

invoice_number
required
string (Invoice Number)

:A unique identification of the Invoice. The sequential number required in Article 226(2) of the directive 2006/112/EC [2], to uniquely identify the Invoice within the business context, time-frame, operating systems and records of the Seller. No identification scheme is to be used.
:Invoice Number
:A unique identification of the Invoice. The sequential number required in Article 226(2) of the directive 2006/112/EC [2], to uniquely identify the Invoice within the business context, time-frame, operating systems and records of the Seller. No identification scheme is to be used.
:PEPPOL
:NA

invoice_currency
required
string (Invoice Currency Code)

:The currency in which all Invoice amounts are given, except for the Total VAT amount in accounting currency. Only one currency shall be used in the Invoice, except for the VAT accounting currency code (BT-6) and the invoice total VAT amount in accounting currency (BT-111).
:Invoice Currency Code
:The currency in which all Invoice amounts are given, except for the Total VAT amount in accounting currency. Only one currency shall be used in the Invoice, except for the VAT accounting currency code (BT-6) and the invoice total VAT amount in accounting currency (BT-111).
:PEPPOL
:NA

invoice_unit_currency
required
string (Currency Unit)

:Mandatory attribute. Use BT-5 or BT-6.
:Currency Unit
:Mandatory attribute. Use BT-5 or BT-6.
:PEPPOL
:NA

invoice_date
string or null <date> (Invoice Issue Date)

:The date when the Invoice was issued. Format "YYYY-MM-DD"
:Invoice Issue Date
:The date when the Invoice was issued. Format "YYYY-MM-DD"
:PEPPOL
:NA

invoice_terms
string or null (Payment Terms)

:A textual description of the payment terms that apply to the amount due for payment (Including description of possible penalties). In case the Amount due for payment (BT-115) is positive, either the Payment due date (BT-9) or the Payment terms (BT-20) shall be present.
:Payment Terms
:A textual description of the payment terms that apply to the amount due for payment (Including description of possible penalties). In case the Amount due for payment (BT-115) is positive, either the Payment due date (BT-9) or the Payment terms (BT-20) shall be present.
:PEPPOL
:NA

invoice_date_due
string or null <date> (Payment Due Date)

:The date when the payment is due.Format "YYYY-MM-DD". In case the Amount due for payment (BT-115) is positive, either the Payment due date (BT-9) or the Payment terms (BT-20) shall be present.
:Payment Due Date
:The date when the payment is due.Format "YYYY-MM-DD". In case the Amount due for payment (BT-115) is positive, either the Payment due date (BT-9) or the Payment terms (BT-20) shall be present.
:PEPPOL
:NA

invoice_seller_company_name
string or null (Seller Trading Name)

:A name by which the Seller is known, other than Seller name (also known as Business name).
:Seller Trading Name
:A name by which the Seller is known, other than Seller name (also known as Business name).
:PEPPOL
:NA

invoice_seller_company_address
string or null (Seller Postal Address)

:A group of business terms providing information about the address of the Seller. Sufficient components of the address are to be filled to comply with legal requirements.
:Seller Postal Address
:A group of business terms providing information about the address of the Seller. Sufficient components of the address are to be filled to comply with legal requirements.
:PEPPOL
:NA

invoice_buyer_company_name
string or null (Buyer Trading Name)

:A name by which the Buyer is known, other than Buyer name (also known as Business name).
:Buyer Trading Name
:A name by which the Buyer is known, other than Buyer name (also known as Business name).
:PEPPOL
:NA

invoice_buyer_company_address
string or null (Buyer Postal Address)

:A group of business terms providing information about the postal address for the Buyer. Sufficient components of the address are to be filled to comply with legal requirements.
:Buyer Postal Address
:A group of business terms providing information about the postal address for the Buyer. Sufficient components of the address are to be filled to comply with legal requirements.
:PEPPOL
:NA

invoice_project_name
string or null (Project Name)

:The identification of the project the invoice refers to.
:Project Name
:The identification of the project the invoice refers to.
:NA
:NA

invoice_project_description
string or null (Project Description)

:Description of the project for which goods and services in the invoice are provided
:Project Description
:Description of the project for which goods and services in the invoice are provided
:NA
:NA

invoice_customer_no
string or null (Buyer Identifier)

:An identifier of the Buyer.
:Buyer Identifier
:An identifier of the Buyer.
:PEPPOL
:NA

invoice_gross_amount
number or null <double> (Sum Of Charges On Document Level)

:Sum of all charges on document level in the Invoice. Must be rounded to maximum 2 decimals.
:Sum Of Charges On Document Level
:Sum of all charges on document level in the Invoice. Must be rounded to maximum 2 decimals.
:PEPPOL
:NA

invoice_discount_amount
number or null <double> (Sum Of Allowances On Document Level)

:Sum of all allowances on document level in the Invoice. Must be rounded to maximum 2 decimals.
:Sum Of Allowances On Document Level
:Sum of all allowances on document level in the Invoice. Must be rounded to maximum 2 decimals.
:PEPPOL
:NA

invoice_tax_amount
number or null <double> (Invoice Total Vat Amount In Accounting Currency)

:The total VAT amount for the Invoice or the VAT total amount expressed in the accounting currency accepted or required in the country of the Seller. Must be rounded to maximum 2 decimals
:Invoice Total Vat Amount In Accounting Currency
:The total VAT amount for the Invoice or the VAT total amount expressed in the accounting currency accepted or required in the country of the Seller. Must be rounded to maximum 2 decimals
:PEPPOL
:NA

invoice_net_amount
number or null <double> (Amount Due For Payment)

:The outstanding amount that is requested to be paid. Must be rounded to maximum 2 decimals.
:Amount Due For Payment
:The outstanding amount that is requested to be paid. Must be rounded to maximum 2 decimals.
:PEPPOL
:NA

Array of objects or null (Item Details)

:Line-level details within Invoice
:Item Details
:Line-level details within Invoice
:NA
:NA

invoice_transport_details
string or null (Item Description)

:A description for an item.The item description allows for describing the item and its features in more detail than the Item name.
:Item Description
:A description for an item.The item description allows for describing the item and its features in more detail than the Item name.
:PEPPOL
:NA

invoice_transport_number
string or null (Despatch Advice Reference)

:An identifier of a referenced despatch advice.
:Despatch Advice Reference
:An identifier of a referenced despatch advice.
:PEPPOL
:NA

invoice_transportation_date
string or null <date> (Actual Delivery Date)

:The date on which the supply of goods or services was made or completed. Format = "YYYY-MM-DD"
:Actual Delivery Date
:The date on which the supply of goods or services was made or completed. Format = "YYYY-MM-DD"
:PEPPOL
:NA

invoice_delivery_from
string or null (Item Country Of Origin)

:The code identifying the country from which the item originates.
:Item Country Of Origin
:The code identifying the country from which the item originates.
:PEPPOL
:NA

invoice_delivery_to
string or null (Deliver To Address)

:A group of business terms providing information about the address to which goods and services invoiced were or are delivered.
:Deliver To Address
:A group of business terms providing information about the address to which goods and services invoiced were or are delivered.
:PEPPOL
:NA

invoice_fda_registration_number
string or null (Fda Registration Number )

:Unique FDA identifier of referenced bill of lading
:Fda Registration Number
:Unique FDA identifier of referenced bill of lading
:NA
:NA

invoice_certification_number
string or null (Certification Number )

:Certification number of invoiced goods
:Certification Number
:Certification number of invoiced goods
:NA
:NA

invoice_supplier_name
string or null (Seller Trading Name)

:A name by which the Seller is known, other than Seller name (also known as Business name).
:Seller Trading Name
:A name by which the Seller is known, other than Seller name (also known as Business name).
:PEPPOL
:NA

invoice_supplier_address
string or null (Seller Postal Address)

:A group of business terms providing information about the address of the Seller. Sufficient components of the address are to be filled to comply with legal requirements.
:Seller Postal Address
:A group of business terms providing information about the address of the Seller. Sufficient components of the address are to be filled to comply with legal requirements.
:PEPPOL
:NA

invoice_tt_beneficiary_name
string or null (Payee Name)

:The name of the Payee.
:Payee Name
:The name of the Payee.
:PEPPOL
:NA

invoice_tt_beneficiary_address
string or null (Address Of Beneficiary / Supplier (Tt) )

:Address of beneficiary
:Address Of Beneficiary / Supplier (Tt)
:Address of beneficiary
:NA
:NA

invoice_tt_beneficiary_account_number
string or null (Payment Account Identifier)

:A unique identifier of the financial payment account, at a payment service provider, to which payment should be made. Such as IBAN or BBAN.
:Payment Account Identifier
:A unique identifier of the financial payment account, at a payment service provider, to which payment should be made. Such as IBAN or BBAN.
:PEPPOL
:NA

invoice_tt_beneficiary_bank_name
string or null (Payment Account Name)

:The name of the payment account, at a payment service provider, to which payment should be made.
:Payment Account Name
:The name of the payment account, at a payment service provider, to which payment should be made.
:PEPPOL
:NA

invoice_tt_beneficiary_bank_address
string or null (Address Of Beneficiary Bank (TT) )

:Address of beneficiary bank
:Address Of Beneficiary Bank (TT)
:Address of beneficiary bank
:NA
:NA

invoice_tt_beneficiary_receiving_agent
string or null (Receiving Agent Of Beneficiary Bank (TT) )

:Receiving Agent of Beneficiary's bank
:Receiving Agent Of Beneficiary Bank (TT)
:Receiving Agent of Beneficiary's bank
:NA
:NA

invoice_co_beneficiary_name
string or null (Payee Name)

:The name of the Payee.
:Payee Name
:The name of the Payee.
:PEPPOL
:NA

invoice_co_beneficiary_account_name
string or null (Payment Account Identifier)

:A unique identifier of the financial payment account, at a payment service provider, to which payment should be made. Such as IBAN or BBAN.
:Payment Account Identifier
:A unique identifier of the financial payment account, at a payment service provider, to which payment should be made. Such as IBAN or BBAN.
:PEPPOL
:NA

invoice_co_beneficiary_account_number
string or null (Payment Account Name)

:The name of the payment account, at a payment service provider, to which payment should be made.
:Payment Account Name
:The name of the payment account, at a payment service provider, to which payment should be made.
:PEPPOL
:NA

invoice_co_other_instructions
string or null (Payment Means Text)

:The means, expressed as text, for how a payment is expected to be or has been settled.
:Payment Means Text
:The means, expressed as text, for how a payment is expected to be or has been settled.
:PEPPOL
:NA

Array of objects or null (Sales Invoice Attachment)

:Sales Invoice Attachment
:Sales Invoice Attachment
:Sales Invoice Attachment
:NA
:NA

{
  • "invoice_number": "string",
  • "invoice_currency": "string",
  • "invoice_unit_currency": "string",
  • "invoice_date": "2019-08-24",
  • "invoice_terms": "string",
  • "invoice_date_due": "2019-08-24",
  • "invoice_seller_company_name": "string",
  • "invoice_seller_company_address": "string",
  • "invoice_buyer_company_name": "string",
  • "invoice_buyer_company_address": "string",
  • "invoice_project_name": "string",
  • "invoice_project_description": "string",
  • "invoice_customer_no": "string",
  • "invoice_gross_amount": 0.1,
  • "invoice_discount_amount": 0.1,
  • "invoice_tax_amount": 0.1,
  • "invoice_net_amount": 0.1,
  • "invoice_item_details": [
    ],
  • "invoice_transport_details": "string",
  • "invoice_transport_number": "string",
  • "invoice_transportation_date": "2019-08-24",
  • "invoice_delivery_from": "string",
  • "invoice_delivery_to": "string",
  • "invoice_fda_registration_number": "string",
  • "invoice_certification_number": "string",
  • "invoice_supplier_name": "string",
  • "invoice_supplier_address": "string",
  • "invoice_tt_beneficiary_name": "string",
  • "invoice_tt_beneficiary_address": "string",
  • "invoice_tt_beneficiary_account_number": "string",
  • "invoice_tt_beneficiary_bank_name": "string",
  • "invoice_tt_beneficiary_bank_address": "string",
  • "invoice_tt_beneficiary_receiving_agent": "string",
  • "invoice_co_beneficiary_name": "string",
  • "invoice_co_beneficiary_account_name": "string",
  • "invoice_co_beneficiary_account_number": "string",
  • "invoice_co_other_instructions": "string",
  • "attachments": [
    ]
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

:Note
:Note
:Note
:NA
:NA

Array of objects or null (Other Documents Attachment)

:Other Documents Attachment
:Other Documents Attachment
:Other Documents Attachment
:NA
:NA

{
  • "note": "string",
  • "attachments": [
    ]
}

Use Case D (Parameters)

Parameter schemas for Use Case D

Agrifood Purchase Order

Data Element ID: agrifood_purchase_order

apo_user_id
number or null (User ID)

User ID

apo_buyer
number or null (Buyer)

Buyer

apo_supplier
number or null (Supplier)

Supplier

apo_trade_contract_number
string or null (Trade Contract Number)

Trade Contract Number

apo_status
string (Status)

Status

apo_company_id
number or null (Company ID)

Company ID

{
  • "apo_user_id": 0,
  • "apo_buyer": 0,
  • "apo_supplier": 0,
  • "apo_trade_contract_number": "string",
  • "apo_status": "string",
  • "apo_company_id": 0
}

Delivery Order

Data Element ID: delivery_order

do_number
required
string (Delivery Order Number)

Unique identifier for invoice referred in delivery order

do_invoice_number
string or null (Invoice Number )

Unique identifier for delivery order

{
  • "do_number": "string",
  • "do_invoice_number": "string"
}

Goods Receipt

Data Element ID: goods_receipt

gr_number
string or null (Goods Receipt No. )

Unique identifier for delivery order referred in goods receipt

{
  • "gr_number": "string"
}

Green Building Certification

Data Element ID: green_building_certification

gbc_name_certified_company
string or null (Registered Name of Certified Company )

Registered Name of Certified Company

gbc_certified_project
string or null (Registered Name of Certified Project )

Registered Name of Certified Project

gbc_postcode_certified_location
string or null (Postcode of Certified Location)

Postcode of Certified Location

{
  • "gbc_name_certified_company": "string",
  • "gbc_certified_project": "string",
  • "gbc_postcode_certified_location": "string"
}

Green Product Certification

Data Element ID: green_product_certification

gpc_name_certified_company
string or null (Name of Certified Company )

Registered Name of Certified Company

gpc_certification_number
required
string (Certification Number )

Certification Number

gpc_licence_number
string or null (License Number )

License Number

{
  • "gpc_name_certified_company": "string",
  • "gpc_certification_number": "string",
  • "gpc_licence_number": "string"
}

Interim Certificate

Data Element ID: interim_certificate

ic_certificate_no
required
string (Certificate No )

Unique identifier for interim certificate

{
  • "ic_certificate_no": "string"
}

Invoice Finance Application

Data Element ID: invoice_finance_application

ifa_application_id
required
string (Trade Financing Application Id)

Unique application reference number

{
  • "ifa_application_id": "string"
}

Invoice Finance Response

Data Element ID: invoice_finance_response

ifr_transaction_reference_number
string or null (Transaction Reference Number )

Transaction Reference Number

{
  • "ifr_transaction_reference_number": "string"
}

Palm Oil Entity Certification

Data Element ID: palm_oil_entity_certification

poec_name_certified_entity
string or null (Name Of Certified Entity)

Name of Certified Entity

poec_certification_number
required
string (Certification Number )

Certification Number

poec_license_number
string or null (License Number )

License Number

poec_name_parent_company
string or null (Parent Company)

Parent Company

poec_membership_number
string or null (Membership Number Of Certified Entity / Parent Company)

Membership Number of Certified Entity / Parent Company

{
  • "poec_name_certified_entity": "string",
  • "poec_certification_number": "string",
  • "poec_license_number": "string",
  • "poec_name_parent_company": "string",
  • "poec_membership_number": "string"
}

Payment Progress Certificate

Data Element ID: payment_progress_certificate

ppc_project_number
string or null (Project No.)

Unique Identifier for project

{
  • "ppc_project_number": "string"
}

Payment Response

Data Element ID: payment_response

pr_project_number
string or null (Project No.)

Unique Identifier for project

{
  • "pr_project_number": "string"
}

Purchase Order

Data Element ID: purchase_order

po_buyer
string or null (Buyer)

Field UID: ORD- 0011-The entity contains the details of the buyer.

{
  • "po_buyer": "string"
}

Sales invoice

Data Element ID: sales_invoice

invoice_number
required
string (Invoice Number)

A unique identification of the Invoice. The sequential number required in Article 226(2) of the directive 2006/112/EC [2], to uniquely identify the Invoice within the business context, time-frame, operating systems and records of the Seller. No identification scheme is to be used.

{
  • "invoice_number": "string"
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

Note

{
  • "note": "string"
}

Use Case E (Payload)

Payload schemas for Use Case E

Crane Blockage

Data Element ID: crane_blockage

status
required
string (Status)

:Status of the request
:Status
:Status of the request
:NA
:NA

error
string or null (Error)

:Error message, if any
:Error
:Error message, if any
:NA
:NA

required
Array of objects (Results)

:Results of the request
:Results
:Results of the request
:NA
:NA

{
  • "status": "string",
  • "error": "string",
  • "results": [
    ]
}

Delivery Shipment Advice

Data Element ID: delivery_shipment_advice

dsa_terminal_nm
required
string (Terminal)

:Terminal e.g. Penjuru Lighter Terminal (P) or Marina South Wharves (N)
:Terminal
:Terminal e.g. Penjuru Lighter Terminal (P) or Marina South Wharves (N)
:JP
:"P" or "N". Min characters = 1, Max characters = 255, Alphabetical Characters

dsa_no
string or null (DSA)

:Unique identifier for DSA. Delivery Shipment Advice
:DSA
:Unique identifier for DSA. Delivery Shipment Advice
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

dsa_status
required
string (DSA Status)

:Status of DSA (e.g. created, checked-in, cancelled, voided)
:DSA Status
:Status of DSA (e.g. created, checked-in, cancelled, voided)
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

dsa_usn
string or null (USN)

:Unique identifier for job. Unique Shipment Number
:USN
:Unique identifier for job. Unique Shipment Number
:JP
:9 characters, Alphanumeric, ends with 1 Alphabetical Character

dsa_check_in_dt_time
string or null <date-time> (Check-In Date and Time)

:Timestamp when truck checks into LTConnect nearby JP terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" when sharing/receiving data with/from JP.
:Check-In Date and Time
:Timestamp when truck checks into LTConnect nearby JP terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" when sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_uncheck_in_dt_time
string or null <date-time> (Uncheck-In Date and Time)

:Timestamp when (if) truck checks out from LTConnect nearby JP terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:Uncheck-In Date and Time
:Timestamp when (if) truck checks out from LTConnect nearby JP terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_cargo_declarant
required
string (Cargo Declarant)

:Name of cargo declarant
:Cargo Declarant
:Name of cargo declarant
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

dsa_lighter_operator
string or null (Lighter Operator)

:Name of assigned Lighter Operator for job
:Lighter Operator
:Name of assigned Lighter Operator for job
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

dsa_mother_vessel
string or null (Mother Vessel)

:Mother Vessel Name
:Mother Vessel
:Mother Vessel Name
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

dsa_mother_vessel_imo
string or null (Mother Vessel IMO)

:Mother Vessel IMO number
:Mother Vessel IMO
:Mother Vessel IMO number
:IMO
:7 characters, Numeric

dsa_truck_no
string or null (Truck Number)

:Vehicle number of truck entering JP terminal
:Truck Number
:Vehicle number of truck entering JP terminal
:LTA
:8 characters, Alphanumeric

dsa_driver_pass_id
string or null (Driver Pass ID)

:JP Pass ID of truck driver entering JP terminal
:Driver Pass ID
:JP Pass ID of truck driver entering JP terminal
:JP
:Min characters = 1, Max characters = 255, Numeric

dsa_driver_id
string or null (Driver ID)

:Registered ID of truck driver entering JP terminal (IC/Work Permit)
:Driver ID
:Registered ID of truck driver entering JP terminal (IC/Work Permit)
:JP
:Min characters = 1, Max characters = 255, Numeric

dsa_gate_in_dt_time
string or null <date-time> (Gate-In Date and Time)

:Actual time when truck enter JP terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:Gate-In Date and Time
:Actual time when truck enter JP terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_lifting_start_dt_time
string or null <date-time> (Lifting Start Date and Time)

:Time when crane lifting operations star. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:Lifting Start Date and Time
:Time when crane lifting operations star. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_lifting_end_dt_time
string or null <date-time> (Lifting End Date and Time)

:Time when crane lifting operations end. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:Lifting End Date and Time
:Time when crane lifting operations end. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_wharf_in_dt_time
string or null <date-time> (Wharf-In Date and Time)

:Time when Lighter Boat enters alongside wharf. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:Wharf-In Date and Time
:Time when Lighter Boat enters alongside wharf. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_atb_dt_time
string or null <date-time> (ATB Date and Time)

:Actual Time of main lighter boat berthing at lighter terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ATB Date and Time
:Actual Time of main lighter boat berthing at lighter terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_atu_dt_time
string or null <date-time> (ATU Date and Time)

:Actual Time of main lighter boat unberthing at lighter terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ATU Date and Time
:Actual Time of main lighter boat unberthing at lighter terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_lighter_nm
string or null (Lighter Name)

:Name of the Lighter Boat
:Lighter Name
:Name of the Lighter Boat
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

dsa_vessel_movement_no
string or null (Vessel Movement Number)

:Unique identifier for vessel call
:Vessel Movement Number
:Unique identifier for vessel call
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

dsa_crane_no
string or null (Crane Number)

:Identifier number for crane assigned to perform lifts for cargo onto boats
:Crane Number
:Identifier number for crane assigned to perform lifts for cargo onto boats
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

dsa_crane_start_dt_time
string or null <date-time> (Crane Start Date and Time)

:Start datetime for Crane operation in performing cargo lift onto boats. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:Crane Start Date and Time
:Start datetime for Crane operation in performing cargo lift onto boats. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_crane_end_dt_time
string or null <date-time> (Crane End Date and Time)

:End datetime for Crane operation in performing cargo lift onto boats. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:Crane End Date and Time
:End datetime for Crane operation in performing cargo lift onto boats. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_gate_out_dt_time
string or null <date-time> (Gate-Out Date and Time)

:Timestamp for when truck exits JP terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:Gate-Out Date and Time
:Timestamp for when truck exits JP terminal. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_cargo_type
string or null (Cargo Type)

:Nature of cargo being delivered by truck (normal or special). JP will hardcode this field to N - normal cargo.
:Cargo Type
:Nature of cargo being delivered by truck (normal or special). JP will hardcode this field to N - normal cargo.
:JP
:"N" by default (hardcoded by JP). Min characters = 1, Max characters = 255, Alphanumeric

dsa_total_no_of_lift
integer or null <int64> (Total No. of Lifts)

:Total number of crane lifts performed for DSA
:Total No. of Lifts
:Total number of crane lifts performed for DSA
:JP
:Min characters = 1, Max characters = 255, Numeric

dsa_payment_mode
string or null (Payment Mode)

:Cash or Credit (account from JP)
:Payment Mode
:Cash or Credit (account from JP)
:JP
:"Cash" or "Credit"

dsa_bill_status
string or null (Bill Status)

:Status of the bill with regards to handling charges (cranage, wharfage)
:Bill Status
:Status of the bill with regards to handling charges (cranage, wharfage)
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

dsa_bill_receipt_no
string or null (Bill / Receipt Number)

:Number of the bill / receipt
:Bill / Receipt Number
:Number of the bill / receipt
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

dsa_bill_receipt_dt
string or null <date-time> (Bill / Receipt Date)

:Date of the bill / receipt. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:Bill / Receipt Date
:Date of the bill / receipt. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_total_wharfage
number or null <double> (Total Wharfage ($))

:Wharfage charged
:Total Wharfage ($)
:Wharfage charged
:JP
:Min characters = 1, Max characters = 255, Numeric

dsa_total_cranage
number or null <double> (Total Cranage ($))

:Cranage charged
:Total Cranage ($)
:Cranage charged
:JP
:Min characters = 1, Max characters = 255, Numeric

dsa_additional_charge
number or null <double> (Additional Charge ($))

:Any additional charges
:Additional Charge ($)
:Any additional charges
:JP
:Min characters = 1, Max characters = 255, Numeric

dsa_total_charges
number or null <double> (Total Charges ($))

:Total charges
:Total Charges ($)
:Total charges
:JP
:Min characters = 1, Max characters = 255, Numeric

dsa_time_stamp
required
string <date-time> (Last Update Date and Time)

:Last update Date and Time of DSA. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:Last Update Date and Time
:Last update Date and Time of DSA. Please omit the decimal seconds in the date-time format. E.g. If system is providing "2013-02-05 16:32:24.999000", please change to "2013-02-05 16:32:25" sharing/receiving data with/from JP.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ). Please omit the decimal seconds, if any.

dsa_internal_identifier
string or null (Internal Identifier)

:Internal Identifier of Loading Parties
:Internal Identifier
:Internal Identifier of Loading Parties
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

Array of objects or null (Export Cargo Details)

:Export Cargo Details
:Export Cargo Details
:Export Cargo Details
:NA
:NA

Array of objects or null (Import Cargo Details)

:Import Cargo Details
:Import Cargo Details
:Import Cargo Details
:NA
:NA

{
  • "dsa_terminal_nm": "string",
  • "dsa_no": "string",
  • "dsa_status": "string",
  • "dsa_usn": "string",
  • "dsa_check_in_dt_time": "2019-08-24T14:15:22Z",
  • "dsa_uncheck_in_dt_time": "2019-08-24T14:15:22Z",
  • "dsa_cargo_declarant": "string",
  • "dsa_lighter_operator": "string",
  • "dsa_mother_vessel": "string",
  • "dsa_mother_vessel_imo": "string",
  • "dsa_truck_no": "string",
  • "dsa_driver_pass_id": "string",
  • "dsa_driver_id": "string",
  • "dsa_gate_in_dt_time": "2019-08-24T14:15:22Z",
  • "dsa_lifting_start_dt_time": "2019-08-24T14:15:22Z",
  • "dsa_lifting_end_dt_time": "2019-08-24T14:15:22Z",
  • "dsa_wharf_in_dt_time": "2019-08-24T14:15:22Z",
  • "dsa_atb_dt_time": "2019-08-24T14:15:22Z",
  • "dsa_atu_dt_time": "2019-08-24T14:15:22Z",
  • "dsa_lighter_nm": "string",
  • "dsa_vessel_movement_no": "string",
  • "dsa_crane_no": "string",
  • "dsa_crane_start_dt_time": "2019-08-24T14:15:22Z",
  • "dsa_crane_end_dt_time": "2019-08-24T14:15:22Z",
  • "dsa_gate_out_dt_time": "2019-08-24T14:15:22Z",
  • "dsa_cargo_type": "string",
  • "dsa_total_no_of_lift": 0,
  • "dsa_payment_mode": "string",
  • "dsa_bill_status": "string",
  • "dsa_bill_receipt_no": "string",
  • "dsa_bill_receipt_dt": "2019-08-24T14:15:22Z",
  • "dsa_total_wharfage": 0.1,
  • "dsa_total_cranage": 0.1,
  • "dsa_additional_charge": 0.1,
  • "dsa_total_charges": 0.1,
  • "dsa_time_stamp": "2019-08-24T14:15:22Z",
  • "dsa_internal_identifier": "string",
  • "dsa_export_cargo_details": [
    ],
  • "dsa_import_cargo_details": [
    ]
}

Job Report (USN)

Data Element ID: job_report_usn

jr_usn
required
string (USN)

:Unique identifier for job. Unique Shipment Number
:USN
:Unique identifier for job. Unique Shipment Number
:JP
:9 characters, Alphanumeric, ends with 1 Alphabetical Character

jr_job_owner
required
string (Job Owner)

:Name of Job creator e.g. Ship Chandler or Lighter Operator (appointed by Ship Agency)
:Job Owner
:Name of Job creator e.g. Ship Chandler or Lighter Operator (appointed by Ship Agency)
:JP
:Min characters = 1, Max characters = 255, Alphabetical Characters

jr_lighter_operator
required
string (Lighter Operator)

:Name of assigned Lighter Operator
:Lighter Operator
:Name of assigned Lighter Operator
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

jr_etb
required
string <date-time> (ETB)

:Estimated Time of Berthing for Lighter Boats at Lighter Terminal
:ETB
:Estimated Time of Berthing for Lighter Boats at Lighter Terminal
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

jr_loading_status
required
string (Loading Status)

:Updated status for cargo loading onto lighter boat
:Loading Status
:Updated status for cargo loading onto lighter boat
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

jr_main_lighter_operator
required
string (Main Lighter Operator)

:Name of assigned Lighter Operator
:Main Lighter Operator
:Name of assigned Lighter Operator
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

jr_main_lighter_nm
required
string (Main Lighter Name)

:Name of assigned Lighter Boat
:Main Lighter Name
:Name of assigned Lighter Boat
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

jr_sub_lighter_operator
string or null (Sub Lighter Operator)

:Name of assigned Sub Lighter Operator
:Sub Lighter Operator
:Name of assigned Sub Lighter Operator
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

jr_sub_lighter_nm
string or null (Sub Lighter Name)

:Name of assigned Sub Lighter Boat
:Sub Lighter Name
:Name of assigned Sub Lighter Boat
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

jr_mother_vessel_abbrev_nm
string or null (Mother Vessel Abbreviated Name)

:Name of receiving vessel
:Mother Vessel Abbreviated Name
:Name of receiving vessel
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

jr_careoff_total_no
number or null (Total No. of Careoff)

:Total number of careoff parties
:Total No. of Careoff
:Total number of careoff parties
:JP
:Min characters = 1, Max characters = 255, Numeric

jr_dsa_total_no
number or null (Total No. of DSA)

:Total Number of utilised DSA forms (Delivery Shipment Advice)
:Total No. of DSA
:Total Number of utilised DSA forms (Delivery Shipment Advice)
:JP
:Min characters = 1, Max characters = 255, Numeric

jr_truck_total_no
number or null (Total No. of Truck)

:Total Number of trucks expected to pass through JP Terminal to deliver cargo
:Total No. of Truck
:Total Number of trucks expected to pass through JP Terminal to deliver cargo
:JP
:Min characters = 1, Max characters = 255, Numeric

jr_total_no_of_lifts
number or null (Total No. of Lifts)

:Total number of crane lifts performed for loading (combined lifts for all DSAs under USN)
:Total No. of Lifts
:Total number of crane lifts performed for loading (combined lifts for all DSAs under USN)
:JP
:Min characters = 1, Max characters = 255, Numeric

jr_total_tonnage
number or null (Total Tonnage)

:Total weightage of cargo passing through terminal transferred onto lighter boats
:Total Tonnage
:Total weightage of cargo passing through terminal transferred onto lighter boats
:JP
:Min characters = 1, Max characters = 255, Numeric

jr_main_lighter_atb
string or null <date-time> (Main Lighter ATB Date and Time)

:Actual Time of main lighter boat berthing at lighter terminal
:Main Lighter ATB Date and Time
:Actual Time of main lighter boat berthing at lighter terminal
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

jr_main_lighter_atu
string or null <date-time> (Main Lighter ATU Date and Time)

:Actual Time of main lighter boat unberthing at lighter terminal
:Main Lighter ATU Date and Time
:Actual Time of main lighter boat unberthing at lighter terminal
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

jr_main_lighter_port_stay_mins
string or null <date-time> (Main Lighter Port Stay (min))

:Actual portstay time of main lighter boat (ATU-ATB)
:Main Lighter Port Stay (min)
:Actual portstay time of main lighter boat (ATU-ATB)
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) duration - string (date-time)

jr_sub_lighter_atb
string or null <date-time> (Sub Lighter ATB Date and Time)

:Actual Time of sub lighter boat berthing at lighter terminal
:Sub Lighter ATB Date and Time
:Actual Time of sub lighter boat berthing at lighter terminal
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

jr_sub_lighter_atu
string or null <date-time> (Sub Lighter ATU Date and Time)

:Actual Time of sub lighter boat unberthing at lighter terminal
:Sub Lighter ATU Date and Time
:Actual Time of sub lighter boat unberthing at lighter terminal
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

jr_sub_lighter_port_stay_mins
string or null <date-time> (Sub Lighter Port Stay (min))

:Actual portstay time of sub lighter boat (ATU-ATB)
:Sub Lighter Port Stay (min)
:Actual portstay time of sub lighter boat (ATU-ATB)
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) duration - string (date-time)

jr_total_port_stay_mins
string or null <date-time> (Total Port Stay (min))

:Total Port Stay (min)
:Total Port Stay (min)
:Total Port Stay (min)
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) duration - string (date-time)

jr_late_check_in_truck
boolean or null (Late Check-In (Truck))

:Late Check-In (Truck)
:Late Check-In (Truck)
:Late Check-In (Truck)
:JP
:"Yes" or "No"

jr_late_check_in_main_lighter
boolean or null (Late Check-In (Main Lighter))

:Late Check-In (Main Lighter)
:Late Check-In (Main Lighter)
:Late Check-In (Main Lighter)
:JP
:"Yes" or "No"

jr_late_check_in_sub_lighter
boolean or null (Late Check-In (Sub Lighter))

:Late Check-In (Sub Lighter)
:Late Check-In (Sub Lighter)
:Late Check-In (Sub Lighter)
:JP
:"Yes" or "No"

jr_no_show_main_lighter
boolean or null (No Show (Main Lighter))

:No Show (Main Lighter)
:No Show (Main Lighter)
:No Show (Main Lighter)
:JP
:"Yes" or "No"

jr_no_show_sub_lighter
boolean or null (No Show (Sub Lighter))

:No Show (Sub Lighter)
:No Show (Sub Lighter)
:No Show (Sub Lighter)
:JP
:"Yes" or "No"

{
  • "jr_usn": "string",
  • "jr_job_owner": "string",
  • "jr_lighter_operator": "string",
  • "jr_etb": "2019-08-24T14:15:22Z",
  • "jr_loading_status": "string",
  • "jr_main_lighter_operator": "string",
  • "jr_main_lighter_nm": "string",
  • "jr_sub_lighter_operator": "string",
  • "jr_sub_lighter_nm": "string",
  • "jr_mother_vessel_abbrev_nm": "string",
  • "jr_careoff_total_no": 0,
  • "jr_dsa_total_no": 0,
  • "jr_truck_total_no": 0,
  • "jr_total_no_of_lifts": 0,
  • "jr_total_tonnage": 0,
  • "jr_main_lighter_atb": "2019-08-24T14:15:22Z",
  • "jr_main_lighter_atu": "2019-08-24T14:15:22Z",
  • "jr_main_lighter_port_stay_mins": "2019-08-24T14:15:22Z",
  • "jr_sub_lighter_atb": "2019-08-24T14:15:22Z",
  • "jr_sub_lighter_atu": "2019-08-24T14:15:22Z",
  • "jr_sub_lighter_port_stay_mins": "2019-08-24T14:15:22Z",
  • "jr_total_port_stay_mins": "2019-08-24T14:15:22Z",
  • "jr_late_check_in_truck": true,
  • "jr_late_check_in_main_lighter": true,
  • "jr_late_check_in_sub_lighter": true,
  • "jr_no_show_main_lighter": true,
  • "jr_no_show_sub_lighter": true
}

Lighter Boat Loading Confirmation

Data Element ID: lighter_boat_loading_confirmation

lighter_boat_loading_confirmation_usn
required
string (USN)

:Unique identifier for job. Unique Shipment Number
:USN
:Unique identifier for job. Unique Shipment Number
:JP
:9 characters, Alphanumeric, ends with 1 Alphabetical Character

lighter_boat_loading_confirmation_dsa_no
required
string (DSA)

:Unique identifier for DSA. Delivery Shipment Advice
:DSA
:Unique identifier for DSA. Delivery Shipment Advice
:JP
:12 characters, Numeric

lighter_boat_loading_confirmation_terminal
required
string (Terminal)

:Terminal e.g. Penjuru Lighter Terminal (PLT) or Marina South Wharves (MSW)
:Terminal
:Terminal e.g. Penjuru Lighter Terminal (PLT) or Marina South Wharves (MSW)
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

lighter_boat_loading_confirmation_loading_completed_dt_time
required
string <date-time> (Loading Completed Date and Time)

:Loading Completed Date and Time
:Loading Completed Date and Time
:Loading Completed Date and Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

Array of objects or null (Lighter Boat Loading Confirmation Attachment) non-empty

:Lighter Boat Loading Confirmation Attachment
:Lighter Boat Loading Confirmation Attachment
:Lighter Boat Loading Confirmation Attachment
:NA
:.JPEG/.PNG/.TIFF/.PDF

{
  • "lighter_boat_loading_confirmation_usn": "string",
  • "lighter_boat_loading_confirmation_dsa_no": "string",
  • "lighter_boat_loading_confirmation_terminal": "string",
  • "lighter_boat_loading_confirmation_loading_completed_dt_time": "2019-08-24T14:15:22Z",
  • "attachments": [
    ]
}

Lighter Boat Location

Data Element ID: lighter_boat_location

lighter_loc_snapshot_dt_time
required
string <date-time> (Snapshot Date-Time)

:Timestamp of this record being captured
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_loc_geofence
string or null (Geofence of Interest)

:Geofence of Interest that boat coordinates (Latitude, Longitude, Altitude (Optional)) fall within
:Geofence of Interest
:Geofence of Interest that boat coordinates (Latitude, Longitude, Altitude (Optional)) fall within
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

lighter_loc_position_radius
required
string (Position Radius (metres))

:Radius of coverage from provided lighter boat coordinates
:Position Radius (metres)
:Radius of coverage from provided lighter boat coordinates
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

lighter_loc_supply_boat_id
required
string (Supply boat Identifier)

:Supply boat Identifier
:Supply boat Identifier
:Supply boat Identifier
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

lighter_loc_position_latitude
required
number (Position Latitude)

:Latitude coordinates of lighter boat. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10
:Position Latitude
:Latitude coordinates of lighter boat. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10
:Decimal Degrees
:Min value = -90, Max value = 90

lighter_loc_position_longitude
required
number (Position Longtitude)

:Longitude coordinates of lighter boat. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10
:Position Longtitude
:Longitude coordinates of lighter boat. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10
:Decimal Degrees
:Min value = -180, Max value = 180

lighter_loc_heading
required
number (Heading)

:Direction in which lighter is pointing. This field has a commonly agreed minimum decimal precision = 0 and maximum decimal precision = 2
:Heading
:Direction in which lighter is pointing. This field has a commonly agreed minimum decimal precision = 0 and maximum decimal precision = 2
:Decimal Degrees
:Min value = 0, Max value = 360

{
  • "lighter_loc_snapshot_dt_time": "2019-08-24T14:15:22Z",
  • "lighter_loc_geofence": "string",
  • "lighter_loc_position_radius": "string",
  • "lighter_loc_supply_boat_id": "string",
  • "lighter_loc_position_latitude": 0,
  • "lighter_loc_position_longitude": 0,
  • "lighter_loc_heading": 0
}

Lighter Boat Schedule

Data Element ID: lighter_boat_schedule

lighter_schedule_usn
required
string (USN)

:Unique identifier for job. Unique Shipment Number
:USN
:Unique identifier for job. Unique Shipment Number
:JP
:9 characters, Alphanumeric, ends with 1 Alphabetical Character

lighter_schedule_eta_at_terminal
required
string <date-time> (ETA at Terminal)

:Estimated Time of Arrival (ETA) at terminal
:ETA at Terminal
:Estimated Time of Arrival (ETA) at terminal
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_schedule_eta_at_vessel
string or null <date-time> (Vessel ETA)

:Estimated Time of Arrival (ETA) at vessel
:Vessel ETA
:Estimated Time of Arrival (ETA) at vessel
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_schedule_et_cast_off_from_vessel
string or null <date-time> (ET Cast-Off from Vessel)

:Estimated Time (ET) of Cast-Off from Vessel
:ET Cast-Off from Vessel
:Estimated Time (ET) of Cast-Off from Vessel
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_schedule_supply_boat_job_id
string or null (Supply boat Job Identifier)

:Supply boat Job Identifier
:Supply boat Job Identifier
:Supply boat Job Identifier
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

lighter_schedule_job_start_time
string or null <date-time> (Job Start Time)

:Job Start Time
:Job Start Time
:Job Start Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_schedule_ata
string or null <date-time> (Actual Time Arrival at Vessel)

:Actual Time Arrival at Vessel
:Actual Time Arrival at Vessel
:Actual Time Arrival at Vessel
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_schedule_atc
string or null <date-time> (AT Cast-Off from Vessel)

:Actual Time (AT) of Cast-Off from Vessel
:AT Cast-Off from Vessel
:Actual Time (AT) of Cast-Off from Vessel
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_schedule_job_end_time
string or null <date-time> (Job End Time)

:Job End Time
:Job End Time
:Job End Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_schedule_supply_boat_id
required
string (Supply boat Identifier)

:Supply boat Identifier
:Supply boat Identifier
:Supply boat Identifier
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

lighter_schedule_query_dt_time
required
string <date-time> (Query DateTime)

:Query DateTime
:Query DateTime
:Query DateTime
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_schedule_speed
number or null (Speed)

:Speed
:Speed
:Speed
:NA
:Min characters = 1, Max characters = 255, Numeric

lighter_schedule_time_stamp
required
string <date-time> (Last Update Date and Time)

:Last update Date and Time of Lighter Boat Schedule
:Last Update Date and Time
:Last update Date and Time of Lighter Boat Schedule
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

Array of objects or null (Lighter Boat Schedule Attachment) non-empty

:Lighter Boat Schedule Attachment
:Lighter Boat Schedule Attachment
:Lighter Boat Schedule Attachment
:NA
:.JPEG/.PNG/.TIFF/.PDF

{
  • "lighter_schedule_usn": "string",
  • "lighter_schedule_eta_at_terminal": "2019-08-24T14:15:22Z",
  • "lighter_schedule_eta_at_vessel": "2019-08-24T14:15:22Z",
  • "lighter_schedule_et_cast_off_from_vessel": "2019-08-24T14:15:22Z",
  • "lighter_schedule_supply_boat_job_id": "string",
  • "lighter_schedule_job_start_time": "2019-08-24T14:15:22Z",
  • "lighter_schedule_ata": "2019-08-24T14:15:22Z",
  • "lighter_schedule_atc": "2019-08-24T14:15:22Z",
  • "lighter_schedule_job_end_time": "2019-08-24T14:15:22Z",
  • "lighter_schedule_supply_boat_id": "string",
  • "lighter_schedule_query_dt_time": "2019-08-24T14:15:22Z",
  • "lighter_schedule_speed": 0,
  • "lighter_schedule_time_stamp": "2019-08-24T14:15:22Z",
  • "attachments": [
    ]
}

Lighter Call

Data Element ID: lighter_call

lighter_call_terminal
required
string (Terminal)

:Terminal e.g. Penjuru Lighter Terminal (PLT) or Marina South Wharves (MSW)
:Terminal
:Terminal e.g. Penjuru Lighter Terminal (PLT) or Marina South Wharves (MSW)
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

lighter_call_lighter_nm
required
string (Lighter Name)

:Name of lighter
:Lighter Name
:Name of lighter
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

lighter_call_etb
required
string <date-time> (Booked Slot Date and Time (ETB))

:Berth booking allocated following application
:Booked Slot Date and Time (ETB)
:Berth booking allocated following application
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_call_etb_booking_submission_time
string or null <date-time> (ETB - Booking Submission Time)

:Estimated Time of Berthing for Lighter Boats at Lighter Terminal
:ETB - Booking Submission Time
:Estimated Time of Berthing for Lighter Boats at Lighter Terminal
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_call_atb
string or null <date-time> (ATB Date and Time)

:Actual Time of lighter boat berthing at lighter terminal
:ATB Date and Time
:Actual Time of lighter boat berthing at lighter terminal
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_call_crane_no
string or null (Crane Number)

:Assigned crane to perform cargo lifts
:Crane Number
:Assigned crane to perform cargo lifts
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

lighter_call_berth_no
string or null (Berth No.)

:Actual berth the lighter boat berth at lighter terminal
:Berth No.
:Actual berth the lighter boat berth at lighter terminal
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

lighter_call_usn
required
string (USN)

:Unique identifier for job. Unique Shipment Number.
:USN
:Unique identifier for job. Unique Shipment Number.
:JP
:9 characters, Alphanumeric, ends with 1 Alphabetical Character

lighter_call_lighter_operator
required
string (Lighter Operator)

:Name of Lighter Boat Operator assigned to job
:Lighter Operator
:Name of Lighter Boat Operator assigned to job
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

lighter_call_booking_by
required
string (Booking By)

:Name of staff making berth booking application
:Booking By
:Name of staff making berth booking application
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

lighter_call_booking_submitted_dt_time
required
string <date-time> (Booking Submitted Date and Time)

:Timestamp of berth booking application submission recorded
:Booking Submitted Date and Time
:Timestamp of berth booking application submission recorded
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_call_check_in_by
string or null (Check-In By)

:Name of staff making check-in
:Check-In By
:Name of staff making check-in
:JP
:Min characters = 1, Max characters = 255, Alphabetical Characters

lighter_call_check_in_dt
string or null <date-time> (Check-In Date and Time)

:Timestamp of lighter boat check in when nearby terminal
:Check-In Date and Time
:Timestamp of lighter boat check in when nearby terminal
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_call_check_in_etb
string or null <date-time> (Check-In - ETB)

:Actual time of lighter check in vs booking time
:Check-In - ETB
:Actual time of lighter check in vs booking time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_call_uncheck_in_dt_time
string or null <date-time> (Uncheck-In Date and Time)

:Timestamp of lighter boat check out when leaving terminal
:Uncheck-In Date and Time
:Timestamp of lighter boat check out when leaving terminal
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_call_atu
string or null <date-time> (ATU Date and Time)

:Actual Time of Unberthing (ATU) Date and Time
:ATU Date and Time
:Actual Time of Unberthing (ATU) Date and Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_call_atu_atb_portstay
string or null <date-time> (ATU-ATB (Portstay))

:Period of time lighter boat berthed at terminal (ATU - ATB)
:ATU-ATB (Portstay)
:Period of time lighter boat berthed at terminal (ATU - ATB)
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) duration - string (date-time)

lighter_call_bill_status
string or null (Bill Status)

:Status of the bill with regards to dockage (e.g. processing, billed)
:Bill Status
:Status of the bill with regards to dockage (e.g. processing, billed)
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

lighter_call_bill_no
string or null (Bill Number)

:Identifier of the bill
:Bill Number
:Identifier of the bill
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

lighter_call_bill_dt
string or null <date-time> (Bill Date)

:Date of the bill / receipt
:Bill Date
:Date of the bill / receipt
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lighter_call_time_stamp
required
string <date-time> (Last Update Date and Time)

:Last update Date and Time of Lighter Call
:Last Update Date and Time
:Last update Date and Time of Lighter Call
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

{
  • "lighter_call_terminal": "string",
  • "lighter_call_lighter_nm": "string",
  • "lighter_call_etb": "2019-08-24T14:15:22Z",
  • "lighter_call_etb_booking_submission_time": "2019-08-24T14:15:22Z",
  • "lighter_call_atb": "2019-08-24T14:15:22Z",
  • "lighter_call_crane_no": "string",
  • "lighter_call_berth_no": "string",
  • "lighter_call_usn": "string",
  • "lighter_call_lighter_operator": "string",
  • "lighter_call_booking_by": "string",
  • "lighter_call_booking_submitted_dt_time": "2019-08-24T14:15:22Z",
  • "lighter_call_check_in_by": "string",
  • "lighter_call_check_in_dt": "2019-08-24T14:15:22Z",
  • "lighter_call_check_in_etb": "2019-08-24T14:15:22Z",
  • "lighter_call_uncheck_in_dt_time": "2019-08-24T14:15:22Z",
  • "lighter_call_atu": "2019-08-24T14:15:22Z",
  • "lighter_call_atu_atb_portstay": "2019-08-24T14:15:22Z",
  • "lighter_call_bill_status": "string",
  • "lighter_call_bill_no": "string",
  • "lighter_call_bill_dt": "2019-08-24T14:15:22Z",
  • "lighter_call_time_stamp": "2019-08-24T14:15:22Z"
}

Manifest

Data Element ID: manifest

Array of objects or null (Line Item) non-empty

:Line Item
:Line Item
:Line Item
:NA
:NA

manifest_vessel_nm
required
string (Vessel Name)

:Vessel Name
:Vessel Name
:Vessel Name
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

manifest_vessel_destination
required
string (Vessel Destination)

:Vessel Destination
:Vessel Destination
:Vessel Destination
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

manifest_vessel_eta
required
string <date-time> (Vessel ETA)

:Estimated Time of Arrival (ETA) at vessel
:Vessel ETA
:Estimated Time of Arrival (ETA) at vessel
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

manifest_vessel_remarks
string or null (Vessel Remarks)

:Vessel Remarks
:Vessel Remarks
:Vessel Remarks
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

manifest_lighter_operator
string or null (Lighter Operator)

:Lighter Operator
:Lighter Operator
:Lighter Operator
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

manifest_agent
string or null (Agent)

:Agent
:Agent
:Agent
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

manifest_no
string or null (Manifest Number)

:Manifest Number
:Manifest Number
:Manifest Number
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

Array of objects or null (Manifest Attachment) non-empty

:Manifest Attachment
:Manifest Attachment
:Manifest Attachment
:NA
:.JPEG/.PNG/.TIFF/.PDF

{
  • "manifest_lineitem": [
    ],
  • "manifest_vessel_nm": "string",
  • "manifest_vessel_destination": "string",
  • "manifest_vessel_eta": "2019-08-24T14:15:22Z",
  • "manifest_vessel_remarks": "string",
  • "manifest_lighter_operator": "string",
  • "manifest_agent": "string",
  • "manifest_no": "string",
  • "attachments": [
    ]
}

Mother Vessel Loading Confirmation

Data Element ID: mother_vessel_loading_confirmation

mother_vessel_loading_confirmation_usn
required
string (USN)

:Unique identifier for job. Unique Shipment Number
:USN
:Unique identifier for job. Unique Shipment Number
:JP
:9 characters, Alphanumeric, ends with 1 Alphabetical Character

mother_vessel_loading_confirmation_vessel_nm
required
string (Vessel Name)

:Vessel Name
:Vessel Name
:Vessel Name
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

mother_vessel_loading_confirmation_loading_completed_dt_time
required
string <date-time> (Loading Completed Date and Time)

:Loading Completed Date and Time
:Loading Completed Date and Time
:Loading Completed Date and Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

Array of objects or null (Mother Vessel Loading Confirmation Attachment) non-empty

:Mother Vessel Loading Confirmation Attachment
:Mother Vessel Loading Confirmation Attachment
:Mother Vessel Loading Confirmation Attachment
:NA
:.JPEG/.PNG/.TIFF/.PDF

{
  • "mother_vessel_loading_confirmation_usn": "string",
  • "mother_vessel_loading_confirmation_vessel_nm": "string",
  • "mother_vessel_loading_confirmation_loading_completed_dt_time": "2019-08-24T14:15:22Z",
  • "attachments": [
    ]
}

Pallet Information

Data Element ID: pallet_information

Array of objects or null (Line Item) non-empty

:Line Item
:Line Item
:Line Item
:NA
:NA

pallet_info_usn
required
string (USN)

:Unique identifier for job. Unique Shipment Number
:USN
:Unique identifier for job. Unique Shipment Number
:JP
:9 characters, Alphanumeric, ends with 1 Alphabetical Character

pallet_info_vessel_nm
required
string (Vessel Name)

:Mother Vessel name and abbreviation
:Vessel Name
:Mother Vessel name and abbreviation
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

pallet_info_vessel_imo
string or null (Vessel IMO)

:Mother Vessel IMO number
:Vessel IMO
:Mother Vessel IMO number
:IMO
:7 characters, Numeric

pallet_info_vessel_eta
string or null <date-time> (Vessel ETA)

:Mother Vessel Estimated Time of Arrival (ETA) at anchorage
:Vessel ETA
:Mother Vessel Estimated Time of Arrival (ETA) at anchorage
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pallet_info_loading_dt_time
required
string <date-time> (Loading DateTime)

:Lighter Boat loading DateTime
:Loading DateTime
:Lighter Boat loading DateTime
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pallet_info_terminal
required
string (Terminal)

:Terminal e.g. Penjuru Lighter Terminal (PLT) or Marina South Wharves (MSW)
:Terminal
:Terminal e.g. Penjuru Lighter Terminal (PLT) or Marina South Wharves (MSW)
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

pallet_info_lighter_boat_nm
string or null (Lighter Boat Name)

:Name of the lighter boat
:Lighter Boat Name
:Name of the lighter boat
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

required
Array of objects (Pallet Count Attachment) non-empty

:Pallet Count Attachment
:Pallet Count Attachment
:Pallet Count Attachment
:NA
:.JPEG/.PNG/.TIFF/.PDF

{
  • "pallet_info_lineitem": [
    ],
  • "pallet_info_usn": "string",
  • "pallet_info_vessel_nm": "string",
  • "pallet_info_vessel_imo": "string",
  • "pallet_info_vessel_eta": "2019-08-24T14:15:22Z",
  • "pallet_info_loading_dt_time": "2019-08-24T14:15:22Z",
  • "pallet_info_terminal": "string",
  • "pallet_info_lighter_boat_nm": "string",
  • "attachments": [
    ]
}

Pilotage Service

Data Element ID: pilotage_service

pilotage_cst_dt_time
required
string <date-time> (CST / SRT Date & Time)

:Pilotage Confirmed Service Time or Service Required Time
:CST / SRT Date & Time
:Pilotage Confirmed Service Time or Service Required Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilotage_arrival_dt_time
string or null <date-time> (Arrive Date and Time)

:Pilot Arrival Date and Time
:Arrive Date and Time
:Pilot Arrival Date and Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilotage_onboard_dt_time
string or null <date-time> (Onboard Date and Time)

:Pilot Onboard Date and Time
:Onboard Date and Time
:Pilot Onboard Date and Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilotage_start_dt_time
string or null <date-time> (Start Date and Time)

:Pilot Start Date and Time
:Start Date and Time
:Pilot Start Date and Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilotage_end_dt_time
string or null <date-time> (End Date and Time)

:Pilot End Date and Time
:End Date and Time
:Pilot End Date and Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilotage_nm
required
string (Name of the Vessel)

:Receiving Vessel Name
:Name of the Vessel
:Receiving Vessel Name
:OHS
:Min characters = 1, Max characters = 255, Alphanumeric

pilotage_imo
required
string (International Maritime Organisation number)

:International Maritime Organisation (IMO) Vessel Identification number
:International Maritime Organisation number
:International Maritime Organisation (IMO) Vessel Identification number
:IMO
:7 characters, Numeric

pilotage_loc_to_code
string or null (Location To Code)

:Location To Code of the location from data fields
:Location To Code
:Location To Code of the location from data fields
:OHS
:Min characters = 1, Max characters = 6, Alphanumeric

pilotage_loc_from_code
string or null (Location From Code)

:Location From Code of the location from data fields
:Location From Code
:Location From Code of the location from data fields
:OHS
:Min characters = 1, Max characters = 6, Alphanumeric

pilotage_snapshot_dt
required
string <date-time> (Snapshot Date-Time)

:Timestamp of this record being captured
:Snapshot Date-Time
:Timestamp of this record being captured
:OHS
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

{
  • "pilotage_cst_dt_time": "2019-08-24T14:15:22Z",
  • "pilotage_arrival_dt_time": "2019-08-24T14:15:22Z",
  • "pilotage_onboard_dt_time": "2019-08-24T14:15:22Z",
  • "pilotage_start_dt_time": "2019-08-24T14:15:22Z",
  • "pilotage_end_dt_time": "2019-08-24T14:15:22Z",
  • "pilotage_nm": "string",
  • "pilotage_imo": "string",
  • "pilotage_loc_to_code": "string",
  • "pilotage_loc_from_code": "string",
  • "pilotage_snapshot_dt": "2019-08-24T14:15:22Z"
}

Product Catalogue

Data Element ID: product_catalogue

product_catalogue_sku
required
string (SKU)

:SKU
:SKU
:SKU
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_store_view_cd
string or null (Store View Code)

:Store View Code
:Store View Code
:Store View Code
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_attribute_set_cd
string or null (Attribute Set Code)

:Attribute Set Code
:Attribute Set Code
:Attribute Set Code
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_product_type
string or null (Product Type)

:Product Type
:Product Type
:Product Type
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_categories
string or null (Categories)

:Categories
:Categories
:Categories
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_product_websites
string or null (Product Websites)

:Product Websites
:Product Websites
:Product Websites
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_nm
required
string (Name)

:Name
:Name
:Name
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_desc
required
string (Description)

:Description
:Description
:Description
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_short_desc
required
string (Short Description)

:Short Description
:Short Description
:Short Description
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_weight
number or null (Weight)

:Weight
:Weight
:Weight
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_product_online
boolean or null (Product Online)

:Product Online
:Product Online
:Product Online
:IMPA
:"Yes" or "No"

product_catalogue_tax_class_nm
string or null (Tax Class Name)

:Tax Class Name
:Tax Class Name
:Tax Class Name
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_visibility
boolean or null (Visibility)

:Visibility
:Visibility
:Visibility
:IMPA
:"Yes" or "No"

product_catalogue_price
required
number (Price)

:Price
:Price
:Price
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_special_price
number or null (Special Price)

:Special Price
:Special Price
:Special Price
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_special_price_from_dt
string or null <date-time> (Special Price From Date)

:Special Price From Date
:Special Price From Date
:Special Price From Date
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

product_catalogue_special_price_to_dt
string or null <date-time> (Special Price To Date)

:Special Price To Date
:Special Price To Date
:Special Price To Date
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

product_catalogue_url_key
string or null (URL Key)

:URL Key
:URL Key
:URL Key
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_meta_title
string or null (Meta Title)

:Meta Title
:Meta Title
:Meta Title
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_meta_keywords
string or null (Meta Keywords)

:Meta Keywords
:Meta Keywords
:Meta Keywords
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_meta_desc
string or null (Meta Description)

:Meta Description
:Meta Description
:Meta Description
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_base_img
string or null (Base Image)

:Base Image
:Base Image
:Base Image
:IMPA
:.JPEG/.PNG/.TIFF/.PDF

product_catalogue_base_img_label
string or null (Base Image Label)

:Base Image Label
:Base Image Label
:Base Image Label
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_small_img
string or null (Small Image)

:Small Image
:Small Image
:Small Image
:IMPA
:.JPEG/.PNG/.TIFF/.PDF

product_catalogue_small_img_label
string or null (Small Image Label)

:Small Image Label
:Small Image Label
:Small Image Label
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_thumbnail_img
string or null (Thumbnail Image)

:Thumbnail Image
:Thumbnail Image
:Thumbnail Image
:IMPA
:.JPEG/.PNG/.TIFF/.PDF

product_catalogue_thumbnail_img_label
string or null (Thumbnail Image Label)

:Thumbnail Image Label
:Thumbnail Image Label
:Thumbnail Image Label
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_swatch_img
string or null (Swatch Image)

:Swatch Image
:Swatch Image
:Swatch Image
:IMPA
:.JPEG/.PNG/.TIFF/.PDF

product_catalogue_swatch_img_label
string or null (Swatch Image Label)

:Swatch Image Label
:Swatch Image Label
:Swatch Image Label
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_created_dt_time
string or null <date-time> (Created At)

:Created At
:Created At
:Created At
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

product_catalogue_updated_dt_time
string or null <date-time> (Updated At)

:Updated At
:Updated At
:Updated At
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

product_catalogue_new_from_dt
string or null <date-time> (New From Date)

:New From Date
:New From Date
:New From Date
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

product_catalogue_new_to_dt
string or null <date-time> (New To Date)

:New To Date
:New To Date
:New To Date
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

product_catalogue_display_product_options_in
string or null (Display Product Options In)

:Display Product Options In
:Display Product Options In
:Display Product Options In
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_map_price
number or null (Map Price)

:Map Price
:Map Price
:Map Price
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_msrp_price
number or null (MSRP Price)

:MSRP Price
:MSRP Price
:MSRP Price
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_map_enabled
boolean or null (Map Enabled)

:Map Enabled
:Map Enabled
:Map Enabled
:IMPA
:"Yes" or "No"

product_catalogue_gift_message_available
boolean or null (Gift Message Available)

:Gift Message Available
:Gift Message Available
:Gift Message Available
:IMPA
:"Yes" or "No"

product_catalogue_custom_design
string or null (Custom Design)

:Custom Design
:Custom Design
:Custom Design
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_custom_design_from
string or null (Custom Design From)

:Custom Design From
:Custom Design From
:Custom Design From
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_custom_design_to
string or null (Custom Design To)

:Custom Design To
:Custom Design To
:Custom Design To
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_custom_layout_update
string or null (Custom Layout Update)

:Custom Layout Update
:Custom Layout Update
:Custom Layout Update
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_page_layout
string or null (Page Layout)

:Page Layout
:Page Layout
:Page Layout
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_product_options_container
string or null (Product Options Container)

:Product Options Container
:Product Options Container
:Product Options Container
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_msrp_display_actual_price_type
string or null (MSRP Display Actual Price Type)

:MSRP Display Actual Price Type
:MSRP Display Actual Price Type
:MSRP Display Actual Price Type
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_country_of_manufacture
string or null (Country Of Manufacture)

:Country Of Manufacture
:Country Of Manufacture
:Country Of Manufacture
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_additional_attributes
string or null (Additional Attributes)

:Additional Attributes
:Additional Attributes
:Additional Attributes
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_qty
number or null (Quantity)

:Quantity
:Quantity
:Quantity
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_out_of_stock_qty
number or null (Out Of Stock Quantity)

:Out Of Stock Quantity
:Out Of Stock Quantity
:Out Of Stock Quantity
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_use_config_min_qty
number or null (User Configuration Minimum Quantity)

:User Configuration Minimum Quantity
:User Configuration Minimum Quantity
:User Configuration Minimum Quantity
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_is_qty_decimal
boolean or null (Is Quantity Decimal)

:Is Quantity Decimal
:Is Quantity Decimal
:Is Quantity Decimal
:IMPA
:"Yes" or "No"

product_catalogue_allow_backorders
boolean or null (Allow Backorders)

:Allow Backorders
:Allow Backorders
:Allow Backorders
:IMPA
:"Yes" or "No"

product_catalogue_use_config_backorders
string or null (User Configuration Backorders)

:User Configuration Backorders
:User Configuration Backorders
:User Configuration Backorders
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_min_cart_qty
number or null (Maximum Cart Quantity)

:Maximum Cart Quantity
:Maximum Cart Quantity
:Maximum Cart Quantity
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_use_config_min_sale_qty
string or null (User Configuration Minimum Sale Quantity)

:User Configuration Minimum Sale Quantity
:User Configuration Minimum Sale Quantity
:User Configuration Minimum Sale Quantity
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_max_cart_qty
number or null (Minimum Cart Quantity)

:Minimum Cart Quantity
:Minimum Cart Quantity
:Minimum Cart Quantity
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_use_config_max_sale_qty
string or null (User Configuration Maximum Sale Quantity)

:User Configuration Maximum Sale Quantity
:User Configuration Maximum Sale Quantity
:User Configuration Maximum Sale Quantity
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_is_in_stock
boolean or null (Is In Stock)

:Is In Stock
:Is In Stock
:Is In Stock
:IMPA
:"Yes" or "No"

product_catalogue_notify_on_stock_below
string or null (Notify On Stock Below)

:Notify On Stock Below
:Notify On Stock Below
:Notify On Stock Below
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_use_config_notify_stock_qty
string or null (User Configuration Notify Stock Quantity)

:User Configuration Notify Stock Quantity
:User Configuration Notify Stock Quantity
:User Configuration Notify Stock Quantity
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_manage_stock
string or null (Manage Stock)

:Manage Stock
:Manage Stock
:Manage Stock
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_use_config_manage_stock
string or null (User Configuration Manage Stock)

:User Configuration Manage Stock
:User Configuration Manage Stock
:User Configuration Manage Stock
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_use_config_qty_increments
string or null (User Configuration Quantity Increments)

:User Configuration Quantity Increments
:User Configuration Quantity Increments
:User Configuration Quantity Increments
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_qty_increments
string or null (Quantity Increments)

:Quantity Increments
:Quantity Increments
:Quantity Increments
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_use_config_enable_qty_inc
string or null (User Configuration Enable Quantity Increments)

:User Configuration Enable Quantity Increments
:User Configuration Enable Quantity Increments
:User Configuration Enable Quantity Increments
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_enable_qty_increments
boolean or null (Enable Quantity Increments)

:Enable Quantity Increments
:Enable Quantity Increments
:Enable Quantity Increments
:IMPA
:"Yes" or "No"

product_catalogue_is_decimal_divided
boolean or null (Is Decimal Divided)

:Is Decimal Divided
:Is Decimal Divided
:Is Decimal Divided
:IMPA
:"Yes" or "No"

product_catalogue_website_id
string or null (Website ID)

:Website ID
:Website ID
:Website ID
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_related_skus
string or null (Related SKUs)

:Related SKUs
:Related SKUs
:Related SKUs
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_related_position
string or null (Related Position)

:Related Position
:Related Position
:Related Position
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_crosssell_skus
string or null (Cross Sell SKUs)

:Cross Sell SKUs
:Cross Sell SKUs
:Cross Sell SKUs
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_crosssell_position
string or null (Cross Sell Position)

:Cross Sell Position
:Cross Sell Position
:Cross Sell Position
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_upsell_skus
string or null (Upsell SKUs)

:Upsell SKUs
:Upsell SKUs
:Upsell SKUs
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_upsell_position
string or null (Upsell Position)

:Upsell Position
:Upsell Position
:Upsell Position
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_additional_img
string or null (Additional Images)

:Additional Images
:Additional Images
:Additional Images
:IMPA
:.JPEG/.PNG/.TIFF/.PDF

product_catalogue_additional_img_labels
string or null (Additional Image Labels)

:Additional Image Labels
:Additional Image Labels
:Additional Image Labels
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_hide_from_product_page
string or null (Hide From Product Page)

:Hide From Product Page
:Hide From Product Page
:Hide From Product Page
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_custom_options
string or null (Custom Options)

:Custom Options
:Custom Options
:Custom Options
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_bundle_price_type
string or null (Bundle Price Type)

:Bundle Price Type
:Bundle Price Type
:Bundle Price Type
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_bundle_sku_type
string or null (Bundle SKU Type)

:Bundle SKU Type
:Bundle SKU Type
:Bundle SKU Type
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_bundle_price_view
string or null (Bundle Price View)

:Bundle Price View
:Bundle Price View
:Bundle Price View
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_bundle_weight_type
string or null (Bundle Weight Type)

:Bundle Weight Type
:Bundle Weight Type
:Bundle Weight Type
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_bundle_values
string or null (Bundle Values)

:Bundle Values
:Bundle Values
:Bundle Values
:IMPA
:Min characters = 1, Max characters = 255, Numeric

product_catalogue_bundle_shipment_type
string or null (Bundle Shipment Type)

:Bundle Shipment Type
:Bundle Shipment Type
:Bundle Shipment Type
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_associated_skus
string or null (Associated SKUs)

:Associated SKUs
:Associated SKUs
:Associated SKUs
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_downloadable_links
string or null (Downloadable Links)

:Downloadable Links
:Downloadable Links
:Downloadable Links
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_downloadable_samples
string or null (Downloadable Samples)

:Downloadable Samples
:Downloadable Samples
:Downloadable Samples
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_configurable_variations
string or null (Configurable Variations)

:Configurable Variations
:Configurable Variations
:Configurable Variations
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

product_catalogue_configurable_variation_labels
string or null (Configurable Variation Labels)

:Configurable Variation Labels
:Configurable Variation Labels
:Configurable Variation Labels
:IMPA
:Min characters = 1, Max characters = 255, Alphanumeric

{
  • "product_catalogue_sku": "string",
  • "product_catalogue_store_view_cd": "string",
  • "product_catalogue_attribute_set_cd": "string",
  • "product_catalogue_product_type": "string",
  • "product_catalogue_categories": "string",
  • "product_catalogue_product_websites": "string",
  • "product_catalogue_nm": "string",
  • "product_catalogue_desc": "string",
  • "product_catalogue_short_desc": "string",
  • "product_catalogue_weight": 0,
  • "product_catalogue_product_online": true,
  • "product_catalogue_tax_class_nm": "string",
  • "product_catalogue_visibility": true,
  • "product_catalogue_price": 0,
  • "product_catalogue_special_price": 0,
  • "product_catalogue_special_price_from_dt": "2019-08-24T14:15:22Z",
  • "product_catalogue_special_price_to_dt": "2019-08-24T14:15:22Z",
  • "product_catalogue_url_key": "string",
  • "product_catalogue_meta_title": "string",
  • "product_catalogue_meta_keywords": "string",
  • "product_catalogue_meta_desc": "string",
  • "product_catalogue_base_img": "string",
  • "product_catalogue_base_img_label": "string",
  • "product_catalogue_small_img": "string",
  • "product_catalogue_small_img_label": "string",
  • "product_catalogue_thumbnail_img": "string",
  • "product_catalogue_thumbnail_img_label": "string",
  • "product_catalogue_swatch_img": "string",
  • "product_catalogue_swatch_img_label": "string",
  • "product_catalogue_created_dt_time": "2019-08-24T14:15:22Z",
  • "product_catalogue_updated_dt_time": "2019-08-24T14:15:22Z",
  • "product_catalogue_new_from_dt": "2019-08-24T14:15:22Z",
  • "product_catalogue_new_to_dt": "2019-08-24T14:15:22Z",
  • "product_catalogue_display_product_options_in": "string",
  • "product_catalogue_map_price": 0,
  • "product_catalogue_msrp_price": 0,
  • "product_catalogue_map_enabled": true,
  • "product_catalogue_gift_message_available": true,
  • "product_catalogue_custom_design": "string",
  • "product_catalogue_custom_design_from": "string",
  • "product_catalogue_custom_design_to": "string",
  • "product_catalogue_custom_layout_update": "string",
  • "product_catalogue_page_layout": "string",
  • "product_catalogue_product_options_container": "string",
  • "product_catalogue_msrp_display_actual_price_type": "string",
  • "product_catalogue_country_of_manufacture": "string",
  • "product_catalogue_additional_attributes": "string",
  • "product_catalogue_qty": 0,
  • "product_catalogue_out_of_stock_qty": 0,
  • "product_catalogue_use_config_min_qty": 0,
  • "product_catalogue_is_qty_decimal": true,
  • "product_catalogue_allow_backorders": true,
  • "product_catalogue_use_config_backorders": "string",
  • "product_catalogue_min_cart_qty": 0,
  • "product_catalogue_use_config_min_sale_qty": "string",
  • "product_catalogue_max_cart_qty": 0,
  • "product_catalogue_use_config_max_sale_qty": "string",
  • "product_catalogue_is_in_stock": true,
  • "product_catalogue_notify_on_stock_below": "string",
  • "product_catalogue_use_config_notify_stock_qty": "string",
  • "product_catalogue_manage_stock": "string",
  • "product_catalogue_use_config_manage_stock": "string",
  • "product_catalogue_use_config_qty_increments": "string",
  • "product_catalogue_qty_increments": "string",
  • "product_catalogue_use_config_enable_qty_inc": "string",
  • "product_catalogue_enable_qty_increments": true,
  • "product_catalogue_is_decimal_divided": true,
  • "product_catalogue_website_id": "string",
  • "product_catalogue_related_skus": "string",
  • "product_catalogue_related_position": "string",
  • "product_catalogue_crosssell_skus": "string",
  • "product_catalogue_crosssell_position": "string",
  • "product_catalogue_upsell_skus": "string",
  • "product_catalogue_upsell_position": "string",
  • "product_catalogue_additional_img": "string",
  • "product_catalogue_additional_img_labels": "string",
  • "product_catalogue_hide_from_product_page": "string",
  • "product_catalogue_custom_options": "string",
  • "product_catalogue_bundle_price_type": "string",
  • "product_catalogue_bundle_sku_type": "string",
  • "product_catalogue_bundle_price_view": "string",
  • "product_catalogue_bundle_weight_type": "string",
  • "product_catalogue_bundle_values": "string",
  • "product_catalogue_bundle_shipment_type": "string",
  • "product_catalogue_associated_skus": "string",
  • "product_catalogue_downloadable_links": "string",
  • "product_catalogue_downloadable_samples": "string",
  • "product_catalogue_configurable_variations": "string",
  • "product_catalogue_configurable_variation_labels": "string"
}

Product Offering

Data Element ID: product_offering

product_offering_no
required
string (Product information number)

:Product information number
:Product information number
:Product information number
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

product_offering_dt
required
string <date-time> (Date)

:Date
:Date
:Date
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

product_offering_item
required
Array of strings (Item)

:Item
:Item
:Item
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

product_offering_item_cd
required
string (Item Code)

:Item Code
:Item Code
:Item Code
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

product_offering_unit
required
string (Unit)

:Sold in units
:Unit
:Sold in units
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

product_offering_unit_price
string or null (Unit price)

:Price per unit
:Unit price
:Price per unit
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

{
  • "product_offering_no": "string",
  • "product_offering_dt": "2019-08-24T14:15:22Z",
  • "product_offering_item": [
    ],
  • "product_offering_item_cd": "string",
  • "product_offering_unit": "string",
  • "product_offering_unit_price": "string"
}

Purchase Order (PO)

Data Element ID: purchase_order_po

po_no
required
string (PO Number)

:PO Number
:PO Number
:PO Number
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

po_vessel_nm
required
string (Vessel Name)

:Name of Vessel
:Vessel Name
:Name of Vessel
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

po_vessel_imo
string or null (Vessel IMO)

:Vessel IMO
:Vessel IMO
:Vessel IMO
:IMO
:7 characters, Numeric

po_req_delivery_dt
string or null <date-time> (Requested Delivery Date)

:Requested Delivery Date
:Requested Delivery Date
:Requested Delivery Date
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

po_vessel_eta
string or null <date-time> (Vessel ETA)

:Estimated Time of Arrival (ETA) at vessel
:Vessel ETA
:Estimated Time of Arrival (ETA) at vessel
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

po_job_coordinator
string or null (Job Coordinator)

:Job Coordinator
:Job Coordinator
:Job Coordinator
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

po_job_coordinator_contact
string or null (Job Coordinator Contact)

:Job Coordinator Contact
:Job Coordinator Contact
:Job Coordinator Contact
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

po_supplier_nm
required
string (Supplier Name)

:Supplier Name
:Supplier Name
:Supplier Name
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

po_supplier_contact
string or null (Supplier Contact)

:Supplier Contact
:Supplier Contact
:Supplier Contact
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

Array of objects or null (Line Item)

:Line Item
:Line Item
:Line Item
:NA
:NA

po_dt
string or null <date-time> (PO Date)

:PO Date
:PO Date
:PO Date
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

po_total_price
number or null <double> (Total Price)

:Total price for the order
:Total Price
:Total price for the order
:NA
:Numeric Digits Only

po_payment_terms
number or null <double> (Payment Terms)

:Payment Terms in Days
:Payment Terms
:Payment Terms in Days
:NA
:Numeric Digits Only

po_delivery_instructions
string or null (Delivery Instructions)

:Additional delivery instructions or remarks
:Delivery Instructions
:Additional delivery instructions or remarks
:NA
:

po_req_delivery_port
string or null (Requested Delivery Port)

:Requested Delivery Port
:Requested Delivery Port
:Requested Delivery Port
:NA
:

Array of objects or null (Purchase Order (PO) Attachment)

:Purchase Order (PO) Attachment
:Purchase Order (PO) Attachment
:Purchase Order (PO) Attachment
:NA
:.JPEG/.PNG/.TIFF/.PDF

{
  • "po_no": "string",
  • "po_vessel_nm": "string",
  • "po_vessel_imo": "string",
  • "po_req_delivery_dt": "2019-08-24T14:15:22Z",
  • "po_vessel_eta": "2019-08-24T14:15:22Z",
  • "po_job_coordinator": "string",
  • "po_job_coordinator_contact": "string",
  • "po_supplier_nm": "string",
  • "po_supplier_contact": "string",
  • "po_lineitem": [
    ],
  • "po_dt": "2019-08-24T14:15:22Z",
  • "po_total_price": 0.1,
  • "po_payment_terms": 0.1,
  • "po_delivery_instructions": "string",
  • "po_req_delivery_port": "string",
  • "attachments": [
    ]
}

Ship Supplies' Delivery Information

Data Element ID: ship_supplies_di

di_supplier_nm
string or null (Supplier Name)

:Name of supplier/company
:Supplier Name
:Name of supplier/company
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

di_supplier_uen
string or null (Supplier UEN)

:UEN of supplier/company
:Supplier UEN
:UEN of supplier/company
:NA
:Min characters = 9, Max characters = 10, Alphanumeric

di_no
string or null (DO Number)

:Delivery Order (DO) Number
:DO Number
:Delivery Order (DO) Number
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

di_dt
string or null <date-time> (DO Date)

:Delivery Order (DO) Date
:DO Date
:Delivery Order (DO) Date
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

required
Array of objects (Line Item) non-empty

:Line Item
:Line Item
:Line Item
:NA
:NA

di_receiving_vessel_nm
string or null (Receiving Vessel Name)

:Name of mother vessel to receive goods
:Receiving Vessel Name
:Name of mother vessel to receive goods
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

di_time_stamp
required
string <date-time> (Last Update Date and Time)

:Last update Date and Time of DO
:Last Update Date and Time
:Last update Date and Time of DO
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

di_dsa
required
string (DSA)

:Unique identifier for DSA. Delivery Shipment Advice
:DSA
:Unique identifier for DSA. Delivery Shipment Advice
:NA
:12 characters, Numeric

{
  • "di_supplier_nm": "string",
  • "di_supplier_uen": "string",
  • "di_no": "string",
  • "di_dt": "2019-08-24T14:15:22Z",
  • "di_lineitem": [
    ],
  • "di_receiving_vessel_nm": "string",
  • "di_time_stamp": "2019-08-24T14:15:22Z",
  • "di_dsa": "string"
}

Ship Supplies' Delivery Order

Data Element ID: ship_supplies_do

do_supplier_nm
required
string (Supplier Name)

:Name of supplier/company
:Supplier Name
:Name of supplier/company
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

do_supplier_address
required
string (Supplier Address)

:Address of supplier/company
:Supplier Address
:Address of supplier/company
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

do_supplier_uen
required
string (Supplier UEN)

:UEN of supplier/company
:Supplier UEN
:UEN of supplier/company
:NA
:Min characters = 9, Max characters = 10, Alphanumeric

do_no
required
string (DO Number)

:Delivery Order (DO) Number
:DO Number
:Delivery Order (DO) Number
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

do_dt
string or null <date-time> (DO Date)

:Delivery Order (DO) Date
:DO Date
:Delivery Order (DO) Date
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

do_receiving_vessel_nm
required
string (Receiving Vessel Name)

:Name of mother vessel to receive goods
:Receiving Vessel Name
:Name of mother vessel to receive goods
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

required
Array of objects (Line Item) non-empty

:Line Item
:Line Item
:Line Item
:NA
:NA

Array of objects or null (Ship Supplies' Delivery Order Attachment) non-empty

:Ship Supplies' Delivery Order Attachment
:Ship Supplies' Delivery Order Attachment
:Ship Supplies' Delivery Order Attachment
:NA
:.JPEG/.PNG/.TIFF/.PDF

do_time_stamp
required
string <date-time> (Last Update Date and Time)

:Last update Date and Time of DO
:Last Update Date and Time
:Last update Date and Time of DO
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

do_remarks
string or null (Remarks)

:Remarks e.g. quality of goods
:Remarks
:Remarks e.g. quality of goods
:NA
:Min characters = 1, Max characters = 255, Alphabetical

{
  • "do_supplier_nm": "string",
  • "do_supplier_address": "string",
  • "do_supplier_uen": "string",
  • "do_no": "string",
  • "do_dt": "2019-08-24T14:15:22Z",
  • "do_receiving_vessel_nm": "string",
  • "do_lineitem": [
    ],
  • "attachments": [
    ],
  • "do_time_stamp": "2019-08-24T14:15:22Z",
  • "do_remarks": "string"
}

Ship Supplies' Invoice

Data Element ID: ship_supplies_invoice

invoice_no
required
string (Invoice Number)

:Identifier number of invoice
:Invoice Number
:Identifier number of invoice
:PEPPOL
:Min characters = 1, Max characters = 255, Numeric

invoice_dt
string or null <date-time> (Invoice Date)

:Date where invoice was issued
:Invoice Date
:Date where invoice was issued
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

invoice_total_payment_amt
number or null (Total Payment Amount)

:Total amount of payment for goods being transacted
:Total Payment Amount
:Total amount of payment for goods being transacted
:PEPPOL
:Min characters = 1, Max characters = 255, Numeric

invoice_currency
string or null (Currency)

:Currency used to calculate price being transacted
:Currency
:Currency used to calculate price being transacted
:PEPPOL
:Min characters = 1, Max characters = 255, Alphabetical Characters

Array of objects or null (Ship Supplies' Invoice Attachment) non-empty

:Ship Supplies' Invoice Attachment
:Ship Supplies' Invoice Attachment
:Ship Supplies' Invoice Attachment
:NA
:.JPEG/.PNG/.TIFF/.PDF

invoice_receiving_vessel_nm
required
string (Receiving Vessel Name)

:Name of vessel to which goods are delivered
:Receiving Vessel Name
:Name of vessel to which goods are delivered
:PEPPOL
:Min characters = 1, Max characters = 255, Alphanumeric

invoice_payee
string or null (Payee)

:Name of party responsible for payment
:Payee
:Name of party responsible for payment
:PEPPOL
:Min characters = 1, Max characters = 255, Alphanumeric

Array of objects or null (Line Item) non-empty

:Line Item
:Line Item
:Line Item
:NA
:NA

invoice_po_no
string or null (PO Number)

:PO Number
:PO Number
:PO Number
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

{
  • "invoice_no": "string",
  • "invoice_dt": "2019-08-24T14:15:22Z",
  • "invoice_total_payment_amt": 0,
  • "invoice_currency": "string",
  • "attachments": [
    ],
  • "invoice_receiving_vessel_nm": "string",
  • "invoice_payee": "string",
  • "invoice_lineitem": [
    ],
  • "invoice_po_no": "string"
}

Truck Location

Data Element ID: truck_location

truck_loc_snapshot_dt
required
string <date-time> (Snapshot Date-Time)

:Timestamp of this record being captured
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

truck_loc_geofence
string or null (Geofence of Interest)

:Geofence of Interest that vehicle coordinates (Latitude, Longitude, Altitude (Optional)) fall within
:Geofence of Interest
:Geofence of Interest that vehicle coordinates (Latitude, Longitude, Altitude (Optional)) fall within
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

truck_loc_position_radius
string or null (Position Radius (metres))

:Radius of coverage from provided vehicle coordinates
:Position Radius (metres)
:Radius of coverage from provided vehicle coordinates
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

truck_loc_trucker_nm
string or null (Trucker Name)

:Abbreviated name of trucker
:Trucker Name
:Abbreviated name of trucker
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

truck_loc_position_latitude
number or null <double> (Position Latitude)

:Latitude coordinates of vehicle. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10
:Position Latitude
:Latitude coordinates of vehicle. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10
:Decimal Degrees
:Min value = -90, Max value = 90

truck_loc_position_longitude
number or null <double> (Position Longtitude)

:Longitude coordinates of vehicle. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10
:Position Longtitude
:Longitude coordinates of vehicle. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10
:Decimal Degrees
:Min value = -180, Max value = 180

truck_loc_heading
number or null <double> (Heading)

:Direction in which vehicle is pointing. This field has a commonly agreed minimum decimal precision = 0 and maximum decimal precision = 2
:Heading
:Direction in which vehicle is pointing. This field has a commonly agreed minimum decimal precision = 0 and maximum decimal precision = 2
:Decimal Degrees
:Min value = 0, Max value = 360

truck_loc_vehicle_no
required
string (Vehicle Number)

:Registration number of trucker
:Vehicle Number
:Registration number of trucker
:LTA
:Min characters = 1, Max characters = 255, Alphanumeric

truck_speed
string or null (Speed)

:Speed of the vehicle
:Speed
:Speed of the vehicle
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

truck_notes
string or null (Notes)

:To input all your notes here
:Notes
:To input all your notes here
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

{
  • "truck_loc_snapshot_dt": "2019-08-24T14:15:22Z",
  • "truck_loc_geofence": "string",
  • "truck_loc_position_radius": "string",
  • "truck_loc_trucker_nm": "string",
  • "truck_loc_position_latitude": 0.1,
  • "truck_loc_position_longitude": 0.1,
  • "truck_loc_heading": 0.1,
  • "truck_loc_vehicle_no": "string",
  • "truck_speed": "string",
  • "truck_notes": "string"
}

Truck Schedule

Data Element ID: truck_schedule

truck_schedule_usn
required
string (USN)

:Unique identifier for job. Unique Shipment Number
:USN
:Unique identifier for job. Unique Shipment Number
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

truck_schedule_dsa
required
string (DSA)

:Unique identifier for DSA. Delivery Shipment Advice
:DSA
:Unique identifier for DSA. Delivery Shipment Advice
:JP
:Min characters = 1, Max characters = 255, Alphanumeric

truck_schedule_terminal
required
string (Terminal)

:Terminal e.g. Penjuru Lighter Terminal (PLT) or Marina South Wharves (MSW)
:Terminal
:Terminal e.g. Penjuru Lighter Terminal (PLT) or Marina South Wharves (MSW)
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

truck_schedule_eta_at_terminal
required
string <date-time> (ETA at Terminal)

:Estimated Time of Arrival (ETA) at terminal
:ETA at Terminal
:Estimated Time of Arrival (ETA) at terminal
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

truck_schedule_job_ref_no
string or null (Job Reference No)

:Job Reference No
:Job Reference No
:Job Reference No
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

truck_schedule_pickup_loc
string or null (Pick-up Location)

:Pick-up Location
:Pick-up Location
:Pick-up Location
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

truck_schedule_pickup_time
string or null <date-time> (Pick-up Time)

:Pick-up Time
:Pick-up Time
:Pick-up Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

truck_schedule_dropoff_terminal_loc
required
string (Drop-off (Terminal) Location)

:Drop-off (Terminal) Location - e.g. Penjuru Lighter Terminal (PLT) or Marina South Wharves (MSW)
:Drop-off (Terminal) Location
:Drop-off (Terminal) Location - e.g. Penjuru Lighter Terminal (PLT) or Marina South Wharves (MSW)
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

truck_schedule_dropoff_eta_time
required
string <date-time> (Drop-off (ETA) Time)

:Drop-off (ETA) Time
:Drop-off (ETA) Time
:Drop-off (ETA) Time
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

Array of objects or null (Line Items) non-empty

:Line Items
:Line Items
:Line Items
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

truck_schedule_assigned_driver
required
string (Assigned Driver)

:Assigned Driver
:Assigned Driver
:Assigned Driver
:NA
:Min characters = 1, Max characters = 255, Alphabetical Characters

truck_schedule_assigned_vehicle_no
required
string (Assigned Vehicle No.)

:Assigned Vehicle No.
:Assigned Vehicle No.
:Assigned Vehicle No.
:LTA
:8 characters, Alphanumeric

truck_schedule_job_status
string or null (Job Status)

:Job Status
:Job Status
:Job Status
:NA
:Min characters = 1, Max characters = 255, Alphanumeric

Array of objects or null (Truck Schedule Attachment) non-empty

:Truck Schedule Attachment
:Truck Schedule Attachment
:Truck Schedule Attachment
:NA
:.JPEG/.PNG/.TIFF/.PDF

truck_schedule_time_stamp
required
string <date-time> (Last Update Date and Time)

:Last update Date and Time of Trucker Schedule
:Last Update Date and Time
:Last update Date and Time of Trucker Schedule
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

{
  • "truck_schedule_usn": "string",
  • "truck_schedule_dsa": "string",
  • "truck_schedule_terminal": "string",
  • "truck_schedule_eta_at_terminal": "2019-08-24T14:15:22Z",
  • "truck_schedule_job_ref_no": "string",
  • "truck_schedule_pickup_loc": "string",
  • "truck_schedule_pickup_time": "2019-08-24T14:15:22Z",
  • "truck_schedule_dropoff_terminal_loc": "string",
  • "truck_schedule_dropoff_eta_time": "2019-08-24T14:15:22Z",
  • "truck_schedule_line_items": [
    ],
  • "truck_schedule_assigned_driver": "string",
  • "truck_schedule_assigned_vehicle_no": "string",
  • "truck_schedule_job_status": "string",
  • "attachments": [
    ],
  • "truck_schedule_time_stamp": "2019-08-24T14:15:22Z"
}

Vehicle Port Entry Exit

Data Element ID: vehicle_port_entry_exit

vehicle_port_entry_exit_vehicle_no
required
string (Vehicle Number)

:Registration number of the assigned vehicle
:Vehicle Number
:Registration number of the assigned vehicle
:LTA
:8 characters, Alphanumeric

vehicle_port_entry_exit_vehicle_movement_type
required
string (Vehicle Movement)

:Indicator of whether vehicle is entering (N) or exiting (X) port gate
:Vehicle Movement
:Indicator of whether vehicle is entering (N) or exiting (X) port gate
:Custom
:Min characters = 1, Max characters = 1, Alpha, equal to "N" or "X"

vehicle_port_entry_exit_vehicle_portgatein_dt
string or null <date-time> (Vehicle Port GateIn Date-Time)

:Actual time of vehicle entering port gate
:Vehicle Port GateIn Date-Time
:Actual time of vehicle entering port gate
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ), Date is not in the future

vehicle_port_entry_exit_vehicle_portgateout_dt
string or null <date-time> (Vehicle Port GateOut Date-Time)

:Actual time of vehicle exiting port gate
:Vehicle Port GateOut Date-Time
:Actual time of vehicle exiting port gate
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ), Date is not in the future

{
  • "vehicle_port_entry_exit_vehicle_no": "string",
  • "vehicle_port_entry_exit_vehicle_movement_type": "string",
  • "vehicle_port_entry_exit_vehicle_portgatein_dt": "2019-08-24T14:15:22Z",
  • "vehicle_port_entry_exit_vehicle_portgateout_dt": "2019-08-24T14:15:22Z"
}

Vessel Current Position

Data Element ID: vessel_current_position

Array of objects or null (Vessel Particulars Information)

:Particulars of the vessel

Note: Only latest data is available where applicable.
:Vessel Particulars Information
:Particulars of the vessel

Note: Only latest data is available where applicable.
:NA
:NA

vessel_source
string or null (Source)

:Source of data

Note: Only latest data is available where applicable.
:Source
:Source of data

Note: Only latest data is available where applicable.
:NA
:NA

vessel_destination_code
string or null (Destination Code)

:International standard port code, also known as UN/LOCODE, e.g. SGSIN

Note: Only latest data is available where applicable.
:Destination Code
:International standard port code, also known as UN/LOCODE, e.g. SGSIN

Note: Only latest data is available where applicable.
:NA
:NA

vessel_destination
string or null (Destination)

:Destination, e.g. CHANGJIANGKOU

Note: Only latest data is available where applicable.
:Destination
:Destination, e.g. CHANGJIANGKOU

Note: Only latest data is available where applicable.
:NA
:NA

vessel_standardised_destination
string or null (Standardised Destination)

:Standardised Destination, e.g. CHANGJIANGKOU,CN

Note: Only latest data is available where applicable.
:Standardised Destination
:Standardised Destination, e.g. CHANGJIANGKOU,CN

Note: Only latest data is available where applicable.
:NA
:NA

vessel_eta_dt
string or null <date-time> (Vessel ETA)

:Estimated Time of Arrival (ETA)

Note: Only latest data is available where applicable.
:Vessel ETA
:Estimated Time of Arrival (ETA)

Note: Only latest data is available where applicable.
:NA
:0

vessel_length
integer or null <int64> (Length of the Vessel)

:Length of the Vessel

Note: Only latest data is available where applicable.
:Length of the Vessel
:Length of the Vessel

Note: Only latest data is available where applicable.
:0
:NA

vessel_depth
integer or null <int64> (Depth of the Vessel)

:Vertical distance measured from the top of the keel (the bottom-most part of the ship) to the top of the deck at the side of the vessel.
It indicates the overall height of the ship's hull.

Note: This field may return NULL or 0 as it is not a mandatory field.
:Depth of the Vessel
:Vertical distance measured from the top of the keel (the bottom-most part of the ship) to the top of the deck at the side of the vessel.
It indicates the overall height of the ship's hull.

Note: This field may return NULL or 0 as it is not a mandatory field.
:NA
:NA

vessel_draught
integer or null <int64> (Draught of the Vessel)

:Vertical distance from the waterline to the bottom of the keel.
It represents how deep the ship sits in the water and is crucial for determining the minimum depth of water a ship can safely navigate.

Note: This field may return NULL or 0 as it is not a mandatory field.
:Draught of the Vessel
:Vertical distance from the waterline to the bottom of the keel.
It represents how deep the ship sits in the water and is crucial for determining the minimum depth of water a ship can safely navigate.

Note: This field may return NULL or 0 as it is not a mandatory field.
:NA
:NA

vessel_type
string or null (Type of the Vessel)

:Type of the Vessel

Note: Only latest data is available where applicable.
:Type of the Vessel
:Type of the Vessel

Note: Only latest data is available where applicable.
:NA
:NA

vessel_grosstonnage
integer or null <int64> (Gross Tonnage of the Vessel)

:Gross Tonnage of the Vessel

Note: Only latest data is available where applicable.
:Gross Tonnage of the Vessel
:Gross Tonnage of the Vessel

Note: Only latest data is available where applicable.
:NA
:NA

vessel_nettonnage
integer or null <int64> (Net Tonnage of the Vessel)

:Net Tonnage of the Vessel

Note: Only latest data is available where applicable.
:Net Tonnage of the Vessel
:Net Tonnage of the Vessel

Note: Only latest data is available where applicable.
:NA
:NA

vessel_deadweight
integer or null <int64> (Dead Weight of the Vessel)

:Dead Weight of the Vessel

Note: Only latest data is available where applicable.
:Dead Weight of the Vessel
:Dead Weight of the Vessel

Note: Only latest data is available where applicable.
:NA
:NA

vessel_mmsi_number
integer or null <int64> (MMSI Number of the Vessel)

:Maritime Mobile Service Identity (MMSI) Vessel Identification Number

Note: This field may return NULL as it is not a mandatory field.
:MMSI Number of the Vessel
:Maritime Mobile Service Identity (MMSI) Vessel Identification Number

Note: This field may return NULL as it is not a mandatory field.
:NA
:9 characters, Numeric

vessel_year_built
integer or null <int64> (The year in which the vessel has been built)

:The year in which the vessel has been built

Note: Only latest data is available where applicable.
:The year in which the vessel has been built
:The year in which the vessel has been built

Note: Only latest data is available where applicable.
:NA
:NA

vessel_latitude
number or null <double> (Latitude)

:Latitude

Note: Only latest data is available where applicable.
:Latitude
:Latitude

Note: Only latest data is available where applicable.
:ISO 6709
:NA

vessel_longitude
number or null <double> (Longitude)

:Longitude

Note: Only latest data is available where applicable.
:Longitude
:Longitude

Note: Only latest data is available where applicable.
:ISO 6709
:NA

vessel_latitude_degrees
number or null <double> (Latitude Degrees)

:Latitude Degrees

Note: Only latest data is available where applicable.
:Latitude Degrees
:Latitude Degrees

Note: Only latest data is available where applicable.
:NA
:NA

vessel_longitude_degrees
number or null <double> (Longitude Degrees)

:Longitude Degrees

Note: Only latest data is available where applicable.
:Longitude Degrees
:Longitude Degrees

Note: Only latest data is available where applicable.
:NA
:NA

vessel_speed
number or null <double> (Speed)

:Speed

Note: Only latest data is available where applicable.
:Speed
:Speed

Note: Only latest data is available where applicable.
:NA
:NA

vessel_course
number or null <double> (Course)

:Course

Note: Only latest data is available where applicable.
:Course
:Course

Note: Only latest data is available where applicable.
:NA
:NA

vessel_heading
number or null <double> (Heading)

:Heading

Note: Only latest data is available where applicable.
:Heading
:Heading

Note: Only latest data is available where applicable.
:NA
:NA

vessel_navigation_status
string or null (Navigation Status)

:Navigation Status

Note: Only latest data is available where applicable.
:Navigation Status
:Navigation Status

Note: Only latest data is available where applicable.
:NA
:NA

vessel_time_stamp
string or null <date-time> (Last Update Time)

:Last Update Time

Note: Only latest data is available where applicable.
:Last Update Time
:Last Update Time

Note: Only latest data is available where applicable.
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

{
  • "vessel_particulars": [
    ],
  • "vessel_source": "string",
  • "vessel_destination_code": "string",
  • "vessel_destination": "string",
  • "vessel_standardised_destination": "string",
  • "vessel_eta_dt": "2019-08-24T14:15:22Z",
  • "vessel_length": 0,
  • "vessel_depth": 0,
  • "vessel_draught": 0,
  • "vessel_type": "string",
  • "vessel_grosstonnage": 0,
  • "vessel_nettonnage": 0,
  • "vessel_deadweight": 0,
  • "vessel_mmsi_number": 0,
  • "vessel_year_built": 0,
  • "vessel_latitude": 0.1,
  • "vessel_longitude": 0.1,
  • "vessel_latitude_degrees": 0.1,
  • "vessel_longitude_degrees": 0.1,
  • "vessel_speed": 0.1,
  • "vessel_course": 0.1,
  • "vessel_heading": 0.1,
  • "vessel_navigation_status": "string",
  • "vessel_time_stamp": "2019-08-24T14:15:22Z"
}

Vessel Due to Arrive

Data Element ID: vessel_due_to_arrive

required
Array of objects (Vessel Particulars Information) non-empty

:Particulars of the vessel, Note: For push, only latest data is available where applicable. For pull, only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Particulars Information
:Particulars of the vessel, Note: For push, only latest data is available where applicable. For pull, only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vda_vessel_due_to_arrive_dt
string or null <date-time> (Vessel Due to Arrive Time)

:Vessel Due to Arrive Time , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_arrived_dt" is not NULL as vessel has arrived. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Due to Arrive Time
:Vessel Due to Arrive Time , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_arrived_dt" is not NULL as vessel has arrived. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vda_vessel_location_from
required
string (Location From)

:Location From , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location From
:Location From , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vda_vessel_location_to
string or null (Location To)

:Location To, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location To
:Location To, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

{
  • "vda_vessel_particulars": [
    ],
  • "vda_vessel_due_to_arrive_dt": "2019-08-24T14:15:22Z",
  • "vda_vessel_location_from": "string",
  • "vda_vessel_location_to": "string"
}

Vessel Information

Data Element ID: vessel_information

required
Array of objects (Vessel Particulars Information) non-empty

:Particulars of the vessel, Note: For push, only latest data is available where applicable. For pull, only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Particulars Information
:Particulars of the vessel, Note: For push, only latest data is available where applicable. For pull, only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_ism_manager
string or null (ISM Manager (If vessel flag is 'SG'))

:International Safety Management Manager, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISM Manager (If vessel flag is 'SG')
:International Safety Management Manager, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_ship_manager
string or null (Ship Manager (if vessel flag is 'SG'))

:Ship Manager, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Ship Manager (if vessel flag is 'SG')
:Ship Manager, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_registered_ownership
string or null (Registered Ownership (if vessel flag is 'SG'))

:Registered Ownership, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Registered Ownership (if vessel flag is 'SG')
:Registered Ownership, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_classification_society
string or null (Classification Society (if vessel flag is 'SG'))

:Classification Society, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Classification Society (if vessel flag is 'SG')
:Classification Society, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_registration_status
string or null (Registration Status)

:Registration Status , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Registration Status
:Registration Status , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_registration_dt
string or null <date-time> (Registration Date)

:Registration Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Registration Date
:Registration Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_validity_dt
string or null <date-time> (Validity Date)

:Validity Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Validity Date
:Validity Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_date_of_closure
string or null <date-time> (Date of Closure)

:Date of Closure, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Date of Closure
:Date of Closure, Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_vessel_certificate_no
string or null (Certificate Number)

:Certificate Number , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Certificate Number
:Certificate Number , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_issue_dt
string or null <date-time> (Issue Date)

:Issue Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Issue Date
:Issue Date , Note: For push, only latest data is available where applicable. For pull, this field will return results if "vessel_flag" is 'SG'. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_movement_start_dt
string or null <date-time> (Movement Start Date and Time)

:Movement Start Date and Time, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Start Date and Time
:Movement Start Date and Time, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_movement_end_dt
string or null <date-time> (Movement End Date and Time)

:Movement End Date and Time, Note: Business Exception Scenario #1: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'A', this field will return a NULL as vessel is due to arrive Business Exception Scenario #2: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'D', this field will return a NULL as vessel is due to depart Business Exception Scenario #3: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'I', this field will return a NULL as vessel is in port and moving For push, only latest data is available. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement End Date and Time
:Movement End Date and Time, Note: Business Exception Scenario #1: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'A', this field will return a NULL as vessel is due to arrive Business Exception Scenario #2: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'D', this field will return a NULL as vessel is due to depart Business Exception Scenario #3: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'I', this field will return a NULL as vessel is in port and moving For push, only latest data is available. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_movement_status
string or null (Movement Status)

:Movement Status, Note: This field will return 'C','O' where each where each letters indicates as follow: 'C' - Close, 'O' - Open., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Status
:Movement Status, Note: This field will return 'C','O' where each where each letters indicates as follow: 'C' - Close, 'O' - Open., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_movement_type
string or null (Movement Type)

:Movement Type, Note: This field will return 'A','D','I','T' where each letters indicates as follow: 'A' - Arrival, 'D' - Departure, 'I' - Intraport, 'T'- Transit., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Type
:Movement Type, Note: This field will return 'A','D','I','T' where each letters indicates as follow: 'A' - Arrival, 'D' - Departure, 'I' - Intraport, 'T'- Transit., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location_from_cd
required
string (Location From Code)

:Location Code of the location from data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location From Code
:Location Code of the location from data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location_to_cd
string or null (Location To Code)

:Location Code of the location to data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location To Code
:Location Code of the location to data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location_from
required
string (Location From)

:Location From , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location From
:Location From , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location_to
string or null (Location To)

:Location To, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location To
:Location To, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_movement_draft
number or null (Movement Draft)

:Movement Draft , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Draft
:Movement Draft , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_movement_height
number or null (Movement Height)

:Movement Height , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Height
:Movement Height , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_arrived_dt
string or null <date-time> (Vessel Arrived Time)

:The Reported Arrival Time, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if vessel is due to arrival OR is not in port. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Arrived Time
:The Reported Arrival Time, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if vessel is due to arrival OR is not in port. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_purpose
string or null (Vessel Purpose)

:The purpose field is a comma-separated value (CSV) field, where each value is a Yes(Y)/No(N) indicator in the following sequence. #1 indicator - Loading / Unloading Cargo #2 indicator - Loading / Unloading Passengers #3 indicator - Taking Bunker #4 indicator - Taking Ship Supplies #5 indicator - Changing Crew #6 indicator - Shipyard Repair #7 indicator - Offshore Support #8 indicator - Not Used #9 indicator - Other Afloat Activities , Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Purpose
:The purpose field is a comma-separated value (CSV) field, where each value is a Yes(Y)/No(N) indicator in the following sequence. #1 indicator - Loading / Unloading Cargo #2 indicator - Loading / Unloading Passengers #3 indicator - Taking Bunker #4 indicator - Taking Ship Supplies #5 indicator - Changing Crew #6 indicator - Shipyard Repair #7 indicator - Offshore Support #8 indicator - Not Used #9 indicator - Other Afloat Activities , Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location_cd
string or null (Location Code)

:Location Code of the location data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location Code
:Location Code of the location data fields , Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_location
string or null (Vessel Location)

:Location of the vessel, Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Location
:Location of the vessel, Note: For push, only latest data is available where applicable. For pull, this field will return results only if the vessel has arrived in port where "vessel_arrived_dt" is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_grid
string or null (Vessel Grid)

:Grid of the Vessel, Note: For push, only latest data is available where applicable. For pull, this field will return NULL unless vessel is at anchorage. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Grid
:Grid of the Vessel, Note: For push, only latest data is available where applicable. For pull, this field will return NULL unless vessel is at anchorage. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_arrival_agent
string or null (Agent of the Arrival Vessel)

:Agent of the Arrival Vessel, Note: For push, only latest data is available where applicable. For pull, this field returns results if vessel has arrived and vessel_arrived_dt is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Agent of the Arrival Vessel
:Agent of the Arrival Vessel, Note: For push, only latest data is available where applicable. For pull, this field returns results if vessel has arrived and vessel_arrived_dt is not NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_due_to_arrive_dt
string or null <date-time> (Vessel Due to Arrive Time)

:Vessel Due to Arrive Time , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_arrived_dt" is not NULL as vessel has arrived. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Due to Arrive Time
:Vessel Due to Arrive Time , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_arrived_dt" is not NULL as vessel has arrived. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_departed_dt
string or null <date-time> (Vessel Departed Time)

:Reported departed time , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if vessel is not in port. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Departed Time
:Reported departed time , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if vessel is not in port. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_departure_agent
string or null (Agent of the Departure Vessel)

:Agent of the Departure Vessel, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Agent of the Departure Vessel
:Agent of the Departure Vessel, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_due_to_depart_dt
string or null <date-time> (Vessel Due to Depart)

:Vessel Due to Depart , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Due to Depart
:Vessel Due to Depart , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_next_port
string or null (Next Port)

:Next Port, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Next Port
:Next Port, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_next_port_of_call_country
string or null (Next Port of Call Country)

:Next Port of Call Country, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Next Port of Call Country
:Next Port of Call Country, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_cargo
number or null (Cargo)

:Cargo, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Cargo
:Cargo, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_cert_issue_dt
string or null <date-time> (Date and Time of Certificate Issue)

:Date and Time of Certificate Issue, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Date and Time of Certificate Issue
:Date and Time of Certificate Issue, Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_expiry_dt_of_port_certificate
string or null <date-time> (Expiry Date and Time of Port Certificate)

:Expiry Date and Time of Port Certificate , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Expiry Date and Time of Port Certificate
:Expiry Date and Time of Port Certificate , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. Only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vessel_master_nm
string or null (Master Name)

:Master Name , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Master Name
:Master Name , Note: For push, only latest data is available where applicable. For pull, this field will return NULL if "vessel_departed_dt" is NULL. This field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vessel_datetime_of_querying
required
string <date-time> (Querying Date Time)

:This field is used only for querying of vessel event data
:Querying Date Time
:This field is used only for querying of vessel event data
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

{
  • "vessel_particulars": [
    ],
  • "vessel_ism_manager": "string",
  • "vessel_ship_manager": "string",
  • "vessel_registered_ownership": "string",
  • "vessel_classification_society": "string",
  • "vessel_registration_status": "string",
  • "vessel_registration_dt": "2019-08-24T14:15:22Z",
  • "vessel_validity_dt": "2019-08-24T14:15:22Z",
  • "vessel_date_of_closure": "2019-08-24T14:15:22Z",
  • "vessel_vessel_certificate_no": "string",
  • "vessel_issue_dt": "2019-08-24T14:15:22Z",
  • "vessel_movement_start_dt": "2019-08-24T14:15:22Z",
  • "vessel_movement_end_dt": "2019-08-24T14:15:22Z",
  • "vessel_movement_status": "string",
  • "vessel_movement_type": "string",
  • "vessel_location_from_cd": "string",
  • "vessel_location_to_cd": "string",
  • "vessel_location_from": "string",
  • "vessel_location_to": "string",
  • "vessel_movement_draft": 0,
  • "vessel_movement_height": 0,
  • "vessel_arrived_dt": "2019-08-24T14:15:22Z",
  • "vessel_purpose": "string",
  • "vessel_location_cd": "string",
  • "vessel_location": "string",
  • "vessel_grid": "string",
  • "vessel_arrival_agent": "string",
  • "vessel_due_to_arrive_dt": "2019-08-24T14:15:22Z",
  • "vessel_departed_dt": "2019-08-24T14:15:22Z",
  • "vessel_departure_agent": "string",
  • "vessel_due_to_depart_dt": "2019-08-24T14:15:22Z",
  • "vessel_next_port": "string",
  • "vessel_next_port_of_call_country": "string",
  • "vessel_cargo": 0,
  • "vessel_cert_issue_dt": "2019-08-24T14:15:22Z",
  • "vessel_expiry_dt_of_port_certificate": "2019-08-24T14:15:22Z",
  • "vessel_master_nm": "string",
  • "vessel_datetime_of_querying": "2019-08-24T14:15:22Z"
}

Vessel Movement

Data Element ID: vessel_movement

required
Array of objects (Vessel Particulars Information) non-empty

:Particulars of the vessel, Note: For push, only latest data is available where applicable. For pull, only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Vessel Particulars Information
:Particulars of the vessel, Note: For push, only latest data is available where applicable. For pull, only latest data is available and won't be affected by query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vm_vessel_movement_start_dt
string or null <date-time> (Movement Start Date and Time)

:Movement Start Date and Time, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Start Date and Time
:Movement Start Date and Time, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vm_vessel_movement_end_dt
string or null <date-time> (Movement End Date and Time)

:Movement End Date and Time, Note: Business Exception Scenario #1: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'A', this field will return a NULL as vessel is due to arrive Business Exception Scenario #2: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'D', this field will return a NULL as vessel is due to depart Business Exception Scenario #3: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'I', this field will return a NULL as vessel is in port and moving For push, only latest data is available. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement End Date and Time
:Movement End Date and Time, Note: Business Exception Scenario #1: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'A', this field will return a NULL as vessel is due to arrive Business Exception Scenario #2: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'D', this field will return a NULL as vessel is due to depart Business Exception Scenario #3: "vessel_movement_status" = 'O' and "vessel_movement_type" = 'I', this field will return a NULL as vessel is in port and moving For push, only latest data is available. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:ISO 8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

vm_vessel_movement_status
string or null (Movement Status)

:Movement Status, Note: This field will return 'C','O' where each where each letters indicates as follow: 'C' - Close, 'O' - Open., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Status
:Movement Status, Note: This field will return 'C','O' where each where each letters indicates as follow: 'C' - Close, 'O' - Open., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vm_vessel_movement_type
string or null (Movement Type)

:Movement Type, Note: This field will return 'A','D','I','T' where each letters indicates as follow: 'A' - Arrival, 'D' - Departure, 'I' - Intraport, 'T'- Transit., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Type
:Movement Type, Note: This field will return 'A','D','I','T' where each letters indicates as follow: 'A' - Arrival, 'D' - Departure, 'I' - Intraport, 'T'- Transit., Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vm_vessel_location_from
required
string (Location From)

:Location From , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location From
:Location From , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vm_vessel_location_to
string or null (Location To)

:Location To, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Location To
:Location To, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vm_vessel_movement_draft
number or null (Movement Draft)

:Movement Draft , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Draft
:Movement Draft , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

vm_vessel_movement_height
number or null (Movement Height)

:Movement Height , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:Movement Height
:Movement Height , Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).
:NA
:NA

{
  • "vm_vessel_particulars": [
    ],
  • "vm_vessel_movement_start_dt": "2019-08-24T14:15:22Z",
  • "vm_vessel_movement_end_dt": "2019-08-24T14:15:22Z",
  • "vm_vessel_movement_status": "string",
  • "vm_vessel_movement_type": "string",
  • "vm_vessel_location_from": "string",
  • "vm_vessel_location_to": "string",
  • "vm_vessel_movement_draft": 0,
  • "vm_vessel_movement_height": 0
}

Vessel Voyage Information

Data Element ID: vvi

vvi_vessel_nm
required
string (Vessel Name)

:Name of vessel
:Vessel Name
:Name of vessel
:NA
:Min characters = 1, Max characters = 255, Alphanumeric, No Special Characters

vvi_voyage_no
required
string (Voyage Number)

:Loader full inward/ outward voyage number
:Voyage Number
:Loader full inward/ outward voyage number
:NA
:Min characters = 1, Max characters = 255, Alphanumeric, No Special Characters

vvi_inward_voyage_no
required
string (Inward Voyage Number)

:Loader full inward voyage number
:Inward Voyage Number
:Loader full inward voyage number
:NA
:Min characters = 1, Max characters = 8, Alphanumeric

vvi_outward_voyage_no
required
string (Outward Voyage Number)

:Loader full outward voyage number
:Outward Voyage Number
:Loader full outward voyage number
:NA
:Min characters = 1, Max characters = 8, Alphanumeric

vvi_vessel_status
required
string (Vessel Status)

:Status of vessel - Berthing, Alongside, Unberthing
:Vessel Status
:Status of vessel - Berthing, Alongside, Unberthing
:Custom
:Min characters = 8, Max characters = 10, Alpha, equal to "Berthing", "Alongside" or "Unberthing"

vvi_vessel_eta_dt
string or null <date-time> (Vessel Estimated Time of Arrival Date-Time)

:Estimated time of vessel arrival at Singapore terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:Vessel Estimated Time of Arrival Date-Time
:Estimated time of vessel arrival at Singapore terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is in the future

vvi_vessel_etd_dt
string or null <date-time> (Vessel Estimated Time of Departure Date-Time)

:Estimated time of vessel departure at Singapore terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:Vessel Estimated Time of Departure Date-Time
:Estimated time of vessel departure at Singapore terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is in the future

vvi_vessel_ata_dt
string or null <date-time> (Vessel Actual Time of Arrival Date-Time)

:Actual time of arrival at Singapore port
:Vessel Actual Time of Arrival Date-Time
:Actual time of arrival at Singapore port
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

vvi_vessel_atd_dt
string or null <date-time> (Vessel Actual Time of Departure Date-Time)

:Actual time of departure from Singapore port
:Vessel Actual Time of Departure Date-Time
:Actual time of departure from Singapore port
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

vvi_terminal_berth
required
string (Terminal and Berth)

:Vessel berthing terminal and berth number
:Terminal and Berth
:Vessel berthing terminal and berth number
:NA
:Min characters = 1, Max characters = 255, Alphanumeric, No Special Characters

required
Array of objects (Time to Avoid) non-empty

:Time to avoid at the berth side for ship supply loading operation
:Time to Avoid
:Time to avoid at the berth side for ship supply loading operation
:NA
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ) Date is not in the future

{
  • "vvi_vessel_nm": "string",
  • "vvi_voyage_no": "string",
  • "vvi_inward_voyage_no": "string",
  • "vvi_outward_voyage_no": "string",
  • "vvi_vessel_status": "string",
  • "vvi_vessel_eta_dt": "2019-08-24T14:15:22Z",
  • "vvi_vessel_etd_dt": "2019-08-24T14:15:22Z",
  • "vvi_vessel_ata_dt": "2019-08-24T14:15:22Z",
  • "vvi_vessel_atd_dt": "2019-08-24T14:15:22Z",
  • "vvi_terminal_berth": "string",
  • "vvi_time_to_avoid": [
    ]
}

Vessel Voyage Schedule

Data Element ID: vessel_activity

Any of
container_no
string or null (Container Number)

:Identification number of container. Sample value: CBHU4398907
:Container Number
:Identification number of container. Sample value: CBHU4398907
:ISO6346
:Min characters = 11, Max characters = 11
4 Alphas (4th Alpha is U/J/Z) and 7 digits

unique_cargo_ref
string or null (Unique Cargo Reference)

:Unique Cargo Reference / Booking Confirmation number
:Unique Cargo Reference
:Unique Cargo Reference / Booking Confirmation number
:NA
:Min characters = 1, Max characters = 255
Alphanumeric

vessel_imo
string or null (IMO Number)

:IMO number of the vessel
:IMO Number
:IMO number of the vessel
:NA
:NA

abbr_vessel_nm
string or null (Abbreviated Vessel Name)

:Abbreviated vessel name
:Abbreviated Vessel Name
:Abbreviated vessel name
:NA
:NA

vessel_nm
required
string (Full Vessel Name)

:Full name of the vessel
:Full Vessel Name
:Full name of the vessel
:NA
:Min characters = 1, Max characters = 255
Alphanumeric
No Special Characters

abbr_inward_voy
string or null (Abbreviated Inward Voyage Number)

:Abbreviated inward voyage number
:Abbreviated Inward Voyage Number
:Abbreviated inward voyage number
:NA
:NA

inward_voyage_no
required
string (Inward Voyage Number)

:Full inward voyage number
:Inward Voyage Number
:Full inward voyage number
:NA
:Min characters = 1, Max characters = 8
Alphanumeric

abbr_outward_voy
string or null (Abbreviated Outward Voyage Number)

:Abbreviated outward voyage number
:Abbreviated Outward Voyage Number
:Abbreviated outward voyage number
:NA
:NA

outward_voyage_no
required
string (Outward Voyage Number)

:Full outward voyage number
:Outward Voyage Number
:Full outward voyage number
:NA
:Min characters = 1, Max characters = 8
Alphanumeric

vessel_btr_dt
required
string <date-time> (Berthing Time Request Date-Time)

:Requested time of vessel berthing at Singapore terminal, submitted by Carrier (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z.
:Berthing Time Request Date-Time
:Requested time of vessel berthing at Singapore terminal, submitted by Carrier (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z.
:NA
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is in the future

vessel_etb_dt
string or null <date-time> (Vessel Estimated Time of Berthing Date-Time)

:Estimated time of vessel berth at terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:Vessel Estimated Time of Berthing Date-Time
:Estimated time of vessel berth at terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is in the future

vessel_etu_dt
string or null <date-time> (Vessel Estimated Time of Unberthing Date-Time)

:Estimated time of vessel unberth at terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:Vessel Estimated Time of Unberthing Date-Time
:Estimated time of vessel unberth at terminal, planned by Port Operator (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is in the future

abbr_terminal_nm
string or null (Abbreviated Terminal Name)

:Abbreviated Terminal Name
:Abbreviated Terminal Name
:Abbreviated Terminal Name
:NA
:Min characters = 3, Max characters = 3. First character is an alpha and 2 digits

vessel_etd_dt
string or null <date-time> (Vessel Estimated Time of Departure Date-Time)

:Declared time of vessel unberthing at Singapore terminal, submitted by Carrier (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z.
:Vessel Estimated Time of Departure Date-Time
:Declared time of vessel unberthing at Singapore terminal, submitted by Carrier (ISO8601). Sample Value: 2021-05-14T16:50:00.000Z.
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

terminal_berth
required
string (Terminal and Berth)

:Vessel berthing terminal and berth number (terminal prefix and berth number e.g. P01, B05).
:Terminal and Berth
:Vessel berthing terminal and berth number (terminal prefix and berth number e.g. P01, B05).
:NA
:Min characters = 3, Max characters = 3. First character is an alpha and 2 digits

vessel_consortium_nm
string or null (Consortium Name)

:Shipping consortium/alliance name
:Consortium Name
:Shipping consortium/alliance name
:NA
:NA

vessel_consortium_cd
string or null (Consortium Code)

:Shipping consortium/alliance code
:Consortium Code
:Shipping consortium/alliance code
:NA
:NA

vessel_operator_cd
required
string (Vessel Operator Code)

:Organisation code for vessel operator as per SMDG definition. Sample values: COS, OOL, PIL
:Vessel Operator Code
:Organisation code for vessel operator as per SMDG definition. Sample values: COS, OOL, PIL
:SMDG
:Min characters = 3, Max characters = 3
Alpha

vessel_operator_uen
string or null (Vessel Operator Unique Entity Number)

:Unique Entity Number for vessel operator
:Vessel Operator Unique Entity Number
:Unique Entity Number for vessel operator
:ACRA
:Min characters = 9, Max characters = 10
Alphanumeric. Final character is an alpha

vessel_operator_nm
string or null (Vessel Operator Name)

:Organisation name for vessel operator
:Vessel Operator Name
:Organisation name for vessel operator
:NA
:NA

vessel_psa_service
string or null (PSA Service Code)

:Shipping service code used by PSA
:PSA Service Code
:Shipping service code used by PSA
:NA
:NA

vessel_psa_service_desc
string or null (PSA Service Description)

:Description of shipping service used by PSA
:PSA Service Description
:Description of shipping service used by PSA
:NA
:NA

vessel_cust_service
string or null (Customer Service Code)

:Shipping service code used by carriers
:Customer Service Code
:Shipping service code used by carriers
:NA
:NA

vessel_cust_service_desc
string or null (Customer Service Description)

:Description of service code used by carriers
:Customer Service Description
:Description of service code used by carriers
:NA
:NA

vessel_status
required
string (Vessel Status)

:Status of vessel - Berthing, Alongside, Unberthing
:Vessel Status
:Status of vessel - Berthing, Alongside, Unberthing
:Custom
:Min characters = 8, Max characters = 10
Alpha, equal to "Berthing", "Alongside" or "Unberthing"

vessel_shift_seq
string or null (Shift Sequence Number)

:Number of the shift sequence
:Shift Sequence Number
:Number of the shift sequence
:NA
:NA

vessel_atb_dt
string or null <date-time> (Vessel Actual Time of Berthing Date-Time)

:Actual time of berthing at terminal
:Vessel Actual Time of Berthing Date-Time
:Actual time of berthing at terminal
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

vessel_atu_dt
string or null <date-time> (Vessel Actual Time of Unberthing Date-Time)

:Actual time of unberthing from terminal
:Vessel Actual Time of Unberthing Date-Time
:Actual time of unberthing from terminal
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

vessel_cod_dt
string or null <date-time> (Vessel Completion Of Discharge Date-Time)

:Actual time of completion of discharge for all containers
:Vessel Completion Of Discharge Date-Time
:Actual time of completion of discharge for all containers
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

vessel_col_dt
string or null <date-time> (Vessel Completion Of Loading Date-Time)

:Actual time of completion of loading for all containers
:Vessel Completion Of Loading Date-Time
:Actual time of completion of loading for all containers
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

vessel_cob_dt
string or null <date-time> (Vessel Completion Of Bunker Date-Time)

:Actual time of completion of bunker
:Vessel Completion Of Bunker Date-Time
:Actual time of completion of bunker
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

snapshot_dt
required
string <date-time> (Snapshot Date-Time)

:Timestamp of this record being captured
:Snapshot Date-Time
:Timestamp of this record being captured
:ISO8601
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)
Date is not in the future

Example
{
  • "container_no": "string",
  • "unique_cargo_ref": "string",
  • "vessel_imo": "string",
  • "abbr_vessel_nm": "string",
  • "vessel_nm": "string",
  • "abbr_inward_voy": "string",
  • "inward_voyage_no": "string",
  • "abbr_outward_voy": "string",
  • "outward_voyage_no": "string",
  • "vessel_btr_dt": "2019-08-24T14:15:22Z",
  • "vessel_etb_dt": "2019-08-24T14:15:22Z",
  • "vessel_etu_dt": "2019-08-24T14:15:22Z",
  • "abbr_terminal_nm": "string",
  • "vessel_etd_dt": "2019-08-24T14:15:22Z",
  • "terminal_berth": "string",
  • "vessel_consortium_nm": "string",
  • "vessel_consortium_cd": "string",
  • "vessel_operator_cd": "string",
  • "vessel_operator_uen": "string",
  • "vessel_operator_nm": "string",
  • "vessel_psa_service": "string",
  • "vessel_psa_service_desc": "string",
  • "vessel_cust_service": "string",
  • "vessel_cust_service_desc": "string",
  • "vessel_status": "string",
  • "vessel_shift_seq": "string",
  • "vessel_atb_dt": "2019-08-24T14:15:22Z",
  • "vessel_atu_dt": "2019-08-24T14:15:22Z",
  • "vessel_cod_dt": "2019-08-24T14:15:22Z",
  • "vessel_col_dt": "2019-08-24T14:15:22Z",
  • "vessel_cob_dt": "2019-08-24T14:15:22Z",
  • "snapshot_dt": "2019-08-24T14:15:22Z"
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

:Note
:Note
:Note
:NA
:NA

Array of objects or null (Other Documents Attachment)

:Other Documents Attachment
:Other Documents Attachment
:Other Documents Attachment
:NA
:NA

{
  • "note": "string",
  • "attachments": [
    ]
}

Use Case E (Parameters)

Parameter schemas for Use Case E

Crane Blockage

Data Element ID: crane_blockage

vesselName
required
string (Vessel Name)

Name of vessel

voyageNumber
required
string (Voyage Number)

Loader full inward/ outward voyage number

numberOfBerthingSequences
required
string (Number of Berthing Sequences)

Number of berthing sequences to query/display

{
  • "vesselName": "string",
  • "voyageNumber": "string",
  • "numberOfBerthingSequences": "string"
}

Delivery Shipment Advice

Data Element ID: delivery_shipment_advice

One of
dsa_no
required
string (DSA)

Unique identifier for DSA. Delivery Shipment Advice

dsa_cargo_declarant
required
string (Cargo Declarant)

Name of cargo declarant

Example
{
  • "dsa_no": "string",
  • "dsa_cargo_declarant": "string"
}

Job Report (USN)

Data Element ID: job_report_usn

jr_usn
required
string (USN)

Unique identifier for job. Unique Shipment Number

jr_main_lighter_operator
required
string (Main Lighter Operator)

Name of assigned Lighter Operator

{
  • "jr_usn": "string",
  • "jr_main_lighter_operator": "string"
}

Lighter Boat Loading Confirmation

Data Element ID: lighter_boat_loading_confirmation

lighter_boat_loading_confirmation_usn
required
string (USN)

NA

lighter_boat_loading_confirmation_dsa_no
required
string (DSA)

NA

{
  • "lighter_boat_loading_confirmation_usn": "string",
  • "lighter_boat_loading_confirmation_dsa_no": "string"
}

Lighter Boat Location

Data Element ID: lighter_boat_location

One of
lighter_loc_position_radius
required
string (Position Radius (metres))

Radius of coverage from provided lighter boat coordinates

lighter_loc_position_latitude
required
number (Position Latitude)

Latitude coordinates of lighter boat. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10

lighter_loc_position_longitude
required
number (Position Longtitude)

Longitude coordinates of lighter boat. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10

Example
{
  • "lighter_loc_position_radius": "string",
  • "lighter_loc_position_latitude": 0,
  • "lighter_loc_position_longitude": 0
}

Lighter Boat Schedule

Data Element ID: lighter_boat_schedule

lighter_schedule_usn
required
string (USN)

Unique identifier for job. Unique Shipment Number

lighter_schedule_supply_boat_id
required
string (Supply boat Identifier)

Supply boat Identifier

{
  • "lighter_schedule_usn": "string",
  • "lighter_schedule_supply_boat_id": "string"
}

Lighter Call

Data Element ID: lighter_call

lighter_call_lighter_nm
required
string (Lighter Name)

Name of lighter

lighter_call_usn
required
string (USN)

Unique identifier for job. Unique Shipment Number.

{
  • "lighter_call_lighter_nm": "string",
  • "lighter_call_usn": "string"
}

Manifest

Data Element ID: manifest

manifest_vessel_nm
required
string (Vessel Name)

Vessel Name

manifest_vessel_destination
required
string (Vessel Destination)

Vessel Destination

manifest_vessel_eta
required
string <date-time> (Vessel ETA)

Estimated Time of Arrival (ETA) at vessel

{
  • "manifest_vessel_nm": "string",
  • "manifest_vessel_destination": "string",
  • "manifest_vessel_eta": "2019-08-24T14:15:22Z"
}

Mother Vessel Loading Confirmation

Data Element ID: mother_vessel_loading_confirmation

mother_vessel_loading_confirmation_usn
required
string (USN)

Unique identifier for job. Unique Shipment Number

{
  • "mother_vessel_loading_confirmation_usn": "string"
}

Pallet Information

Data Element ID: pallet_information

pallet_info_usn
required
string (USN)

Unique identifier for job. Unique Shipment Number

{
  • "pallet_info_usn": "string"
}

Pilotage Service

Data Element ID: pilotage_service

pilotage_imo
required
string (International Maritime Organisation number)

International Maritime Organisation (IMO) Vessel Identification number

{
  • "pilotage_imo": "string"
}

Product Catalogue

Data Element ID: product_catalogue

product_catalogue_sku
required
string (SKU)

SKU

product_catalogue_nm
required
string (Name)

Name

{
  • "product_catalogue_sku": "string",
  • "product_catalogue_nm": "string"
}

Product Offering

Data Element ID: product_offering

product_offering_no
required
string (Product information number)

Product information number

{
  • "product_offering_no": "string"
}

Purchase Order (PO)

Data Element ID: purchase_order_po

po_no
required
string (PO Number)

PO Number

{
  • "po_no": "string"
}

Ship Supplies' Delivery Information

Data Element ID: ship_supplies_di

di_no
required
string (DO Number)

Delivery Order (DO) Number

{
  • "di_no": "string"
}

Ship Supplies' Delivery Order

Data Element ID: ship_supplies_do

do_no
required
string (DO Number)

Delivery Order (DO) Number

{
  • "do_no": "string"
}

Ship Supplies' Invoice

Data Element ID: ship_supplies_invoice

invoice_no
required
string (Invoice Number)

Identifier number of invoice

{
  • "invoice_no": "string"
}

Truck Location

Data Element ID: truck_location

One of
truck_loc_position_radius
required
string (Position Radius (metres))

Radius of coverage from provided vehicle coordinates

truck_loc_position_latitude
required
number (Position Latitude)

Latitude coordinates of vehicle. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10

truck_loc_position_longitude
required
number (Position Longtitude)

Longitude coordinates of vehicle. This field has a commonly agreed minimum decimal precision = 4 and maximum decimal precision = 10

Example
{
  • "truck_loc_position_radius": "string",
  • "truck_loc_position_latitude": 0,
  • "truck_loc_position_longitude": 0
}

Truck Schedule

Data Element ID: truck_schedule

truck_schedule_usn
required
string (USN)

Unique identifier for job. Unique Shipment Number

truck_schedule_dsa
required
string (DSA)

Unique identifier for DSA. Delivery Shipment Advice

{
  • "truck_schedule_usn": "string",
  • "truck_schedule_dsa": "string"
}

Vehicle Port Entry Exit

Data Element ID: vehicle_port_entry_exit

vehicle_port_entry_exit_vehicle_no
required
string (Vehicle Number)

Registration number of the assigned vehicle

{
  • "vehicle_port_entry_exit_vehicle_no": "string"
}

Vessel Current Position

Data Element ID: vessel_current_position

One of
vessel_nm
required
string (Receiving Vessel Name)

Name of the Vessel

Note: Only latest data is available where applicable.

Example
{
  • "vessel_nm": "string"
}

Vessel Due to Arrive

Data Element ID: vessel_due_to_arrive

One of
any (vda_in_date)
Example
null

Vessel Information

Data Element ID: vessel_information

vessel_imo_no
required
string (International Maritime Organisation Number)

International Maritime Organisation (IMO) Vessel Identification Number, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).

vessel_datetime_of_querying
required
string <date-time> (Querying Date Time)

This field is used only for querying of vessel event data

{
  • "vessel_imo_no": "string",
  • "vessel_datetime_of_querying": "2019-08-24T14:15:22Z"
}

Vessel Movement

Data Element ID: vessel_movement

One of
vessel_nm
required
string (Receiving Vessel Name)

Name of the Vessel, Note: For push, only latest data is available where applicable. For pull, this field will return results as at the query date and time supplied in "vessel_datetime_of_querying" (part of the parameter for this API).

Example
{
  • "vessel_nm": "string"
}

Vessel Voyage Information

Data Element ID: vvi

One of
vvi_vessel_nm
required
string (Vessel Name)

Name of vessel

vvi_voyage_no
required
string (Voyage Number)

Loader full inward/ outward voyage number

{
  • "vvi_vessel_nm": "string",
  • "vvi_voyage_no": "string"
}

Vessel Voyage Schedule

Data Element ID: vessel_activity

One of
vessel_nm
required
string (Full Vessel Name)

Full name of the vessel

voyage_no
required
string (Voyage Number)

Full inward/ outward voyage number

Example
{
  • "vessel_nm": "string",
  • "voyage_no": "string"
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

Note

{
  • "note": "string"
}

Use Case F (Payload)

Payload schemas for Use Case F

Liquid Bulk Agent Nomination Timestamp

Data Element ID: liquid_bulk_agent_nomination_timestamp

liquid_bulk_agent_nomination_timestamp_agent_nomination_of_terminal
string <date-time> (Agent nomination of terminal)

:Agent nomination of terminal
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_vessel_name
required
string (Vessel Name)

:Vessel Name
:Name of Vessel on or for which activity was conducted
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_imo_number
string (IMO Number)

:IMO Number
:IMO Number of Vessel on which Activity was conducted
:IMO Number of Vessel on which Activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_remarks
string (Remarks)

:Remarks
:Additional Remarks
:Additional Remarks
:NA
:NA

{
  • "liquid_bulk_agent_nomination_timestamp_agent_nomination_of_terminal": "2019-08-24T14:15:22Z",
  • "liquid_bulk_vessel_clearance_timestamp_vessel_name": "string",
  • "liquid_bulk_vessel_clearance_timestamp_imo_number": "string",
  • "liquid_bulk_vessel_clearance_timestamp_remarks": "string"
}

Liquid Bulk Anchorage Timestamp

Data Element ID: liquid_bulk_anchorage_timestamp

liquid_bulk_moving_to_anchorage_timestamp_decide_to_move_vessel_from_sg_port_to_anchorage
string <date-time> (Submission of Q88)

:Decide port to anchorage movement
:Decide port to anchorage movement
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_instruct_agent_to_book_pilot_to_anchorage
string <date-time> (Instruct agent to Book pilot to anchorage)

:Instruct agent to Book pilot to anchorage
:Instruct agent to Book pilot to anchorage
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_pilot_booked
string <date-time> (Pilot booked)

:Pilot booked
:Pilot booked
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_pilot_order_confirmed
string <date-time> (Pilot order confirmed)

:Pilot order confirmed
:Pilot order confirmed
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_service_request_time
string <date-time> (Service request time)

:Service request time
:Service request time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_cofirmed_service_time
string <date-time> (Cofirmed Service Time)

:Cofirmed Service Time
:Cofirmed Service Time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_pilot_arrival_time
string <date-time> (Pilot Arrival Time)

:Pilot Arrival Time
:Pilot Arrival Time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_pilot_onboard_time
string <date-time> (Pilot Onboard Time)

:Pilot Onboard Time
:Pilot Onboard Time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_start_of_pilotage_service
string <date-time> (Start of Pilotage Service)

:Start of Pilotage Service
:Start of Pilotage Service
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_end_of_pilotage_service
string <date-time> (End of Pilotage Service)

:End of Pilotage Service
:End of Pilotage Service
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_vessel_arrive_at_anchorage
string <date-time> (Vessel arrive at anchorage)

:Vessel arrive at anchorage
:Vessel arrive at anchorage
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_vessel_tendering_nor
string <date-time> (Vessel tendering NOR)

:Vessel tendering NOR
:Vessel tendering NOR
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_moving_to_anchorage_timestamp_sampling_tank_inspection_at_anchorage
string <date-time> (Sampling/Tank inspection at anchorage)

:Sampling/Tank inspection at anchorage
:Sampling/Tank inspection at anchorage
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_anchorage_timestamp_vessel_name
required
string (Vessel Name)

:Vessel Name
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_anchorage_timestamp_imo_number
string (IMO Number)

:IMO Number
:IMO Number
:IMO Number of Vessel on which Activity was conducted
:NA
:NA

liquid_bulk_anchorage_timestamp_anchorage_point
required
string (Anchorage Point)

:Anchorage Point
:Anchorage Point
:Name of Anchorage
:NA
:NA

liquid_bulk_anchorage_timestamp_remarks
string (Remarks)

:Remarks
:Remarks
:Additional Remarks
:NA
:NA

{
  • "liquid_bulk_moving_to_anchorage_timestamp_decide_to_move_vessel_from_sg_port_to_anchorage": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_instruct_agent_to_book_pilot_to_anchorage": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_pilot_booked": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_pilot_order_confirmed": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_service_request_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_cofirmed_service_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_pilot_arrival_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_pilot_onboard_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_start_of_pilotage_service": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_end_of_pilotage_service": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_vessel_arrive_at_anchorage": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_vessel_tendering_nor": "2019-08-24T14:15:22Z",
  • "liquid_bulk_moving_to_anchorage_timestamp_sampling_tank_inspection_at_anchorage": "2019-08-24T14:15:22Z",
  • "liquid_bulk_anchorage_timestamp_vessel_name": "string",
  • "liquid_bulk_anchorage_timestamp_imo_number": "string",
  • "liquid_bulk_anchorage_timestamp_anchorage_point": "string",
  • "liquid_bulk_anchorage_timestamp_remarks": "string"
}

Liquid Bulk Berthing Timestamp

Data Element ID: liquid_bulk_berthing_timestamp

liquid_bulk_berthing_to_terminal_timestamp_instruct_agent_to_book_pilot_to_jetty
string <date-time> (Instruct agent to Book pilot to jetty)

:Datetime at which activity was conducted
:Instruct agent to Book pilot to jetty
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_to_terminal_timestamp_time_actual_booking_is_done_by_agent
string <date-time> (Time actual booking is done by agent)

:Datetime at which activity was conducted
:Time actual booking is done by agent
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_to_terminal_timestamp_time_pilot_confirms_the_order
string <date-time> (Time pilot confirms the order)

:Datetime at which activity was conducted
:Time pilot confirms the order
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_to_terminal_timestamp_service_request_time
string <date-time> (Service request time)

:Datetime at which activity was conducted
:Service request time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_to_terminal_timestamp_expected_boarding_time
string <date-time> (Expected boarding time)

:Datetime at which activity was conducted
:Expected boarding time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_to_terminal_timestamp_pilot_arrival_time
string <date-time> (Pilot Arrival Time)

:Datetime at which activity was conducted
:Pilot Arrival Time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_to_terminal_timestamp_pilot_onboard_time
string <date-time> (Pilot Onboard Time)

:Datetime at which activity was conducted
:Pilot Onboard Time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_to_terminal_timestamp_start_of_pilotage_service
string <date-time> (Start of Pilotage Service)

:Datetime at which activity was conducted
:Start of Pilotage Service
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_to_terminal_timestamp_end_of_pilotage_service
string <date-time> (End of Pilotage Service)

:Datetime at which activity was conducted
:End of Pilotage Service
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_to_terminal_timestamp_first_line_ashore
string <date-time> (First line ashore)

:Datetime at which activity was conducted
:First line ashore
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_to_terminal_timestamp_vessel_all_fast
string <date-time> (Vessel all fast)

:Datetime at which activity was conducted
:Vessel all fast
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_to_terminal_timestamp_gangway_down
string <date-time> (Gangway down)

:Datetime at which activity was conducted
:Gangway down
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_berthing_timestamp_vessel_name
required
string (Vessel Name)

:Name of Vessel on or for which activity was conducted
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_berthing_timestamp_imo_number
string (IMO Number)

:IMO Number of Vessel on which activity was conducted
:IMO Number
:IMO Number of Vessel on which activity was conducted
:NA
:NA

liquid_bulk_berthing_timestamp_terminal
required
string (Terminal)

:Name of Terminal at which or for which activity was conducted
:Terminal
:Name of Terminal at which or for which activity was conducted
:NA
:NA

liquid_bulk_berthing_timestamp_jetty
required
string (Jetty)

:Jetty at which activity was conducted
:Jetty
:Jetty at which activity was conducted
:NA
:NA

liquid_bulk_berthing_timestamp_remarks
string (Remarks)

: Additional Remarks
:Remarks
:Additional Remarks
:NA
:NA

{
  • "liquid_bulk_berthing_to_terminal_timestamp_instruct_agent_to_book_pilot_to_jetty": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_to_terminal_timestamp_time_actual_booking_is_done_by_agent": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_to_terminal_timestamp_time_pilot_confirms_the_order": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_to_terminal_timestamp_service_request_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_to_terminal_timestamp_expected_boarding_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_to_terminal_timestamp_pilot_arrival_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_to_terminal_timestamp_pilot_onboard_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_to_terminal_timestamp_start_of_pilotage_service": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_to_terminal_timestamp_end_of_pilotage_service": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_to_terminal_timestamp_first_line_ashore": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_to_terminal_timestamp_vessel_all_fast": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_to_terminal_timestamp_gangway_down": "2019-08-24T14:15:22Z",
  • "liquid_bulk_berthing_timestamp_vessel_name": "string",
  • "liquid_bulk_berthing_timestamp_imo_number": "string",
  • "liquid_bulk_berthing_timestamp_terminal": "string",
  • "liquid_bulk_berthing_timestamp_jetty": "string",
  • "liquid_bulk_berthing_timestamp_remarks": "string"
}

Liquid Bulk Cargo Post Ops Timestamp

Data Element ID: liquid_bulk_cargo_post_ops_timestamp

liquid_bulk_post_cargo_ops_surveyor_timestamp_surveyor_onboard
string <date-time> (Surveyor onboard)

:Datetime at which activity was conducted
:Surveyor onboard
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_post_cargo_ops_surveyor_timestamp_start_taking_sample
string <date-time> (Start taking sample)

:Datetime at which activity was conducted
:Start taking sample
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_post_cargo_ops_surveyor_timestamp_complete_taking_sample
string <date-time> (Complete taking sample)

:Datetime at which activity was conducted
:Complete taking sample
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_post_cargo_ops_surveyor_timestamp_start_ullaging_calculation
string <date-time> (Start ullaging / calculation)

:Datetime at which activity was conducted
:Start ullaging / calculation
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_post_cargo_ops_surveyor_timestamp_complete_ullaging_calculation
string <date-time> (Complete ullaging / calculation)

:Datetime at which activity was conducted
:Complete ullaging / calculation
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_post_cargo_ops_surveyor_timestamp_start_hose_disconnection
string <date-time> (Start Hose disconnection)

:Datetime at which activity was conducted
:Start Hose disconnection
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_post_cargo_ops_surveyor_timestamp_surveyor_offboard
string <date-time> (Surveyor offboard)

:Datetime at which activity was conducted
:Surveyor offboard
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_post_cargo_ops_surveyor_timestamp_completed_hose_disconnection
string <date-time> (Completed hose disconnection)

:Datetime at which activity was conducted
:Completed hose disconnection
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_post_cargo_ops_surveyor_timestamp_documentation_on_board
string <date-time> (Documentation on board)

:Datetime at which activity was conducted
:Documentation on board
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_post_ops_timestamp_vessel_name
required
string (Vessel Name)

:Name of Vessel on or for which activity was conducted
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_cargo_post_ops_timestamp_imo_number
string (IMO Number)

:IMO Number of Vessel on which activity was conducted
:IMO Number
:IMO Number of Vessel on which activity was conducted
:NA
:NA

liquid_bulk_cargo_post_ops_timestamp_terminal
required
string (Terminal)

:Name of Terminal at which or for which activity was conducted
:Terminal
:Name of Terminal at which or for which activity was conducted
:NA
:NA

liquid_bulk_cargo_post_ops_timestamp_jetty
required
string (Jetty)

:Jetty at which activity was conducted
:Jetty
:Jetty at which activity was conducted
:NA
:NA

liquid_bulk_cargo_post_ops_timestamp_remarks
string (Remarks)

:Additional Remarks
:Remarks
:Additional Remarks
:NA
:NA

{
  • "liquid_bulk_post_cargo_ops_surveyor_timestamp_surveyor_onboard": "2019-08-24T14:15:22Z",
  • "liquid_bulk_post_cargo_ops_surveyor_timestamp_start_taking_sample": "2019-08-24T14:15:22Z",
  • "liquid_bulk_post_cargo_ops_surveyor_timestamp_complete_taking_sample": "2019-08-24T14:15:22Z",
  • "liquid_bulk_post_cargo_ops_surveyor_timestamp_start_ullaging_calculation": "2019-08-24T14:15:22Z",
  • "liquid_bulk_post_cargo_ops_surveyor_timestamp_complete_ullaging_calculation": "2019-08-24T14:15:22Z",
  • "liquid_bulk_post_cargo_ops_surveyor_timestamp_start_hose_disconnection": "2019-08-24T14:15:22Z",
  • "liquid_bulk_post_cargo_ops_surveyor_timestamp_surveyor_offboard": "2019-08-24T14:15:22Z",
  • "liquid_bulk_post_cargo_ops_surveyor_timestamp_completed_hose_disconnection": "2019-08-24T14:15:22Z",
  • "liquid_bulk_post_cargo_ops_surveyor_timestamp_documentation_on_board": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_post_ops_timestamp_vessel_name": "string",
  • "liquid_bulk_cargo_post_ops_timestamp_imo_number": "string",
  • "liquid_bulk_cargo_post_ops_timestamp_terminal": "string",
  • "liquid_bulk_cargo_post_ops_timestamp_jetty": "string",
  • "liquid_bulk_cargo_post_ops_timestamp_remarks": "string"
}

Liquid Bulk Cargo Pre Ops Timestamp

Data Element ID: liquid_bulk_cargo_pre_ops_timestamp

liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_loading_master_onboard
string <date-time> (Loading master onboard)

:Datetime at which activity was conducted
:Loading master onboard
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_join_ship_shore_conference
string <date-time> (Join ship shore conference)

:Datetime at which activity was conducted
:Join ship shore conference
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_leave_ship_shore_conference
string <date-time> (Leave ship shore conference)

:Datetime at which activity was conducted
:Leave ship shore conference
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_mla_hose_connection_start
string <date-time> (MLA/Hose connection start)

:Datetime at which activity was conducted
:MLA/Hose connection start
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_mla_hose_connection_completed
string <date-time> (MLA/Hose connection completed)

:Datetime at which activity was conducted
:MLA/Hose connection completed
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nor_accepted
string <date-time> (NOR Accepted)

:Datetime at which activity was conducted
:NOR Accepted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nitrogen_hose_connected
string <date-time> (Nitrogen hose connected)

:Datetime at which activity was conducted
:Nitrogen hose connected
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nitrogen_purging_started
string <date-time> (Nitrogen purging started)

:Datetime at which activity was conducted
:Nitrogen purging started
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nitrogen_purging_completed
string <date-time> (Nitrogen purging completed)

:Datetime at which activity was conducted
:Nitrogen purging completed
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nitrogen_blanketing_completed
string <date-time> (Nitrogen blanketing completed)

:Datetime at which activity was conducted
:Nitrogen blanketing completed
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nitrogen_hose_disconnected
string <date-time> (Nitrogen hose disconnected)

:Datetime at which activity was conducted
:Nitrogen hose disconnected
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_timestamp_vessel_name
required
string (Vessel Name)

:Name of Vessel on or for which activity was conducted
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_timestamp_imo_number
string (IMO Number)

:IMO Number of Vessel on which activity was conducted
:IMO Number
:IMO Number of Vessel on which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_timestamp_terminal
required
string (Terminal)

:Name of Terminal at which or for which activity was conducted
:Terminal
:Name of Terminal at which or for which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_timestamp_jetty
required
string (Jetty)

:Jetty at which activity was conducted
:Jetty
:Jetty at which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_timestamp_remarks
string (Remarks)

:Addiitional Remarks
:Remarks
:Addiitional Remarks
:NA
:NA

{
  • "liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_loading_master_onboard": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_join_ship_shore_conference": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_leave_ship_shore_conference": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_mla_hose_connection_start": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_mla_hose_connection_completed": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nor_accepted": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nitrogen_hose_connected": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nitrogen_purging_started": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nitrogen_purging_completed": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nitrogen_blanketing_completed": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_pre_ops_terminal_ops_timestamp_nitrogen_hose_disconnected": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_pre_ops_timestamp_vessel_name": "string",
  • "liquid_bulk_cargo_pre_ops_timestamp_imo_number": "string",
  • "liquid_bulk_cargo_pre_ops_timestamp_terminal": "string",
  • "liquid_bulk_cargo_pre_ops_timestamp_jetty": "string",
  • "liquid_bulk_cargo_pre_ops_timestamp_remarks": "string"
}

Liquid Bulk Cargo Transfer Timestamp

Data Element ID: liquid_bulk_cargo_transfer_timestamp

liquid_bulk_cargo_transfer_timestamp_cargo_start
string <date-time> (Cargo start)

:Datetime at which activity was conducted
:Cargo start
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_cargo_suspension
string <date-time> (Cargo suspension)

:Datetime at which activity was conducted
:Cargo suspension
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_first_foot_loading_commence
string <date-time> (First foot loading commence)

:Datetime at which activity was conducted
:First foot loading commence
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_first_foot_loading_completed
string <date-time> (First foot loading Completed)

:Datetime at which activity was conducted
:First foot loading Completed
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_first_foot_sampling_commenced
string <date-time> (First foot sampling commenced)

:Datetime at which activity was conducted
:First foot sampling commenced
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_first_foot_sampling_completed
string <date-time> (First foot sampling completed)

:Datetime at which activity was conducted
:First foot sampling completed
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_first_foot_sample_taken
string <date-time> (First foot sample taken)

:Datetime at which activity was conducted
:First foot sample taken
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_first_foot_sample_passed
string <date-time> (First foot sample passed)

:Datetime at which activity was conducted
:First foot sample passed
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_clearance_to_resume_cargo_ops
string <date-time> (Clearance to resume cargo ops)

:Datetime at which activity was conducted
:Clearance to resume cargo ops
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_first_foot_resume
string <date-time> (First foot resume)

:Datetime at which activity was conducted
:First foot resume
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_cargo_resume
string <date-time> (Cargo resume)

:Datetime at which activity was conducted
:Cargo resume
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_cargo_completed
string <date-time> (Cargo completed)

:Datetime at which activity was conducted
:Cargo completed
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_vessel_name
required
string (Vessel Name)

:Name of Vessel on or for which activity was conducted
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_imo_number
string (IMO Number)

:IMO Number of Vessel on which activity was conducted
:IMO Number
:IMO Number of Vessel on which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_terminal
required
string (Terminal)

:Name of Terminal at which or for which activity was conducted
:Terminal
:Name of Terminal at which or for which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_jetty
required
string (Jetty)

:Jetty at which activity was conducted
:Jetty
:Jetty at which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_remarks
string (Remarks)

:Additional Remarks
:Remarks
:Additional Remarks
:NA
:NA

{
  • "liquid_bulk_cargo_transfer_timestamp_cargo_start": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_cargo_suspension": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_first_foot_loading_commence": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_first_foot_loading_completed": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_first_foot_sampling_commenced": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_first_foot_sampling_completed": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_first_foot_sample_taken": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_first_foot_sample_passed": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_clearance_to_resume_cargo_ops": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_first_foot_resume": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_cargo_resume": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_cargo_completed": "2019-08-24T14:15:22Z",
  • "liquid_bulk_cargo_transfer_timestamp_vessel_name": "string",
  • "liquid_bulk_cargo_transfer_timestamp_imo_number": "string",
  • "liquid_bulk_cargo_transfer_timestamp_terminal": "string",
  • "liquid_bulk_cargo_transfer_timestamp_jetty": "string",
  • "liquid_bulk_cargo_transfer_timestamp_remarks": "string"
}

Liquid Bulk Cargo Unberthing Timestamp

Data Element ID: liquid_bulk_cargo_unberthing_timestamp

liquid_bulk_unberthing_timestamp_instruct_agent_to_book_pilot_to_leave_jetty
string <date-time> (Instruct agent to Book pilot to leave jetty)

:Datetime at which activity was conducted
:Instruct agent to Book pilot to leave jetty
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_booking_time
string <date-time> (Booking time)

:Datetime at which activity was conducted
:Booking time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_confirmation_time
string <date-time> (Confirmation time)

:Datetime at which activity was conducted
:Confirmation time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_service_request_time
string <date-time> (Service request time)

:Datetime at which activity was conducted
:Service request time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_expected_boarding_time
string <date-time> (Expected boarding time)

:Datetime at which activity was conducted
:Expected boarding time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_pilot_arrival_time
string <date-time> (Pilot Arrival Time)

:Datetime at which activity was conducted
:Pilot Arrival Time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_pilot_onboard_time
string <date-time> (Pilot Onboard Time)

:Datetime at which activity was conducted
:Pilot Onboard Time
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_start_of_pilotage_service
string <date-time> (Start of Pilotage Service)

:Datetime at which activity was conducted
:Start of Pilotage Service
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_end_of_pilotage_service
string <date-time> (End of Pilotage Service)

:Datetime at which activity was conducted
:End of Pilotage Service
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_vessel_cast_off
string <date-time> (Vessel cast off)

:Datetime at which activity was conducted
:Vessel cast off
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_vessel_name
required
string (Vessel Name)

:Name of Vessel on or for which activity was conducted
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_imo_number
string (IMO Number)

:IMO Number of Vessel on which activity was conducted
:IMO Number
:IMO Number of Vessel on which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_terminal
required
string (Terminal)

:Name of Terminal at which or for which activity was conducted
:Terminal
:Name of Terminal at which or for which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_jetty
required
string (Jetty)

:Jetty at which activity was conducted
:Jetty
:Jetty at which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_remarks
string (Remarks)

:Additional Remarks
:Remarks
:Additional Remarks
:NA
:NA

{
  • "liquid_bulk_unberthing_timestamp_instruct_agent_to_book_pilot_to_leave_jetty": "2019-08-24T14:15:22Z",
  • "liquid_bulk_unberthing_timestamp_booking_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_unberthing_timestamp_confirmation_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_unberthing_timestamp_service_request_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_unberthing_timestamp_expected_boarding_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_unberthing_timestamp_pilot_arrival_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_unberthing_timestamp_pilot_onboard_time": "2019-08-24T14:15:22Z",
  • "liquid_bulk_unberthing_timestamp_start_of_pilotage_service": "2019-08-24T14:15:22Z",
  • "liquid_bulk_unberthing_timestamp_end_of_pilotage_service": "2019-08-24T14:15:22Z",
  • "liquid_bulk_unberthing_timestamp_vessel_cast_off": "2019-08-24T14:15:22Z",
  • "liquid_bulk_unberthing_timestamp_vessel_name": "string",
  • "liquid_bulk_unberthing_timestamp_imo_number": "string",
  • "liquid_bulk_unberthing_timestamp_terminal": "string",
  • "liquid_bulk_unberthing_timestamp_jetty": "string",
  • "liquid_bulk_unberthing_timestamp_remarks": "string"
}

Liquid Bulk Pre-Berthing Timestamp

Data Element ID: liquid_bulk_pre_berthing_timestamp

liquid_bulk_pre_berthing_process_timestamp_complete_submission_of_pbq
string <date-time> (Complete submission of PBQ)

:Complete submission of PBQ
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_pre_berthing_process_timestamp_advance_eta_notice_prior_to_arrival_in_sg
string <date-time> (Advance ETA notice prior to arrival in SG)

:Advance ETA notice prior to arrival in SG
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_pre_berthing_process_timestamp_entering_and_updating_vessel_eta
string <date-time> (Entering and updating vessel ETA)

:Entering and updating vessel ETA
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_pre_berthing_process_timestamp_entering_&_updating_work_order_log_job
string <date-time> (Entering & updating Work order/log job)

:Entering and updating Work order/log job
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_pre_berthing_process_timestamp_vessel_arrival_in_singapore_port
string <date-time> (Vessel arrival in Singapore port)

:Vessel arrival in Singapore port
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_pre_berthing_process_timestamp_vessel_tendering_nor
string <date-time> (Vessel tendering NOR)

:Vessel tendering NOR
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_pre_berthing_timestamp_vessel_name
required
string (Vessel Name)

:Vessel Name
:Name of Vessel on or for which activity was conducted
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_pre_berthing_timestamp_imo_number
string (IMO Number)

:IMO Number
:IMO Number of Vessel on which Activity was conducted
:IMO Number of Vessel on which Activity was conducted
:NA
:NA

liquid_bulk_pre_berthing_timestamp_terminal
required
string (Terminal)

:Terminal
:Terminal
:Name of Terminal at which or for which activity was conducted
:NA
:NA

liquid_bulk_pre_berthing_timestamp_remarks
string (Remarks)

:Remarks
:Remarks
:Addiitional Remarks
:NA
:NA

{
  • "liquid_bulk_pre_berthing_process_timestamp_complete_submission_of_pbq": "2019-08-24T14:15:22Z",
  • "liquid_bulk_pre_berthing_process_timestamp_advance_eta_notice_prior_to_arrival_in_sg": "2019-08-24T14:15:22Z",
  • "liquid_bulk_pre_berthing_process_timestamp_entering_and_updating_vessel_eta": "2019-08-24T14:15:22Z",
  • "liquid_bulk_pre_berthing_process_timestamp_entering_&_updating_work_order_log_job": "2019-08-24T14:15:22Z",
  • "liquid_bulk_pre_berthing_process_timestamp_vessel_arrival_in_singapore_port": "2019-08-24T14:15:22Z",
  • "liquid_bulk_pre_berthing_process_timestamp_vessel_tendering_nor": "2019-08-24T14:15:22Z",
  • "liquid_bulk_pre_berthing_timestamp_vessel_name": "string",
  • "liquid_bulk_pre_berthing_timestamp_imo_number": "string",
  • "liquid_bulk_pre_berthing_timestamp_terminal": "string",
  • "liquid_bulk_pre_berthing_timestamp_remarks": "string"
}

Liquid Bulk Terminal Nomination Timestamp

Data Element ID: liquid_bulk_terminal_nomination_timestamp

liquid_bulk_customer_nomination_timestamp_entering_initial_nomination
string <date-time> (Entering initial nomination)

:Entering initial nomination
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_customer_nomination_timestamp_entering_update_nomination
string <date-time> (Entering update nomination)

:Entering update nomination
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_customer_nomination_timestamp_cancelation_of_nomination
string <date-time> (Cancelation of nomination)

:Cancelation of nomination
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_customer_nomination_timestamp_acceptance_of_nomination
string <date-time> (Acceptance of nomination)

:Acceptance of nomination
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_customer_nomination_timestamp_rejection_of_nomination
string <date-time> (Rejection of nomination)

:Rejection of nomination
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_customer_nomination_timestamp_appointment_of_surveyor_agent
string (Appointment of surveyor and agent)

:Appointment of surveyor and agent
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_imo_number
string (IMO Number)

:IMO Number
:IMO Number of Vessel on which Activity was conducted
:IMO Number of Vessel on which Activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_terminal
required
string (Terminal)

:Terminal
:Name of Terminal at which or for which activity was conducted
:Name of Terminal at which or for which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_vessel_name
required
string (Vessel Name)

:Vessel Name
:Name of Vessel on or for which activity was conducted
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_remarks
string (Remarks)

:Remarks
:Additional Remarks
:Additional Remarks
:NA
:NA

{
  • "liquid_bulk_customer_nomination_timestamp_entering_initial_nomination": "2019-08-24T14:15:22Z",
  • "liquid_bulk_customer_nomination_timestamp_entering_update_nomination": "2019-08-24T14:15:22Z",
  • "liquid_bulk_customer_nomination_timestamp_cancelation_of_nomination": "2019-08-24T14:15:22Z",
  • "liquid_bulk_customer_nomination_timestamp_acceptance_of_nomination": "2019-08-24T14:15:22Z",
  • "liquid_bulk_customer_nomination_timestamp_rejection_of_nomination": "2019-08-24T14:15:22Z",
  • "liquid_bulk_customer_nomination_timestamp_appointment_of_surveyor_agent": "string",
  • "liquid_bulk_vessel_clearance_timestamp_imo_number": "string",
  • "liquid_bulk_vessel_clearance_timestamp_terminal": "string",
  • "liquid_bulk_vessel_clearance_timestamp_vessel_name": "string",
  • "liquid_bulk_vessel_clearance_timestamp_remarks": "string"
}

Liquid Bulk Vessel Clearance Timestamp

Data Element ID: liquid_bulk_vessel_clearance_timestamp

liquid_bulk_vessel_clearance_submission_of_q88
string <date-time> (Submission of Q88)

:Submission of Q88
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_receiving_of_q88
string <date-time> (Receiving of Q88)

:Receiving of Q88
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_confirmation_vessel_clearance
string <date-time> (Confirmation of vessel clearance)

:Confirmation of vessel clearance
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_acknowledge_confirmation_vessel_clearance
string <date-time> (Acknowledge confirmation of clearance)

:Acknowledge confirmation of clearance
:Datetime at which activity was conducted
:Datetime at which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_vessel_name
required
string (Vessel Name)

:Vessel Name
:Name of Vessel on or for which activity was conducted
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_imo_number
string (IMO Number)

:IMO Number
:IMO Number of Vessel on which Activity was conducted
:IMO Number of Vessel on which Activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_terminal
required
string (Terminal)

:Terminal
:Name of Terminal at which or for which activity was conducted
:Name of Terminal at which or for which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_jetty
string (Jetty)

:Jetty
:Name of Jetty at which or for which activity was conducted
:Name of Jetty at which or for which activity was conducted
:NA
:NA

liquid_bulk_vessel_clearance_timestamp_remarks
string (Remarks)

:Remarks
:Addiitional Remarks
:Addiitional Remarks
:NA
:NA

{
  • "liquid_bulk_vessel_clearance_submission_of_q88": "2019-08-24T14:15:22Z",
  • "liquid_bulk_vessel_clearance_receiving_of_q88": "2019-08-24T14:15:22Z",
  • "liquid_bulk_vessel_clearance_confirmation_vessel_clearance": "2019-08-24T14:15:22Z",
  • "liquid_bulk_vessel_clearance_acknowledge_confirmation_vessel_clearance": "2019-08-24T14:15:22Z",
  • "liquid_bulk_vessel_clearance_timestamp_vessel_name": "string",
  • "liquid_bulk_vessel_clearance_timestamp_imo_number": "string",
  • "liquid_bulk_vessel_clearance_timestamp_terminal": "string",
  • "liquid_bulk_vessel_clearance_timestamp_jetty": "string",
  • "liquid_bulk_vessel_clearance_timestamp_remarks": "string"
}

Pilotage Event

Data Element ID: demurrage_pilotage_service

pilot_order_no
required
string (OHS Pilot Order Number)

:OHS Pilot Order Number
:Unique transaction reference number in OHS system to identify the pilot order
:Unique transaction reference number in OHS system to identify the pilot order
:NA
:NA

pilot_imo_no
required
string (IMO Number)

:IMO Number
:International Maritime Organisation(IMO) unique ship identification number, for identification of the vessel.
:International Maritime Organisation(IMO) unique ship identification number, for identification of the vessel.
:NA
:7 characters, Numeric

pilot_location_to
required
string (Location_To)

:Location_To
:Location To Code for the location where vessel will be travelling to. Location codes are predetermined and maintained by MPA.
:Location To Code for the location where vessel will be travelling to. Location codes are predetermined and maintained by MPA.
:NA
:Min characters = 1, Max characters = 6, Alphanumeric

pilot_location_from
required
string (Location_From)

:Location_From
:Location From Code for the location where vessel will be travelling from. Location codes are predetermined and maintained by MPA.
:Location From Code for the location where vessel will be travelling from. Location codes are predetermined and maintained by MPA.
:NA
:Min characters = 1, Max characters = 6, Alphanumeric

pilot_service_request_time_agent_toa
required
string <date-time> (Pilot Booking Request Time (Time of Advice))

:Pilot Booking Request Time (Time of Advice)
:Time of advice from agent for the pilot service request time. This can be for the actions of pilot order creation, ammendments or deletion. (OHS has no difference indicator in the fields between the different types of action types (amend/create/delete))
:Time of advice from agent for the pilot service request time. This can be for the actions of pilot order creation, ammendments or deletion. (OHS has no difference indicator in the fields between the different types of action types (amend/create/delete))
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilot_service_request_time
required
string <date-time> (Pilot Service Request Time (SRT))

:Pilot Service Request Time (SRT)
:Pilotage Service Request Time.This can be for the actions of pilot order creation, ammendments or deletion. (OHS has no difference indicator in the fields between the different types of action types (amend/create/delete))
:Pilotage Service Request Time.This can be for the actions of pilot order creation, ammendments or deletion. (OHS has no difference indicator in the fields between the different types of action types (amend/create/delete))
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilot_booking_confirmed_time
string or null <date-time> (Pilot Booking Confirmed Time (CST))

:Pilot Booking Confirmed Time (CST)
:Pilotage Confirmed Service Time
:Pilotage Confirmed Service Time
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilot_arrival_time
string or null <date-time> (Pilot Arrival Start Time)

:Pilot Arrival Start Time
:Pilot Arrival Date and Time
:Pilot Arrival Date and Time
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilot_cancellation_requestor
string or null (Pilot Cancellation Requestor)

:Pilot Cancellation Requestor
:Personnel who made the request for pilot cancellation, based on the user's iMOS account.
:Personnel who made the request for pilot cancellation, based on the user's iMOS account.
:NA
:NA

pilot_onboard_time
string or null <date-time> (Pilot Onboard Time)

:Pilot Onboard Time
:Pilot Onboard Date and Time
:Pilot Onboard Date and Time
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilotage_start_time
string or null <date-time> (Pilotage Start/Vessel Cast-off Time)

:Pilotage Start/Vessel Cast-off Time
:Timing that the pilot starts the pilotage/vessel cast off
:Timing that the pilot starts the pilotage/vessel cast off
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilotage_end_time
string or null <date-time> (Pilotage End Time)

:Pilotage End Time
:Timing of actual pilotage end
:Timing of actual pilotage end
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilotage_delay_start_time
string or null <date-time> (Pilotage Delay Start Time)

:Pilotage Delay Start Time
:Timing of delay start
:Timing of delay start
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilotage_delay_duration
number or null <double> (Pilotage Delay Duration)

:Pilotage Delay Duration
:Duration of delay (in minutes)
:Duration of delay (in minutes)
:NA
:Min characters = 1, Max characters = 255, Numeric

pilotage_delay_reason
string or null (Pilotage Delay Reason)

:Pilotage Delay Reason
:Reason for delay
:Reason for delay
:NA
:NA

pilotage_etub
string or null <date-time> (Estimated Time of Unberthing)

:Estimated Time of Unberthing
:Estimated Time of Unberthing
:Estimated Time of Unberthing
:NA
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

{
  • "pilot_order_no": "string",
  • "pilot_imo_no": "string",
  • "pilot_location_to": "string",
  • "pilot_location_from": "string",
  • "pilot_service_request_time_agent_toa": "2019-08-24T14:15:22Z",
  • "pilot_service_request_time": "2019-08-24T14:15:22Z",
  • "pilot_booking_confirmed_time": "2019-08-24T14:15:22Z",
  • "pilot_arrival_time": "2019-08-24T14:15:22Z",
  • "pilot_cancellation_requestor": "string",
  • "pilot_onboard_time": "2019-08-24T14:15:22Z",
  • "pilotage_start_time": "2019-08-24T14:15:22Z",
  • "pilotage_end_time": "2019-08-24T14:15:22Z",
  • "pilotage_delay_start_time": "2019-08-24T14:15:22Z",
  • "pilotage_delay_duration": 0.1,
  • "pilotage_delay_reason": "string",
  • "pilotage_etub": "2019-08-24T14:15:22Z"
}

Terminal Berthing & Unberthing (B2G)

Data Element ID: terminal_berthing_unberthing

serviceProviderCompanyId
required
string (Service Provider Company ID (UEN))

:Service Provider Company UEN Number
:Service Provider Company ID (UEN)
:Service Provider Company UEN Number
:NA
:NA

adviceCode
string or null (Advice Code)

:Indicate if Create - 'C', Update - 'U'. When not provided system will perform creation or update based on existence of data. During update of record Vessel Name, Outward Voyage Number and Berthing Shift Sequence cannot be updated.
:Advice Code
:Indicate if Create - 'C', Update - 'U'. When not provided system will perform creation or update based on existence of data. During update of record Vessel Name, Outward Voyage Number and Berthing Shift Sequence cannot be updated.
:NA
:'C' or 'U'

vesselId
string or null (Vessel ID Number)

:Vessel ID Number - Either Vessel Id, IMO Number or Callsign must be provided.
:Vessel ID Number
:Vessel ID Number - Either Vessel Id, IMO Number or Callsign must be provided.
:NA
:NA

vesselIMONumber
string or null (Vessel IMO Number)

:Vessel IMO Number - Either Vessel Id, IMO Number or Callsign must be provided.
:Vessel IMO Number
:Vessel IMO Number - Either Vessel Id, IMO Number or Callsign must be provided.
:NA
:NA

vesselName
required
string (Vessel Name)

:Vessel Name
:Vessel Name
:Vessel Name
:NA
:NA

vesselCallSignNumber
string or null (Vessel Call Sign)

:Vessel Call Sign - Either Vessel Id, IMO Number or Callsign must be provided.
:Vessel Call Sign
:Vessel Call Sign - Either Vessel Id, IMO Number or Callsign must be provided.
:NA
:NA

vesselFullInVoyNumber
string or null (Vessel Inward Voyage Number)

:Vessel Inward Voyage Number (Import for Singapore for reference only). 1. Must be provided for both PSA and JP Terminal. 2. For Oil Terminal if there is advance planning resulting in multiple call, please provide information, this is meant to identify each vessel call accurately.
:Vessel Inward Voyage Number
:Vessel Inward Voyage Number (Import for Singapore for reference only). 1. Must be provided for both PSA and JP Terminal. 2. For Oil Terminal if there is advance planning resulting in multiple call, please provide information, this is meant to identify each vessel call accurately.
:NA
:NA

vesselFullOutVoyNumber
string or null (Vessel Outward Voyage Number)

:Vessel Outward Voyage Number (Export for Singapore used to link up all activities. Field cannot be updated). 1. Must be provided for both PSA and JP Terminal. 2. For Oil Terminal if there is advance planning resulting in multiple call, please provide information, this is meant to identify each vessel call accurately.
:Vessel Outward Voyage Number
:Vessel Outward Voyage Number (Export for Singapore used to link up all activities. Field cannot be updated). 1. Must be provided for both PSA and JP Terminal. 2. For Oil Terminal if there is advance planning resulting in multiple call, please provide information, this is meant to identify each vessel call accurately.
:NA
:NA

shiftSeqNumber
required
integer <int64> (Berthing Shift Sequence)

:Berthing Shift Sequence
:Berthing Shift Sequence
:Berthing Shift Sequence
:NA
:NA

terminalCode
string or null (Terminal Code)

:Terminal Code
:Terminal Code
:Terminal Code
:NA
:NA

berthNumber
string or null (Berth Number)

:Berth number (System will validate that the berth location is valid based on MDH Location API. If found to be invalid system will return error message stating that the location is invalid. For berthing straddling over multiple berths, the delimiter '/' should be used to separate the berths)
:Berth Number
:Berth number (System will validate that the berth location is valid based on MDH Location API. If found to be invalid system will return error message stating that the location is invalid. For berthing straddling over multiple berths, the delimiter '/' should be used to separate the berths)
:NA
:NA

btrDateTime
required
string <date-time> (Berth Time Required)

:Berth Time Required
:Berth Time Required
:Berth Time Required
:NA
:Date-time format (YYYY-MM-DDThh:mm:ss)

ubtrDateTime
required
string <date-time> (Unberth Time Required)

:Unberth Time Required
:Unberth Time Required
:Unberth Time Required
:NA
:Date-time format (YYYY-MM-DDThh:mm:ss)

etbDateTime
string or null <date-time> (Estimated Time of Berth)

:Estimated Time of Berth
:Estimated Time of Berth
:Estimated Time of Berth
:NA
:Date-time format (YYYY-MM-DDThh:mm:ss)

etuDateTime
string or null <date-time> (Estimated Time of Unberthing)

:Estimated Time of Unberthing
:Estimated Time of Unberthing
:Estimated Time of Unberthing
:NA
:Date-time format (YYYY-MM-DDThh:mm:ss)

atbDateTime
string or null <date-time> (Actual Time of Berth)

:Actual Time of Berth
:Actual Time of Berth
:Actual Time of Berth
:NA
:Date-time format (YYYY-MM-DDThh:mm:ss)

atuDateTime
string or null <date-time> (Actual Time of Unberthing)

:Actual Time of Unberthing
:Actual Time of Unberthing
:Actual Time of Unberthing
:NA
:Date-time format (YYYY-MM-DDThh:mm:ss)

agentId
required
string (Agent UEN)

:Agent UEN
:Agent UEN
:Agent UEN
:NA
:NA

{
  • "serviceProviderCompanyId": "string",
  • "adviceCode": "string",
  • "vesselId": "string",
  • "vesselIMONumber": "string",
  • "vesselName": "string",
  • "vesselCallSignNumber": "string",
  • "vesselFullInVoyNumber": "string",
  • "vesselFullOutVoyNumber": "string",
  • "shiftSeqNumber": 0,
  • "terminalCode": "string",
  • "berthNumber": "string",
  • "btrDateTime": "2019-08-24T14:15:22Z",
  • "ubtrDateTime": "2019-08-24T14:15:22Z",
  • "etbDateTime": "2019-08-24T14:15:22Z",
  • "etuDateTime": "2019-08-24T14:15:22Z",
  • "atbDateTime": "2019-08-24T14:15:22Z",
  • "atuDateTime": "2019-08-24T14:15:22Z",
  • "agentId": "string"
}

Terminal Operations Arrival Information

Data Element ID: terminal_operations_arrival_information

toai_arrival_id
required
string (Arrival ID)

:Arrival ID
:Unique Identifier for vessel Arrival records on the Newton system
:Unique Identifier for vessel Arrival records on the Newton system
:NA
:NA

toai_arrival_id_status
required
string (Arrival ID Status)

:Arrival ID Status
:The status of the Arrival ID records from Newton .
:The status of the Arrival ID records from Newton .
:NA
:NA

toai_pilot_on_board_for_mooring_time
required
string <date-time> (Pilot on Board for Mooring Time)

:Pilot on Board for Mooring Time
:The time recorded of the Pilot onboarding the vessel to pilot it to the jetty for mooring (as obtained from the vessel captain)
:The time recorded of the Pilot onboarding the vessel to pilot it to the jetty for mooring (as obtained from the vessel captain)
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

toai_jetty_berth_location
required
string (Jetty/Berth)

:Jetty/Berth
:The specified location code of jetty/berth that the vessel berths at, as determined by the fixed port location codes from MPA.
:The specified location code of jetty/berth that the vessel berths at, as determined by the fixed port location codes from MPA.
:NA
:Min characters = 1, Max characters = 6, Alphanumeric

toai_imo_number
required
string (IMO Number)

:IMO Number
:The registered unqiue global identification number of the ship
:The registered unqiue global identification number of the ship
:NA
:7 characters, numeric

toai_vessel_name
required
string (Vessel Name)

:Vessel Name
:The registered name of the ship
:The registered name of the ship
:NA
:NA

toai_vessel_size_dwt
required
number <double> (Vessel Size (DWT))

:Vessel Size (DWT)
:Size of the vessel in deadweight tonnage
:Size of the vessel in deadweight tonnage
:NA
:numeric

required
Array of objects (Work Order Items)

:Work Order Items
:Array of work order items
:Array of work order items
:NA
:NA

toai_first_line_rope_ashore_time
string or null <date-time> (First Line/Rope Ashore Time)

:First Line/Rope Ashore Time
:The time recorded of the vessel's first line being secured to the berth it is docked at.
:The time recorded of the vessel's first line being secured to the berth it is docked at.
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

toai_all_fast_time
string or null <date-time> (All fast Time)

:All fast Time
:The time recorded when the ship has finished all it's mooring operations and all mooring lines are secured to the dock or pier, and it is safe for crew to disembark or for cargo operations to commence.
:The time recorded when the ship has finished all it's mooring operations and all mooring lines are secured to the dock or pier, and it is safe for crew to disembark or for cargo operations to commence.
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

toai_pilot_on_board_for_unmooring_time
string or null <date-time> (Pilot on Board for Unmooring Time)

:Pilot on Board for Unmooring Time
:The time of the pilot onboard to start pilotage of the vessel away from the jetty for unmooring (as obtained from PSA Marine's Confirmed Service Time for pilotage service)
:The time of the pilot onboard to start pilotage of the vessel away from the jetty for unmooring (as obtained from PSA Marine's Confirmed Service Time for pilotage service)
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

toai_documentation_on_board_time
string or null <date-time> (Documentation On Board Time)

:Documentation On Board Time
:The time the documentations required for the completion of the whole transaction concludes, recorded on Newton.
:The time the documentations required for the completion of the whole transaction concludes, recorded on Newton.
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

toai_agent
string or null (Agent)

:Agent
:The agent who will be conducts the pilotage service to bring the vessel to the berth.
:The agent who will be conducts the pilotage service to bring the vessel to the berth.
:NA
:NA

toai_atb
string or null <date-time> (Actual Time of Berthing)

:Actual Time of Berthing
:Actual Time of Berthing
:Actual Time of Berthing
:NA
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

{
  • "toai_arrival_id": "string",
  • "toai_arrival_id_status": "string",
  • "toai_pilot_on_board_for_mooring_time": "2019-08-24T14:15:22Z",
  • "toai_jetty_berth_location": "string",
  • "toai_imo_number": "string",
  • "toai_vessel_name": "string",
  • "toai_vessel_size_dwt": 0.1,
  • "toai_work_order_items": [
    ],
  • "toai_first_line_rope_ashore_time": "2019-08-24T14:15:22Z",
  • "toai_all_fast_time": "2019-08-24T14:15:22Z",
  • "toai_pilot_on_board_for_unmooring_time": "2019-08-24T14:15:22Z",
  • "toai_documentation_on_board_time": "2019-08-24T14:15:22Z",
  • "toai_agent": "string",
  • "toai_atb": "2019-08-24T14:15:22Z"
}

Terminal Operations Sequence Information

Data Element ID: terminal_operations_tank_information

tosi_work_order_id
required
string (Work Order ID)

:Work Order ID
:Unique Identifier for work order records on the Newton system
:Unique Identifier for work order records on the Newton system
:NA
:NA

tosi_tank_number
required
string (Tank Number)

:Tank Number
:The Terminal's unique tank identifier
:The Terminal's unique tank identifier
:NA
:NA

tosi_work_order_sequence_number
required
string (Work Order Sequence Number)

:Work Order Sequence Number
:The specified sequence of execution of the items in the work order
:The specified sequence of execution of the items in the work order
:NA
:NA

tosi_product_name
required
string (Product Name)

:Product Name
:The name of the product in the work order
:The name of the product in the work order
:NA
:NA

tosi_product_quantity_in_l-obs
required
number <double> (Product Quantity in L-obs)

:Product Quantity in L-obs
:The quantity of the work items in the line item of the work order (in L-obs)
:The quantity of the work items in the line item of the work order (in L-obs)
:NA
:numeric

tosi_product_quantity_in_l-15-c
required
number <double> (Product Quantity in L-15-C)

:Product Quantity in L-15-C
:The quantity of the work items in the line item of the work order in L-15-C)
:The quantity of the work items in the line item of the work order in L-15-C)
:NA
:numeric

tosi_product_quantity_in_mt
required
number <double> (Product Quantity in Mt)

:Product Quantity in Mt
:The quantity of the work items in the line item of the work order (in Mt)
:The quantity of the work items in the line item of the work order (in Mt)
:NA
:numeric

tosi_product_quantity_in_mtv
required
number <double> (Product Quantity in MtV)

:Product Quantity in MtV
:The quantity of the work items in the line item of the work order (in MtV)
:The quantity of the work items in the line item of the work order (in MtV)
:NA
:numeric

tosi_product_quantity_in_Bls-60-f
required
number <double> (Product Quantity in Bls-60-F)

:Product Quantity in Bls-60-F
:The quantity of the work items in the line item of the work order (in Bls-60-F)
:The quantity of the work items in the line item of the work order (in Bls-60-F)
:NA
:numeric

tosi_cargo_start_first_foot_start_time
string <date-time> (Cargo Start/ First Foot Loading Start Time)

:Cargo Start/ First Foot Loading Start Time
:The time of start of cargo operations /The time recorded for the start of first foot sampling operations, that occurs before the start of main cargo operations, when sampling is required.
:The time of start of cargo operations /The time recorded for the start of first foot sampling operations, that occurs before the start of main cargo operations, when sampling is required.
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

tosi_first_foot_end_time
string or null <date-time> (First Foot Loading End Time)

:First Foot Loading End Time
:The ending time of the first foot sampling event before the official start of cargo operations
:The ending time of the first foot sampling event before the official start of cargo operations
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

tosi_first_foot_clear_time
string or null <date-time> (First Foot Sampling Passed/Clearance Time)

:First Foot Sampling Passed/Clearance Time
:The time of clearance of the sampling event
:The time of clearance of the sampling event
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

tosi_first_foot_resume_time
string or null <date-time> (Cargo Resume (after First Foot) Time)

:Cargo Resume (after First Foot) Time
:The time cargo operations resume after first foot event
:The time cargo operations resume after first foot event
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

tosi_cargo_end_time
string or null <date-time> (Cargo End Time)

:Cargo End Time
:The time the cargo operations concludes
:The time the cargo operations concludes
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

Array of objects or null (Cease Cargo Operation (uncalled for) items)

:Cease Cargo Operation (uncalled for) items
:List of Cease Cargo Operation (uncalled for) items
:List of Cease Cargo Operation (uncalled for) items
:International
:NA

{
  • "tosi_work_order_id": "string",
  • "tosi_tank_number": "string",
  • "tosi_work_order_sequence_number": "string",
  • "tosi_product_name": "string",
  • "tosi_product_quantity_in_l-obs": 0.1,
  • "tosi_product_quantity_in_l-15-c": 0.1,
  • "tosi_product_quantity_in_mt": 0.1,
  • "tosi_product_quantity_in_mtv": 0.1,
  • "tosi_product_quantity_in_Bls-60-f": 0.1,
  • "tosi_cargo_start_first_foot_start_time": "2019-08-24T14:15:22Z",
  • "tosi_first_foot_end_time": "2019-08-24T14:15:22Z",
  • "tosi_first_foot_clear_time": "2019-08-24T14:15:22Z",
  • "tosi_first_foot_resume_time": "2019-08-24T14:15:22Z",
  • "tosi_cargo_end_time": "2019-08-24T14:15:22Z",
  • "tosi_cargo_cease_items": [
    ]
}

Terminal Operations Work Order Information

Data Element ID: terminal_operations_work_order_information

towoi_work_order_id
required
string (Work Order ID)

:Work Order ID
:Unique Identifier for work order records on the Newton system
:Unique Identifier for work order records on the Newton system
:NA
:NA

towoi_work_order_status
required
string (Work Order ID Status)

:Work Order ID Status
:The status of the work order ID from Newton
:The status of the work order ID from Newton
:NA
:NA

toiwo_work_order_customer_name
required
string (Customer Name)

:Customer Name
:Name of the terminal's customer
:Name of the terminal's customer
:NA
:NA

towoi_nor_tendered_time
required
string <date-time> (Vessel tendering NOR Time)

:Vessel tendering NOR Time
:The time of the submitted Notice of Readiness for the vessel and the respective cargo that the vessel is carrying (from Shipmaster to Trader/Agent)
:The time of the submitted Notice of Readiness for the vessel and the respective cargo that the vessel is carrying (from Shipmaster to Trader/Agent)
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

towoi_work_order_operation_type
required
string (Operation Type)

:Operation Type
:The type of operation that will be executed by the Terminal in the work order
:The type of operation that will be executed by the Terminal in the work order
:NA
:NA

towoi_nor_accepted_time
string or null <date-time> (NOR Acceptance Time from Terminal)

:NOR Acceptance Time from Terminal
:The response of the confirmed Notice of Readiness as a confirmation of Terminal operations
:The response of the confirmed Notice of Readiness as a confirmation of Terminal operations
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

towoi_hose_connect_end_time
string or null <date-time> (Hose Connect End Time)

:Hose Connect End Time
:The time where all hoses required to connect and transfer cargo between the shore and the vessel is completed.
:The time where all hoses required to connect and transfer cargo between the shore and the vessel is completed.
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

towoi_hose_disconnect_end_time
string or null <date-time> (Hose Disconnection End Time)

:Hose Disconnection End Time
:The time the connection to the vessel stops, as recorded on Newton
:The time the connection to the vessel stops, as recorded on Newton
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

towoi_work_order_surveyor
string or null (Surveyor)

:Surveyor
:The surveyor who conducts the sampling of the product in relation to the work order within the arrival same arrival instance of the vessel
:The surveyor who conducts the sampling of the product in relation to the work order within the arrival same arrival instance of the vessel
:NA
:NA

{
  • "towoi_work_order_id": "string",
  • "towoi_work_order_status": "string",
  • "toiwo_work_order_customer_name": "string",
  • "towoi_nor_tendered_time": "2019-08-24T14:15:22Z",
  • "towoi_work_order_operation_type": "string",
  • "towoi_nor_accepted_time": "2019-08-24T14:15:22Z",
  • "towoi_hose_connect_end_time": "2019-08-24T14:15:22Z",
  • "towoi_hose_disconnect_end_time": "2019-08-24T14:15:22Z",
  • "towoi_work_order_surveyor": "string"
}

Terminal Pilot Booking Information

Data Element ID: demurrage_terminal_pilot_booking_information

lqb_order_creation_time
required
string <date-time> (LqB Order creation time)

:LqB Order creation time
:Timing of creation of LqB Order on PSA OHS LqB module
:Timing of creation of LqB Order on PSA OHS LqB module
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

lqb_pilot_on_board_time
required
string <date-time> (LqB Pilot On Board (POB) Time)

:LqB Pilot On Board (POB) Time
:Requested pilot service time (from terminal via the PSA OHS LqB module)
:Requested pilot service time (from terminal via the PSA OHS LqB module)
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

pilot_lqb_imo_no
required
string (IMO Number)

:IMO Number
:International Maritime Organisation(IMO) unique ship identification number, for identification of the vessel.
:International Maritime Organisation(IMO) unique ship identification number, for identification of the vessel.
:NA
:7 characters, Numeric

pilot_lqb_location_to
required
string (Location_To)

:Location_To
:Location To Code for the location where vessel will be travelling to. Location codes are predetermined and maintained by MPA.
:Location To Code for the location where vessel will be travelling to. Location codes are predetermined and maintained by MPA.
:NA
:Min characters = 1, Max characters = 6, Alphanumeric

pilot_lqb_location_from
required
string (Location_From)

:Location_From
:Location From Code for the location where vessel will be travelling from. Location codes are predetermined and maintained by MPA.
:Location From Code for the location where vessel will be travelling from. Location codes are predetermined and maintained by MPA.
:NA
:Min characters = 1, Max characters = 6, Alphanumeric

lqb_agent_acknowledgment_time
string or null <date-time> (LqB Agent Acknowledgment Time)

:LqB Agent Acknowledgment Time
:Time the agent acknowledges any change or request from terminal via the PSA OHS LqB module
:Time the agent acknowledges any change or request from terminal via the PSA OHS LqB module
:International
:ISO 8601 date-time format (YYYY-MM-DDThh:mm:ssZ)

{
  • "lqb_order_creation_time": "2019-08-24T14:15:22Z",
  • "lqb_pilot_on_board_time": "2019-08-24T14:15:22Z",
  • "pilot_lqb_imo_no": "string",
  • "pilot_lqb_location_to": "string",
  • "pilot_lqb_location_from": "string",
  • "lqb_agent_acknowledgment_time": "2019-08-24T14:15:22Z"
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

:Note
:Note
:Note
:NA
:NA

Array of objects or null (Other Documents Attachment)

:Other Documents Attachment
:Other Documents Attachment
:Other Documents Attachment
:NA
:NA

{
  • "note": "string",
  • "attachments": [
    ]
}

Use Case F (Parameters)

Parameter schemas for Use Case F

Liquid Bulk Agent Nomination Timestamp

Data Element ID: liquid_bulk_agent_nomination_timestamp

liquid_bulk_vessel_clearance_timestamp_vessel_name
required
string (Vessel Name)

:Vessel Name
:Name of Vessel on or for which activity was conducted
:Name of Vessel on or for which activity was conducted
:NA
:NA

{
  • "liquid_bulk_vessel_clearance_timestamp_vessel_name": "string"
}

Liquid Bulk Anchorage Timestamp

Data Element ID: liquid_bulk_anchorage_timestamp

liquid_bulk_anchorage_timestamp_vessel_name
string (Vessel Name)

:Vessel Name
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

{
  • "liquid_bulk_anchorage_timestamp_vessel_name": "string"
}

Liquid Bulk Berthing Timestamp

Data Element ID: liquid_bulk_berthing_timestamp

liquid_bulk_berthing_timestamp_vessel_name
required
string (Vessel Name)

:Name of Vessel on or for which activity was conducted
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_berthing_timestamp_jetty
required
string (Jetty)

:Jetty at which activity was conducted
:Jetty
:Jetty at which activity was conducted
:NA
:NA

{
  • "liquid_bulk_berthing_timestamp_vessel_name": "string",
  • "liquid_bulk_berthing_timestamp_jetty": "string"
}

Liquid Bulk Cargo Post Ops Timestamp

Data Element ID: liquid_bulk_cargo_post_ops_timestamp

liquid_bulk_cargo_post_ops_timestamp_vessel_name
required
string (Vessel Name)

:Name of Vessel on or for which activity was conducted
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_cargo_post_ops_timestamp_jetty
required
string (Jetty)

:Jetty at which activity was conducted
:Jetty
:Jetty at which activity was conducted
:NA
:NA

{
  • "liquid_bulk_cargo_post_ops_timestamp_vessel_name": "string",
  • "liquid_bulk_cargo_post_ops_timestamp_jetty": "string"
}

Liquid Bulk Cargo Pre Ops Timestamp

Data Element ID: liquid_bulk_cargo_pre_ops_timestamp

liquid_bulk_cargo_pre_ops_timestamp_vessel_name
required
string (Vessel Name)

:Name of Vessel on or for which activity was conducted
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_cargo_pre_ops_timestamp_jetty
required
string (Jetty)

:Jetty at which activity was conducted
:Jetty
:Jetty at which activity was conducted
:NA
:NA

{
  • "liquid_bulk_cargo_pre_ops_timestamp_vessel_name": "string",
  • "liquid_bulk_cargo_pre_ops_timestamp_jetty": "string"
}

Liquid Bulk Cargo Transfer Timestamp

Data Element ID: liquid_bulk_cargo_transfer_timestamp

liquid_bulk_cargo_transfer_timestamp_vessel_name
required
string (Vessel Name)

:Name of Vessel on or for which activity was conducted
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_cargo_transfer_timestamp_jetty
required
string (Jetty)

:Jetty at which activity was conducted
:Jetty
:Jetty at which activity was conducted
:NA
:NA

{
  • "liquid_bulk_cargo_transfer_timestamp_vessel_name": "string",
  • "liquid_bulk_cargo_transfer_timestamp_jetty": "string"
}

Liquid Bulk Cargo Unberthing Timestamp

Data Element ID: liquid_bulk_cargo_unberthing_timestamp

liquid_bulk_unberthing_timestamp_vessel_name
required
string (Vessel Name)

:Name of Vessel on or for which activity was conducted
:Vessel Name
:Name of Vessel on or for which activity was conducted
:NA
:NA

liquid_bulk_unberthing_timestamp_jetty
required
string (Jetty)

:Jetty at which activity was conducted
:Jetty
:Jetty at which activity was conducted
:NA
:NA

{
  • "liquid_bulk_unberthing_timestamp_vessel_name": "string",
  • "liquid_bulk_unberthing_timestamp_jetty": "string"
}

Liquid Bulk Pre-Berthing Timestamp

Data Element ID: liquid_bulk_pre_berthing_timestamp

liquid_bulk_pre_berthing_timestamp_vessel_name
required
string (Vessel Name)

:Vessel Name
:Name of Vessel on or for which activity was conducted
:Name of Vessel on or for which activity was conducted
:NA
:NA

{
  • "liquid_bulk_pre_berthing_timestamp_vessel_name": "string"
}

Liquid Bulk Terminal Nomination Timestamp

Data Element ID: liquid_bulk_terminal_nomination_timestamp

liquid_bulk_vessel_clearance_timestamp_vessel_name
required
string (Vessel Name)

:Vessel Name
:Name of Vessel on or for which activity was conducted
:Name of Vessel on or for which activity was conducted
:NA
:NA

{
  • "liquid_bulk_vessel_clearance_timestamp_vessel_name": "string"
}

Liquid Bulk Vessel Clearance Timestamp

Data Element ID: liquid_bulk_vessel_clearance_timestamp

liquid_bulk_vessel_clearance_timestamp_vessel_name
required
string (Vessel Name)

:Vessel Name
:Name of Vessel on or for which activity was conducted
:Name of Vessel on or for which activity was conducted
:NA
:NA

{
  • "liquid_bulk_vessel_clearance_timestamp_vessel_name": "string"
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

Note

{
  • "note": "string"
}

Use Case G (Payload)

Payload schemas for Use Case G

Bill of Lading Verification

Data Element ID: bill_of_lading_verification

blv_carrier_name
required
string (Carrier Name)

:Issuing shipping line, Max characters= 70
:Carrier Name
:Issuing shipping line, Max characters= 70
:N/A
:Max characters= 70

blv_bl_number
required
string (BL Number)

:Unique identifier of the transport document allocated by the shipping line, Max characters= 35
:BL Number
:Unique identifier of the transport document allocated by the shipping line, Max characters= 35
:N/A
:Max characters= 35

blv_issuance_date
string or null <date> (Issuance Date)

:Date when the Original bill of lading was issued. Local date at place of issue, date (YYYY-MM-DD)
:Issuance Date
:Date when the Original bill of lading was issued. Local date at place of issue, date (YYYY-MM-DD)
:ISO-8601
:date (YYYY-MM-DD)

blv_vessel_name
string or null (Vessel Name)

:The name of the first sea going Vessel on board which the cargo is loaded or intended to be loaded, Max characters= 70
:Vessel Name
:The name of the first sea going Vessel on board which the cargo is loaded or intended to be loaded, Max characters= 70
:N/A
:Max characters= 70

blv_vessel_imo_number
string or null (Vessel IMO Number)

:International Maritime Organisation (IMO) Vessel Identification Number, Characters= 10
:Vessel IMO Number
:International Maritime Organisation (IMO) Vessel Identification Number, Characters= 10
:N/A
:Characters= 10

blv_port_of_loading
string or null (Port of Loading)

:The location where the cargo is loaded onto a first sea-going vessel for water transportation, Max characters= 70
:Port of Loading
:The location where the cargo is loaded onto a first sea-going vessel for water transportation, Max characters= 70
:N/A
:Max characters= 70

blv_port_of_discharge
string or null (Port of Discharge)

:The location where the cargo is discharged from the last sea-going vessel, Max characters = 70
:Port of Discharge
:The location where the cargo is discharged from the last sea-going vessel, Max characters = 70
:N/A
:Max characters= 70

blv_quantity_value
string or null (Quantity - Value)

:Specifies the quantity of a product in a trade transaction. Number of objects represented as a decimal number. Max characters= 18
:Quantity - Value
:Specifies the quantity of a product in a trade transaction. Number of objects represented as a decimal number. Max characters= 18
:N/A
:Max characters= 18

blv_quantity_unit_of_measure_code
string or null (Quantity - Unit of Measure Code)

:Identifies the unit of measure by means of a code from list of UN/ECE Recommendation 20.
:Quantity - Unit of Measure Code
:Identifies the unit of measure by means of a code from list of UN/ECE Recommendation 20.
:UN/CEFACT
:Max characters= 4

blv_quantity_other_unit_of_measure
string or null (Quantity - Other Unit of Measure)

:Identifies the unit of measure by means of a free-form unit of measure input. Max characters= 35
:Quantity - Other Unit of Measure
:Identifies the unit of measure by means of a free-form unit of measure input. Max characters= 35
:N/A
:Max characters= 35

blv_goods_description
string or null (Goods Description)

:Text describing the goods which may contain marks and numbers, if any. Max characters= 70
:Goods Description
:Text describing the goods which may contain marks and numbers, if any. Max characters= 70
:N/A
:Max characters= 70

blv_shipper_name
string or null (Shipper Name)

:Any person or legal entity by whom or in whose name, or on whose behalf, a contract of carriage of goods by sea has been concluded with a carrier, or any person by whom or in whose name, or on whose behalf, the goods are actually delivered to the carrier in relation to the contract of carriage by sea. Max characters= 70
:Shipper Name
:Any person or legal entity by whom or in whose name, or on whose behalf, a contract of carriage of goods by sea has been concluded with a carrier, or any person by whom or in whose name, or on whose behalf, the goods are actually delivered to the carrier in relation to the contract of carriage by sea. Max characters= 70
:N/A
:Max characters= 70

blv_consignee_name
string or null (Consignee Name)

:The party to whom a cargo is consigned under a contract of carriage or a transport document or electronic transport record. It can be the end receiver. Max characters= 70
:Consignee Name
:The party to whom a cargo is consigned under a contract of carriage or a transport document or electronic transport record. It can be the end receiver. Max characters= 70
:N/A
:Max characters= 70

blv_shipper_country
string or null (Shipper Country)

:Country of the Physical Address of the Shipper. See Field 'Shipper Name' for definition of Shipper. Max characters=2
:Shipper Country
:Country of the Physical Address of the Shipper. See Field 'Shipper Name' for definition of Shipper. Max characters=2
:ISO 3166 Alpha-2 code
:Max characters=2

blv_consignee_country
string or null (Consignee Country)

:Country of the Physical Address of the Consignee. See Field 'Consignee Name' for definition of Shipper. Max characters=2
:Consignee Country
:Country of the Physical Address of the Consignee. See Field 'Consignee Name' for definition of Shipper. Max characters=2
:ISO 3166 Alpha-2 code
:Max characters=2

blv_error_code
string or null (Error Code)

:Reason for invalid or incomplete results
:Error Code
:Reason for invalid or incomplete results
:N/A
:N/A

{
  • "blv_carrier_name": "string",
  • "blv_bl_number": "string",
  • "blv_issuance_date": "2019-08-24",
  • "blv_vessel_name": "string",
  • "blv_vessel_imo_number": "string",
  • "blv_port_of_loading": "string",
  • "blv_port_of_discharge": "string",
  • "blv_quantity_value": "string",
  • "blv_quantity_unit_of_measure_code": "string",
  • "blv_quantity_other_unit_of_measure": "string",
  • "blv_goods_description": "string",
  • "blv_shipper_name": "string",
  • "blv_consignee_name": "string",
  • "blv_shipper_country": "string",
  • "blv_consignee_country": "string",
  • "blv_error_code": "string"
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

:Note
:Note
:Note
:NA
:NA

Array of objects or null (Other Documents Attachment)

:Other Documents Attachment
:Other Documents Attachment
:Other Documents Attachment
:NA
:NA

{
  • "note": "string",
  • "attachments": [
    ]
}

Use Case G (Parameters)

Parameter schemas for Use Case G

Bill of Lading Verification

Data Element ID: bill_of_lading_verification

blv_carrier_name
required
string (Carrier Name)

Issuing shipping line, Max characters= 70

blv_bl_number
required
string (BL Number)

Unique identifier of the transport document allocated by the shipping line, Max characters= 35

{
  • "blv_carrier_name": "string",
  • "blv_bl_number": "string"
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

Note

{
  • "note": "string"
}

Use Case H (Payload)

Payload schemas for Use Case H

Certificate of Origin

Data Element ID: certificate_of_origin

bol_no
string or null (Bill of Lading / Transport Contract Document Number)

:Reference number to identify a document evidencing a transport contract
:Bill of Lading / Transport Contract Document Number
:Reference number to identify a document evidencing a transport contract
:ISO7372
:NA

inv_no
string or null (Invoice Number)

:Reference number to identify an invoice
:Invoice Number
:Reference number to identify an invoice
:ISO7372
:NA

contract_no
string or null (Contract Number)

:Identifier of a contract concluded between parties such as between buyer and seller
:Contract Number
:Identifier of a contract concluded between parties such as between buyer and seller
:ISO7372
:NA

coo_doc_identifier
string or null (Document Identifier)

:Reference number identifying a specific document
:Document Identifier
:Reference number identifying a specific document
:ISO7372
:NA

coo_doc_credit_identifier
string or null (Documentary Credit Identifier)

:Reference number to identify a documentary credit
:Documentary Credit Identifier
:Reference number to identify a documentary credit
:ISO7372
:NA

coo_po_no
string or null (Purchase Order Number)

:Identifier assigned by the buyer to an order
:Purchase Order Number
:Identifier assigned by the buyer to an order
:ISO7372
:NA

coo_no
required
string (Certificate of Origin Number)

:Reference number to identify a certificate of origin
:Certificate of Origin Number
:Reference number to identify a certificate of origin
:ISO7372
:NA

coo_issue_dt
required
string <date> (Issue Date)

:Date that a document was issued and when appropriate, signed or otherwise authenticated
:Issue Date
:Date that a document was issued and when appropriate, signed or otherwise authenticated
:ISO7372
:NA

coo_consignee
string or null (Consignee)

:Party to which goods are consigned
:Consignee
:Party to which goods are consigned
:ISO7372
:NA

coo_consignor
string or null (Consignor)

:Party consigning goods as stipulated in the transport contract by the party ordering transport
:Consignor
:Party consigning goods as stipulated in the transport contract by the party ordering transport
:ISO7372
:NA

coo_importer
string or null (Importer)

:Party who makes—or on whose behalf a Customs clearing agent or other authorised person makes— an import declaration. This may include a person who has possession of the goods or to whom the goods are consigned
:Importer
:Party who makes—or on whose behalf a Customs clearing agent or other authorised person makes— an import declaration. This may include a person who has possession of the goods or to whom the goods are consigned
:ISO7372
:NA

coo_exporter
required
string (Exporter)

:Party who makes, or on whose behalf the export declaration is made, and who is the owner of the goods or has similar rights of disposal over them at the time when the declaration is accepted
:Exporter
:Party who makes, or on whose behalf the export declaration is made, and who is the owner of the goods or has similar rights of disposal over them at the time when the declaration is accepted
:ISO7372
:NA

coo_origin_country
required
string (Origin Country)

:Name of the country in which the goods have been produced or manufactured, according to criteria laid down for the application of the Customs tariff or quantitative restrictions, or any measure related to trade.
:Origin Country
:Name of the country in which the goods have been produced or manufactured, according to criteria laid down for the application of the Customs tariff or quantitative restrictions, or any measure related to trade.
:ISO7372
:NA

coo_pod
string or null (Place of Departure)

:Port, airport or other type of location from which a means of transport is scheduled to depart or has departed
:Place of Departure
:Port, airport or other type of location from which a means of transport is scheduled to depart or has departed
:ISO7372
:NA

coo_grossweight
required
string (Gross Weight)

:Total gross weight (mass) of all goods items referred to as one consignment including packaging but excluding any transport equipment
:Gross Weight
:Total gross weight (mass) of all goods items referred to as one consignment including packaging but excluding any transport equipment
:ISO7372
:NA

coo_netweight
string or null (Net Weight)

:Total net weight (mass) of all the goods items referred to as one consignment
:Net Weight
:Total net weight (mass) of all the goods items referred to as one consignment
:ISO7372
:NA

coo_transport_grossweight
string or null (Transport Means, gross weight)

:The measure of the overall size of a vessel determined in accordance with the provisions of the International Convention on Tonnage Measurement of Ships, 1969.
:Transport Means, gross weight
:The measure of the overall size of a vessel determined in accordance with the provisions of the International Convention on Tonnage Measurement of Ships, 1969.
:ISO7372
:NA

required
Array of objects (Goods Details)

:Details of the goods
:Goods Details
:Details of the goods
:ISO7372
:NA

coo_transport_identifier
string or null (Transport Means Identifier)

:Name of a specific means of transport such as the vessel name
:Transport Means Identifier
:Name of a specific means of transport such as the vessel name
:ISO7372
:NA

coo_vehicle_no
string or null (Vehicle Registration Number)

:Identifier of a specific means of transport such as the International Maritime Organisation number of a vessel
:Vehicle Registration Number
:Identifier of a specific means of transport such as the International Maritime Organisation number of a vessel
:ISO7372
:NA

coo_equipment_identifier
string or null (Transport Equipment Identifier)

:Identifier of a piece of transport equipment e.g. container or unit load device
:Transport Equipment Identifier
:Identifier of a piece of transport equipment e.g. container or unit load device
:ISO7372
:NA

coo_container_iso
string or null (Container Size and Type)

:Code specifying the characteristics, i.e. size and type of a piece of transport equipment
:Container Size and Type
:Code specifying the characteristics, i.e. size and type of a piece of transport equipment
:ISO7372
:NA

coo_transport_mode
string or null (Mode of Transport)

:Code specifying a mode of transport
:Mode of Transport
:Code specifying a mode of transport
:ISO7372
:NA

Array of objects or null (Certificate of Origin Attachment)

:Certificate of Origin Attachment
:Certificate of Origin Attachment
:Certificate of Origin Attachment
:NA
:NA

{
  • "bol_no": "string",
  • "inv_no": "string",
  • "contract_no": "string",
  • "coo_doc_identifier": "string",
  • "coo_doc_credit_identifier": "string",
  • "coo_po_no": "string",
  • "coo_no": "string",
  • "coo_issue_dt": "2019-08-24",
  • "coo_consignee": "string",
  • "coo_consignor": "string",
  • "coo_importer": "string",
  • "coo_exporter": "string",
  • "coo_origin_country": "string",
  • "coo_pod": "string",
  • "coo_grossweight": "string",
  • "coo_netweight": "string",
  • "coo_transport_grossweight": "string",
  • "coo_goods": [
    ],
  • "coo_transport_identifier": "string",
  • "coo_vehicle_no": "string",
  • "coo_equipment_identifier": "string",
  • "coo_container_iso": "string",
  • "coo_transport_mode": "string",
  • "attachments": [
    ]
}

DCSA Electronic Bill of Lading

Data Element ID: ebl_dcsa

required
Array of objects (Document)

:The document that governs the terms of carriage between shipper and carrier for maritime transportation.
:Document
:The document that governs the terms of carriage between shipper and carrier for maritime transportation.
:International
:NA

required
Array of objects (Issue To)

:Details of receipient
:Issue To
:Details of receipient
:International
:NA

dcsa_ebl_jurisdiction
required
string (Jurisdiction )

:To be defined
:Jurisdiction
:To be defined
:International
:to be defined

dcsa_ebl_seat
required
string (Seat)

:To be defined
:Seat
:To be defined
:International
:to be defined

required
Array of objects (Electronic Bill of Lading Attachment)

:Electronic Bill of Lading Attachment
:Electronic Bill of Lading Attachment
:Electronic Bill of Lading Attachment
:NA
:NA

{
  • "dcsa_ebl_document": [
    ],
  • "dcsa_ebl_issue_to": [
    ],
  • "dcsa_ebl_jurisdiction": "string",
  • "dcsa_ebl_seat": "string",
  • "attachments": [
    ]
}

Delivery Order

Data Element ID: delivery_order

do_buyer_company_address
required
string (Buyer Company Address )

:Registered Company address of document Recipient
:Buyer Company Address
:Registered Company address of document Recipient
:NA
:NA

do_buyer_company_name
required
string (Buyer Company Name )

:Registered Company name of document Recipient
:Buyer Company Name
:Registered Company name of document Recipient
:NA
:NA

do_date
required
string <date> (Date )

:Date of issuance of delivery order
:Date
:Date of issuance of delivery order
:NA
:NA

do_delivery_address
required
string (Delivery Address )

:Delivery address of receiver
:Delivery Address
:Delivery address of receiver
:NA
:NA

required
Array of objects (Item Details)

:Item Details
:Item Details
:Item Details
:NA
:NA

do_number
required
string (Delivery Order Number)

:Unique identifier for delivery order
:Delivery Order Number
:Unique identifier for delivery order
:NA
:NA

do_seller_company_address
required
string (Seller’s Company Address )

:Registered Company address of document Issuer
:Seller’s Company Address
:Registered Company address of document Issuer
:NA
:NA

do_seller_company_name
required
string (Seller’s Company Name )

:Registered Company name of document Issuer
:Seller’s Company Name
:Registered Company name of document Issuer
:NA
:NA

do_seller_registration_number
required
string (Seller Registration)

:Registration number of Company
:Seller Registration
:Registration number of Company
:NA
:NA

do_delivery_from
string or null (Deliver From )

:Delivery address of sender
:Deliver From
:Delivery address of sender
:NA
:NA

do_invoice_number
string or null (Invoice Number )

:Unique identifier for invoice referred in delivery order
:Invoice Number
:Unique identifier for invoice referred in delivery order
:NA
:NA

do_lc_number
string or null (Letter Of Credit Number )

:Unique identifier for letter of credit applicable to delivery order
:Letter Of Credit Number
:Unique identifier for letter of credit applicable to delivery order
:NA
:NA

Array of objects or null (Delivery Order Attachment)

:Delivery Order Attachment
:Delivery Order Attachment
:Delivery Order Attachment
:NA
:NA

{
  • "do_buyer_company_address": "string",
  • "do_buyer_company_name": "string",
  • "do_date": "2019-08-24",
  • "do_delivery_address": "string",
  • "do_item_details": [
    ],
  • "do_number": "string",
  • "do_seller_company_address": "string",
  • "do_seller_company_name": "string",
  • "do_seller_registration_number": "string",
  • "do_delivery_from": "string",
  • "do_invoice_number": "string",
  • "do_lc_number": "string",
  • "attachments": [
    ]
}

Electronic Bill of Lading

Data Element ID: ebl

ebl_reference
required
string (Electronic Bill of Lading Reference)

:Document Reference Number
:Electronic Bill of Lading Reference
:Document Reference Number
:NA
:NA

required
Array of objects (Attachments)
{
  • "ebl_reference": "string",
  • "attachments": [
    ]
}

Inspection Certificate

Data Element ID: inspection_certificate

ic_reference_number
required
string (Inspection Certificate Reference Number)

:Unique reference number for Inspection Certificate
:Inspection Certificate Reference Number
:Unique reference number for Inspection Certificate
:NA
:NA

Array of objects or null (Inspection Certificate Attachment)

:Inspection Certificate Attachment
:Inspection Certificate Attachment
:Inspection Certificate Attachment
:NA
:NA

{
  • "ic_reference_number": "string",
  • "attachments": [
    ]
}

Invoice Finance Application

Data Element ID: invoice_finance_application

ifa_bank_name
string (Bank )

:Name of Bank providing Trade Financing
:Bank
:Name of Bank providing Trade Financing
:NA
:NA

ifa_date
string <date> (Date )

:Date of application
:Date
:Date of application
:NA
:NA

ifa_applicant_name
string (Applicant )

:Name of applicant
:Applicant
:Name of applicant
:NA
:NA

ifa_applicant_contact_person
string (Contact Person )

:Name of contact person for applicant
:Contact Person
:Name of contact person for applicant
:NA
:NA

ifa_applicant_telephone_no
string (Telephone )

:Contact number of contact person
:Telephone
:Contact number of contact person
:NA
:NA

ifa_product
string (Trade Financing Product Name )

:Trade financing product name e.g. Invoice Financing (Purchase) or Invoice Financing (Sales)
:Trade Financing Product Name
:Trade financing product name e.g. Invoice Financing (Purchase) or Invoice Financing (Sales)
:NA
:NA

ifa_application_id
string (Trade Financing Application Id)

:Unique application reference number
:Trade Financing Application Id
:Unique application reference number
:NA
:NA

ifa_invoice_currency
string (Invoice Currency )

Currency unit in Invoice

ifa_tenor
string (Tenor )

:Tenor for trade financing
:Tenor
:Tenor for trade financing
:NA
:NA

ifa_finance_date_start
string <date> (Finance Start Date)

:Financing start date
:Finance Start Date
:Financing start date
:NA
:NA

ifa_finance_date_due
string <date> (Finance Due Date )

:Financing due date
:Finance Due Date
:Financing due date
:NA
:NA

ifa_percentage_financing
number <double> (Percentage Of Financing)

:Percentage of financing applicable (%)
:Percentage Of Financing
:Percentage of financing applicable (%)
:NA
:NA

ifa_instruction_proceed
string (Instruction On Proceeds)

:Instructions for treatment of proceeds
:Instruction On Proceeds
:Instructions for treatment of proceeds
:NA
:NA

ifa_payment_type
string (Payment Type )

:Mode of payment used for trade financing
:Payment Type
:Mode of payment used for trade financing
:NA
:NA

ifa_bearer_charges
string (Bearer Of Charges)

:Bearer of charges
:Bearer Of Charges
:Bearer of charges
:NA
:NA

ifa_counterparty_name
string (Name Of Counterparty)

:Name of Counterparty
:Name Of Counterparty
:Name of Counterparty
:NA
:NA

ifa_tt_remmitance_currency
string (Remittance Currency (Tt) )

:Currency unit used for remittance
:Remittance Currency (Tt)
:Currency unit used for remittance
:NA
:NA

ifa_tt_amount
number <double> (Amount (Tt) )

:Amount to be remitted
:Amount (Tt)
:Amount to be remitted
:NA
:NA

ifa_tt_beneficiary_account_no
string (Beneficiary Account Number (Tt) )

:Bank Account number of beneficiary
:Beneficiary Account Number (Tt)
:Bank Account number of beneficiary
:NA
:NA

ifa_tt_beneficiary_bank_name
string (Name Of Beneficiary Bank (Tt) )

:Name of beneficiary bank
:Name Of Beneficiary Bank (Tt)
:Name of beneficiary bank
:NA
:NA

ifa_tt_beneficiary_bank_address
string (Address Of Beneficiary Bank (Tt) )

:Address of beneficiary bank
:Address Of Beneficiary Bank (Tt)
:Address of beneficiary bank
:NA
:NA

ifa_tt_beneficiary_receiving_agent
string (Receiving Agent Of Beneficiary Bank (Tt) )

:Receiving Agent of Beneficiary's bank
:Receiving Agent Of Beneficiary Bank (Tt)
:Receiving Agent of Beneficiary's bank
:NA
:NA

ifa_co_beneficiary_name
string (Beneficiary Name (Co) )

:Name of beneficiary
:Beneficiary Name (Co)
:Name of beneficiary
:NA
:NA

ifa_financing_currency
string or null (Financing Currency )

:Financing Currency Unit
:Financing Currency
:Financing Currency Unit
:NA
:NA

ifa_port_loading
string or null (Port Of Loading )

:Name of port where goods were loaded
:Port Of Loading
:Name of port where goods were loaded
:NA
:NA

ifa_port_discharge
string or null (Port Of Discharge )

:Name of port where goods were discharged
:Port Of Discharge
:Name of port where goods were discharged
:NA
:NA

ifa_vessel_number
string or null (Vessel Imo Number )

:Unique Identifier for vessel (IMO)
:Vessel Imo Number
:Unique Identifier for vessel (IMO)
:NA
:NA

ifa_fx_contract_number
string or null (Fx Contract Number )

:Unique identifier for exchange rate contracts
:Fx Contract Number
:Unique identifier for exchange rate contracts
:NA
:NA

ifa_fx_rate
string or null (Fx Rate )

:FX contract rate to be applied
:Fx Rate
:FX contract rate to be applied
:NA
:NA

ifa_counterparty_address
string or null (Address Of Counterparty)

:Address of Counterparty
:Address Of Counterparty
:Address of Counterparty
:NA
:NA

ifa_co_beneficiary_account_name
string or null (Account Name (Co) )

:Bank Account name of beneficiary
:Account Name (Co)
:Bank Account name of beneficiary
:NA
:NA

ifa_co_beneficiary_account_number
string or null (Account Number (Co) )

:Bank Account number of beneficiary
:Account Number (Co)
:Bank Account number of beneficiary
:NA
:NA

ifa_co_other_instructions
string or null (Other Instructions (Co) )

:Other applicable instructions for payment
:Other Instructions (Co)
:Other applicable instructions for payment
:NA
:NA

ifa_tt_beneficiary_bank_swift_code
string or null (Swift Code- Beneficiary Bank (Tt))

:Swift Code- Beneficiary Bank (Tt)
:Swift Code- Beneficiary Bank (Tt)
:Swift Code- Beneficiary Bank (Tt)
:NA
:NA

ifa_co_beneficiary_bank_swift_code
string or null

Swift Code- Beneficiary Bank (Co)

{
  • "ifa_bank_name": "string",
  • "ifa_date": "2019-08-24",
  • "ifa_applicant_name": "string",
  • "ifa_applicant_contact_person": "string",
  • "ifa_applicant_telephone_no": "string",
  • "ifa_product": "string",
  • "ifa_application_id": "string",
  • "ifa_invoice_currency": "string",
  • "ifa_tenor": "string",
  • "ifa_finance_date_start": "2019-08-24",
  • "ifa_finance_date_due": "2019-08-24",
  • "ifa_percentage_financing": 0.1,
  • "ifa_instruction_proceed": "string",
  • "ifa_payment_type": "string",
  • "ifa_bearer_charges": "string",
  • "ifa_counterparty_name": "string",
  • "ifa_tt_remmitance_currency": "string",
  • "ifa_tt_amount": 0.1,
  • "ifa_tt_beneficiary_account_no": "string",
  • "ifa_tt_beneficiary_bank_name": "string",
  • "ifa_tt_beneficiary_bank_address": "string",
  • "ifa_tt_beneficiary_receiving_agent": "string",
  • "ifa_co_beneficiary_name": "string",
  • "ifa_financing_currency": "string",
  • "ifa_port_loading": "string",
  • "ifa_port_discharge": "string",
  • "ifa_vessel_number": "string",
  • "ifa_fx_contract_number": "string",
  • "ifa_fx_rate": "string",
  • "ifa_counterparty_address": "string",
  • "ifa_co_beneficiary_account_name": "string",
  • "ifa_co_beneficiary_account_number": "string",
  • "ifa_co_other_instructions": "string",
  • "ifa_tt_beneficiary_bank_swift_code": "string",
  • "ifa_co_beneficiary_bank_swift_code": "string"
}

Invoice Finance Response

Data Element ID: invoice_finance_response

ifr_transaction_reference_number
required
string (Transaction Reference Number )

:Transaction Reference Number
:Transaction Reference Number
:Transaction Reference Number
:NA
:NA

ifr_finance_approved_date
string or null <date> (Finance Approved Date)

:Finance Approved Date
:Finance Approved Date
:Finance Approved Date
:NA
:NA

ifr_financing_start_date
string or null <date> (Financing Start Date)

:Financing Start Date
:Financing Start Date
:Financing Start Date
:NA
:NA

ifr_financing_maturity_date
string or null <date> (Financing Maturity Date)

:Financing Maturity Date
:Financing Maturity Date
:Financing Maturity Date
:NA
:NA

ifr_disbursement_date
string or null <date> (Disbursement Date)

:Disbursement Date
:Disbursement Date
:Disbursement Date
:NA
:NA

ifr_finance_status
required
string <date> (Finance Status)

:Finance Status
:Finance Status
:Finance Status
:NA
:NA

Array of objects or null (Invoice Finance Response Attachment)

:Invoice Finance Response Attachment
:Invoice Finance Response Attachment
:Invoice Finance Response Attachment
:NA
:NA

{
  • "ifr_transaction_reference_number": "string",
  • "ifr_finance_approved_date": "2019-08-24",
  • "ifr_financing_start_date": "2019-08-24",
  • "ifr_financing_maturity_date": "2019-08-24",
  • "ifr_disbursement_date": "2019-08-24",
  • "ifr_finance_status": "2019-08-24",
  • "attachments": [
    ]
}

Letter Of Credit

Data Element ID: letter_of_credit

lc_doc_lc_form
string or null (Form of Documentary Credit)

:SWIFT MT 700 Field 40A : Form of Documentary Credit
This field specifies the type of credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Form of Documentary Credit
:SWIFT MT 700 Field 40A : Form of Documentary Credit
This field specifies the type of credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_dt_of_issue
required
string <date> (Date Of Issue)

:SWIFT MT 700 Field 31C : Date Of Issue
This field specifies the date on which the issuing bank (Sender) considers the documentary credit as being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Date Of Issue
:SWIFT MT 700 Field 31C : Date Of Issue
This field specifies the date on which the issuing bank (Sender) considers the documentary credit as being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:date (YYYY-MM-DD)

lc_doc_lc_no
string or null (Documentary Credit Number)

:SWIFT MT 700 Field 20 : Documentary Credit Number
This field specifies the documentary credit number which has been assigned by the Sender.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Documentary Credit Number
:SWIFT MT 700 Field 20 : Documentary Credit Number
This field specifies the documentary credit number which has been assigned by the Sender.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_dt_and_place_of_expiry
string or null (Date and Place of Expiry)

:SWIFT MT 700 Field 31D : Date and Place of Expiry
This field specifies the latest date for presentation under the documentary credit and the place where documents may be presented.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Date and Place of Expiry
:SWIFT MT 700 Field 31D : Date and Place of Expiry
This field specifies the latest date for presentation under the documentary credit and the place where documents may be presented.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_applicant
string or null (Applicant)

:SWIFT MT 700 Field 50 : Applicant
This field specifies the party on behalf of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Applicant
:SWIFT MT 700 Field 50 : Applicant
This field specifies the party on behalf of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_beneficiary_nm_and_address
string or null (Beneficiary)

:SWIFT MT 700 Field 59 : Beneficiary
The field specifies the party in favour of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Beneficiary
:SWIFT MT 700 Field 59 : Beneficiary
The field specifies the party in favour of which the documentary credit is being issued.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_doc_lc_currency_cd_and_amount
string or null (Currency Code, Amount)

:SWIFT MT 700 Field 32B : Currency Code, Amount
This field contains the currency code and amount of the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Currency Code, Amount
:SWIFT MT 700 Field 32B : Currency Code, Amount
This field contains the currency code and amount of the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_available_with_by
string or null (Available with and by)

:SWIFT MT 700 Field 41a : Available with... by …
This field identifies the bank with which the credit is available (the place for presentation) and an indication of how the credit is available.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Available with and by
:SWIFT MT 700 Field 41a : Available with... by …
This field identifies the bank with which the credit is available (the place for presentation) and an indication of how the credit is available.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_negotiation_deferred_payment_details
string or null (Negotiation/Deferred Payment Details)

:SWIFT MT 700 Field 42P : Negotiation/Deferred Payment Details
This field specifies the payment date or method for its determination in a documentary credit which is available by deferred payment or negotiation only.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Negotiation/Deferred Payment Details
:SWIFT MT 700 Field 42P : Negotiation/Deferred Payment Details
This field specifies the payment date or method for its determination in a documentary credit which is available by deferred payment or negotiation only.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_partial_shipments
string or null (Partial Shipments)

:SWIFT MT 700 Field 43P : Partial Shipments
This field specifies whether or not partial shipments are allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Partial Shipments
:SWIFT MT 700 Field 43P : Partial Shipments
This field specifies whether or not partial shipments are allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_transhipment
string or null (Transhipment)

:SWIFT MT 700 Field 43T : Transhipment
This field specifies whether or not transhipment is allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Transhipment
:SWIFT MT 700 Field 43T : Transhipment
This field specifies whether or not transhipment is allowed under the documentary credit.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_latest_dt_of_shipment
string or null <date> (Latest Date of Shipment)

:SWIFT MT 700 Field 44C : Latest Date of Shipment
This field specifies the latest date for loading on board/dispatch/taking in charge.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Latest Date of Shipment
:SWIFT MT 700 Field 44C : Latest Date of Shipment
This field specifies the latest date for loading on board/dispatch/taking in charge.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:date (YYYY-MM-DD)

lc_confirmation_instructions
string or null (Confirmation Instructions)

:SWIFT MT 700 Field 49 : Confirmation Instructions
This field contains confirmation instructions for the requested confirmation party.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Confirmation Instructions
:SWIFT MT 700 Field 49 : Confirmation Instructions
This field contains confirmation instructions for the requested confirmation party.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_percentage_credit_amt_tolerance
string or null (Percentage Credit Amount Tolerance)

:SWIFT MT 700 Field 39A : Percentage Credit Amount Tolerance
This field specifies the tolerance relative to the documentary credit amount as a percentage plus and/or minus that amount.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Percentage Credit Amount Tolerance
:SWIFT MT 700 Field 39A : Percentage Credit Amount Tolerance
This field specifies the tolerance relative to the documentary credit amount as a percentage plus and/or minus that amount.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_mixed_payment_details
string or null (Mixed Payment Details)

:SWIFT MT 700 Field 42M : Mixed Payment Details
This field specifies the payment dates, amounts and/or method for their determination in a documentary credit which is available by mixed payment.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Mixed Payment Details
:SWIFT MT 700 Field 42M : Mixed Payment Details
This field specifies the payment dates, amounts and/or method for their determination in a documentary credit which is available by mixed payment.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

lc_period_for_presentation_in_days
string or null (Period for Presentaton in Days)

:SWIFT MT 700 Field 48 : Period for Presentaton in Days
This field specifies the number of calendar days after the date of shipment within which the documents must be presented for payment, acceptance, or negotiation. Narrative must only be used to specify another type of date than a shipment date, for example invoice date, from which the period for presentation begins.
This definition is per the Standards MT November 2020 Message Reference Guide.
:Period for Presentaton in Days
:SWIFT MT 700 Field 48 : Period for Presentaton in Days
This field specifies the number of calendar days after the date of shipment within which the documents must be presented for payment, acceptance, or negotiation. Narrative must only be used to specify another type of date than a shipment date, for example invoice date, from which the period for presentation begins.
This definition is per the Standards MT November 2020 Message Reference Guide.
:NA
:NA

Array of objects or null (Letter of Credit Attachment)

:Letter of Credit Attachment
:Letter of Credit Attachment
:Letter of Credit Attachment
:NA
:NA

{
  • "lc_doc_lc_form": "string",
  • "lc_dt_of_issue": "2019-08-24",
  • "lc_doc_lc_no": "string",
  • "lc_dt_and_place_of_expiry": "string",
  • "lc_applicant": "string",
  • "lc_beneficiary_nm_and_address": "string",
  • "lc_doc_lc_currency_cd_and_amount": "string",
  • "lc_available_with_by": "string",
  • "lc_negotiation_deferred_payment_details": "string",
  • "lc_partial_shipments": "string",
  • "lc_transhipment": "string",
  • "lc_latest_dt_of_shipment": "2019-08-24",
  • "lc_confirmation_instructions": "string",
  • "lc_percentage_credit_amt_tolerance": "string",
  • "lc_mixed_payment_details": "string",
  • "lc_period_for_presentation_in_days": "string",
  • "attachments": [
    ]
}

Letter Of Credit Application

Data Element ID: letter_of_credit_application

lca_date
required
string <date> (Date)

:Date of document
:Date
:Date of document
:NA
:date (YYYY-MM-DD)

lca_applicant_name
string or null (Applicant's Name)

:Name of applicant
:Applicant's Name
:Name of applicant
:NA
:NA

lca_applicant_address
string or null (Applicant's Address)

:Address of applicant
:Applicant's Address
:Address of applicant
:NA
:NA

lca_contact_person_applicant
string or null (Contact Person (Applicant))

:Name of contact person for applicant
:Contact Person (Applicant)
:Name of contact person for applicant
:NA
:NA

lca_telephone_number_applicant
number or null <double> (Telephone Number (Applicant))

:Contact number of contact person
:Telephone Number (Applicant)
:Contact number of contact person
:NA
:NA

lca_fax_applicant
number or null <double> (Fax No (Applicant))

:Fax Number of Applicant
:Fax No (Applicant)
:Fax Number of Applicant
:NA
:NA

lca_debit_account_no
string or null (Debit Account No.)

:Debit account number of Applicant
:Debit Account No.
:Debit account number of Applicant
:NA
:NA

lca_beneficiary_type
string or null (Beneficiary Type (Local / Overseas))

:Local or Overseas Beneficiary type
:Beneficiary Type (Local / Overseas)
:Local or Overseas Beneficiary type
:NA
:NA

lca_beneficiary_name
string or null (Beneficiary's Name)

:Name of beneficiary
:Beneficiary's Name
:Name of beneficiary
:NA
:NA

lca_beneficiary_address
string or null (Beneficiary's Address)

:Address of beneficiary
:Beneficiary's Address
:Address of beneficiary
:NA
:NA

lca_contact_person_beneficiary
string or null (Contact Person (Beneficiary))

:Name of contact person for beneficiary
:Contact Person (Beneficiary)
:Name of contact person for beneficiary
:NA
:NA

lca_telephone_number_beneficiary
number or null <double> (Telephone Number (Beneficiary))

:Contact number of contact person
:Telephone Number (Beneficiary)
:Contact number of contact person
:NA
:NA

lca_fax_beneficiary
number or null <double> (Fax No (Beneficiary))

:Fax Number of Beneficiary
:Fax No (Beneficiary)
:Fax Number of Beneficiary
:NA
:NA

lca_third_party_name
string or null (Third Party Name)

:Name of Third Party (if applying on behalf of)
:Third Party Name
:Name of Third Party (if applying on behalf of)
:NA
:NA

lca_third_party_address
string or null (Third Party Address)

:Address of Third Party (if applying on behalf of)
:Third Party Address
:Address of Third Party (if applying on behalf of)
:NA
:NA

lca_advising_bank_name
string or null (Advising Bank Name)

:Registered company name of advising bank
:Advising Bank Name
:Registered company name of advising bank
:NA
:NA

lca_advising_bank_address
string or null (Advising Bank Address)

:Registered company address of advising bank
:Advising Bank Address
:Registered company address of advising bank
:NA
:NA

lca_advising_bank_swift_address
string or null (Advising Bank SWIFT Address)

:Registered company SWIFT address of advising bank
:Advising Bank SWIFT Address
:Registered company SWIFT address of advising bank
:NA
:NA

lca_currency
string or null (Currency)

:Currency Type to be used
:Currency
:Currency Type to be used
:NA
:NA

lca_amount
number or null <double> (Amount)

:Amount applicable
:Amount
:Amount applicable
:NA
:NA

lca_issuance_date
string or null <date> (LC Issuance Date)

:Issuance date of Letter of Credit
:LC Issuance Date
:Issuance date of Letter of Credit
:NA
:NA

lca_date_expiry_beneficiary_country
string or null <date> (Expiry Date (Beneficiary Country))

:Expiry date of Letter of Credit in country of beneficiary
:Expiry Date (Beneficiary Country)
:Expiry date of Letter of Credit in country of beneficiary
:NA
:NA

lca_date_expiry_applicant_country
string or null <date> (Expiry Date (Applicant Country))

:Expiry date of Letter of Credit in country of applicant
:Expiry Date (Applicant Country)
:Expiry date of Letter of Credit in country of applicant
:NA
:NA

lca_charges
string or null (Charges)

:Indicates reimburement charges to be charged to applicant / beneficiary
:Charges
:Indicates reimburement charges to be charged to applicant / beneficiary
:NA
:NA

lca_documents
string or null (Documents Required)

:Type of documents required
:Documents Required
:Type of documents required
:NA
:NA

lca_special_instructions
string or null (Special Instructions)

:Indicates if any special instructions are applicable
:Special Instructions
:Indicates if any special instructions are applicable
:NA
:NA

lca_special_type_credit_governing_rule
string or null (Special Type of Credit- Governing Rule)

:SBLC Subject to UCP600 or ISP 98 (if applicable)
:Special Type of Credit- Governing Rule
:SBLC Subject to UCP600 or ISP 98 (if applicable)
:NA
:NA

lca_tenor
string or null (Tenor )

:Tenor for trade financing (e.g. Sight / Term)
:Tenor
:Tenor for trade financing (e.g. Sight / Term)
:NA
:NA

lca_shipment_from
string or null (Shipment From)

:Details of shipment location of origin
:Shipment From
:Details of shipment location of origin
:NA
:NA

lca_shipment_to
string or null (Shipment To)

:Details of shipment location
:Shipment To
:Details of shipment location
:NA
:NA

lca_date_latest_shipment
string or null <date> (Latest Shipment Date)

:Date of latest shipment
:Latest Shipment Date
:Date of latest shipment
:NA
:NA

lca_present_documents_in_X_days_after_shipment_date_but_before_LC_expiry
number or null <double> (Present documents in X days after shipment date but before LC expiry)

:Present documents in X days after shipment date but before LC expiry
:Present documents in X days after shipment date but before LC expiry
:Present documents in X days after shipment date but before LC expiry
:NA
:NA

lca_issuance_mode
string or null (LC issuance mode)

:Mode of LC issuance
:LC issuance mode
:Mode of LC issuance
:NA
:NA

lca_lc_to_be_confirmed_by_advising_bank
string or null (LC To Be Confirmed by Advising Bank)

:Indicates whether LC is to be confirmed by Advising Bank
:LC To Be Confirmed by Advising Bank
:Indicates whether LC is to be confirmed by Advising Bank
:NA
:NA

lca_confirmation_charges
string or null (Confirmation Charges)

:Indicates confirmation charges to be charged to applicant / beneficiary
:Confirmation Charges
:Indicates confirmation charges to be charged to applicant / beneficiary
:NA
:NA

lca_tolerance
string or null (Tolerance)

:Tolerance on Credit Amount
:Tolerance
:Tolerance on Credit Amount
:NA
:NA

lca_goods_description
string or null (Goods description)

:Description of goods
:Goods description
:Description of goods
:NA
:NA

lca_transshipment_allowed
string or null (Transshipment Allowed)

:Indicates whether transshipment is allowed
:Transshipment Allowed
:Indicates whether transshipment is allowed
:NA
:NA

lca_partial_shipment_allowed
string or null (Partial Shipment Allowed)

:Indicates whether partial shipment is allowed
:Partial Shipment Allowed
:Indicates whether partial shipment is allowed
:NA
:NA

lca_incoterms
string or null (Incoterms)

:Applicable Incoterms
:Incoterms
:Applicable Incoterms
:NA
:NA

lca_insurance_to_be_covered_by
string or null (Insurance To Be Covered By)

:Indicates the party covering the insurance
:Insurance To Be Covered By
:Indicates the party covering the insurance
:NA
:NA

lca_cover_no
string or null (Cover No.)

:Insurance Policy cover number (if Insurance covered by Applicant)
:Cover No.
:Insurance Policy cover number (if Insurance covered by Applicant)
:NA
:NA

lca_insurance_company
string or null (Insurance Company)

:Insurance company (if Insurance covered by Applicant)
:Insurance Company
:Insurance company (if Insurance covered by Applicant)
:NA
:NA

Array of objects or null (Letter of Credit Application Attachment)

:Letter of Credit Application Attachment
:Letter of Credit Application Attachment
:Letter of Credit Application Attachment
:NA
:NA

{
  • "lca_date": "2019-08-24",
  • "lca_applicant_name": "string",
  • "lca_applicant_address": "string",
  • "lca_contact_person_applicant": "string",
  • "lca_telephone_number_applicant": 0.1,
  • "lca_fax_applicant": 0.1,
  • "lca_debit_account_no": "string",
  • "lca_beneficiary_type": "string",
  • "lca_beneficiary_name": "string",
  • "lca_beneficiary_address": "string",
  • "lca_contact_person_beneficiary": "string",
  • "lca_telephone_number_beneficiary": 0.1,
  • "lca_fax_beneficiary": 0.1,
  • "lca_third_party_name": "string",
  • "lca_third_party_address": "string",
  • "lca_advising_bank_name": "string",
  • "lca_advising_bank_address": "string",
  • "lca_advising_bank_swift_address": "string",
  • "lca_currency": "string",
  • "lca_amount": 0.1,
  • "lca_issuance_date": "2019-08-24",
  • "lca_date_expiry_beneficiary_country": "2019-08-24",
  • "lca_date_expiry_applicant_country": "2019-08-24",
  • "lca_charges": "string",
  • "lca_documents": "string",
  • "lca_special_instructions": "string",
  • "lca_special_type_credit_governing_rule": "string",
  • "lca_tenor": "string",
  • "lca_shipment_from": "string",
  • "lca_shipment_to": "string",
  • "lca_date_latest_shipment": "2019-08-24",
  • "lca_present_documents_in_X_days_after_shipment_date_but_before_LC_expiry": 0.1,
  • "lca_issuance_mode": "string",
  • "lca_lc_to_be_confirmed_by_advising_bank": "string",
  • "lca_confirmation_charges": "string",
  • "lca_tolerance": "string",
  • "lca_goods_description": "string",
  • "lca_transshipment_allowed": "string",
  • "lca_partial_shipment_allowed": "string",
  • "lca_incoterms": "string",
  • "lca_insurance_to_be_covered_by": "string",
  • "lca_cover_no": "string",
  • "lca_insurance_company": "string",
  • "attachments": [
    ]
}

Packing List

Data Element ID: packing_list

inv_no
string or null (Invoice Number )

:Reference number to identify an invoice
:Invoice Number
:Reference number to identify an invoice
:ISO7372
:NA

contract_no
string or null (Contract Number)

:Identifier of a contract concluded between parties such as between buyer and seller
:Contract Number
:Identifier of a contract concluded between parties such as between buyer and seller
:ISO7372
:NA

issue_dt
required
string (Issue Date)

:Date that a document was issued and when appropriate, signed or otherwise authenticated
:Issue Date
:Date that a document was issued and when appropriate, signed or otherwise authenticated
:ISO7372
:NA

consignee_nm
required
string (Consignee)

:Party to which goods are consigned
:Consignee
:Party to which goods are consigned
:ISO7372
:NA

buyer_nm
required
string (Buyer)

:Party to which merchandise or services are sold.
:Buyer
:Party to which merchandise or services are sold.
:ISO7372
:NA

carrier_nm
string or null (Carrier (Transport Services Provider))

:Party providing the transport of goods between named points
:Carrier (Transport Services Provider)
:Party providing the transport of goods between named points
:ISO7372
:NA

seller_nm
required
string (Seller)

:Party selling merchandise or services to a buyer
:Seller
:Party selling merchandise or services to a buyer
:ISO7372
:NA

goods_pod
required
string (Place of the delivery of the goods (by the carrier))

:Location to which a consignment is to be delivered to the final consignee.
:Place of the delivery of the goods (by the carrier)
:Location to which a consignment is to be delivered to the final consignee.
:ISO7372
:NA

unloading_loc
string or null (Baseport Unloading Location)

:The place or port at which the cargo is discharged or unloaded from a means of transport according to the transport contract. The goods may or may not be discharged from the main means of transport at this place or port
:Baseport Unloading Location
:The place or port at which the cargo is discharged or unloaded from a means of transport according to the transport contract. The goods may or may not be discharged from the main means of transport at this place or port
:ISO7372
:NA

carriage_condition_ref
string or null (Transport Contract Document Conditions)

:Reference to carrier’s conditions of carriage printed on document or provided separately.
:Transport Contract Document Conditions
:Reference to carrier’s conditions of carriage printed on document or provided separately.
:ISO7372
:NA

volume
required
string (Volume (Cube))

:Measurement normally arrived at by multiplying the maximum length, width and height of pieces or package or transport equipment. Also known as cube.
:Volume (Cube)
:Measurement normally arrived at by multiplying the maximum length, width and height of pieces or package or transport equipment. Also known as cube.
:ISO7372
:NA

net_weight
required
string (Net Weight)

:Total net weight (mass) of all the goods items referred to as one consignment
:Net Weight
:Total net weight (mass) of all the goods items referred to as one consignment
:ISO7372
:NA

temperature
required
string (Transport Temperature)

:Instructions regarding the temperature under which the cargo has to be transported
:Transport Temperature
:Instructions regarding the temperature under which the cargo has to be transported
:ISO7372
:NA

required
Array of objects (Goods Details)

:Details of the goods
:Goods Details
:Details of the goods
:ISO7372
:NA

danger_lvl_cd
string or null (Packaging Danger Level Code)

:Code specifying the level of danger for which the packaging must cater
:Packaging Danger Level Code
:Code specifying the level of danger for which the packaging must cater
:ISO7372
:NA

proper_nm
string or null (Proper Shipping / Technical Name)

:Proper shipping name, supplemented as necessary with the correct technical name, by which a dangerous substance or article may be correctly identified, or which is sufficiently informative to permit identification by reference to generally available literature
:Proper Shipping / Technical Name
:Proper shipping name, supplemented as necessary with the correct technical name, by which a dangerous substance or article may be correctly identified, or which is sufficiently informative to permit identification by reference to generally available literature
:ISO7372
:NA

undg_no
string or null (UNDG Number)

:United Nations Dangerous Goods Identifier (UNDG) is the unique serial number assigned within the United Nations to substances and articles contained in a list of the dangerous goods most commonly carried.
:UNDG Number
:United Nations Dangerous Goods Identifier (UNDG) is the unique serial number assigned within the United Nations to substances and articles contained in a list of the dangerous goods most commonly carried.
:ISO7372
:NA

transport_nm
required
string (Transport means identifier )

:Name of a specific means of transport such as the vessel name
:Transport means identifier
:Name of a specific means of transport such as the vessel name
:ISO7372
:NA

vehicle_nm
required
string (Vehicle registration number)

:Identifier of a specific means of transport such as the International Maritime Organisation number of a vessel
:Vehicle registration number
:Identifier of a specific means of transport such as the International Maritime Organisation number of a vessel
:ISO7372
:NA

equipment_identifier
string or null (Transport Equipment Identifier)

:Identifier of a piece of transport equipment e.g. container or unit load device
:Transport Equipment Identifier
:Identifier of a piece of transport equipment e.g. container or unit load device
:ISO7372
:NA

conveyance_ref
required
string (Conveyance reference number/Journey identifier)

:Identifier of a journey of a means of transport, for example voyage number, flight number, trip number
:Conveyance reference number/Journey identifier
:Identifier of a journey of a means of transport, for example voyage number, flight number, trip number
:ISO7372
:NA

Array of objects or null (Packing List Attachment)

:Packing List Attachment
:Packing List Attachment
:Packing List Attachment
:NA
:NA

{
  • "inv_no": "string",
  • "contract_no": "string",
  • "issue_dt": "string",
  • "consignee_nm": "string",
  • "buyer_nm": "string",
  • "carrier_nm": "string",
  • "seller_nm": "string",
  • "goods_pod": "string",
  • "unloading_loc": "string",
  • "carriage_condition_ref": "string",
  • "volume": "string",
  • "net_weight": "string",
  • "temperature": "string",
  • "goods_details": [
    ],
  • "danger_lvl_cd": "string",
  • "proper_nm": "string",
  • "undg_no": "string",
  • "transport_nm": "string",
  • "vehicle_nm": "string",
  • "equipment_identifier": "string",
  • "conveyance_ref": "string",
  • "attachments": [
    ]
}

Purchase Order

Data Element ID: purchase_order

po_additional_document_reference
string or null (Additional Document Reference)

:Field UID: ORD- 0034-An associative reference to Additional Document.
:Additional Document Reference
:Field UID: ORD- 0034-An associative reference to Additional Document.
:UN/CEFACT
:NA

po_allowance_and_charge
string or null (Allowance And Charge)

:Field UID: ORD- 0050-The entity contains the details of the allowance and charge valid for the order header.
:Allowance And Charge
:Field UID: ORD- 0050-The entity contains the details of the allowance and charge valid for the order header.
:UN/CEFACT
:NA

po_assets_expense_account
string or null (Assets Or Expenses Account)

:Field UID: ORD- 0136-The entity contains information related to the assets or expenses account where to record the debit or credit accounting amount, the code defining the type of account (e.g. general, secondary, cost accounting, budget, etc.)..
:Assets Or Expenses Account
:Field UID: ORD- 0136-The entity contains information related to the assets or expenses account where to record the debit or credit accounting amount, the code defining the type of account (e.g. general, secondary, cost accounting, budget, etc.)..
:UN/CEFACT
:NA

po_blanket_order_reference
string or null (Blanket Order Reference)

:Field UID: ORD- 0018-The unique identification assigned by the issuer to a blanket order.
:Blanket Order Reference
:Field UID: ORD- 0018-The unique identification assigned by the issuer to a blanket order.
:UN/CEFACT
:NA

po_buyer
required
string (Buyer)

:Field UID: ORD- 0011-The entity contains the details of the buyer.
:Buyer
:Field UID: ORD- 0011-The entity contains the details of the buyer.
:UN/CEFACT
:NA

po_carrier
string or null (Carrier)

:Field UID: ORD- 0035-The entity contains the details of the carrier.
:Carrier
:Field UID: ORD- 0035-The entity contains the details of the carrier.
:UN/CEFACT
:NA

po_confirmed_earliest_schedule_date
string or null <date> (Confirmed Earliest Schedule Date)

:Field UID: ORD- 0108-The earliest date/time on which the delivery is confirmed.
:Confirmed Earliest Schedule Date
:Field UID: ORD- 0108-The earliest date/time on which the delivery is confirmed.
:UN/CEFACT
:NA

po_confirmed_latest_schedule_date
string or null <date> (Confirmed Latest Schedule Date)

:Field UID: ORD- 0109-The latest date/time on which the delivery is confirmed.
:Confirmed Latest Schedule Date
:Field UID: ORD- 0109-The latest date/time on which the delivery is confirmed.
:UN/CEFACT
:NA

po_confirmed_schedule_date
string or null <date> (Confirmed Schedule Date)

:Field UID: ORD- 0107-The date, a date and time on which the delivery is confirmed.
:Confirmed Schedule Date
:Field UID: ORD- 0107-The date, a date and time on which the delivery is confirmed.
:UN/CEFACT
:NA

po_consignee
string or null (Consignee)

:Field UID: ORD- 0038-The entity contains the details of the consignee.
:Consignee
:Field UID: ORD- 0038-The entity contains the details of the consignee.
:UN/CEFACT
:NA

po_consignee_agent
string or null (Consignee Agent)

:Field UID: ORD- 0113-Associates the shipment with the consignee agent.
:Consignee Agent
:Field UID: ORD- 0113-Associates the shipment with the consignee agent.
:UN/CEFACT
:NA

po_consignee_order_reference
string or null (Consignee Order Reference)

:Field UID: ORD- 0019-The unique identification assigned by the consignee to an order.
:Consignee Order Reference
:Field UID: ORD- 0019-The unique identification assigned by the consignee to an order.
:UN/CEFACT
:NA

po_cost_assignment_reference
string or null (Cost Assignment Reference)

:Field UID: ORD- 0033-The Buyer's accounting code applied to the Order as a whole, expressed as text.
:Cost Assignment Reference
:Field UID: ORD- 0033-The Buyer's accounting code applied to the Order as a whole, expressed as text.
:UN/CEFACT
:NA

po_country_final_destination
string or null (Country Of Final Destination)

:Field UID: ORD- 0124-The code specifying the final country to which the goods are to be delivered.
:Country Of Final Destination
:Field UID: ORD- 0124-The code specifying the final country to which the goods are to be delivered.
:UN/CEFACT
:NA

po_customer_accountant
string or null (Customer Accountant)

:Field UID: ORD- 0012-The entity contains the details of the customer accountant.
:Customer Accountant
:Field UID: ORD- 0012-The entity contains the details of the customer accountant.
:UN/CEFACT
:NA

po_customer_reference
string or null (Customer Reference)

:Field UID: ORD- 0032-A supplementary reference for the Order, expressed as text.
:Customer Reference
:Field UID: ORD- 0032-A supplementary reference for the Order, expressed as text.
:UN/CEFACT
:NA

po_customs_certificate_reference
string or null (Customs Certificate Reference)

:Field UID: ORD- 0029-The unique identification assigned by the issuer to a customs certificate.
:Customs Certificate Reference
:Field UID: ORD- 0029-The unique identification assigned by the issuer to a customs certificate.
:UN/CEFACT
:NA

po_delivery_document_reference
string or null (Delivery Document Reference)

:Field UID: ORD- 0114-Associates the delivery Line with a Document.
:Delivery Document Reference
:Field UID: ORD- 0114-Associates the delivery Line with a Document.
:UN/CEFACT
:NA

po_delivery_instruction
string or null (Delivery Instruction)

:Field UID: ORD- 0120-The code specifying the delivery instruction.
:Delivery Instruction
:Field UID: ORD- 0120-The code specifying the delivery instruction.
:UN/CEFACT
:NA

po_delivery_instruction_description
string or null (Delivery Instruction Description)

:Field UID: ORD- 0121-The textual description of a delivery instruction.
:Delivery Instruction Description
:Field UID: ORD- 0121-The textual description of a delivery instruction.
:UN/CEFACT
:NA

po_despatch_document_note
string or null (Despatch Document Note)

:Field UID: ORD- 0078-The textual description to be provided on the despatch documents.
:Despatch Document Note
:Field UID: ORD- 0078-The textual description to be provided on the despatch documents.
:UN/CEFACT
:NA

po_despatch_period
string or null (Despatch Period)

:Field UID: ORD- 0039-The despatch period of the goods valid for the entire order.
:Despatch Period
:Field UID: ORD- 0039-The despatch period of the goods valid for the entire order.
:UN/CEFACT
:NA

po_document_information
string or null (Document Information)

:Field UID: ORD- 0007-Generic document.
:Document Information
:Field UID: ORD- 0007-Generic document.
:UN/CEFACT
:NA

po_document_purpose
string or null (Document Purpose/Function)

:Field UID: ORD- 0137-A code describing the purpose/function of the document.
:Document Purpose/Function
:Field UID: ORD- 0137-A code describing the purpose/function of the document.
:UN/CEFACT
:NA

po_earliest_schedule_date
string or null <date> (Earliest Schedule Date)

:Field UID: ORD- 0105-The value of the earliest scheduled date, a date and time in a specified representation.
:Earliest Schedule Date
:Field UID: ORD- 0105-The value of the earliest scheduled date, a date and time in a specified representation.
:UN/CEFACT
:NA

po_engineering_change_reference
string or null (Engineering Change Reference)

:Field UID: ORD- 0024-The unique identification assigned by the issuer to an engineering change.
:Engineering Change Reference
:Field UID: ORD- 0024-The unique identification assigned by the issuer to an engineering change.
:UN/CEFACT
:NA

po_export_license_reference
string or null (Export License Reference)

:Field UID: ORD- 0028-The unique identification assigned by the issuer to an export license.
:Export License Reference
:Field UID: ORD- 0028-The unique identification assigned by the issuer to an export license.
:UN/CEFACT
:NA

po_import_license_reference
string or null (Import License Reference)

:Field UID: ORD- 0027-The unique identification assigned by the issuer to an import license.
:Import License Reference
:Field UID: ORD- 0027-The unique identification assigned by the issuer to an import license.
:UN/CEFACT
:NA

po_invoice_currency
string or null (Invoice Currency)

:Field UID: ORD- 0044-The name or symbol of the monetary unit used for calculation in an invoice.
:Invoice Currency
:Field UID: ORD- 0044-The name or symbol of the monetary unit used for calculation in an invoice.
:UN/CEFACT
:NA

po_invoice_currency_exchange
string or null (Invoice Currency Exchange)

:Field UID: ORD- 0052-The exchange rate used for the conversion of the invoice currency from a source currency.
:Invoice Currency Exchange
:Field UID: ORD- 0052-The exchange rate used for the conversion of the invoice currency from a source currency.
:UN/CEFACT
:NA

po_invoicee
string or null (Invoicee)

:Field UID: ORD- 0042-The entity contains the details of the invoicee.
:Invoicee
:Field UID: ORD- 0042-The entity contains the details of the invoicee.
:UN/CEFACT
:NA

po_latest_schedule_date
string or null <date> (Latest Schedule Date)

:Field UID: ORD- 0106-The value of a latest scheduled date, a date and time in a specified representation.
:Latest Schedule Date
:Field UID: ORD- 0106-The value of a latest scheduled date, a date and time in a specified representation.
:UN/CEFACT
:NA

po_letter_of_credit_reference
string or null (Letter Of Credit Reference)

:Field UID: ORD- 0026-The unique identification assigned by the issuer to a letter of credit.
:Letter Of Credit Reference
:Field UID: ORD- 0026-The unique identification assigned by the issuer to a letter of credit.
:UN/CEFACT
:NA

po_minus_delivery_quantity
string or null (Minus Delivery Quantity)

:Field UID: ORD- 0111-The quantity tolerance in minus.
:Minus Delivery Quantity
:Field UID: ORD- 0111-The quantity tolerance in minus.
:UN/CEFACT
:NA

po_no_partial_delivery_allowed
string or null (No Partial Delivery Allowed)

:Field UID: ORD- 0122-The indicator that no partial delivery of the order is allowed.
:No Partial Delivery Allowed
:Field UID: ORD- 0122-The indicator that no partial delivery of the order is allowed.
:UN/CEFACT
:NA

po_order_change_header
string or null (Order Change Header)

:Field UID: ORD- 0001-Header information related to the ordering event and order document
:Order Change Header
:Field UID: ORD- 0001-Header information related to the ordering event and order document
:UN/CEFACT
:NA

po_order_currency
string or null (Order Currency)

:Field UID: ORD- 0045-The name or symbol of the monetary unit used for calculation in an order.
:Order Currency
:Field UID: ORD- 0045-The name or symbol of the monetary unit used for calculation in an order.
:UN/CEFACT
:NA

po_order_currency_exchange
string or null (Order Currency Exchange)

:Field UID: ORD- 0053-The exchange rate used for the conversion of the order currency from a source currency.
:Order Currency Exchange
:Field UID: ORD- 0053-The exchange rate used for the conversion of the order currency from a source currency.
:UN/CEFACT
:NA

Array of objects or null (Order Details)

:Line Level Order Details
:Order Details
:Line Level Order Details
:UN/CEFACT
:NA

po_order_number_marketplace
string or null (Order Number Marketplace)

:Field UID: ORD- 0030-The unique number given by the marketplace to identify an order.
:Order Number Marketplace
:Field UID: ORD- 0030-The unique number given by the marketplace to identify an order.
:UN/CEFACT
:NA

po_order_response_header
string or null (Order Response Header)

:Field UID: ORD- 0003-Header information related to the ordering event and order document
:Order Response Header
:Field UID: ORD- 0003-Header information related to the ordering event and order document
:UN/CEFACT
:NA

po_original_order_reference
string or null (Original Order Reference)

:Field UID: ORD- 0023-The unique identification assigned by the issuer to the original order.
:Original Order Reference
:Field UID: ORD- 0023-The unique identification assigned by the issuer to the original order.
:UN/CEFACT
:NA

po_payable_account
string or null (Payable Account)

:Field UID: ORD- 0051-The entity contains information related to the payable account where to record the debit or credit accounting amount, the code defining the type of account (e.g. general, secondary, cost accounting, budget, etc.)..
:Payable Account
:Field UID: ORD- 0051-The entity contains information related to the payable account where to record the debit or credit accounting amount, the code defining the type of account (e.g. general, secondary, cost accounting, budget, etc.)..
:UN/CEFACT
:NA

po_payee
string or null (Payee)

:Field UID: ORD- 0128-The entity contains the details of the payer.
:Payee
:Field UID: ORD- 0128-The entity contains the details of the payer.
:UN/CEFACT
:NA

po_payer
string or null (Payer)

:Field UID: ORD- 0043-The entity contains the details of the payer.
:Payer
:Field UID: ORD- 0043-The entity contains the details of the payer.
:UN/CEFACT
:NA

po_payment_instructions
string or null (Payment Instructions)

:Field UID: ORD- 0048-The entity contains the set of information describing the conditions and guarantee under which the payment will or should be made.
:Payment Instructions
:Field UID: ORD- 0048-The entity contains the set of information describing the conditions and guarantee under which the payment will or should be made.
:UN/CEFACT
:NA

po_payment_terms
string or null (Payment Terms)

:Field UID: ORD- 0049-The entity contains the details of the payment terms and date/time basis.
:Payment Terms
:Field UID: ORD- 0049-The entity contains the details of the payment terms and date/time basis.
:UN/CEFACT
:NA

po_place_destination
string or null (Place Of Destination)

:Field UID: ORD- 0119-The internal destination of the ship to location or address, of the products after discharging the transport means
:Place Of Destination
:Field UID: ORD- 0119-The internal destination of the ship to location or address, of the products after discharging the transport means
:UN/CEFACT
:NA

po_place_discharge
string or null (Place Of Discharge)

:Field UID: ORD- 0118-The internal location of the ship to location or address, were the products will be (are) discharged from the transport means.
:Place Of Discharge
:Field UID: ORD- 0118-The internal location of the ship to location or address, were the products will be (are) discharged from the transport means.
:UN/CEFACT
:NA

po_plus_delivery_quantity
string or null (Plus Delivery Quantity)

:Field UID: ORD- 0112-The quantity tolerance in plus.
:Plus Delivery Quantity
:Field UID: ORD- 0112-The quantity tolerance in plus.
:UN/CEFACT
:NA

po_price
string or null (Price)

:Field UID: ORD- 0134-The entity contains the price type, price amount, the allowance and charges and the validity period for the order line or delivery details specified in the depending scheduled lines.
:Price
:Field UID: ORD- 0134-The entity contains the price type, price amount, the allowance and charges and the validity period for the order line or delivery details specified in the depending scheduled lines.
:UN/CEFACT
:NA

po_price_list_reference
string or null (Price List Reference)

:Field UID: ORD- 0017-The unique identification assigned by the issuer to a price list.
:Price List Reference
:Field UID: ORD- 0017-The unique identification assigned by the issuer to a price list.
:UN/CEFACT
:NA

po_pricing_currency
string or null (Pricing Currency)

:Field UID: ORD- 0046-The name or symbol of the monetary unit used for all prices in an order.
:Pricing Currency
:Field UID: ORD- 0046-The name or symbol of the monetary unit used for all prices in an order.
:UN/CEFACT
:NA

po_pricing_currency_exchange
string or null (Pricing Currency Exchange)

:Field UID: ORD- 0055-The exchange rate used for the conversion of the pricing currency from a source currency.
:Pricing Currency Exchange
:Field UID: ORD- 0055-The exchange rate used for the conversion of the pricing currency from a source currency.
:UN/CEFACT
:NA

po_prior_order_change_reference
string or null (Prior Order Change Reference)

:Field UID: ORD- 0021-The unique identification assigned by the issuer to a prior order change.
:Prior Order Change Reference
:Field UID: ORD- 0021-The unique identification assigned by the issuer to a prior order change.
:UN/CEFACT
:NA

po_prior_order_reference
string or null (Prior Order Reference)

:Field UID: ORD- 0020-The unique identification assigned by the issuer to a prior order.
:Prior Order Reference
:Field UID: ORD- 0020-The unique identification assigned by the issuer to a prior order.
:UN/CEFACT
:NA

po_prior_order_response_reference
string or null (Prior Order Response Reference)

:Field UID: ORD- 0022-The unique identification assigned by the issuer to a prior order response.
:Prior Order Response Reference
:Field UID: ORD- 0022-The unique identification assigned by the issuer to a prior order response.
:UN/CEFACT
:NA

po_quote_reference
string or null (Quote Reference (Offer))

:Field UID: ORD- 0014-The unique identification assigned by the issuer to a quote (offer).
:Quote Reference (Offer)
:Field UID: ORD- 0014-The unique identification assigned by the issuer to a quote (offer).
:UN/CEFACT
:NA

po_release_period
string or null (Release Period)

:Field UID: ORD- 0040-The release period of the goods valid for the entire order.
:Release Period
:Field UID: ORD- 0040-The release period of the goods valid for the entire order.
:UN/CEFACT
:NA

po_report_reference
string or null (Sales Report Reference)

:Field UID: ORD- 0015-The unique identification assigned by the issuer to a sales report.
:Sales Report Reference
:Field UID: ORD- 0015-The unique identification assigned by the issuer to a sales report.
:UN/CEFACT
:NA

po_request_for_quote_reference
string or null (Request For Quote Reference)

:Field UID: ORD- 0013-The unique identification assigned by the issuer to a request for quote.
:Request For Quote Reference
:Field UID: ORD- 0013-The unique identification assigned by the issuer to a request for quote.
:UN/CEFACT
:NA

po_requisition_reference
string or null (Requisition Reference)

:Field UID: ORD- 0025-The unique identification assigned by the issuer to a requisition.
:Requisition Reference
:Field UID: ORD- 0025-The unique identification assigned by the issuer to a requisition.
:UN/CEFACT
:NA

po_requisitioner
string or null (Requisitioner)

:Field UID: ORD- 0083-The party who originated Order
:Requisitioner
:Field UID: ORD- 0083-The party who originated Order
:UN/CEFACT
:NA

po_response_reason_code
string or null (Response Reason Code)

:Field UID: ORD- 0138-A code describing the reason for a specific response such as a rejection. Used on both header and line.
:Response Reason Code
:Field UID: ORD- 0138-A code describing the reason for a specific response such as a rejection. Used on both header and line.
:UN/CEFACT
:NA

po_rounding_amount
string or null (Rounding Amount)

:Field UID: ORD- 0062-The rounding amount (positive or negative) added to the to be paid amount.
:Rounding Amount
:Field UID: ORD- 0062-The rounding amount (positive or negative) added to the to be paid amount.
:UN/CEFACT
:NA

po_scedule_period
string or null (Schedule Period)

:Field UID: ORD- 0041-The scheduled period of the goods valid for the entire order.
:Schedule Period
:Field UID: ORD- 0041-The scheduled period of the goods valid for the entire order.
:UN/CEFACT
:NA

po_schedule_date
string or null <date> (Schedule Date)

:Field UID: ORD- 0104-The value of the scheduled date, a date and time in a specified representation.
:Schedule Date
:Field UID: ORD- 0104-The value of the scheduled date, a date and time in a specified representation.
:UN/CEFACT
:NA

po_seller
string or null (Seller)

:Field UID: ORD- 0008-The entity contains the details of the seller.
:Seller
:Field UID: ORD- 0008-The entity contains the details of the seller.
:UN/CEFACT
:NA

po_ship_from
string or null (Ship From)

:Field UID: ORD- 0037-The entity contains the details of the party from whom the products are physically shipped..
:Ship From
:Field UID: ORD- 0037-The entity contains the details of the party from whom the products are physically shipped..
:UN/CEFACT
:NA

po_ship_from_location
string or null (Ship From Location)

:Field UID: ORD- 0116-Information directly relating to the address/location from which a delivery is shipped.
:Ship From Location
:Field UID: ORD- 0116-Information directly relating to the address/location from which a delivery is shipped.
:UN/CEFACT
:NA

po_ship_to
string or null (Ship To)

:Field UID: ORD- 0036-The entity contains the details of the party to whom the products will be physical delivered.
:Ship To
:Field UID: ORD- 0036-The entity contains the details of the party to whom the products will be physical delivered.
:UN/CEFACT
:NA

po_ship_to_location
string or null (Ship To Location Or Address)

:Field UID: ORD- 0117-The location or address to which a means of transport is destined for the delivery of goods.
:Ship To Location Or Address
:Field UID: ORD- 0117-The location or address to which a means of transport is destined for the delivery of goods.
:UN/CEFACT
:NA

po_shipping_grouping_identifier
string or null (Shipping Grouping Identifier)

:Field UID: ORD- 0125-The identifier of the shipping grouping of the order with the shipping of other orders.
:Shipping Grouping Identifier
:Field UID: ORD- 0125-The identifier of the shipping grouping of the order with the shipping of other orders.
:UN/CEFACT
:NA

po_supplier_order_identifier
string or null (Supplier Order Identifier)

:Field UID: ORD- 0031-An identifier for the Order assigned by the Supplier.
:Supplier Order Identifier
:Field UID: ORD- 0031-An identifier for the Order assigned by the Supplier.
:UN/CEFACT
:NA

po_tax_currency
string or null (Tax Currency)

:Field UID: ORD- 0047-The name or symbol of the monetary unit requested for tax amounts in invoices related to this order.
:Tax Currency
:Field UID: ORD- 0047-The name or symbol of the monetary unit requested for tax amounts in invoices related to this order.
:UN/CEFACT
:NA

po_tax_currency_exchange
string or null (Tax Currency Exchange)

:Field UID: ORD- 0054-The exchange rate used for the conversion of the tax currency from a source currency.
:Tax Currency Exchange
:Field UID: ORD- 0054-The exchange rate used for the conversion of the tax currency from a source currency.
:UN/CEFACT
:NA

po_tax_fee_totals
string or null (Tax Fee Totals)

:Field UID: ORD- 0064-The entity contains of the order the tax type, tax rate, the taxable amount and the tax amount for the tax type and rate.
:Tax Fee Totals
:Field UID: ORD- 0064-The entity contains of the order the tax type, tax rate, the taxable amount and the tax amount for the tax type and rate.
:UN/CEFACT
:NA

po_to_be_paid_amount
string or null (To Be Paid Amount)

:Field UID: ORD- 0063-The total amount to be paid.
:To Be Paid Amount
:Field UID: ORD- 0063-The total amount to be paid.
:UN/CEFACT
:NA

po_total_order_additional_allowance_amount
string or null (Total Order Additional Allowance Amount)

:Field UID: ORD- 0058-The sum of all the allowances at the order header before tax or fee.
:Total Order Additional Allowance Amount
:Field UID: ORD- 0058-The sum of all the allowances at the order header before tax or fee.
:UN/CEFACT
:NA

po_total_order_additional_charge_amount
string or null (Total Order Additional Charge Amount)

:Field UID: ORD- 0057-The sum of all the charges at the order header before tax or fee.
:Total Order Additional Charge Amount
:Field UID: ORD- 0057-The sum of all the charges at the order header before tax or fee.
:UN/CEFACT
:NA

po_total_order_amount
string or null (Total Order Amount)

:Field UID: ORD- 0061-The total amount of the order, being the sum of total order line amount, total additional amounts and total tax fee amount.
:Total Order Amount
:Field UID: ORD- 0061-The total amount of the order, being the sum of total order line amount, total additional amounts and total tax fee amount.
:UN/CEFACT
:NA

po_total_amount
string or null (Total Amount)

:Field UID: ORD- 0056-The value of the total order expressed in the order currency. Is also used as an alternative for the price.
:Total Amount
:Field UID: ORD- 0056-The value of the total order expressed in the order currency. Is also used as an alternative for the price.
:UN/CEFACT
:NA

po_total_quantity
string or null (Total Quantity)

:Field UID: ORD- 0132-The value of the total order line quantity.
:Total Quantity
:Field UID: ORD- 0132-The value of the total order line quantity.
:UN/CEFACT
:NA

po_total_tax_fee_amount
string or null (Total Tax Fee Amount)

:Field UID: ORD- 0060-The sum of all tax and fee amounts.
:Total Tax Fee Amount
:Field UID: ORD- 0060-The sum of all tax and fee amounts.
:UN/CEFACT
:NA

po_total_taxable_amount
string or null (Total Taxable Amount)

:Field UID: ORD- 0059-The total amount subject to tax or fee.
:Total Taxable Amount
:Field UID: ORD- 0059-The total amount subject to tax or fee.
:UN/CEFACT
:NA

po_transport_mode
string or null (Transport Mode)

:Field UID: ORD- 0126-The code specifying the mode of transport.
:Transport Mode
:Field UID: ORD- 0126-The code specifying the mode of transport.
:UN/CEFACT
:NA

Array of objects or null (Purchase Order Attachment)

:Purchase Order Attachment
:Purchase Order Attachment
:Purchase Order Attachment
:NA
:NA

{
  • "po_additional_document_reference": "string",
  • "po_allowance_and_charge": "string",
  • "po_assets_expense_account": "string",
  • "po_blanket_order_reference": "string",
  • "po_buyer": "string",
  • "po_carrier": "string",
  • "po_confirmed_earliest_schedule_date": "2019-08-24",
  • "po_confirmed_latest_schedule_date": "2019-08-24",
  • "po_confirmed_schedule_date": "2019-08-24",
  • "po_consignee": "string",
  • "po_consignee_agent": "string",
  • "po_consignee_order_reference": "string",
  • "po_cost_assignment_reference": "string",
  • "po_country_final_destination": "string",
  • "po_customer_accountant": "string",
  • "po_customer_reference": "string",
  • "po_customs_certificate_reference": "string",
  • "po_delivery_document_reference": "string",
  • "po_delivery_instruction": "string",
  • "po_delivery_instruction_description": "string",
  • "po_despatch_document_note": "string",
  • "po_despatch_period": "string",
  • "po_document_information": "string",
  • "po_document_purpose": "string",
  • "po_earliest_schedule_date": "2019-08-24",
  • "po_engineering_change_reference": "string",
  • "po_export_license_reference": "string",
  • "po_import_license_reference": "string",
  • "po_invoice_currency": "string",
  • "po_invoice_currency_exchange": "string",
  • "po_invoicee": "string",
  • "po_latest_schedule_date": "2019-08-24",
  • "po_letter_of_credit_reference": "string",
  • "po_minus_delivery_quantity": "string",
  • "po_no_partial_delivery_allowed": "string",
  • "po_order_change_header": "string",
  • "po_order_currency": "string",
  • "po_order_currency_exchange": "string",
  • "po_order_details": [
    ],
  • "po_order_number_marketplace": "string",
  • "po_order_response_header": "string",
  • "po_original_order_reference": "string",
  • "po_payable_account": "string",
  • "po_payee": "string",
  • "po_payer": "string",
  • "po_payment_instructions": "string",
  • "po_payment_terms": "string",
  • "po_place_destination": "string",
  • "po_place_discharge": "string",
  • "po_plus_delivery_quantity": "string",
  • "po_price": "string",
  • "po_price_list_reference": "string",
  • "po_pricing_currency": "string",
  • "po_pricing_currency_exchange": "string",
  • "po_prior_order_change_reference": "string",
  • "po_prior_order_reference": "string",
  • "po_prior_order_response_reference": "string",
  • "po_quote_reference": "string",
  • "po_release_period": "string",
  • "po_report_reference": "string",
  • "po_request_for_quote_reference": "string",
  • "po_requisition_reference": "string",
  • "po_requisitioner": "string",
  • "po_response_reason_code": "string",
  • "po_rounding_amount": "string",
  • "po_scedule_period": "string",
  • "po_schedule_date": "2019-08-24",
  • "po_seller": "string",
  • "po_ship_from": "string",
  • "po_ship_from_location": "string",
  • "po_ship_to": "string",
  • "po_ship_to_location": "string",
  • "po_shipping_grouping_identifier": "string",
  • "po_supplier_order_identifier": "string",
  • "po_tax_currency": "string",
  • "po_tax_currency_exchange": "string",
  • "po_tax_fee_totals": "string",
  • "po_to_be_paid_amount": "string",
  • "po_total_order_additional_allowance_amount": "string",
  • "po_total_order_additional_charge_amount": "string",
  • "po_total_order_amount": "string",
  • "po_total_amount": "string",
  • "po_total_quantity": "string",
  • "po_total_tax_fee_amount": "string",
  • "po_total_taxable_amount": "string",
  • "po_transport_mode": "string",
  • "attachments": [
    ]
}

Sales Invoice

Data Element ID: sales_invoice

invoice_number
required
string (Invoice Number)

:A unique identification of the Invoice. The sequential number required in Article 226(2) of the directive 2006/112/EC [2], to uniquely identify the Invoice within the business context, time-frame, operating systems and records of the Seller. No identification scheme is to be used.
:Invoice Number
:A unique identification of the Invoice. The sequential number required in Article 226(2) of the directive 2006/112/EC [2], to uniquely identify the Invoice within the business context, time-frame, operating systems and records of the Seller. No identification scheme is to be used.
:PEPPOL
:NA

invoice_currency
required
string (Invoice Currency Code)

:The currency in which all Invoice amounts are given, except for the Total VAT amount in accounting currency. Only one currency shall be used in the Invoice, except for the VAT accounting currency code (BT-6) and the invoice total VAT amount in accounting currency (BT-111).
:Invoice Currency Code
:The currency in which all Invoice amounts are given, except for the Total VAT amount in accounting currency. Only one currency shall be used in the Invoice, except for the VAT accounting currency code (BT-6) and the invoice total VAT amount in accounting currency (BT-111).
:PEPPOL
:NA

invoice_unit_currency
required
string (Currency Unit)

:Mandatory attribute. Use BT-5 or BT-6.
:Currency Unit
:Mandatory attribute. Use BT-5 or BT-6.
:PEPPOL
:NA

invoice_date
string or null <date> (Invoice Issue Date)

:The date when the Invoice was issued. Format "YYYY-MM-DD"
:Invoice Issue Date
:The date when the Invoice was issued. Format "YYYY-MM-DD"
:PEPPOL
:NA

invoice_terms
string or null (Payment Terms)

:A textual description of the payment terms that apply to the amount due for payment (Including description of possible penalties). In case the Amount due for payment (BT-115) is positive, either the Payment due date (BT-9) or the Payment terms (BT-20) shall be present.
:Payment Terms
:A textual description of the payment terms that apply to the amount due for payment (Including description of possible penalties). In case the Amount due for payment (BT-115) is positive, either the Payment due date (BT-9) or the Payment terms (BT-20) shall be present.
:PEPPOL
:NA

invoice_date_due
string or null <date> (Payment Due Date)

:The date when the payment is due.Format "YYYY-MM-DD". In case the Amount due for payment (BT-115) is positive, either the Payment due date (BT-9) or the Payment terms (BT-20) shall be present.
:Payment Due Date
:The date when the payment is due.Format "YYYY-MM-DD". In case the Amount due for payment (BT-115) is positive, either the Payment due date (BT-9) or the Payment terms (BT-20) shall be present.
:PEPPOL
:NA

invoice_seller_company_name
string or null (Seller Trading Name)

:A name by which the Seller is known, other than Seller name (also known as Business name).
:Seller Trading Name
:A name by which the Seller is known, other than Seller name (also known as Business name).
:PEPPOL
:NA

invoice_seller_company_address
string or null (Seller Postal Address)

:A group of business terms providing information about the address of the Seller. Sufficient components of the address are to be filled to comply with legal requirements.
:Seller Postal Address
:A group of business terms providing information about the address of the Seller. Sufficient components of the address are to be filled to comply with legal requirements.
:PEPPOL
:NA

invoice_buyer_company_name
string or null (Buyer Trading Name)

:A name by which the Buyer is known, other than Buyer name (also known as Business name).
:Buyer Trading Name
:A name by which the Buyer is known, other than Buyer name (also known as Business name).
:PEPPOL
:NA

invoice_buyer_company_address
string or null (Buyer Postal Address)

:A group of business terms providing information about the postal address for the Buyer. Sufficient components of the address are to be filled to comply with legal requirements.
:Buyer Postal Address
:A group of business terms providing information about the postal address for the Buyer. Sufficient components of the address are to be filled to comply with legal requirements.
:PEPPOL
:NA

invoice_project_name
string or null (Project Name)

:The identification of the project the invoice refers to.
:Project Name
:The identification of the project the invoice refers to.
:NA
:NA

invoice_project_description
string or null (Project Description)

:Description of the project for which goods and services in the invoice are provided
:Project Description
:Description of the project for which goods and services in the invoice are provided
:NA
:NA

invoice_customer_no
string or null (Buyer Identifier)

:An identifier of the Buyer.
:Buyer Identifier
:An identifier of the Buyer.
:PEPPOL
:NA

invoice_gross_amount
number or null <double> (Sum Of Charges On Document Level)

:Sum of all charges on document level in the Invoice. Must be rounded to maximum 2 decimals.
:Sum Of Charges On Document Level
:Sum of all charges on document level in the Invoice. Must be rounded to maximum 2 decimals.
:PEPPOL
:NA

invoice_discount_amount
number or null <double> (Sum Of Allowances On Document Level)

:Sum of all allowances on document level in the Invoice. Must be rounded to maximum 2 decimals.
:Sum Of Allowances On Document Level
:Sum of all allowances on document level in the Invoice. Must be rounded to maximum 2 decimals.
:PEPPOL
:NA

invoice_tax_amount
number or null <double> (Invoice Total Vat Amount In Accounting Currency)

:The total VAT amount for the Invoice or the VAT total amount expressed in the accounting currency accepted or required in the country of the Seller. Must be rounded to maximum 2 decimals
:Invoice Total Vat Amount In Accounting Currency
:The total VAT amount for the Invoice or the VAT total amount expressed in the accounting currency accepted or required in the country of the Seller. Must be rounded to maximum 2 decimals
:PEPPOL
:NA

invoice_net_amount
number or null <double> (Amount Due For Payment)

:The outstanding amount that is requested to be paid. Must be rounded to maximum 2 decimals.
:Amount Due For Payment
:The outstanding amount that is requested to be paid. Must be rounded to maximum 2 decimals.
:PEPPOL
:NA

Array of objects or null (Item Details)

:Line-level details within Invoice
:Item Details
:Line-level details within Invoice
:NA
:NA

invoice_transport_details
string or null (Item Description)

:A description for an item.The item description allows for describing the item and its features in more detail than the Item name.
:Item Description
:A description for an item.The item description allows for describing the item and its features in more detail than the Item name.
:PEPPOL
:NA

invoice_transport_number
string or null (Despatch Advice Reference)

:An identifier of a referenced despatch advice.
:Despatch Advice Reference
:An identifier of a referenced despatch advice.
:PEPPOL
:NA

invoice_transportation_date
string or null <date> (Actual Delivery Date)

:The date on which the supply of goods or services was made or completed. Format = "YYYY-MM-DD"
:Actual Delivery Date
:The date on which the supply of goods or services was made or completed. Format = "YYYY-MM-DD"
:PEPPOL
:NA

invoice_delivery_from
string or null (Item Country Of Origin)

:The code identifying the country from which the item originates.
:Item Country Of Origin
:The code identifying the country from which the item originates.
:PEPPOL
:NA

invoice_delivery_to
string or null (Deliver To Address)

:A group of business terms providing information about the address to which goods and services invoiced were or are delivered.
:Deliver To Address
:A group of business terms providing information about the address to which goods and services invoiced were or are delivered.
:PEPPOL
:NA

invoice_fda_registration_number
string or null (Fda Registration Number )

:Unique FDA identifier of referenced bill of lading
:Fda Registration Number
:Unique FDA identifier of referenced bill of lading
:NA
:NA

invoice_certification_number
string or null (Certification Number )

:Certification number of invoiced goods
:Certification Number
:Certification number of invoiced goods
:NA
:NA

invoice_supplier_name
string or null (Seller Trading Name)

:A name by which the Seller is known, other than Seller name (also known as Business name).
:Seller Trading Name
:A name by which the Seller is known, other than Seller name (also known as Business name).
:PEPPOL
:NA

invoice_supplier_address
string or null (Seller Postal Address)

:A group of business terms providing information about the address of the Seller. Sufficient components of the address are to be filled to comply with legal requirements.
:Seller Postal Address
:A group of business terms providing information about the address of the Seller. Sufficient components of the address are to be filled to comply with legal requirements.
:PEPPOL
:NA

invoice_tt_beneficiary_name
string or null (Payee Name)

:The name of the Payee.
:Payee Name
:The name of the Payee.
:PEPPOL
:NA

invoice_tt_beneficiary_address
string or null (Address Of Beneficiary / Supplier (Tt) )

:Address of beneficiary
:Address Of Beneficiary / Supplier (Tt)
:Address of beneficiary
:NA
:NA

invoice_tt_beneficiary_account_number
string or null (Payment Account Identifier)

:A unique identifier of the financial payment account, at a payment service provider, to which payment should be made. Such as IBAN or BBAN.
:Payment Account Identifier
:A unique identifier of the financial payment account, at a payment service provider, to which payment should be made. Such as IBAN or BBAN.
:PEPPOL
:NA

invoice_tt_beneficiary_bank_name
string or null (Payment Account Name)

:The name of the payment account, at a payment service provider, to which payment should be made.
:Payment Account Name
:The name of the payment account, at a payment service provider, to which payment should be made.
:PEPPOL
:NA

invoice_tt_beneficiary_bank_address
string or null (Address Of Beneficiary Bank (TT) )

:Address of beneficiary bank
:Address Of Beneficiary Bank (TT)
:Address of beneficiary bank
:NA
:NA

invoice_tt_beneficiary_receiving_agent
string or null (Receiving Agent Of Beneficiary Bank (TT) )

:Receiving Agent of Beneficiary's bank
:Receiving Agent Of Beneficiary Bank (TT)
:Receiving Agent of Beneficiary's bank
:NA
:NA

invoice_co_beneficiary_name
string or null (Payee Name)

:The name of the Payee.
:Payee Name
:The name of the Payee.
:PEPPOL
:NA

invoice_co_beneficiary_account_name
string or null (Payment Account Identifier)

:A unique identifier of the financial payment account, at a payment service provider, to which payment should be made. Such as IBAN or BBAN.
:Payment Account Identifier
:A unique identifier of the financial payment account, at a payment service provider, to which payment should be made. Such as IBAN or BBAN.
:PEPPOL
:NA

invoice_co_beneficiary_account_number
string or null (Payment Account Name)

:The name of the payment account, at a payment service provider, to which payment should be made.
:Payment Account Name
:The name of the payment account, at a payment service provider, to which payment should be made.
:PEPPOL
:NA

invoice_co_other_instructions
string or null (Payment Means Text)

:The means, expressed as text, for how a payment is expected to be or has been settled.
:Payment Means Text
:The means, expressed as text, for how a payment is expected to be or has been settled.
:PEPPOL
:NA

Array of objects or null (Sales Invoice Attachment)

:Sales Invoice Attachment
:Sales Invoice Attachment
:Sales Invoice Attachment
:NA
:NA

{
  • "invoice_number": "string",
  • "invoice_currency": "string",
  • "invoice_unit_currency": "string",
  • "invoice_date": "2019-08-24",
  • "invoice_terms": "string",
  • "invoice_date_due": "2019-08-24",
  • "invoice_seller_company_name": "string",
  • "invoice_seller_company_address": "string",
  • "invoice_buyer_company_name": "string",
  • "invoice_buyer_company_address": "string",
  • "invoice_project_name": "string",
  • "invoice_project_description": "string",
  • "invoice_customer_no": "string",
  • "invoice_gross_amount": 0.1,
  • "invoice_discount_amount": 0.1,
  • "invoice_tax_amount": 0.1,
  • "invoice_net_amount": 0.1,
  • "invoice_item_details": [
    ],
  • "invoice_transport_details": "string",
  • "invoice_transport_number": "string",
  • "invoice_transportation_date": "2019-08-24",
  • "invoice_delivery_from": "string",
  • "invoice_delivery_to": "string",
  • "invoice_fda_registration_number": "string",
  • "invoice_certification_number": "string",
  • "invoice_supplier_name": "string",
  • "invoice_supplier_address": "string",
  • "invoice_tt_beneficiary_name": "string",
  • "invoice_tt_beneficiary_address": "string",
  • "invoice_tt_beneficiary_account_number": "string",
  • "invoice_tt_beneficiary_bank_name": "string",
  • "invoice_tt_beneficiary_bank_address": "string",
  • "invoice_tt_beneficiary_receiving_agent": "string",
  • "invoice_co_beneficiary_name": "string",
  • "invoice_co_beneficiary_account_name": "string",
  • "invoice_co_beneficiary_account_number": "string",
  • "invoice_co_other_instructions": "string",
  • "attachments": [
    ]
}

External Transport Document

etd_type
required
string (External Transport Document Type)
Enum: "Ocean BOL" "Others"

:The classification of the uploaded transport document based on its mode of transport, such as Ocean Bill of Lading (BOL) or Others.
:External Transport Document Type
:The classification of the uploaded transport document based on its mode of transport, such as Ocean Bill of Lading (BOL) or Others.
:UN/CEFACT
:Enum: "Ocean BOL", "Others"

etd_bl_type
string or null (External BL Type)
Enum: "To Order" "Bearer" null

:Defines negotiability type of the Bill of Lading. Applicable if Document Type is "Ocean BOL".
:External BL Type
:Defines negotiability type of the Bill of Lading. Applicable if Document Type is "Ocean BOL".
:ICC Uniform Customs & Practice for Documentary Credits (UCP 600)
:Enum: "To Order", "Bearer"

etd_reference_number
required
string (External Reference Number)

:Unique identifier assigned to the transport document by the issuing carrier or forwarder.
:External Reference Number
:Unique identifier assigned to the transport document by the issuing carrier or forwarder.
:ISO 15459-1
:Alphanumeric, Length: 8-35

etd_notice
required
string (Notice)

:Notice of a TradeTrust eBL
:Notice
:Notice of a TradeTrust eBL
:NA
:NA

etd_model_terms
required
string (Model Terms)

:Model Terms of a TradeTrust eBL
:Model Terms
:Model Terms of a TradeTrust eBL
:NA
:NA

required
object (Transport Document PDF)

:The original transport document in PDF format.
:Transport Document PDF
:The original transport document in PDF format.
:NA
:Must be in .pdf format, Max File Size: 5MB

Array of objects (External Transport Document Attachment)

:External Transport Document Attachment
:External Transport Document Attachment
:External Transport Document Attachment
:NA
:Accepted Formats: .pdf, .jpg, .png, .xlsx, .csv; Max Size: 5MB per file

{
  • "etd_type": "Ocean BOL",
  • "etd_bl_type": "To Order",
  • "etd_reference_number": "string",
  • "etd_notice": "string",
  • "etd_model_terms": "string",
  • "etd_transport_doc_pdf": {
    },
  • "attachments": [
    ]
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

:Note
:Note
:Note
:NA
:NA

Array of objects or null (Other Documents Attachment)

:Other Documents Attachment
:Other Documents Attachment
:Other Documents Attachment
:NA
:NA

{
  • "note": "string",
  • "attachments": [
    ]
}

Use Case H (Parameters)

Parameter schemas for Use Case H

Certificate Of Origin

Data Element ID: certificate_of_origin

bol_no
required
string (Bill of Lading / Transport Contract Document Number)

Reference number to identify a document evidencing a transport contract

coo_origin_country
required
string (Origin Country)

Name of the country in which the goods have been produced or manufactured, according to criteria laid down for the application of the Customs tariff or quantitative restrictions, or any measure related to trade.

{
  • "bol_no": "string",
  • "coo_origin_country": "string"
}

DCSA Electronic Bill Of Lading

Data Element ID: ebl_dcsa

bol_ref
required
string (Bill of Lading Reference Number)

A unique number allocated by the shipping line to the transport document and the main number used for the tracking of the status of the shipment.

{
  • "bol_ref": "string"
}

Delivery Order

Data Element ID: delivery_order

do_number
required
string (Delivery Order Number)

Unique identifier for invoice referred in delivery order

do_invoice_number
string or null (Invoice Number )

Unique identifier for delivery order

{
  • "do_number": "string",
  • "do_invoice_number": "string"
}

Electronic Bill of Lading

Data Element ID: ebl

ebl_reference
string or null (Electronic Bill of Lading Reference)

Document Reference Number

{
  • "ebl_reference": "string"
}

Inspection Certificate

Data Element ID: inspection_certificate

ic_reference_number
required
string (Inspection Certificate Reference Number)

Unique reference number for Inspection Certificate

{
  • "ic_reference_number": "string"
}

Invoice Finance Application

Data Element ID: invoice_finance_application

ifa_application_id
required
string (Trade Financing Application Id)

Unique application reference number

{
  • "ifa_application_id": "string"
}

Invoice Finance Response

Data Element ID: invoice_finance_response

ifr_transaction_reference_number
string or null (Transaction Reference Number )

Transaction Reference Number

{
  • "ifr_transaction_reference_number": "string"
}

Letter Of Credit

Data Element ID: letter_of_credit

lc_dt_of_issue
required
string <date> (Lc Doc Lc No)
{
  • "lc_dt_of_issue": "2019-08-24"
}

Letter Of Credit Application

Data Element ID: letter_of_credit_application

lca_date
required
string <date> (Date)

Date of document

{
  • "lca_date": "2019-08-24"
}

Purchase Order

Data Element ID: purchase_order

po_buyer
string or null (Buyer)

Field UID: ORD- 0011-The entity contains the details of the buyer.

{
  • "po_buyer": "string"
}

Sales Invoice

Data Element ID: sales_invoice

invoice_number
required
string (Invoice Number)

A unique identification of the Invoice. The sequential number required in Article 226(2) of the directive 2006/112/EC [2], to uniquely identify the Invoice within the business context, time-frame, operating systems and records of the Seller. No identification scheme is to be used.

{
  • "invoice_number": "string"
}

External Transport Document

etd_type
required
string (External Transport Document Type)
Enum: "Ocean BOL" "Others"

The classification of the uploaded transport document based on its mode of transport, such as Ocean Bill of Lading (BOL) or Others.

etd_bl_type
string or null (External BL Type)
Enum: "To Order" "Bearer" null

Defines negotiability type of the Bill of Lading. Applicable if Document Type is "Ocean BOL".

etd_reference_number
required
string (External Reference Number)

Unique identifier assigned to the transport document by the issuing carrier or forwarder.

{
  • "etd_type": "Ocean BOL",
  • "etd_bl_type": "To Order",
  • "etd_reference_number": "string"
}

Other Documents

Data Element ID: other_documents

note
required
string (Note)

Note

{
  • "note": "string"
}