VibeFox 99Minutos for PrestaShop — ヘルプ

要件

PrestaShop: 8.0 ～ 9.x。

PHP: 8.0 以降。古い PHP バージョンではモジュールをインストールできません。

99minutos API キー（配送可否の確認のみに使用）: 99minutos のアカウントマネージャーに問い合わせるか、99minutos デベロッパーポータル（developers.99minutos.com）で取得してください。サンドボックス用と本番用のキーは別々です。料金マトリクスのみを使用する場合、API キーは不要です。

国: 99minutos は、メキシコ、コロンビア、チリ、ペルーへ配送します。発送先の国は International > Locations で有効になっている必要があります。

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

インストール

1. 管理画面で Modules > Module Manager を開き、Upload a module をクリックします。モジュールの ZIP ファイルを選択してください。

2. アップロードが完了したら Configure をクリックします。後で探す場合は、モジュール一覧から VibeFox 99Minutos を見つけて Configure をクリックしてください。

3. Configure ページ上部のライセンスブロックの License key に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。

4. Price matrix に入力します（少なくとも 1 行。例：「* Default」）。必要に応じて API キーと配送可否の確認モードも設定してください（設定を参照）。Save をクリックします。

インストール時、モジュールは配達日数のテキスト Courier delivery を持つ配送業者 99Minutos を作成します。配送業者はすべてのゾーンとすべての顧客グループに割り当てられます。ゾーン、顧客グループ、配達日数、ロゴ、サイズ制限は Shipping > Carriers で変更できます。メキシコ、コロンビア、チリ、ペルーのゾーンは、この配送業者で有効のままにしてください。そこで料金を設定しないでください。料金は常にモジュールから取得されます。

設定

すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox 99Minutos > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。保存するたびに、キャッシュされた配送可否の結果も消去されます。保存後、料金マトリクスが空の場合、99minutos が対応していない国の行がある場合、API キーなしで配送可否の確認モードが選択されている場合、またはモジュールがショップの重量単位を認識できない場合（この場合、重量はキログラムとして扱われます）には、ページで警告が表示されます。Method title が 64 文字を超える場合、重量または金額の欄が 0 以上の数値ではない場合、Min weight (kg) が Max weight (kg) より大きい場合は、何も保存されず、エラーが表示されます。ページに The 99Minutos carrier was not found — reset the module to create it again. と表示される場合は、トラブルシューティングを参照してください。

一般

Enable 99Minutos: 配送業者を有効または無効にします。これは Shipping > Carriers の配送業者のステータスと同じスイッチです。

Method title: カートとチェックアウトで購入者に表示される配送業者名。既定値：99Minutos。必須、64 文字以内。

Tax: 配送業者の税ルール、または No tax。税ルールがある場合、PrestaShop は料金マトリクスの配送料に税金を加算します。

99minutos API（配送可否の確認）（任意）

API は、99minutos が購入者の郵便番号に配送するかどうかを確認するためにのみ使用されます。料金は常にマトリクスから取得されます。

Coverage check: 郵便番号を確認するかどうか、および確認方法。

配送可否の確認を有効にすると、購入者が郵便番号を入力した後にのみ配送業者が表示されます。結果はキャッシュされます。配送可能は 6 時間、配送不可は 30 分、API エラーは 5 分です。99minutos に送信されるのは郵便番号のみで、大文字に変換され、英字と数字のみになります。

API key: 99minutos API キー。Bearer トークンとして 99minutos の配送可否確認エンドポイントに送信されます。配送可否の確認が有効な場合は必須です。保存後、欄は空のままになり、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。キーは入力したとおりに保存され、前後の空白のみが削除されます。

Remove the saved API key: 保存されたキーがある場合にのみ表示されます。オンにして Save をクリックすると、キーが削除されます。

Environment: Sandbox (test)（既定値）または Production。サンドボックスと本番では API キーが異なるため、キーに合わせて環境を選択してください。

料金

料金は貴店の基準通貨で、税抜きで入力し、入力された値のまま使用されます。最終料金は購入者のカート通貨で表示されます。

