C咖开放接口-同步商品
已支持：
1.新增时，可以添加商品的品牌、分类、包装比例、附件等信息
2.更新时，可以更新商品所属的品牌、所属分类、包装比例、附件以及商品自身的相关信息。
不支持:
1.通过商品编号，修改分类、品牌的名称等信息
API描述：新增时批量插入，更新逐条更新，批量最大不能超过100个。
请求流程
参阅 API开放平台接入指南
请求信息
|
协议 |
HTTPS |
|
请求方法 |
POST |
|
请求路径 |
/openapi/trace/app/v1/open/product/add-upd-product/batch-v2 |
|
请求头 |
Content-Type：application/json |
公共参数
通用请求头
请参阅 通用请求头
请求参数
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| commodityVoList | string[] | 必须 | 商品信息集合 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
传出参数
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | 错误码 | format: int32 | |
| data | string | 非必须 | 商品id | ||
| message | string | 非必须 | 消息内容 | ||
| timestamp | integer | 非必须 | 时间戳 | format: int64 | |
| traceId | string | 非必须 | 链路追踪ID |
请求示例
{
"commodityVoList": [
{
"productNo": "spc",
"productName": "spc名称",
"packScaleList": [
{
"packLevelSort": 1,
"packLevelUnit": "单品",
"codeLength": 12,
"packScaleQuantity": 3
},
{
"packLevelSort": 2,
"packLevelUnit": "箱",
"codeLength": 24,
"packScaleQuantity": 1
}
],
"productStandard": "",
"productModel": "",
"shelfLife": "",
"shelfLifeUnit": "",
"warrantyPeriod": "1",
"warrantyPeriodUnit": "1",
"remark": "",
"isGiftBox":1,
"giftBoxList": [ {
"productNo": "pro0521",
"productNum": 12,
"packLevelUnit": "盒"
}
]
}
]
}
响应示例
{
"code": 200,
"message": "success",
"data": "e8cd39d561754d36b454a9b841319b8d",
"timestamp": 1679565957862,
"traceId": "221198c7-ccf5-444e-a088-12aae8d995fd"
}
异常示例
{
"code": 135630001,
"message": "参数错误",
"traceId":"xxxxxx",
"timestamp": 1679368912568
}
返回码
| 返回码 | 描述 | 解决方案 |
|---|---|---|
| 21041000 | 商品状态不正确（0删除 1禁用 2启用） | |
| 21041001 | token不正确 | |
| 21041002 | 商品f3-f10长度不能大于200 | |
| 21040062 | 生码标记号已达到最大量，请联系管理员！ | |
| 21041003 | 商品规格长度不能大于50 | |
| 21041004 | 商品型号长度不能大于50 | |
| 21041005 | 保质期单位不正确（1:年 2：月 3：日） | |
| 21041006 | 质保期限单位不正确（1:年 2：月 3：日） | |
| 21041007 | 商品附件应为http开头，后缀为（png/jpg/bmp/gif/jpeg），长度不大于5000 | |
| 21041008 | 商品分类f1-f10长度不能大于200 | |
| 21041009 | 商品分类编号长度不能大于50 | |
| 21041010 | 商品分类名称长度不能大于128 | |
| 21041011 | 商品品牌编号长度不能大于50 | |
| 21041012 | 商品品牌名称长度不能大于128 | |
| 21041013 | 商品品牌f1-f10长度不能大于200 | |
| 21041014 | 商品包装单位名称长度不能大于50 | |
| 21041015 | 商品包装层级顺序应从1开始依次递增 | |
| 21041016 | 商品分类名称已存在 | |
| 21040029 | 商品分类编号不能为空 | |
| 21040056 | 备注长度不得超过256 | |
| 21040131 | 商品编号请输入长度1-128位的任意字符，不支持中文及空格 | |
| 21040125 | 商品名称1到128位 | |
| 21040051 | 商品名称不能为空 | |
| 21040122 | 保质期请输入长度9位内的正整数 | |
| 21040064 | 请输入正确的保质期 | |
| 21040134 | 质保期限请输入长度9位内的正整数 | |
| 21040135 | 请输入正确的质保期限 | |
| 21040065 | 包装比例不正确 | |
| 21040030 | 商品分类名称不能为空 | |
| 21040152 | 网络出现异常，请稍后重试 | |
| 21041017 | 品牌已禁用，请先启用品牌 | |
| 21041018 | 商品分类已禁用，请先启用商品分类 | |
| 21041019 | 商品集合不能为空 | |
| 21041020 | 商品编号集合不能为空 | |
| 21041021 | 根据包装单位名称和层级顺序未找到对应的包装层级 | |
| 21041022 | 码制长度必须全部填写或全部不填写 |