获取数码实物关联信息

# 获取数码实物关联信息

## 注意
## 支持场景
>1. 第三方发货设备,扫描数码通过此接口实时查询数码实物信息
>2. 不支持防伪码

## API描述
>1. 通过数码获取实物数码关系信息,已经拆零（打散）的数码通过上级数码查询会自动过滤掉。

## 请求流程
> 参阅 [API开放平台接入指南](https://developers.yesno.com.cn/doc/56/)

## 请求信息
>域名：请参阅 [环境信息](https://developers.yesno.com.cn/doc/56/)

## 公共参数
**通用请求头**
>请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/)

## 请求参数
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key=name>名称</th><th key=type>类型</th><th key=required>是否必须</th><th key=default>默认值</th><th key=desc>备注</th><th key=sub>其他信息</th>
    </tr>
  </thead><tbody className="ant-table-tbody"><tr key=0-1><td key=0><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> code</span></td><td key=1><span>string</span></td><td key=2>必须</td><td key=3></td><td key=4><span style="white-space: pre-wrap">数码</span></td><td key=5></td></tr>
               </tbody>
              </table>

## 响应参数

| 名称 | 类型 | 是否必填 | 默认值 | 备注 | 其它信息 |
| --- | --- | --- | --- | --- | --- |
| code |integer  |必须  |  |  <span style="white-space: pre-wrap">200为成功，其他请参考<a href="https://developers.yesno.com.cn/doc/59/">错误码</span>|  |
|  data|  object|非必须  |  |数码信息数据字段  |  |
|  ├─ code| string | 必须 |  |物流码(中商物流码一般是纯数字) |  |
| ├─ originCode | string | 必须 |  | 查询原数码,入参的数码通过此字段原路返回 |  |
| ├─ level | integer | 必须 |  |  数码层级，1～4（如单品为 1，箱码为 2，托码为 3）|  |
| ├─sub1 | set[string]|非必须  |  | 下一级数码,无则内容为空 |  |
| ├─sub2 | set[string] |非必须  |  | 下二级数码,无则内容为空  |  |
| ├─sub3 | set[string] |非必须  |  | 下三级数码,无则内容为空  |  |
| ├─sup1 | string |非必须  |  | 上一级数码,无则内容为空  |  |
| ├─sup2 | string |非必须  |  | 上二级数码,无则内容为空  |  |
| ├─sup3 | string |非必须  |  | 上三级数码,无则内容为空  |  |
| ├─productNo | string |非必须  |  | 商品编号 |  |
| ├─productName | string |非必须  |  | 商品名称  |  |
| ├─batchNo | string |非必须  |  | 生产批次号 |  |
| ├─productionDate | string |非必须  |  | 生产日期，样例: 2024-06-26   |  |
| message | string |非必须  |  | 异常时描述内容  |  |
| traceId | string |非必须  |  | 请求唯一标识链路 ID，发生问题时可提供此ID |  |
| timestamp | string |非必须  |  | 时间戳  |  |

补充场景：

扫大托时,返回 Level 为 4，所有的单品在 字段 Sub3
扫托时,返回 Level 为 3，所有的单品在 字段 Sub2
扫箱时,返回 Level 为 2，所有的单品在 字段 Sub1

## 请求示例
```
{
    "code": "126702213675",
}
```
## 出参示例
```
{
    "code": 200,
    "message": "success",
    "data": {
        "code": "25630188289947",
        "originCode": "25630188289947",
        "level": 2,
        "sub1": [
            "256301001005",
            "256301001006"
        ],
        "sub2": [],
        "sub3": [],
        "sup1": null,
        "sup2": null,
        "sup3": null,
        "productNo": "SP-LA3-001",
        "productName": "商品三层001",
        "batchNo": "20240626",
        "productionDate": "2025-01-22"
    },
    "timestamp": 1750750753001,
    "traceId": "addfab0a-cb85-446f-b10b-cd0194c5e68d",
    "exception": null,
    "meta": null,
    "ext": null
}
```