物流对接,从「写代码」到「做配置」

把对接一家物流/快递公司,变成下拉选一个编码。内置 12 家厂商 + 快递鸟 28 家通道,零代码、零重启、在线调试,回执自动写入业务流程。

一次配置,物流能力即取即用

过去每接一家物流商都要开发、联调、发版;现在,选编码、填密钥、点调试即可

01

告别定制开发

过去每接一家厂商要写一套 Client + 签名 + 报文解析;现在内置 12 家 Provider,选编码自动带出端点、签名算法与参数,开箱即用。

  • ✓ 12 家厂商端点/签名预置
  • ✓ 编码即带出参数
  • ✓ 无需写接入代码
  • ✓ 标准入参自动生成
02

长尾厂商零代码扩展

任何定制/长尾物流商,用 Magic API 脚本或可视化 HTTP 模板即可接入,零代码、零重启,不用为一家客户改一次系统。

  • ✓ Magic API 脚本接入
  • ✓ HTTP 模板 + 占位符
  • ✓ 响应 JSONPath 映射
  • ✓ 不改 Java 即可上线
03

结果统一,下游直接复用

不论哪家承运商,结果都归一为统一的 LogisticsRouteVO / LogisticsOrderVO 与 8 态 RouteStateEnum,后续流程节点无需为每家写适配。

  • ✓ 统一出参模型
  • ✓ 8 态路由状态机
  • ✓ 变量自动写入流程
  • ✓ 下游零改造复用
04

配置过程看得见

能力编辑页内置在线调试:填参数、执行、直接看请求报文、原始响应与解析结果,失败给排查建议,出问题不再只能翻日志。

  • ✓ 在线调试执行
  • ✓ 请求/响应全展示
  • ✓ 失败排查建议
  • ✓ 日志一键重放

三种接入方式,总有一种适合你

高频厂商内置直连,长尾厂商零代码扩展

A

内置直连(BUILTIN)

聚合平台(快递鸟 / 快递100)、直连厂商(顺丰·丰桥TMS、京东、德邦、增联、腾林、合纵、诺特、松冷、云豹)与快递鸟通道 28 家。只填密钥,端点/签名/编码全部自动带出。

  • ✓ 填密钥即用
  • ✓ 已验证签名链路
  • ✓ 一键预置能力
  • ✓ 覆盖最广
B

脚本接入(MAGIC_API)

任何长尾或定制厂商,写一段 Magic API 脚本(接收参数 Map、返回厂商原始结构即可),脚本路径从下拉选择,无需手敲路径。

  • ✓ 下拉选脚本路径
  • ✓ 不碰 Java 代码
  • ✓ 灵活适配私有接口
  • ✓ 热更新
C

HTTP 模板(EXTERNAL_HTTP)

有接口文档但不想写脚本:填地址 + 请求体模板({{字段}} 占位)+ 响应字段映射(JSONPath),平台负责装配与解析。

  • ✓ 纯配置无代码
  • ✓ 占位符模板
  • ✓ JSONPath 取数
  • ✓ 签名位置可配

已内置的物流能力

12 家主流厂商 Provider + 快递鸟通道再覆盖 28 家快递公司,多数「填密钥即用」

聚合平台

快递鸟、快递100 —— 一次接入即可调度其覆盖的众多快递公司

直连厂商(10 家)

顺丰(丰桥·TMS)、京东、德邦、增联、腾林、合纵、诺特、松冷、云豹、快递鸟直连

快递鸟通道 28 家

中通、圆通、申通、韵达、EMS、极兔、百世、宅急送、优速、安能、天天、邮政、跨越、中铁、龙邦、德邦/京东/百世/中通快运等,下拉选公司即复用已验证链路

核心能力全覆盖

下单、查轨迹、取消/撤单、电子面单、运费试算、智选物流 —— 标准接口一键预置

说明:国际件(DHL / FedEx / UPS / TNT)编码体系不同,暂未代管,可用 Magic API 或外部 HTTP 按实际接口配置。

