Booking Confirmation V.2

This section explains each field in the Booking Confirmation document and how it is populated from the system’s data. Use this table to understand what appears on the document and why.

Field Documentation

Party and Shipment Information

Field Label

Description

Handlebars Field

Mapping / Description

To

The customer receiving the booking confirmation, including their address, contact details, and attention person. Mapped to Customer on the system.

{{ customerName }}, {{ customerPrintAddress }}, {{ tel }}, {{ fax }}

Customer name from shipmentHBLDetail.partnerCustomer.printName
Customer address from shipmentHBLDetail.partnerCustomer.printAddress
Phone number formatted as (+[countryCode]) [phoneNo]
Fax number formatted as (+[countryCode]) [fax]
Contact person from customer's contactPeople where isRepresentative is true

Shipper

The party sending the goods. Mapped to the Actual Shipper on the system.

{{ shipperName }}

Shipper name from shipmentHBLDetail.partnerActShipper.printName

Job No

Unique identifier of the shipment. Mapped to the Job No on the system.

{{ jobNo }}

Shipment number from shipmentBL.shipmentNo

Booking Date

When the booking was created. Mapped to shipment’s created date.

{{ bookingDate }}

Formatted date from shipmentBL.createdAt

Booking Ref No

Reference number for this specific booking. Mapped to MBL No on the shipment.

{{ bookingNo }}

Bill of Lading number from shipmentBL.billofLadingNo

Carrier Bkg Ref. No

Reference number for this specific booking. Mapped to Booking No on the shipment.

{{ carrierBookingNo }}

For Ocean Import: shipmentBL.partnerBLAcctCarrierRefNo<br>For Ocean Export: shipmentBL.carrierBookingNo

Cargo Type

Classification of the cargo (e.g., General, Dangerous Goods) mapped to Cargo Type on the shipment.

{{ cargoType }}

Cargo type from shipmentHBLDetail.cargoType.name

Commodity

The name of the commodity being shipped. Mapped to Commodity Name on the shipment.

{{ commodity }}

Joined list of commodity names from shipmentHBLDetail.shipmentHBLCommodities[].commodityName

Container Qty/Type

Number and type of containers (e.g., 1000 X 20GP means 1000 twenty-foot general purpose containers)

{{ containerQtyAndType }}

Joined list of container quantities and types from shipmentHBLDetail.shipmentHBLContainers

Cargo Details

Additional information about the cargo: contain total of package, weight, and measurement. Mapped to the total on Container List on the system.

{{{ cargoDetails }}}

HTML-formatted list of package details including package value, UOM, weight, and measurement


Shipment & Routing Info

Field Label

Description

Handlebars Field

Mapping / Description

Feeder Vessel

  • For Ocean Export: if there's Main Carriage and Post Carriage, the Feeder Vessel will be taken from Main Carriage.

  • For Ocean Import: if there's Pre Carriage and Main Carriage, the Feeder Vessel will be taken from Main Carriage.

  • If there’s only Main Carriage, then the Feeder Vessel will be empty and only the Mother Vessel will be filled in.

{{ feederVesselVoyage }}

For Ocean Export with Post-Carriage: Main Carriage vessel name + voyage<br>For Ocean Import with Pre-Carriage: Main Carriage vessel name + voyage<br>Format: [vesselName] V.[voyageNo]

Mother Vessel

  • For Ocean Export: if there's Main Carriage and Post Carriage, the Mother Vessel will be taken from Post Carriage.

  • For Ocean Import: if there's Pre Carriage and Main Carriage, the Mother Vessel will be taken from Pre Carriage

  • If there’s only Main Carriage, then the Main Carriage will be the Mother Vessel

{{ motherVesselVoyage }}

For Ocean Export with Post-Carriage: Post Carriage vessel name + voyage<br>For Ocean Import with Pre-Carriage: Pre Carriage vessel name + voyage<br>If only Main Carriage: Main Carriage vessel name + voyage

Place of Receipt

Location where the goods are initially received. Mapped to Place of Receipt in Main Carriage on the system.

{{ placeOfReceipt }}

