VibeFox 99Minutos for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 5.0 以降。インストールされて有効である必要があります。WooCommerce がなければ、プラグインは有効化できません。

PHP: 8.0 以降。

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

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

インストール

1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_99minutos フォルダを /wp-content/plugins/ にアップロードすることもできます。

2. Activate をクリックします。

3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox 99Minutos。または、Plugins ページでプラグイン名の下にある Settings をクリックします。

4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。

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

6. WooCommerce > Settings > Shipping > Shipping zones で、メキシコ、コロンビア、チリ、ペルーを対象とする配送ゾーンに VibeFox 99Minutos を追加します。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox 99Minutos。設定はすべての配送ゾーンに適用されます。ゾーンに配送方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます。

Method title (zone): このゾーンで購入者に表示される名前。空欄にすると、全体設定の Method title を使用します。

設定を保存する際、料金マトリクスが空の場合や、API キーがないのに配送可否確認モードが選ばれている場合は、ページに警告が表示されます。

全般

Enable/Disable: すべての配送ゾーンで 99Minutos を一括で有効にします。この配送方法は、メキシコ、コロンビア、チリ、ペルーを対象とする配送ゾーンにも追加する必要があります。デフォルト：オン。

Method title: チェックアウト時に購入者に表示される配送方法名。ゾーンごとに上書きできます。デフォルト：99Minutos。

Tax status: Taxable は送料に WooCommerce の税金を加算し、None は加算しません。

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

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

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

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

API key: 99minutos API キー。Bearer トークンとして 99minutos の配送可否確認エンドポイントに送信されます。配送可否確認がオンの場合は必須です。このフィールドはマスク表示されます。

Environment: Sandbox (test)（デフォルト）または Production。サンドボックスと本番では API キーが異なるため、お使いのキーに合った環境を選択してください。

料金

料金は貴店の通貨で入力し、換算せずにそのまま使用されます。

Price matrix: 配送先の国と料金の表です。+ Add country をクリックすると行を追加でき、×印をクリックすると行を削除できます。各行には、Country、Base price、そして XS（1 kg まで）、S（2 kg まで）、M（3 kg まで）、L（5 kg まで）、XL（5 kg 超）の各サイズの料金があります。サイズの料金が空欄または 0 の場合は、Base price が使用されます。* Default の行は、専用の行がない国に適用されます。小数点とカンマのどちらも小数点区切りとして使用できます。負の料金は 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): カートがこれより重い場合、配送方法を非表示にします。デフォルト：25。0 は制限なしを意味します。

Minimum subtotal: カート小計（割引後、税抜き）がこの金額以上の場合にのみ、配送方法を表示します。空欄にすると常に表示されます。

Excluded shipping classes: カート内のいずれかの商品が、これらの WooCommerce 配送クラスのいずれかに属している場合、配送方法を非表示にします。

Restrict countries: 下記の国に対してのみ配送方法を提供します。これは配送ゾーンに対する追加のフィルターです。配送方法は引き続き配送ゾーンに追加する必要があります。1 つのゾーンが複数の国をカバーする場合に便利です。

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

詳細設定

Debug log: 料金計算を WooCommerce > Status > Logs に記録します（ソースは「vfd-99minutos」）。このオプションがオフでも、API エラーは記録されます。API キー、購入者の氏名と住所は記録されません。

Remove data on uninstall: オンにすると、プラグインを削除したときに設定と配送可否のキャッシュが削除されます。無効化では何も削除されません。配送ゾーンの配送方法と注文は、いずれの場合も保持されます。

チェックアウト時の動作

配送先の国がメキシコ、コロンビア、チリ、またはペルーの場合にのみ配送方法が提供されます（Restrict countries がオンの場合は Countries の一覧に含まれている必要があります）。購入者が配送先住所を入力すると、プラグインはカートの重量制限、Minimum subtotal、Excluded shipping classes を確認します。

配送可否確認モードがオンの場合、プラグインは次に 99minutos API に郵便番号が配送可能かどうかを問い合わせます。リクエストのタイムアウトは 10 秒で、応答はキャッシュされるため、同じ郵便番号で新たなリクエストが発生することはありません。API のエラーが購入者に表示されることはありません。Strict モードでは配送方法を非表示にし、Soft モードでは料金マトリクスの料金を使用します。送料無料でも配送可否確認は省略されません。

料金は、配送先の国に対応するマトリクスの行、または * Default の行から取得されます。どちらもない場合は、配送方法を非表示にします。Free shipping がオンで、カート小計が Free shipping from に達している場合、料金は 0 になります。

配送方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックで動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。

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

ライセンスキー

プラグインは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox 99Minutos の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ステータス（ライセンスの有効期限日など）と、お使いのドメインが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。

1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。枠は vibefox.net のアカウントで解放してください。

有効なキーがない場合、99Minutos はチェックアウトで購入者に表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示されたうえで表示されるため、キーを購入する前にプラグインを設定してテストできます。Plugins ページと WooCommerce のページにはリマインダーが表示されます。既存の注文には影響しません。

ライセンスの期限が切れた場合も、プラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスは自動的にバックグラウンドで再確認されます。

トラブルシューティング

99Minutos がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、購入者の住所のゾーンに配送方法が追加されていることを確認してください。配送先の国はメキシコ、コロンビア、チリ、またはペルーである必要があります。Price matrix にその国の行、または * Default の行があるか確認し、重量制限、Minimum subtotal、Excluded shipping classes、Restrict countries も確認してください。

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

Strict モードで配送方法が常に非表示になる: Debug log をオンにして、チェックアウトを再読み込みし、WooCommerce > Status > Logs（ソースは「vfd-99minutos」）を開いてください。HTTP 401 または 403 のエラーは、API キーが拒否されたことを意味します。キーと Environment の設定が一致しているか確認してください（サンドボックスと本番のキーは異なります）。API が利用できない間も購入者に料金マトリクスの料金を提示したい場合は、Soft モードを使用してください。

料金が想定と異なる: Calculation（注文単位または商品単位）、商品の重量、貴店の重量単位を確認してください。サイズの料金が空欄または 0 の場合は、Base price が使用されます。

その他の国: 開発者は vfd_99m_supported_countries フィルターで、対象国のリストを変更できます。

ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、キーが別のドメインで既に使用されている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。

アンインストール

プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページでプラグインを無効化してから削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。設定と配送可否のキャッシュは、Remove data on uninstall がオンだった場合にのみ削除されます。そうでない場合は、後日の再インストールのために残されます。配送ゾーンの配送方法と既存の注文は保持されます。

99minutos は、各所有者の商標です。本プラグインは 99minutos と提携しておらず、99minutos による承認や推奨もありません。