把「配置」本身也变简单

面向实施与运维,而不是只给开发看

✶

智能填充

选「承运商编码」自动带出地址、签名、推荐能力与必需凭据,少填少错。

✶

配置模板

把配通的一套配置固化成模板,之后「套用 + 微调」即可;支持另存为模板、从模板新建、恢复出厂模板。

✶

可下拉可手输

签名字段名、时间戳、字符集、接口版本、快递公司编码、JSONPath 等统一用 SmartSelect,既给候选又不限制输入。

✶

结构化悬停说明

每个字段按「说明 / 使用场景 / 示例 / 注意」四段给出富文本提示,未登记字段不显示问号。

✶

页面内新手引导

首次进入按页引导;跨页流程引导(第一次接入 / 排查失败 / 流程节点)可从顶栏手动启动。

✶

载入推荐参数

按「厂商 + 能力」一键补齐入参/出参;粘贴真实响应可自动提取出参与 JSONPath。

5 分钟跑通一次对接

以「快递鸟查轨迹」为例

1

承运商配置

菜单「三方物流快递 → 承运商配置 → 新增」,编码选「快递鸟」即自动带出端点、签名与参数;填写密钥,自定义路由键 partnerNo(流程与回调定位承运商的键),测试期打开沙箱。

2

一键预置能力

承运商列表点「预置能力」,自动生成该厂商支持的能力(下单/查轨迹/取消/面单…)及标准入参定义,无需手搭。

3

在线调试

能力编辑页「在线调试」页签,填 {"LogisticCode":"SF123","ShipperCode":"SF"} 执行,看解析结果是否为预期结构,失败看错误码与原始响应。

4

流程里调用

流程编辑器 → 三方物流 → 拖「物流对接」节点 → 选承运商 + 能力类型 + 结果变量名;下游节点即可用 ${routeResult.data.waybillNo} 等表达式消费结果。

典型应用场景

让发货、追踪与售后不再被对接成本拖累

医药流通企业发货

开单后自动对接顺丰/京东/德邦等,生成电子面单并回写运单号,减少人工录单与差错

零售 / 电商发货

门店与电商订单统一对接多家快递,按地区与成本智能选物流,提升发货时效

多仓调拨追踪

调拨在途状态统一接入,8 态路由状态机让每一步流向清晰可查

冷链与时效监控

轨迹订阅 + 状态回调,异常停留、超时未达自动预警,保障时效与合规

供应链协同

上下游伙伴的物流节点通过统一模型对接,数据一处接入、处处复用

售后与退换

撤单/取消接口与轨迹查询打通,售后逆向物流状态实时可查

技术架构

路由中枢统一编排,接入与解析可插拔

应用与集成层

Vue3 管理端
流程节点(物流对接)
在线调试 / 日志重放
↓

引擎层(Router 中枢)

请求装配
响应归一化
签名 / 脱敏
配置缓存门面
异步日志
↓

接入层(可插拔 Provider)

内置 12 家 Provider
快递鸟 28 家通道
Magic API 脚本
外部 HTTP 模板

为什么客户选它

上线快 · 覆盖广 · 扩展易 · 看得见

01

接入周期从天到分钟

高频厂商填密钥即用,长尾厂商配置即上线,不再排期开发

02

40+ 物流通道覆盖

12 家内置直连 + 快递鸟 28 家通道,主流快递基本全覆盖

03

零代码持续扩展

新物流商用脚本或模板接入,实施人员即可完成,不依赖发版

04

配置全程可观测

在线调试、日志重放、脱敏留痕,每一次调用都查得到、说得清

05

结果统一复用

统一模型与状态机,下游流程零改造消费各家回执

06

与业务流一体

作为流程节点嵌入业务,回执自动写回变量,驱动后续动作

把物流对接,交给配置而不是开发

告诉我们你在用哪几家物流商,我们帮你 5 分钟跑通第一个对接