Kuehne + Nagel LTL+
  1. BillOfLading
Kuehne + Nagel LTL+
  • Overview
    • Introduction
    • Acceptable Use Policy
    • Support & Feedback
  • API
    • Overview
    • Full Integration API Workflow
    • Accessorials
      • Accessorial - Retrieve all accessorial charge codes
    • BillOfLading
      • BOL - Create a bill of lading PDF
        POST
    • Quoting
      • RateQuote - Submit a quote request
      • RateQuote - Submit a quote request for multiple points
    • Document Retrieval
      • GetImageList - Retrieve list of available shipment documents
      • GetImage - Retrieve shipping documents based on DocumentID
    • Invoice
      • Invoice - Retrieve a single invoice or pull an entire week of invoices
    • Shipment Tracking
      • HTML Tracking Link Generation
      • TrackingList - Get a list of shipment tracking information
      • TrackingDetails - Retrieve all the tracking details related to a shipment
    • Load Tendering
      • LoadTender - Tender a shipment
      • LoadTender - Tender a shipment
    • Transit
      • Transit - Receive transit time for a shipment lane.
    • Orders
      • Order
      • OrderDetails
  • EDI
    • Overview
    • 210 - Freight Details and Invoice
    • 214 - Transportation Carrier Shipment Status Message
    • Segments
      • 210/214 - 0100 Location Loop (N1 Loop)
      • 210 - 0400 Detail Loop (LX Loop)
      • 214 - 0205 Shipment Status Details (AT7 Loop)
  1. BillOfLading

BOL - Create a bill of lading PDF

POST
https://api.ltlp.kuehne-nagel.com/api/billoflading/preparebilloflading
Last modified:2024-12-11 20:36:47
The BOL API endpoint is designed to create a Bill of Lading (BOL) for a shipment, which is a crucial document in the shipping process.
PRO Numbers
ProNumber is not a required field in this endpoint, and can be left blank.
Kuehne + Nagel LTL+ does not generate PRO numbers on behalf of customers.
Customers can supply their own PRO numbers, which must be issued by the carrier handling the shipment.

Input Parameters:#

User Authentication:
UserName: The username of the person or system making the request.
ClientCode: A code associated with the client.
AuthenticationId: A unique identifier for authentication.
Shipment Details:
BillOfLadingNumber: The number assigned to the Bill of Lading.
ProNumber: The shipment's Pro number (tracking number).
PONumber: The associated purchase order number.
CarrierName: The name of the carrier handling the shipment.
CarrierSCAC: The Standard Carrier Alpha Code for the carrier.
QuoteNumber: An optional quote number associated with the shipment.
ShipmentDate: The date the shipment is scheduled.
ShipperNumber, TrailerNumber, ShipperCompanyName, ShipperContactPhone, ShipperContactName, ShipperAddress, ShipperCity, ShipperState, ShipperZip: Details about the shipper.
ConsigneeName, ConsigneePhone, ConsigneeContact, ConsigneeAddress, ConsigneeCity, ConsigneeState, ConsigneeZip: Details about the consignee (recipient).
ThirdPartyName, ThirdPartyPhone, ThirdPartyContactName, ThirdPartyAddress, ThirdPartyCity, ThirdPartyState, ThirdPartyZip: Optional third-party billing details.
CustomerNumber, SpecialInstructions, StoreNumber, DepartmentNumber: Additional shipment-related information.
HazContractNUM, HazContactName, HazContactPhone: Hazardous materials information.
DeclaredValue, DeclaredValueUnitsOfMeasure: The declared value of the shipment.
CODFeeCollect, CODFeePrePaid, CODAmt, Collect, CustomerCheckNotOK, CustomerCheckOK: Cash on delivery and payment-related options.
Accessorials: A list of additional services or charges with associated ServiceCode.
Line Items: An array of items being shipped, each with:
ShippingUnits, PKGType, Description, NMFC, ClassNum, Weight, Haz: Specifics about the items.

PKGType (Package Types)#

ItemCode
BarrelBBL
BinBIN
BoxBOX
CaseCAS
ContainerCNT
CrateCRT
CartonCTN
PiecesPCS
PackagePKG
PalletPLT
SkidSKD
UnitUNT
BottleBTL
CylinderCYL
DrumDRM
PailPAL
BatteryBAT
CanisterCAN
ToteTOT

Output Structure:#

PDF: A base64-encoded string of the Bill of Lading PDF.
ShipmentLabel: A base64-encoded string of the shipment label.
BlNumber: The generated Bill of Lading number.
ShipmentLabelZpl: An array containing ZPL formatted shipment label strings for printing.
ErrorMessage: Any error messages that occur during the process.
This endpoint is essential for creating formal shipping documents, facilitating the transportation of goods.

