增量获取物流订单数码关系数据
支持场景
- 增量获取已完成订单的各层数码关系数据
- 该接口使用前需要先申请,规整历史数据
API描述
增量获取已完成订单的各层数码关系数据
请求流程
参阅 API开放平台接入指南
请求信息
域名：请参阅 环境信息
| 请求方法 |
POST |
| 请求路径 |
/trace/app/v1/open/wms/order/codes |
公共参数
通用请求头
请参阅 通用请求头
传入参数
| 参数名称 |
参数值 |
是否必须 |
示例 |
备注 |
| Content-Type |
application/json |
是 |
|
|
| Body |
|
|
|
|
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
| startCompleteTime | string | 必须 | | 开始完成时间
ISO 8601 格式的 UTC 时间戳：2025-06-09T08:49:13.501Z | |
| endCompleteTime | string | 必须 | | 结束完成时间
开始和结束的时间范围控制不能大于 1 天。轮询最新数据的情况下，结束时间请用当前减半小时，避免拉取不到处理中的数据 | |
| placeCate | string | 否 | | 部署点组织类型（出库单的收货单位，入库单的收货单位）
3-仓库，4-渠道，默认:空代表所有 | |
| direction | string | 否 | | 物流方向
1 入 ，2 出，默认:空代表所有 | |
| size | string | 否 | | 每次请求数据量大小
最大10000,默认 1000 | |
| scrollId | string | 否 | | 滚动查询Id
上次查询结果中最大的Id(最后一个记录的 id）, 查询条件不变的情况下，需要使用此 ID 一直滚动查询到无数据返回 | |
传出参数
| 名称 |
类型 |
必选 |
约束 |
中文名 |
说明 |
| code |
integer(int32) |
false |
none |
|
错误码 |
| data |
[ResponseWmsCodes] |
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 |
ResponseWmsCodes
| 名称 |
类型 |
必选 |
约束 |
中文名 |
说明 |
| 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 |
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:日) |
ExtendField
| 名称 |
类型 |
必选 |
约束 |
中文名 |
说明 |
| 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 |
入参示例
出参示例
{
"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
}
