DHL Express REST APIのKeyとSecretを取得する方法

Ship&coでDHLアカウントを使用するためには、DHLのAPI資格情報を取得する必要があります。以下のステップに従ってください。

• API Key ＝ Ship&co画面での表記は "Site ID"
• API Secret ＝ Ship&co画面での表記は "パスワード"

＊ お客様1社につき、1件のAPI Key取得となります。同一の事業者様で複数のDHLアカウントのご契約をお持ちで、それぞれShip&coに登録を希望される場合は、同一のAPI Key (Site ID) とAPI Secret (パスワード) で全てのアカウント登録を完了いただけますので、アカウント毎のAPI Key取得は不要です。

ステップ1 : DHL Developer Portalでアカウント登録を行う

(以前からShip&coでDHLの送り状発行を利用されていて、既にDHL Developer Portalのアカウントをお持ちの場合は、ステップ2に進んでください）

1. DHL Developer Portal にアクセス: https://developer.dhl.com/user

2. 必要項目を記入します。

• First Name（名を英語で入力）
• Last Name（姓を英語で入力）
• Email address （Eメールアドレス）
• Username（Eメールアドレスを入力してください)
• Company name（会社名や屋号等を英語で入力してください）
• Country（居住の国を選択）

利用規約とプライバシーポリシーに同意し、チェックを入れます

CAPTCHAを完了し、Send (送信) をクリック

3. portal@developer.dhl から、件名 "Account details for [あなたのEメールアドレス] at DHL API Developer Portal" のメールが届きます。

メール内のリンクをクリックして、パスワード設定画面に進みます。

4. パスワードを設定する

「SET PASSWORD（パスワード設定）」画面にて「Log In」をクリックし、Profileにて任意のパスワード* を設定、「Save」をクリックして情報を保存します。*パスワードは8文字以上、大文字/小文字/数字/半角記号 (例: &, $, @) のうち3種類以上含むこと。

ステップ2 : API資格情報のリクエスト

1. DHL Developer Portal (https://developer.dhl.com/express) にアクセスし、上記ステップ1 で設定したUsernameとPassword でログインします。(以前からShip&coでDHLの送り状発行をご利用いただいていた場合は、過去に取得されたDHL Developer PortalのUsernameとPassword でログインできます)

2. ログイン後、画面右上の "Get Access!" をクリックしてAPI資格情報をリクエストします。

3. 「DHL EXPRESS - MYDHL API ON-BOARDING REQUEST」にて顧客情報を入力します（*がついた項目は必須です）。全て半角英数字で入力してください。

• DHL Express Account Number : 9桁数字のDHLアカウント番号
• Requestor Company Details : 英語で入力
• Are the Requestor Details the same as the DHL Express Account Owner details?
  に「Yes」を選択します。
• How would you like to use the API? には「I require credentials to DHL Express – MyDHL API for an existing plugin/ecommerce platform/third-party solution」を選択します。
  Requestor Platform Name：「Ship&co」を入力します。
• Requested Services：「Rating」と「Shipment」にチェックを入れます。
  Rating Details：サービス名（Rating）と１ヶ月のDHL出荷件数の目安を入力します。
  Create Shipment Details：サービス名（Create Shipment）と１ヶ月のDHL出荷件数の目安を入力します。

4. 最終ステップ

DHL Express利用規約および一般条件とプライバシーポリシーに同意し、チェックを入れます。

Submit (送信) をクリックしてリクエストを完了します。

ステップ3 : API資格情報の確認

1. 登録後、翌営業日まで (受付: 平日9:00 - 17:30) に、DHL Express - MyDHL API（no-reply@dhl.com）から以下の2通のメールが届きます。

　- DHL Express - MyDHL API: Test access approved
　- DHL Express - MyDHL API: Production access approved

2通目のメール（本番アクセス承認）が届いたら、メール内のリンクをクリックして、登録したUsername と Password で DHL Developer Portal にログインします。

2. DHL Developer Portal て「DHL Express - MyDHL API - 貴社名 - JP」をクリックします。

. ポータル内のDHL EXPRESS - MYDHL APIセクションで、会社名のリンクをクリックします。

. APIキーとAPIシークレットを確認します。(Show Keyをクリックして資格情報を表示します)

以上で、Ship&coとDHLアカウントの統合に必要となるDHLのAPI Key (Site ID) とAPI Secret (パスワード) の取得が完了です。

ご注意：

1. DHLのAPIキー発行の対応時間は、平日9:00〜17:30となっております。平日営業完了時間（17:30）以降にご登録の場合、DHLシステム側での発行作業が翌営業日となりますので、ご了承ください。
2. 2023年8月28日より、DHL側での名称が変更されました。DHLからの案内には「API Key」(＝Site ID) ならびに「API Secret」(＝パスワード) として表記されますので、ご留意ください。
3. DHL XMLサービスから「API Key」と「API Secret」を取得された後、DHL側で有効化されるまでに最大4時間程度かかることがあります。DHL側でこれらが有効化される前にShip&co画面に登録された場合、「アカウント情報が正しくありません。もう一度確認してください。」というエラーメッセージが表示されますので、その場合は、少し時間をおいて再度 操作をお願いいたします。

4. 上記の手順で取得されたAPI Key (Site ID) を使った送り状発行の操作が一定期間 (取得から6ヶ月間) 認められない場合、IDはDHLにより予告なく削除され、削除されたIDを使って送り状発行しようとするとIDが存在しない旨のエラーが発生します。該当のケースにおいては、DHL Developer Portal画面から新たにAPI Key (Site ID) とAPI Secret (パスワード) を取得していただく必要がありますので、何卒ご了承ください。これらの取得に関するご不明点については、DHLの担当窓口：jp-integration@dhl.com 宛にお問い合わせください。