House Bill of Lading (HBL)

Field Reference

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

Party Information

Field Label

Handlebars Field

Mapping / Description

Shipper

{{shipperName}}

Name of the actual shipper (from partnerActShipper.printName)


{{shipperAddress}}

Shipper’s address (partnerActShipper.printAddress)

Consignee

{{consigneeName}}

Consignee name (partnerConsignee.printName)


{{consigneeAddress}}

Consignee address (partnerConsignee.printAddress)

Notify Party

{{notifyName}}

Notify party name (partnerNotify.printName)


{{notifyAddress}}

Notify party address (partnerNotify.printAddress)

Delivery Agent

{{deliveryAgentName}}

Name of agent at destination


{{deliveryAgentAddress}}

Address of delivery agent


Bill of Lading & Document Metadata

Field Label

Handlebars Field

Mapping / Description

B/L Number

{{blNo}}

House Bill of Lading number (houseBillofLadingNo)

Document Type

{{#if isOriginal}}...

Chooses between ORIGINAL, SEAWAY BILL, or NON NEGOTIABLE based on:
- isOriginal = true → "ORIGINAL"
- isExpressBL = true → "SEAWAY BILL"
- isSurrenderBL = true → "NON NEGOTIABLE"

Company Name

{{companyName}}

User’s company name

Company Logo

{{companyLogoUrl}}

URL to display company logo


Routing & Shipment Details

Field Label

Handlebars Field

Mapping / Description

Vessel / Voyage No.

{{vesselVoyageNo}}

Concatenated from vesselName + voyageNo

Port of Loading

{{portOfLoading}}

From loadingPort.name in HBL routing

Port of Discharge

{{portOfDischarge}}

From dischargePort.name

Final Destination

{{finalDestination}}

From delivery details or post-carriage routing

Place of Receipt

{{placeOfAcceptance}}

Starting point of combined transport

Place of Delivery

{{placeOfDelivery}}

Final delivery location

Freight Payable At

{{payableAt}}

"DESTINATION" if freightCharges = collect, otherwise origin

No. of Original B/L

{{noOfOriginalBl}}

"THREE (3)" or "ZERO (0)" depending on isSurrenderBL

Shipped On Board Date

{{shippedOnBoardDate}}

Formatted date from onBoardDate

Signed At

{{signedAt}}

Location of issuance

Signed Date

{{signedDate}}

Issuance date of document


Cargo & Container Details

Field Label

Handlebars Field

Mapping / Description

Marks and Numbers

{{mark}}

Free text cargo marking (hbl.mark)

Description of Goods

{{descOfGoods}}

Text description (hbl.description)

Gross Weight

{{grossWeightValue}} {{grossWeigtUom}}

Summed from all containers or packages

Net Weight (if shown)

{{netWeightValue}} {{netWeightUom}}

Calculated from itemized commodities

Measurement (Volume)

{{measurementValue}} {{measurementUom}}

Summed CBM or CFT

Container/Seal Nos.

{{containerOrSealNo}}

Combined string of container numbers and seal numbers

Type of Service

{{typeOfService}}

e.g., "CY/CY", "CFS/CFS", etc. from serviceTermFrom and serviceTermTo

Packages

{{packages}}

Loop over { container, package } pairs. Shows either total packages or container grouping

Total in Words

{{totalContainerInWords}}

Number of containers or packages expressed in words (e.g., “ONE HUNDRED PKGS ONLY”)

Container Breakdown Table

{{containerInfos}}

Table of: containerNo, seal, type, weight, volume, package unit

Console Ref. / Reference

{{consigneeRefNo}}

Consignee or customer-provided reference


Commercial & Financial Fields

Field Label

Handlebars Field

Mapping / Description

Freight Charges

{{freightCharges}}

“Prepaid” or “Collect” from hbl.freightCharges

Incoterm

{{incoterm}}

From incoterm entity (e.g., FOB, DAP, CIF)

Goods Notes

{{goodsNotes}}

List of tags like “FREIGHT PREPAID”, “B/L SURRENDERED IN SINGAPORE”

Note (Cargo Statement)

{{note}}

If shipmentMode = FCL → “Shipper load, stow, and count”
Else if LCL → “Said to contain”


Conditional Logic Summary

Condition

Effect on Template

isOriginal = true

Shows “ORIGINAL” in doc type

isExpressBL = true

Shows “SEAWAY BILL”

isSurrenderBL = true

Shows “NON NEGOTIABLE”

shipmentMode = LCL

Show package list instead of container grouping

showAttachments = true

Hides inline details and shows “As per attachment” label

freightCharges = "collect"

Payable at destination

freightCharges = "prepaid"

Payable at origin