API
查询物流计划
更新时间: 2023-08-27 20:43:38 访问次数:9819

接口说明

根据WINIT产品、验货仓及目的仓筛选可选物流计划。
1.标准海外仓入库查询物流计划,验货仓(inspectionWarehouseCode)为国内验货仓;
2.直发自验/海外验WINIT承运查询物流计划,验货仓(inspectionWarehouseCode)为国内出运地。

使用场景

WINIT承运入库单使用

接口名称

winit.tms.getLogisticsPlan

请求说明

请求内容 说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,1000有需要可申请加大。

请求入参

名称 类型 必填 说明 示例
winitProductCode String(50) Y WINIT产品编码 OW01010382
inspectionWarehouseCode String(50) Y 验货仓编码
通过接口winit.pms.getWarehouseList返回出参warehouseCode
SZ0001
destinationWarehouseCode String(50) Y 目的仓编码
通过接口winit.pms.getWarehouseList返回出参warehouseCode
US0001

请求示例

1、标准海外仓查询

  1. {
  2. "action": " winit.tms.getLogisticsPlan",
  3. "app_key": "rebecca",
  4. "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign":"26B28A13AD3CB2BD928EB0F48392E47D",
  6. "data": {
  7. "winitProductCode": "OW01010382",
  8. "inspectionWarehouseCode": "SZ0001",
  9. "destinationWarehouseCode": "US0001"
  10. },
  11. "format": "json",
  12. "language": "zh_CN",
  13. "platform": "OWNERERP",
  14. "sign": "43A4ACFBC36578B984CF531D77D9874B",
  15. "sign_method": "md5",
  16. "timestamp": "2016-09-09 10:46:01",
  17. "version": "1.0"
  18. }

2、直发海外验Winit承运查询

  1. {
  2. "action": " winit.tms.getLogisticsPlan",
  3. "app_key": "rebecca",
  4. "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign":"26B28A13AD3CB2BD928EB0F48392E47D",
  6. "data": {
  7. "winitProductCode": "OW01010382",
  8. "inspectionWarehouseCode": "SZ0001",
  9. "destinationWarehouseCode": "US0001"
  10. },
  11. "format": "json",
  12. "language": "zh_CN",
  13. "platform": "OWNERERP",
  14. "sign": "43A4ACFBC36578B984CF531D77D9874B",
  15. "sign_method": "md5",
  16. "timestamp": "2016-09-09 10:46:01",
  17. "version": "1.0"
  18. }

返回出参

返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。

名称 类型 必传 说明 示例
planList Array Y 物流计划list
planCode String(50) Y 物流计划编码 198280
planName String(100) Y 物流计划名称 CNYTN-US-14-Jun
planType String(20) Y 物流计划类型:sea-海运,air-空运 sea
createOrderDeadline String(20) Y 截止下单时间
YYYY-MM-DD hh:mm:ss
pickupPackageDeadline String(20) Y 截止收货时间
YYYY-MM-DD hh:mm:ss
planOutboudDate String(20) Y 预计发货时间
YYYY-MM-DD hh:mm:ss
planShelfDate String(20) Y 预计到仓时间
YYYY-MM-DD hh:mm:ss

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {"planList": [
  5. {
  6. "planOutboudDate": "2019-06-15 05:50:07",
  7. "planType": "sea",
  8. "pickupPackageDeadline": "2019-06-15 00:50:07",
  9. "planName": "CNYTN-US-14-Jun",
  10. "createOrderDeadline": "2019-06-14 23:50:07",
  11. "planShelfDate": "2019-06-24 05:50:07",
  12. "planCode": "198280"
  13. },
  14. {
  15. "planOutboudDate": "2019-06-20 05:50:23",
  16. "planType": "sea",
  17. "pickupPackageDeadline": "2019-06-20 00:50:23",
  18. "planName": "CNYTN-US-19-Jun",
  19. "createOrderDeadline": "2019-06-19 23:50:23",
  20. "planShelfDate": "2019-06-29 05:50:23",
  21. "planCode": "198180"
  22. },
  23. {
  24. "planOutboudDate": "2019-06-21 05:50:07",
  25. "planType": "sea",
  26. "pickupPackageDeadline": "2019-06-21 00:50:07",
  27. "planName": "CNYTN-US-20-Jun",
  28. "createOrderDeadline": "2019-06-20 23:50:07",
  29. "planShelfDate": "2019-06-30 05:50:07",
  30. "planCode": "198292"
  31. },
  32. {
  33. "planOutboudDate": "2019-06-21 05:50:23",
  34. "planType": "sea",
  35. "pickupPackageDeadline": "2019-06-21 00:50:23",
  36. "planName": "CNYTN-US-20-Jun",
  37. "createOrderDeadline": "2019-06-20 23:50:23",
  38. "planShelfDate": "2019-06-30 05:50:23",
  39. "planCode": "198182"
  40. }
  41. ]}
  42. }