当前位置: API文档
spec_barcode_push.php(创建、更新系统规格多条码)
¥标准
1.接口说明
| 1.1 接口描述:创建、更新系统规格多条码 |
| 1.2 适用版本:网页版 |
1.3 注意事项:①每次请求,已存在的条码,执行更新操作。不存在的条码,执行新增操作。已存在但是未传输的条码不做处理。 ②当一次请求中存在重复条码时,需要提示“条码不允许重复”。 ③当请求中标识某一条记录为主条码时,自动清除已有的主条码记录标识,并同步更新sku的主条码字段。当一次请求中多条被标识为主条码时,需给出提示“只允许设置一个条码记录为主条码” |
2.调用场景
| 2.1 自研商城、 |
3.请求参数说明
3.1 请求地址
| 环境 | HTTP地址 |
|---|---|
| 测试环境 | https://openapi.ali.huice.cc/openapi/spec_barcode_push.php |
| 正式环境 | https://openapi.huice.com/openapi/spec_barcode_push.php |
3.2 公共请求参数
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| 卖家账号 | sid | String | 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 | |
| 接口账号 | appkey | String | 是 | 本开放平台“自助对接”功能模块内自助申请,申请流程单击这里 | |
| 时间戳 | timestamp | int | 是 | 北京时间1970-01 -01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务 端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 | |
| 签名 | sign | String | 是 | API输入参数签名结果,签名算法介绍单击这里 |
3.3 业务请求参数
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
| 商家编码(新) | spec_no | varchar | 255 | 是 | 商家编码(新) |
多条码列表 | barcode_list | data[ ] | 是 | 多条码列表 |
barcode_list
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
条码 | barcode_no | varchar | 是 | 条码,不允许重复 | |
| 数量 | num | int | 是 | 数量,主条码数量为1 | |
是否是主条码 | is_main_barcode | int | 否 | 1.是 0.否 默认为0 ;只允许设置一个条码记录为主条码 | |
是否删除 | deleted | int | 否 | 1.是 0.否 默认为0 |
spec_list
4.响应参数
4.1 公共响应参数
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
| 错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
| 错误描述 | message | varchar | 255 | 是 | 错误描述 |
5.请求示例
6.响应示例
6.1 正常响应示例
| JSON | {"code":0,"message":""} |
6.2 异常响应示例
| JSON | {"code":2541,"message":"请检查参数是否正确::条码不能为空、数量需要大于1"} |