VibeFox Frenet for WooCommerce — ヘルプ
要件
WordPress：5.8 以降。
WooCommerce：5.0 以降。インストール済みで有効であること。WooCommerce がないとプラグインを有効化できません。
PHP：8.0 以降。
Frenet アカウント（リアルタイム見積もりのみ必要）：Frenet パネル（painel.frenet.com.br）で無料アカウントを作成し、使用する配送業者を有効にして、API トークンをコピーしてください。固定料金のみを使う場合、Frenet アカウントは不要です。
商品：正確な料金のために重量と寸法を入力してください。入力されていない商品は 0.3 kg、16 × 11 × 2 cm として見積もられます（Correios の最小箱）。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_frenet フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox Frenet。または、プラグインページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. API トークンを貼り付け、発送元の CEP を入力します。ストアの通貨が BRL でない場合は、BRL の為替レートを入力します。必要に応じて固定料金と代替送料を追加します。
6. WooCommerce > Settings > Shipping > Shipping zones で、ブラジル向けの配送ゾーンに VibeFox Frenet を追加するか、Ignore shipping zones をオンにして国を選択します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox Frenet。設定はすべての配送ゾーンに適用されます。配送ゾーンに方法を追加すると、ゾーンのウィンドウにはフィールドが 1 つだけ表示されます：
Title (zone)：このゾーンでお客様に表示される名前。空欄にすると、全体の Method title を使用します。
ページ上部には、次のような警告が表示されます：API トークンがない（固定料金のみ使用、固定料金もない場合は方法が表示されない）、8 桁の発送元 CEP がない、またはストアの通貨が BRL で為替レートが未入力。設定を保存するたびに、キャッシュされた見積もりは消去されます。料金欄では、小数点としてピリオドとカンマのどちらも使用できます。
一般
Enable/Disable：すべてのゾーンでこの方法を一度にオフ／オンにします。デフォルト：on。
Method title：カートとチェックアウトに表示される配送方法の名前。ゾーンごとに上書きできます。デフォルト：Frenet。
Frenet のリアルタイム見積もり
Frenet は、Frenet アカウントで有効な配送業者を比較し、カートの料金を返します。リアルタイム見積もりは、8 桁の完全な CEP があるブラジル国内の住所に対してのみ要求されます。
API token：Frenet パネルの Frenet API トークン。固定料金のみを使う場合は空欄にします。
Origin CEP：荷物を発送する郵便番号（CEP）。例：00000-000。ストアの住所がブラジルにある場合は、空欄にするとストアの郵便番号を使用します。8 桁でない CEP は保存時に通知されます。
Service to offer：Cheapest service（デフォルト）または Fastest service。Frenet は複数のサービスを返しますが、この方法は料金を 1 つだけ表示します。
BRL exchange rate：Frenet はブラジルレアル建てで見積もります。ストアの通貨が BRL でない場合は、1 BRL がストアの通貨でいくらかを入力してください。例：0.16。見積もりと申告された注文金額はこのレートで換算されます。これがないとリアルタイム見積もりは使用されません。ストアの通貨が BRL の場合は不要です。
固定料金
API トークンがない場合、Frenet が配送していない国の場合、および Frenet が料金を返さない場合（API が利用不可、CEP が対象外）に使用されます。
Price per country：Country、Price、XS、S、M、L、XL の列を持つ表で、料金はストアの通貨建てです。+ Add country をクリックして行を追加し、×印をクリックして削除します。サイズ列はカートの重量によって異なります：XS は 1 kg まで、S は 2 kg まで、M は 3 kg まで、L は 5 kg まで、XL は 5 kg 超。サイズ列が空の場合は Price を使用します。Price が 0 の場合、その国は送料無料です。他のすべての国には * Default を使用します。料金が 1 つもない行は保存時に削除されます。
Fallback cost：Frenet も表も料金を提供しない場合に使用されます。方法を非表示にするには空欄にします。
Fixed price applies：Per order は料金を 1 回だけ請求します。Per item (price × quantity) は料金に商品数を掛けます。これは固定料金と代替送料にのみ適用されます。Frenet の見積もりはすでにカート全体をカバーしています。
条件
Minimum weight (kg)：カートの重量がこの値未満の場合、方法を非表示にします。0 は制限なしを意味します。
Maximum weight (kg)：カートの重量がこの値を超える場合、方法を非表示にします。デフォルト：30。0 は制限なしを意味します。
Minimum order amount：カートの小計（割引後、税抜き）がこの金額以上の場合のみ方法を表示します。空欄にすると常に表示されます。
Excluded shipping classes：カートにこれらの WooCommerce 配送クラスのいずれかの商品が含まれる場合、方法を非表示にします。
Free shipping from：カートの小計（割引後、税抜き）がこの金額以上で送料無料になります。空欄にすると送料無料は提供されません。
Tax status：Taxable は WooCommerce の税金を送料に加算します。None は加算しません。Frenet の料金は配送業者の最終料金です。WooCommerce で税金を加算させたくない場合は None を選択してください。
商品の重量は、ストアの単位から kg に変換されます。
配送ゾーンを使わない場合の提供範囲
Ignore shipping zones：配送ゾーンに Frenet を追加していなくても、下記の国に対して Frenet を提供します。
Countries：このモードの配送先の国。空欄にすると、配送可能なすべての国を使用します。Ignore shipping zones がオンの場合にのみ使用されます。
詳細設定
Debug log：すべての見積もりリクエストとレスポンスを WooCommerce > Status > Logs に記録します。ソースは vfd-frenet です。API エラーは常に記録されます。トークンは決して記録されず、お客様の CEP は短縮されます。作業が終わったらオフにしてください。
Remove data on uninstall：オンの場合、プラグインを削除すると Frenet のすべての設定と配送ゾーンの方法が削除されます。プラグインを無効化しても設定が削除されることはありません。キャッシュされた見積もりは常に削除されます。
チェックアウト時の動作
お客様が配送先住所を入力すると、WooCommerce がプラグインに料金を問い合わせます。プラグインはまずカートの重量、最低注文金額、除外する配送クラスを確認します。送料無料が適用される場合は、料金ゼロで方法が表示され、Frenet へのリクエストは送信されません。
8 桁の完全な CEP があるブラジルの住所の場合、プラグインは Frenet に発送元と配送先の CEP、カート内の各商品（重量（kg）、寸法（cm）、数量、SKU、カテゴリ）、BRL 建ての注文金額、そして最初に適用されたクーポンを送信します。CEP が未入力の間はリクエストを行いません。Frenet は有効な配送業者のサービスを返します。エラーがあるサービスや料金のないサービスはスキップされます。プラグインは最安または最速のサービスを選び、料金をストアの通貨に換算します。配送業者、サービス、配送日数は注文の配送行とともに保存され、管理画面の注文ページに表示されます。
同じカートと住所に対する各レスポンスは 1 時間キャッシュされます。失敗したリクエスト、または有効な配送業者がどれも対応していない CEP は 10 分間記憶されます。API のタイムアウトは 10 秒です。こうした場合でも、お客様にエラーは表示されません。固定料金または代替送料が使用され、どちらもない場合は方法が非表示になります。ブラジル以外の住所には、固定料金のみが使用されます。
この方法は、クラシックチェックアウトとカートおよびチェックアウトのブロックで動作します。WooCommerce の High-Performance Order Storage（HPOS）に対応しています。
プラグインが行うのは料金の計算だけです。送り状の作成、ラベルの印刷、荷物の追跡は行いません。これらは Frenet が自身のパネルで提供します。カートごとに表示されるのは Frenet のサービス 1 つだけで、複数は表示されません。また、受け取りポイントやロッカーには対応していません。Frenet の見積もりはブラジル国内のみです。他の国では固定料金を使用してください。
ライセンスキー
プラグインは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Frenet の上部にあります。License key にキーを貼り付けて、Activate をクリックします。ブロックにはステータス（例：ライセンスの有効期限の日付）と、お使いのドメインが表示されます。Check now でステータスを再確認、Change key で別のキーを入力、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがないと、Frenet はチェックアウトでお客様に表示されません。ログインしているストア管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインの設定とテストができます。プラグインページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。
ライセンスの期限が切れてもプラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスは自動的にバックグラウンドで再確認されます。
トラブルシューティング
Frenet がチェックアウトに表示されない：ライセンスが有効か、Enable/Disable がオンか、お客様の国のゾーンに方法が追加されているか（または Ignore shipping zones がオンで、その国が許可されているか）を確認してください。設定ページ上部の警告、重量の制限、Minimum order amount、Excluded shipping classes を確認します。よくある原因：お客様がまだ 8 桁の完全な CEP を入力しておらず固定料金もない、または Frenet がそのルートのサービスを返さず固定料金もない。
リアルタイム見積もりが表示されない：Debug log をオンにして、チェックアウトを再読み込みし、WooCommerce > Status > Logs を開いてソース vfd-frenet を選択してください。理由が表示されます：トークンの拒否（HTTP 401 または 403）、発送元 CEP がない、BRL の為替レートがない、Frenet パネルで配送業者が有効になっていない、またはスキップされたサービスのメッセージ。
ストアがユーロまたはドルで販売している：Frenet は BRL で応答します。BRL exchange rate（1 BRL がストアの通貨でいくらか）を入力してください。
変更後に料金が古いように見える：設定ページを保存してください。キャッシュされた見積もりが消去されます。
ライセンスブロックにエラーが表示される：ブロック内のメッセージに従ってください。たとえば、そのキーが別のドメインで使用中の場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックします。サイトのアドレスを変更した場合は、Check now をクリックして新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべての設定は保持され、キャッシュされた見積もりだけが消去されます。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータス、キャッシュされた見積もり、古いログファイルは必ず削除されます。設定とゾーンの方法は、Remove data on uninstall がオンだった場合にのみ削除されます。そうでない場合は、後で再インストールするために残ります。既存の注文は、Frenet 配送業者の配送行を保持します。
Frenet は各所有者の商標です。このプラグインは Frenet と提携しておらず、Frenet による承認もありません。