# DHLと連携する

## <mark style="background-color:red;">初期設定方法</mark>

### DHLアカウントの作成

DHLアカウントをお持ちでない方は、[公式ウェブサイト](https://www.dhl.com/jp-ja/home.html)よりアカウント申請を行なってください。

1. カスタマーポータルログイン＞MyDHL+をクリック
2. 右上の"登録"よりアカウントを申請する。

### API認証情報の取得

①[API Developer Portal](https://developer.dhl.com/user/login?destination=/user/) へ登録

（登録手順）

1. 画面右の "Register here" ボタンをクリックし、アカウント登録を開始する。

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2FnxncaO2wHidov7r2aRhu%2Fimage.png?alt=media&#x26;token=79e75118-e7d6-4fa4-bd6d-19678d8dbd3a" alt=""><figcaption></figcaption></figure>

2. 必要事項を入力

* "担当者 名" (First name)
* "担当者 姓"（Last address）
* "Eメールアドレス"（Email address）
* "Eメールアドレス"（Username）
* "会社名"（Company Name）
* "Japan"（Country）

3. "I have read and accept the terms of use and privacy policy\*" にチェックを入れる。
4. "I'm not a robot"にチェックを入れる。
5. 最後に、"Send" ボタンをクリックする。

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2FmCrXBel0bmjmStxYHG8x%2Fimage.png?alt=media&#x26;token=50bd38ae-0fa9-4f88-932f-b27d6f107693" alt=""><figcaption></figcaption></figure>

6. 次に、「Account details for 〇〇〇〇 at DHL API Developer Portal」というタイトルのメールが送信されるので、メール本文中段のURLをクリックして、「パスワード設定」画面にアクセスする。

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2FcTxxAb1nSCZEORNZXZHE%2Fimage.png?alt=media&#x26;token=338dfa6f-3769-4fe0-9a39-412ce5b46404" alt=""><figcaption></figcaption></figure>

7. パスワードを設定する。
8. "Save" をクリックし、プロフィールにパスワードを設定し、変更を保存する。

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2FiJNsnSqTkx6UUDcBNKQl%2Fimage.png?alt=media&#x26;token=3b95f81c-5a37-46dd-8d84-7ff688b43d1b" alt=""><figcaption></figcaption></figure>

**②**[**資格情報をリクエスト**](https://developer.dhl.com/api-reference/dhl-express-mydhl-api#get-started-section/)

1. 設定した UsernameとPasswordを入力して[Developer Portal](https://developer.dhl.com/user/login?destination=/node/112)へログインする。
2. 画面右上の "[Get Access](https://developer.dhl.com/api-reference/dhl-express-mydhl-api#get-started-section/)" をクリック
3. "DHL EXPRESS - MYDHL API ON-BOARDING REQUEST" フォームに必要事項を入力する。

* DHL Express Account Number" に9桁のDHLアカウント番号を入力
* "Requestor Company Details" には、英語で企業の詳細情報を入力

4. "Are the Requestor Details the same as the DHL Express Account Owner details?" という質問に対して "Yes" を選択する。

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2F7NAhxEj0RghoUfW1pDaz%2Fimage.png?alt=media&#x26;token=01065537-f59d-499c-9b19-f75f9e9cefe7" alt=""><figcaption></figcaption></figure>

5. "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" を選択する。
6. "Requestor Platform Name" に "AnyLogi" と入力する。
7. "Requested Services" の下にある "Rating"  "Shipment"  "Tracking"  "Pickup"をチェックする。
8. "Rating Details" には、サービス名（Rating）と1ヶ月の出荷件数の目安を入力する。
9. "Create Shipment Details" には、サービス名（Create Shipment）と1ヶ月の出荷件数を入力する。
10. "I accept the DHL Express Terms of Use" と "I accept the DHL Express General Terms and Privacy and Cookies Policy" にチェックを入れ、最後に "Submit" ボタンをクリックする。

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2FS2FQrQwFgfSIxUQHqn6q%2Fimage.png?alt=media&#x26;token=eab70fc5-9b5d-4b79-a6a9-ae1797682d0d" alt=""><figcaption></figcaption></figure>

その後、DHL Expressから2通のメールが送られてきます。

* 「DHL Express - MyDHL API: Test access approved」
* 「**DHL Express - MyDHL API: Production access approved**」

11. "DHL Express - MyDHL API: Production access approved" というタイトルのメール内のURLをクリックし、登録したUsernameとパスワードを使用してAPI Developer Portalにログインする。

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2FaEH7vRJmixs6HlkOleKY%2Fimage.png?alt=media&#x26;token=2d13a30c-ad39-493a-8578-4aef738d6190" alt=""><figcaption></figcaption></figure>

12. "Apps" ページに移動し、「DHL Express - MyDHL API - 貴社名 - JP」をクリックする。

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2FFycahvazoudVlAZLJJdu%2Fimage.png?alt=media&#x26;token=f42f4876-4834-4e27-8c03-4421f6728d79" alt=""><figcaption></figcaption></figure>

13. 表示されるページで、"API Key" と "API Secret" を確認する

これで、DHLのAPI Key（Site ID）とAPI Secret（パスワード）の取得手続きが完了となります。

## AnyLogiと接続する

1. AnyLogiにログイン＞データ連携＞配送サービス＞DHLで下記ページへ

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2Fd7xm1R12o8sMDSijb6f4%2Fimage.png?alt=media&#x26;token=26dc640e-368a-484d-bc20-cb95220e3aae" alt=""><figcaption></figcaption></figure>

2. 発行されたAPI KeyとAPI Secretをコピーして入力する。
3. DHLのアカウント番号を入力する。
4. 荷主を選択する。

* DHLとアカウント契約をしている連絡先住所を選択する。
* 事前に[基本設定](https://anymind-group.gitbook.io/any-x/v/ja-jp/label/address)で荷主の住所を登録してないと選べません。

5. 法人番号

* 日本で法人番号を持っている場合は必ず13桁の法人番号を入力する。
* 持っていない場合（個人のお客様など）は、"日本で法人番号を持っていません"をチェックする。

6. 梱包材

普段ご利用の梱包材を選択する。（※DHL梱包材を使用しない場合は選択しなくて結構です。）

{% embed url="https://mydhl.express.dhl/jp/ja/ship/order-supplies.html" %}

{% embed url="https://mydhl.express.dhl/content/dam/downloads/jp/ja/packing-with-care/dhl_express_packing_guide_jp_ja.pdf.coredownload.pdf" %}

7. 署名イメージ

署名イメージを登録すると、**ペーパーレス取引 (PLT)**&#x304C;利用可能になります。

基本はすべての出荷にPLTが適用されますが、「署名イメージが登録されていない」「PLTが適用できない国へ出荷する」場合には、PLTが適用されません。

<mark style="background-color:orange;">PLTが適用されている場合</mark>

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2FRHUeY6gbbEPJmvKiYbsV%2Fimage.png?alt=media&#x26;token=806b16ec-1c33-4ea6-bd12-00c64d9a0663" alt="" width="276"><figcaption></figcaption></figure>

<mark style="background-color:orange;">PLTが適用されていない場合</mark>

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2Fq7ghfAaeUHwgxmpb1UMS%2Fimage.png?alt=media&#x26;token=8c54d303-a450-449d-bf29-0c146296111d" alt="" width="276"><figcaption></figcaption></figure>

## <mark style="background-color:red;">送り状発行手順</mark>

{% content-ref url="box" %}
[box](box)
{% endcontent-ref %}

①海外配送ページの「出荷待ち」リストで、送り状を発行したい受注をクリックする。

②荷主、内容品種別、梱包材サイズを設定。必要に応じて、署名オプション、DDP、損害要償額も設定する。



{% hint style="info" %}
**署名オプション**をON：有料の直接配達記録サービス（Direct Signature）が適用される。

ほかの署名オプションはAnyLogiでは現在サポートしておりません。\


※直接配達記録サービスは送り状にDSRと印字されます。」（詳細は[こちら](https://www.white-box.biz/?p=1759)）
{% endhint %}

{% hint style="info" %}
**DDP**

DDPをON：送料、関税を荷送人が負担します。

DDPをOFF；DAPとして扱います。

DDPが適用されている場合は、ラベルにDTPと印字され、コマーシャルインボイスにもDDPと記載されます。
{% endhint %}

{% hint style="info" %}
**損害要償額**

損害賠償額を損害要償額を設定した場合は、WayBillに反映されます。（下図）

ただし、PLTが適用されている場合はWayBillは作成されません。※作成されなくても保険は適用されます。
{% endhint %}

<figure><img src="https://1190326794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkq0Ybbx44-Y4DQSeYp%2Fuploads%2FDH1gQpg7g8uQ4mwLPvVe%2Fimage.png?alt=media&#x26;token=a454e5c6-e17c-4785-af41-0e36db7bb799" alt=""><figcaption></figcaption></figure>

③送り状を印刷・添付する。

※送り状の詳しい発行の仕方は[こちら](dhl)
