VibeFox Estafeta for PrestaShop — ヘルプ
要件
PrestaShop：8.0 から 9.x。
PHP：cURL 拡張機能を備えた 8.0 以降。古い PHP バージョンや cURL がない環境ではモジュールをインストールできません。
DrEnvio アカウント（リアルタイム料金のみ）：Estafeta のリアルタイム料金は、メキシコにおける Estafeta のパートナーである DrEnvio から取得されます。drenvio.com でアカウントを作成し、Estafeta を有効にして、そこで集荷先住所を設定し、DrEnvio の管理画面から API キーをコピーしてください。これは公式の DrEnvio プラグインが使用するものと同じキーです。独自の料金のみを使用する場合は、DrEnvio アカウントは不要です。
商品：リアルタイム料金を使用するには、商品に重量が必要です。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. 管理画面で Modules > Module Manager に進み、Upload a module をクリックします。モジュールの ZIP ファイルを選択してください。
2. アップロードが完了したら Configure をクリックするか、後でモジュール一覧から VibeFox Estafeta を見つけて Configure をクリックします。
3. Configure ページ上部のライセンスブロックにある License key 欄に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。
4. DrEnvio API key と、必要に応じて Origin postcode を入力します。ショップのデフォルト通貨が MXN でない場合は、MXN exchange rate を入力してください。DrEnvio から料金が返されない場合でも配送業者を表示させたい場合は、MX の国別料金または Fallback cost を設定します。Save をクリックします。
インストール時、モジュールは配送時間のテキストが Estafeta courier (Mexico) である Estafeta 配送業者を作成します。この配送業者は、すべてのゾーンとすべての顧客グループに割り当てられます。ゾーン、顧客グループ、配送時間、ロゴ、サイズ制限は Shipping > Carriers で変更できます。ここで料金は設定しないでください。料金は常にモジュールから取得されます。
設定
すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox Estafeta > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。保存するたびに、キャッシュされた DrEnvio の料金もクリアされます。
ページ上部には、モジュールから以下の警告が表示されます：DrEnvio API キーがない、デフォルト通貨が MXN ではなく為替レートもない、MX の国別料金もフォールバック料金もない（この場合、リアルタイム料金がないと配送業者は非表示になり、API キーがないと一度も表示されません）、またはモジュールが認識しないショップの重量単位がある（この場合、商品の重量は kg として扱われます。単位は International > Localization の Local units で設定してください）。数値フィールドは小数点またはカンマを小数区切りとして受け付けます。有効な数値ではない値は、保存時にクリアされて通知されます。その他の設定は保存されます。
一般
配送業者のゾーン、顧客グループ、サイズ制限は Shipping > Carriers で設定します。これらの設定はすべてのゾーンに適用されます。
Enable/Disable：Estafeta の配送を有効または無効にします。これは Shipping > Carriers にある配送業者のステータスと同じスイッチです。
Name：チェックアウト時に購入者に表示される配送業者名。デフォルト：Estafeta。必須です。無効な名前は通知され、以前の名前が維持されます。
Tax：配送業者の税ルール、または No tax。ショップはこの税金を送料に上乗せします。DrEnvio の料金に IVA が含まれるかどうかは、DrEnvio アカウントによって異なります。すでに IVA が含まれている場合は No tax を選択してください。
リアルタイム料金（DrEnvio API）
その住所に対して最も安い Estafeta サービスが提示されます。キーがない場合は、次のセクションの料金が使用されます。
DrEnvio API key：DrEnvio の管理画面にある API キーです。保存後、フィールドは空のままになり、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。
Remove the saved API key：保存済みのキーがあるときにのみ表示されます。Yes に設定して保存すると、キーが削除されます。その後は Country prices と Fallback cost のみが使用されます。上のフィールドに入力したキーは、保存済みのキーを置き換えます。
Origin country：集荷先住所の 2 文字の国コードです。デフォルト：MX。Origin postcode と一緒にのみ送信されます。
Origin postcode：集荷先住所の 5 桁の郵便番号です。空欄にすると、DrEnvio アカウントに保存された発送元住所が使用されます。5 桁ではない郵便番号は、保存時にクリアされて通知されます。
MXN exchange rate：DrEnvio はメキシコペソで見積もりを提示します。ショップのデフォルト通貨が MXN でない場合にのみ必要です。デフォルト通貨での 1 MXN の価値を入力します（例：0.05）。これがないと、リアルタイム料金は使用されません。
リアルタイム料金がない場合の料金
API キーがない場合、または DrEnvio から Estafeta の料金が返されない場合（API の停止、不明な郵便番号、郵便番号が未入力など）に使用されます。料金はショップのデフォルト通貨で、税抜きで表示されます。
Country prices：1 行に 1 つの配送先の国を、CC:PRICE の形式で入力します（例：MX:150）。小数点またはカンマを使用してください。桁区切りは使用しないでください。別の形式の部分は無視され、保存時に通知されます。
Fallback cost：リアルタイム料金も国別料金もない場合の料金です。配送業者を非表示にする場合は空欄のままにします。0 は送料無料を意味します。
Calculation type：Per order は料金を 1 回だけ請求します。Per item (price x number of items) は、料金にカート内の商品数を掛けます。これは Country prices と Fallback cost に適用されます。DrEnvio のリアルタイム料金は常に荷物全体の料金です。
条件
Free shipping from：カートの小計（配送が必要な商品、割引後、税抜き）がこの金額に達すると、送料は無料になります。その場合、DrEnvio へのリクエストは行われません。送料無料を一切提供しない場合は空欄にします。
Minimum subtotal：カートの小計（割引後、税抜き）がこの金額以上の場合にのみ配送業者を表示します。常に表示する場合は空欄にします。
Min weight：配送業者が表示されるためのカートの最低重量（kg）です。0 は制限なしを意味します。
Max weight：カートの最大重量（kg）です。これを超えると配送業者は非表示になります。デフォルト：30。0 は制限なしを意味します。
Min weight が Max weight より大きい場合、保存時にエラーが表示され、両方の重量は変更されません。商品の重量は、ショップの重量単位から kg に変換されます。
配送ゾーンなしでの提供条件
Ignore shipping zones：配送業者にゾーンを設定せずに、以下の国に対して配送業者を提供します。オンの間、配送業者はすべてのゾーンを受け取ります。後から作成したゾーンも含まれます。オフにすると、配送業者は自身のゾーンに戻ります。
Countries：このモードの配送先の国です。ショップで有効な国の中から選択します。すべての国を対象にする場合は空欄にします。Ignore shipping zones がオンの場合にのみ使用されます。
詳細設定
Debug log：API リクエストと料金の計算結果を、モジュールフォルダ内の logs/vfd_est_debug.log.php に書き込みます。このファイルは Web からは開けません。API のエラーは常に記録されます。API キーと顧客の住所は決して記録されません。作業が終わったらログをオフにしてください。
Log：デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログが空になります。
Remove data on uninstall：オンの場合、モジュールをアンインストールすると、すべてのモジュール設定、配送業者、注文に保存された Estafeta サービス、ログが削除されます。オフの場合は、再インストールに備えてすべて保持されます。
チェックアウト時の動作
配送のステップで、PrestaShop はモジュールに Estafeta の料金を問い合わせます。対象は実物の商品のみです。仮想商品は重量に加算されず、小計にも含まれません。モジュールはまず条件を確認します：Countries のリスト（Ignore shipping zones がオンの場合）、カートの重量、最低小計です。送料無料が適用される場合、料金は 0 になり、DrEnvio へのリクエストは行われません。
それ以外の場合、モジュールは DrEnvio に、配送先の国と郵便番号、カートの重量、商品数、MXN での小計を送信します。発送元の郵便番号を設定している場合は、それも送信されます。メキシコの郵便番号は 5 桁である必要があります。購入者がこの形式の郵便番号を含む配送先住所を入力するまで、リクエストは行われません。DrEnvio はアカウント内のすべての配送業者の見積もりを返します。モジュールは Estafeta の見積もりのみを使用し、0 の料金は無視し、最も安いものを選んで、ショップのデフォルト通貨に換算します。その後、料金は購入者のカートの通貨で表示されます。
各応答は 1 時間キャッシュされます。失敗したリクエストや、Estafeta の料金がない経路は 5 分間記憶されるため、API が遅い場合や不具合がある場合でも、チェックアウトの更新のたびに処理が止まることはありません。API のタイムアウトは 12 秒です。これらの場合、購入者にエラーは表示されません。国別料金またはフォールバック料金が使用されるか、どちらも設定されていなければ配送業者が非表示になります。理由はログに記録されます。
配送業者に注文が入った後で Shipping > Carriers から編集すると、PrestaShop はそれを配送業者の新しいバージョンとして保存します。モジュールは新しいバージョンに自動的に従います。
モジュールは料金の計算のみを行います。発送の作成、ラベル（guías）の印刷、荷物の追跡は行いません。発送は DrEnvio または Estafeta のアカウントで作成してください。購入者は特定の Estafeta サービスや Estafeta の営業所を選ぶことはできず、為替レートは自動更新されません。
注文
Estafeta 配送業者で注文が行われると、モジュールはそのカートについて計算された料金を保持します。その後の再計算（管理画面の注文ページなど）では、この料金は変更されません。
Orders > Orders の注文ページには、Estafeta ブロックが表示されます：
Estafeta service：DrEnvio の見積もりの Estafeta サービスとその配送日数です。リアルタイム料金の場合にのみ表示されます。
Price source：Live DrEnvio rate、Country price (no live rate)、Fallback cost (no live rate)、または Free shipping threshold です。
Calculated price (excl. tax)：デフォルト通貨での配送料金です。
ライセンスキー
モジュールは、vibefox.net から取得した VibeFox ライセンスキーで動作します。License — VibeFox Estafeta ライセンスブロックは Modules > Module Manager > VibeFox Estafeta > Configure ページの一番上、設定より上にあります。キーを License key 欄に入力し、Activate をクリックしてください。その後、ブロックにはマスクされたキー、ステータス（ライセンスの有効期限日やドメインなど）、そして Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このショップからキーを削除）のボタンが表示されます。その下には Product: presta-shipping-estafeta の行と、Manage licenses and domains in your account のリンク（vibefox.net のアカウントを開きます）があります。キーを変更できるのは、このモジュールの Configure 権限を持つ従業員のみです。ブロックの文言は管理画面の言語に従います（英語とロシア語が含まれます）。
キーが受け付けられない場合、ブロックには理由が表示されます（例：Key not found、This key belongs to another product、Domain limit reached、License expired on と日付）。ショップのアドレスを変更した後、またはアカウントでドメイン枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認されたステータスで動作を続けます。
1 つのキーは 1 つのドメインで使用できます。これはメインショップのドメインで、マルチストア構成でも同じです。ショップからキーを削除しても、そのドメイン枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウト時に Estafeta 配送業者は購入者に表示されず、料金も計算されません。PrestaShop のストアフロントは、バックオフィスにログインしていることを認識しないため、配送業者はあなたにも表示されません。キーを購入する前にモジュールを設定することはできますが、チェックアウトでのテストはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文は影響を受けません。
ライセンスが期限切れになってもモジュールは動作を続けますが、アップデートとサポートには更新が必要です。キーを入力してから最初の 14 日間は 1 日に 1 回、その後は週に 1 回、管理画面で作業中に自動的にステータスが再確認されます。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
チェックアウトに Estafeta が表示されない：ライセンスが有効であり、Enable/Disable がオンになっているか確認してください。Shipping > Carriers で、配送業者が購入者の国のゾーンと顧客グループをカバーしているか確認してください（または Ignore shipping zones がオンで、その国が許可されているか確認してください）。モジュールページ上部の警告、重量制限、Minimum subtotal も確認してください。API キーがない場合、または DrEnvio から Estafeta の料金が返されない場合は、配送先の国別料金またはフォールバック料金が必要です。商品ページで、特定の配送業者に制限されている場合もあります。
リアルタイム料金が表示されない：Debug log をオンにして、チェックアウトを再読み込みし、モジュールページの Log フィールドを確認してください。理由が表示されます：API キーがない、デフォルト通貨が MXN でないショップに為替レートがない、郵便番号がないまたは無効、API キーが拒否された（DrEnvio の HTTP 401 または 403。API キーを確認してください）、その経路に Estafeta の料金がない（ログには DrEnvio が返した配送業者が表示されます）、または MXN 以外の通貨の料金である。
料金に IVA は含まれていますか？これは DrEnvio アカウントによって異なります。DrEnvio の料金にすでに IVA が含まれている場合は、Tax を No tax に設定してください。
変更後に料金が古いようです：モジュールページで Save をクリックしてください。これにより、キャッシュされた DrEnvio の料金がクリアされます。
Estafeta 配送業者が見つからないと表示される：配送業者は Shipping > Carriers で削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。The settings were saved, but the carrier could not be updated. というメッセージについても同じです。
注文ページに Estafeta ブロックがない：このブロックは、モジュールがインストールされていた期間に Estafeta 配送業者で行われた注文にのみ表示されます。Remove data on uninstall をオンにしてアンインストールすると、保存されたサービスが削除されます。
アンインストール
Modules > Module Manager に進み、VibeFox Estafeta の横のメニューを開いて Uninstall を選びます。ライセンスキーとライセンスステータスは常に削除されます。キャッシュされた料金は常に削除されます。Remove data on uninstall がオンの場合、配送業者は削除されます（注文の履歴は残ります）。また、設定、注文に保存された Estafeta サービス、ログも削除されます。オフの場合、配送業者は無効になるだけで、設定と注文に保存されたサービスは保持されます。モジュールを再インストールすると、配送業者はアンインストール前のステータスに戻ります。
Estafeta と DrEnvio は、それぞれの所有者の商標です。このモジュールは Estafeta や DrEnvio と提携しておらず、それらによる承認も受けていません。