note:API name and link will be replaced when the relative module get online
Logistics
Here are some important logistics parameters you should know before starting to manage your logistics:
IDs |
Demo |
|
trade_order_id (order_id) |
Order id |
104221207803998 |
logistics_order_id (warehouse_order_id) |
Aliexpress logistics order id. The id will be generated once the AE warehouse order is created. |
5043788595 |
out_order_code |
CaiNiao logistics order id. Once warehouse order is created, seller could query logistics info with CN id at global.cainiao.com |
LP00143017183663 |
international_logistics_num (intl_tracking_no) |
PPT (Posta ve Telgraf Teskilati) logistics tracking number |
RA200014005TR |
aliexpress.logistics.redefining.getonlinelogisticsservicelistbyorderid
The API requires order id and responds with available logistics services including warehouse name, logistics service name, timelineness, service id, etc.
Before using the service, make sure the order id belongs to the account that developer is currently logged in.
Request parameter:
Request Parameter |
Optional/Required |
|
goods_width |
optional |
Width, height and length must be less than 60cm.The sum of all three must be less than 90 cm. |
goods_height |
optional |
|
goods_length |
optional |
|
goods_weight |
optional |
Maximum weight is 2kg. |
order_id |
required |
Order id must belong to the account that developer is currently logged in. |
Sample Code:
goods_width: 30 goods_height: 10 goods_length: 10 goods_weight: 1 order_id：103482801093998
order_id：103482801093998
Response Sample:
{ "aliexpress_logistics_redefining_getonlinelogisticsservicelistbyorderid_response": { "result_list": { "result": [ { "delivery_address": "Trendyol Akasya TOM Depo Logipark Tesisleri Orta Mh. 1. Sanayi Cd. Oztas Sok. No: 7 B1 Blok Tuzla Istanbul", "logistics_service_id": "CAINIAO_G2G_DIRECTSHIP_30111284", "logistics_service_name": "CAINIAO G2G DIRECTSHIP Standard", "logistics_timeliness": "6-60days", "trial_result": "CN?0.00", "warehouse_name": "Turkey Warehouse" } ] }, "request_id": "48vm8frocugu" } }
aliexpress.logistics.redefining.getlogisticsselleraddresses
The API returns seller addresses (sender, pickup, refund) based on the request.
Request Parameter |
Optional / Required |
|
seller_address_query |
Required |
Choose one from sender,pickup and refund |
Sample Code
seller_address_query: sender
seller_address_query: pickup
{ "aliexpress_logistics_redefining_getlogisticsselleraddresses_response": { "result_error_code": 0, "result_success": true, "sender_seller_address_list": { "senderselleraddresslist": [ { "address_id": 109164806, "city": "chong qing shi", "country": "China", "county": "bi shan qu", "email": "TEST@TEST.COM", "is_default": 0, "language": "en_US", "member_type": "sender", "name": "XIAO OU", "phone": "186888888", "postcode": "300000", "province": "chong qing", "street": "da lu jie dao", "street_address": "test Chinese address 2", "trademanage_id": "tr1524496074zjff" }, { "address_id": 109143742, "city": "bei jing shi", "country": "China", "county": "chang ping qu", "email": "test@test.com", "is_default": 0, "language": "en_US", "member_type": "sender", "name": "Leon Fan", "phone": "18688888888", "postcode": "100000", "province": "bei jing", "street": "bei qi jia zhen", "street_address": "test Chinese address 1", "trademanage_id": "tr1524496074zjff" } ] }, "request_id": "6iosacxu2vth" } }
(Asynchronously, may take 30 mins to 2 hours to generate print info. Contact us if you waits beyond 2 hours )
aliexpress.logistics.createwarehouseorder
The API creates online warehouse order based on the parameter below:
Request Parameter |
Optional / Required |
|
address_d_t_os |
required |
Option 1: Set“address_id”:-1
|
declare_product_d_t_os |
required |
Following fields are required to create the order successfully: |
domestic_logistics_company |
optional |
|
domestic_logistics_company_id |
required |
Set domestic_logistics_company_id to “505” |
domestic_tracking_no |
required |
Set domestic_tracking_no to “none” |
package_num |
optional |
|
trade_order_from |
required |
Set trade_order_from to “ESCROW” |
trade_order_id |
required |
Order id. demo:103374365963998 |
undeliverable_decision |
optional |
0: Destroy 1:Return |
warehouse_carrier_service |
required |
Can be retrieved in Step 1: returned as logistics_service_id with aliexpress.logistics.redefining.getonlinelogisticsservicelistbyorderid |
Sample Code
address_d_t_os:
{ "receiver": { "member_type": "receiver", //optional "country": "RU", "street_address": "Пл олд оддж", "city": "Amurskoe", "mobile": "98745632108", "trademanage_id": "us1181510866cdiv", //optional "province": "Amurskaya oblast", "phone": "95510912522", "post_code": "518000", "name": "По ол ол", "email": "aetestsg@gmail.com" }, //optional "sender": { "member_type": "sender", //optional "country": "TR", "street_address": "street address", "city": "huai bei shi", "county": "CN", "address_id": -1, "mobile": "18766234324", "trademanage_id": "aliqatest01", //optional "province": "an hui sheng", "phone": "123321", "street": "test street", "post_code": "518000", "name": "Linda123", "fax": "234234234", //optional "email": "rhh01@sina.cn" }, "pickup": { "member_type": "pickup", //optional "country": "TR", "street_address": "street address", "city": "sdfsdf", "county": "sdfsdf", "address_id": -1, "mobile": "18766234324", "trademanage_id": "cn234234234", //optional "province": "asdasd", "phone": "95510912522", "street": "asdasfa", "post_code": "518000", "name": "Linda", "fax": "234234234", //optional "email": "rhh01@sina.cn" }, "refund": { "member_type": "refund", //optional "country": "TR", "street_address": "street address", "city": "Moscow", "county": "sdfsd", "address_id": -1, "mobile": "18766234324", "trademanage_id": "aliqatest01", //optional "province": "Moscow", "phone": "12312312312", "street": "street", "post_code": "518000", "name": "Linda", "fax": "234234234", //optional "email": "rhh01@sina.cn" } }
{ "receiver": { "member_type": "receiver", "country": "RU", "street_address": "Пл олд оддж", "city": "Amurskoe", "mobile": "98745632108", "trademanage_id": "us1181510866cdiv", "province": "Amurskaya oblast", "phone": "95510912522", "post_code": "518000", "name": "По ол ол", "email": "aetestsg@gmail.com" }, "sender": { "address_id": 109123806 }, "pickup": { "address_id": 109162345 }, "refund": { "address_id": 109161234 } }
declare_product_d_t_os：
{ "category_cn_desc": "连衣裙", "product_weight": "1.5", "product_num": 2, "product_declare_amount": "1.3", //declare amount should between 0.01 and 10000.00 "sku_value": "white", //sku attribute value name. Demo: "XL white" "category_en_desc": "dress", "product_id": 1000, "breakable": false, "sku_code": "A123321", //self-defined code for each variant under a same product id "contains_battery": false, "sc_item_code": "scitem code", //optional "aneroid_markup": false, //optional "sc_item_id": 1000, //optional "hs_code": "12345", //optional "sc_item_name": "scitem name", //optional "only_battery": false //optional }
domestic_logistics_company_id: 505 // please fill in the blank with 505 (default value) domestic_tracking_no：none // please fill in the blank with none trade_order_from：ESCROW // please fill in the blank with ESCROW trade_order_id:103374365963998 warehouse_carrier_service:CPAM_WLB_FPXSZ
{ "aliexpress_logistics_createwarehouseorder_response": { "result": { "error_code": 1, "intl_tracking_no": RA200007551TR, "out_order_id": 14907636011, "success": true, "trade_order_from": "ESCROW", "trade_order_id": 103374365963998, "warehouse_order_id":5044581876, }, "result_success": true, "request_id": "69abbhqfcqj0" } }
aliexpress.logistics.querylogisticsorderdetail
The API requires order id and returns international logistics details including international logistics number.
Before using the service, make sure the order id belongs to the account that developer is currently logged in.
Request Parameter |
Optional / Required |
|
trade_order_id |
Required |
Demo:103838754733998 |
Respond Parameters |
Demo |
|
trade_order_id |
Order id |
104221207803998 |
logistics_order_id |
Aliexpress logistics order id. The id will be generated once the AE warehouse order is created. |
5043788595 |
out_order_code |
CaiNiao logistics order id. Once warehouse order is created, seller could query logistics info with CN id at global.cainiao.com |
LP00143017183663 |
international_logistics_num |
PPT (Posta ve Telgraf Teskilati) logistics tracking number |
RA200014005TR |
Sample Code
trade_order_id：103838754733998
{ "aliexpress_logistics_querylogisticsorderdetail_response": { "result": { "current_page": 1, "result_list": { "aeop_logistics_order_detail_dto": [ { "channel_code": "", "gmt_create": "2019-07-05 18:26:41", "international_logistics_num": "RA200007565TR", "international_logistics_type": "CAINIAO_G2G_DIRECTSHIP_30111284", "logistics_order_id": 5002416858, "logistics_status": "out_stock_success", "out_order_code": "LP00137282156429", "trade_order_id": 103838754733998 }, { "channel_code": "", "gmt_create": "2019-07-05 18:26:30", "international_logistics_num": "RA200006635TR", "international_logistics_type": "CAINIAO_G2G_DIRECTSHIP_30111284", "logistics_order_id": 5046851519, "logistics_status": "wait_warehouse_receive_goods", "out_order_code": "LP00137282450174", "trade_order_id": 103838754733998 } ] }, "success": true, "total_page": 1 }, "request_id": "10st0do11k5dw" } }
aliexpress.logistics.redefining.getprintinfo
The API returns print info based on logistic_id. The service is only available for order created by aliexpress.logistics.createwarehouseorder
Request Parameter |
Optional / Required |
|
international_logistics_id |
Required |
International_ logistics_id can be retrieved from Step 4. |
Sample Code
international_logistics_id：RA200007551TR
{ "aliexpress_logistics_redefining_getprintinfo_response":{ "result":"{"Content-Disposition":"attachment;filename=RA200013000TR", "body":"JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9GaWx0ZXIvRmxhdGVEZWNvZGUvTGVuZ3RoIDc0OT4+c3RyZWFtCniclVXLbtNAFL2S40ZyJVhQSKmgzI4UyMQzHr+KkHi7asSjqVOlqVFRKUWiD5QqEuqiEvwAEp\/Bml\/oL7CAFXv2XXNmnEh5lRRZ9jzu9Tnn3rm+bjurzorTdh6mjs9kEHA3Yum247KKiEIupF48SeHicsE+OhuSua+Yy7YdGSmM+2bsvrcHrGE3l4mukzjDrkHcf0N0jSNkbUcwfR2+c6RyuQqZUAFXkimP+x5Tvg7g8K2zY0KUbBlYCfB94J+N2rOLWHBf9dTniwF7ztW154s9k04kUzAdmWCSST\/gMfK471SfShZz4bN0B2LSQyB5ri88oJXtJDs4KZ5mnS8L6XuAw6qzgNS3meDSz+H0RCjuRdCjeCTYm31Wbe5I9vgDG6IVkTBnmdPiKOM+WunFodK0tEgNYmQNkJZJ0gtKaZkSvQ8N\/chuzL3zokd0dzicQZGhywM5ESam5xC0hkvLejYqODt4NP0n2\/ps\/6QKzVIl69y2E\/tySxVPCz\/GxMBE4JqDmEB8h5rIz+p\/ZghHFPMgPkfua1Qfg30F1zxdo0sYb2A2S1dpLn+OZfN8HgeT2Irf7N2p3wMDAwNzY4ODUgMDAwMDAgbiAKMDAwMDA3NjY5OCAwMDAwMCBuIAowMDAwMDAwOTE5IDAwMDAwIG4gCjAwMDAwNzczNTggMDAwMDAgbiAKMDAwMDA3ODI5NCAwMDAwMCBuIAowMDAwMDc4NTQ5IDAwMDAwIG4gCjAwMDAwNzkyMjggMDAwMDAgbiAKMDAwMDA3OTI4MCAwMDAwMCBuIAowMDAwMDc5MzI3IDAwMDAwIG4gCnRyYWlsZXIKPDwvSW5mbyAxMyAwIFIvSUQgWzxlMWI2ZTMwYjE1NTM2ODk3MDc5MDMzNTUxYTQ2ODRlND48OTYzOGNmZGUyYmU5ZGE0YmEwNDQzOTdmMjcyNzVlNDk+XS9Sb290IDEyIDAgUi9TaXplIDE0Pj4KJWlUZXh0LTUuNC4yCnN0YXJ0eHJlZgo3OTQ4MQolJUVPRgo=\",\"StatusCode\":200,\"Content-Type\":\"application\/x-zip-compressed\"}", "request_id": "10st0do11k5dw" } }
