API
查询商品的单品条码及其状态
更新时间： 2023-08-17 16:12:07 访问次数：6810

接口说明

该接口可以查询SKU对应的单品信息及单品状态。

接口名称

winit.singleitem.list

请求说明

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

请求入参

名称 类型 必填 说明 示例
skuCode String(255) Y 商品编码 LCD-IP5-01
specification String(255) N 商品规格 红色
barcode String(255) N 单品条码 S000000000123456789
status String(255) N 单品状态
准备中：INIT；
在途：ON_ORDER；
待发：WAITING_OUTBOUND；
可用：USABLE；
待销毁：WAITING_DESTRUCTION；
丢失确认中：LOST_CONFIRMING；
已丢失：LOST；
已销毁：DESTRUCTION；
已出库：OUTBOUND；
已拣选：PICKED；
已打包：PACKED；
拣选完成：PKC；
海外已拆包：SPLIT；
入库丢失：LOST_INBOUND；		 INIT
pageVo Object Y 分页参数list
–|pageNo Int Y 页码/第几页
–|pageSize Int Y 分页大小/每页条数

请求示例

1、全部查询

  1. {
  2.     "action": "winit.singleitem.list",
  3.     "app_key": "rebecca",
  4.     "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5.     "data": {
  6.         "skuCode": "LCD-IP5-01",
  7.         "specification": "",
  8.         "barcode": "",
  9.         "status": "",
  10.         "pageVo": {
  11.             "pageNo": 1,
  12.             "pageSize": 10
  13.         }
  14.     },
  15.     "format": "json",
  16.     "language": "zh_CN",
  17.     "sign": "F60496CD31D565C8CEDA1115606927C1",
  18.     "sign_method": "md5",
  19.     "platform": "OWNERERP",
  20.     "timestamp": "2015-06-16 00:19:26",
  21.     "version": "1.0",
  22.     "client_sign": "903150A315B5F3A024BD52191F81B25C"
  23. }

2、单个查询

  1. {
  2.     "action": "winit.singleitem.list",
  3.     "app_key": "rebecca",
  4.     "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5.     "data": {
  6.         "skuCode": "LCD-IP5-01",
  7.         "specification": "",
  8.         "barcode": "S509900000005456771",
  9.         "status": "",
  10.         "pageVo": {
  11.             "pageNo": 1,
  12.             "pageSize": 10
  13.         }
  14.     },
  15.     "format": "json",
  16.     "language": "zh_CN",
  17.     "sign": "32FE9622B48339D4C25D56C83B0A5106",
  18.     "sign_method": "md5",
  19.     "platform": "OWNERERP",
  20.     "timestamp": "2015-06-16 00:19:26",
  21.     "version": "1.0",
  22.     "client_sign": "950C11C547B27E0047A2B5D295398C91"
  23. }

返回出参

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

名称 类型 必传 说明 示例
list Array Y 查询结果list
sku String() Y 商品条码
skuCode String() Y 商品编码
specification String() Y 商品规格
barcode String() Y 单品条码
status String() Y 单品状态
pageParams Object Y 分页参数list
pageNo Int Y 页码/第几页
pageSize Int Y 分页大小/每页条数
totalCount Int Y 总记录数

返回示例

  1. {
  2.     "code": "0",
  3.     "msg": "操作成功",
  4.     "data": {
  5.         "pageParams": {
  6.             "pageNo": 1,
  7.             "pageSize": 10,
  8.             "totalCount": 20095
  9.         },
  10.         "list": [
  11.             {
  12.                 "barcode": "S509900000005456774",
  13.                 "sku": "M010000000000062792",
  14.                 "skuCode": "LCD-IP5-01",
  15.                 "specification": "",
  16.                 "status": "USABLE",
  17.                 "merchandiseName": null,
  18.                 "merchandiseCnName": null,
  19.                 "skuType": null,
  20.                 "standardQty": null,
  21.                 "updated": "2019-01-24 09:47:00"
  22.             },
  23.             {
  24.                 "barcode": "S509900000005456765",
  25.                 "sku": "M010000000000062792",
  26.                 "skuCode": "LCD-IP5-01",
  27.                 "specification": "",
  28.                 "status": "USABLE",
  29.                 "merchandiseName": null,
  30.                 "merchandiseCnName": null,
  31.                 "skuType": null,
  32.                 "standardQty": null,
  33.                 "updated": "2019-01-24 09:47:00"
  34.             }
  35.         ]
  36.     }
  37. }