VibeFox Econt for OpenCart — ヘルプ
要件
OpenCart: 3.0.x（3.0.5.0 で検証済み）または 4.0.2 以降（4.1.0.3 で検証済み）。
PHP: 8.0 以降。
国: ブルガリアとルーマニアを System > Localisation > Countries で有効にしておく必要があります。
Econt: 契約や API キーは不要です。営業所リストは Econt の公開データです。Econt に送信されるのは国コードのみで、購入者のデータは送信されません。Econt から貴店に認証が求められた場合にのみ、e-Econt のユーザー名とパスワードを入力してください。e-Econt へのログイン方法は Econt の開発者ページ（econt.com/developers）に記載されています。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
ダウンロードは、両方の OpenCart バージョン用のパッケージを含む 1 つの zip ファイルです。お使いのコンピューターで展開してください。含まれるのは、README.txt、OpenCart 3 用パッケージ vfd_econt-oc3-(バージョン).ocmod.zip、OpenCart 4 用パッケージ vfd_econt.ocmod.zip です。お使いの OpenCart バージョンのパッケージだけをインストールしてください。ライセンスキーは両方のバージョンで同じです。
OpenCart 3
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_econt-oc3-(バージョン).ocmod.zip を選択します。本拡張機能は OCMOD の変更を追加しないため、Extensions > Modifications を更新する必要はありません。インストーラーを使う代わりに、このパッケージの upload フォルダーの内容をストアのルートフォルダーにコピーすることもできます。
2. Extensions > Extensions に移動し、拡張機能の種類で Shipping を選びます。VibeFox Econt を見つけて Install（緑色の + ボタン）をクリックします。
3. Edit（鉛筆のボタン）をクリックして設定ページを開きます。
4. Edit ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（License key を参照）。
5. 国ごとの料金を設定し、他のオプションを確認します（Configuration を参照）。Enable/Disable をオンにして Save をクリックします。接続を確認するには Load offices from Econt now をクリックします。
OpenCart 4
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_econt.ocmod.zip を選択します。ファイル名は変更しないでください。OpenCart 4 は拡張機能のコードをファイル名から取得するため、名前を変更したパッケージは動作しません。
2. 同じページのインストール済み拡張機能の一覧にパッケージが表示されます。その横にある Install（緑色の + ボタン）をクリックします。
3. Extensions > Extensions に移動し、拡張機能の種類で Shipping を選びます。VibeFox Econt を見つけて、Install（緑色の + ボタン）をクリックし、次に Edit（鉛筆のボタン）をクリックします。
4. ライセンスキーと設定は、OpenCart 3 の手順 4 と 5 と同じように入力します。設定ページとそのフィールドは両方のバージョンで同じです。
インストール直後は、Enable/Disable をオンにして保存するまで、この方法は無効のままです。アンインストール後に拡張機能を再インストールすると、保持されていた設定が再び使用されます。
設定
すべての設定は拡張機能のページにあります: Extensions > Extensions > Shipping > VibeFox Econt > Edit。セクションは左側に一覧表示されます。Save ボタン 1 つで、ページを再読み込みせずにページ全体を保存します。設定の保存、営業所の読み込み、ログの消去ができるのは、この拡張機能の変更権限を持つ管理者ユーザーだけです。
ページの上部には、拡張機能からの警告が表示されます。デモ API が有効になっている、ブルガリアまたはルーマニアの料金が設定されていない（その場合、この方法は表示されません）、ある国の直近の営業所リストの取得に失敗した、またはストアに単位が kg の重量クラスがない（その場合、商品の重量は単位名（kg、g、lb、oz）で読み取られます）などです。数値フィールドでは小数点のカンマ（例: 5,99）を使えます。数値フィールドに数値ではない値や負の値が入力されている場合、または Minimum weight (kg) が Maximum weight (kg) より大きい場合は、エラーにフィールド名が表示され、何も保存されません。Name が空の場合や 64 文字を超える場合、Sort order が整数でない場合、不明な税クラスやジオゾーンを選んだ場合も同様です。
全般
Enable/Disable: チェックアウトで Econt の配送を表示するか非表示にします。既定値: オフ。
Name: カートとチェックアウトに表示される配送方法の名前。既定値: Econt Express。必須、64 文字以内。
Sort order: チェックアウトの配送方法の中での表示順。整数。
Tax class: 配送料の税クラス。または --- None ---（既定値）。OpenCart は、下記の料金にこの税を上乗せします。--- None --- の場合、料金は確定価格になります。
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: オンにして Save をクリックすると、保存されているパスワードが削除されます。
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 が使われます。別の形式の項目は無視され、保存時の警告に一覧表示されます。残りは保存されます。
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): より重いカートの場合はこの方法を非表示にします。空の場合は制限なしです。
提供地域
Econt はブルガリアとルーマニアにのみ配送します。通常は、ジオゾーンによってこの方法を提供する地域が決まります。Ignore geo zone を使うと、代わりに選択した国によって決まります。
Geo zone: このジオゾーン内の住所にのみ Econt を提供します。All Zones（既定値）は、ブルガリアとルーマニアの全域を意味します。ジオゾーンは System > Localisation > Geo Zones で管理されます。Ignore geo zone を使用する場合、ジオゾーンは使用されません。
Ignore geo zone: ジオゾーンは確認されません。住所がジオゾーン内にあるかどうかに関係なく、下記の国で Econt が提供されます。
Countries: ブルガリアおよび/またはルーマニア。Ignore geo zone を使用する場合にのみ使われます。何も選択されていない場合は、すべての Econt の国を意味します。
詳細設定
Debug log: デバッグメッセージを storage/logs/vfd_ecn_debug.log.php（OpenCart 4 では system/storage/logs/vfd_ecn_debug.log.php）に書き込みます。このファイルは Web から読み取ることはできません。5 MB に達すると、新しいログが開始されます。API のエラーや警告（Econt に接続できない、営業所がない、営業所のない注文など）は、常にログに記録されます。パスワードや購入者のデータは書き込まれません。
Log: ログのサイズと最新のエントリが表示されます。Clear log をクリックすると、ログが空になります。
Remove data on uninstall: オンの場合、拡張機能をアンインストールすると、Econt の設定、ログ、未完了のチェックアウトの選択内容が削除されます。オフの場合、再インストールに備えて設定が保持されます。注文に保存された営業所は、常に保持されます。
インポート / エクスポート
Export: Download JSON をクリックすると、設定が JSON ファイルとして保存されます。パスワードはエクスポートされません。
Import: 以前にエクスポートした JSON を貼り付けて Import をクリックすると、設定が復元されます（別のストアでの利用など）。値は通常の保存と同じように検証されます。保存済みのパスワードは保持されます。
チェックアウトでの動作
この方法はブルガリアとルーマニアにのみ提供されます。OpenCart が配送方法を表示すると、拡張機能に Econt の料金を問い合わせます。Ignore geo zone を使用する場合、ジオゾーンは確認されず、選択された Countries の場合にのみこの方法が提供されます（何も選択されていない場合は、ブルガリアとルーマニア）。それ以外で Geo zone が設定されている場合は、住所がそのジオゾーン内にある必要があります。Requires Shipping が Yes に設定されている商品のみが対象になります。その他の商品は重量に加算されず、小計にも含まれません。拡張機能は重量の制限と最低小計を確認し、その国の料金を取得します。カートの小計が Free shipping from に達している場合、料金は 0 になります。国の営業所リストが利用できない場合、配送は常に営業所宛てになるため、この方法は非表示になります。料金は貴店の既定通貨で計算され、選択した Tax class の税金を含めて、購入者の通貨で表示されます。
購入者が Econt を選択すると、方法の下に 2 つのリスト、City と Office / Econtomat が表示されます。営業所リストは、Econt が選択されたときにのみ、ページごとに 1 回読み込まれます。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 のリストから取得され、ブラウザからは取得されません。
OpenCart 4 では、購入者はチェックアウトページの配送方法ブロックで Choose をクリックし、Shipping method options ウィンドウで Econt を選びます。City と Office / Econtomat のリストは、そのウィンドウの方法の下に表示され、上記のとおりに動作します。ウィンドウの Continue ボタンは、有効な営業所がないと先に進めず、同じメッセージが表示されます。
営業所リストは 24 時間キャッシュされ、ライブ API とデモ API、および国ごとに別々に保存されます。Econt に接続できない場合は、直近に正常に読み込まれたリストが使われ、10 分間は Econt への再問い合わせは行われません。API のタイムアウトは 15 秒です。営業所リストは https://ee.econt.com/services/（ライブ）または https://demo.econt.com/ee/services/（デモ）から取得されます。
本拡張機能は固定料金のみを使用します。Econt にリアルタイムの料金を問い合わせず、送り状やラベルを作成せず、集荷を手配せず、荷物を追跡せず、代金引換を扱わず、住所への配送も行いません。営業所リストがあるのはブルガリアとルーマニアのみです。
受け取りポイント
注文が確定すると、チェックアウトで選択された営業所が、都市、営業所名と住所、Econt の営業所コードとともに注文と一緒に保存されます。e-Econt で発送を作成する際には、営業所コードを使用してください。
購入者: 営業所は注文の配送方法に追加されます。例: Econt Express - Econt office / Econtomat: city, office (address)（最大 128 文字。OpenCart 4 ではテキストは短縮されません）。これにより、購入者の注文履歴、注文メール、請求書、管理画面の注文に表示されます。OpenCart 4 では、チェックアウトで 1 つの注文が保持され、購入者が再度確定するたびに更新されます。その際、注文の営業所も一緒に更新されます。
管理画面の注文ページ: Sales > Orders で、履歴の上にある Econt office / Econtomat パネルには、営業所とその営業所コードが表示されます。これは、後で方法が無効になった場合でも同様です。Change の下で、注文の国の別の都市と営業所を選び、Save をクリックします。パネルには Saved. と表示され、注文の配送方法のテキストが更新されます。さらに、注文履歴には（購入者には送信されない）メモが残り、以前の営業所と新しい営業所が記録されます。営業所を選ばずに Save をクリックすると、パネルには Select a city and an office first - nothing was changed. と表示されます。注文の国のリストにない営業所は、The selected Econt office is not available for the shipping country - nothing was changed. と表示されて拒否されます。注文の変更権限を持つ管理者ユーザーであれば、誰でも営業所を変更できます。拡張機能の設定へのアクセスは必要ありません。営業所リストを読み込めない場合、パネルには Econt offices cannot be loaded right now. と表示されます。営業所なしで行われた注文には No Econt office is saved for this order. と表示され、ログにはそのエラーが記録されます。
営業所名は、ストアの言語がブルガリア語またはルーマニア語の場合は現地語（ブルガリアはキリル文字）で、それ以外の場合は英語で表示されます。
ライセンスキー
本拡張機能は、vibefox.net で入手した VibeFox ライセンスキーで動作します。License — VibeFox Econt のライセンスブロックは、Extensions > Extensions > Shipping > VibeFox Econt > Edit ページで設定より上にある最初のブロックです。キーを License key に入力し、Activate をクリックします。その後、ブロックにはキーがマスク表示された状態、ステータス（ライセンスの有効期限日やお使いのドメインなど）、および Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このストアからキーを削除）のボタンが表示されます。その下には Product: opencart-shipping-econt の行と、vibefox.net のアカウントを開く Manage licenses and domains in your account のリンクがあります。キーを変更できるのは、この拡張機能の Modify 権限を持つ管理者ユーザーだけです。ブロックの文言は管理画面の言語に従います（英語とロシア語を含みます）。
キーが受け付けられない場合、ブロックに理由が表示されます。例: Key not found、This key belongs to another product、Domain limit reached、または License expired on と日付。ストアのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、拡張機能は最後に確認できたステータスで動作を続けます。
1 つのキーは 1 つのドメインで使用できます。OpenCart の設定にあるストアのアドレスが対象です。ストアからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで購入者に Econt の配送方法は表示されず、料金も計算されません。同じブラウザーで管理画面にログインしている管理者ユーザーには、ストアで (unlicensed — visible to admins only) と表示された状態で引き続きこの方法が表示されるため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 ではこのプレビューは利用できません。ストアから管理画面のログインは見えないため、有効なキーがない場合は全員に対してこの方法が非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると、7 日間非表示になります。既存の注文には影響しません。
ライセンスが期限切れになっても、拡張機能は動作を続けますが、アップデートとサポートには更新が必要です。管理画面の Dashboard または Edit ページを開くと、ステータスは自動的に再確認されます。キーの入力後最初の 14 日間は 1 日に 1 回、その後は週に 1 回です。cron ジョブは必要ありません。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
チェックアウトに Econt が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、配送先の国がブルガリアまたはルーマニアであること（System > Localisation > Countries で有効になっていること）を確認してください。Geo zone（または Ignore geo zone と Countries）、その国の料金が設定されていること、重量の制限、Minimum subtotal を確認してください。設定の Office list の行を確認してください。その国で営業所リストが利用できない間は、この方法は非表示になります。商品の Requires Shipping が Yes に設定されていることも確認してください。
営業所リストが読み込まれない: Load offices from Econt now をクリックして結果を確認するか、設定ページ上部の警告を確認してください。エラーは常にログに書き込まれます。詳細が必要な場合は Debug log をオンにして、Log フィールドを確認してください。Econt が貴店に対して認証を要求する場合は、Econt username と Econt password を入力してください。
購入者にテスト用の営業所が表示される: Demo API がオンになっています。本番のストアではオフにしてください。
料金はどの通貨ですか？貴店の既定通貨で、税別です。購入者には、その購入者の通貨で表示されます。
料金に税金が上乗せされる: 税クラスが選択されています。料金に付加価値税（VAT）がすでに含まれている場合は、Tax class を --- None --- に設定してください。
ページに "Warning: You do not have permission to modify VibeFox Econt!" と表示される: 管理者ユーザーのグループには、設定の閲覧権限しかない可能性があります。System > Users > User Groups で、そのグループに extension/shipping/vfd_econt（OpenCart 3）または extension/vfd_econt/shipping/vfd_econt（OpenCart 4）の変更権限を付与してください。
アンインストール
Extensions > Extensions に移動し、種類 Shipping を選んで、VibeFox Econt の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは、常に削除されます。OpenCart は常に Enable/Disable、Sort order、Tax class、Geo zone をリセットします。拡張機能は常に、そのイベントとキャッシュされた営業所リストを削除します。Remove data on uninstall がオンの場合は、その他の設定、ログ、未完了のチェックアウトの選択内容も削除されます。オフの場合、設定は保持され、拡張機能を再インストールしたときに再び使用されます。注文に保存された営業所は常に保持され、既存の注文は配送方法と料金を保持します。
OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に移動し、インストール済み拡張機能の一覧で VibeFox Econt の横にある Uninstall（オレンジ色の − ボタン）をクリックし、次にアップロードしたパッケージを削除するために Delete（赤いゴミ箱のボタン）をクリックします。
Econt は、それぞれの所有者の商標です。本拡張機能は Econt と提携しておらず、Econt の承認も受けていません。