教学中心 / 集成指南

连接快递(Flash、Kerry、J&T、泰国邮政、SPX、Ninja Van、DHL)

约 3 分钟

把快递公司的 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 KeyKEX 销售发的 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 ExpressApp ID、API SecretSPX 商户 API 凭证(SPX 目前没有公开的商户 API,通常经 Shopee 体系)
Ninja VanClient ID、Client secret客户经理在沙箱对接审核后发的正式 Client ID / Client Key(泰国区 /TH/)
DHL eCommerceClient ID、Client secret、取件账号(Pickup account)DHL 销售发的 Client ID 和密码(沙箱、正式各一套),以及 Pickup Account ID

第 1 步 · 凭证:填进 SellerTiger

  1. 设置 → 连接与授权 → 「物流 / 快递」→ 点要用的快递图标。
  2. 在 密钥 里按上表填每一栏。已保存的栏会显示「打码值 · 留空 = 保持不变」,只改要改的那栏。
  3. 环境 选 测试(Sandbox) 或 正式(Live),要和凭证一致。
  4. 勾 在手工单里可选。
  5. 点 保存。
SellerTiger 快递窗口:密钥、环境、在手工单里可选
SellerTiger 快递窗口:密钥、环境、在手工单里可选

第 2 步 · 加密 / Webhook:不需要

密钥在 SellerTiger 加密保存。物流状态由 SellerTiger 定时查询(默认每小时),不需要在快递那边配 Webhook。

第 3 步 · 权限:由快递按合同开通

第 4 步 · 回调:不需要

第 5 步 · 测试

点 测试连接:

  • 「资料已保存 · 测试模式」:密钥齐了,发货会生成 TEST 开头的测试运单。
  • 「资料已保存 · 正式调用已开启」:服务器已开启正式调用,会真的向快递下单。
  • 「密钥已保存。快递 API 对接还没上线……」+「未完成:…」:还缺字段,或这家快递接口还是预留。

测试后窗口顶部可能显示红色的「上次测试 ✗ · saved_test_mode」,这是已知的显示问题,意思就是「已保存 · 测试模式」,不是失败。

第 6 步 · 开始发货

  1. 订单 → 打开一张自己发货的订单 → 发货。
  2. 选这家快递,确认重量和 COD → 建运单。测试模式下单号以 TEST 开头。
  3. 打印面单;物流状态在 数据中心 → 订单 → 物流 / 快递运单 按频率自动更新。

常见问题

你看到的提示原因怎么办
还没有设置这个快递,请先在设置里接入发货时选的快递没保存密钥完成第 1 步
接口预留,暂未实现这家快递的 API 还没接通先手动填运单号
不支持这个快递快递不在列表里手动填运单号
未知字段字段名不对(一般是旧版本页面)刷新页面重填
运单号都是 TEST 开头服务器还没开启快递正式调用联系 SellerTiger 开启;之前的测试运单不会产生快递费用
清除这家快递的密钥想停用点后确认,手工单里将不能再选它
还需要帮助?

在 SellerTiger 里点右下角的耳机按钮,询问 AI 助手或提交工单。

在 SellerTiger 中打开