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

Credentials

object

required

Username

string

optional

LTL+ provided Username

ClientCode

string

optional

LTL+ provided Clientcode

AuthenticationCode

string

optional

LTL+ provided AuthenticationID

QuoteNumber

string

optional

LTL+ Quote Number

CarrierCode

string

required

LTL+ Carrier Code SCAC

MethodOfPayment

string

required

Default: PP
PP - PrePaid
CC - Collect
TP - Third Party

TransactionSetPurpose

string

required

Valid values
00 - Original (default)
01 - Cancellation (future state - currently only allows Original)

PickupDate

string

required

Should be formatted as YYYYMMDD

PickupOpenTime

string

required

HHMM (Hours & Minutes in military local time)

PickupCloseTime

string

required

HHMM (Hours & Minutes in military local time)

PalletCount

integer

required

Total pallet count of the item pallet counts
Must be greater than 0

TotalWeight

integer

required

SpecialInstructions

string

optional

Free text field for pickup or delivery instructions

BLReferenceNumber

integer

optional

Internal - DO NOT USE

BLPdf

string

required

Base 64 encoded PDF of bill of lading

DeveloperMode

boolean

required

DeveloperMode = True for testing

AccessorialCodes

array[string]

optional

Hazmat

object

optional

Name

string

optional

Phone

string

optional

ContractNumber

string

optional

Locations

array [object {11}]

required

There should always be 3 Locations.
SH for Shipper
CN for Consignee
TP for Third Party

>= 3 items<= 3 items

Code

string

optional

SH for Shipper
CN for Consignee
TP for Third Party

Company

string

optional

Address

string

optional

Address2

string

optional

City

string

optional

State

string

optional

PostalCode

string

optional

Country

string

optional

USA or CAN

ContactName

string

optional

ContactPhone

string

optional

ContactEmail

string

optional

Items

array [object {11}]

required

>= 1 items

Units

integer

required

PackageType

string

required

Hazmat

boolean

required

Description

string

required

NMFCCode

string

optional

FreightClass

string

required

Valid values
50
55
60
65
70
77.5
85
92.5
100
110
125
150
175
200
250
300
400
500

PalletCount

integer

required

ItemWeight

integer

required

ItemLength

integer

optional

ItemWidth

integer

optional

ItemHeight

integer

optional

References

object

optional

string

optional

string

optional

string

optional

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 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"
    }
}'

application/json

Body

ConfirmationID

string

optional

Success

boolean

optional

Message

string

optional

RTFPickupID

integer

optional

Example

{
    "ConfirmationID": "string",
    "Success": true,
    "Message": "string",
    "RTFPickupID": 0
}

LoadTender - Tender a shipment

Input Parameters:#

Output Structure:#

Request

Request samples

Responses

Input Parameters:

Output Structure: