LoadTender - Tender a shipment - Kuehne + Nagel LTL+

The LoadTender API endpoint allows users to submit a tender request for pickup to the carrier, including shipment details, contact information, and instructions.

Input Parameters:

Credentials:

Username, ClientCode, and AuthenticationCode authenticate the user.

Tender Details:

QuoteNumber: Identifies the specific quote for this tender.

CarrierCode: Specifies the carrier.

Method of Payment: Payment options are:

PP for PrePaid (default),

CC for Collect,

TP for Third Party.

Transaction Set Purpose: Specifies the type of tender request:

00 for Original (default),

01 for Cancellation (future state, not available yet)

PickupDate, PickupOpenTime, and PickupCloseTime: Scheduling details for the pickup.

PalletCount and TotalWeight: Shipment load details.

SpecialInstructions: Any specific instructions for the carrier.

BLPdf: Base64-encoded Bill of Lading PDF

Additional Options:

DeveloperMode: When true, enables test mode.

AccessorialCodes: List of codes for additional services required.

Hazmat Information (if applicable):

Name, Phone, and ContractNumber for hazardous material contact details.

Locations:

An array of three location entries for shipper, consignee, and billing party. Each location includes Code, Company, Address, City, State, PostalCode, Country, and contact details (ContactName, ContactPhone, ContactEmail).

Postal Codes

Canadian Postal codes must not contain a space. Additionally, extended zip codes in the USA such as 02538-1113 must be reduced to the first 5 digits.

Items:

An array detailing each item in the shipment, including:

Units (number of packages), PackageType (see table below), Hazmat (if the item is hazardous), Description, NMFCCode, FreightClass, PalletCount (handling units), ItemWeight, ItemLength, ItemWidth, and ItemHeight.

Package Types are listed below

Code	Description
BAT	Battery
BDL	Bundles
BIN	Bin
BOX	Box
BRL	Barrels
CAN	Canister
CAS	Case
CRT	Cartons
CRT	Crate
CTN	Container
CYL	Cylinder
DRM	Drum
LOS	Loose
OTH	Other
PAL	Pail
PCS	Pieces
PKG	Package
PLT	Pallet
SKD	Pallet
SKD	Skid
TOT	Tote
UNT	Unit

References:

Reference numbers, including BL (Bill of Lading), PO (Purchase Order), and QT (Quote Number).

Output Structure:

Confirmation:

ConfirmationID: Unique identifier provided by the carrier for the tender request.

Success: Boolean indicating if the tender was successfully submitted.

Message: Any additional information regarding the submission.

RTFPickupID: Unique identifier for Kuehne + Nagel, LTL+.

This endpoint enables users to submit tender requests, providing flexibility for different payment methods, shipment details, and handling hazardous materials.

Request

Body Params application/json

Example

{
    "Credentials": {
        "Username": "string",
        "ClientCode": "string",
        "AuthenticationCode": "string"
    },
    "QuoteNumber": "string",
    "CarrierCode": "string",
    "MethodOfPayment": "string",
    "TransactionSetPurpose": "string",
    "PickupDate": "string",
    "PickupOpenTime": "string",
    "PickupCloseTime": "string",
    "PalletCount": 0,
    "TotalWeight": 0,
    "SpecialInstructions": "string",
    "BLReferenceNumber": 0,
    "BLPdf": "string",
    "DeveloperMode": true,
    "AccessorialCodes": [
        "string"
    ],
    "Hazmat": {
        "Name": "string",
        "Phone": "string",
        "ContractNumber": "string"
    },
    "Locations": [
        {
            "Code": "string",
            "Company": "string",
            "Address": "string",
            "Address2": "string",
            "City": "string",
            "State": "string",
            "PostalCode": "string",
            "Country": "string",
            "ContactName": "string",
            "ContactPhone": "string",
            "ContactEmail": "string"
        },
        {
            "Code": "string",
            "Company": "string",
            "Address": "string",
            "Address2": "string",
            "City": "string",
            "State": "string",
            "PostalCode": "string",
            "Country": "string",
            "ContactName": "string",
            "ContactPhone": "string",
            "ContactEmail": "string"
        },
        {
            "Code": "string",
            "Company": "string",
            "Address": "string",
            "Address2": "string",
            "City": "string",
            "State": "string",
            "PostalCode": "string",
            "Country": "string",
            "ContactName": "string",
            "ContactPhone": "string",
            "ContactEmail": "string"
        }
    ],
    "Items": [
        {
            "Units": 0,
            "PackageType": "string",
            "Hazmat": true,
            "Description": "string",
            "NMFCCode": "string",
            "FreightClass": "string",
            "PalletCount": 0,
            "ItemWeight": 0,
            "ItemLength": 0,
            "ItemWidth": 0,
            "ItemHeight": 0
        }
    ],
    "References": {
        "BL": "string",
        "PO": "string",
        "QT": "string"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.ltlp.kuehne-nagel.com/api/loadtenderingv2/loadtenderv2' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Credentials": {
        "Username": "string",
        "ClientCode": "string",
        "AuthenticationCode": "string"
    },
    "QuoteNumber": "string",
    "CarrierCode": "string",
    "MethodOfPayment": "string",
    "TransactionSetPurpose": "string",
    "PickupDate": "string",
    "PickupOpenTime": "string",
    "PickupCloseTime": "string",
    "PalletCount": 0,
    "TotalWeight": 0,
    "SpecialInstructions": "string",
    "BLReferenceNumber": 0,
    "BLPdf": "string",
    "DeveloperMode": true,
    "AccessorialCodes": [
        "string"
    ],
    "Hazmat": {
        "Name": "string",
        "Phone": "string",
        "ContractNumber": "string"
    },
    "Locations": [
        {
            "Code": "string",
            "Company": "string",
            "Address": "string",
            "Address2": "string",
            "City": "string",
            "State": "string",
            "PostalCode": "string",
            "Country": "string",
            "ContactName": "string",
            "ContactPhone": "string",
            "ContactEmail": "string"
        },
        {
            "Code": "string",
            "Company": "string",
            "Address": "string",
            "Address2": "string",
            "City": "string",
            "State": "string",
            "PostalCode": "string",
            "Country": "string",
            "ContactName": "string",
            "ContactPhone": "string",
            "ContactEmail": "string"
        },
        {
            "Code": "string",
            "Company": "string",
            "Address": "string",
            "Address2": "string",
            "City": "string",
            "State": "string",
            "PostalCode": "string",
            "Country": "string",
            "ContactName": "string",
            "ContactPhone": "string",
            "ContactEmail": "string"
        }
    ],
    "Items": [
        {
            "Units": 0,
            "PackageType": "string",
            "Hazmat": true,
            "Description": "string",
            "NMFCCode": "string",
            "FreightClass": "string",
            "PalletCount": 0,
            "ItemWeight": 0,
            "ItemLength": 0,
            "ItemWidth": 0,
            "ItemHeight": 0
        }
    ],
    "References": {
        "BL": "string",
        "PO": "string",
        "QT": "string"
    }
}'

LoadTender - Tender a shipment

Input Parameters:#

Output Structure:#

Request

Request Code Samples

Responses

Input Parameters:

Output Structure: