VibeFox Econt for PrestaShop — ヘルプ
要件
PrestaShop: 8.0 ～ 9.x。
PHP: 8.0 以降。古い PHP バージョンではモジュールをインストールできません。
Econt: Econt の契約や API キーは不要です。営業所一覧は Econt が公開している標準データです。Econt に送信されるのは国コードのみで、顧客データは送信されません。Econt からショップに認証が求められた場合にのみ、e-Econt のユーザー名とパスワードを入力してください。e-Econt のログインについては、Econt の開発者ページ（econt.com/developers）をご覧ください。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. バックオフィスで Modules > Module Manager に移動し、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら Configure をクリックします。後でモジュール一覧から VibeFox Econt を探し、Configure をクリックすることもできます。
3. Configure ページ上部のライセンスブロックの License key に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。
4. 国ごとの料金を設定し、他のオプションも確認してから（設定を参照）、Save をクリックします。接続を確認するには、Load offices from Econt now をクリックします。
インストール時に、モジュールは配送時間テキスト Delivery to an Econt office or Econtomat を付けた Econt Express 配送業者を作成します。この配送業者は、ブルガリアとルーマニアのゾーンと、すべての顧客グループに割り当てられます。ゾーン、顧客グループ、配送時間、ロゴ、サイズ制限は Shipping > Carriers で変更できます。料金はそこで設定しないでください。料金は常にモジュールから取得されます。
設定
すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox Econt > Configure。各セクションには個別の Save ボタンがあり、ページ全体が保存されます。料金と条件は、配送業者のすべてのゾーンに適用されます。
ページの上部には、モジュールによる警告が表示されます。Econt 配送業者が見つからない、デモ API が有効、ブルガリアまたはルーマニアの料金が未設定（この場合、配送業者は表示されません）、ある国の直近の営業所リクエストが失敗した、またはストアの重量単位がモジュールで認識されていない（この場合、重量は kg として扱われます。単位は International > Localization の Local units で設定してください）。数値フィールドは小数点のカンマも受け付けます（例：5,99）。数値フィールドに数値でないもの、または負の数値が入力された場合、または Minimum weight (kg) が Maximum weight (kg) より大きい場合は、エラーにフィールド名が表示され、何も保存されません。
一般
Enable/Disable: Econt 配送を有効または無効にします。これは Shipping > Carriers の配送業者のステータスと同じスイッチです。
Name: カートとチェックアウトに表示される配送業者名。既定値：Econt Express。必須、最大 64 文字。
Tax: 配送業者の税ルール、または No tax。PrestaShop は、以下の料金にこの税を加算します。No tax を選択すると、料金は確定価格になります。
Econt 営業所一覧
営業所と Econtomat は Econt API から読み込まれ、24 時間キャッシュされます。
Demo API: テストデータを使う Econt のデモ API を使用します。本番のストアでは無効にしておいてください。デモの営業所は、実際の営業所とは異なる ID を持ちます。デモモードでは、ログインが設定されていない場合、Econt の公開テストアカウントが使用されます。
Econt username: 任意。HTTP Basic 認証に使用する e-Econt のログインです。
Econt password: 任意。ショップのデータベースに保存され、ログに書き込まれることはありません。保存後、このフィールドは空のままになり、Saved - leave empty to keep it. と表示されます。値を変更する場合にのみ新しい値を入力してください。保存されたパスワードを削除するには、Remove the saved password にチェックを入れて保存します。
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 日からユーロを使用しているため、ブルガリアのショップでは通常、EUR で料金を入力します。
Price per country: 1 行に 1 か国（またはカンマ区切り）：国コード、コロン、料金。例：BG:5.99 と RO:8.99（これらは既定値です）。小数点のカンマも使えます：BG:5,99。料金が 0 の場合は送料無料を意味します。フィールドが空の場合は、既定の料金 BG:5.99 と RO:8.99 が使用されます（Ignore zones が有効な場合、配送業者のゾーン外の国には、その場合料金が設定されません）。別の形式の入力は無視され、保存時に警告として一覧表示されます。それ以外の内容は保存されます。
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): 重いカートでは配送業者を非表示にします。空のままにすると、上限はありません。
配送ゾーンなしの利用可否
Ignore zones: 配送先住所のゾーンが配送業者に関連付けられていない場合でも、以下の国に Econt を提供します。有効にすると、配送業者はすべての有効なゾーンに関連付けられ、後で作成されたゾーンも関連付けられます。再び無効にすると、配送業者は以前関連付けられていたゾーンに戻ります。関連付けられていたゾーンは、これまでどおり動作します。Econt の提供対象は、引き続きブルガリアとルーマニアのみです。
Countries: ブルガリアおよび／またはルーマニア。Ignore zones と併用する場合にのみ使用されます。何もチェックしない場合は、ショップが発送するすべての Econt の国が対象になります。
詳細設定
Debug log: デバッグメッセージを、モジュールフォルダー内の logs/vfd_ecn_debug.log.php に書き込みます。このファイルは Web からは開けません。API のエラーは常に記録されます。パスワードや顧客データは書き込まれません。
Log: ログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログを空にできます。
Remove data on uninstall: オンの場合、モジュールをアンインストールすると、Econt の設定、配送業者、ログが削除されます。オフの場合、再インストールに備えて設定が保持されます。注文に保存された営業所は、常に保持されます。
チェックアウトでの動作
配送業者は、ブルガリアとルーマニアにのみ提供されます。配送ステップで、PrestaShop はモジュールに Econt の料金を問い合わせます。対象となるのは物理的な商品のみです。バーチャル商品は重量に加算されず、小計にも含まれません。モジュールは重量制限と最低小計を確認し、その国の料金を取得します。カートの小計が Free shipping from に達すると、料金は 0 になります。その国に営業所一覧がない場合は、配送は常に営業所宛てになるため、配送業者は非表示になります。料金はショップの標準通貨で計算され、その後、購入者のカート通貨で表示されます。
購入者が Econt を選択すると、配送業者の下に 2 つのリストが表示されます：City と Office / Econtomat。営業所一覧は、ページごとに 1 回だけ、Econt が選択されたときにのみ読み込まれます。Econtomat は一覧で目印が付きます。選択内容は直ちにカートに保存されます。営業所一覧を読み込めない場合、購入者には Econt offices cannot be loaded right now. Please try again in a few minutes or choose another shipping method. と表示されます。
購入者が配送ステップで Continue をクリックすると、モジュールはサーバー上で、営業所が選択されていること、およびその営業所が配送先の国の Econt 一覧に存在すること（Show によるフィルタリング後）を確認します。営業所を選択していない場合、購入者には Please select an Econt office or Econtomat. と表示されます。一覧にない営業所は、The selected Econt office is not available for the shipping country. Please select it again. と表示されて拒否されます。営業所名は常に Econt の一覧から取得され、ブラウザからは取得されません。セレクターは Classic テーマおよび Hummingbird で動作します。
営業所一覧は、ライブ API とデモ API のそれぞれについて、24 時間キャッシュされます。Econt に接続できない場合は、直近に成功した一覧が使用され、10 分間は Econt に再度問い合わせません。API のタイムアウトは 15 秒です。営業所一覧は https://ee.econt.com/services/（ライブ）または https://demo.econt.com/ee/services/（デモ）から取得されます。
注文がある配送業者を Shipping > Carriers で編集すると、PrestaShop はそれを新しいバージョンの配送業者として保存します。モジュールは新しいバージョンに自動的に従います。
モジュールは固定料金のみを使用します。Econt にリアルタイムの料金を問い合わせることはなく、送り状やラベルの作成、集荷の手配、荷物の追跡、代金引換の処理、住所への配送も行いません。営業所一覧があるのはブルガリアとルーマニアだけです。
受け取り拠点
注文時に、カートで選択された営業所が注文と一緒に保存されます。保存される情報は、都市、営業所名と住所、Econt 営業所コードです。e-Econt で発送を作成するときは、営業所コードを使用します。
バックオフィスの注文ページ: Econt office / Econtomat のブロックに、営業所と Office code が表示されます。Change の下で、注文の国の別の都市と営業所を選び、Save をクリックします。変更はすぐに保存され、非公開の注文メッセージに、旧営業所と新営業所が記録されます。営業所を選ばずに Save をクリックすると、ブロックには Select a city and an office first - nothing was changed. と表示されます。注文を編集できる権限を持つ従業員であれば、誰でも営業所を変更できます。モジュールのページへのアクセスは必要ありません。営業所一覧を読み込めない場合、ブロックには Econt offices cannot be loaded right now. と表示されます。
同じカートからの複数の注文: 営業所は最初の注文に属します。同じカートから行われた別の注文には営業所が割り当てられません。ログにエラーが記録され、そのブロックには、このカートの営業所が別の注文に属していることが表示されます。顧客と営業所を調整し、e-Econt で発送を手動で作成してください。
顧客: 営業所は、購入者の注文ページと注文確認ページに表示されます。また、注文確認メールと、ショップ宛ての新規注文メールでは、配送業者名に追加されます。
営業所名は、ショップの言語がブルガリア語またはルーマニア語の場合は現地語（ブルガリアではキリル文字）で、それ以外の場合は英語で表示されます。
ライセンスキー
このモジュールは、vibefox.net で取得した VibeFox ライセンスキーを使用します。ライセンスブロック License — VibeFox Econt は、Modules > Module Manager > VibeFox Econt > Configure の最初のブロックで、設定の上にあります。キーを License key に入力し、Activate をクリックします。その後、ブロックにはキーが一部隠された状態で表示され、ステータス（ライセンスの有効期限の日付やドメインなど）と、ボタンが表示されます：Check now でステータスを再確認、Change key で別のキーを入力、Remove key でこのストアからキーを削除します。その下には Product: presta-shipping-econt の行と、Manage licenses and domains in your account のリンクがあり、vibefox.net のアカウントが開きます。キーを変更できるのは、このモジュールの Configure 権限を持つ従業員のみです。ブロックのテキストはバックオフィスの言語に従います（英語とロシア語を含みます）。
キーが受け入れられない場合、ブロックに理由が表示されます。例：Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on。ストアのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認された状態で動作を続けます。
1 つのキーは 1 つのドメインで使用できます。メインストアのドメインであり、マルチストア構成でも同様です。ストアからキーを削除しても、ドメインの枠は解放されません。枠は vibefox.net のアカウントで解放してください。
有効なキーがない場合、Econt 配送業者はチェックアウト時に購入者に表示されず、料金も計算されません。PrestaShop のストアフロントはバックオフィスにログインしていることを認識しないため、配送業者はあなたにも表示されません。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文は影響を受けません。
ライセンスの有効期限が切れてもモジュールは動作を続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キーを入力後の最初の 14 日間は 1 日に 1 回、その後は週に 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
チェックアウトに Econt が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、配送先の国がブルガリアまたはルーマニアであることを確認してください。Shipping > Carriers で、配送業者が顧客の国のゾーンと顧客グループをカバーしていることを確認してください（または Ignore zones をオンにして Countries を確認してください）。その国の料金、重量制限、Minimum subtotal が設定されていることを確認してください。設定の Office list 行を確認してください。その国で利用できる営業所一覧がない間は、配送業者が非表示になります。商品ページで、商品を特定の配送業者に限定することもできます。
営業所一覧が読み込まれない: Load offices from Econt now をクリックして結果を確認するか、設定ページ上部の警告を確認してください。エラーは常にログに記録されます。詳細を確認するには Debug log をオンにし、Log フィールドを確認してください。Econt がショップに認証を要求している場合は、Econt username と Econt password を入力してください。
購入者にテスト用の営業所が表示される: Demo API がオンになっています。本番のショップではオフにしてください。
料金の通貨は？ ショップの標準通貨で、税抜きです。購入者にはカートの通貨で表示されます。
税金が料金に上乗せされる: 配送業者には税ルールがあります。料金に付加価値税がすでに含まれている場合は、Tax を No tax に設定してください。
ページに Econt 配送業者が見つからないと表示される: 配送業者が Shipping > Carriers で削除されました。Modules > Module Manager でモジュールをリセットすると、再作成されます。
アンインストール
Modules > Module Manager に移動し、VibeFox Econt の横のメニューを開いて Uninstall を選択します。ライセンスキーとライセンスステータスは常に削除されます。キャッシュされた営業所一覧は常に削除されます。Remove data on uninstall がオンの場合、配送業者は削除されます（注文の履歴は保持されます）。また、設定とログも削除されます。オフの場合、配送業者は無効化されるだけで、すべての設定は保持されます。モジュールを再インストールすると、保存されていた配送業者が、そのときのステータスで復元されます。モジュールをリセットしても、現在の配送業者のステータスは維持されます。注文に保存された営業所は、常に保持されます。
Econt は、それぞれの所有者の商標です。本モジュールは Econt と提携しておらず、Econt による推奨も受けていません。