API
打印商品条码标签-返回带有单品信息
更新时间: 2023-08-17 15:49:39 访问次数:14814

接口说明

通过本接口用户可打印已经注册并发布商品条码label,并查询到商品S码。

使用场景

用户在入库之前通过该接口打印商品条码label,张贴至每个商品上,用于验货扫描。
可用于单品化管理的商品,返回条码文件同时返回单品S码。也可用于商品化管理的商品,仅返回条码文件

接口名称

winit.singleitem.label.print.v2

请求说明

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

请求入参

名称 类型 必填 说明 示例
singleItems Array Y 单品信息数据list
–productCode String(100) Y 商品编码 LCD-IP4S-02
–specification String(255) N 产品规格
–printQty Integer Y 打印数量,<1000
若为数组,则总数<1000
10
labelType String(10) Y 条码尺寸类型
LZ10060:100x60mm;
LZ7050:70x50mm;
LZ6040:60x40mm
仅返回指定尺寸的单品条码
LZ10060
madeIn String(40) Y 产地,选择China/None
None:不显示信息在条码
China:显示make in china
China
isEar String(1) N 是否带欧代信息,Y\N,不传默认为N
Y:打印的条码中,带有欧代信息。(前提是维护了欧代信息)
N:打印的条码不变,不带有欧代信息

请求示例

  1. {
  2. "action": "winit.singleitem.label.print.v2",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "5AFF6FB9F1821C8F2D7DB6BA0899ED0E",
  6. "data": {
  7. "singleItems": [{
  8. "productCode": "FGBX001",
  9. "specification": "",
  10. "printQty": "10"
  11. }],
  12. "labelType": "LZ10060",
  13. "madeIn": "China"
  14. },
  15. "format": "json",
  16. "language": "zh_CN",
  17. "sign": "8C8BD249EFF148A855AF35009AC5F0F2",
  18. "sign_method": "md5",
  19. "timestamp": "2015-06-16 00:19:26",
  20. "platform": "OWNERERP",
  21. "version": "1.0"
  22. }

返回出参

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

名称 类型 必传 说明 示例
formatType String(20) Y itemBarcodeFile解析后的文件类型 pdf
itemBarcodeFile String Y bese64标签字符串(PDF)
itemBarcodeList Array Y 商品S码 S500086000146277531

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "formatType": "pdf",
  6. "itemBarcodeFile": "JVBERi0xLjQKJeLjz9MKNSAwIG9iago8PC9Db2xvclNwYWNlWy9JbmRleGVkL0RldmljZVJHQiAyNTUoAAAAgGCg==",
  7. "itemBarcodeList": [
  8. "S500070000146278230",
  9. "S500081000146278229",
  10. "S500082000146278228",
  11. "S500083000146278227",
  12. "S500084000146278226",
  13. "S500085000146278225",
  14. "S500086000146278224",
  15. "S500087000146278223",
  16. "S500088000146278222",
  17. "S500089000146278221"
  18. ]
  19. }
  20. }