根据商品编号查询（批量）V3

#  根据商品编号查询（批量）V3 `公开`

## 支持场景
>  已支持：获取商品的品牌、分类、名称、编号、包装比例、附件……
>  排序：按修订时间倒序

## API描述
>  API描述：根据商品编号查询（批量）V3

## 请求流程

>   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/query-by-nos           |
| 请求头   | Content-Type: application/json                         |

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

## 请求参数

| 名称      | 类型    | 是否必须 | 默认值 | 备注       | 其他信息          |
|-----------|---------|----------|--------|------------|-------------------|
| productNos | string[]  | 必须  |  | 商品编号集合 |
| rowDeleted | boolean  | 非必须  | false | 是否包含删除，默认不包含 |
## 返回消息体

<table>
 <tr><td> 名称              </td><td> 类型      </td> <td> 是否必须 </td> <td> 默认值 </td> <td> 备注                          </td> <td> 其他信息                                </td> </tr>
  <tr><td> code             </td> <td> integer    </td> <td> 非必须   </td> <td> 错误码                </td> <td> **format:** int32                       </td> </tr>
  <tr><td> data        </td> <td> object [] </td> <td> 非必须   </td> <td>        </td> <td> 返回内容              </td> <td> **item 类型:** object                   </td> </tr>
  <tr><td colspan="6">
  <table>
	  <tr>
		<td>outProductId</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>productName</td><td>string</td><td>非必须</td><td> </td> <td>商品名称</td><td></td>
	  </tr>
	  <tr>
		<td>packScale</td><td>string</td><td>非必须</td><td> </td> <td>包装比例</td><td></td>
	  </tr>
	  <tr>
		<td>categoryNo</td><td>string</td><td>非必须</td><td> </td> <td>商品分类编号</td><td></td>
	  </tr>
	  <tr>
		<td>categoryName</td><td>string</td><td>非必须</td><td> </td> <td>商品分类名称</td><td></td>
	  </tr>
	  <tr>
		<td>brandNo</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>productStandard</td><td>string</td><td>非必须</td><td> </td> <td>商品规格</td><td></td>
	  </tr>
	  <tr>
		<td>productModel</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>保质期单位 1:年 2：月 3：日</td><td></td>
	  </tr>
	   <tr>
		<td>warrantyPeriod</td><td>integer</td><td>非必须</td><td> </td> <td>质保期限</td><td></td>
	  </tr>
	  <tr>
		<td>warrantyPeriodUnit</td><td>string</td><td>非必须</td><td> </td> <td>质保期限单位 1:年 2：月 3：日</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>
	<tr>
		<td>attachmentName</td><td>string</td><td>非必须</td><td> </td> <td>附件名</td><td></td>
	  </tr>
</table>
  <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> packScaleList </td> <td> object [] </td> <td> 非必须   </td> <td>        </td> <td> 商品包装层级              </td> <td>                </td> </tr>
  <tr><td colspan="6">
  <table>
 <tr> <td> codeLength        </td> <td>integer   </td> <td> 非必须   </td> <td>        </td> <td> 码制长度                      </td> <td> **format:** int32                       </td> </tr>
  <tr><td> packLevelGroup    </td><td> integer   </td> <td> 非必须   </td> <td>        </td> <td> 层级组                        </td> <td> **format:** int32                       </td> </tr>
  <tr><td> packLevelSort     </td><td> integer   </td> <td> 非必须   </td> <td>        </td> <td> 层级顺序                      </td> <td> **format:** int32                      </td> </tr>
 <tr> <td> packLevelUnit     </td><td> string    </td> <td> 非必须   </td> <td>        </td> <td> 包装单位名称                  </td> <td>                                         </td> </tr>
  <tr><td> packScaleQuantity </td> <td>integer   </td> <td> 非必须   </td> <td>        </td> <td> 相应层级包装比例数字          </td> <td> **format:** int32                       </td> </tr>
  <tr><td> productId </td> <td>string   </td> <td> 非必须   </td> <td>        </td> <td> 商品id          </td> <td> </td> </tr>
   <tr><td> packLevelId </td> <td>string   </td> <td> 非必须   </td> <td>        </td> <td> 相应层级id          </td> <td> </td> </tr>
   </table>
  </td></tr>
  <tr><td> remark            </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> rowCreateDate         </td> <td>string    </td> <td> 非必须     </td> <td>        </td> <td> 创建时间	                      </td> <td>                                         </td> </tr>
  <tr><td> rowCreateUsername   </td> <td>string    </td> <td> 非必须   </td> <td>        </td> <td> 创建人	                      </td> <td>                                         </td> </tr>
  <tr><td> rowUpdateDate            </td><td> string    </td> <td> 非必须   </td> <td>        </td> <td> 修订时间	                          </td> <td>                                         </td> </tr>
 <tr><td> rowUpdateUsername   </td> <td>string    </td> <td> 非必须   </td> <td>        </td> <td> 修订人                      </td> <td>                                         </td> </tr>
  <tr><td> flag   </td> <td>string    </td> <td> 非必须   </td> <td>        </td> <td> 状态 1禁用/2启用                      </td> <td>                                         </td> </tr>
   <tr><td> rowDeleted   </td> <td>boolean    </td> <td> 非必须   </td> <td>        </td> <td> 是否删除                    </td> <td>                                         </td> </tr>
     </table>
  </td></tr>
  <tr><td> message           </td><td> string    </td> <td> 非必须   </td> <td>        </td> <td> 消息内容                      </td> <td>                                        </td> </tr>
  <tr><td> timestamp         </td><td> integer   </td> <td> 非必须   </td> <td>        </td> <td> 时间戳                        </td> <td> **format:** int64                        </td> </tr>
  <tr><td> traceId           </td><td> string    </td> <td> 非必须   </td> <td>        </td> <td> 链路追踪ID                    </td> <td>                                          </td> </tr>