Request

Body Params application/json

Example
{
    "UserName": "string",
    "ClientCode": "string",
    "AuthenticationId": "string",
    "BillOfLadingNumber": "string",
    "ProNumber": "string",
    "PONumber": "string",
    "CarrierName": "string",
    "CarrierSCAC": "string",
    "QuoteNumber": 0,
    "ShipmentDate": "string",
    "ShipperNumber": "string",
    "TrailerNumber": "string",
    "ShipperCompanyName": "string",
    "ShipperContactPhone": "string",
    "ShipperContactName": "string",
    "ShipperAddress": "string",
    "ShipperCity": "string",
    "ShipperState": "string",
    "ShipperZip": "string",
    "ConsigneeName": "string",
    "ConsigneePhone": "string",
    "ConsigneeContact": "string",
    "ConsigneeAddress": "string",
    "ConsigneeCity": "string",
    "ConsigneeState": "string",
    "ConsigneeZip": "string",
    "ThirdPartyName": "string",
    "ThirdPartyPhone": "string",
    "ThirdPartyContactName": "string",
    "ThirdPartyAddress": "string",
    "ThirdPartyCity": "string",
    "ThirdPartyState": "string",
    "ThirdPartyZip": "string",
    "CustomerNumber": "string",
    "SpecialInstructions": "string",
    "StoreNumber": "string",
    "DepartmentNumber": "string",
    "HazContractNUM": "string",
    "HazContactName": "string",
    "HazContactPhone": "string",
    "DeclaredValue": "string",
    "DeclaredValueUnitsOfMeasure": "string",
    "CODFeeCollect": true,
    "CODFeePrePaid": true,
    "CODAmt": "string",
    "Collect": true,
    "CustomerCheckNotOK": true,
    "CustomerCheckOK": true,
    "AccessorialList": [
        {
            "ServiceCode": "string"
        }
    ],
    "LineItems": [
        {
            "ShippingUnits": "string",
            "PKGType": "string",
            "Description": "string",
            "NMFC": "string",
            "ClassNum": 0,
            "Weight": "string",
            "Haz": true
        }
    ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.ltlp.kuehne-nagel.com/api/billoflading/preparebilloflading' \
--header 'Content-Type: application/json' \
--data-raw '{
    "UserName": "string",
    "ClientCode": "string",
    "AuthenticationId": "string",
    "BillOfLadingNumber": "string",
    "ProNumber": "string",
    "PONumber": "string",
    "CarrierName": "string",
    "CarrierSCAC": "string",
    "QuoteNumber": 0,
    "ShipmentDate": "string",
    "ShipperNumber": "string",
    "TrailerNumber": "string",
    "ShipperCompanyName": "string",
    "ShipperContactPhone": "string",
    "ShipperContactName": "string",
    "ShipperAddress": "string",
    "ShipperCity": "string",
    "ShipperState": "string",
    "ShipperZip": "string",
    "ConsigneeName": "string",
    "ConsigneePhone": "string",
    "ConsigneeContact": "string",
    "ConsigneeAddress": "string",
    "ConsigneeCity": "string",
    "ConsigneeState": "string",
    "ConsigneeZip": "string",
    "ThirdPartyName": "string",
    "ThirdPartyPhone": "string",
    "ThirdPartyContactName": "string",
    "ThirdPartyAddress": "string",
    "ThirdPartyCity": "string",
    "ThirdPartyState": "string",
    "ThirdPartyZip": "string",
    "CustomerNumber": "string",
    "SpecialInstructions": "string",
    "StoreNumber": "string",
    "DepartmentNumber": "string",
    "HazContractNUM": "string",
    "HazContactName": "string",
    "HazContactPhone": "string",
    "DeclaredValue": "string",
    "DeclaredValueUnitsOfMeasure": "string",
    "CODFeeCollect": true,
    "CODFeePrePaid": true,
    "CODAmt": "string",
    "Collect": true,
    "CustomerCheckNotOK": true,
    "CustomerCheckOK": true,
    "AccessorialList": [
        {
            "ServiceCode": "string"
        }
    ],
    "LineItems": [
        {
            "ShippingUnits": "string",
            "PKGType": "string",
            "Description": "string",
            "NMFC": "string",
            "ClassNum": 0,
            "Weight": "string",
            "Haz": true
        }
    ]
}'

Responses

🟢200OK
application/json
Body

Example
{
    "PDF": "string",
    "ShipmentLabel": "string",
    "BlNumber": "string",
    "ShipmentLabelZpl": [
        "string"
    ],
    "ErrorMessage": "string"
}
Previous
Accessorial - Retrieve all accessorial charge codes
Next
RateQuote - Submit a quote request
Built with