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

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

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/v2/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"
    }
  ]
}

Manifest Booking

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​

Request body Parameters​

Request Parameters​

Parcels Parameters​

Note on AWB:​

Example : "ELS00000001"​

Note on MAWB:​

Example : "ELM00000001"​

Note on a manifest with more than 50 parcels:​

Items​

Request​

Request URL :​

Request Method :​

Content-Type :​

Request Body :​

Response​

Response Body :​

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

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

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

Request body Parameters

Request Parameters

Parcels Parameters

Note on AWB:

Example : "ELS00000001"

Note on MAWB:

Example : "ELM00000001"

Note on a manifest with more than 50 parcels:

Items

Request

Request URL :

Request Method :

Content-Type :

Request Body :

Response

Response Body :

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

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