Price matrix: 配送先の国と料金の表です。Add country をクリックして行を追加し、ごみ箱アイコンで行を削除します。各行には、Country（* Default、メキシコ、コロンビア、チリ、ペルー）、Base price、およびサイズ XS（1 kg まで）、S（2 kg まで）、M（3 kg まで）、L（5 kg まで）、XL（5 kg 超）の料金があります。サイズの料金が空または 0 の場合は Base price が使われます。* Default の行は、独自の行がない国に適用されます。1 つの国に複数の行がある場合は、最初の行が使われます。小数点とカンマのどちらも小数点区切りとして使用できます。空欄、無効、または負の料金は 0 として保存されます。マトリクスに少なくとも 1 行が追加されるまで、チェックアウトで配送業者は表示されません。

Calculation: Per order — size by the total cart weight（既定値）は、カート全体の荷物サイズに対して 1 つの料金を請求します。Per item — each unit priced by its own weight は、各単位をそれぞれの重量のサイズで料金設定し、合計します。

Free shipping: カート小計による送料無料を有効にします。

Free shipping from: 料金が 0 になるカート小計（割引後、税抜き）。Free shipping が有効な場合にのみ使用されます。

制限

Min weight (kg): カートがこれより軽い場合、配送業者を非表示にします。0 は制限なしを意味します。Max weight (kg) より大きくすることはできません。商品の重量は、貴店の重量単位から換算されます。

Max weight (kg): カートがこれより重い場合、配送業者を非表示にします。既定値：25。0 は制限なしを意味します。空欄の場合は 25 kg になります。

Minimum subtotal: カート小計（割引後、税抜き）がこの金額以上の場合にのみ、配送業者を表示します。常に表示する場合は空欄のままにしてください。

Restrict countries: 以下の国に対してのみ配送業者を提供します。配送業者のゾーンに対する追加のフィルターです。1 つのゾーンに複数の国が含まれている場合に便利です。

Countries: 99minutos の対応国（メキシコ、コロンビア、チリ、ペルー）から選択します。Ctrl（Cmd）を押しながら複数選択できます。Restrict countries が有効な場合にのみ使用されます。空欄の場合は 99minutos のすべての国を許可します。

詳細設定

Debug log: 料金計算の内容を、モジュールフォルダ内の logs/vfd_99m_debug.log.php に書き込みます。このファイルは Web から開くことはできません。この設定がオフでも API エラーは記録されます。API キーや購入者の氏名・住所は記録されません。作業が終わったらログをオフにしてください。

Log: デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると内容が消去されます。

Remove data on uninstall: オンの場合、モジュールをアンインストールすると、設定、配送業者、配送可否のキャッシュ、ログが削除されます。オフの場合は、再インストールのためにすべて保持されます。注文は常に保持されます。

チェックアウトでの動作

配送ステップで、PrestaShop はモジュールに 99Minutos の料金を問い合わせます。対象となるのは物理的な商品のみです。バーチャル商品は重量を加算せず、カート小計にも含まれません。配送業者は、配送先の国がメキシコ、コロンビア、チリ、ペルーの場合にのみ提供されます（Restrict countries が有効な場合は Countries リストにも含まれている必要があります）。その後、モジュールは重量制限と Minimum subtotal を確認します。

配送可否の確認モードが有効な場合、モジュールは 99minutos API に郵便番号が配送対象かどうかを問い合わせます。リクエストのタイムアウトは 10 秒で、結果はキャッシュされるため、同じ郵便番号では新たなリクエストは発生しません。API エラーが購入者に表示されることはありません。Strict モードでは配送業者が非表示になり、Soft モードではマトリクスの料金が使用されます。送料無料は配送可否の確認を回避しません。

料金は、配送先の国のマトリクス行、または * Default 行から取得されます。どちらも存在しない場合、配送業者は非表示になります。Free shipping が有効で、カート小計が Free shipping from に達している場合、料金は 0 です。料金は貴店の基準通貨で計算され、その後、購入者のカート通貨で表示されます。

