DHL Express 接続：リアルタイム料金・ラベル発行・追跡

最終更新 2026-11-01

DHL Developer Portal で承認済みの MyDHL API アプリから API Key と API Secret を取得し、DHL Express アカウント番号とともに Integration に入力、テスト後に料金照会・出荷開始。

DHL Express コネクタは MyDHL API でリアルタイム料金取得、ラベル購入、追跡を行います。料金と出荷は DHL Express アカウントに課金されます。DHL Express 専用です。別の API と認証情報を使う DHL eCommerce とは異なります。

DHL Express 接続手順：まずポータルの認証情報、次にアカウント番号、最後に追跡プローブテスト。

前提条件#

DHL Express アカウントと、その DHL Express アカウント番号。DHL の請求書、または mydhl+ の My Profile で確認できます。
DHL Developer Portal（developer.dhl.com）へのアクセスと、承認済みの MyDHL API アプリ。
まず練習したい場合はサンドボックスから開始：sandbox フィールドに true を入力。テスト環境には 1 日の呼び出し上限があります。

認証情報の取得#

DHL Developer Portal（developer.dhl.com）→ Apps → 承認済みの MyDHL API アプリを開きます。
Credential セクションで API Key の横の Show key をクリックしてコピーします。この API Key が API Username として入力する値です。mydhl+ サイトのログイン ID ではありません。
同じ Credential セクションで API Secret の横の Show key をクリックしてコピーします。この API Secret が API Password として入力する値です。
DHL Express アカウント番号は DHL の請求書、または mydhl+ → My Profile で確認します。Key と Secret と一緒に保管してください。接続の入力には 3 つすべてが必要です。

Integration への入力#

Integration → コネクタマーケットプレイス → DHL Express → 新規接続。
API Username：MyDHL API アプリの Credential セクションの API Key を貼り付けます。フィールド名に惑わされず、mydhl+ のログイン名ではなく API Key を入力してください。
API Password：同じ Credential セクションの API Secret を貼り付けます。フィールド名に惑わされず、mydhl+ サイトのパスワードではなく API Secret を入力してください。
DHL Express Account Number：DHL の請求書または mydhl+ → My Profile の DHL Express アカウント番号を入力します。料金とラベルはこのアカウントに課金されるため、番号が間違っていても見積やラベル発行の段階まで分かりません。
Use sandbox（任意）：練習中は true を入力してテスト環境を使用。本番では空欄にします。

接続テスト#

MyDHL にはトークン用エンドポイントがないため、テストは他のキャリアと異なります。API Key と API Secret を追跡エンドポイントに送り、存在しない出荷番号を検索します。DHL が 404（出荷が見つからない）と答えたら、それは良い知らせです。認証情報が受け入れられ、架空の出荷だけが存在しないという意味であり、テストはその 404 で合格します。401 または 403 が本当の失敗で、認証情報が拒否されたことを意味します。テストは読み取り専用で出荷は作成せず、アカウント番号も確認しません。アカウント番号が間違っていてもテストは合格し、見積やラベル発行の段階で初めて失敗します。

Mapping / テンプレート選択#

DHL Express は注文 Mapping 不要です。荷物を扱い、注文は扱いません。ここで設定するのはキャリアサービスのマッピングです。接続設定で、実際に提供する DHL Express サービスを出荷時に使うサービス名に対応付け、提供しないサービスは未マッピングのままにします。料金比較はマッピングしたサービスだけを対象とするため、アカウントで扱わないサービスで見積やラベルが作られることはありません。

DHL Express 出荷フロー：見積、ラベル購入、追跡。すべて Integration 経由。

有効化#

有効化後、出荷時に料金比較とラベル購入で利用でき、接続のアカウント番号に課金されます。追跡更新は自動で返送され、出荷に反映されます。無人で任せる前に、最初の数件を Runs / Logs で確認してください。特に最初の見積は重要です。テストではアカウント番号を確認しないためです。

よくある質問#

テストで 404 や出荷が見つからないと出た。失敗ですか？

いいえ。DHL Express では、その 404 が成功の合図です。テストは存在しない出荷番号をわざと検索します。見つからないという回答が返るのは、DHL が API Key と API Secret を受け入れ、架空の出荷だけを拒否したという意味です。

テストは合格として、Mapping と有効化に進んでください。401 または 403 の場合だけが本当の失敗です。

テストが 401 または 403 で失敗する

DHL が認証情報を拒否しました。よくある原因は、API Key または API Secret のコピーミス、両者の入れ替え、あるいは MyDHL API の Secret の代わりに mydhl+ サイトのパスワードや DHL eCommerce の認証情報を入力したことです。

DHL Developer Portal → Apps → 承認済みの MyDHL API アプリ → Credential セクションに戻り、もう一度 Show key をクリックして慎重にコピーし直してください。API Key を API Username に、API Secret を API Password に入力し、再度テストします。

テストは合格するが、見積やラベルが失敗する

接続テストではアカウント番号をまったく確認しないため、番号が間違っていても合格します。その誤りは、実際の見積やラベルがそのアカウントに課金しようとした段階で初めて現れます。

DHL Express アカウント番号を DHL の請求書または mydhl+ → My Profile と照合し、接続で修正してから見積を再実行してください。

mydhl+ のログインや DHL eCommerce の認証情報を使ったが動作しない

これらは互いに代用できない 3 種類の認証情報です。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 コネクタ用に残してください。