接 DHL Express：实时费率、打 Label、查轨迹
在 DHL Developer Portal 里已获批的 MyDHL API 应用中拿到 API Key 和 API Secret，连同 DHL Express 账号一起填进 Integration，测试通过就能查费率、打单。
DHL Express 连接器走 MyDHL API 查实时费率、买 Label、查轨迹。费率和运单都计入您的 DHL Express 账号。这里只讲 DHL Express——不是 DHL eCommerce，两者 API 不同、凭证也不同。
前置条件#
- 一个 DHL Express 账号，以及它的 DHL Express 账号——在 DHL 账单上，或在 mydhl+ 的 My Profile 里能找到。
- 能进 DHL Developer Portal（developer.dhl.com），且已有一个获批的 MyDHL API 应用。
- 想先练一遍就从沙箱开始：把沙箱字段填 true。测试环境有每日调用上限，测试次数留给真正的检查。
拿凭证#
- 去 DHL Developer Portal（developer.dhl.com）→ Apps → 您已获批的 MyDHL API 应用。
- 在 Credential 区，点 API Key 旁的 Show key 并复制。这个 API Key 就是后面要填作 API Username 的值——它不是 mydhl+ 网站的登录账号。
- 在同一个 Credential 区，点 API Secret 旁的 Show key 并复制。这个 API Secret 就是后面要填作 API Password 的值。
- 在 DHL 账单上，或在 mydhl+ → My Profile 里找到您的 DHL Express 账号。把它和 Key、Secret 放在一起——填连接时三样都要用。
填进 Integration#
- 打开 Integration → 连接器市场 → DHL Express → 新建连接。
- API Username：粘贴 MyDHL API 应用 Credential 区的 API Key。别被字段名误导：这一栏填的是 API Key，不是 mydhl+ 登录名。
- API Password：粘贴同一 Credential 区的 API Secret。同样别被字段名误导：这一栏填的是 API Secret，不是 mydhl+ 网站登录密码。
- DHL Express Account Number：填 DHL 账单上或 mydhl+ → My Profile 里的 DHL Express 账号。费率和 Label 都计入这个账号，填错了要到报价或打单时才会暴露。
- Use sandbox（可选）：练习时填 true 走测试环境；正式使用时留空走生产环境。
测试连接#
MyDHL 没有 token 端点，所以测试方式和别的承运商不一样：它拿您的 API Key 和 API Secret 去轨迹端点查一个不存在的单号。如果 DHL 返回 404——单号不存在——这反而是好消息：说明凭证被接受了，只是那个编造的单号查无此单。测试就是在这个 404 上判定通过。401 或 403 才是真失败：说明凭证被拒。测试是只读的，不会创建运单，也不查您的账号——账号填错了测试照样能过，要到报价或打单时才会失败。
配 Mapping / 选模板#
DHL Express 不需要订单 Mapping——它处理包裹，不处理订单。这里要配的是承运商服务映射：在连接设置里，把您实际提供的每个 DHL Express 服务对到您发货时用的服务名上，不提供的服务留空不映射。这样比价就只报您映射过的服务，包裹不会被报到或打到您账号并不发的服务上。
激活#
激活后，连接即可在发货时用于比价和买 Label，费用计入连接上的 DHL Express 账号。轨迹更新会自动回来，落到运单上。放手跑之前，先在 运行监控 / 日志里盯头几单——尤其是第一次报价，因为测试不查账号。
常见问题#
测试提到 404 或单号不存在——是失败了吗？
没有——对 DHL Express 来说，这个 404 正是通过信号。测试是故意去查一个不存在的单号。能拿到“不存在”的回答，说明 DHL 接受了您的 API Key 和 API Secret，只是拒绝了那个编造的单号。
把这次测试当作通过，继续去配 Mapping 和激活。只有返回 401 或 403，才是测试真的失败。
测试报 401 或 403
DHL 拒绝了凭证。常见原因是 API Key 或 API Secret 复制错了、两者填反了，或者填的是 mydhl+ 网站密码——又或是 DHL eCommerce 的凭证——而不是 MyDHL API 的 Secret。
回到 DHL Developer Portal → Apps → 已获批的 MyDHL API 应用 → Credential 区，再次点 Show key，仔细重新复制：API Key 填进 API Username，API Secret 填进 API Password。然后重新测试。
测试通过了，但报价或打单失败
连接测试根本不查账号，所以账号填错了测试也能通过。这个错误要到真正的报价或打单去向那个账号计费时才会暴露。
拿 DHL 账单或 mydhl+ → My Profile 核对 DHL Express 账号，在连接里改对，再重新报价。
我填了 mydhl+ 登录或 DHL eCommerce 凭证，不行
这是三套不同的凭证，互相不能替代：mydhl+ 网站登录只用于网站，DHL eCommerce 凭证属于另一套 API，而这个连接只认 MyDHL API 应用的 API Key 和 API Secret。
这个连接只用 MyDHL API 凭证：DHL Developer Portal → Apps → 已获批的 MyDHL API 应用 → Credential 区 → 点 Show key 取 API Key 和 API Secret。eCommerce 的凭证留给 eCommerce 连接器用。