教学中心 / 集成指南
连接快递(Flash、Kerry、J&T、泰国邮政、SPX、Ninja Van、DHL)
把快递公司的 API 密钥存进 SellerTiger 后,在 订单 → 发货 里就能选这家快递建运单、打印面单、自动跟踪物流。平台订单(Shopee / Lazada / TikTok Shop)仍然走平台自己的物流;快递连接用于官网、LINE、手工单等自己发货的订单。
现状(2026-10-17): 密钥加密保存后即可在发货时选择这家快递。服务器开启「快递正式调用」之前,建的都是 测试运单(单号以
TEST开头,不会真的叫快递)。Flash Express 已按官方接口接好;其他快递的接口按文档预留,也可以在订单里手动填运单号。
开始之前
- 谁来做: SellerTiger 里「设置」4 级权限的人。
- 快递账号: 泰国的快递公司都不提供自助申请 API 的网站,要先和快递签约(企业 / 电商客户),再向你的 快递销售或客户经理 要 API 凭证。通常先给测试(Sandbox)凭证,对接测试通过后给正式(Live)凭证。
每家快递要什么
| 快递 | SellerTiger 里的字段 | 向快递要什么(快递那边的叫法) |
|---|---|---|
| Flash Express | 商户号(Merchant ID)、API Key | 签约后 Flash 泰国团队发的 mchId 和 secret key |
| Kerry Express(KEX) | App ID、App Key | KEX 销售发的 App ID、API Key(还有一个 Prefix,SellerTiger 暂不需要) |
| J&T Express | 客户编号(Customer code)、API Key、私钥 / 签名密钥 | J&T 合作协议后发的客户编号和签名密钥 |
| 泰国邮政(Thailand Post) | API Token | 泰国邮政物流 API 的 Token(一般在 track.thailandpost.co.th 的开发者页面注册后生成;2026-10-17 未能在官方页面核实,请以泰国邮政为准) |
| SPX Express | App ID、API Secret | SPX 商户 API 凭证(SPX 目前没有公开的商户 API,通常经 Shopee 体系) |
| Ninja Van | Client ID、Client secret | 客户经理在沙箱对接审核后发的正式 Client ID / Client Key(泰国区 /TH/) |
| DHL eCommerce | Client ID、Client secret、取件账号(Pickup account) | DHL 销售发的 Client ID 和密码(沙箱、正式各一套),以及 Pickup Account ID |
第 1 步 · 凭证:填进 SellerTiger
- 设置 → 连接与授权 → 「物流 / 快递」→ 点要用的快递图标。
- 在 密钥 里按上表填每一栏。已保存的栏会显示「打码值 · 留空 = 保持不变」,只改要改的那栏。
- 环境 选 测试(Sandbox) 或 正式(Live),要和凭证一致。
- 勾 在手工单里可选。
- 点 保存。

第 2 步 · 加密 / Webhook:不需要
密钥在 SellerTiger 加密保存。物流状态由 SellerTiger 定时查询(默认每小时),不需要在快递那边配 Webhook。
第 3 步 · 权限:由快递按合同开通
第 4 步 · 回调:不需要
第 5 步 · 测试
点 测试连接:
- 「资料已保存 · 测试模式」:密钥齐了,发货会生成
TEST开头的测试运单。 - 「资料已保存 · 正式调用已开启」:服务器已开启正式调用,会真的向快递下单。
- 「密钥已保存。快递 API 对接还没上线……」+「未完成:…」:还缺字段,或这家快递接口还是预留。
测试后窗口顶部可能显示红色的「上次测试 ✗ · saved_test_mode」,这是已知的显示问题,意思就是「已保存 · 测试模式」,不是失败。
第 6 步 · 开始发货
- 订单 → 打开一张自己发货的订单 → 发货。
- 选这家快递,确认重量和 COD → 建运单。测试模式下单号以
TEST开头。 - 打印面单;物流状态在 数据中心 → 订单 → 物流 / 快递运单 按频率自动更新。
常见问题
| 你看到的提示 | 原因 | 怎么办 |
|---|---|---|
| 还没有设置这个快递,请先在设置里接入 | 发货时选的快递没保存密钥 | 完成第 1 步 |
| 接口预留,暂未实现 | 这家快递的 API 还没接通 | 先手动填运单号 |
| 不支持这个快递 | 快递不在列表里 | 手动填运单号 |
| 未知字段 | 字段名不对(一般是旧版本页面) | 刷新页面重填 |
| 运单号都是 TEST 开头 | 服务器还没开启快递正式调用 | 联系 SellerTiger 开启;之前的测试运单不会产生快递费用 |
| 清除这家快递的密钥 | 想停用 | 点后确认,手工单里将不能再选它 |
还需要帮助?
在 SellerTiger 中打开在 SellerTiger 里点右下角的耳机按钮,询问 AI 助手或提交工单。