VibeFox Econt for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 7.0 以降、インストールされて有効になっていること。WooCommerce がないとプラグインは有効化できません。
PHP: 8.0 以降。
Econt: Econt の契約や API キーは不要です。営業所一覧は Econt の公開データです。Econt に送信されるのは国コードのみで、購入者のデータは送信されません。Econt からサイトの認証を求められた場合にのみ、e-Econt のユーザー名とパスワードを入力してください。e-Econt へのログインについては、Econt の開発者向けページ（econt.com/developers）に記載があります。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_econt フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます。WooCommerce > Settings > Shipping > VibeFox Econt、またはプラグインの一覧ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. 国ごとの料金を設定し、他のオプションを確認します（設定の項を参照）。Load offices from Econt now をクリックして接続をテストします。
6. WooCommerce > Settings > Shipping > Shipping zones で、ブルガリアやルーマニアを含む配送ゾーンに VibeFox Econt を追加するか、Ignore zones を有効にして国を選びます。
設定
すべての設定は 1 つのページにあります。WooCommerce > Settings > Shipping > VibeFox Econt です。料金と条件はすべての配送ゾーンに適用されます。ゾーンにこの方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます。
Title (zone): このゾーンで購入者に表示される名称です。空欄にすると、全体の Name が使用されます。
ページ上部には、プラグインからの警告が表示されることがあります。デモ API が有効になっている、ブルガリアまたはルーマニアの料金が未設定である（この場合、この方法は表示されません）、または特定の国の最後の営業所リクエストが失敗した、といった内容です。数値の項目では小数点としてカンマを使用できます（例: 5,99）。数値でない値は無視され、保存時に通知されます。
全般
Enable/Disable: すべてのゾーンで Econt 配送を一度に有効または無効にします。既定値: 有効。
Name: チェックアウトに表示される配送方法の名称です。ゾーンで設定された Title があれば、それが優先されます。既定値: Econt Express。
Tax status: Taxable は送料に WooCommerce の税金を加えます。None は加えません。既定値: Taxable。
Econt 営業所一覧
営業所と Econtomat は Econt API から読み込まれ、24 時間キャッシュされます。
Demo API: テストデータを含む Econt のデモ API を使用します。本番のストアでは無効のままにしてください。デモの営業所の ID は実際の営業所と異なります。デモモードでは、ログインが設定されていない場合、Econt の公開テストアカウントが使用されます。
Econt username: 任意です。HTTP Basic 認証に使用する e-Econt のユーザー名です。
Econt password: 任意です。WordPress のデータベースに保存され、ログに書き込まれることはありません。
Office list: 国ごとにキャッシュされている営業所の数と、読み込み時刻を表示します。Load offices from Econt now ボタンを押すと、一覧をすぐに再読み込みして結果を表示します。読み込みに失敗した場合は、直近の成功時の営業所が保持されます。このボタンがなくても、一覧は最初のチェックアウト時に自動的に読み込まれます。Demo API、ユーザー名、またはパスワードを変更すると、キャッシュされた一覧は消去されます。
チェックアウトの営業所セレクター
Show: 購入者が選択できる拠点です。
City order: 大都市（ソフィア、プロヴディフ、ヴァルナ、ブカレストなど）を先頭に表示します。オフの場合、都市はアルファベット順に並びます。既定値: 有効。
City list width: クラシックチェックアウトでの都市一覧の CSS 幅です（例: 100% または 300px）。既定値: 100%。
Office list width: クラシックチェックアウトでの営業所一覧の CSS 幅です（例: 100% または 400px）。既定値: 100%。
料金（ストアの通貨で）
本プラグインは、料金を Econt にリアルタイムで問い合わせません。ブルガリアは 2026 年 1 月 1 日からユーロを使用しているため、ブルガリアのストアでは通常ユーロで料金を入力します。
Price per country: 1 行に 1 つの国を記入します（またはカンマ区切り）。国コード、コロン、料金の順に記入します（例: BG:5.99 と RO:8.99。これは既定値です）。小数点にカンマを使うこともできます（例: BG:5,99）。料金が 0 の場合は送料無料になります。別の形式の入力は無視され、保存時にエラーメッセージに一覧表示されます。
Calculation: Per order は料金を 1 回だけ請求します。Per item (price x quantity) は、カート内の配送対象商品の数を掛けた料金を請求します。
Price for other countries: 上に記載されていない Econt の国（ブルガリアまたはルーマニア）に使用されます。空欄または 0 の場合、その国では方法が非表示になります。
条件
Free shipping from: この金額以上のカート小計で送料が無料になります。空欄にすると、送料無料は提供されません。
Minimum subtotal: カートの小計がこの金額以上の場合にのみ、この方法を表示します。空欄にすると、常に表示されます。
Minimum weight (kg): より軽いカートではこの方法を非表示にします。商品の重量は、ストアの単位から kg に換算されます。空欄にすると制限はありません。
Maximum weight (kg): より重いカートではこの方法を非表示にします。空欄にすると制限はありません。
Hide for shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、この方法を非表示にします。
配送ゾーンなしでの提供
Ignore zones: どのゾーンにも Econt が追加されていない場合でも、下記の国に Econt を提供します。この方法を含むゾーンは、これまでどおり動作します。
Countries: ブルガリアおよび／またはルーマニア。Ignore zones と併用する場合にのみ使用されます。空欄にすると、ストアが配送する Econt のすべての国が対象になります。
詳細設定
Debug log: デバッグメッセージを WooCommerce > Status > Logs に書き込みます。ソースは vfd-econt です。API エラーは常に記録されます。パスワードや購入者データは書き込まれません。
Remove data on uninstall: 有効にすると、プラグインを削除したときに Econt の設定とゾーンの配送方法が削除されます。プラグインを無効にしても、設定が削除されることはありません。注文に保存された営業所は、常に保持されます。
チェックアウトでの動作
この方法はブルガリアとルーマニアにのみ提供されます。購入者が配送先住所を入力すると、プラグインはカートの重量、最低小計、非表示の配送クラスを確認し、その国の料金を取得します。カートの小計が Free shipping from に達していれば、料金は 0 になります。その国で利用可能な営業所一覧がない場合、配送は常に営業所で行われるため、この方法は非表示になります。
購入者が Econt を選択すると、配送方法の下に 2 つのリストが表示されます。City と Office / Econtomat です。営業所一覧はページごとに 1 回だけ読み込まれます。Econtomat には一覧で目印が付きます。選択内容はセッション中保持されます。営業所一覧を読み込めない場合、購入者には数分後にもう一度試すか、別の配送方法を選ぶよう求めるメッセージが表示されます。
購入者は、営業所を選ばなければ注文できません。サーバー側では、プラグインが配送先の国の Econt 一覧にその営業所が存在することを再度確認します。営業所名は必ず Econt の一覧から取得され、ブラウザからは取得されません。これはクラシックチェックアウトとチェックアウトブロックの両方で動作します。本プラグインは WooCommerce の高性能注文保存（HPOS）に対応しています。
営業所一覧は 24 時間キャッシュされます。Econt に接続できない場合は、直近の正常な一覧が使用され、10 分間は Econt への再問い合わせも行われません。API のタイムアウトは 15 秒です。
本プラグインは固定料金のみを使用します。Econt にリアルタイムの料金を問い合わせることも、送り状やラベルを作成することも、集荷を手配することも、荷物を追跡することも、代金引換を扱うことも、住所への配送を行うこともありません。営業所一覧があるのは、ブルガリアとルーマニアのみです。
受け取り拠点
選択された営業所は、都市、営業所名と住所、Econt 営業所コードとともに注文に保存されます。e-Econt で発送を作成するときは、営業所コードを使用してください。
管理者の注文画面: 営業所と営業所コードは、配送先住所の下に表示されます。Change をクリックすると営業所一覧が読み込まれ、別の都市と営業所を選べます。変更はすぐに保存され、注文メモに変更前と変更後の営業所が記録されます。
購入者: 営業所は、購入者の注文ページ、注文完了ページ、注文メール（HTML とプレーンテキスト）に表示されます。
営業所名は、サイトの言語がブルガリア語またはルーマニア語の場合は現地語（ブルガリアではキリル文字）で表示され、それ以外の場合は英語で表示されます。
ライセンスキー
本プラグインは、vibefox.net で取得した VibeFox ライセンスキーを使用します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Econt の上部にあります。License key にキーを貼り付け、Activate をクリックします。ブロックには、ステータス（例: ライセンスの有効期限の日付）と、お使いのドメインが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除できます。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインでのみ使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、Econt はチェックアウトで購入者に表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインの設定とテストができます。プラグインのページと WooCommerce のページには、通知が表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作し続けます。ただし、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Econt が表示されない: ライセンスが有効であること、Enable/Disable が有効であること、配送先の国がブルガリアまたはルーマニアであること、その国のゾーンにこの方法が追加されていること（または Ignore zones が有効で、その国が許可されていること）を確認してください。国の料金が設定されていること、重量の制限、Minimum subtotal、Hide for shipping classes も確認してください。設定の Office list の行を確認してください。その国の営業所一覧が利用できない間は、この方法が非表示になります。
営業所一覧が読み込まれない: Load offices from Econt now をクリックして結果を確認するか、設定ページ上部の警告を確認してください。エラーは WooCommerce > Status > Logs に、ソース vfd-econt で記録されます。Econt がサイトの認証を求める場合は、Econt username と Econt password を入力してください。
購入者にテスト用の営業所が表示される: Demo API が有効になっています。本番のストアでは無効にしてください。
料金はどの通貨ですか？ ストアの通貨です。
その他の国: 開発者は vfd_ecn_countries フィルターを使って国を追加できます（2 文字のコードを 3 文字のコードに対応付けます）。
ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。たとえば、キーが別のドメインで既に使用されている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効化してください。ライセンスサーバーに接続できない場合は、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効にしても、すべての設定は保持され、営業所のキャッシュだけが消去されます。削除するには、Plugins ページで無効にしてから削除してください。このプラグインのライセンスキーとライセンスステータス、およびキャッシュされた営業所一覧は、常に削除されます。設定とゾーンの配送方法は、Remove data on uninstall が有効だった場合にのみ削除されます。それ以外の場合は、後日再インストールするために残ります。注文に保存された営業所は常に保持され、既存の注文は配送行を保持します。
Econt は、各所有者の商標です。本プラグインは Econt と提携しておらず、Econt の承認も受けていません。