Skip to main content

Manifest Booking

This service allows you to book a manifest of shipments(bulk shipping).

Do not forget to authenticate your request,

Please note that this service only allows you to book Turkey inbound shipments(shipments with turkey as a destination).

Please note that you can only attach up to 50 parcels per booking request

You can perform several requests to add as many shipments as required to be attached to the MAWB as long as you are using the same MAWB. A practical example would be to book your first 50 out of 90 shipments on a single MAWB using the first request while supplying the MAWB. Then, you can submit another request to book your remaining 40 shipments to the MAWB, supplying the same MAWB.

Request body Parameters

Request Parameters

Request Parameters
ParameterRequiredTypeRulesDescription
MAWBYesStringThis is a reference to the Master Air Way Bill NumberMaster Air Way Bill
parcelsYesarrayPlease refer to the parcels table bellowParcels data

Parcels Parameters

Parcels Parameters
ParameterRequiredTypeRulesDescription
AWBYesStringPlease refer to the note bellowShipment reference
shipperNameYesStringMust be alphanumeric and must be between 3 and 32 characters longShipper Name
consigneeIsCompanyYesbooleanIndicates if the consignee is a company (hard code it as false)Consignee Type
consigneeNameYesStringMust be alphanumeric and must be between 3 and 32 characters longConsignee Name
consigneePhoneYesStringMust be a valid phone numberConsignee Phone Number
consigneeCountryYesStringMust be an iso 2 digit country code (Hardcode it as TR)Consignee country
consigneeStateYesStringMust be alphanumericConsignee State/Province
consigneeCityYesStringMust be alphanumericConsignee City
consigneePostCodeYesStringMust be alphanumericConsignee Post Code
consigneeAddress1YesStringMust be alphanumeric and must be between 5 and 32 characters longConsignee Address Line 1
consigneeAddress2NoStringMust be alphanumeric and must be between 5 and 32 characters longConsignee Address Line 2
parcelCurrencyYesStringMust be a valid ISO 4217 currency codeShipment deceleration currency
parcelWeightYesnumberMust be a numberShipment Weight
parcelWidthYesNumberMust be a numberShipment width
parcelLengthYesNumberMust be a numberShipment Length
parcelHeightYesNumberMust be a numberShipment Height
itemsYesArrayCheck Items TableShipment Product Information

Note on AWB:

This is the reference to your parcel, it will be used to track your shipment using the tracking service. This has to be a unique value, not just to you but to our entire database. This is unfortunately an inefficient and suboptimal way to handle Shipment referencing. This issue will be fixed with later revisions of the this service. But for now what we recommend is to prefix your reference number with a 2 letter code that references your company name followed by an S.

Example : "ELS00000001"

Please refer to our support for further clarification.

Note on MAWB:

The MAWB field doesn't have to be the exact Master Air way bill number, it is just a reference to the batch of shipments under the same manifest. It should be a unique identifier that you can prefix with a 2 letter code that references your company name followed by an M.

Example : "ELM00000001"

Please refer to our support for further clarification.

Note on a manifest with more than 50 parcels:

If your booking request (manifest) contains more than 50 parcels, you will have to divide your booking into multiple request.

You would use the same MAWB that you provided using your first booking request.

Please refer to our support for further clarification.

Items

Items Parameters

Items are the products that you would like to ship.

ParameterRequiredTypeRulesDescription
hsYesStringMust be numerical and between 5 and 12 digits longProduct HS Code
descriptionYesStringMust be alphanumerical and between 3 and 32 characters longProduct Description
productLinkNoStringProduct Link
valueYesNumberMust be numberProduct Value
quantityYesNumberMust be numberProduct Quantity
weightYesNumberMust be number, Must be in KGProduct Weight

Request

Request URL :

https://srv.eliexpress.com.tr/api/v1/client-integration/new-order

Request Method :

POST

Content-Type :

application/json

Request Body :