注文を受けた後に Shipping > Carriers で配送業者を編集すると、PrestaShop はそれを配送業者の新しいバージョンとして保存します。モジュールは新しいバージョンに自動的に追従します。

モジュールは 99minutos から実際の運賃見積もりを取得しません。料金は常に貴店のマトリクスから取得されます。99minutos での発送や注文の作成、伝票（guides）の印刷、荷物の追跡、Punto99 受取拠点の提供、代金引換の処理は行いません。発送は、通常どおり 99minutos アカウントで作成してください。

ライセンスキー

このモジュールは、vibefox.net で取得した VibeFox ライセンスキーで動作します。License — VibeFox 99Minutos ライセンスブロックは、Modules > Module Manager > VibeFox 99Minutos > Configure ページで設定より上にある最初のブロックです。キーを License key に貼り付けて Activate をクリックします。その後、ブロックにはキーがマスク表示され、ステータス（ライセンスの有効期限の日付やドメインなど）が表示されます。また、ステータスを再確認する Check now、別のキーを入力する Change key、このショップからキーを削除する Remove key のボタンがあります。その下には Product: presta-shipping-99minutos の行と、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 アカウントで解放してください。

有効なキーがない場合、チェックアウトで購入者に 99Minutos 配送業者は表示されず、料金も計算されません。PrestaShop のストアフロントは、管理画面にログインしていることを認識しないため、配送業者はあなたにも表示されません。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。

ライセンスの有効期限が切れた場合も、モジュールは動作し続けますが、アップデートとサポートには更新が必要です。ステータスは管理画面での作業中に自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは常に削除されます。

トラブルシューティング

チェックアウトに 99Minutos が表示されない: ライセンスが有効で、Enable 99Minutos がオンになっていることを確認してください。配送先の国はメキシコ、コロンビア、チリ、ペルーのいずれかで、International > Locations で有効になっている必要があります。Shipping > Carriers で、配送業者が購入者の国のゾーンと顧客グループをカバーしていることを確認してください。Price matrix に、その国の行または * Default の行があることを確認し、重量制限、Minimum subtotal、Restrict countries も確認してください。商品ページで、特定の配送業者に制限されている商品もある場合があります。

郵便番号を入力した後にのみ配送業者が表示される: 配送可否の確認を有効にしている場合は、これは想定どおりの動作です。Strict モードでは、API が配送可能を確認した場合にのみ表示されます。

Strict モードで配送業者が常に非表示になる: Debug log をオンにし、チェックアウトを再読み込みして、モジュールのページの Log 欄を確認してください。HTTP 401 または 403 エラーは、API キーが拒否されたことを意味します。キーと、Environment が一致しているか確認してください（サンドボックスと本番のキーは異なります）。API が利用できない間も購入者にマトリクスの料金を表示したい場合は、Soft モードを使用してください。

料金が想定と異なる: Calculation（注文単位または商品単位）、商品の重量、貴店の重量単位（International > Localization）を確認してください。空欄または 0 のサイズ料金は Base price が使われます。Tax で税ルールがある場合、マトリクスの料金に税金が加算されます。

変更後に配送可否の結果が古いようです: モジュールのページで Save をクリックしてください。これにより、キャッシュされた配送可否の結果が消去されます。

ページに 99Minutos 配送業者が見つからないと表示される: 配送業者が Shipping > Carriers で削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。メッセージ The settings were saved, but the carrier could not be updated. Reset the module to create it again. についても同様です。

アンインストール

Modules > Module Manager に移動し、VibeFox 99Minutos の横にあるメニューを開いて Uninstall を選択します。ライセンスキーとライセンスステータスは常に削除されます。配送可否のキャッシュも常に削除されます。Remove data on uninstall がオンの場合、配送業者は削除されます（注文は履歴を保持します）。また、設定とログも削除されます。オフの場合、配送業者は無効になるだけで、すべての設定は保持されます。モジュールを再インストールすると、保存されていた配送業者はアンインストール前のステータスに戻ります。そのため、Reset によって無効化された配送業者が有効になることはありません。

99minutos は、それぞれの所有者の商標です。このモジュールは 99minutos と提携しておらず、99minutos の承認も受けていません。