运单信息查询
请求地址
https://www.xxyb.cn/union/api/wlpt/consignor/queryWaybillInfo
Header
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Token | 是 | string | 应用令牌 |
| cid | 是 | string | 合作ID |
| corpId | 是 | string | 企业ID |
请求参数
| 参数名 | 必选 | 类型 | 层级 | 说明 | 备注 |
|---|---|---|---|---|---|
| id | 是 | string | 1 | 运单ID |
入参示例
json
{
"id": "B123456789"
}返回参数
| 参数名 | 类型 | 层级 | 说明 | 备注 |
|---|---|---|---|---|
| code | int | 1 | 状态码 | |
| msg | string | 1 | 请求结果 | |
| total | int | 1 | 返回总条数 | |
| requestId | string | 1 | 请求编号 | |
| data | object | 1 | 返回数据 | |
| billDetail | object | 2 | 账户信息 | |
| id | string | 3 | 运单ID | |
| billCode | string | 3 | 运单号 | |
| goodsCode | string | 3 | 货源单号 | |
| orderCode | string | 3 | 订单号 | |
| planCode | string | 3 | 计划单号 | |
| driverName | string | 3 | 司机姓名 | |
| driverPhone | string | 3 | 司机手机号 | |
| licensePlateNumber | string | 3 | 车牌号 | |
| vehicleType | enum | 3 | 车型 | 见下方车型代码 |
| vehicleLength | decimal | 3 | 车长 | |
| pickGoodsTime | date | 3 | 提货时间 | |
| arriveTime | date | 3 | 运抵时间 | |
| billStatus | enum | 3 | 运单状态 | 见下方运单状态代码 |
| coverStatus | enum | 3 | 覆盖状态 | 见下方覆盖状态代码 |
| checkStatus | enum | 3 | 核对状态 | 见下方核对状态代码 |
| checkTime | date | 3 | 核对时间 | |
| invoiceStatus | enum | 3 | 开票状态 | 见下方开票状态代码 |
| invoiceTime | date | 3 | 开票时间 | |
| locationStatus | enum | 3 | 定位状态 | 见下方定位状态代码 |
| isLeaderPayee | boolean | 3 | 是否车队长收运费 | true 是 false 及有车队长ID 收佣金 |
| leaderType | enum | 3 | 车队长类型 | 见下方车队长类型代码 |
| receiptStatus | enum | 3 | 回单状态 | 见下方回单状态代码 |
| receiptComplianceStatus | enum | 3 | 回单合规状态 | 见下方回单签收状态代码 |
| receipt | array | 3 | 回单 | |
| receiptUrl | string | 4 | 回单地址 | |
| billImageType | enum | 4 | 回单类型 | 见下方回单类型代码 |
| createTime | string | 4 | 创建时间 | |
| receiptTime | date | 3 | 回单上传时间 | |
| insureStatus | enum | 3 | 保险状态 | 见下方保险状态代码 |
| insureBuyer | enum | 3 | 要求保险购买方 | 见下方保险购买方代码 |
| settlementWeight | decimal | 3 | 结算吨重值 | |
| kilometer | decimal | 3 | 公里值 | |
| tonKilometer | decimal | 3 | 吨公里值 | |
| billGenerationTime | date | 3 | 运单生成时间 | |
| remark | string | 3 | 运单备注 | |
| feeDetail | object | 2 | 费用总汇 | |
| cashTotalAmount | decimal | 3 | 现金运费 | |
| settlementMethod | enum | 3 | 结算吨重 | 见下方结算吨重代码 |
| deductQuantity | decimal | 3 | 扣杂 | |
| deductQuantityMethod | enum | 3 | 扣杂计算方式 | 见下方扣杂计算方式代码 |
| reasonableLosses | decimal | 3 | 合理亏损 | |
| reasonableMethod | enum | 3 | 合理亏损单位 | 见下方合理亏损计算方式代码 |
| goodsUnitPrice | decimal | 3 | 货物单价 | |
| detailMethod | string | 3 | 计价单位 | |
| transportUnit | decimal | 3 | 运输单价 | |
| totalAmount | decimal | 3 | 总金额 | |
| driverTransportUnit | decimal | 3 | 运输单价 | 司机 |
| driverTotalAmount | decimal | 3 | 总金额 | 司机 |
| paidAmount | decimal | 3 | 已付金额 | |
| unpaidAmount | decimal | 3 | 未付金额 | |
| taxAmount | decimal | 3 | 税额（服务费） | |
| paidTaxAmount | decimal | 3 | 已付税额 | |
| paidTotalAmount | decimal | 3 | 已付总额 | 佣金+运费+服务费 |
| taxRate | decimal | 3 | 支付税率 | |
| driverAmount | decimal | 3 | 司机所得运费 | |
| payStatus | enum | 3 | 支付状态 | 见下方支付状态代码 |
| payTime | date | 3 | 支付时间 | |
| feeItemDetailList | array | 3 | 费用明细 | |
| feeType | enum | 4 | 费用类型 | 见下方费用类型代码 |
| customName | string | 4 | 自定义费用名称 | |
| customUnit | decimal | 4 | 自定义单价 | |
| customMethod | enum | 4 | 自定义费用计价方式 | 见下方合理亏损计算方式代码 |
| detailTotalAmount | decimal | 4 | 自定义费用总额 | |
| augmentAmount | decimal | 4 | 增补金额 | |
| deductionAmount | decimal | 4 | 扣减金额 | |
| augmentDeductionReason | string | 4 | 增补扣减原因 | |
| confirmStatus | enum | 4 | 司机确认状态 | 见下方司机确认状态代码 |
| contractUrl | string | 4 | 合同地址 | |
| lineDetail | object | 2 | 线路信息 | |
| sendProvince | string | 3 | 发货省 | |
| sendCity | string | 3 | 发货市 | |
| sendArea | string | 3 | 发货区 | |
| sendAddress | string | 3 | 发货详细地址 | |
| sendAddressRemark | string | 3 | 发货详细地址备注 | |
| sendLon | decimal | 3 | 发货经度 | |
| sendLat | decimal | 3 | 发货纬度 | |
| sendPerson | string | 3 | 发货联系人 | |
| sendPhone | string | 3 | 发货联系手机号 | |
| sendPlanTime | date | 3 | 计划发货时间 | |
| deliveryProvince | string | 3 | 收货省 | |
| deliveryCity | string | 3 | 收货市 | |
| deliveryArea | string | 3 | 收货区 | |
| deliveryAddress | string | 3 | 收货详细地址 | |
| deliveryAddressRemark | string | 3 | 收货详细地址备注 | |
| deliveryLon | decimal | 3 | 收货经度 | |
| deliveryLat | decimal | 3 | 收货纬度 | |
| deliveryPerson | string | 3 | 收货联系人 | |
| deliveryPhone | string | 3 | 收货联系手机号 | |
| deliveryPlanTime | date | 3 | 计划收货时间 | |
| goodsDetailList | array | 2 | 货物信息 | |
| goodsType | string | 3 | 货物类型 | |
| goodsPrice | decimal | 3 | 货值 | |
| goodsName | string | 3 | 货物名称 | |
| sendWeight | decimal | 3 | 发货重量 | |
| deliveryWeight | decimal | 3 | 收货重量 | |
| goodsNumber | decimal | 3 | 货物数量 | |
| insuranceDetail | object | 2 | 保险信息 | |
| insuranceId | string | 3 | 保险产品ID | |
| coverage | decimal | 3 | 保额 | |
| insuranceFee | decimal | 3 | 保险费用 | |
| insured | string | 3 | 被投保人 | |
| insuredCardType | enum | 3 | 被投保人证件类型 | 见下方被投保人证件类型代码 |
| insuredCardNumber | string | 3 | 被投保人证件号码 | |
| insuredPhone | string | 3 | 被投保人电话 |
反参示例
json
{
"code": 200,
"data": {
"billDetail": {
"id": "WB123456789",
"billCode": "BILL123456789",
"goodsCode": "GC123456789",
"orderCode": "ORD123456789",
"planCode": "PLAN123456789",
"driverName": "张三",
"driverPhone": "13800138000",
"licensePlateNumber": "京A12345",
"vehicleType": "HEAVY_SEMI_TRAILER",
"vehicleLength": 12.5,
"pickGoodsTime": "2023-10-01T10:00:00Z",
"arriveTime": "2023-10-03T14:30:00Z",
"billStatus": "COMPLETE",
"coverStatus": "COVER_ALL",
"checkStatus": "CHECK_ED",
"checkTime": "2023-10-02T12:00:00Z",
"invoiceStatus": "INVOICED",
"invoiceTime": "2023-10-04T09:00:00Z",
"locationStatus": "LOCATION_ED",
"isLeaderPayee": false,
"leaderType": "ENTERPRISE",
"receiptStatus": "RECEIPT_ALL",
"receiptComplianceStatus": "RECEIPT_YES",
"receipt": [
{
"receiptUrl": "https://example.com/receipt1.jpg",
"billImageType": "RECEIPT",
"createTime": "2023-10-03T14:30:00Z"
},
{
"receiptUrl": "https://example.com/receipt2.jpg",
"billImageType": "OUT_RECEIPT",
"createTime": "2023-10-01T10:00:00Z"
}
],
"receiptTime": "2023-10-03T14:30:00Z",
"insureStatus": "INSURE_ED",
"insureBuyer": "OWNER",
"settlementWeight": 100.00,
"kilometer": 500.00,
"tonKilometer": 50000.00,
"billGenerationTime": "2023-09-30T09:00:00Z",
"remark": "运单备注信息"
},
"feeDetail": {
"cashTotalAmount": 10000.00,
"settlementMethod": "DELIVERY",
"deductQuantity": 500.00,
"deductQuantityMethod": "TON",
"reasonableLosses": 100.00,
"reasonableMethod": "TON",
"goodsUnitPrice": 100.00,
"detailMethod": "吨",
"transportUnit": 20.00,
"totalAmount": 10000.00,
"driverTransportUnit": 18.00,
"driverTotalAmount": 9000.00,
"paidAmount": 8000.00,
"unpaidAmount": 2000.00,
"taxAmount": 1000.00,
"paidTaxAmount": 800.00,
"paidTotalAmount": 8800.00,
"taxRate": 0.10,
"driverAmount": 9000.00,
"payStatus": "PAYMENT_PARTIAL",
"payTime": "2023-10-05T10:00:00Z",
"feeItemDetailList": [
{
"feeType": "FREIGHT",
"customName": "运费",
"customUnit": 20.00,
"customMethod": "TON",
"detailTotalAmount": 10000.00,
"augmentAmount": 500.00,
"deductionAmount": 200.00,
"augmentDeductionReason": "额外费用",
"confirmStatus": "CONFIRM_AGREE",
"contractUrl": "https://example.com/contract.pdf"
}
]
},
"lineDetail": {
"sendProvince": "北京市",
"sendCity": "北京市",
"sendArea": "海淀区",
"sendAddress": "北京市海淀区中关村大街1号",
"sendAddressRemark": "近地铁站",
"sendLon": 116.3182,
"sendLat": 39.9978,
"sendPerson": "张三",
"sendPhone": "13800138000",
"sendPlanTime": "2023-10-01T10:00:00Z",
"deliveryProvince": "上海市",
"deliveryCity": "上海市",
"deliveryArea": "浦东新区",
"deliveryAddress": "上海市浦东新区世纪大道100号",
"deliveryAddressRemark": "近地铁站",
"deliveryLon": 121.4737,
"deliveryLat": 31.2304,
"deliveryPerson": "李四",
"deliveryPhone": "13900139000",
"deliveryPlanTime": "2023-10-03T14:30:00Z"
},
"goodsDetailList": [
{
"id": "GD123456789",
"goodsType": "大宗",
"goodsName": "煤炭",
"sendWeight": 100.00,
"deliveryWeight": 95.00,
"goodsNumber": 5.00,
"goodsPrice": 10000.00,
"createTime": "2023-09-30T09:00:00Z"
}
],
"insuranceDetail": {
"insuranceId": "INS123456789",
"coverage": 50000.00,
"insuranceFee": 500.00,
"insured": "张三",
"insuredCardType": "IDENTITY_CARD",
"insuredCardNumber": "11010519900101001X",
"insuredPhone": "13800138000"
}
},
"msg": "业务处理成功",
"total": null,
"requestId": "1eb7cb0e"
}车型代码（VehicleTypeEnum）：
| Name | Message |
|---|---|
| HEAVY_SEMI_TRAILER | 重型半挂牵引车 |
| SMALL_CAR | 小型轿车 |
| SMALL_ORDINARY | 小型普通客车 |
| HEAVY_DUMP_TRUCK | 重型自卸货车 |
| HEAVY_BARN_TYPE_SEMI_TRAILER | 重型仓栅式半挂车 |
| HEAVY_ORDINARY_TRUCK | 重型普通货车 |
| HEAVY_TRAILER | 重型全挂牵引车 |
| HEAVY_GENERAL_SEMI_TRAILER | 重型普通半挂车 |
| LARGE_UNLOADED_WORK_CAR | 大型非载货专项作业车 |
| MEDIUM_DUMP_TRUCK | 中型自卸货车 |
| LIGHT_WAREHOUSE_GRID_TRUCK | 轻型仓栅式货车 |
| LIGHT_TRAILER | 轻型全挂牵引车 |
| MINIVAN | 小型面包车 |
| HEAVY_SILO_TRUCK | 重型仓栅式货车 |
| VAN | 轻型厢式货车 |
| HEAVY_FLAT_DUMP_TRUCK | 重型平板自卸车 |
| HEAVY_VAN | 重型厢式货车 |
| HEAVY_BOX_TRUCK | 重型箱式货车 |
| LIGHT_ORDINARY_TRUCK | 轻型普通货车 |
| HEAVY_KEY_DUMP_TRUCK | 重型键式自卸货车 |
| OTHER | 其它 |
运单状态代码（BillStatusEnum）：
| Name | Message |
|---|---|
| PICK_GOODS | 待提货 |
| WAIT_ARRIVE | 待运抵 |
| COMPLETE | 已完成 |
| CANCEL | 已失效 |
覆盖状态代码（CoverStatusEnum）：
| Name | Message |
|---|---|
| COVER_UN | 未覆盖 |
| COVER_START | 覆盖起点 |
| COVER_END | 覆盖终点 |
| COVER_ALL | 全覆盖 |
核对状态代码（CheckStatusEnum）：
| Name | Message |
|---|---|
| CHECK_UN | 未核对 |
| CHECK_ED | 已核对 |
定位状态代码（LocationStatusEnum）：
| Name | Message |
|---|---|
| LOCATION_UN | 未定位 |
| LOCATION_ING | 定位中 |
| LOCATION_ED | 定位结束 |
开票状态代码（InvoiceStatusEnum）：
| Name | Message |
|---|---|
| AUDITED | 待审核 |
| AUDIT_REJECT | 审核驳回 |
| TO_BE_INVOICED | 待开票 |
| INVOICED | 已开票 |
| REFUSE_INVOICE | 拒绝开票 |
| CANCEL | 作废 |
| INVOICE_RED | 发票冲红 |
| UN_INVOICE | 未开票 |
| PENDING_INVOICE | 开票中 |
| PRE_INVOICING | 预开票申请中 |
| REVOKE_APPLY | 已撤销 |
车队长类型代码（AccountTypeEnum）：
| Name | Message |
|---|---|
| PERSONAL | 个人 |
| ENTERPRISE | 企业 |
回单状态代码（ReceiptStatusEnum）：
| Name | Message |
|---|---|
| RECEIPT_UN | 未上传 |
| RECEIPT_PART | 部分上传 |
| RECEIPT_ALL | 全部上传 |
回单签收状态代码（ReceiptComplianceStatusEnum）：
| Name | Message |
|---|---|
| RECEIPT_UN | 待签收 |
| RECEIPT_YES | 已签收 |
| RECEIPT_NO | 未签收 |
回单类型代码（BillImageTypeEnum）：
| Name | Message |
|---|---|
| OUT_RECEIPT | 发货单 |
| IN_RECEIPT | 收货单 |
| LOAD_RECEIPT | 装货照 |
| UNLOAD_RECEIPT | 卸货照 |
保险状态代码（InsureStatusEnum）：
| Name | Message |
|---|---|
| INSURE_UN | 未投保 |
| INSURE_ING | 投保中 |
| INSURE_ED | 已投保 |
保险购买方代码（InsureBuyerEnum）：
| Name | Message |
|---|---|
| OWNER | 货主 |
| DRIVER | 司机 |
结算吨重代码（SettlementMethodEnum）：
| Name | Message |
|---|---|
| SEND | 发货吨重 |
| DELIVERY | 收货吨重 |
| AUTO | 自动亏损 |
扣杂计算方式代码（DeductQuantityMethodEnum）：
| Name | Message |
|---|---|
| TON | 吨 |
| YUAN | 元 |
合理亏损计算方式代码（DetailMethodEnum）：
| Name | Message |
|---|---|
| TON | 吨 |
| VOLUME | 方 |
| VEHICLE | 车 |
| BILL | 单 |
| PROPORTION | 比例 |
| WEIGHT | 重量 |
费用类型代码（FeeTypeEnum）：
| Name | Message |
|---|---|
| FREIGHT | 现金运费 |
| SERVICE_FEE | 服务费 |
| COMMISSION_FEE | 佣金 |
| OIL_FEE_ONLINE | 线上油卡 |
| OIL_FEE_OFFLINE | 线下油卡 |
| RECEIPT_DEPOSIT_SERVICE | 回单押金-交押金 |
| RECEIPT_DEPOSIT_TRANSPORT | 回单押金-回单付 |
| CREATE_BILL_FEE | 建单费 |
| LOCATION_FEE | 定位费 |
| INFO_FEE | 信息费 |
| FREIGHT_CUSTOM | 自定义运费 |
支付状态代码（PayStatusEnum）：
| Name | Message |
|---|---|
| PAYMENT_UN | 未支付 |
| PAYMENT_ING | 支付中 |
| PAYMENT_PARTIAL | 部分支付 |
| PAYMENT_ED | 支付完成 |
| PAYMENT_NO | 不予支付 |
| FREEZE | 已冻结 |
| UNFREEZE | 已解冻 |
司机确认状态代码（CustomConfirmEnum）：
| Name | Message |
|---|---|
| CONFIRM_WAIT | 待司机确认 |
| CONFIRM_REFUSE | 司机已拒绝 |
| CONFIRM_AGREE | 司机已同意 |
被投保人证件类型代码（CardTypeEnum）：
| Name | Message |
|---|---|
| IDENTITY_CARD | 身份证 |
| BUSINESS_LICENSE | 营业执照 |