主题
运单轨迹开放上报
- 接口根路径：
/openapi/unifiedWaybill - 说明：外部系统调用开放 API 上报运单/轨迹到具语开放网关；
- 与订单区分：本接口上报的是查货库 运单/轨迹，不是
/openapi/order的开单/订单；路径、字段、业务语义均独立。 - 验签：与其它开放接口相同（
X-Access-Key/X-Timestamp/X-Sign），请求体顶层字段参与签名。
上报运单
- 接口地址：
/openapi/unifiedWaybill/pushWaybill - 请求方式：
POST - 单次最多 1000 条；同
companyId + waybillNo再次上报会覆盖并重置为待处理。
请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
list | Array | 是 | 运单对象数组，1～1000 条 |
list 元素字段
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
openDateTime | String | 是 | 开单时间 |
lastUpdateTime | String | 是 | 最新修改时间 |
waybillNo | String | 是 | 运单号 |
sendCompany | String | 是 | 物流公司名称 |
companyId | String | 是 | 物流公司 ID |
status | String | 是 | 运单状态 |
sendName | String | 是 | 发货人 |
receiverName | String | 是 | 收货人 |
receiverMobile | String | 是 | 收货人手机 |
cargoPoll | String | 是 | 货物套数 |
cargoNumber | String | 是 | 货物件数 |
shipperProvince / shipperCity / shipperDistrict | String | 是 | 发货省市区 |
consigneeProvince / consigneeCity / consigneeDistrict | String | 是 | 收货省市区 |
destinationProvince / destinationCity | String | 是 | 到站省市 |
interceptionStatus | String | 是 | 拦截状态（如 未拦截 / 已拦截 / 1 / 2） |
receiptStatus | Integer | 是 | 回单状态：0 待上传 / 1 已上传 |
consignorName | String | 否 | 货主 |
sendMobile | String | 否 | 发货人手机 |
consigneeExtensionTel | String | 否 | 虚拟号分机 |
distributionType | String | 否 | 配送方式 |
cargoName / cargoPack / cargoWeight / cargoVolume | String | 否 | 货物信息 |
shipperAddress / consigneeAddress | String | 否 | 详细地址 |
destinationDistrict | String | 否 | 到站区 |
totalMoney | String | 否 | 开单总金额 |
receiptImg | String | 否 | 回单图片，多张逗号分隔 |
electronicWaybillNo | String | 否 | 电子面单号 |
请求示例
json
{
"list": [
{
"openDateTime": "2025-10-09 17:22:00",
"lastUpdateTime": "2025-10-09 17:22:00",
"waybillNo": "251003182",
"sendCompany": "北诚物流",
"companyId": "300616",
"status": "已签收",
"sendName": "日昇家具",
"receiverName": "王静",
"receiverMobile": "18400939887",
"cargoPoll": "2",
"cargoNumber": "2",
"shipperProvince": "江西省",
"shipperCity": "赣州市",
"shipperDistrict": "南康区",
"consigneeProvince": "河北",
"consigneeCity": "唐山",
"consigneeDistrict": "路北区",
"destinationProvince": "广东省",
"destinationCity": "深圳市",
"interceptionStatus": "未拦截",
"receiptStatus": 0
}
]
}响应示例
json
{
"code": 200,
"message": "",
"result": {
"accepted": 1,
"updated": 0,
"skipped": 0
}
}| 字段 | 说明 |
|---|---|
accepted | 新写入条数 |
updated | 覆盖更新条数 |
skipped | 本批内重复键跳过条数 |
上报轨迹
- 接口地址：
/openapi/unifiedWaybill/pushTrack - 请求方式：
POST - 单次最多 1000 条；同
trackID再次上报会覆盖并重置为待处理。
请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
list | Array | 是 | 轨迹对象数组，1～1000 条 |
list 元素字段
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
trackID | String | 是 | 轨迹唯一 ID |
trackDate | String | 是 | 轨迹时间 |
trackType | String | 是 | 节点类型（揽收/发车/到达/到达派送网点/预约/上门派件/已签收 等） |
trackContent | String | 是 | 轨迹描述 |
waybillNo | String | 是 | 运单号 |
companyId | String | 是 | 公司 ID |
deptId / deptName / deptAddress / deptAddressDetailed | String | 否 | 操作网点（多数节点建议传） |
arriveDeptName / startDeptName | String | 否 | 到达/始发网点 |
destinationStation | String | 否 | 目的站 |
driverName / driverMobile | String | 否 | 司机信息 |
appointmentTime | String | 否 | 预约时间 |
signName / signType / pictures | String | 否 | 签收相关 |
departType | Integer | 否 | 发车类型：0 短驳 / 1 干线 / 2 外包 |
plateNumber | String | 否 | 车牌号 |
remarks | String | 否 | 备注 |
请求示例
json
{
"list": [
{
"trackID": "111110",
"trackDate": "2025-09-03 13:43:00",
"trackType": "到达派送网点",
"trackContent": "货物已到达【河北省石家庄市】，请耐心等待！",
"waybillNo": "61494130000",
"companyId": "440852658211917000",
"deptId": "641341038895697000",
"deptName": "安居东莞二仓",
"arriveDeptName": "安居东莞仓储中心",
"startDeptName": "和谐仓储中心",
"destinationStation": "广东东莞"
}
]
}响应示例
同「上报运单」。