用户手册
帮助中心/用户手册/连接器目录:快递承运商与聚合快递

连接器目录:快递承运商与聚合快递

最后更新 2026-10-20

承运商直连(UPS、FedEx、USPS、DHL)与一个 Key 接多家的聚合快递(Shippo、EasyPost、ShipEngine、ShipStation、Easyship、AfterShip、Sendle):每个向导要填的字段与获取路径。

从 Docklify 发货有两条路:用您自己的承运商账号直连(费率按该账号报价、Label 按该账号计费);或用一个 API Key 接聚合快递,通过您在聚合商账号里开通的承运商发货。两种都没有凭证时都走模拟模式——费率和 Label 明确标注「模拟」,没有真实 key 的测试绝不谎报成功。

快递承运商(直连)#

UPS

走 UPS API 查实时费率、买 Label、查轨迹,按您自己的 UPS 账号报价。完整分步指南见本栏目《接 UPS》;这里是字段摘要:

字段必填?去哪拿
Client ID必填UPS Developer Kit → 建应用 → OAuth 凭证
Client Secret必填Developer Kit 同一应用页面
Shipper Number(账号)必填您的 6 位 UPS 账号——任意一张 UPS 发票上都有

UPS 的测试和生产凭证是分开的——分开建连接,测试时选对环境。

还没有凭证?可以先在 Docklify 里把全流程练一遍:先建好 UPS 账号、凭证字段留空——发货弹窗里的费率、出面单、查轨迹都会进入明确标注的演练模式。演练费率只是培训用的估算价(带「模拟」角标),演练面单带醒目 DEMO 水印、不能拿去寄货,演练轨迹是示例时间线。凭证一旦填上并保存,全部自动切换为 UPS 真实数据。

FedEx

走 FedEx API 查实时费率、买 Label、查轨迹,按您自己的 FedEx 账号。

字段必填?去哪拿
API Key(Client ID)必填FedEx Developer Portal → My Projects → 您的项目 → API 凭证
Secret Key(Client Secret)必填同一凭证页;项目创建时只显示一次
Account Number(账号)必填您的 FedEx 账号——任意一张 FedEx 发票上都有

FedEx 只走真实数据,没有演练模式。把上面的 API Key、Secret Key 和账号填好并保存,费率、出面单、查轨迹就直接按您的 FedEx 账号实时运行。凭证缺失或不完整时,系统会先提示您补录凭证,再进行报价、买面单或查轨迹。

USPS

走 USPS API 查费率、买 Label、查轨迹。OAuth 凭证可以查费率和轨迹;买 Label 还需要您的 USPS 付款账号标识(CRID / MID / EPS)。

字段必填?去哪拿
Consumer Key必填USPS Developer Portal → Apps → 您的应用
Consumer Secret必填同一应用页面
CRID选填您的 USPS Customer Registration ID——USPS 商业账号 / BCG 资料里;买 Label 时需要
MID选填您的 USPS Mail ID——同一商业账号资料里
EPS 账号选填您的 USPS 企业付款系统(EPS)账号——Label 按它计费

DHL Express

走 MyDHL API(Express)查费率、买 Label、查轨迹。凭证由 DHL 顾问发放——没有自助拿 Key 的页面。

字段必填?去哪拿
Username(用户名)必填DHL 账号顾问为 MyDHL API 发放(Basic 认证)
Password(密码)必填与用户名一起发放
Account Number(账号)必填您的 DHL Express 账号——任意一张 DHL 发票上都有

聚合快递(一个 Key,多家承运商)#

接聚合快递只需一个连接一个 API Key;实际能用哪些承运商,取决于您在聚合商账号里开通了哪些。测试 Key(沙箱)用示例数据报价打单;正式 Key 打的是真实计费的 Label——特别注意 ShipStation 没有沙箱,它的 Key 从一开始就是正式的。

Shippo

用一个 API Token,按您 Shippo 账号里的承运商查费率、买 Label、查轨迹。

字段必填?去哪拿
API Token必填Shippo 后台 → Settings → API → API tokens。测试 token 以 shippo_test_ 开头,正式以 shippo_live_ 开头

EasyPost

用一个 API Key,按您 EasyPost 账号里的承运商查费率、买 Label、查轨迹。

字段必填?去哪拿
API Key必填EasyPost 后台 → Settings → API Keys。测试 key 以 EZTKtest 开头,生产以 EZTKprod 开头

ShipEngine

用一个 API Key,按您 ShipEngine 账号里的承运商查费率、买 Label、查轨迹。沙箱 Key(TEST_ 开头)打的是示例 Label,可以拿来练全流程。

字段必填?去哪拿
API Key必填ShipEngine 后台 → Settings → API Management → API keys

ShipStation

通过您的 ShipStation 账号(V2 API)查费率、买 Label。注意:ShipStation V2 没有沙箱——用这个 Key 打的 Label 是真实计费的。

字段必填?去哪拿
API Key必填ShipStation → Settings → Account → API Settings → API keys(V2)

Easyship

用一个 Access Token,按您 Easyship 账号里的承运商查费率、买 Label、查轨迹。Easyship 沙箱是独立环境、用独立 token。

字段必填?去哪拿
Access Token必填Easyship 后台 → Settings → API Integration / 开发者 → access token(生产 token 以 prod_ 开头)

AfterShip(Postmen)

通过您的 Postmen(AfterShip Shipping)账号查费率、买 Label。Postmen 不提供轨迹接口——它用来报价和打单,轨迹在承运商或 Docklify 的轨迹视图里看。

字段必填?去哪拿
API Key必填Postmen 后台 → Settings → API(作为 as-api-key 请求头发送)
Shipper Account Slug选填要发货的承运商账号在 Postmen 里的 slug(有多个账号时填)

Sendle

用 Sendle(澳/美/加)打 Label、查轨迹。Sendle 没有比价接口——报价在建单时逐单返回。

字段必填?去哪拿
Sendle ID必填Sendle 后台 → Settings → API(您的 Sendle ID)
API Key必填同一 API 设置页(与 Sendle ID 一起做 Basic 认证)