VibeFox Estafeta for WooCommerce — ヘルプ
要件
WordPress：5.8 以降。
WooCommerce：7.0 以降、インストールされ有効化されていること。WooCommerce がない場合、プラグインは有効化できません。
PHP：8.0 以降。
DrEnvio アカウント（リアルタイム料金を使う場合のみ）：Estafeta のリアルタイム料金は、メキシコにおける Estafeta のパートナーである DrEnvio から提供されます。drenvio.com でアカウントを作成し、Estafeta を有効にして、そこで集荷先住所を設定してから、DrEnvio の管理パネルから API キーをコピーしてください。これは公式の DrEnvio プラグインが使用するものと同じキーです。独自の料金のみを使用する場合、DrEnvio アカウントは不要です。
商品：リアルタイム料金には、商品に重量が必要です。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_estafeta フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox Estafeta。または、プラグインの一覧画面でプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. DrEnvio の API キーと、必要に応じて発送元の郵便番号を入力します。ストアの通貨が MXN でない場合は、MXN exchange rate を入力します。DrEnvio から料金が返されない場合も配送方法を表示させたいときは、MX の国ごとの料金またはフォールバック料金を設定します。
6. WooCommerce > Settings > Shipping > Shipping zones で、メキシコのゾーンに VibeFox Estafeta を追加します。または、Ignore shipping zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox Estafeta。設定はすべての配送ゾーンに適用されます。配送方法をゾーンに追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます：
Title (zone)：チェックアウト時のこのオプションの名称。空欄にすると、全体の Name が使用されます。
ページの上部には、プラグインからの警告が表示されます。DrEnvio の API キーがない場合、ストアの通貨が MXN 以外で為替レートがない場合、または MX の国ごとの料金もフォールバック料金もない場合です（この場合、リアルタイム料金がないと配送方法は非表示になります）。設定を保存するたびに、キャッシュされた DrEnvio の料金は消去されます。数値の項目では、小数点またはカンマを入力できます。有効な数値でない値は、保存時に消去され、通知されます。
一般
Enable/Disable：すべてのゾーンで Estafeta の配送を一括で有効または無効にします。既定値：オン。
Name：チェックアウト時に購入者に表示される配送方法の名称。既定値：Estafeta。
Tax status：Taxable を選ぶと、WooCommerce が配送料に税金を加算します。None を選ぶと加算しません。DrEnvio の料金に IVA が含まれるかどうかは、DrEnvio アカウントによって異なります。すでに IVA が含まれている場合は、None を選択してください。既定値：Taxable。
リアルタイム料金（DrEnvio API）
その住所に対して最も安い Estafeta サービスが提示されます。キーがない場合は、次のセクションの料金が使用されます。
DrEnvio API key：DrEnvio の管理パネルにある API キー。
Origin country：集荷先住所の 2 文字の国コード。既定値：MX。発送元の郵便番号と一緒に送信される場合にのみ使用されます。
Origin postcode：集荷先住所の 5 桁の郵便番号。空欄にすると、DrEnvio アカウントに保存された発送元住所が使用されます。5 桁でない郵便番号は、保存時に消去されます。
MXN exchange rate：DrEnvio はメキシコペソで見積もりを提示します。ストアの通貨が MXN でない場合にのみ必要です。1 MXN がストアの通貨でいくらに相当するかを入力します（例：0.05）。入力しない場合、リアルタイム料金は使用されません。
リアルタイム料金がない場合の料金
API キーがない場合、または DrEnvio から Estafeta の料金が返されない場合（API が利用できない、郵便番号が不明、郵便番号がまだ入力されていない）に使用されます。料金はストアの通貨で表示されます。
Country prices：1 行に 1 つの配送先国を、CC:PRICE の形式で入力します（例：MX:150）。小数点またはカンマを使用し、桁区切り記号は使用しないでください。別の形式の部分は無視され、保存時に通知されます。
Fallback cost：リアルタイム料金も国ごとの料金もない場合の料金。空欄にすると配送方法は非表示になります。0 は送料無料を意味します。
Calculation type：Per order は料金を 1 回だけ請求します。Per item (price x number of items) は、発送可能な商品数を掛けた金額を請求します。これは Country prices と Fallback cost に適用されます。DrEnvio のリアルタイム料金は常に荷物全体の料金です。
条件
Free shipping from：カートの小計がこの金額に達すると、送料は無料になります。この場合、DrEnvio へのリクエストは行われません。空欄にすると、送料無料は提供されません。
Minimum subtotal：カートの小計がこの金額以上の場合にのみ、配送方法を表示します。空欄にすると、常に表示されます。
Min weight (kg)：配送方法が表示されるために必要なカートの最小重量。0 は制限なしを意味します。
Max weight (kg)：カートの最大重量。超えた場合、配送方法は非表示になります。既定値：30。0 は制限なしを意味します。
Excluded shipping classes：カート内の商品がこれらの WooCommerce の配送クラスのいずれかに属している場合、配送方法は非表示になります。
商品の重量は、ストアの単位から kg に換算されます。
配送ゾーンを使わない場合の提供条件
Ignore shipping zones：配送方法を配送ゾーンに追加していない場合でも、以下の国に対して配送方法を提供します。
Countries：このモードで対象とする配送先の国。空欄にすると、すべての国が対象になります。Ignore shipping zones がオンの場合にのみ使用されます。
詳細設定
Debug log：API リクエストと料金の計算を、WooCommerce > Status > Logs に、ソース vfd-estafeta で記録します。API のエラーは常に記録されます。API キーと顧客の住所は記録されません。
Remove data on uninstall：オンにすると、プラグインを削除したときに、プラグインのすべての設定とゾーンの配送方法が削除されます。プラグインを無効化しても、何も削除されません。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce がプラグインに料金を問い合わせます。プラグインはまず、カートの重量、最低小計、除外される配送クラスを確認します。送料無料が適用される場合は、料金ゼロで配送方法が表示され、DrEnvio へのリクエストは行われません。
それ以外の場合、プラグインは配送先の国と郵便番号、カートの重量、商品数、小計を DrEnvio に送信します。発送元の郵便番号を設定している場合は、それも送信されます。メキシコの郵便番号は 5 桁である必要があります。購入者が郵便番号を入力するまで、リクエストは行われません。DrEnvio は、アカウントのすべての運送会社の見積もりを返します。プラグインは Estafeta の見積もりのみを使用し、料金がゼロのものは無視して、最も安いものを選び、ストアの通貨に換算します。Estafeta のサービスと配送日数は、注文の配送行とともに保存され、管理画面の注文画面に表示されます。
各応答は 1 時間キャッシュされます。失敗したリクエストや、Estafeta の料金がないルートは 5 分間記録され、API の応答が遅い場合や不具合がある場合でも、チェックアウトの更新のたびに処理が止まることはありません。API のタイムアウトは 12 秒です。これらの場合、購入者にエラーは表示されません。国ごとの料金またはフォールバック料金が使用されます。どちらも設定されていない場合は、配送方法が非表示になります。
この配送方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックの両方で動作します。WooCommerce の High-Performance Order Storage（HPOS）に対応しています。
プラグインが行うのは料金の計算のみです。発送の作成、ラベル（guías）の印刷、荷物の追跡は行いません。発送は DrEnvio または Estafeta のアカウントで作成してください。購入者は特定の Estafeta サービスや Estafeta の営業所を選ぶことはできず、為替レートは自動では更新されません。
ライセンスキー
このプラグインは、vibefox.net から取得した VibeFox ライセンスキーで動作します。ライセンスブロックは、WooCommerce > Settings > Shipping > VibeFox Estafeta の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ステータス（例：ライセンスの有効期限日）と、あなたのドメインが表示されます。Check now を使うとステータスを再確認でき、Change key を使うと別のキーを入力でき、Remove key を使うとこのサイトからキーを削除できます。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、Estafeta はチェックアウト時に顧客には表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインの設定とテストを行えます。プラグインの一覧画面と WooCommerce の各ページには、通知が表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れた場合も、プラグインは動作し続けますが、アップデートとサポートを利用するには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Estafeta が表示されない：ライセンスが有効であること、Enable/Disable がオンであること、配送方法が顧客の国のゾーンに追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。設定ページ上部の通知、重量の制限、Minimum subtotal、Excluded shipping classes も確認します。API キーがない場合、または DrEnvio から Estafeta の料金が返されない場合は、配送先の国ごとの料金またはフォールバック料金が必要です。
リアルタイム料金が表示されない：Debug log をオンにし、チェックアウトを再読み込みしてから、WooCommerce > Status > Logs をソース vfd-estafeta で開いてください。原因が表示されます。API キーがない、MXN 以外のストアの為替レートがない、郵便番号がない、または無効、API キーが拒否された（HTTP 401 または 403）、またはそのルートに Estafeta の料金がない、などです。
料金に IVA は含まれていますか？これは DrEnvio アカウントによって異なります。DrEnvio の料金にすでに IVA が含まれている場合は、Tax status を None に設定してください。
変更後も料金が古いようです：設定ページを保存してください。これにより、キャッシュされた DrEnvio の料金が消去されます。
ライセンスブロックにエラーが表示される：ブロック内のメッセージに従ってください。たとえば、そのキーが別のドメインで既に使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できた状態で動作を続けます。
アンインストール
プラグインを無効化すると、すべての設定は保持され、料金のキャッシュのみが消去されます。削除するには、プラグインを無効化してから、Plugins ページで削除してください。このプラグインのライセンスキーとライセンスのステータス、キャッシュされた料金、古いログファイルは、常に削除されます。設定とゾーンの配送方法は、Remove data on uninstall がオンになっていた場合にのみ削除されます。それ以外の場合は、後日再インストールする際のために残ります。注文には一切触れず、既存の注文は配送行をそのまま保持します。
Estafeta と DrEnvio は、それぞれの所有者の商標です。このプラグインは、Estafeta または DrEnvio と提携しておらず、両社の承認も受けていません。