API
直发入库-上传快递单号
更新时间: 2023-08-27 20:13:41 访问次数:2175

接口说明

入库类型为直发类的订单时,可批量上传快递单号

使用场景

直发自验或直发海外验入库单使用

接口名称

wh.inboundOrder.uploadExpressNo

请求说明

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

请求入参

名称 类型 必填 说明 示例
orderList Array Y 订单列表
-|orderNo String() Y 入库单号
-|uploadDimension String() Y PACKAGE - 包裹维度
ORDER - 订单维度

-|expressNoList Array Y 快递单号集合
-|-|expressNo String() Y 快递单号
-|-|expressCompany String() Y 快递公司
-|-|sellerCaseNo String() N 当选择订单维度时,非必填,如果填写,系统自动忽略。
当选择包裹维度时sellerCaseNo和thirdPartyCaseNo至少传入1个

-|-|thirdPartyCaseNo String() N 当选择订单维度时,非必填,如果填写,系统自动忽略。
当选择包裹维度时sellerCaseNo和thirdPartyCaseNo至少传入1个

请求示例

  1. {
  2. "action": "wh.inboundOrder.uploadExpressNo",
  3. "app_key": "rebecca",
  4. "data": {
  5. "orderList": [
  6. {
  7. "orderNo": "WI9900002340",
  8. "uploadDimension": "PACKAGE",
  9. "expressNoList": [
  10. {
  11. "expressNo": "111011eeeDDDD2",
  12. "expressCompany": "UPS",
  13. "sellerCaseNo": "1",
  14. "thirdPartyCaseNo": ""
  15. }
  16. ]
  17. }
  18. ]
  19. },
  20. "format": "json",
  21. "platform": "sw",
  22. "sign_method": "md5",
  23. "timestamp": "2021-10-19 11:58:24",
  24. "version": "1.0",
  25. "sign": "00000000000000000000000000000000",
  26. "language": "zh_cn"
  27. }

返回出参

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

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功"
  4. }
关键词