Bill of Lading
Structured extraction preset for ocean, air, rail, and multimodal bills of lading. Captures shipper/consignee details, cargo manifest, transport routing, and freight charges with full FOB/CIF/INCOTERM support.
curl -X POST $XBERG_ENTERPRISE_URL/v1/extract \ -H "Authorization: Bearer $XBERG_API_KEY" \ -F file=@your-bill_of_lading.pdf \ -F 'preset=bill_of_lading'
Structured fields extracted by this preset
bol_numberstringrequiredUnique bill of lading number, exactly as printed on the document.
booking_numberstringBooking reference number for the carrier.
bill_typestringrequiredType of bill of lading (ocean/air/rail/road/multimodal/master/house/straight/order/sea_waybill).
issue_datestringrequiredDate bill of lading was issued (ISO-8601).
shipperobjectrequirednamestringrequiredShipper company name, exactly as printed.
addressstringShipper full address including street, city, state, postal code, country.
contact_phonestringShipper contact telephone number.
tax_idstringShipper tax identification number (VAT/EIN/equivalent).
consigneeobjectrequirednamestringrequiredConsignee company name, exactly as printed.
addressstringConsignee full address including street, city, state, postal code, country.
contact_phonestringConsignee contact telephone number.
notify_partyobjectcarrierobjectport_of_loadingstringPort/airport/terminal of loading, exactly as printed.
port_of_dischargestringPort/airport/terminal of discharge, exactly as printed.
place_of_receiptstringPlace where goods are received by carrier.
place_of_deliverystringFinal destination place of delivery.
transport_modestringPrimary transport mode (sea/air/rail/road/multimodal).
incotermsstringIncoterms 2020 code (EXW, FCA, CPT, CIP, DAP, DPU, DDP, FAS, FOB, CFR, CIF, other).
freight_paymentstringFreight payment method (prepaid/collect/third_party).
cargoarray<object>requiredArray of cargo line items.
total_packagesintegerTotal package count (must be an integer).
total_gross_weight_kgnumberTotal gross weight in kilograms.
total_volume_cbmnumberTotal volume in cubic meters.
currencystringISO 4217 currency code (e.g., USD, EUR, GBP).
freight_chargesarrayArray of freight and ancillary charges.
total_freightnumberTotal freight and charges amount.
signaturesobjectConfiguration
Call Mode
text_plus_visionCitations
EnabledVersion
v1Tags
+System Prompt
Extract bill of lading details from the provided document. Record ports, locations, and addresses exactly as printed. Convert all package counts, weights, and dimensions to integers where specified. For cargo line items, capture marks and numbers verbatim, package counts as integers, and weights/volumes as numbers. Ensure shipper and consignee names are transcribed precisely. Include carrier details (vessel name, voyage, flight, or container numbers) if present. Capture freight charges and payment terms. Do not infer or supply missing data—only extract what is explicitly shown.