VibeFox Mercado Envios for PrestaShop — ヘルプ
要件
PrestaShop：8.0 から 9.x。
PHP：8.0 以降。古いバージョンの PHP ではモジュールをインストールできません。
Mercado Pago アカウント（リアルタイム料金のみ）：リアルタイム料金は、アルゼンチン、ブラジル、またはメキシコにある Mercado Pago アカウントの Mercado Envios 料金計算機から取得されます。このアカウントで Mercado Envios が有効になっている必要があります。荷物は、そのアカウントに設定された発送元住所を基準に見積もられます。本番環境の Access Token（APP_USR- で始まる）が必要です。Mercado Pago の開発者パネルで、アプリケーションと本番環境の認証情報を開いてください。ログインボタンはありません。トークンをモジュールの設定に貼り付けます。国ごとの料金のみを使う場合は、Mercado Pago アカウントは不要です。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. 管理画面で Modules > Module Manager に進み、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら Configure をクリックします。後で探す場合は、モジュール一覧から VibeFox Mercado Envios を見つけて Configure をクリックします。
3. Configure ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（「ライセンスキー」を参照）。
4. リアルタイム料金を使う場合は、Access Token を貼り付け、Mercado Envios の国を選択します。ショップの既定通貨が ARS、BRL、MXN のいずれでもない場合は、為替レートも設定します。必要に応じて Country prices と Fallback cost を入力します（リアルタイム料金がない場合に使用されます）。Save をクリックします。
インストール時、モジュールは配送時間のテキストが Mercado Envios delivery の Mercado Envios 配送業者を作成します。この配送業者はすべてのゾーンとすべての顧客グループに割り当てられ、税ルールは設定されません。ゾーン、顧客グループ、配送時間、ロゴ、サイズ制限は Shipping > Carriers で変更できます。料金はそこで設定しないでください。料金は常にモジュールから取得されます。
設定
すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox Mercado Envios > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。保存するたびに、キャッシュされた Mercado Envios の料金と最後の API エラーも消去されます。
ページ上部の警告には、設定の問題が表示されます。為替レートの未設定、Access Token と料金がどちらもない状態、日付付きの最後の Mercado Envios API エラー、そしてモジュールが認識しないショップの重量・寸法単位（その場合は kg または cm として扱われます）などです。配送業者が削除されている場合、General セクションに The Mercado Envios carrier was not found — reset the module to create it again. と表示されます。
General
顧客のゾーンを Shipping > Carriers で Mercado Envios 配送業者に追加するか、下の Ignore shipping zones を使用してください。これらの設定はすべてのゾーンに適用されます。
Enable Mercado Envios shipping：配送業者をオンまたはオフにします。これは Shipping > Carriers の配送業者ステータスと同じスイッチです。
Name：チェックアウトで顧客に表示される配送業者名。既定値：Mercado Envios。必須、最大 64 文字。
Tax：配送業者の税ルール、または No tax（既定）。Mercado Envios は最終価格を提示します。No tax は提示された価格をそのまま表示します。税ルールを選ぶと、配送税が上乗せされます。
Mercado Envios API（リアルタイム料金）（トークンがない場合は、下記の料金のみが使用されます）
Access token：Mercado Pago の本番環境 Access Token（APP_USR-...）。api.mercadopago.com にのみ送信され、ログに記録されることはありません。保存後、このフィールドは空になり、Saved — leave empty to keep it. と表示されます。値を変更する場合にのみ新しい値を入力してください。リアルタイム料金の使用を停止するには、Remove the saved access token (only the prices below are used then) にチェックを入れて保存します。
Mercado Envios country：Mercado Pago アカウントの国：Argentina (ARS)（既定）、Brazil (BRL)、または Mexico (MXN)。リアルタイム料金は、この国の届け先に対してのみ要求され、その国の通貨で提示されます。
Exchange rate：ショップの既定通貨が Mercado Envios の通貨と異なる場合のみ必要です。ショップの既定通貨で表した 1 ARS、BRL、または MXN の価格（例：0.001）。設定しない場合、リアルタイム料金は使用されません。正の数である必要があります。小数点とカンマのどちらも小数点区切りとして使用できます。
リアルタイム料金がない場合の料金
これらの料金は、Access Token がない場合、Mercado Envios の対象国以外への届け先の場合、および API が料金を返さない場合に使用されます。ショップの既定通貨で、税抜きで表示されます。
Country prices：届け先の国と料金の表です。Add country をクリックすると行を追加し、ごみ箱アイコンをクリックすると行を削除します。独自の行がないすべての国には、* All other countries を選択します。Price は、その国の料金です。XS（1 kg まで）、S（1-2 kg）、M（2-3 kg）、L（3-5 kg）、XL（5 kg 超）の各列は、そのカートの重量に対してこの料金に代わって使われます。空または 0 の列は Price を使用します。Price が 0 の場合、その国への送料は無料になります。9.99 と 9,99 の両方が受け付けられます。数値ではない値は、保存後に通知され、消去されます。どの料金も入っていない行は、保存時に削除されます。
Fallback cost：API も Country prices も料金を提示しない場合に使用されます。その場合に配送業者を非表示にするには、空欄のままにします。
Calculation type：Per order は料金を 1 回だけ請求します。Per item (each item priced by its own weight x quantity) は、各商品の重量に基づいて Country prices（または Fallback cost）を調べ、数量を掛けます。ある商品に料金が設定されていない場合、配送業者は非表示になります。Mercado Envios のリアルタイム料金は、常に荷物全体が対象です。
提供条件
Min weight：この配送業者が表示されるための、カートの最低重量（kg）。0 は制限なしを意味します。
Max weight：カートの重量がこの値を超える場合、配送業者を非表示にします（kg）。空欄は 25 kg、0 は制限なしを意味します。Max weight より大きい Min weight は、保存時に拒否されます。
Minimum subtotal：カートの小計（割引後、税抜き）がこの金額以上の場合にのみ配送業者を表示します。常に表示する場合は空欄にします。
Ignore shipping zones：配送業者のゾーンを設定せずに、下記の国に対して配送業者を提供します。保存時に、配送業者はすべてのゾーンに追加され、後から作成されたゾーンにも追加されます。このオプションをオフにすると、このオプションで追加されたゾーンが削除されます。配送業者は独自のゾーンを保持します。
Countries：このモードの届け先の国。空欄の場合は、ショップで有効なすべての国が対象になります。このフィールドは Ignore shipping zones がオンの場合にのみ使用されます。
送料無料
Free shipping from：この配送業者が無料になるカートの小計（割引後、税抜き）。この場合、API リクエストは送信されません。無効にするには空欄のままにします。
詳細設定
Debug log：API リクエストと料金計算を、モジュールフォルダ内の logs/vfd_mrcv_debug.log.php に書き込みます。このファイルはウェブから開くことはできません。このオプションがオフでも、エラーは常に記録されます。Access Token と顧客の住所が記録されることはありません。
Log：ログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログが空になります。
Remove data on uninstall：オンの場合、モジュールをアンインストールすると、設定、配送業者、キャッシュされた料金、ログが削除されます。オフの場合は、再インストールに備えてすべてが保持されます。
チェックアウト時の動作
配送ステップで、PrestaShop はモジュールに Mercado Envios の料金を問い合わせます。対象となるのは物理的な商品だけです。仮想商品は重量に加算されず、小計にも含まれません。モジュールはまず条件を確認します：許可された国（Ignore shipping zones の場合）、カートの重量、最低小計。送料無料が適用される場合、料金は 0 となり、Mercado Envios へのリクエストは行われません。
Mercado Envios の対象国内で、郵便番号が有効な届け先の場合、モジュールはカートを 1 つの荷物として扱います。商品の中で最も大きい幅と長さ、すべての商品の高さの合計、そしてグラム単位の総重量です。各辺と重量は、その国の Mercado Envios の最低値まで引き上げられるため、寸法や重量のない商品でも料金を取得できます。カートの金額は、Mercado Envios の通貨で商品価格として送信されます。Mercado Envios が返した最も安いオプションは、ショップの既定通貨に換算され、その後、顧客のカートの通貨で表示されます。
各見積もりは 1 時間キャッシュされるため、同じカートで新しいリクエストが発生することはありません。失敗した見積もりは 5 分間再送されません。Mercado Pago に接続できない場合、トークンが拒否された場合、またはリクエストが制限された場合は、すべてのリアルタイム見積もりが 5 分間一時停止され、チェックアウトが更新のたびに API を待つことがなくなります。API のタイムアウトは 10 秒です。
トークンがない場合、届け先が Mercado Envios の対象国外の場合、郵便番号が未入力または無効な場合、為替レートが未設定の場合、荷物が国ごとの Mercado Envios の重量上限（アルゼンチン 25 kg、ブラジル 15 kg、メキシコ 30 kg）を超える場合、または Mercado Envios がエラーを返すか、その住所に対するオプションを返さない場合は、代わりにリアルタイム料金がない場合の料金が使用されます。その国の行（または * の行）が使用され、なければ予備の送料が使われます。料金がない場合、配送業者は非表示になります。顧客に API エラーが表示されることはありません。
注文のある配送業者を Shipping > Carriers で編集すると、PrestaShop はそれを新しい配送業者のバージョンとして保存します。モジュールは自動的に新しいバージョンに従います。
モジュールは料金の計算のみを行います。発送の作成、ラベルの印刷、荷物の追跡は行いません。発送は、お使いの Mercado Libre または Mercado Pago アカウントで作成してください。表示されるのは 1 つの料金、つまり最も安い Mercado Envios のオプションです。すべてのオプションから選ばせるわけではなく、受け取り拠点（営業所）の選択機能もありません。
注文
リアルタイムの Mercado Envios 料金で注文が行われると、モジュールはサービス名、日数で表した推定配送日数、リアルタイム料金を保持します。管理画面の注文ページには、Mercado Envios service、Estimated delivery、Live rate (excl. tax) を含む Mercado Envios ブロックが表示されます。顧客は、自分のアカウントの注文詳細ページで Mercado Envios service と Estimated delivery を確認できます。既存の注文は、その後の料金変更の影響を受けません。
ライセンスキー
このモジュールは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Mercado Envios は、Modules > Module Manager > VibeFox Mercado Envios > Configure ページで設定の上に表示される最初のブロックです。キーを License key に貼り付け、Activate をクリックしてください。その後、ブロックにはマスクされたキー、ステータス（ライセンスの有効期限日やドメインなど）、そして次のボタンが表示されます。Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このショップからキーを削除）。その下には、Product: presta-shipping-mercado-envios の行と、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 のアカウントで枠を解放してください。
有効なキーがない場合、Mercado Envios 配送業者はチェックアウトで顧客に表示されず、料金も計算されません。PrestaShop のストアフロントは、バックオフィスにログインしていることを認識しないため、配送業者はあなたにも表示されません。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文は影響を受けません。
ライセンスの有効期限が切れた場合も、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キー入力後最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは必要ありません。モジュールのアンインストールまたはリセットを行うと、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
Mercado Envios がチェックアウトに表示されない：ライセンスが有効であること、Enable Mercado Envios shipping がオンであることを確認してください。Shipping > Carriers で、配送業者が顧客の国のゾーンと顧客のグループをカバーしていることを確認してください（または Ignore shipping zones をオンにして Countries を確認してください）。モジュールのページ上部の警告、重量制限、Minimum subtotal も確認してください。配送業者には料金が必要です。Mercado Envios の対象国の住所に対して有効な Access Token があるか、Country prices または Fallback cost が設定されている必要があります。また、商品ページで商品が特定の配送業者に制限されている場合もあります。
リアルタイム料金が表示されない：Debug log をオンにし、チェックアウトを再読み込みして、モジュールのページの Log フィールドを確認してください。よくある原因：トークンがない、届け先が Mercado Envios の対象国外、郵便番号がない・無効、Exchange rate が未設定、荷物が重量制限を超えている、またはその住所に対する Mercado Envios のオプションがない。
警告に HTTP 401 または 403 が表示される：Access Token が無効か、期限切れです。Mercado Pago の開発者パネルから本番環境の Access Token を再度コピーしてください。
Mercado Envios が別の通貨で応答した：アカウントの国が Mercado Envios country と一致していません。Mercado Pago アカウントの国を選択してください。
料金はどの通貨か：Country prices、Fallback cost、および上限・下限の値は、ショップの既定通貨で設定されます。リアルタイム料金は Mercado Pago アカウントの通貨で届き、ショップが別の既定通貨を使用している場合は Exchange rate で換算されます。
変更後に料金が古いように見える：モジュールのページで Save をクリックしてください。これによりキャッシュされた料金が消去されます。
ページに Mercado Envios 配送業者が見つからないと表示される：Shipping > Carriers で配送業者が削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。
アンインストール
Modules > Module Manager に進み、VibeFox Mercado Envios の横にあるメニューを開いて、Uninstall を選択します。ライセンスキーとライセンスステータスは常に削除されます。キャッシュされた料金は常に削除されます。Remove data on uninstall がオンの場合、配送業者は削除されます（注文は履歴を保持します）。さらに、設定、ログ、注文に保存されたサービスデータも削除されます。オフの場合、配送業者は無効になるだけで、すべての設定と注文のサービスデータは保持されます。モジュールを再インストールすると、配送業者はアンインストール前のステータスを取り戻します。
Mercado Envios と Mercado Pago は、それぞれの所有者の商標です。このモジュールは、Mercado Envios または Mercado Pago とは提携しておらず、これらの企業による推奨もありません。