VibeFox DHL Africa for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 5.0 以降がインストールされ、有効になっていること。WooCommerce がないとプラグインは有効化できません。
PHP: 8.0 以降。
DHL Express アカウント（リアルタイム料金のみ）: リアルタイム料金は MyDHL API を使用します。DHL Express のアカウント番号と MyDHL API の認証情報（API キーと API シークレット）が必要です。DHL Developer Portal（MyDHL API、「Get access」）または DHL Express のアカウントマネージャーから取得してください。すでに DHL XML Services の認証情報（Site ID とパスワード）をお持ちの場合は、それを代わりに使用できます。代替料金のみを使う場合、DHL の認証情報は不要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin を開き、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_dhl_africa フォルダーを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます: WooCommerce > Settings > Shipping > DHL Express Africa。または、Plugins ページでプラグイン名の下の Settings をクリックします。
4. ページ上部のライセンス欄に VibeFox ライセンスキーを入力し、Activate をクリックします。
5. DHL API を選択し、API キー、API シークレット、DHL アカウント番号を入力します。テストの認証情報を使用している間は Test mode をオンのままにします。Ship from の住所を入力します。DHL アカウントがストアの通貨で請求されていない場合は、DHL quote currency と Exchange rate を設定します。必要に応じて、国ごとの料金と代替料金を設定します（「設定」の項を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で DHL Express Africa を配送ゾーンに追加するか、Ignore shipping zones をオンにして国を選択します。
設定
すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > DHL Express Africa。設定はすべての配送ゾーンに適用されます。配送方法をゾーンに追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます:
Title (zone): このゾーンでチェックアウト時に表示されるこの選択肢の名前。空欄のままにすると、全体の Name を使用します。
設定の上部の警告は、認証情報または発送元が不足しているためにリアルタイム料金が無効になっている場合、また見積もり通貨が設定されているのに為替レートがない場合に表示されます。設定を保存するたびに、キャッシュされた DHL の見積もりが消去されます。料金と重量は小数点のカンマでもピリオドでも入力できます。
一般
Enable/Disable: すべてのゾーンでこの方法をまとめてオンまたはオフにします。
Name: チェックアウトに表示される配送方法の名前。既定値: DHL Express。
Tax status: Taxable（WooCommerce の税金が有効な場合）は、DHL が見積もった税金を除いた DHL 料金を取得し、WooCommerce が独自の税金を追加します。None は、税金込みで見積もられた DHL 料金をそのまま請求します。
DHL Express アカウント（リアルタイム料金にのみ必要）
DHL API: 使用する DHL のインターフェース。選択した API の項目だけが表示されます。
API key: MyDHL API のユーザー名（API キー）。
API secret: MyDHL API のパスワード（API シークレット）。
XML Site ID: DHL XML Services の Site ID（旧 API のみ）。
XML password: DHL XML Services のパスワード（旧 API のみ）。
DHL account number: DHL Express のアカウント番号（9 桁）。MyDHL API では必須です。XML Services の場合は、公開料金ではなくご契約のアカウント料金が返されます。
Test mode: DHL のテスト環境を使用します。既定値はオンです。テストの認証情報はテスト環境でのみ、本番の認証情報は本番環境でのみ有効です。本番運用を開始するときはオフにしてください。
発送元
DHL が荷物を集荷する住所。料金はこれによって変わります。
Origin country: 発送元の国。
Origin city: 発送元の都市（例: Johannesburg）。MyDHL API では必須です。
Origin postcode: 郵便番号のない国（例: ケニア、ナイジェリア、ガーナ）では空欄にします。
料金
すべての料金はストアの通貨で入力します。リアルタイム料金は、荷物に対する最も安い DHL Express 製品の料金です。DHL が設定されていない、失敗した、またはその経路にサービスがない場合は、国ごとの料金が使用され、その次に代替料金が使用されます。どちらもない場合、この配送方法は非表示になります。
DHL quote currency: DHL は DHL アカウントの国の通貨（例: ZAR、NGN、KES）で見積もります。DHL がストアの通貨での金額を返さない場合、リアルタイム料金はこの通貨から下記の為替レートで換算されます。そうでなければ使用されません。
Exchange rate: DHL 見積もり通貨 1 単位がストアの通貨でいくらになるか（例: 1 ZAR = 0.05）。換算しない場合は空欄にします。レートは手動で設定します。
Fallback cost: リアルタイム料金も国ごとの料金もない場合の一律の料金。空欄にすると、この配送方法は非表示になります。
Country prices: 届け先の国ごとの代替料金。1 行に 1 つ、CC:Price の形式で入力します（例: ZA:25.00）。リアルタイム料金がない場合に使用されます。
Fallback price basis: Per order は料金を 1 回だけ請求します。Per item (multiplied by the cart quantity) は料金にカートの数量を掛けます。これは国ごとの料金と代替料金のみに適用されます。リアルタイムの DHL 料金は常に荷物全体についてのものです。
Free shipping from: この配送方法が無料になるカートの小計。DHL には問い合わせません。空欄にすると無料になることはありません。
条件
Minimum weight (kg): カートの重量がこの値未満の場合、この配送方法を非表示にします。0 は制限なしを意味します。
Maximum weight (kg): カートの重量がこの値を超える場合、この配送方法を非表示にします。既定値: 70。0 は制限なしを意味します。
Minimum subtotal: カートの小計がこの金額以上の場合にのみ、この配送方法を表示します。常に表示する場合は空欄にします。
Excluded shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかの商品が含まれている場合、この配送方法を非表示にします。
配送ゾーンを使用しない場合の提供条件
Ignore shipping zones: 一致した配送ゾーンにこの配送方法が追加されていなくても、下記の国にこの配送方法を提供します。
Countries: そのモードの届け先の国。空欄にすると、ストアが発送するすべての国を使用します。Ignore shipping zones がオンの場合にのみ使用されます。
詳細設定
Debug log: 料金計算のログを WooCommerce > Status > Logs に、ソース vfd-dhl-africa で記録します。このオプションがオフでも、DHL のエラーは常に記録されます。認証情報と購入者の住所は決して記録されません。
Remove data on uninstall: オンの場合、プラグインを削除すると、その設定と配送ゾーンの方法が削除されます。プラグインを無効化してもデータが削除されることはありません。
チェックアウト時の動作
購入者が配送先の住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインは最初にカートの重量、最低小計、除外する配送クラスを確認します。送料無料が適用される場合、購入者への配送は無料になり、DHL へのリクエストは送信されません。
そうでない場合、プラグインは DHL に発送元と届け先（国、都市、郵便番号）、キログラムに換算したカートの重量（最低 0.5 kg）、そして商品の寸法（cm）から作成した 1 つの箱を送信します。箱は、最長の長さ、最大の幅、積み重ねた高さで構成されます。寸法のない商品は何も加えません。どの商品にも寸法がない場合は、10 x 10 x 10 cm の箱が使用されます。国際配送は商品として申告され、申告価値はカートの小計になるため、DHL は荷物の商品を基に見積もります。国内配送は申告されません。リアルタイム料金は、購入者が都市を入力した後にのみ要求されます（XML Services の場合は都市または郵便番号）。
最も安い DHL Express の製品が、設定したタイトルで 1 つの料金として表示されます。購入者には DHL の製品や配送日数は表示されません。製品名（例: "EXPRESS WORLDWIDE (P)"）は注文の配送明細に DHL product として保存されるため、どの製品を予約すればよいかがわかります。
各見積もりは、荷物と経路ごとに 1 時間キャッシュされます。失敗したリクエストは 10 分間キャッシュされるため、更新のたびにチェックアウトが DHL の応答を待つことはありません。API のタイムアウトは 12 秒です。DHL がエラーを返す、またはサービスがない場合でも、購入者にエラーは表示されません。代替料金が使用されるか、配送方法が非表示になります。
この方法は、クラシックチェックアウトと、カートとチェックアウトのブロックの両方で機能します。WooCommerce の高性能注文ストレージ（HPOS）に対応しています。
プラグインが行うのは料金の計算のみです。DHL の配送の作成、ラベルや商業送り状の印刷、集荷の予約、荷物の追跡、DHL のサービスポイントの提供、購入者による DHL 製品の選択、複数の箱への梱包、保険の追加、関税や税金の見積もりは行いません。見積もりは配送料のみのものです。関税と輸入税は受取人が支払います。
ライセンスキー
プラグインは vibefox.net で発行された VibeFox ライセンスキーで動作します。ライセンス欄は WooCommerce > Settings > Shipping > DHL Express Africa の上部にあります。キーを License key に貼り付け、Activate をクリックします。ライセンス欄にはステータス（例: ライセンスの有効期限の日付）とドメインが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。リンク Manage licenses and domains in your account は、vibefox.net のアカウントを開きます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。枠を解放するには、vibefox.net のアカウントで行ってください。
有効なキーがない場合、チェックアウトの購入者には DHL Express が表示されません。ストアの管理者としてログインしている場合は、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインのページと WooCommerce のページには、リマインダーが表示されます。既存の注文には影響しません。
ライセンスが期限切れになっても、プラグインは引き続き動作しますが、アップデートとサポートには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに DHL Express が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、そして購入者の国のゾーンに配送方法が追加されていること（または Ignore shipping zones がオンで国が許可されていること）を確認してください。重量の制限、Minimum subtotal、Excluded shipping classes を確認します。リアルタイム料金がない場合、国ごとの料金または代替料金が設定されているときにのみ配送方法が表示されます。
リアルタイム料金が表示されない: 設定ページ上部の警告（認証情報または発送元の不足）を確認してください。Debug log をオンにして、WooCommerce > Status > Logs をソース vfd-dhl-africa で開きます。誤った認証情報、経路にサービスがない、通貨の問題などの DHL のエラーは常に記録されます。Test mode が認証情報と一致しているか確認してください。
DHL が ZAR、NGN、KES で料金を返すが、ストアは別の通貨を使用している: DHL quote currency をその通貨に設定し、Exchange rate を入力してください。これがないと、リアルタイム料金は使用されず、代替料金が適用されます。
古い DHL XML Services の認証情報がある: DHL API で XML Services (legacy) を選択してください。MyDHL の認証情報を受け取ったら、MyDHL API に切り替えてください。
配送料に税金が二重にかかる: Tax status を Taxable に設定すると、DHL の VAT を除いた DHL 料金が取得されます。または None に設定すると、見積もられた DHL の金額をそのまま請求します。
変更後も料金が古いように見える: 設定ページを保存してください。これにより、キャッシュされた DHL の見積もりが消去されます。
ライセンス欄にエラーが表示される: ライセンス欄のメッセージに従ってください。例えば、キーが別のドメインですでに使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効化してください。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべての設定は保持されます。キャッシュされた DHL の見積もりのみが消去されます。プラグインを削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンスステータスは常に削除され、キャッシュされた見積もりも同様です。設定と配送ゾーンの方法は、Remove data on uninstall がオンになっていた場合にのみ削除されます。そうでなければ、後で再インストールするために残ります。注文は変更されず、既存の注文は配送明細をそのまま保持します。
DHL は、それぞれの所有者の商標です。このプラグインは DHL との提携や承認を受けていません。