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

#  通过商品编号新增/修改商品信息 `公开`

## 支持场景
>  已支持：操作商品的品牌、品类、名称、编号、包装比例、附件……

## API描述
>  API描述：操作商品的详细信息

## 请求流程

>   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                                                   |
| 请求路径 | /ps/v1/open/product/add-upd-product                |

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

## 请求参数

<table>
 <tr><td> 名称              </td><td> 类型      </td> <td> 是否必须 </td> <td> 默认值 </td> <td> 备注                          </td> <td> 其他信息                                </td> </tr>
 <tr><td> attachments      </td> <td>object [] </td> <td> 非必须   </td> <td>        </td> <td> 商品附件                      </td> <td>                 </td> </tr>
 
<tr><td colspan="6">
  <table>
 <tr> <td> attachmentPath        </td> <td>string   </td> <td> 非必须   </td> <td>        </td> <td> 附件地址                      </td> <td>                        </td> </tr>
   </table>
  </td></tr>
  <tr><td> brandId          </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> 商品品牌编号                      </td> <td>                                         </td> </tr>
  <tr><td> brandName        </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> 商品品牌名称                  </td> <td>                                          </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>                                         </td> </tr>
 <tr><td> f4               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> f4                            </td> <td>                                          </td> </tr>
 <tr><td> f5               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> f5                            </td> <td>                                         </td> </tr>
 <tr> <td> f6               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> f6                            </td> <td>                                          </td> </tr>
  <tr><td> f7               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> f7                            </td> <td>                                         </td> </tr>
  <tr><td> f8               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> f8                            </td> <td>                                         </td> </tr>
  <tr><td> f9               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> f9                            </td> <td>                                         </td> </tr>
  <tr><td> f10              </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> f10                           </td> <td>                                         </td> </tr>
   <tr><td> packScaleStr   </td> <td>string    </td> <td> 非必须   </td> <td>        </td> <td> 包装比例                       </td> <td>1（箱）:2（盒）:2（个）</td> </tr>
 <tr><td> productCategory   </td> <td>string    </td> <td> 非必须   </td> <td>        </td> <td> 商品类别编号                   </td> <td>                                         </td> </tr>
  <tr><td> productId         </td> <td>string    </td> <td> 非必须   </td> <td>        </td> <td> 商品id                        </td> <td>                                         </td> </tr>
  <tr><td> productModel      </td><td> string    </td> <td> 非必须   </td> <td>        </td> <td> 商品型号                      </td> <td>                                         </td> </tr>
  <tr><td> productName       </td> <td>string    </td> <td> 必须     </td> <td>        </td> <td> 商品名称                      </td> <td>                                         </td> </tr>
  <tr><td> productNo         </td> <td>string    </td> <td> 必须     </td> <td>        </td> <td> 商品编号                      </td> <td>                                         </td> </tr>
  <tr><td> productStandard   </td> <td>string    </td> <td> 非必须   </td> <td>        </td> <td> 商品规格                      </td> <td>                                         </td> </tr>
  <tr><td> remark            </td><td> string    </td> <td> 非必须   </td> <td>        </td> <td> 备注                          </td> <td>                                         </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> flag     </td><td> int    </td> <td> 非必须     </td> <td>        </td> <td> 启用禁用                    </td> <td>  1：启用 0：禁用                                      </td> </tr>
</table>

## 返回消息体

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

## 请求示例
``` text
请求地址：{URL}/ps/v1/open/product/add-upd-product
Post参数：{
  "productNo": "productNo2",
  "productName": "111111",
  "packScale":  [
  {
   "packLevelId": "b80facbd3ba94c24b7a2ac3c600fad3f",
   "packScaleQuantity": 4
  },
  {
   "packLevelId": "b221c3d6c82949669718af39378f036b",
   "packScaleQuantity": 2
  },
  {
   "packLevelId": "cf717069ff3f47969ae235e26043c6f5",
   "packScaleQuantity": 1
  }
 ],
 "packScaleStr": "1（箱）：2（盒）:2（个）",
  "productCategory": "",
  "brandId": "",
  "productStandard": "",
  "productModel": "",
  "shelfLife": "",
  "shelfLifeUnit": "",
  "attachments": [
      {"attachmentPath":"http://localhost:8080/123.png"}
  ],
  "remark": "",
  "f1": "",
  "f2": "",
  "f3": "",
  "f4": "",
  "f5": "",
  "f6": "",
  "f7": "",
  "f8": "",
  "f9": "",
  "f10": ""
}
```

## 响应示例

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

## 异常示例
```json
{
  "code": 135630001,
  "message": "参数错误",
  "traceId":"xxxxxx",
  "timestamp": 1679368912568
}
```

## 返回码
| 返回码 | 描述 |  解决方案|
| --- | --- | --- | 
21040120|商品规格长度应为2到50|
21040121|商品型号长度应为2到30|
21040127|packScale与包装比例不符|
21040062|生码标记号已达到最大量，请联系管理员！|
21040063|保质期单位不正确|
21040122|保质期请输入长度9位内的正整数|
21040065|包装比例不正确|
21040055|商品编号重复|
21040053|商品分类不存在|
21040054|品牌不存在|