Place of receipt from isMainCarriage.placeOfReceipt

S/Agent

Shipping Agent handling the shipment. This field is mapped to Carrier in Main Carriage on the system.

{{ shippingAgentName }}

Carrier name from isMainCarriage.partnerCarrier.printName

S/Agent Code

Code identifying the shipping agent. This field is mapped to Shipping Agent Code in Main Carriage on the system.

{ shippingAgentCode }}

Shipping agent code from isMainCarriage.shippingAgentCode

Vessel ID

Unique identifier for the vessel. This field is mapped to Vessel ID in Main Carriage on the system.

{{ vesselCodeId }}

Vessel ID from isMainCarriage.vesselCodeId

SCN

Shipment Call Number (SCN), this field mapped to Shipment Call Number (SCN) in Main Carriage on the system.

{{ scn }}

Shipment Call Number from isMainCarriage.scn

Port of Loading (POL)

The port where cargo is loaded onto the vessel. This field is mapped to Port of Loading in Main Carriage on the system.

{{ portOfLoading }}

For Pre-Carriage: Pre-Carriage loading port<br>Otherwise: Main Carriage loading port<br>Format: [portName], [city], [country]

T/S Port

Transshipment port where cargo is transferred between Vessels. This field is mapped to Post Carriage’s loading port leg.

{{ transitPort }}

For Ocean: Post-Carriage loading port if exists<br>For Air: First transit point from hblMainRoutingTransits[0].routingPort.name

Port of Discharged (POD)

The port where cargo will be unloaded. This field is mapped to Port of Discharged in Main Carriage on the system.

{{ portOfDischarge }}

For Post-Carriage: Post-Carriage discharge port<br>Otherwise: Main Carriage discharge port<br>Format: [portName], [city], [country]

Final Destination

Ultimate destination of the shipment. This field is mapped to the last leg of the shipment.

  • If there’s Post Carriage, then it will be mapped to the last leg of the Post Carriage.

  • If there’s Delivery (Trucking) leg, then it will be mapped to the last leg of the Delivery.

{{ finalDestination }}

For Post-Carriage: Post-Carriage discharge port<br>Otherwise: Main Carriage discharge port<br>Format: [portName], [city]


Other Information

Field Label

Description

Handlebars Field

Mapping / Description

Port Terminal

The specific terminal at the port where operations will take place. This field is mapped Terminal in MBL Port of Loading Main Carriage.

{{ terminal }}

Terminal from blMainCarriage.loadingPortTerminal

Opening Time

When the terminal opens for this shipment. This field is mapped to Terminal Opening Time in Main Carriage.



Closing Time

Deadline for delivering cargo to the terminal. This field is mapped to Terminal Closing Time in Main Carriage.



VGM Cut Off Time

Deadline for submitting Verified Gross Mass information. This field is mapped to VGM Cut-off Time in Main Carriage.

{{ cutOffTime }}

Formatted date/time from isMainCarriage.cutOffDateTime

SI / Docs Cut Off Time

Deadline for submitting Shipping Instructions and documentation. This field is mapped to Doc. Closing Datetime in Main Carriage.

{{ siDocsSubmissionDate }}

Formatted date/time from isMainCarriage.docClosingDateTime

Empty Container Pick-up Location

Where to collect empty containers before loading. This field is mapped to Empty Container Location in the pick-up leg.

{{ emptyPickupPartner }}

Partner name from pickup.partnerEmptyPickup.printName

Stuffing Warehouse – For LCL Cargo

For LCL cargo, the Container Freight Station where goods will be consolidated. This field is mapped to Warehouse (CFS) on the MBL level.

{{ stuffWarehouse }}
{{ stuffWarehouseAddress }}
{{ stuffWarehouseTel }}
{{ stuffWarehouseFax }}
{{ stuffWarehouseAttention }}

For Ocean Import & LCL: shipmentBL.partnerCFS.printName<br>Otherwise: shipmentHBLDetail.doReleasedTo.printName
Address of the stuffing warehouse
Phone number of the stuffing warehouse

Fax number of the stuffing warehouse

Contact person at the stuffing warehouse