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

接口说明

该接口可以查询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. }