VibeFox Envioclick for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 5.0 以降、インストールされ有効であること。WooCommerce がないとプラグインは有効化されません。
PHP: 8.0 以降。
Envioclick アカウント（リアルタイムの料金の場合のみ）: API アクセスのあるメキシコまたはコロンビアの Envioclick アカウント。API キーは Envioclick アカウントの Mi cuenta（右上）> Información del API にあります。固定料金のみを使用する場合、Envioclick アカウントは不要です。
User-Agent（メキシコのみ）: Envioclick Mexico では、API リクエストごとに User-Agent の値が必要です。Envioclick サポートに問い合わせてください（soporte.tecnico@envioclick.com）。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_envioclick フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox Envioclick。または、Plugins ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. API キーを入力し、API の国を選択し、User-Agent（メキシコ）、発送元の郵便番号または DANE コード、発送元の住所を入力します。ストアの通貨が MXN または COP でない場合は、為替レートを入力します。
6. 任意：国別の固定料金とフォールバック料金を追加します。
7. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーンに VibeFox Envioclick を追加します。または Ignore shipping zones をオンにして国を選択します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox Envioclick。設定はすべての配送ゾーンに適用されます。配送方法をゾーンに追加すると、ゾーンのウィンドウには 1 つの項目だけが表示されます：
Title (zone): このゾーンで購入者に表示される名前。空欄にすると、全体の Method title を使用します。
API キーが設定されている場合、リアルタイムの料金が機能しないと、プラグインはページ上部に警告を表示します：MXN または COP 以外のストア通貨に為替レートがない、メキシコの User-Agent がない、発送元の郵便番号または DANE コードがない、またはコロンビアの発送元住所がない場合です。設定を保存するたびに、キャッシュされた見積もりは消去されます。数値フィールドは、小数点としてピリオドとカンマの両方を受け付けます。
一般
Enable/Disable: すべてのゾーンで一度にこの配送方法を有効または無効にします。デフォルト：オン。
Method title: カートとチェックアウトに表示される配送方法の名前。ゾーンごとに上書きできます。デフォルト：Envioclick Shipping。
Carrier in the title: リアルタイムの料金の場合、タイトルの横に配送業者と推定配達日数を表示します。例：「Envioclick Shipping (Estafeta Express, 1 day)」。この設定に関係なく、配送業者は注文に保存され、注文メールに表示されます。デフォルト：オン。
Envioclick API（リアルタイムの料金）
任意です。API キーがない場合は、固定料金のみが使用されます。リアルタイムの料金は、API の国の配送先に対してのみ要求されます。他の国への配送には固定料金が使用されます。
API key: Envioclick アカウントの Mi cuenta > Información del API にある API キー。
API country: Envioclick アカウントの国。
User-Agent (Mexico): Envioclick サポートから発行された値（soporte.tecnico@envioclick.com）。メキシコでは必須で、これがないとメキシコのリアルタイムの料金は要求されません。コロンビアでは任意です。
Carrier choice: Cheapest（デフォルト）または Fastest (then cheapest)。Envioclick は複数の配送業者から見積もりを返し、購入者は 1 つの料金を受け取ります。
Branch pickup rates: 「Ocurre」の料金も考慮します。これは、購入者が配送業者の営業所で荷物を受け取る場合の料金です。オフの場合は、自宅への配送料金のみが使用されます。代金引換（COD）サービスは使用しません。デフォルト：オフ。
Currency conversion rate: Envioclick は MXN（メキシコ）または COP（コロンビア）で見積もります。ストアの通貨が異なる場合は、1 MXN または 1 COP の価値をストアの通貨で入力します（例：0.05）。申告された荷物の価値も同様に換算されます。ストアの通貨が MXN または COP の場合は空欄にします。設定しない場合、他の通貨ではリアルタイムの料金は使用されません。
発送元
リアルタイムの料金に使用されます。ストアが API の国にある場合、空欄は WooCommerce > Settings > General のストアの住所から補われます。
Origin postcode / DANE code: メキシコ：5 桁の郵便番号。コロンビア：自治体の 8 桁の DANE コード（例：ボゴタは 11001000）。
Origin address: 集荷先住所の番地と丁目。コロンビアでは必須、メキシコでは任意です。
固定料金
リアルタイムの料金がない場合に使用されます：API キーがない、配送先が API の国以外、API エラー、またはそのルートの配送業者がない場合。
Price per country: ストアの通貨による国と料金の表。+ Add country をクリックして行を追加し、× をクリックして削除します。* Default 行は、独自の行がないすべての国に適用されます。
Fallback cost: リアルタイムの料金がなく、表のどの行も一致しない場合に使用されます。空欄にすると、その場合は配送方法が非表示になります。
Fixed price applies: Per order は料金を 1 回だけ請求します。Per item (price × quantity) は、カート内の商品数を掛けて請求します。Envioclick のリアルタイムの料金は常に出荷ごとです。
条件
Minimum weight (kg): カートの重量がこの値未満の場合、配送方法を非表示にします。0 は制限なしを意味します。
Maximum weight (kg): カートの重量がこの値を超える場合、配送方法を非表示にします。デフォルト：25。0 は制限なしを意味します。
Minimum order amount: カートの小計（割引後、税抜き）がこの金額以上の場合にのみ配送方法を表示します。常に表示するには空欄にします。
Free shipping from: カートの小計（割引後、税抜き）がこの金額に達すると送料無料になります。この場合、API へのリクエストは行われません。送料無料を一切提供しない場合は空欄にします。
Excluded shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、配送方法を非表示にします。
Tax status: Taxable は WooCommerce の税金を送料に加算し、None は加算しません。Envioclick の見積もりには配送業者の税金がすでに含まれているため、送料に二重に税金がかからないように None を選択してください。
配送ゾーンを使わない場合の利用可否
Ignore shipping zones: Envioclick が配送ゾーンに追加されていなくても、下記の国に対して提供します。
Countries: このモードの配送先の国。空欄にすると、配送しているすべての国が使用されます。Ignore shipping zones がオンの場合にのみ使用されます。
詳細設定
Debug log: 料金計算と API エラーを WooCommerce > Status > Logs に、ソース vfd_envioclick として記録します。API キーと購入者の住所は記録されません。作業が終わったらオフにしてください。
Remove data on uninstall: オンの場合、プラグインを削除すると、すべての Envioclick 設定、ゾーンの配送方法、キャッシュされた見積もりが削除されます。プラグインを無効化しても、設定は削除されません。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を要求します。プラグインは最初に、カートの重量、最低注文金額、除外される配送クラスを確認します。送料無料が適用される場合、配送方法は 0 円で表示され、Envioclick へのリクエストは送信されません。
API キーが設定されていて、配送先が API の国にある場合、プラグインは Envioclick に見積もりを要求します。メキシコでは、購入者が 5 桁の郵便番号を入力すると要求されます。コロンビアでは、県と自治体が認識されると要求されます（大文字小文字やアクセント記号は区別されず、「Bogotá D.C.」も使用できます）。プラグインは、代金引換ではない最安または最速の自宅配送の見積もりを選び、それをストアの通貨に換算します。
荷物は常に 1 箱として扱われます。合計重量を kg に換算し、最も大きな商品の縦と横の長さを使い、高さはすべての商品の合計容積を収めるように決定します。寸法のない商品は 10 × 10 × 10 cm として数えます。重量のないカートは 0.5 kg として送られます。申告価値はカートの小計です。
同じルートと荷物に対する各見積もりは 1 時間キャッシュされます。失敗したリクエストは 10 分間キャッシュされるため、利用できない API がチェックアウトの更新のたびに遅くなることはありません。API のタイムアウトは 10 秒です。Envioclick がエラーを返す場合、またはそのルートの配送業者がない場合、購入者にエラーは表示されません。固定料金が使用されるか、配送方法が非表示になります。理由はデバッグログに記録されます。
この配送方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックの両方で動作します。WooCommerce の High-Performance Order Storage（HPOS）に対応しています。
プラグインが行うのは料金の計算のみです。送り状やラベルの作成、集荷の依頼、配送状況の追跡やキャンセルは行いません。配送業者の選択肢ではなく料金を 1 つ提示し、代金引換サービス、追加の保険、複数荷物の見積もりは使用しません。リアルタイムの見積もりは国内のみです。
注文
Envioclick のリアルタイムの料金で注文が行われると、配送業者とサービスが注文に保存されます。管理画面の注文画面では、配送先住所の下に推定配達日数と一緒に Envioclick carrier が表示されます。購入者の注文ページと注文メール（HTML とプレーンテキスト）には Shipping carrier が表示されます。見積もりの Envioclick 料金 ID は、注文の配送行に非表示データとして保存されます。注文画面には表示されません。送り状は Envioclick アカウントで作成してください。
固定料金で行われた注文には、配送業者はありません。
ライセンスキー
このプラグインは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Envioclick のページ上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ライセンスの有効期限日やお使いのドメインなど、ステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。リンク Manage licenses and domains in your account をクリックすると、vibefox.net のアカウントが開きます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、Envioclick はチェックアウトで購入者に表示されません。ログイン中のストア管理者には表示されますが、(unlicensed — visible to admins only) と表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れてもプラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Envioclick が表示されない: ライセンスが有効か、Enable/Disable がオンか、配送方法が購入者の国のゾーンに追加されているか（または Ignore shipping zones がオンで、その国が許可されているか）を確認してください。重量の制限、Minimum order amount、Excluded shipping classes も確認します。リアルタイムの料金がない場合、配送方法にはその国の固定料金、* Default 行、または Fallback cost が必要です。
リアルタイムの料金が表示されない: 設定ページ上部の警告を確認し、Debug log をオンにして、チェックアウトを再読み込みし、WooCommerce > Status > Logs を開いて、ソース vfd_envioclick を確認してください。よくある原因：為替レートがない（ストアの通貨が MXN または COP ではない）、User-Agent がない（メキシコ）、発送元の郵便番号または DANE コードがない、購入者の郵便番号（メキシコ）または市区町村（コロンビア）がまだ入力されていない、配送先が API の国の外にある、またはそのルートの配送業者がない。
なぜ為替レートが必要なのですか？ Envioclick はメキシコ・ペソまたはコロンビア・ペソでのみ料金を返します。プラグインは、ペソの金額を別の通貨として表示することはありません。
コロンビア：市区町村が認識されない: 購入者は県を選択し、自治体名を入力する必要があります。郵便番号欄に入力された 8 桁の DANE コードも使用できます。開発者は vfd_evc_dane_code フィルターで DANE コードを指定できます。
配送料に税金が二重にかかる: Envioclick の見積もりには、配送業者の税金がすでに含まれています。Tax status を None に設定してください。
変更後に料金が古く見える: 設定ページを保存してください。これにより、キャッシュされた見積もりが消去されます。
開発者向けフィルター: vfd_evc_quotation_request（リクエスト本文）、vfd_evc_api_url、vfd_evc_dane_code、vfd_evc_default_dimensions、vfd_evc_package_description。
ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。例えば、そのキーが別のドメインで使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合は、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべての設定とゾーンの配送方法は保持され、キャッシュされた見積もりのみが消去されます。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。設定、ゾーンの配送方法、キャッシュされた見積もりは、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。過去の注文で保存された配送業者は保持され、既存の注文は配送行を保持します。
Envioclick は、その所有者の商標です。このプラグインは Envioclick と提携しておらず、Envioclick による承認も受けていません。