商品分页列表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                                                  |
|----------|-----------------------------------------------------------------------------------------------|
| 请求方法 | GET                                                   |
| 请求路径 | /base/app/v3/open/product/page           |
| 请求头   | Content-Type: application/json                         |

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

## 请求参数

| 名称      | 类型    | 是否必须 | 默认值 | 备注       | 其他信息          |
|-----------|---------|----------|--------|------------|-------------------|
| productNo | string  | 非必须  |  | 商品编号 |
| productName | string  | 非必须  |  | 商品名称 |
| categoryNo | string  | 非必须  |  | 商品分类编号 |
| categoryName | string  | 非必须  |  | 商品分类名称 |
| brandNo | string  | 非必须  |  | 品牌编号 |
| brandName | string  | 非必须  |  | 品牌名称 |
| packScale | string  | 非必须  |  | 包装比例 |
| rowCreateUsername | string  | 非必须  |  | 创建人名称 |
| rowUpdateUsername | string  | 非必须  |  | 修订人名称 |
| rowCreateDateStart | string  | 非必须  |  | 创建时间-开始时间，格式：yyyy-MM-dd HH:mm:ss |
| rowCreateDateEnd | string  | 非必须  |  | 创建时间-结束时间，格式：yyyy-MM-dd HH:mm:ss |
| rowUpdateDateStart | string  | 非必须  |  | 修订时间-开始时间，格式：yyyy-MM-dd HH:mm:ss |
| rowUpdateDateEnd | string  | 非必须  |  | 修订时间-结束时间，格式：yyyy-MM-dd HH:mm:ss |
| flag | string  | 非必须  |  | 状态 1禁用/2启用 |
| f1 | string  | 非必须  |  | 扩展字段f1 |
| f2 | string  | 非必须  |  | 扩展字段f2 |
| f3 | string  | 非必须  |  | 扩展字段f3 |
| f4 | string  | 非必须  |  | 扩展字段f4 |
| f5 | string  | 非必须  |  | 扩展字段f5 |
| f6 | string  | 非必须  |  | 扩展字段f6 |
| f7 | string  | 非必须  |  | 扩展字段f7 |
| f8 | string  | 非必须  |  | 扩展字段f8 |
| f9 | string  | 非必须  |  | 扩展字段f9 |
| f10 | string  | 非必须  |  | 扩展字段f10 |
| rowDeleted | boolean  | 非必须  | false | 是否包含删除，默认不包含 |
## 返回消息体

<table>
 <tr><td> 名称              </td><td> 类型      </td> <td> 是否必须 </td> <td> 默认值 </td> <td> 备注                          </td> <td> 其他信息                                </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>
  <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>total</td><td>integer</td><td>非必须</td><td> </td> <td>总数</td><td></td>
	  </tr>
	<tr><td>list</td><td>object[]</td><td>非必须</td><td></td><td>数据列表</td><td></td></tr>
<tr><td colspan="6">
<table>
	  <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>
</table>
</table>

</table>

## 请求示例
``` text
{URL}//base/app/v3/open/product/page
```

## 响应示例

```json
{
    "code": 200,
    "message": "success",
    "data": {
        "total": 1,
        "list": [
            {
                "outProductId": "99999",
                "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": 1731656290941,
    "traceId": "",
    "exception": null,
    "meta": null,
    "ext": null
}
```

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

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