VibeFox 99Minutos for OpenCart — ヘルプ

動作要件

OpenCart: 3.0.x（3.0.5.0 で検証済み）または 4.0.2 以降（4.1.0.3 で検証済み）。

PHP: 8.0 以降。

99minutos API キー（対応地域チェックにのみ必要）: 99minutos のアカウントマネージャーから、または 99minutos デベロッパーポータル（developers.99minutos.com）で入手できます。サンドボックス用と本番用のキーは別々です。価格マトリックスのみを使用する場合、API キーは不要です。

国: 99minutos は、メキシコ、コロンビア、チリ、ペルーへ配送します。発送先の国は System > Localisation > Countries で有効にしておく必要があります。

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

インストール

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

OpenCart 3

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

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

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

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

5. Price matrix に入力します（少なくとも 1 行、例：「* Default」）。必要に応じて、API キーと対応地域チェックのモードも設定します（設定を参照）。Enable 99Minutos をオンにして、Save をクリックします。

OpenCart 4

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

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

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

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

インストール直後は、Enable 99Minutos をオンにして保存するまで、この配送方法は無効のままです。アンインストール後に再インストールした場合は、保持されていた 99minutos の設定が再び使用されます。

設定

すべての設定は拡張機能のページにあります：Extensions > Extensions > Shipping > VibeFox 99Minutos > Edit。セクションは左側に表示されます。Save ボタンを 1 回押すと、ページを再読み込みせずにページ全体が保存されます。保存するたびに、キャッシュされた対応地域の確認結果も消去されます。値が正しくない場合は何も保存されず、ページに理由が表示されます。例：Enter a method title (1 to 64 characters).、フィールドは 0 以上の数値である必要があるという通知、Min weight (kg) が Max weight (kg) より大きくてはならないという通知。保存後、設定の上部に警告が表示され、現在の設定では配送方法が機能しない可能性があることが分かります。たとえば、価格マトリックスが空の場合、API キーなしで対応地域チェックのモードが選択されている場合、マトリックスに 99minutos が対応していない国の行がある場合、ストアに「kg」の重量単位がなく、拡張機能が重量単位を認識できない場合（この場合、重量はキログラムとして扱われます）などです。この拡張機能を変更する権限を持つ管理者ユーザーのみが設定を保存できます。

一般

設定はすべてのジオゾーンに適用されます。99Minutos は、配送先の国としてメキシコ、コロンビア、チリ、ペルーの場合にのみ提供されます。

Enable 99Minutos: チェックアウトで 99Minutos を表示または非表示にします。既定値：オフ。

Method title: 購入者がカートとチェックアウトで見る配送方法の名称です。既定値：99Minutos。必須、64 文字まで。

Tax class: 送料の税クラス、または No tax（既定値）。税クラスを選択すると、OpenCart は価格マトリックスの料金に税金を加算します。

Sort order: チェックアウトの配送方法の中で 99Minutos が表示される順番です。整数で指定します。

99minutos API（対応地域チェック）（任意）

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

Coverage check: 郵便番号を確認するかどうか、またその方法です。

対応地域チェックを有効にすると、購入者が郵便番号を入力した後にのみ配送方法が表示されます。結果はキャッシュされます：対応地域内は 6 時間、対応地域外は 30 分、API エラーは 5 分です。ただし、OpenCart のキャッシュ期間（既定では 1 時間）を超えることはありません。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: 配送が必要な商品の小計（クーポン適用後、税抜き）がこの金額以上の場合にのみ、配送方法を表示します。常に表示する場合は空欄にしてください。

Geo zone: このジオゾーン内の住所に対してのみ 99Minutos を提供します。All zones（既定値）は制限なしを意味します。ジオゾーンは System > Localisation > Geo Zones で管理されます。

Restrict countries: 下記の国に対してのみ配送方法を提供します。これは Geo zone に加えて適用される追加のフィルターです。

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

詳細

Debug log: 料金計算の内容を storage/logs/vfd_99m_debug.log.php に書き込みます。このファイルは Web から読み取ることはできません。この設定がオフの場合でも、API エラーは記録されます。API キーや顧客の氏名・住所がログに記録されることはありません。作業が終わったらログをオフにしてください。ファイルが 5 MB に達すると、vfd_99m_debug.old.log.php に移動され、新しいログが開始されます。

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

Remove data on uninstall: オンの場合、拡張機能をアンインストールすると、99minutos の設定、対応地域のキャッシュ、ログが削除されます。オフの場合（既定値）は、再インストール用に保持されます。注文はいずれの場合も保持されます。

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

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

Import: 以前にエクスポートした JSON を貼り付け、Import をクリックすると、設定が復元されます（例：別のストアでの利用）。値は通常の保存時と同様にチェックされます。保存済みの API キーは保持されます。

