VibeFox Delhivery for OpenCart — ヘルプ

要件

OpenCart: 3.0.x（3.0.5.0 で動作確認済み）または 4.0.2 以降（4.1.0.3 で動作確認済み）。

PHP: 8.0 以降。

Delhivery API トークン（リアルタイム料金の場合のみ）: Delhivery One にログインし、Settings > API setup を開きます。Delhivery のヘルプ記事「API token generation」に手順が説明されています。両方のリンクは拡張機能のページにあります。テスト用トークンはステージング環境で使用できます。また、集荷場所の 6 桁の pincode も必要です。固定料金のみを使用する場合は、トークンは不要です。

VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。

インストール

このダウンロードは、両方の OpenCart バージョン用のパッケージを含む 1 つの zip ファイルです。コンピューターで解凍してください。README.txt、OpenCart 3 用パッケージ vfd_delhivery-oc3-(version).ocmod.zip、OpenCart 4 用パッケージ vfd_delhivery.ocmod.zip が含まれています。お使いの OpenCart バージョンに対応するパッケージのみをインストールしてください。ライセンスキーは両方のバージョンで同じです。

OpenCart 3

1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_delhivery-oc3-(version).ocmod.zip を選択します。本拡張機能は OCMOD の変更を追加しないため、Extensions > Modifications を更新する必要はありません。インストーラーを使う代わりに、このパッケージの upload フォルダの内容をストアのルートフォルダにコピーすることもできます。

2. Extensions > Extensions に移動し、拡張機能の種類として Shipping を選択します。VibeFox Delhivery を見つけて、Install（緑色の + ボタン）をクリックします。

3. Edit（鉛筆ボタン）をクリックして、設定ページを開きます。

4. VibeFox ライセンスキーを、Edit ページ上部のライセンス欄にある License key に貼り付けて、Activate をクリックします（ライセンスキーの項目を参照）。

5. API トークンと発送元 pincode を入力し、Express または Surface、および Pre-paid または COD を選択します。ストアのデフォルト通貨が INR でない場合は、換算レートを入力します。必要に応じて固定料金を入力します（設定を参照）。Enable Delhivery をオンにして、Save をクリックします。

OpenCart 4

1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_delhivery.ocmod.zip を選択します。ファイル名は変更しないでください。OpenCart 4 は、ファイル名から拡張機能のコードを取得するため、名前を変更したパッケージは動作しません。

2. パッケージは、同じページのインストール済み拡張機能の一覧に表示されます。その横にある Install（緑色の + ボタン）をクリックします。

3. Extensions > Extensions に移動し、拡張機能の種類として Shipping を選択します。VibeFox Delhivery を見つけて、Install（緑色の + ボタン）をクリックし、次に Edit（鉛筆ボタン）をクリックします。

4. OpenCart 3 の手順 4 と 5 と同じように、ライセンスキーと設定を入力します。設定ページとそのフィールドは、両方のバージョンで同じです。

インストール後は、Enable Delhivery をオンにして保存するまで、この配送方法はオフのままです。アンインストール後に拡張機能を再インストールすると、保持していた Delhivery の設定が再び使用されます。

設定

