API
新增第三方商品条码
更新时间: 2025-08-07 10:37:43 访问次数:70

接口说明

通过此接口支持绑定SKU的第三方商品条码,单次最大限制200;

使用场景

商品发货到仓实物上粘贴为第三方的商品条码(一品一码),避免到仓无法识别商品,需及时进行关联第三方商品条码与商品;

接口名称

winit.item.batchSaveSkuCodeThird

请求说明

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

请求入参

字段 类型 必填 说明 示例
BatchModifySkuCodeThirdVos Array Y 要新增的条码
– skuCode String(40) Y 商品编码 SKU000123
– specification String(40) N 规格
开通白名单且有规则的商品需提供
– skuCodeThird String(48) Y 第三方商品条码
关联此商品的第三方商品条码,实物条码扫描结果。
A0092983991
– countryCode String(2) O 国家二字简称
美国:US
英国:UK
德国:DE
……
开通国家级第三方商品条码必填,指定此第三方商品条码生效的国家
– description String(40) N 备注信息

请求示例

  1. {
  2. "action": "winit.item.batchSaveSkuCodeThird",
  3. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  4. "app_key": "rebecca",
  5. "data": {
  6. "sernos": [
  7. {
  8. "skuCode": "FGBX001",
  9. "specification": "",
  10. "skuCodeThird": "1123341123",
  11. }
  12. ]
  13. },
  14. "format": "json",
  15. "language": "zh_CN",
  16. "sign": "101CD26CAF7DCF80ED0C04D6F4498AEA",
  17. "sign_method": "md5",
  18. "platform": "OWNERERP",
  19. "timestamp": "2015-06-16 00:19:26",
  20. "version": "1.0",
  21. "client_sign": "F4C23238246754CF1A5354DA3349C915"
  22. }

返回出参

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

名称 类型 必传 说明 示例
row String | 出错的行数
barcode String | 出错的条码
errorMsg String | 出错的原因

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "errorMsgs": []
  6. }
  7. }
  1. {
  2. "code": "0",
  3. "msg": "",
  4. "data": [
  5. {
  6. "row": 0,
  7. "barcode": "zshre58383",
  8. "errorMsg": "商品不存在, 商品编码[auto_sku24],规格[]"
  9. }
  10. ]
  11. }
关键词