チェックアウトでの動作

OpenCart が配送方法を表示するとき、拡張機能に 99Minutos の料金を問い合わせます。Geo zone が設定されていて、住所がその範囲外の場合、99Minutos は提供されません。Requires Shipping が Yes に設定された商品のみが計算に含まれます。それ以外の商品は重量を加算せず、注文金額にも含まれません。配送方法は、配送先の国がメキシコ、コロンビア、チリ、ペルーの場合にのみ提供されます（Restrict countries が有効な場合は、Countries の一覧に含まれている必要があります）。その後、拡張機能は重量の制限と Minimum subtotal を確認します。注文金額は、配送が必要な商品の価格で、クーポン割引後、税抜きの金額です。ギフト券、ポイント、ストアクレジットは考慮されません。

対応地域チェックが有効な場合、拡張機能は 99minutos API に郵便番号が対応地域内かどうかを問い合わせます。リクエストのタイムアウトは 10 秒で、回答はキャッシュされるため、同じ郵便番号で再度リクエストが送信されることはありません。API エラーが購入者に表示されることはありません。Strict モードでは配送方法が非表示になり、Soft モードでは価格マトリックスの料金が使用されます。送料無料であっても、対応地域チェックは省略されません。

料金は、配送先の国に対応するマトリックスの行、または * Default の行から取得されます。どちらも存在しない場合は、配送方法が非表示になります。Free shipping が有効で、注文金額が Free shipping from に達した場合、料金は 0 になります。料金はストアの既定通貨で計算され、その小数点以下の桁数に丸められ、選択された Tax class の税金を加えて、購入者の通貨で表示されます。

拡張機能は 99minutos からリアルタイムの運賃見積もりを取得しません。料金は常にお客様のマトリックスから取得されます。拡張機能は 99minutos で出荷や注文を作成せず、伝票（ガイド）を印刷せず、荷物を追跡せず、Punto99 の受取ポイントを提供せず、代金引換にも対応しません。注文には何も追加されません。注文には、他の OpenCart の配送方法と同様に、配送方法の名称と送料が表示されます。出荷は、通常どおり 99minutos のアカウントで作成してください。

OpenCart 4 では、購入者はチェックアウトページの配送方法ブロックで Choose をクリックし、Shipping method options のウィンドウで 99Minutos を選択します。この方法は OpenCart 3 と同じように動作します。

ライセンスキー

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

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

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

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

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

トラブルシューティング

チェックアウトに 99Minutos が表示されない：ライセンスが有効であること、Enable 99Minutos がオンであることを確認してください。配送先の国がメキシコ、コロンビア、チリ、ペルーのいずれかで、System > Localisation > Countries で有効になっている必要があります。Geo zone と Restrict countries を確認してください。Price matrix に、その国の行または * Default の行があることを確認し、重量の制限と Minimum subtotal も確認してください。商品の Requires Shipping が Yes に設定されていることを確認してください。Save の後に表示される警告は、配送方法を非表示にしている設定を示しています。

郵便番号を入力した後にのみ配送方法が表示される：対応地域チェックを使用している場合は想定どおりの動作です。Strict モードでは、API が対応地域を確認した場合にのみ表示されます。

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

料金が想定と異なる：Calculation（注文ごとまたは商品ごと）と、商品の重量および重量単位を確認してください。サイズの料金が空欄または 0 の場合は、Base price が使用されます。Tax class を設定している場合、価格マトリックスの料金に税金が加算されます。

変更後に対応地域の結果が古く見える：拡張機能のページで Save をクリックしてください。これにより、キャッシュされた対応地域の結果が消去されます。

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

開発者向け：99minutos API のアドレスは、設定 vfd_99m_api_url（テスト用）で置き換えられます。この設定は設定ページにはフィールドがありません。

アンインストール

Extensions > Extensions に進み、Shipping の種類を選択して、VibeFox 99Minutos の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスの状態は常に削除されます。OpenCart は常に Enable 99Minutos、Sort order、Tax class、Geo zone をリセットします。キャッシュされた対応地域の結果は、常に削除されます。Remove data on uninstall がオンの場合は、99minutos の設定とデバッグログも削除されます。オフの場合は、他の設定が保持され、拡張機能を再インストールしたときに再び使用されます。既存の注文は、配送方法と送料がそのまま保持されます。

OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に進み、インストール済み拡張機能の一覧にある VibeFox 99Minutos の横の Uninstall（オレンジ色の − ボタン）をクリックして、次にアップロードしたパッケージを削除するため Delete（赤いごみ箱ボタン）をクリックします。

99minutos は、それぞれの所有者の商標です。この拡張機能は 99minutos との提携や承認を受けていません。