すべての設定は拡張機能のページにあります: Extensions > Extensions > Shipping > VibeFox Delhivery > Edit。セクションは左側に表示されます。Save ボタン 1 つで、ページを再読み込みせずにページ全体を保存します。保存するたびに、キャッシュされた Delhivery の料金もクリアされます。金額は "9.99" と "9,99" の両方を受け付けます。値が誤っている場合は何も保存されず、ページに理由が表示されます。例: Enter a valid method title (without < > ; = # { }).、フィールドは負でない数値である必要があるというメッセージ、または Sort order must be a whole number. この拡張機能の変更権限を持つ管理者ユーザーのみが設定を保存できます。

ストアのデフォルト通貨が INR ではなく、API トークンは保存されているものの換算レートが設定されていない場合、ページ上部の警告は、レートを入力するまでリアルタイム料金は使用されないことを知らせます。ストアにキログラム単位の重量クラスがなく、重量の単位が標準単位（kg、g、lb、oz）ではない場合、警告は商品の重量がキログラムとして扱われることを示します。System > Localisation > Weight Classes で標準単位を設定してください。

一般

設定はすべてのジオゾーンに適用されます。Availability で配送方法を制限できます。

Enable Delhivery: チェックアウト時に Delhivery を提供します。デフォルト: オフ。

Method title: カートとチェックアウト時に顧客に表示される配送方法の名前。デフォルト: Delhivery。必須。最大 64 文字で、文字 < > ; = # { } は使用できません。

Tax class: 配送料の税クラス、または No tax（デフォルト）。税クラスを選択すると、OpenCart は配送料に税金を加算します。

Sort order: チェックアウト時の配送方法の中での Delhivery の表示順。整数。

Delhivery API アカウント（リアルタイム料金の場合のみ必要）

Environment: Production (track.delhivery.com)（デフォルト）または Staging / test account (staging-express.delhivery.com)。Staging は Delhivery のテスト用トークンを使用する場合にのみ選択してください。

API token: Delhivery の API トークン。認可ヘッダーでのみ送信され、ログに書き込まれることはありません。保存後、このフィールドは空欄になり、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。

Remove saved token: オンにして保存すると、保存されたトークンを削除します。その後は固定料金のみが使用されます。

Origin pincode: 集荷場所または倉庫の 6 桁の pincode（例: 110001）。6 桁でない場合、設定は The origin pincode must have 6 digits — live rates are not requested until it is fixed. の警告付きで保存されます。

リアルタイム料金

リアルタイム料金は、有効な 6 桁の pincode を持つインドの配送先に対して、往路（配達）の出荷について取得されます。

Shipping mode: 料金の計算に使用される Delhivery の課金モード: Express（デフォルト）または Surface。

Payment type: Delhivery に送信される支払いタイプ: Pre-paid（デフォルト）または COD (cash on delivery — Delhivery adds its COD charge)。顧客が選択した支払い方法に応じて、拡張機能がこれを切り替えることはありません。

Rate amount: Delhivery は、GST 込みと GST 抜きの両方の料金を返します。

INR to (store currency) conversion rate: ラベルにはストアのデフォルト通貨が表示されます。Delhivery の料金はインドルピー建てです。デフォルト通貨が INR でない場合は、1 ルピーが自国通貨で何単位に相当するかを入力してください（例: 0.011）。レートは 0 より大きい必要があります。空欄のままにすると、リアルタイム料金は使用されず、固定料金が適用されます。デフォルト通貨が INR の場合は不要です。

固定料金（リアルタイム料金がない場合に使用されます）

固定料金は、トークンや pincode がまだ設定されていない場合、配送先がインド国外の場合、pincode が配送対象外の場合、または API がエラーを返した場合に使用されます。ストアのデフォルト通貨で、税抜きで入力します。

Prices per country: 1 行に 1 件、国コード:料金 の形式で入力します（例: 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 は制限なしを意味し、空欄の場合は 30 kg として扱われます。Min weight を Max weight より大きくすることはできません。ページにエラーが表示され、何も保存されません。

商品の重量は、OpenCart の重量クラスに基づいて kg に変換されます。料金は、実際のカート重量（商品の重量の合計）を使用します。容積重量や箱は考慮されません。

対象地域

Geo zone: このジオゾーン内の住所に対してのみ Delhivery を提供します。All zones（デフォルト）は制限なしを意味します。ジオゾーンは System > Localisation > Geo Zones で管理されます。Ignore zones がオンの場合は確認されません。

Ignore zones: オンの場合、ジオゾーンは確認されず、下記の国に対して配送方法が提供されます（リストが空の場合はすべての国）。

Countries: そのモードでの配送先の国。Ignore zones がオンの場合にのみ使用されます。

詳細設定

Debug log: 料金の計算結果を storage/logs/vfd_dlv_debug.log.php（OpenCart 4 では system/storage/logs/vfd_dlv_debug.log.php）に書き込みます。このファイルは Web から読み取ることはできません。このオプションがオフの場合でも、API のエラーは常に記録されます。トークンと顧客の完全な pincode は、決して記録されません。ファイルが 5 MB に達すると、vfd_dlv_debug.old.log.php に移動され、新しいログが開始されます。

Log: ログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログが空になります。

Remove data on uninstall: オンの場合、拡張機能をアンインストールすると、Delhivery の設定、キャッシュされた料金、ログが削除されます。オフ（デフォルト）の場合、再インストール用に保持されます。注文データ（モード、料金のソース、AWB 番号）は決して削除されません。

インポート / エクスポート

Export: Download JSON をクリックすると、設定が JSON ファイルとして保存されます。API トークンはエクスポートされません。

Import: 以前にエクスポートした JSON を貼り付けて Import をクリックすると、設定を復元します（例: 別のストアに移行する場合）。値は通常の保存と同様にチェックされます。保存済みの API トークンは変更されません。

チェックアウト時の動作

OpenCart が配送方法を表示するとき、拡張機能に Delhivery の料金を問い合わせます。Geo zone が設定されていて（かつ Ignore zones がオフの場合）、住所がその範囲外であれば、Delhivery は提供されません。Requires Shipping が Yes に設定された商品のみが対象となります。それ以外の商品は重量に加算されず、小計にも含まれません。その後、拡張機能は（Ignore zones がオンの場合）国、カートの重量、Show from subtotal を確認します。小計は、クーポン割引後、税抜きの、配送が必要な商品の価格です。ギフト券、ポイント、ストアクレジットは考慮されません。送料無料が適用される場合は、料金は 0 となり、Delhivery へのリクエストは送信されません。

有効な 6 桁の pincode（住所の郵便番号）を持つインドの住所の場合、拡張機能は Delhivery に発送元と配送先の pincode、グラム単位のカート重量、配送モード、支払いタイプを送信します。返された金額は INR からストアのデフォルト通貨に換算され、その小数桁数に丸められ、選択した Tax class の税金を含めて顧客の通貨で表示されます。各応答は 1 時間キャッシュされます。失敗したリクエストは 10 分間キャッシュされるため、チェックアウトは更新のたびに Delhivery の応答を待つことがありません。API のタイムアウトは 10 秒です。

リアルタイム料金がない場合は、国別料金または代替料金が使用されます。どちらも設定されていない場合は、配送方法は非表示になります。顧客に API のエラーが表示されることはありません。その理由はログに記録されます。

拡張機能は料金を計算し、顧客に追跡リンクを提供します。発送や送り状の作成、ラベルの印刷、集荷やマニフェストの依頼、pincode の配送可否の確認、配送日の推定、追跡ステータスの同期、Delhivery の国際料金の見積もりは行いません。インド国外では、固定料金のみが使用されます。

OpenCart 4 では、顧客はチェックアウトページの配送方法欄にある Choose をクリックし、Shipping method options ウィンドウで Delhivery を選択します。この配送方法の動作は OpenCart 3 と同じです。

注文と追跡

Delhivery で注文が行われると、拡張機能は配送モードと料金のソースを注文とともに保存します。Sales > Orders で注文を開くと、注文履歴の上にある Delhivery パネルに、Mode:（Express または Surface）、Price:（Delhivery のリアルタイム料金、固定料金、または送料無料の基準額）、Delhivery AWB / tracking number が表示されます。未入力の場合は Not entered yet. と表示されます。

OpenCart 4 では、チェックアウトで注文が 1 件保持され、顧客が再度確定するたびに更新されます。配送モードと料金のソースも、これに合わせて更新されます。AWB を入力する前に顧客が別の配送方法に切り替えた場合、その注文では Delhivery パネルは表示されなくなります。

Delhivery One で発送を作成し、その AWB をパネルに入力して Save をクリックします。ページは再読み込みされません。文字、数字、ハイフンは保持されます（最大 64 文字）。AWB を削除するには、フィールドを空欄にして保存します。AWB がある場合、パネルに Track on delhivery.com のリンクが表示されます。AWB を保存するには、注文を変更する権限が必要です。権限がない場合、パネルは読み取り専用になります。

登録済みの顧客は、自分のアカウントの注文ページで Delhivery tracking: を確認でき、AWB は Delhivery の追跡ページへのリンクになっています。注文履歴にエントリを追加して顧客に通知すると、注文ステータスのメールにも同じ行とリンクが含まれます。AWB は後から入力されるため、新規注文のメールには追跡リンクは含まれません。パネルと追跡リンクは、拡張機能がオフになっている場合でも、過去の注文に対して機能します。

ライセンスキー

この拡張機能は、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンス欄 License — VibeFox Delhivery は、Extensions > Extensions > Shipping > VibeFox Delhivery > Edit ページの一番上、設定より上にあります。License key にキーを貼り付け、Activate をクリックします。その後、ライセンス欄にはキーが一部隠された形で表示され、ステータス（例: ライセンスの有効期限の日付とドメイン）と、ボタン Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このストアからキーを削除）が表示されます。その下には、Product: opencart-shipping-delhivery の行と、リンク Manage licenses and domains in your account（vibefox.net のアカウントが開きます）があります。キーを変更できるのは、この拡張機能の Modify 権限を持つ管理者ユーザーのみです。ライセンス欄のテキストは、管理画面の言語に従います（英語とロシア語に対応しています）。

キーが受け付けられない場合、ライセンス欄に理由が表示されます（例: Key not found、This key belongs to another product、Domain limit reached、License expired on と日付）。ストアのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、拡張機能は最後に確認したステータスで動作を続けます。

1 つのキーは 1 つのドメインでのみ使用できます。ドメインは、OpenCart の設定にあるストアのアドレスです。ストアからキーを削除しても、ドメインの枠は解放されません。枠を解放するには、vibefox.net のアカウントで操作してください。

有効なキーがない場合、Delhivery はチェックアウトで顧客に表示されず、料金も計算されません。管理画面に 同じブラウザー でログインしている管理者ユーザーには、ストアで配送方法が表示されます（(unlicensed — visible to admins only) と表示されます）。これにより、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 では、このプレビューは利用できません。ストアは管理画面のログインを認識しないため、有効なキーがない場合は、すべてのユーザーに対して配送方法が非表示になります。一度 Edit ページを開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると、7 日間非表示になります。既存の注文には影響しません。

ライセンスの有効期限が切れた場合も、拡張機能は動作を続けますが、アップデートやサポートを受けるには更新が必要です。管理画面の Dashboard または Edit ページを開くと、ステータスが自動的に再確認されます。キーを入力してから最初の 14 日間は 1 日に 1 回、その後は週に 1 回です。cron ジョブは必要ありません。拡張機能をアンインストールすると、ライセンスキーとライセンスのステータスは常に削除されます。

トラブルシューティング

Delhivery がチェックアウトに表示されない:ライセンスが有効であること、および Enable Delhivery がオンであることを確認してください。Geo zone、または Ignore zones と Countries、重量制限、Show from subtotal を確認してください。リアルタイム料金がない場合は、国別料金または Fallback price が必要です。商品の Requires Shipping が Yes に設定されていることも確認してください。

リアルタイム料金が表示されない:API トークン、有効な Origin pincode、そしてデフォルト通貨が INR でない場合は換算レートを確認してください。顧客は郵便番号として、有効な 6 桁のインドの pincode を入力する必要があります。Debug log をオンにし、チェックアウトを再読み込みして、拡張機能のページにある Log フィールドを確認してください。pincode が配送対象外である場合や、Delhivery からの HTTP エラーなど、理由が表示されます。

GST が二重に課税される:Delhivery の合計金額にはすでに GST が含まれています。Rate amount を Gross amount (excluding GST) に設定するか、Tax class を No tax に設定してください。

テスト:Environment を Staging に設定し、Delhivery のテスト用トークンを使用してください。

変更後に料金が古く見える:拡張機能のページで Save をクリックしてください。これにより、キャッシュされた Delhivery の料金がクリアされます。

AWB を保存できない:You do not have permission to modify orders. というメッセージは、管理者ユーザーグループに System > Users > User Groups で sale/order の変更権限が必要であることを意味します。

ページに "Warning: You do not have permission to modify VibeFox Delhivery!" と表示される:管理者ユーザーグループに設定の閲覧権限しかない可能性があります。System > Users > User Groups で、そのグループに extension/shipping/vfd_delhivery（OpenCart 3）または extension/vfd_delhivery/shipping/vfd_delhivery（OpenCart 4）の変更権限を付与してください。

開発者向け:この拡張機能は、OpenCart のイベント catalog/vfd_delhivery/api_url と catalog/vfd_delhivery/api_timeout を発生させます。これらにより、API のアドレスとタイムアウトを変更できます。

アンインストール

Extensions > Extensions に移動し、種類 Shipping を選択して、VibeFox Delhivery の横にある Uninstall（赤色の − ボタン）をクリックします。OpenCart は常に Enable Delhivery、Sort order、Tax class、Geo zone をリセットします。キャッシュされた料金と拡張機能のイベントは常に削除されます。Remove data on uninstall がオンの場合、Delhivery の設定とデバッグログも削除されます。オフの場合、その他の設定は保持され、拡張機能を再インストールしたときに再び使用されます。注文の Delhivery データ（モード、料金のソース、AWB 番号）は決して削除されません。既存の注文は、配送方法と料金をそのまま維持します。

OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer を開き、インストール済み拡張機能の一覧で VibeFox Delhivery の横にある Uninstall（オレンジ色の − ボタン）をクリックしてから、Delete（赤いゴミ箱ボタン）をクリックして、アップロードしたパッケージを削除してください。

Delhivery は、その所有者の商標です。本拡張機能は Delhivery と提携しておらず、Delhivery による承認もされていません。