API
查询出库单(列表)
更新时间: 2024-07-15 10:26:39 访问次数:18465

接口说明

卖家或第三方通过该接口可查询出库单。

接口名称

queryOutboundOrderList

请求说明

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

请求入参

名称 类型 必填 说明 示例
warehouseId String() N 海外仓仓库Id
outboundOrderNum String() N 海外仓出库单号
sellerOrderNo String() N 卖家订单号(自定义)
trackingNo String() N 快递单号
receiverName String() N 收件人姓名
bookingOperator String() N winit客户名称
productValue String() N 产品编码
productName String() N 产品名称
productSku String() N 商品SKU
dateOrderedStartDate String(10) Y yyyy-MM-dd 出库单提交时间
dateOrderedEndDate String(10) Y yyyy-MM-dd 出库单提交时间
status String() N 订单状态编码,详见出库单状态列表
“status”不填写的时候,默认不包含VO(已作废)的订单,如需查询“已作废”的订单,请入参status=”VO”
pageSize integer Y 每页显示数量
pageNum integer Y 页码,默认1

已停用字段:
shareOrderType是否共享订单(已停用) 0:不包含共享信息 1:包含共享信息 2:共享方 3:被共享方 [默认为0]

请求示例

  1. {
  2. "action": "queryOutboundOrderList",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "B9DE8A08181811889837EB365E4FD933",
  6. "data": {
  7. "dateOrderedStartDate": "2018-06-15",
  8. "dateOrderedEndDate": "2029-06-20",
  9. "pageSize": "10",
  10. "pageNum": "1"
  11. },
  12. "format": "json",
  13. "language": "zh_CN",
  14. "platform": "OWNERERP",
  15. "sign": "AF335602C0257273694DC97E7559ECDF",
  16. "sign_method": "md5",
  17. "timestamp": "",
  18. "version": "1.0"
  19. }

返回出参

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

名称 类型 必传 说明 示例
exwarehouseId String() Y 出库单ID -
documentNo String() Y 海外仓出库单号
sellerOrderNo String() Y 卖家订单号
status String() Y 订单状态编码
statusName String() Y 出库单状态中文名 出库确认中
warehouseId String() Y 下单仓库ID
warehouseName String() Y 下单仓库名称 USWC Warehouse
deliverywayId String() Y 下单发货渠道ID
deliverywayName String() Y 下单发货渠道 AU Post eParcel
actualWarehouseInfoList Array Y 实际发货的仓库列表
-|warehouseID String() Y 实际发货的仓库ID
-|warehouseCode String() Y 实际发货的仓库编码
-|warehouseName String() Y 实际发货的仓库名称
actualProductInfoList Array Y 实际发货的渠道列表
-|deliveryWayID String() Y 实际发货的渠道ID
-|winitProductCode String() Y 实际发货的渠道编码
-|winitProductName String() Y 实际发货的渠道名称
carrierHasChange String() Y 派送商是否已更新
当下单渠道为组合服务时,返回“O”;
当下单渠道为非组合服务时,下单渠道的派送商与实际发货的渠道的派送商不一致时,返回“Y”,否则返回“N”

trackingNo String() Y 快递单号
countryName String() Y 国家 US
postal String() Y 邮编
name String() Y 收件人姓名
ontimeStatus String() Y 准时派送(服务时间、完成时间)
sku String() Y 商品编码SKU LCD-IP5-01
itemqty Integer Y 单品数量
weight Numeric(10,2) Y 重量(kg)
isEBayOrder String() Y 是否ebay订单
eBaySellerID String() Y eBaySellerID
storageOntime String() Y 服务时间(天)
serviceStandardTime String() Y 标准时间(天)
serviceCompleteTime String() Y 完成时间(天)
bpName String() Y 下单人 1000136
dateOrdered Date Y 下单时间 2015-06-23 15:16:49
dateFinish Date Y 出库时间
isShareOrder String() Y 是否为代销出库单 -
cBpartnerId String() Y 业务伙伴 -
cFromBpartnerId String() Y 共享方ID -
cToBpartnerId String() Y 代销商ID -
isError String() Y Y:成功,N:失败 -
totalCost String N 订单总费用
包含增值服务费用
VASFeeCost String N 总增值服务费用
packageList Array Y 包裹列表
–|packageNum String() Y 包裹编号
–|status String() Y 包裹状态编码
一个订单一个包裹的情况下跟出库单状态编码相同
一个订单多个包裹的情况下,则有可能包裹状态跟出库单状态不相同

