API
批量作废出库单
更新时间: 2023-08-27 23:22:32 访问次数:4880

接口说明

本接口可以作废海外仓出库单(支持多个作废)
作废结果分为三个(1)作废成功,(2)作废失败,(3)作废中,
订单作废中,需要再次查询订单详情,订单状态变更为 已作废(VO)才算作废成功。

接口名称

wh.outbound.batchVoidOrder

请求说明

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

请求入参

名称 类型 必填 说明 示例
orderNoList Array Y 作废订单列表
orderNo String() Y 作废winit订单号 WO0000009902
cancelReason String() N 作废订单原因 testforcancel

请求示例

  1. {
  2. "action": "wh.outbound.batchVoidOrder",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "8A631AE2464DE716BB7CC815BFEF87D3",
  6. "data": {
  7. "orderNoList": [
  8. {
  9. "orderNo": "WO0000009902",
  10. "cancelReason": "testforcancel"
  11. },
  12. {
  13. "orderNo": "WO0000009911",
  14. "cancelReason": "11111"
  15. }
  16. ]
  17. },
  18. "format": "json",
  19. "language": "zh_CN",
  20. "platform": "OWNERERP",
  21. "sign": "ED8A9D0ED4772BA0516ED65B7BD94ACF",
  22. "sign_method": "md5",
  23. "timestamp": "2015-06-16 00:19:26",
  24. "version": "1.0"
  25. }

返回出参

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

名称 类型 必传 说明 示例
failNum Number() Y 作废失败数量 0
successNum number() Y 作废成功数量 2
response Array N 失败原因
errorOrderNo String() Y 作废失败订单号 WO0000009828
errorCode String() Y 作废失败代码
查看出库单作废失败代码

errorMsg String() Y 作废失败的原因描述

返回示例

1.作废成功

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "failNum": 0,
  6. "successNum": 2,
  7. "response": null
  8. }
  9. }

2.作废失败

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "failNum": 2,
  6. "successNum": 0,
  7. "response": [
  8. {
  9. "errorIndex": null,
  10. "errorOrderNo": "WO0000009828",
  11. "errorCode": "02020240223",
  12. "errorMsg": "作废失败,订单仅支持草稿、出库确认中、出库确认、拣选异常状态下作废,当前订单状态为派送失败"
  13. },
  14. {
  15. "errorIndex": null,
  16. "errorOrderNo": "WO0000009911",
  17. "errorCode": "02020240223",
  18. "errorMsg": "作废失败,订单仅支持草稿、出库确认中、出库确认、拣选异常状态下作废,当前订单状态为派送中"
  19. }
  20. ]
  21. }
  22. }

3.作废中

  1. {
  2. "code": "02010250093",
  3. "msg": "订单正在作废中,请稍后再确认是否作废成功"
  4. }
关键词