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 |
| Name of the actual shipper (from |
| Shipper’s address ( | |
Consignee |
| Consignee name ( |
| Consignee address ( | |
Notify Party |
| Notify party name ( |
| Notify party address ( | |
Delivery Agent |
| Name of agent at destination |
| Address of delivery agent |
Bill of Lading & Document Metadata
Field Label | Handlebars Field | Mapping / Description |
|---|---|---|
B/L Number |
| House Bill of Lading number ( |
Document Type |
| Chooses between |
Company Name |
| User’s company name |
Company Logo |
| URL to display company logo |
Routing & Shipment Details
Field Label | Handlebars Field | Mapping / Description |
|---|---|---|
Vessel / Voyage No. |
| Concatenated from |
Port of Loading |
| From |
Port of Discharge |
| From |
Final Destination |
| From delivery details or post-carriage routing |
Place of Receipt |
| Starting point of combined transport |
Place of Delivery |
| Final delivery location |
Freight Payable At |
| "DESTINATION" if |
No. of Original B/L |
| "THREE (3)" or "ZERO (0)" depending on |
Shipped On Board Date |
| Formatted date from |
Signed At |
| Location of issuance |
Signed Date |
| Issuance date of document |
Cargo & Container Details
Field Label | Handlebars Field | Mapping / Description |
|---|---|---|
Marks and Numbers |
| Free text cargo marking ( |
Description of Goods |
| Text description ( |
Gross Weight |
| Summed from all containers or packages |
Net Weight (if shown) |
| Calculated from itemized commodities |
Measurement (Volume) |
| Summed CBM or CFT |
Container/Seal Nos. |
| Combined string of container numbers and seal numbers |
Type of Service |
| e.g., "CY/CY", "CFS/CFS", etc. from |
Packages |
| Loop over |
Total in Words |
| Number of containers or packages expressed in words (e.g., “ONE HUNDRED PKGS ONLY”) |
Container Breakdown Table |
| Table of: containerNo, seal, type, weight, volume, package unit |
Console Ref. / Reference |
| Consignee or customer-provided reference |
Commercial & Financial Fields
Field Label | Handlebars Field | Mapping / Description |
|---|---|---|
Freight Charges |
| “Prepaid” or “Collect” from |
Incoterm |
| From incoterm entity (e.g., FOB, DAP, CIF) |
Goods Notes |
| List of tags like “FREIGHT PREPAID”, “B/L SURRENDERED IN SINGAPORE” |
Note (Cargo Statement) |
| If |
Conditional Logic Summary
Condition | Effect on Template |
|---|---|
| Shows “ORIGINAL” in doc type |
| Shows “SEAWAY BILL” |
| Shows “NON NEGOTIABLE” |
| Show package list instead of container grouping |
| Hides inline details and shows “As per attachment” label |
| Payable at destination |
| Payable at origin |