物流订单数码关系数据

# 增量获取物流订单数码关系数据(研发中)

## 支持场景
>  1. 增量获取已完成订单的各层数码关系数据

## API描述
>增量获取已完成订单的各层数码关系数据

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

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

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

## 传入参数

| 参数名称  | 参数值  |  是否必须 | 示例  | 备注  |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| Content-Type  |  application/json | 是  |   |   |
**Body**
<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-0><td key=0><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> startCompleteTime</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">开始完成时间
ISO 8601 格式的 UTC 时间戳：2025-06-09T08:49:13.501Z</span></td><td key=5></td></tr><tr key=0-1><td key=0><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> endCompleteTime</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">结束完成时间
开始和结束的时间范围控制不能大于 1 天。轮询最新数据的情况下，结束时间请用当前减半小时，避免拉取不到处理中的数据</span></td><td key=5></td></tr><tr key=0-2><td key=0><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> placeCate</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">部署点组织类型
3-仓库，4-渠道，默认:空代表所有</span></td><td key=5></td></tr><tr key=0-3><td key=0><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> direction</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">物流方向
1 入 ，2 出，默认:空代表所有</span></td><td key=5></td></tr><tr key=0-4><td key=0><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> size</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">每次请求数据量大小
最大10000,默认 1000</span></td><td key=5></td></tr><tr key=0-5><td key=0><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> scrollId</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">滚动查询Id
上次查询结果中最大的Id(最后一个记录的 id）, 查询条件不变的情况下，需要使用此 ID 一直滚动查询到无数据返回</span></td><td key=5></td></tr>
               </tbody>
              </table>

## 传出参数
|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|code|integer(int32)|false|none||错误码|
|data|[[ResponseWmsCodes](#schemaresponsewmscodes)]|false|none||数据|
|exception|string|false|none||异常信息|
|ext|object|false|none||扩展数据|
|message|string|false|none||消息内容|
|meta|object|false|none||元数据，如参数校验的data信息等|
|timestamp|integer(int64)|false|none||时间戳|
|traceId|string|false|none||链路追踪ID|

<a id="schemaresponsewmscodes"></a>
<h2 id="tocS_ResponseWmsCodes">ResponseWmsCodes</h2>

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|batchNo|string|false|none||批次编号|
|code1|string|false|none||一层数码|
|code2|string|false|none||二层数码|
|code3|string|false|none||三层数码|
|code4|string|false|none||四层数码|
|completeTime|string(date-time)|false|none||完成时间|
|id|integer(int64)|false|none||编号|
|placeNo|string|false|none||地点编号|
|placeType|integer(int64)|false|none||地点类型|
|productExtend|[ExtendField](#schemaextendfield)|false|none||商品扩展信息|
|productNo|string|false|none||产品编号|
|productionDate|string|false|none||生产日期|
|scanTime|string(date-time)|false|none||扫描时间|
|senderNo|string|false|none||发送方编号|
|senderType|integer(int64)|false|none||发送方类型|
|shelfLife|integer(int32)|false|none||保质期 (需要和保质期单位组合使用)|
|shelfLifeUnit|integer(int32)|false|none||保质期单位 （1:年，2：月，3:日)|

<a id="schemaextendfield"></a>
<h2 id="tocS_ExtendField">ExtendField</h2>

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|f1|string|false|none||none|
|f2|string|false|none||none|
|f3|string|false|none||none|
|f4|string|false|none||none|
|f5|string|false|none||none|
|f6|string|false|none||none|
|f7|string|false|none||none|
|f8|string|false|none||none|
|f9|string|false|none||none|
|f10|string|false|none||none|

## 入参示例
```json
{
    "direction": 1,
    "placeCate": 3,
    "scrollId": 136,
    "size": 1000,
    "startCompleteTime": "2024-10-08T00:00:00.000Z",
    "endCompleteTime": "2024-10-09T00:00:00.000Z"
}
```
## 出参示例
```json
{
    "code": 200,
    "message": "success",
    "data": [
        {
            "id": "1421",
            "code1": "071101018018",
            "code2": "07110100016506",
            "code3": "071103010014454774610794",
            "code4": null,
            "productNo": "512yanshi",
            "productExtend": {
                "f1": "1796",
                "f2": "6952080200235",
                "f3": "",
                "f4": "",
                "f5": "",
                "f6": "",
                "f7": "",
                "f8": "",
                "f9": "",
                "f10": ""
            },
            "batchNo": "UUUUa",
            "productionDate": "2025-03-13",
            "shelfLife": 30,
            "shelfLifeUnit": 3,
            "senderNo": "whjx2",
            "senderType": 16,
            "placeNo": "CK12345",
            "placeType": 14,
            "scanTime": "2025-03-24T07:46:33.500Z",
            "completeTime": "2025-03-24T07:46:45.500Z"
        },
        {
            "id": "1422",
            "code1": "071101018010",
            "code2": "07110100016504",
            "code3": "071103010014454774610794",
            "code4": null,
            "productNo": "512yanshi",
            "productExtend": {
                "f1": "1796",
                "f2": "6952080200235",
                "f3": "",
                "f4": "",
                "f5": "",
                "f6": "",
                "f7": "",
                "f8": "",
                "f9": "",
                "f10": ""
            },
            "batchNo": "UUUUa",
            "productionDate": "2025-03-13",
            "shelfLife": 30,
            "shelfLifeUnit": 3,
            "senderNo": "whjx2",
            "senderType": 16,
            "placeNo": "CK12345",
            "placeType": 14,
            "scanTime": "2025-03-24T07:46:33.500Z",
            "completeTime": "2025-03-24T07:46:45.500Z"
        }
    ],
    "timestamp": 1750073731217,
    "traceId": "",
    "exception": null,
    "meta": null,
    "ext": null
}
```