获取商品详细信息

#  获取商品详细信息 `公开`

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

## 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                                                  |
|----------|-----------------------------------------------------------------------------------------------|
| 请求方法 | GET                                                   |
| 请求路径 | /base/app/v1/open/product/query-product                |
| 请求头   | Content-Type: application/json                         |

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

## 请求参数

| 参数名称  | 是否必须 | 示例 | 备注      |
|-----------|----------|------|-----------|
| enterpriseNo     | 是   | 100548954785   | enterpriseNo       |
| productId | 是       | wA2zT2MF9pZheWKSpPLlY4klf4  | productId |

## 返回消息体

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

## 出参

<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> attachmentPath      </td> <td>string </td> <td> 非必须   </td> <td>        </td> <td> 商品图片                      </td> <td>                 </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> categoryName        </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> packScale        </td> <td> string</td> <td> 非必须   </td> <td>        </td> <td> 包装比例           </td> <td> **item 类型:** object                   </td> </tr>
  
  <tr><td> packScaleList        </td> <td> object [] </td> <td> 非必须   </td> <td>        </td> <td> 包装层级              </td> <td> **item 类型:** object                   </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> packLevelId       </td><td> string    </td> <td> 非必须   </td> <td>        </td> <td> 相应层级id                    </td> <td>                                         </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>
   </table>
  </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> 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> 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>
     </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
https://open-test.yesno.com.cn/pms/v1/open/product/query-product?productId=ae4c5dfdd01549c49077bc190ff67c0b&enterpriseNo=131627012487
```

## 响应示例

```json
{
    "code": 200,
    "message": "success",
    "data": {
        "productNo": "pro0328",
        "productName": "0323name",
        "packScale": "1:2:4",
        "productCategory": null,
        "brandId": null,
        "productStandard": "12",
        "productModel": "12",
        "shelfLife": "1",
        "shelfLifeUnit": "3",
        "attachmentPath": null,
        "remark": null,
        "rowCreateUsername": null,
        "categoryName": "分类3级",
        "brandName": "xiadaoru",
        "rowUpdateDate": null,
        "rowCreateDate": null,
        "flag": "2",
        "flagStr": null,
        "productId": "ae4c5dfdd01549c49077bc190ff67c0b",
        "packScaleList": [
            {
                "packLevelSort": 1,
                "packLevelUnit": "个",
                "codeLength": 12,
                "packScaleQuantity": 1,
                "packLevelId": "cf717069ff3f47969ae235e26043c6f5",
                "packLevelGroup": 5
            },
            {
                "packLevelSort": 3,
                "packLevelUnit": "箱",
                "codeLength": 24,
                "packScaleQuantity": 4,
                "packLevelId": "b80facbd3ba94c24b7a2ac3c600fad3f",
                "packLevelGroup": 5
            },
            {
                "packLevelSort": 2,
                "packLevelUnit": "盒",
                "codeLength": 24,
                "packScaleQuantity": 2,
                "packLevelId": "b221c3d6c82949669718af39378f036b",
                "packLevelGroup": 5
            }
        ],
        "f1": null,
        "f2": null,
        "f3": null,
        "f4": null,
        "f5": null,
        "f6": null,
        "f7": null,
        "f8": null,
        "f9": null,
        "f10": null
    },
    "timestamp": 1679565957862,
    "traceId": "221198c7-ccf5-444e-a088-12aae8d995fd"
}
```

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

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