Kuehne + Nagel LTL+
  1. Load Tendering
Kuehne + Nagel LTL+
  • Overview
    • Introduction
    • Acceptable Use Policy
    • Getting Started
    • Full Integration API Workflow
    • Support & Feedback
  • Accessorials
    • Accessorial - Retrieve all accessorial charge codes
      GET
  • BillOfLading
    • BOL - Create a bill of lading PDF
      POST
  • Quoting
    • RateQuote - Submit a quote request
      POST
    • RateQuote - Submit a quote request for multiple points
      POST
  • Document Retrieval
    • GetImageList - Retrieve list of available shipment documents
      POST
    • GetImage - Retrieve shipping documents based on DocumentID
      POST
  • Invoice
    • Invoice - Retrieve a single invoice or pull an entire week of invoices
      POST
  • Shipment Tracking
    • HTML Tracking Link Generation
    • TrackingList - Get a list of shipment tracking information
      POST
    • TrackingDetails - Retrieve all the tracking details related to a shipment
      POST
  • Load Tendering
    • LoadTender - Tender a shipment
      POST
    • LoadTender - Tender a shipment
      POST
  • Transit
    • Transit - Receive transit time for a shipment lane.
      POST
  • Orders
    • Order
      POST
    • OrderDetails
      POST
  1. Load Tendering

LoadTender - Tender a shipment

POST
https://api.ltlp.kuehne-nagel.com/api/loadtenderingv2/loadtenderv2
LoadTendering
Last modified:2024-12-09 19:31:12
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:#

1.
Credentials:
Username, ClientCode, and AuthenticationCode authenticate the user.
2.
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
3.
Additional Options:
DeveloperMode: When true, enables test mode.
AccessorialCodes: List of codes for additional services required.
4.
Hazmat Information (if applicable):
Name, Phone, and ContractNumber for hazardous material contact details.
5.
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.
6.
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
CodeDescription
BATBattery
BDLBundles
BINBin
BOXBox
BRLBarrels
CANCanister
CASCase
CRTCartons
CRTCrate
CTNContainer
CYLCylinder
DRMDrum
LOSLoose
OTHOther
PALPail
PCSPieces
PKGPackage
PLTPallet
SKDPallet
SKDSkid
TOTTote
UNTUnit
7.
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
BL
string 
optional
PO
string 
optional
QT
string 
optional
Example

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/loadtenderingv2/loadtenderv2' \
--header 'Content-Type: application/json' \
--data-raw ''

Responses

🟢200OK
application/json
OK
Body
ConfirmationID
string 
optional
Success
boolean 
optional
Message
string 
optional
RTFPickupID
integer 
optional
Example
{
  "ConfirmationID": "string",
  "Success": true,
  "Message": "string",
  "RTFPickupID": 0
}
Previous
LoadTender - Tender a shipment
Next
Transit - Receive transit time for a shipment lane.
Built with