商业项目 · 真实企业客户● 上线运行 · 持续维护中

速达非物流 Shopify / WooCommerce 插件

为国际物流企业速达非(Speedaf)开发的双平台物流插件:将电商店铺与物流系统之间的履约链路完全打通——运费查询、在线下单、物流轨迹跟踪。

Shopify AppWooCommerce物流 API 对接双端交付长期维护

项目背景

速达非(Speedaf)是覆盖非洲、中东等新兴市场的国际物流企业。跨境卖家在其平台上发货时,需要在自己的电商店铺里完成运费计算、创建运单、跟踪包裹——这些动作如果靠人工在两个系统之间来回搬运,效率低且容易出错。本项目的目标:让卖家在 Shopify 或 WooCommerce 店铺内,直接完成与速达非的物流交互。

交付内容

Shopify 端(App)

  • 基于官方 App 架构(app.toml / OAuth / Admin GraphQL API)
  • 运费实时查询,结算页自动展示运费方案
  • 订单创建后自动推送运单至速达非系统
  • 物流轨迹状态回传,商家后台可见
  • Webhook 订阅处理订单与履约状态变化

WooCommerce 端(插件)

  • 物流方式集成,结算页运费实时计算
  • 订单推送与运单号回写
  • 轨迹查询展示,客户可自助查件
  • 兼容 HPOS(高性能订单存储)
  • 与主题和常用插件的无冲突适配

技术难点与解决

双平台体系差异大。 Shopify App 与 WooCommerce 插件是两套完全不同的架构:App 走 OAuth + GraphQL + Webhook,插件走 PHP 钩子体系。物流逻辑需抽象出一层与平台无关的中间层,两端各自适配。

物流状态回传的可靠性。 轨迹数据由物流方推送,存在延迟与乱序。通过状态机管理运单生命周期,乱序到达的状态按时间戳归位,避免展示错乱。

长期可维护性。 物流 API 会演进,电商平台会升级。代码按"平台适配层 / 物流逻辑层 / API 客户端层"分层,平台变更只改适配层,这也是本插件能持续维护数年的原因。

成果

2 平台
Shopify + WooCommerce 双端交付
持续维护
上线至今,跟进平台与 API 变更
全链路
订单→运单→轨迹免人工

补充说明

这不是一个一次性交付的 demo——插件上线后一直跟随 Shopify 与 WooCommerce 的版本演进持续适配,并按"项目费 + 年度维护"的模式与客户长期合作。对同类物流企业而言,这套能力(运费查询 / 下单 / 轨迹)高度通用,可以按需求快速适配新的物流 API。

技术栈

Shopify

Remix(Node.js)Admin GraphQL APIOAuthWebhookapp.toml

WooCommerce

PHPWooCommerce HooksHPOS 兼容REST API

通用

物流 API 客户端状态机MySQLRedis 缓存

您的物流或履约链路需要打通?

同类需求(物流商 API 对接、海外仓、订单同步)可直接沟通,我提供免费评估。

邮件沟通:tanwei@mslbit.com