物流行业解决方案
中合智付物流行业解决方案面向物流 SaaS 平台、网络货运平台、三方物流及大中型车队企业，提供能源消费与资金合规管控的数字化服务。
方案支持轻量快速接入与全流程深度集成两种模式，覆盖油站检索、优惠比价、车队额度调配、现场支付扣款及增值税专用发票申领全流程，实现运力、运单、加油与财税合规的完整数据闭环。
接入方式全景：轻量 API 接入 vs 完整 API 接入
为适配不同物流企业的系统现状与业务阶段，平台支持两种接入方式（司机端加油功能均完整保留在企业自有小程序内）：
双轨 API 接入模式对比与选型指南
司机端始终保留在企业自有小程序内。中合智付提供从「轻量 API 极速闭环（仅需 4~5 个核心接口）」到「全套 API 深度无缝直连（前后端全流程自动化）」的灵活接入矩阵。
模式 A · 轻量 API 接入⚡ 1~2 个工作日极速闭环
核心消费闭环模式（管用分离 / 小程序极简接入）
繁重的后台管理直接使用中合智付现成的 Web 商户后台；企业仅需在自有小程序对接 4~5 个核心加油消费 API，今天下发配额、明天司机就能在自有小程序内加油。
💻 角色与操作载体
调度 / 财务
商户管理控制台（Web 端零研发）直接登录
mch.harmopay.com，通过可视化界面批量导入人车档案、对公充值、手动或批量给司机/车辆划拨额度、一键申请专票与下载对账单。车队司机
企业自有小程序（仅调 4~5 个核心 API）司机完全留在企业自有小程序内。前端仅需对接：油站检索 (
station.query)、额度查询 (account.list)、生成到站付款码 (paycode.create) 及状态轮询 (paycode.query)。🚀 适用客群与优势
- ✓ 极低研发门槛：企业无需开发复杂的后台管理系统，仅需 1 名前端研发 1~2 天在小程序嵌入几个页面。
- ✓ 极速上线验证：对公充值并下发配额后，司机当天即可在自有小程序开始加油消费，快速跑通商业闭环。
- ✓ 适合场景：业务前期快速验证、现有后台暂无充裕研发排期、希望以最小成本启动加油业务的中小车队与 SaaS。
模式 B · 完整 API 接入🛠️ 3~5 天全套系统联调
全套深度集成模式（全链路自动化 / 100% 自有品牌）
企业自研的 TMS / ERP 系统与自有小程序全链路直连中合智付 OpenAPI，实现从运力建档、运单自动划拨额度、在途沿途找油到月末自动开票的全流程自动化无人值守。
⚙️ 角色与操作载体
SaaS / TMS
企业后台全自动化直连（Server-to-Server）服务端对接管理服务接口：运力建档同步 (
driver.sync)、排班发车自动划拨额度 (account.allocate)、结单自动清收 (recycle)、批量开具专票 (invoice.apply)。自有司机端
企业自有小程序（全功能深度集成）除基础加油外，深度接入动态折线沿途找油 (
along-polyline)、现场风控拍照存证、直接支付与亮码双模、订单历史与电子发票下载。🎯 适用客群与优势
- ✓ 全自动化运作：额度随运单调度秒级自动划拨，运单结算自动清收结余，彻底免除人工后台维护。
- ✓ 100% 品牌独占：前后端所有流程完全沉浸在企业自有品牌与业务系统内，业务、数据与财税高度集成。
- ✓ 适合场景：网络货运平台、大中型专线物流车队、成熟物流 SaaS / TMS 软件服务商。
推荐最佳实践路径：先模式 A 快速跑通闭环，后模式 B 深度升级企业可先通过模式 A（轻量 API），仅投入 1~2 天前端工作量在自有小程序打通核心加油流程，让车队快速加到优惠油；后续随着车队规模扩张、订单量增大，再逐步对接模式 B的后台管理类 API，平滑过渡到全流程自动化，业务不中断、研发零浪费！
核心业务价值
端侧集成 · 物流 SaaS / 自有司机端小程序（零跳出沉浸体验）
SaaS 自有业务
📦 运单与找货调度
运单派发 · 货物装载 · 线路规划
SaaS 自有业务
🛰️ 轨迹与在途监控
北斗/GPS 车辆定位 · 电子围栏监测
↓↓
企业精细化额度账户控制
资金专款专用 · 结单实时清零回收- 两级账户体系：支持开立「司机个人额度账户」与「车辆专属额度账户」，人车灵活绑定扣款
- 按单按需划拨：发车前由调度系统调接口自动注资，跑完运单秒级回收结余，避免资金沉淀
- 高强防作弊风控：结合司机 GPS 定位进行 500 米围栏校验，强制车牌/加油机现场拍照存证
全国签约油网与协议底价
10,000+ 品牌站点互联 · 专票秒级回收- 集团协议直降：聚合中石化、中石油等主流品牌，享受协议底价（每升直省 0.3~1.2 元）
- 智能沿途找油：传入司机运输始发地与目的地，自动沿导航规划折线推荐最优优惠油站
- 直接扣款 / 到站亮码：支持在车内直接下单扣款，或在收银台出示动态一次性付款码由枪机扫码
- 端内闭环体验：司机找油站、查看可用额度、现场核验与支付扣款，全流程均可在物流企业自有小程序或 App 内完成。
- 两级额度管控：支持将企业消费配额按需划拨至“司机额度账户”或“车辆额度账户”，专款专用、余额可查、结单即回收。
- 协议优惠结算：聚合全国主流品牌合作油站，企业直接享受专属协议优惠价，降低车队用油成本。
- 交易风控存证：支持地理围栏距离校验、车牌与加油机油表现场照片存证。
- 集中对账开票：消费订单明细支持按需批量申请 13% 成品油增值税专用发票。
核心模型与领域实体
物流企业商户 (Merchant)
根实体 · 主账户开立企业基础存管账户 · 统一管理企业充值资金池、开票抬头与全局风控策略
1 : N 雇佣 / 合作主体1 : N 运输运力资产
司机档案 (Driver)
承运人主体平台司机建档与实名认证，支持自有、外协、派遣多用工类型，可独立配置额度。
车辆资产 (Vehicle)
运输工具登记车牌与行驶证，支持为车辆设立专属消费账户，加油按车核算用油成本。
人车双向绑定关系 (Vehicle-Driver N:M) · 灵活支持一车多人 / 一人多车排班
↓ 消费时选择扣款源 (司机个人额度 / 车辆专属额度)
产品额度账户 (ProductAccount)
金额最小单位：分 (Long)在账户域统一管控的专用资金消费账户，支持发车预划拨、按需配额、结单自动清零回收
模式 A司机个人额度账户
ownerType = DRIVER (2)额度直接注入司机个人手机号绑定的虚拟子钱包，多班倒流动司机场景首选，专款专用于加油消费。
模式 B车辆专属额度账户
ownerType = VEHICLE (3)额度绑定在具体车牌上，被授权绑定的合规司机均可直接从该车额度扣款，适合自有固定车队管理。
- 司机（Driver）：物流企业的承运人员，以手机号唯一定位。录入档案时可同步开立司机个人额度账户。
- 车辆（Vehicle）：物流企业的运输车辆，以车牌号唯一定位。录入档案时可同步开立车辆额度账户。
- 人车绑定（Vehicle-Driver）：定义司机与车辆的驾驶关联关系。司机下单时，可选择扣减“司机个人额度”或“绑定车辆额度”。
- 额度账户：用于管控司机或车辆加油消费配额的专用账户，金额单位统一为分。
两大加油核心交易链路
物流场景支持两种现场支付方式，物流企业自有小程序可按需选择或同时支持：
司机自主操作 网关自动风控与核销
01
司机小程序➔物流 SaaS
product.logistics.station.query检索油站与协议行情
司机查看附近或沿途签约油站列表，比对门市价与平台专属协议底价。
02
物流 SaaS➔中合智付网关
product.logistics.policy.config.get调取企业支付风控配置
获取企业为该司机/车辆下发的前置策略（是否必须拍摄车牌、油枪照片，获取地理围栏半径）。
03
司机小程序➔中合智付网关
product.logistics.order.payment拍摄现场凭据并提交扣款
司机拍摄油枪与车牌照片，携带手机 GPS 定位坐标，选择从司机额度或车辆额度扣减。
04
中合智付网关➔油站加油机
扣款成功 · 专票自动秒级归集实时风控核验与扣款放行
网关毫秒级计算围栏半径与照片哈希，原子扣减额度账户，并下发指令通知油机结算放行。
开放接口全景速查
物流行业开放接口全部采用统一网关协议访问（POST /gateway/v1），业务请求参数以 JSON 字符串形式置于 bizContent。
一、司机管理（查看详情）
接口方法名 (method) | 接口中文名 | 核心能力描述 |
|---|---|---|
product.logistics.capacity.driver.add | 新增司机档案 | 录入司机基础信息，支持开立专属额度账户 |
product.logistics.capacity.driver.query | 单司机查询 | 按司机 ID 或手机号查询单个司机完整档案 |
product.logistics.capacity.driver.update | 更新司机档案 | 差量更新司机档案信息与状态 |
product.logistics.capacity.driver.list | 司机列表查询 | 分页查询企业司机档案列表 |
二、车辆管理（查看详情）
接口方法名 (method) | 接口中文名 | 核心能力描述 |
|---|---|---|
product.logistics.capacity.vehicle.add | 新增车辆档案 | 录入车辆基础档案，支持开立专属额度账户 |
product.logistics.capacity.vehicle.query | 单车辆查询 | 按车辆 ID 或车牌号查询单个车辆完整档案 |
product.logistics.capacity.vehicle.update | 更新车辆档案 | 更新车辆配置与启用状态 |
product.logistics.capacity.vehicle.list | 车辆列表查询 | 分页查询企业车辆档案列表 |
product.logistics.capacity.vehicle.bind | 车辆绑定/解绑司机 | 建立或解除司机与车辆的驾驶关联关系 |
product.logistics.capacity.vehicle.drivers | 查询车辆关联司机 | 查询指定车辆当前关联绑定的司机档案列表 |
三、账户管理（查看详情）
| 状态 | 接口方法名 (method) | 接口中文名 | 核心能力描述 |
|---|---|---|---|
| 已上线 | product.logistics.account.query | 账户查询 | 查询指定司机或车辆额度账户的账户状态与实时可用余额 |
| 已上线 | product.logistics.account.allocate | 额度分配与回收 | 额度调配统一接口：排班派车预发油费配额（分配），运单完结结算清收结余（回收） |
四、油站查询（查看详情）
| 状态 | 接口方法名 (method) | 接口中文名 | 核心能力描述 |
|---|---|---|---|
| 已上线 | product.logistics.station.query | 签约油站列表与行情查询 | 综合查询：合作油站信息 + 协议优惠价 + 油枪行情 + 配套服务（要素全选填，支持周边坐标比价、折线沿途找油与单站详情） |
五、加油订单（查看详情）
| 状态 | 接口方法名 (method) | 接口中文名 | 核心能力描述 |
|---|---|---|---|
| 已上线 | product.logistics.order.calc | 订单试算 | 按油机金额预知实付与优惠金额，返回挂牌价、协议价、升数等完整计价明细（仅用于计价试算，不产生订单） |
| 已上线 | product.logistics.order.payment | 直接支付（自主扣款） | 司机确认油品与金额后发起支付（支持上传现场车牌照、油表照及定位信息用于风控校验） |
| 已上线 | product.logistics.order.paycode | 申请到站付款码 | 司机选定油品与油机金额后生成动态付款码，同时创建待支付订单并锁定协议价；收银员扫码即核销 |
| 已上线 | product.logistics.order.query | 订单查询 | 查询付款码核销结果，确认处理中订单的最终交易结果，返回订单状态与完整交易明细 |
六、发票（查看详情）
| 状态 | 接口方法名 (method) | 接口中文名 | 核心能力描述 |
|---|---|---|---|
| 已上线 | product.logistics.invoice.apply | 批量发票申领与下载 | 勾选多笔加油单据批量申请 13% 增值税专用发票，返回电子发票 PDF 下载链接 |
接入快速指引
- 入驻与获得接入凭证：联系商务开通企业商户号（
merchantId），并在开放平台控制台创建应用，获取accessId以及分配的 RSA2/SM2 平台公钥，上传商户公钥。详见签名与验签规范。 - 初始化运力池：在商户管理后台【运力管理】通过标准模板批量导入司机与车辆，系统自动完成建档开户。
- 额度分配：企业在开户银行完成银行账户划款授权后，在商户管理后台【额度管理】为司机或车辆分配消费配额。
- 前端小程序页面对接：物流系统在自有小程序内接入油站地图与支付页面。通过调用
product.logistics.station.query查询油站比价、调用product.logistics.order.payment完成扣款。 - 部署 Webhook 接收最终交易结果：在企业服务端配置回调接口，接收平台发送的交易成功通知，实时核销内部运单油费台账（详见异步通知机制）。