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
Parameter | Required | Type | Rules | Description |
---|---|---|---|---|
MAWB | Yes | String | This is a reference to the Master Air Way Bill Number | Master Air Way Bill |
parcels | Yes | array | Please refer to the parcels table bellow | Parcels data |
Parcels Parameters
Parcels Parameters
Parameter | Required | Type | Rules | Description |
---|---|---|---|---|
AWB | Yes | String | Please refer to the note bellow | Shipment reference |
shipperName | Yes | String | Must be alphanumeric and must be between 3 and 32 characters long | Shipper Name |
consigneeIsCompany | Yes | boolean | Indicates if the consignee is a company (hard code it as false) | Consignee Type |
consigneeName | Yes | String | Must be alphanumeric and must be between 3 and 32 characters long | Consignee Name |
consigneePhone | Yes | String | Must be a valid phone number | Consignee Phone Number |
consigneeCountry | Yes | String | Must be an iso 2 digit country code (Hardcode it as TR) | Consignee country |
consigneeState | Yes | String | Must be alphanumeric | Consignee State/Province |
consigneeCity | Yes | String | Must be alphanumeric | Consignee City |
consigneePostCode | Yes | String | Must be alphanumeric | Consignee Post Code |
consigneeAddress1 | Yes | String | Must be alphanumeric and must be between 5 and 32 characters long | Consignee Address Line 1 |
consigneeAddress2 | No | String | Must be alphanumeric and must be between 5 and 32 characters long | Consignee Address Line 2 |
parcelCurrency | Yes | String | Must be a valid ISO 4217 currency code | Shipment deceleration currency |
parcelWeight | Yes | number | Must be a number | Shipment Weight |
parcelWidth | Yes | Number | Must be a number | Shipment width |
parcelLength | Yes | Number | Must be a number | Shipment Length |
parcelHeight | Yes | Number | Must be a number | Shipment Height |
items | Yes | Array | Check Items Table | Shipment 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.
Parameter | Required | Type | Rules | Description |
---|---|---|---|---|
hs | Yes | String | Must be numerical and between 5 and 12 digits long | Product HS Code |
description | Yes | String | Must be alphanumerical and between 3 and 32 characters long | Product Description |
productLink | No | String | Product Link | |
value | Yes | Number | Must be number | Product Value |
quantity | Yes | Number | Must be number | Product Quantity |
weight | Yes | Number | Must be number, Must be in KG | Product 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"
}
]
}