</table>

## 请求示例
``` text
{URL}//base/app/v3/open/product/query-by-nos

入参：
{
   "productNos":[
        "spc111212"
   ]
}
```

## 响应示例

```json
{
    "code": 200,
    "message": "success",
    "data": [
        {
            "outProductId": "00001",
            "productNo": "spc111212",
            "productName": "spc111210",
            "packScale": "1:2",
            "categoryNo": "00005",
            "categoryName": "00005",
            "brandNo": "051501",
            "brandName": "051501",
            "productStandard": "productStandard01",
            "productModel": "productModel01",
            "shelfLife": "1",
            "shelfLifeUnit": "1",
            "warrantyPeriod": 2,
            "warrantyPeriodUnit": "2",
            "warrantyPeriodStr": "22",
            "attachments": [
                {
                    "attachmentPath": "https://hive-alpha.oss-cn-shanghai.aliyuncs.com/sup8-upload/1_1727581450645299200.jpg",
                    "attachmentName": "spc111210"
                },
                {
                    "attachmentPath": "https://tx-assets-test.supercarrier8.com/sup8-upload/3283781224.gif",
                    "attachmentName": "spc111210"
                }
            ],
            "remark": "",
            "rowCreateUsername": "ccn-pms-product",
            "rowUpdateUsername": "ccn-pms-product",
            "rowUpdateDate": "2024-11-14 13:31:17",
            "rowCreateDate": "2024-11-13 16:51:07",
            "flag": "2",
            "packScaleList": [
                {
                    "packLevelSort": 1,
                    "packLevelUnit": "个",
                    "codeLength": 12,
                    "packScaleQuantity": 1,
                    "packLevelId": "3821da1bc1d94539a3112e490c913993",
                    "packLevelGroup": 4,
                    "productId": "fc8594290ba34361b000b1528594e56f"
                },
                {
                    "packLevelSort": 2,
                    "packLevelUnit": "盒1",
                    "codeLength": 24,
                    "packScaleQuantity": 2,
                    "packLevelId": "cb6e655157ed42bf99d049db2366e57d",
                    "packLevelGroup": 4,
                    "productId": "fc8594290ba34361b000b1528594e56f"
                }
            ],
            "f1": "",
            "f2": "2",
            "f3": "",
            "f4": "",
            "f5": "",
            "f6": "2021-01-01",
            "f7": "",
            "f8": "",
            "f9": "",
            "f10": "",
            "productId": "fc8594290ba34361b000b1528594e56f",
            "rowDeleted": false
        }
    ],
    "timestamp": 1731565275841,
    "traceId": "",
    "exception": null,
    "meta": null,
    "ext": null
}
```

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

## 返回码
| 返回码 | 描述 |  解决方案|
| --- | --- | --- | 
| 200 | 成功 |  | 
| 400 | 参数错误 | 
| 21040002 | 企业号为空
| 21040106 | 商品id为空
| 21040103 | 系统异常