1.URL
http://124.223.60.234:18080/tms/cargo/queryCargoListIncludeChild
2.请求参数
2.1请求头
token:对应登录验证成功后,data里面对应的tokenId

2.2.参数示例
{
"orgId":"A92E24CCB7714550ACCB5BC7EB81FA60",
"cargoReportParams":{
"cargoNum":"",
"terminalId":"",
"vehicleId":"",
"cargoTypeId":"",
"shipperId":"",
"cneeId":"",
"carrierId":"",
"routeId":"",
"cargoStatus":-1,
"isLD":-1,
"isLA":-1,
"key":""
},
"queryType":0,
"pageNum":1,
"pageSize":20
}
2.3.参数说明
| 字段 |
类型 |
说明 |
是否必须 |
| orgId |
String |
组织唯一标识 |
Y |
| cargoReportParams |
Object |
过滤条件合集 |
Y |
| queryType |
int |
查询范围;0:全部;1:直属 |
Y |
| pageNum |
int |
分页查询第几页 |
Y |
| pageSize |
int |
分页查询每页几条数据 |
Y |
cargoReportParams(过滤条件合集)
| 字段 |
类型 |
说明 |
是否必须 |
| cargoNum |
String |
运单编号 |
N |
| terminalId |
String |
设备唯一标识 |
N |
| vehicleId |
String |
车辆唯一标识 |
N |
| cargoTypeId |
String |
货物类型唯一标识 |
N |
| shipperId |
String |
发货人唯一标识 |
N |
| cneeId |
String |
收货人唯一标识 |
N |
| carrierId |
String |
承运人唯一标识 |
N |
| routeId |
String |
运输路线唯一标识 |
N |
| cargoStatus |
int |
货物运输状态,-2:全部;-1:作废;0:待发车;1:运输中;2:已到达;3:已完成; |
N |
| isLD |
int |
超时发车,-1:查询全部;0:未延迟;1:延迟 |
N |
| isLA |
int |
超时到达,-1:查询全部;0:未延迟;1:延迟 |
N |
| key |
String |
按运单号模糊查询key |
N |
3.接口应答
3.1.返回示例
{
"code": 200,
"message": "Operation succeeded",
"data": {
"total": 1,
"size": 1,
"data": [
{
"id": "7DE0D0286D274214B301F73F93C75389",
"orgId": "A92E24CCB7714550ACCB5BC7EB81FA60",
"orgName": "Replace device",
"cargoNum": "CG-20251116012030",
"cargoTypeId": "6B728EF494CE40C6A713FC267BB10129",
"cargoTypeName": "啤酒",
"terminalId": "5AEF91E0A71646C19F13827F8BEA3996",
"terminalNum": "413052644290",
"vehicleId": "CDE8AE62730546FE87358C669313A5C8",
"vehicleNum": "A-4290",
"iconType": 0,
"driverId": "42559B45AEB14D0C8006F610838E5DEA",
"driverName": "Li",
"driverPhoneNum": "13530991295",
"shipperId": "BC4BB0D390224D518261F61C3C24012F",
"shipperName": "LEVAE",
"shipperPhoneNum": "13536548526",
"cneeId": "5249FB85807F4168AF74491CC5F3F8FA",
"cneeName": "AOVX",
"cneePhoneNum": "13896536521",
"carrierId": "085DF26F8FE24B06B30A7ECD7935EE4B",
"carrierName": "SF",
"carrierContact": "wz",
"carrierPhoneNum": "2568926263232",
"routeId": "6F5583357ED6464498E0A699EA11ECB6",
"routeName": "祥源城",
"extraFields": "",
"cargoStatus": 1,
"sdt": "2025-11-16 00:00:00",
"sat": "2025-11-18 00:00:00",
"adt": "2025-11-19 15:44:42",
"aat": null,
"isLD": 0,
"isLA": 0,
"signTime": null,
"createTime": "2025-11-15 16:15:02"
}
]
}
}
3.2.返回结果说明
| 字段 |
类型 |
说明 |
| code |
int |
返回状态 |
| message |
String |
返回结果描述 |
| data |
object |
返回结果体 |
data说明
| 字段 |
类型 |
说明 |
| total |
int |
总条数 |
| size |
int |
共几页 |
| data |
List |
返回结果体 |
data说明
| 字段 |
类型 |
说明 |
| id |
String |
唯一标识 |
| orgId |
String |
公司唯一标识 |
| orgName |
String |
公司名称 |
| cargoNum |
String |
运单号 |
| cargoTypeId |
String |
货物类型唯一标识 |
| cargoTypeName |
String |
货物类型名称 |
| terminalId |
String |
设备唯一标识 |
| terminalNum |
String |
设备编号 |
| vehicleId |
String |
运输载具唯一标识 |
| vehicleNum |
String |
运输载具名称 |
| iconType |
int |
车辆图标 |
| driverId |
String |
司机唯一标识 |
| driverName |
String |
司机名称 |
| driverPhoneNum |
String |
司机电话 |
| shipperId |
String |
发货人唯一标识 |
| shipperName |
String |
发货人名称 |
| shipperPhoneNum |
String |
发货人电话 |
| shipperEmail |
String |
发货人邮箱 |
| shipperCompany |
String |
发货人公司名称 |
| cneeId |
String |
收货人唯一标识 |
| cneeName |
String |
收货人名称 |
| cneePhoneNum |
String |
收货人电话 |
| cneeEmail |
String |
收货人邮箱 |
| cneeCompany |
String |
收货人公司名称 |
| carrierId |
String |
承运商唯一标识 |
| carrierName |
String |
承运商名称 |
| carrierContact |
String |
承运商联系人 |
| carrierPhoneNum |
String |
承运商联系电话 |
| carrierEmail |
String |
承运商联系邮箱 |
| routeId |
String |
运输路线唯一标识 |
| routeName |
String |
运输路线名称 |
| startRule |
int |
发车规则(0:手动启动;1:设备安装事件启动;2:出起点围栏启动;3:绑定设备后自动启动) |
| endRule |
int |
到达规则(0:手动到达;1:设备拆除事件到达;2:入终点围栏到达;) |
| cargoImage |
String |
货物图片集合对应的JSON字符串 |
| cargoInfo |
String |
货物描述 |
| extraFields |
String |
自定义字段集合的JSON字符串,采用Map的JSON存储 |
| cargoStatus |
int |
-1:作废;0:待发车;1:运输中;2:已到达;3:已完成;当未绑定设备的时候,只能是0或者-1;默认是0 |
| sdt |
String |
计划发车时间 |
| sat |
String |
计划到达时间 |
| adt |
String |
实际发车时间 |
| sat |
String |
实际到达时间 |
| isLD |
int |
是否延迟发车 |
| isLA |
int |
是否延迟到达 |
| signTime |
String |
签收时间 |
| createTime |
String |
创建时间 |
Author:admin Create time:2025-11-15 22:15
Last editor:admin Update time:2025-12-08 12:33