VibeFox Delhivery for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 5.0 以降。インストールされ、有効になっている必要があります。WooCommerce がない場合、本プラグインは有効化できません。
PHP: 8.0 以降。
Delhivery API トークン（リアルタイム料金の場合のみ）: Delhivery One にログインし、Settings > API setup を開きます。Delhivery のヘルプ記事「API token generation」に手順が説明されています。テストトークンはステージング環境で使用できます。また、集荷場所の 6 桁の PIN コードも必要です。固定料金のみを使用する場合、トークンは不要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin を開き、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_delhivery フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox Delhivery。または、プラグイン一覧ページでプラグイン名の下の Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. API トークンと出荷元の PIN コードを入力し、Express または Surface、および Pre-paid または COD を選択します。ストアの通貨が INR でない場合は、為替レートを入力します。必要に応じて固定料金を入力します（「設定」を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で、VibeFox Delhivery を配送ゾーン（例: インド）に追加します。または Ignore zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox Delhivery。設定はすべての配送ゾーンに適用されます。ゾーンにこの方法を追加すると、ゾーンのウィンドウには次の 1 つのフィールドだけが表示されます：
Title (zone): このゾーンでお客様に表示される名称。空欄にすると、全体の Method title が使用されます。
設定を保存するたびに、キャッシュされた Delhivery の料金は消去されます。料金と金額は「9.99」と「9,99」のどちらの形式でも入力できます。
一般
Enable/Disable: すべてのゾーンでこの方法を一括で有効または無効にします。
Method title: チェックアウト時に表示される配送方法の名称。初期値: Delhivery。ゾーンごとに独自の Title で上書きできます。
Tax status: Taxable は配送料に WooCommerce の税金を加算します。None は加算しません。
Delhivery API アカウント（リアルタイム料金の場合のみ必要）
Environment: Production (track.delhivery.com)（初期値）または Staging / test account (staging-express.delhivery.com)。Staging は Delhivery のテストトークンを使用する場合にのみ選択してください。
API token: Delhivery の API トークン。認可ヘッダーでのみ送信され、ログには書き込まれません。
Origin pincode: 集荷場所または倉庫の 6 桁の PIN コード。例: 110001。
リアルタイム料金
リアルタイム料金は、有効な 6 桁の PIN コードを持つインドの宛先に対して、通常の（配達される）出荷の場合に取得されます。
Shipping mode: 料金の計算に使用される Delhivery の課金モード。Express（初期値）または Surface。
Payment type: Delhivery に送信される支払いタイプ。Pre-paid（初期値）または COD（代金引換。Delhivery が COD 手数料を加算します）。プラグインは、お客様が選択した支払い方法に応じてこの設定を切り替えることはありません。
Rate amount: Delhivery は GST を含む金額と含まない金額の両方を返します。
INR to (store currency) conversion rate: Delhivery の料金はインドルピーで表示されます。ストアの通貨が INR でない場合は、1 ルピーがストアの通貨で何単位に相当するかを入力してください（例: 0.011）。空欄のままにすると、リアルタイム料金は使用されず、固定料金が適用されます。また、設定の上部に警告が表示されます。ストアの通貨が INR の場合は入力不要です。
固定料金（リアルタイム料金がない場合に使用）
固定料金は、トークンや PIN コードがまだ設定されていない場合、宛先がインド国外の場合、PIN コードが配送対象外の場合、または API がエラーを返した場合に使用されます。料金はストアの通貨で指定します。
Prices per country: 1 行に 1 つ、COUNTRY_CODE:price の形式で入力します（例: IN:120）。予備料金より先に確認されます。
Fallback price: リアルタイム料金も国別料金も適用されない場合に使用されます。空欄にすると、この方法は非表示になります。0 は無料を意味します。
Fixed price is charged: Per order は料金を 1 回だけ請求します。Per item (price × quantity) はカート内の商品数を掛けた金額を請求します。Delhivery のリアルタイム料金は常に荷物全体の重量に基づきます。
条件
Free shipping from: カートの小計がこの金額以上の場合、配送は無料になります。Delhivery へのリクエストは送信されません。空欄にすると無効になります。
Show from subtotal: カートの小計がこの金額以上の場合のみ、この方法を表示します。空欄にすると常に表示されます。
Min weight (kg): この方法を表示するために必要な、カートの最小重量。0 は制限なしを意味します。
Max weight (kg): カートがこの重量を超える場合、この方法を非表示にします。初期値: 30。0 は制限なしを意味します。
商品の重量は、ストアの重量単位から kg に換算されます。料金は実際のカート重量（商品重量の合計）に基づき、容積重量や箱は考慮しません。
Excluded shipping classes: カート内のいずれかの商品が、これらの WooCommerce 配送クラスに属する場合、この方法を非表示にします。
配送ゾーンを使用しない場合の利用可能性
Ignore zones: 配送ゾーンに追加せずに、以下の国を対象に Delhivery を提供します。
Countries: このモードの配送先の国。空欄にすると、発送先として設定しているすべての国が対象になります。Ignore zones が有効な場合にのみ使用されます。
詳細設定
Debug log: 料金の計算を WooCommerce > Status > Logs に記録します（ソース: vfd_delhivery）。この設定がオフでも、API エラーは常に記録されます。トークンとお客様の完全な PIN コードは記録されません。
Remove data on uninstall: オンにすると、プラグインを削除したときに、すべての設定、ゾーンの配送方法、キャッシュされた料金が削除されます。プラグインを無効にしても、何も削除されません。
チェックアウト時の動作
お客様が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまずカートの重量、小計、除外する配送クラスを確認します。送料無料の条件を満たす場合、お客様は無料配送を受けられ、Delhivery へのリクエストは送信されません。
有効な 6 桁の PIN コードを持つインドの住所の場合、プラグインは Delhivery に出荷元と宛先の PIN コード、グラム単位のカート重量、配送モード、支払いタイプを送信し、返された金額をストアの通貨に換算して表示します。各応答は 1 時間キャッシュされます。失敗したリクエストは 10 分間キャッシュされるため、チェックアウトの更新のたびに Delhivery の応答を待つ必要はありません。API のタイムアウトは 10 秒です。
リアルタイム料金がない場合は、国別料金または予備料金が使用されます。どちらも設定されていない場合、この方法は非表示になります。お客様に API エラーが表示されることはありません。
この方法は、クラシックチェックアウトとカートおよびチェックアウトブロックの両方で動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。
プラグインは料金を計算し、追跡リンクを表示します。出荷データや送り状（waybill）の作成、ラベルの印刷、集荷やマニフェストの依頼、PIN コードの配送可否の確認、配達日の推定、追跡ステータスの同期、Delhivery の国際料金の見積もりは行いません。インド国外では固定料金のみが使用されます。
注文と追跡
注文画面の配送先住所の下にある Delhivery ブロックには、配送モード（Express または Surface）と料金の取得元（Delhivery のリアルタイム料金、固定料金、または送料無料の基準）が表示されます。
Delhivery One で出荷を作成し、その AWB を Delhivery AWB / tracking number 欄に貼り付けて注文を保存します。管理画面に Track on delhivery.com のリンクが表示されます。お客様には、マイアカウントの注文ページと注文メール（HTML とプレーンテキスト）に、Delhivery tracking と追跡リンクが表示されます。AWB は注文ステータスより先に保存されるため、同じ保存操作で注文を完了した場合、「完了した注文」のメールにはすでに AWB が含まれています。
ライセンスキー
本プラグインは、vibefox.net で取得した VibeFox ライセンスキーを使用します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Delhivery の上部にあります。キーを License key に貼り付けて Activate をクリックします。ブロックにはステータス（例: ライセンスの有効期限日とドメイン）が表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除できます。Manage licenses and domains in your account のリンクから vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、Delhivery はチェックアウトでお客様には表示されません。ログイン中のストアマネージャーには、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインの設定とテストができます。プラグインページと WooCommerce のページにはリマインダーが表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れてもプラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Delhivery が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、お客様の国のゾーンにこの方法が追加されていること（または Ignore zones がオンで、その国が許可されていること）を確認してください。重量制限、Show from subtotal、Excluded shipping classes も確認してください。リアルタイム料金がない場合は、国別料金または Fallback price が必要です。
リアルタイム料金が表示されない: API トークン、有効な Origin pincode、および INR 以外のストアの場合は為替レートを確認してください。お客様は有効な 6 桁のインドの PIN コードを入力する必要があります。Debug log をオンにして、WooCommerce > Status > Logs（ソース: vfd_delhivery）を開くと、配送対象外の PIN コードなど、API エラーを確認できます。
GST が二重に課税される: Delhivery の合計金額には、すでに GST が含まれています。Rate amount を Gross amount (excluding GST) に設定するか、Tax status を None に設定してください。
テスト: Environment を Staging に設定し、Delhivery のテストトークンを使用してください。
変更後に料金が古く見える: 設定ページを保存してください。キャッシュされた Delhivery の料金が消去されます。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、キーがすでに別のドメインで使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効化してください。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作を続けます。
アンインストール
プラグインを無効にしても、すべてのデータは保持されます。削除するには、プラグインを無効にしてから Plugins ページで削除してください。本プラグインのライセンスキーとライセンスステータスは、常に削除されます。設定、ゾーンの配送方法、キャッシュされた料金は、Remove data on uninstall がオンになっていた場合にのみ削除されます。それ以外の場合は、再インストールに備えて保持されます。AWB 番号は注文に残り、既存の注文は配送の明細を保持します。
Delhivery は、それぞれの所有者の商標です。本プラグインは Delhivery と提携しておらず、Delhivery による推奨も受けていません。