Esnad Express International | Shipping Information
Table of Contents
How does it Work? ...... 3
Security ...... 3
1. Upload Shipments...... 4
2. Track Shipments ...... 8
APPENDIX: ESNAD and General References ...... 11
NOTE: DOCUMENT INDEX SHOULD BE MODIFIED AS PER YOUR DOCUMENT HEADINGS AND THIS INDEX IS GIVEN AS FORMAT AND SAME SHOULD BE FOLLOWED FOR ESNAD API DOC AS WELL. URLs SHOULD BE CREATED AND ACCORDINGLY WE CAN UPDATE ON API DOC AS WELL ONCE ALL URL ARE WORKING FINE.
Esnad Express International | Shipping Information How does it Work?
The Esnad Services API provides these features:
Upload Shipments & Track Shipments
Simple and easy to use Upload Shipments, is easily generated by providing very basic and simple information about the shipper, consignee and shipments
1. Upload Shipments
Allows you to create shipments, providing a wide range of options for customers to provide full details about their shipments.
2. Track Shipments
Allows you to track shipment whole life cycle information details.
Security
Each submitted request should contain a valid account Token. This is used to authenticate and verify the identity of the client.
During the process of shipment, the submitted information such as addresses, payment methods and more, goes through a detailed validation procedure to insure the validity and correctness. In case of errors, detailed descriptive error messages are provided in the generated response.
The API access token is generated by Esnad IT group, pls add it in HTTP Headers:
Esnad Express International | Shipping Information 1. Upload Shipments
1.1 Request URL: Staging: http://testapi.esnad.com.cn/orderInfo/uploadOrderInfo Production: http://api.esnad.com.cn/orderInfo/uploadOrderInfo
1.2 HTTP Method: Method: POST Content-Type: application/json token: [Get from Esnad IT]
Esnad Express International | Shipping Information 1.3 Request Body Json Sample: Red is Mandatory
1. [{ 2. "esnadAwbNo": "1008000000021", //esnad give AWB number zone to client,such as 10010 00000000 to 1001999999999 3. "clientOrderNo": "test860096766679", //client’s order number 4. "pieceId": "A00001|A00002", //client’s package number, use ** | ** split different package number if one order has more than one package 5. "orderType": "INT", //International client use INT, Domestic client use DOM, B2B client use TOB 6. "deliveryService": "EXP", //normal order use EXP, urgent order use UGT 7. "consignor": "zhang san", //consignor name 8. "pickupAddress": "Room601 Bldg Gongyuan Plaza DengLiang Road", //consignor address 9. "pickupPincode": "518000", //consignor zip 10. "pickupContact": "+86-0755-82597607", //consignor contact 11. "originCity": "Shenzhen", //consignor city 12. "originCountry": "CN", // consignor country 13. "consignee": "Li Si", //consignee name 14. "deliveryAddress": "2319 Muqbal Adh Dhakir Riyadh 12467 ", // consignee address 15. "deliveryLandmark": "Kindom Tower", // consignee address landmark 16. "deliveryPincode": "11564", // consignee zip 17. "deliveryContact": "+933-500774188", // consignee contact 18. "deliveryContact2": "+933-500773333", // backup contact 19. "deliveryTime": "13:00-18:00 GMT+3", // delivery time 20. "deliveryLongitude": "25.0445575", // consignee longitude 21. "deliveryLatitude": "55.1418511", // consignee latitude 22. "destCity": "Riyadh", // consignee city 23. "destRegion": "Esatern Province", // consignee province 24. "destCountry": "SA", // consignee country 25. "returnName": "", //return name 26. "returnAddress": "", //return address 27. "returnPincode": "", // return zip 28. "returnContact": "", // return contact 29. "returnCity": "", // return city 30. "returnCountry": "", // return country 31. "productDescription": "Toys Cloths", //product category, for customs clearance 32. "paymentMode": "COD", // **cash on delivery use COD , prepaid use PPD** 33. "amountToCollect": "104.55", //order total price **Currency is SAR** 34. "pcs": "3", //product pieces 35. "declaredValue": "20", //customs declared value **Currency is Doller** 36. "length": "", //package length **unit is cm ** 37. "breadth": "", // package breadth ** unit is cm ** 38. "height": "", // package height ** unit is cm ** 39. "volWeight": "3", // package volumn weight ** unit is kg ** 40. "packageWeight": "3", //package real weight ** unit is kg ** 41. "invoiceNumber": "85120366570", //invoice number 42. "invoicePdf": "http://invoice.xxxxx.com/download?uuid=123", //invoice pdf or html link, esnad print it for customs random check 43. "memo": "LP00134943276177", //remarks ** will print on the bottom of esnad AWB, for client private tracking info ** 44. "productDetails": [{ //product details 45. "productLink": "http://www.xxxxxx.com/item/32855004219.html", //product link ** for prohibited products auto detection** 46. "productPrice": "100.00", //product price 47. "productPcs": "3", //product pieces 48. "productHscode": "21069010.00", //costoms HScode 49. "productName": "2019 Summer Chiffon Women Blouses Vintage Floral Print Blouse S exy V Neck Sleeveless Tunic Casual Loose Ladies Tops" //product’s full name 50. }, { Esnad Express International | Shipping Information 51. "productLink": "", 52. "productPrice": "", 53. "productPcs": "", 54. "productHscode": "", 55. "productName": "" 56. }] 57. }]
Esnad Express International | Shipping Information
1.4 Response Message There are 3 response code: 1000 – upload success 2000 – upload failed because of invalid value check 3000 – upload failed because of duplicate order number
Upload success response – 1000
1. { 2. "data": [ 3. { 4. "clientOrderNo": "98765432472", 5. "esnadAwbNo": "1000000000150", 6. "esnadAwbPdfLink": "http://testawb.esnad.com.cn/20191118/1000000000150.pdf" , 7. "esnadAwbHTMLLink": "http://testapi.esnad.com.cn/pdf/getOrderDocHtml/100000 0000150" 8. } 9. ], 10. "code": "1000", 11. "msg": "SUCCESS" 12. }
Upload failed response – 2000
1. { 2. "data": "", 3. "code": "2000", 4. "msg": "consignor can't be null!" 5. }
This case is consignor is null
Upload failed response – 3000
1. { 2. "data": [ 3. { 4. "esnadAwbNo": "1000000000151", // request esnad awb number 5. "clientOrderNo": "98765432472", // request client order number 6. "orignEsnadAwbNo": "1000000000150", // esnad awb number saved in db 7. "orignClientOrderNo": "98765432472", // client order number saved in db 8. "esnadAwbPdfLink": "http://testawb.esnad.com.cn/20191118/1000000000150.pdf" , 9. "esnadAwbHTMLLink": "http://testapi.esnad.com.cn/pdf/getOrderDocHtml/100000 0000150", 10. "consignee": "wang wu", 11. "deliveryContact": "+966-500774188" 12. } 13. ], 14. "code": "3000", Esnad Express International | Shipping Information 15. "msg": "the order have exist!" 16. } 2. Track Shipments
2.1 Request URL: Staging: http://testapi.esnad.com.cn/orderTracking/esnadTrackingOrderInfo Production: http://tracking.esnad.com.cn/orderTracking/esnadTrackingOrderInfo
2.2 HTTP Method: Method: POST Content-Type: application/json token: [Get from Esnad IT]
2.3 Request Body Json Sample:
1. { 2. "esnadAwbNo": "1000000000000" 3. }
Esnad Express International | Shipping Information 2.4 Response Message
1. { 2. "data": { 3. "paymentMode": "COD", 4. "esnadAwbNo": "4000000001335", 5. "consigneeInfo": { 6. "id": 60286, 7. "consignee": "FEDAA ALJAAFAR", 8. "deliveryAddress": "KSA, EASTERN REGION, SAFWA, JABER BIN HAYAN STREET SAFW A", 9. "deliveryPincode": "", 10. "deliveryContact": "00966558165888", 11. "orderId": 60299 12. }, 13. "consignorInfo": { 14. "id": 60417, 15. "consignor": "YNAP MIDDLE EAST GENERAL TRADING(BR", 16. "pickupAddress": "LIU E08 , DUBAI AIRPORT FREEZONE DUBAI - VAT NO. 10025217 3800003 DAFZ, PO BOX 49042", 17. "pickupPincode": "", 18. "pickupContact": "8008449250", 19. "orderId": 60299 20. }, 21. "signatureUrls": "", 22. "trackingInfoList": [ 23. { 24. "status": "999", 25. "description": "delivered", 26. "updatedTime": "2019-11-18 19:10:54", 27. "location": null, 28. "remarks": "TASK_COMPLETED_SUCCESSFULLY" 29. }, 30. { 31. "status": "600", 32. "description": "out for delivery", 33. "updatedTime": "2019-11-18 17:06:27", 34. "location": null, 35. "remarks": "TASK_ASSIGNED" 36. }, 37. { 38. "status": "300", 39. "description": "assign to last mile team", 40. "updatedTime": "2019-11-18 03:00:28", 41. "location": "", 42. "remarks": null 43. } 44. ], 45. "collectAmount": "100.00" 46. }, 47. "code": "1000", 48. "msg": "SUCCESS" 49. }
Esnad Express International | Shipping Information 2.5 Track Status List
Code Status Remarks
100 Data received 客户创建订单完成
200 Shipment pickuped from shipper 收货完成
-201 Shipment pickuped failed 收货失败
210 Departed from the origin 发货目的国
400 Customs clearance completed 清关完成
-401 Held at customs authorities 清关失败
-402 Customs clearance delay 清关延迟
500 Arrived at sorting hub facility 入库扫描
510 Sorting at hub facility 分拣打包
520 Departed from sorting hub facility 出库扫描
530 Arrived at delivery center 地派团队收货
540 Shipment in transit 货物运输流转
600 Shipment out for delivery 外出派送
610 Undelivery - Hold at delivery center 派送失败后返回仓库
700 RTH - Return to hub 退件到退货中心
710 Arrived at RTH 退件入库扫描
720 RTC - Reshipped to consignee - Delivery reinitiated 退件出库扫描
777 RTS - Return to shipper 退件回客户
789 Return complete 客户收到退件
999 Delivered 派送成功
-901 Attempt to delivery: Consignee Refused To Accept 买家拒签
-902 Attempt to delivery: Consignee No Response 联系不到客户
-903 Attempt to delivery: Address Incorrect 地址不详/错误
-904 Attempt to delivery: Consignee requested for future delivery 客户要求更改送货时间和地址
-905 Attempt to delivery: Shipment Destroyed / Lost 包裹丢失或损坏
-906 Attempt to delivery: Forcibly Taken by Consignee 买家拒付并强行拿走货
-907 Attempt to delivery: Delay beyond Control / Natural Disaster 自然灾害不可抗力
-908 Attempt to delivery: Out of Delivery Area 超出配送范围
-909 Attempt to delivery: Shipment Detained/Seized by Regulatory Authority 货品被监管机构扣留
-910 Attempt to delivery: Special Reason 特殊原因
Esnad Express International | Shipping Information
APPENDIX: ESNAD and General References
Appendix A – Esnad Served Cities
1. AHB Abha 2. ABQ Buqayq 3. ABA Abu Arish 4. AFI Afif 5. AFL Al Aflaj 6. AHM Ahad Al Masarihah 7. AHD Ahad Rafidah 8. AIN Ain Dar 9. ABY Al Bashayer 10. DUL Al Dulaymiyah 11. ADY Al Dayer 12. HSA Al Hassa 13. GHT Al Ghat 14. ADA Alhada 15. AKB Al Khabra 16. AMD Al Madha 17. RAS Ar Rass 18. ARQ Ar Ruqi 19. AMQ Amaq 20. ANK Anak 21. AQK Al Aqiq 22. RAE Arar 23. ART Al Artawiyah 24. ASF Asfan 25. ASW Asuwayq 26. ASQ Ash Shuqayq 27. ATA Al Atawlah 28. AWA Al Awamiyah 29. AYN Ayn lbn Fuhayd 30. AAY Al Ayun 31. BDA Al Badayea 32. BDR Badr 33. BAD Al Bad 34. ABT Bahah 35. BCW Bahrain Causeway 36. BHR Bahrah 37. BAS Baish 38. BSM Billasmar 39. BAQ Baqaa 40. BAR Bariq 41. BAT Al Batha 42. BJD Al Bijadyah 43. BNM Bani Malik 44. BAL Baljurashi 45. BRK Al Birk 46. BIH Bir Ibn Hirmas 47. BIS Bisha 48. BUK Al Bukayriyah 49. BUR Buraydah 50. DMD Damad 51. DMM Dammam 52. DRB Ad Darb
Esnad Express International | Shipping Information 53. DAM Dhalm 54. DAB Dahaban 55. DER Dirab 56. DLM Ad Dilam 57. DHA Dhahran 58. DHJ Dhahran Al Janoob 59. DRY Ad Diriyah 60. DHU Dhurma 61. DAJ Dumah Al Jandal 62. DBA Duba 63. DUK Duhknah 64. DUW Al Duwadimi 65. FRS Farasan 66. GIL Gilwa 67. GIZ Jazan 68. HDA Hadda 69. HAD Al Hadithah 70. HBT Hafar Al Batin 71. HAS Hail 72. HAY Al Haeer 73. HAM Halat Ammar 74. HQL Haql 75. HRD Haradh 76. HRQ Al Hariq 77. HAW Al Huwaya 78. HWT Howtat Bani Tamim 79. HIN Al Henakiyah 80. HOF Al Hofuf 81. HML Huraymila 82. HTS Hautat Sudair 83. JAF Jafar 84. JAS Jash 85. JLJ Jalajil 86. JED Jeddah 87. AJF Al Jowf 88. QJB Al Jubail 89. JUM Jumum 90. KRB Al Karbus 91. KHF Khafji 92. KHB Khaybar 93. KHA Khamaseen 94. AKM Al Kamil 95. KHM Khamis Mushait 96. KHJ Al Kharj 97. KHT Al Khitah 98. KHO Al Khobar 99. KHL Khulais 100. KHU Al Khurma 101. KKC King Khalid Military City 102. LTH Al Laith 103. MED Medina 104. MNF Manifah 105. MHD Mahd Al Thahab 106. MJD Majarda 107. MJH Al Majmaah 108. QCA Mecca 109. MAN Almandaq 110. MAS Mastorah 111. MID Al Mithnab 112. MAW Al Makhwah 113. MOH Muhayil Esnad Express International | Shipping Information 114. MAR Marat 115. MBZ Al Mubarraz 116. MUW Al Muwayh 117. MJA Mulayjah 118. MUZ Almuzaylif 119. MUS Al Mushaytiyah 120. MZH Al Muzahimiyah 121. ANB Al Nabah 122. NAK Nakeea 123. NAB An Nabiyah 124. NAN An Nabhaniyah 125. NAY Nairyah 126. EAM Najran 127. NIM Namas 128. NIF Nifi 129. ONZ Unayzah 130. ULA Al Ula 131. OYA Al Uyaynah 132. QAI Al Qaid 133. QMH Al Qahma 134. QAB Al Qalibah 135. QAR Al Qarah 136. QAU Qaryat Al Ulya 137. QSA Al Qasab 138. ELQ Qassim 139. QAT Qatif 140. AQI Al Qaisumah 141. QIL Qilwah 142. QNA Qina 143. QUN Al Qunfudhah 144. URY Al Qurayyat 145. QUW Al Quwaiiyah 146. RAB Rabigh 147. RAF Rafha 148. RAG Rafayaa Al Gimsh 149. RHM Rahima 150. RAN Ranyah 151. RAK Ras Al Khair 152. RAT Ras Tanura 153. RJL Rijal Alma 154. RMH Rumah 155. RUH Riyadh 156. RKH Riyadh Al Khabra 157. RAY Ar Rayn 158. RWA Rwaydah 159. SBT Sabt Al Alayah 160. SAB Sabya 161. SAR Saira 162. SAY Sayirah 163. SFN As Saffaniyah 164. SAF Safwa 165. SHN As Sahna 166. SAJ Sajir 167. SKA Sakaka 168. SBK Salbukh 169. SLW Salwa 170. SAM Samtah 171. SRR As Sarrar 172. SBD Sarat Abidah 173. SAK As Sail Al Kabeer 174. SAI Saihat Esnad Express International | Shipping Information 175. SHQ Shaqra 176. SHW Sharourah 177. SHF Ash Shafa 178. SDG Shedgum 179. SHG Shigry 180. SHB Shaybah 181. SHR Shari 182. SUL As Sulayyil 183. TBL Tubarjal 184. TUU Tabuk 185. TIF Taif 186. TLN Tala'at Naza 187. TAN Tanajib 188. TAH Tanumah 189. TAR Tarout 190. TAL Tathleeth 191. TAY Tayma 192. TDK Thadiq 193. THU Tumair 194. THK Thuqbah 195. THW Thuwal 196. TWL Al Tuwal 197. TAB Tarib 198. TUI Turaif 199. TUR Turbah 200. UDH Udhailiyah 201. UMJ Umm Al Jamajm 202. UML Umluj 203. UAS Uglat Asugour 204. UMY Uthmaniyah 205. UYU Uyun Al Jawa 206. WDE Al Wadeen 207. WBH Wadi Ibn Hasbal 208. WAD Wadi ad-Dawasir 209. EJH Al Wajh 210. YNB Yanbu 211. ZUL Az Zulfi
Esnad Express International | Shipping Information