-|warehouseID String() Y 实际发货的仓库ID
-|warehouseCode String() Y 实际发货的仓库编码
-|warehouseName String() Y 实际发货的仓库名称
-|deliveryWayID String() Y 实际发货的渠道ID
-|winitProductCode String() Y 实际发货的渠道编码
-|winitProductName String() Y 实际发货的渠道名称
–|weight Number Y 包裹重量Kg
–|trackingNos Array Y 包裹跟踪号
–|sku String Y 商品编码
–|itemqty Integer Y 包裹中商品数量
–|serviceCompleteTime String() Y 订单处理完成时间(天)
–|serviceStandardTime String() Y 订单处理标准时间(天)
–|ontimeStatus String() Y 准时派送(服务时间、完成时间)

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "currentPageSize": 10,
  6. "total": 257,
  7. "currentPageNum": 1,
  8. "list": [
  9. {
  10. "actualWarehouseInfoList": [
  11. {
  12. "warehouseID": "123",
  13. "warehouseCode": "EWD",
  14. "warehouseName": "AU Warehouse"
  15. }
  16. ],
  17. "actualProductInfoList": [
  18. {
  19. "deliveryWayID": "123",
  20. "winitProductCode": "OSF81232",
  21. "winitProductName": "AU Post - Parcel Post eParcel (Standard 2-6 Business Days)"
  22. }
  23. ],
  24. "carrierHasChange": "N",
  25. "winitTrackingNo": null,
  26. "sellerOrderNo": "PowerSellerABC1234",
  27. "serviceNormDay": null,
  28. "cFromBpartnerId": 0,
  29. "deliverywayId": 1000020,
  30. "dateFinish": null,
  31. "warehouseName": "AU Warehouse",
  32. "warehouseCode": "EWD",
  33. "isAddressError": "",
  34. "isShareOrder": "N",
  35. "documentNo": "WO0000004020",
  36. "winit_trackingno": null,
  37. "eBaySellerID": "PowerSellerABC124",
  38. "dateOrdered": "2019-08-23 15:48:51",
  39. "statusName": "出库确认",
  40. "deliverywayName": "AU Post - Parcel Post eParcel (Standard 2-6 Business Days)",
  41. "currency": "AUD",
  42. "is_ebay_plus": "N",
  43. "isRepeat": "N",
  44. "sku": "LCD-IP4-01@@1@@M010000000000062788@@",
  45. "serviceCompletionDay": null,
  46. "isEBayOrder": "Y",
  47. "estimateFees": 7.41,
  48. "itemqty": 0,
  49. "sellerWeight": null,
  50. "exwarehouseId": 402,
  51. "weight": null,
  52. "estimateVolume": 0.000756,
  53. "packageList": [
  54. {
  55. "itemqty": 1,
  56. "serviceCompleteTime": 0,
  57. "ontimeStatus": null,
  58. "trackingNos": null,
  59. "weight": null,
  60. "serviceStandardTime": 0,
  61. "sku": "LCD-IP4-01*1",
  62. "packageNum": "WO0000004020A",
  63. "status": "CF",
  64. "warehouseID": "123",
  65. "warehouseCode": "EWD",
  66. "warehouseName": "AU Warehouse",
  67. "deliveryWayID": "123",
  68. "winitProductCode": "OSF81232",
  69. "winitProductName": "AU Post - Parcel Post eParcel (Standard 2-6 Business Days)"
  70. }
  71. ],
  72. "storageOntime": null,
  73. "errorMsg": "",
  74. "estimateWeight": 0.01,
  75. "volume": null,
  76. "ontimeStatus": null,
  77. "serviceCompleteTime": null,
  78. "bpName": "万邑通质量保证部测试账号1-TEST",
  79. "ontimeTrack": null,
  80. "warehouseId": 1000001,
  81. "trackingNo": "",
  82. "name": "mingbao",
  83. "cToBpartnerId": 0,
  84. "serviceStandardTime": null,
  85. "finishedTime": null,
  86. "winitProductCode": "OSF810100",
  87. "postal": "3153",
  88. "countryName": "澳大利亚",
  89. "cBpartnerId": 1000019,
  90. "status": "CF"
  91. }
  92. ]
  93. }
  94. }