VibeFox Mercado Envios for WooCommerce — ヘルプ
要件
WordPress：5.8 以降。
WooCommerce：7.0 以降。インストールされていて有効であること。WooCommerce がない場合、プラグインは有効化できません。
PHP：8.0 以降。
Mercado Pago アカウント（リアルタイム料金のみ必要）：リアルタイム料金は、アルゼンチン、ブラジル、またはメキシコの Mercado Pago アカウントの Mercado Envios 料金計算機から取得されます。そのアカウントで Mercado Envios が有効になっている必要があります。荷物は、そのアカウントに設定された配送先住所を基準に見積もられます。本番環境の Access Token（APP_USR- で始まります）が必要です。Mercado Pago の開発者パネルで、アプリケーションと本番環境の認証情報を開いてください。ログインボタンはありません。トークンを設定画面に貼り付けます。国ごとの価格だけを使う場合は、Mercado Pago アカウントは必要ありません。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin を開き、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_mercado_envios フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox Mercado Envios。または、Plugins ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. リアルタイム料金を使う場合は、Access Token を貼り付け、Mercado Envios の国を選択します。ストアの通貨が ARS、BRL、MXN のいずれでもない場合は、為替レートも入力します。必要に応じて Country prices と Fallback cost を入力します（リアルタイム料金がない場合に使用されます）。
6. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーンに VibeFox Mercado Envios を追加します。または Ignore shipping zones をオンにして国を選択します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox Mercado Envios。設定はすべての配送ゾーンに適用されます。配送ゾーンにこの方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます。
Title (zone)：チェックアウトでこのオプションに表示される名前です。空欄にすると、全体の Name が使用されます。
ページ上部の警告には、為替レートの未設定、アクセストークンと価格の両方が未設定である場合、日時付きの最後の Mercado Envios API エラーなど、設定の問題が表示されます。設定を保存するたびに、キャッシュされた料金はクリアされます。
一般
Enable/Disable：すべてのゾーンで Mercado Envios の配送を一括で有効または無効にします。
Name：チェックアウトで購入者に表示される配送方法の名前です。初期値：Mercado Envios。
Tax status：Mercado Envios は最終価格を提供します。None は見積もりどおりに表示し、Taxable は WooCommerce の配送税を上乗せします。
Mercado Envios API（リアルタイム料金）（トークンがない場合は、下記の価格のみが使用されます）
Access token：Mercado Pago の本番環境の Access Token（APP_USR-...）です。Mercado Pago にのみ送信され、ログには記録されません。
Mercado Envios country：Mercado Pago アカウントの国です：Argentina (ARS)（初期値）、Brazil (BRL)、または Mexico (MXN)。リアルタイム料金は、この国の届け先に対してのみ取得され、その国の通貨で表示されます。
Exchange rate：ストアの通貨が Mercado Envios の通貨と異なる場合にのみ必要です。1 ARS、BRL、または MXN のストア通貨建ての価格を入力します（例：0.001）。設定しない場合、リアルタイム料金は使用されません。小数点とカンマのどちらも小数点記号として使えます。
リアルタイム料金がない場合の価格
これらの価格は、アクセストークンがない場合、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 超）の各列は、そのカートの重量の場合に Price の代わりに使用されます。空欄または 0 の列は Price を使用します。数値でない値は保存後に通知され、消去されます。どの価格も入っていない行は、保存時に削除されます。
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。0 は制限なしを意味します。
Minimum subtotal：カートの小計がこの金額以上の場合にのみ、この方法を表示します。空欄にすると常に表示されます。
Excluded shipping classes：カート内のいずれかの商品が、これらの WooCommerce 配送クラスに属している場合、この方法を非表示にします。
Ignore shipping zones：配送ゾーンに追加されていなくても、以下の国に対してこの方法を提供します。
Countries：このモードでの届け先の国です。すべての国を対象にする場合は空欄のままにします。このフィールドは Ignore shipping zones がオンの場合にのみ使用されます。
送料無料
Free shipping from：この方法が無料になるカートの小計です。この場合、Mercado Envios へのリクエストは行われません。空欄にすると無効になります。
詳細設定
Debug log：API リクエストと料金計算を WooCommerce > Status > Logs（ソース：vfd-mercado-envios）に記録します。このオプションをオフにしていても、エラーは常に記録されます。アクセストークンと顧客の住所は、一切記録されません。
Remove data on uninstall：オンの場合、プラグインを削除するとプラグインのすべての設定とゾーンの配送方法が削除されます。プラグインを無効にしても、設定が削除されることはありません。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまず条件を確認します：カートの重量、最小小計、除外する配送クラスです。送料無料が適用される場合、この方法の料金は 0 になり、Mercado Envios へのリクエストは行われません。
有効な郵便番号を持つ Mercado Envios の対象国への配送の場合、プラグインはカートを 1 つの荷物として扱います。商品の中で最大の幅と長さ、すべての商品の高さの合計、そしてグラム単位の合計重量です。各辺と重量は、その国の Mercado Envios の最小値まで切り上げられるため、寸法や重量が未設定の商品にも料金が表示されます。カートの金額は、Mercado Envios の通貨での商品価格として送信されます。Mercado Envios が返した最も安いオプションは、ストアの通貨に換算され、配送方法の名前の下に表示されます。
各見積もりは 1 時間キャッシュされるため、同じカートで新しいリクエストが発生することはありません。失敗した見積もりは 5 分間再送信されません。Mercado Pago に接続できない場合、またはトークンが拒否された場合、チェックアウトが更新のたびに API を待たないよう、すべてのリアルタイム見積もりは 5 分間一時停止されます。API のタイムアウトは 10 秒です。
代わりにリアルタイム料金がない場合の価格が使用されるのは、トークンがない場合、届け先が Mercado Envios の対象国外の場合、郵便番号がないか無効な場合、為替レートがない場合、荷物がその国の Mercado Envios の重量制限（アルゼンチンは 25 kg、ブラジルは 15 kg、メキシコは 30 kg）を超える場合、または Mercado Envios がその住所に対してエラーを返す、もしくはオプションを返さない場合です。その国の行（または * の行）が使用され、なければ予備の送料が使われます。価格がない場合は、この方法は非表示になります。購入者に API エラーが表示されることはありません。
この方法は、クラシックチェックアウトとカートおよびチェックアウトのブロックの両方で動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。
プラグインが行うのは料金の計算だけです。発送の作成、ラベルの印刷、荷物の追跡は行いません。発送は Mercado Libre または Mercado Pago のアカウントで作成してください。この方法ごとに 1 つの料金を表示します。それはすべてのオプションから選ぶのではなく、最も安い Mercado Envios のオプションです。また、受け取り拠点（代理店）の選択機能はありません。
注文
リアルタイム料金で注文が行われると、サービス名と推定配送日数（日単位）が、注文の配送明細に Mercado Envios service と Estimated delivery として保存されます。既存の注文は、配送明細をそのまま保持します。
ライセンスキー
このプラグインは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Mercado Envios の上部にあります。キーを License key に貼り付けて、Activate をクリックします。ブロックには、ライセンスの有効期限などの状態と、お使いのドメインが表示されます。Check now で状態を再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクで、vibefox.net のアカウントが開きます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで購入者には Mercado Envios が表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示された状態で表示されるので、キーを購入する前にプラグインを設定してテストできます。Plugins ページと WooCommerce のページにはリマインダーが表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作を続けます。ただし、アップデートとサポートには更新が必要です。状態は、バックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Mercado Envios が表示されない：ライセンスが有効であること、Enable/Disable がオンであること、そして購入者の国のゾーンに方法が追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。設定ページ上部の警告、重量制限、Minimum subtotal、Excluded shipping classes を確認してください。この方法には価格が必要です。Mercado Envios の対象国の住所に対して有効な Access Token、または Country prices か Fallback cost のいずれかが必要です。
リアルタイム料金が表示されない：Debug log をオンにして、チェックアウトを再読み込みし、WooCommerce > Status > Logs を開いて、ソースの vfd-mercado-envios を選択してください。よくある原因は、トークンがない、届け先が Mercado Envios の対象国外、郵便番号がないか無効、Exchange rate が未設定、荷物が重量制限を超えている、またはその住所に Mercado Envios のオプションがないことです。
警告に HTTP 401 または 403 が表示される：アクセストークンが無効か、期限切れです。Mercado Pago の開発者パネルから、本番環境の Access Token をコピーし直してください。
Mercado Envios が別の通貨で応答した：アカウントの国が Mercado Envios country と一致していません。Mercado Pago アカウントの国を選択してください。
価格はどの通貨か：Country prices と Fallback cost は、ストアの通貨建てです。リアルタイム料金は Mercado Pago アカウントの通貨で届き、ストアが別の通貨を使用している場合は Exchange rate で換算されます。
変更後に料金が古いように見える：設定ページを保存してください。キャッシュされた料金がクリアされます。
ライセンスブロックにエラーが表示される：ブロック内のメッセージに従ってください。たとえば、そのキーが別のドメインで使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認された状態で動作を続けます。
アンインストール
プラグインを無効にしても、すべての設定は保持されます。消去されるのは料金のキャッシュだけです。削除するには、無効にしたうえで Plugins ページで削除してください。このプラグインのライセンスキーとライセンス状態、キャッシュされた料金、最後の API エラーは、常に削除されます。設定とゾーンの配送方法は、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後日の再インストールのために残ります。既存の注文は配送明細を保持します。
Mercado Envios と Mercado Pago は、それぞれの所有者の商標です。このプラグインは、Mercado Envios や Mercado Pago の関連会社ではなく、両社の承認も受けていません。