Shippo物流打单集成金蝶云星空解决方案

更新: 10/9/2026 字数: 0 字 时长: 0 分钟

业务背景

源系统	成集云	目标系统
Shippo物流发货平台		金蝶云星空ERP

Shippo 是海外广泛使用的航运 API 平台，聚合 USPS、FedEx、UPS、DHL 等数十家承运商，提供运费比价、面单购买、批量发货与全链路物流轨迹追踪能力，是跨境电商、独立站与海外仓履约环节的核心「打单中枢」。

企业的履约链路常常是：金蝶云星空管理销售订单与库存，Shippo 负责实际发货与物流追踪，两者若各自为政会带来明显痛点：

• 出库人员在金蝶看到待发货订单，却要切到 Shippo 逐单录入地址、比价、买面单，重复操作且易错；
• 物流单号、面单 PDF 无法回写金蝶，仓管与客服查不到发货状态；
• 物流轨迹停留在 Shippo，金蝶无法感知「在途 / 已签收」，影响应收确认与售后时效；
• 运费散落在 Shippo，财务难以归集到对应订单与销售费用，对账困难。

通过成集云数据集成平台，可将金蝶的销售发货需求自动驱动 Shippo 完成比价、购单、打单，并把物流单号、面单、轨迹与运费实时回写金蝶，打通「ERP 发货—Shippo 履约—财务核算」全链路。

解决方案

基于成集云 iPaaS 数据集成平台，通过 Shippo REST API（Authorization: ShippoToken <token> 鉴权，统一端点 https://api.goshippo.com/）对接其 shipments / rates / transactions / batches / tracks 等资源，结合 Webhook 事件推送，构建可视化自动同步任务：金蝶发货通知单触发 Shippo 创建运单并购买面单，回写物流单号与面单地址；Shippo 物流轨迹与运费变化实时回写金蝶，形成闭环履约。

对接要点：

• 鉴权方式：Shippo Token（Authorization: ShippoToken <token>），支持 Live / Test 双环境，建议生产用 Live Token。
• 核心资源：addresses（地址）、parcels（包裹）、shipments（运单）、rates（运费）、transactions（面单购买）、batches（批量发货）、tracks（轨迹）。
• 事件驱动：订阅 transaction_updated（面单状态）、track_updated（轨迹变更）等 Webhook，实现近实时回写，无需轮询。

业务流程

一、发货制单与面单回写流程

二、物流轨迹实时同步流程

三、运费核算与归集流程

四、批量发货流程

对接说明

一、基础资料同步（源 → 目标）

Shippo 对象	金蝶云星空对象	关键字段映射
Address（收发货地址）	收货地址 / 客户地址	name / street1 / city / zip / country → 收货地址字段
Parcel（包裹）	发货包裹信息	weight / width / height → 包裹规格（作为履约参考）
Carrier Account（承运商）	承运商档案	carrier name → 承运商名称

二、业务单据同步（源 → 目标）

Shippo 对象	金蝶云星空对象	触发条件
Shipment + Transaction	销售出库单物流单号 / 面单	金蝶发货通知单触发创建并购买面单
Track（轨迹）	出库单物流状态	Webhook track_updated 状态变更
Transaction 运费	销售费用单 / 运费归集	面单购买成功后回写金额
Batch（批量）	批量出库单更新	多单合并发货时批量回写

三、同步规则与过滤条件

• 触发规则：仅当金蝶销售订单状态为「已审核 / 待发货」且关联发货通知单生成时，才触发 Shippo 制单，避免重复购单。
• 承运商选择：可按订单重量、目的国、时效要求配置比价规则（如「美国境内优先 USPS Priority，跨境优先 DHL」），由成集云自动选优。
• 幂等去重：以金蝶发货通知单号为外部主键，Shippo 侧记录 object_id，重复触发仅补打不重复购单；面单购买成功前失败可安全重试。
• 异常处理：承运商接口超时自动退避重试；轨迹 Webhook 非幂等待客户端做去重（同一 tracking_number 仅保留最新状态）；同步异常进入成集云异常队列并告警。
• 多币种：跨境运费以原币种记录，金蝶通过币别与汇兑损益处理。

业务价值

• 发货零切换：ERP 一键驱动 Shippo 比价购单，仓管不再跨系统录单，单票发货操作时间从分钟级降到秒级。
• 物流可视：物流单号、面单、在途与签收状态实时回写金蝶，客服与财务共享同一视图，售后与应收确认更及时。
• 运费可控：每笔运费自动归集到对应订单与销售费用，月底运费核算从「Excel 拼凑」变为「系统直出」。
• 批量提效：大促多单并发时走 Shippo Batch 批量发货，配合成集云批量回写，履约吞吐显著提升。
• 全程可追溯：发货、物流、费用三流合一且保留外部单号，差错可快速定位到具体承运商与包裹。

接口文档

• Shippo API 参考文档：https://goshippo.com/docs/reference
• Shippo 公开 API（地址/包裹/运单/面单/批量/轨迹）：https://docs.goshippo.com/shippoapi/public-api/
• Shippo 物流轨迹与 Webhook：https://docs.goshippo.com/tracking/tracking
• 金蝶云星空 OpenAPI 文档（开放平台）