{
"MAWB": "EL123456789",
"parcels": [
{
"AWB": "ELI123456789",
"shipperName": "John Doe",
"consigneeIsCompany": false,
"consigneeName": "Jane Doe",
"consigneeID": "12345678912",
"consigneeAddress1": "Halkali Merkez Mah Hekim Sokak",
"consigneeAddress2": "No: 16 a/b",
"consigneeState": "Istanbul",
"consigneeCity": "Kucukcekmece",
"consigneePostCode": "34303",
"consigneeCountry": "TR",
"consigneePhone": "2124703737",
"parcelCurrency": "USD",
"parcelWeight": 4.33,
"parcelWidth": 30,
"parcelLength": 40,
"parcelHeight": 15,
"items": [
{
"value": 45,
"quantity": 1,
"weight": 4.33,
"hs": "62171070",
"description": "Socks"
"productLink":"https://www.amazon.com/Amazon-Essentials-Performance-Cushioned-Athletic/dp/B08PF114QH/ref=sr_1_1_sspa?keywords=socks&qid=1659699599&sr=8-1-spons&psc=1&spLa=ZW5jcnlwdGVkUXVhbGlmaWVyPUFRMUNKRTVNQTMwSE8mZW5jcnlwdGVkSWQ9QTA2NjgwOTgxU1dJNjVHSE1BQ1lMJmVuY3J5cHRlZEFkSWQ9QTAxNTI1NTgyQ1BNSVNaVFVRSjk3JndpZGdldE5hbWU9c3BfYXRmJmFjdGlvbj1jbGlja1JlZGlyZWN0JmRvTm90TG9nQ2xpY2s9dHJ1ZQ=="
}
]
},
{
"AWB": "ELI123456790",
"shipperName": "John Doe",
"consigneeIsCompany": false,
"consigneeName": "Jane Doe",
"consigneeID": "12345678912",
"consigneeAddress1": "Halkali Merkez Mah Hekim Sokak",
"consigneeAddress2": "No: 16 a/b",
"consigneeState": "Istanbul",
"consigneeCity": "Kucukcekmece",
"consigneePostCode": "34303",
"consigneeCountry": "TR",
"consigneePhone": "2124703737",
"parcelCurrency": "USD",
"parcelWeight": 4.33,
"parcelWidth": 30,
"parcelLength": 40,
"parcelHeight": 15,
"items": [
{
"value": 45,
"quantity": 1,
"weight": 4.33,
"hs": "62171070",
"description": "Socks",
"productLink":"https://www.amazon.com/Amazon-Essentials-Performance-Cushioned-Athletic/dp/B08PF114QH/ref=sr_1_1_sspa?keywords=socks&qid=1659699599&sr=8-1-spons&psc=1&spLa=ZW5jcnlwdGVkUXVhbGlmaWVyPUFRMUNKRTVNQTMwSE8mZW5jcnlwdGVkSWQ9QTA2NjgwOTgxU1dJNjVHSE1BQ1lMJmVuY3J5cHRlZEFkSWQ9QTAxNTI1NTgyQ1BNSVNaVFVRSjk3JndpZGdldE5hbWU9c3BfYXRmJmFjdGlvbj1jbGlja1JlZGlyZWN0JmRvTm90TG9nQ2xpY2s9dHJ1ZQ=="
}
]
}
]
}

Response

Response Body :

I your shipment booking was successful, the server will respond with a success true, and a data entry successful message.

{
"success": true,
"message": "Data entry successful."

}

If you failed to authenticate the server will respond with a request unauthorized message.

{
"success": false,
"message": "Request Unauthorized"
}

If some parcels did not pass the data validation process the api will skip it and continue to the next parcel in the array. This means that if you provided some bad data, the server will respond with a list of the rejected data and the reason why they were rejected.

If some of the data was rejected you will get something like the bellow response

{
"success": false,
"message": "Some data rejected, please check reason",
"rejected": [
{
"reason": "Invalid Consignee ID",
"AWB": "ELI123456790"
}
]
}

If all of the data got rejected you will get the bellow response

{
"success": false,
"message": "Data rejected, please check reason",
"rejected": [
{
"reason": "Invalid Consignee ID",
"AWB": "ELI123456790"
}
]
}