三类运力,一套接口。客户不必对接三个系统、维护三份合同、做三本对账;下单、计费、状态回传三件事在网关这一层统一掉。
多运力协同最难的不是运力本身,是接口、口径与责任在三方之间对不齐。
一次提单,填重量、起点、终点即可,地址自动转坐标,运力由系统判定。
按重量与业务类型双判据分流,规则透明可查,派单环节零人工介入。
三类运力共用同一套计费与对账流程,客户只收一份账单。
各运力的节点状态映射为同一套事件口径,客户系统一次订阅即可。
用尽量少的必填字段完成下单,避免对接方为内部字段反复改造。
网关与调度可作为独立系统交付到客户侧部署,数据不出客户环境。
下单只需要 8 个字段。以下为字段示意,实际联调以接口文档为准。
| 字段 | 含义 |
|---|---|
| order_id | 客户侧订单号,用于幂等与对账 |
| weight_kg | 货物重量(公斤),决定空运或陆运 |
| from_addr | 起点地址,自动转坐标 |
| to_addr | 终点地址,自动转坐标 |
| biz_type | 业务类型:货运 / 载人 |
| expect_time | 期望送达或上车时间 |
| contact | 收件人或乘客联系方式 |
| callback_url | 状态回传地址 |
示意,非最终接口定义;实际以联调时提供的接口文档为准。
四步,把技术对接和业务跑通分开处理。
确认运力组合、业务类型、计费口径与回传要求,出一份对接方案。
在测试环境完成下单、分流、状态回传闭环,处理异常与幂等场景。
小批量真实单量运行,校验计费与对账,确认时效承诺可达成。
切换到生产环境,纳入监控与月度对账,按需调整分流规则。
三类运力合并计费,不用分别对账。
不同运力的状态统一口径,系统只解析一次。
技术问题只有一个联系窗口,不用三方协调。
每一单为什么走空运或陆运,规则可查可复核。