通过商品编号新增/修改商品信息V3（批量）

#  通过商品编号新增/修改商品信息V3（批量） `公开`

## 使用场景
>  已支持：
	1.新增时，可以添加商品的品牌、分类、包装比例、附件等信息
	2.更新时，可以更新商品所属的品牌、所属分类、包装比例、附件以及商品自身的相关信息。
>  不支持:
	1.通过商品编号，修改分类、品牌的名称等信息

## API描述
>  API描述：新增时批量插入，更新逐条更新，批量最大不能超过100个。

## 请求流程

>   1. 在超8平台中申请第三方系统的应用Access Key和密钥（线下）。
>   2. 第三方系统根据应用Access Key和密钥向系统发起**Access Token**申请【[如何获取token](https://developers.yesno.com.cn/doc/57/ "如何获取token")】。
>   3. 三方系统调用防伪领域服务的开放接口进行数据对接。

> 具体请求请参阅：
>请参阅  [请求流程](https://developers.yesno.com.cn/doc/56/ "请求流程")

## 请求信息

| 协议     | HTTPS                                                  |
|----------|-----------------------------------------------------------------------------------------------|
| 请求方法 | POST                                                   |
| 请求路径 | /base/app/v3/open/product/add-upd-product/batch-v2                |

### header头
请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/ "请求头")

## 请求参数

<tr><td>commodityVoList</td><td>string[]</td><td>必须</td><td></td><td>商品信息集合</td><td></td></tr>
<tr><td colspan="6">
<table>
	<tr><td>productNo</td><td>string</td><td>必须</td><td></td><td>商品编号</td><td>1-128位的任意字符，不支持中文及空格</td></tr>
	<tr><td>productName</td><td>string</td><td>新增时必须</td><td></td><td>商品名称</td><td>商品名称1到128位</td></tr>
	
<tr><td>packScaleList</td><td>object[]</td><td>不必须</td><td></td><td>包装比例</td><td>新增时不填则默认包装层级1层、数码长度12、单位【单品】</td></tr>

<tr><td colspan="6">
<table>
<tr><td>packLevelSort</td><td>int</td><td>必须</td><td></td><td>层级顺序</td><td></td></tr>
<tr><td>packLevelUnit</td><td>string</td><td>必须</td><td></td><td>包装单位名称</td><td>长度不能大于50</td></tr>
<tr><td>codeLength</td><td>int</td><td>非必须</td><td></td><td>码制长度</td><td>只能全部填写或全部不填写；不填写时，根据包装单位名称和层级顺序查找现有的包装层级配置，找不到提示错误</td></tr>
<tr><td>packScaleQuantity</td><td>int</td><td>必须</td><td></td><td>相应层级包装比例数字</td><td></td></tr>
</table>
</td></tr>

<tr><td>category</td><td>object</td><td>不必填</td><td></td><td>商品分类</td><td></td></tr>

<tr><td colspan="6">
<table>
<tr><td>categoryNo</td><td>string</td><td>必须</td><td></td><td>商品分类编号</td><td>长度不能大于50</td></tr>
<tr><td>categoryName</td><td>string</td><td>必须</td><td></td><td>商品分类名称</td><td>长度不能大于128</td></tr>
<tr><td>remark</td><td>string</td><td>非必须</td><td></td><td>备注</td><td>长度不能大于256</td></tr>
<tr><td>f1</td><td>string</td><td>非必须</td><td></td><td>f1</td><td>长度不能大于200</td></tr>
<tr><td>f2</td><td>string</td><td>非必须</td><td></td><td>f2</td><td>长度不能大于200</td></tr>
<tr><td>f3</td><td>string</td><td>非必须</td><td></td><td>f3</td><td>长度不能大于200</td></tr>
<tr><td>f4</td><td>string</td><td>非必须</td><td></td><td>f4</td><td>长度不能大于200</td></tr>
<tr><td>f5</td><td>string</td><td>非必须</td><td></td><td>f5</td><td>长度不能大于200</td></tr>
<tr><td>f6</td><td>string</td><td>非必须</td><td></td><td>f6</td><td>长度不能大于200</td></tr>
<tr><td>f7</td><td>string</td><td>非必须</td><td></td><td>f7</td><td>长度不能大于200</td></tr>
<tr><td>f8</td><td>string</td><td>非必须</td><td></td><td>f8</td><td>长度不能大于200</td></tr>
<tr><td>f9</td><td>string</td><td>非必须</td><td></td><td>f9</td><td>长度不能大于200</td></tr>
<tr><td>f10</td><td>string</td><td>非必须</td><td></td><td>f10</td><td>长度不能大于200</td></tr>
</table>
</td></tr>

<tr><td>brand</td><td>object</td><td>不必须</td><td></td><td>商品品牌</td><td></td></tr>

<tr><td colspan="6">
<table>
<tr><td>brandNo</td><td>string</td><td>必须</td><td></td><td>品牌编号</td><td>长度不能大于50</td></tr>
<tr><td>brandName</td><td>string</td><td>必须</td><td></td><td>品牌名称</td><td>长度不能大于128</td></tr>
<tr><td>remark</td><td>string</td><td>非必须</td><td></td><td>备注</td><td>长度不能大于256</td></tr>
<tr><td>f1</td><td>string</td><td>非必须</td><td></td><td>f1</td><td>长度不能大于200</td></tr>
<tr><td>f2</td><td>string</td><td>非必须</td><td></td><td>f2</td><td>长度不能大于200</td></tr>
<tr><td>f3</td><td>string</td><td>非必须</td><td></td><td>f3</td><td>长度不能大于200</td></tr>
<tr><td>f4</td><td>string</td><td>非必须</td><td></td><td>f4</td><td>长度不能大于200</td></tr>
<tr><td>f5</td><td>string</td><td>非必须</td><td></td><td>f5</td><td>长度不能大于200</td></tr>
<tr><td>f6</td><td>string</td><td>非必须</td><td></td><td>f6</td><td>长度不能大于200</td></tr>
<tr><td>f7</td><td>string</td><td>非必须</td><td></td><td>f7</td><td>长度不能大于200</td></tr>
<tr><td>f8</td><td>string</td><td>非必须</td><td></td><td>f8</td><td>长度不能大于200</td></tr>
<tr><td>f9</td><td>string</td><td>非必须</td><td></td><td>f9</td><td>长度不能大于200</td></tr>
<tr><td>f10</td><td>string</td><td>非必须</td><td></td><td>f10</td><td>长度不能大于200</td></tr>
</table>
</td></tr>

<tr><td>productModel</td><td>string</td><td>非必须</td><td></td><td>商品型号</td><td>长度不能大于50</td></tr>
<tr><td>productStandard</td><td>string</td><td>非必须</td><td></td><td>商品规格</td><td>长度不能大于50</td></tr>

<tr><td>shelfLife</td><td>string</td><td>非必须</td><td></td><td>保质期</td><td>填写数字，如果需要控制商品的保质期请和【保质期单位】联合传输</td></tr>
<tr><td>shelfLifeUnit</td><td>string</td><td>非必须</td><td></td><td>保质期单位</td><td>1：年，2：月；3：天</td></tr>

<tr><td>warrantyPeriod</td><td>int</td><td>非必须</td><td></td><td>质保期限</td><td>填写数字，如果需要控制商品的质保期请和【质保期限单位】联合传输</td></tr>
<tr><td>warrantyPeriodUnit</td><td>string</td><td>非必须</td><td></td><td>质保期限单位</td><td>1：年，2：月；3：天</td></tr>

<tr><td>attachments</td><td>string[]</td><td>非必须</td><td></td><td>商品附件</td><td>商品附件集合，http开头jpg|gif|png|bmp|jpeg结尾的url链接集合,长度不能大于5000</td></tr>

<tr><td>remark</td><td>string</td><td>非必须</td><td></td><td>备注</td><td>长度不能大于256</td></tr>

<tr><td>flag</td><td>int</td><td>非必须</td><td></td><td>商品状态</td><td>0删除1禁用2启用,不必填,新增时不填则默认启用</td></tr>

<tr><td>f1</td><td>string</td><td>非必须</td><td></td><td>f1</td><td></td></tr>
<tr><td>f2</td><td>string</td><td>非必须</td><td></td><td>f2</td><td></td></tr>
<tr><td>f3</td><td>string</td><td>非必须</td><td></td><td>f3</td><td>长度不能大于200</td></tr>
<tr><td>f4</td><td>string</td><td>非必须</td><td></td><td>f4</td><td>长度不能大于200</td></tr>
<tr><td>f5</td><td>string</td><td>非必须</td><td></td><td>f5</td><td>长度不能大于200</td></tr>
<tr><td>f6</td><td>string</td><td>非必须</td><td></td><td>f6</td><td>长度不能大于200</td></tr>
<tr><td>f7</td><td>string</td><td>非必须</td><td></td><td>f7</td><td>长度不能大于200</td></tr>
<tr><td>f8</td><td>string</td><td>非必须</td><td></td><td>f8</td><td>长度不能大于200</td></tr>
<tr><td>f9</td><td>string</td><td>非必须</td><td></td><td>f9</td><td>长度不能大于200</td></tr>
<tr><td>f10</td><td>string</td><td>非必须</td><td></td><td>f10</td><td>长度不能大于200</td></tr>

</table>

## 返回消息体

| 名称      | 类型    | 是否必须 | 默认值 | 备注       | 其他信息          |
|-----------|---------|----------|--------|------------|-------------------|
| code      | integer | 非必须   |        | 错误码     | **format:** int32 |
| data      | string  | 非必须   |        | 商品id       |                   |
| message   | string  | 非必须   |        | 消息内容   |                   |
| timestamp | integer | 非必须   |        | 时间戳     | **format:** int64 |
| traceId   | string  | 非必须   |        | 链路追踪ID |                   |

## 请求示例
``` text
请求地址：{URL}/base/app/v3/open/product/add-upd-product/batch-v2
Post参数：
{
  "commodityVoList": [
    {
      "productNo": "spc",
      "productName": "spc名称",
      "packScaleList": [
        {
          "packLevelSort": 1,
          "packLevelUnit": "单品",
          "codeLength": 12,
          "packScaleQuantity": 3
        },
        {
          "packLevelSort": 2,
          "packLevelUnit": "箱",
          "codeLength": 24,
          "packScaleQuantity": 1
        }
      ],
      "category": {
        "categoryNo": "categoryNo01-sff",
        "categoryName": "catcategoryName01-sff",
        "remark": "remark01",
        "f1": "f1",
        "f2": "f2",
        "f3": "f3",
        "f4": "f4",
        "f5": "f5",
        "f6": "f6",
        "f7": "f7",
        "f8": "f8",
        "f9": "f9",
        "f10": "f10"
      },
      "brand": {
        "brandNo": "brandNo01-sff",
        "brandName": "brandName01-sff",
        "remark": "remark01",
        "f1": "f1",
        "f2": "f2",
        "f3": "f3",
        "f4": "f4",
        "f5": "f5",
        "f6": "f6",
        "f7": "f7",
        "f8": "f8",
        "f9": "f9",
        "f10": "f10"
      },
      "productStandard": "productStandard01",
      "productModel": "productModel01",
      "shelfLife": "1",
      "shelfLifeUnit": "1",
      "warrantyPeriod": "2",
      "warrantyPeriodUnit": "2",
      "attachments": [
        "https://hive-alpha.oss-cn-shanghai.aliyuncs.com/sup8-upload/1_1727581450645299200.jpg",
        "https://tx-assets-test.supercarrier8.com/sup8-upload/3283781224.gif"
      ],
      "remark": "remark01",
      "flag": "2",
      "f1": "f1",
      "f2": "f2",
      "f3": "f3",
      "f4": "f4",
      "f5": "f5",
      "f6": "f6",
      "f7": "f7",
      "f8": "f8",
      "f9": "f9",
      "f10": "f10"
    },
    {
      "productNo": "spc2",
      "productName": "spc名称2",
      "packScaleList": [
        {
          "packLevelSort": 1,
          "packLevelUnit": "单品",
          "codeLength": 12,
          "packScaleQuantity": 3
        },
        {
          "packLevelSort": 2,
          "packLevelUnit": "箱",
          "codeLength": 24,
          "packScaleQuantity": 1
        }
      ],
      "category": {
        "categoryNo": "categoryNo02-sff",
        "categoryName": "catcategoryName02-sff",
        "remark": "remark02",
        "f1": "f1",
        "f2": "f2",
        "f3": "f3",
        "f4": "f4",
        "f5": "f5",
        "f6": "f6",
        "f7": "f7",
        "f8": "f8",
        "f9": "f9",
        "f10": "f10"
      },
      "brand": {
        "brandNo": "brandNo02-sff",
        "brandName": "brandName02-sff",
        "remark": "remark02",
        "f1": "f1",
        "f2": "f2",
        "f3": "f3",
        "f4": "f4",
        "f5": "f5",
        "f6": "f6",
        "f7": "f7",
        "f8": "f8",
        "f9": "f9",
        "f10": "f10"
      },
      "productStandard": "productStandard02",
      "productModel": "productModel02",
      "shelfLife": "1",
      "shelfLifeUnit": "1",
      "warrantyPeriod": "2",
      "warrantyPeriodUnit": "2",
      "attachments": [
        "https://hive-alpha.oss-cn-shanghai.aliyuncs.com/sup8-upload/1_1727581450645299200.jpg",
        "https://tx-assets-test.supercarrier8.com/sup8-upload/3283781224.gif"
      ],
      "remark": "remark02",
      "flag": "2",
      "f1": "f1",
      "f2": "f2",
      "f3": "f3",
      "f4": "f4",
      "f5": "f5",
      "f6": "f6",
      "f7": "f7",
      "f8": "f8",
      "f9": "f9",
      "f10": "f10"
    }
  ]
}
```

## 响应示例

```json
{
    "code": 200,
    "message": "success",
    "data": "e8cd39d561754d36b454a9b841319b8d",
    "timestamp": 1679565957862,
    "traceId": "221198c7-ccf5-444e-a088-12aae8d995fd"
}
```

## 异常示例
```json
{
  "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|码制长度必须全部填写或全部不填写