VibeFox Sameday Easybox for OpenCart — ヘルプ
要件
OpenCart: 3.0.x（3.0.5.0 で動作確認済み）または 4.0.2 以降（4.1.0.3 で動作確認済み）。
PHP: 8.0 以降。
Sameday API のユーザー名とパスワード: API アクセスは、ルーマニア、ハンガリー、ブルガリアの Sameday ビジネスアカウントに含まれています。Sameday のアカウントマネージャーまたは Sameday の連携チームにお問い合わせください。認証情報は、eAWB ポータル（eawb.sameday.ro、.hu、.bg）のものと同じ場合が多くあります。デモ API の場合、Sameday は別のテスト用認証情報を提供します。API のユーザー名とパスワードがない場合、お客様はロッカーを選択できないため、この配送方法は表示されません。
国と郡: Sameday アカウントの国は System > Localisation > Countries で有効にしておく必要があります。Sameday の見積もりには、配送先住所の郡（Region / State フィールド）が必要です。OpenCart にはルーマニアとブルガリアの郡がありますが、OpenCart 3 にはハンガリーの郡はありません（OpenCart 4.1 にはあります）。この拡張機能は、それらを追加できます（下記の easybox ロッカーを参照してください）。追加しない場合、料金は料金表または代替料金から取得されます。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
このダウンロードは、両方の OpenCart バージョン用のパッケージが入った zip ファイル 1 つです。コンピュータで解凍してください。README.txt、OpenCart 3 用パッケージ vfd_sameday_easybox-oc3-(version).ocmod.zip、OpenCart 4 用パッケージ vfd_sameday_easybox.ocmod.zip が含まれています。お使いの OpenCart のバージョンのパッケージのみをインストールしてください。ライセンスキーは両方のバージョンで同じです。
OpenCart 3
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_sameday_easybox-oc3-(version).ocmod.zip を選択します。この拡張機能は OCMOD の変更を追加しないため、Extensions > Modifications を更新する必要はありません。Installer を使用する代わりに、このパッケージの upload フォルダの内容をストアのルートフォルダにコピーすることもできます。
2. Extensions > Extensions に移動し、拡張機能の種類 Shipping を選択して、VibeFox Sameday Easybox を探し、Install（緑色の + ボタン）をクリックします。
3. Edit（鉛筆ボタン）をクリックして設定ページを開きます。
4. Edit ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを貼り付け、Activate をクリックします（ライセンスキーを参照）。
5. Sameday の API username と API password を入力し、Sameday country を選択して、Enable/Disable をオンにし、Save をクリックします。ページに "Connected to Sameday ... easybox lockers" と表示されるはずです。Pickup point と Easybox service はアカウントから自動的に入力されます。
6. 料金を設定します。ストアの通貨が Sameday の通貨と異なる場合は Exchange rate of the estimate を設定し、Country prices の行（例：* Default）または Fallback cost を設定します。
7. Sameday の国に対応する郡が OpenCart にないとページに表示される場合は、easybox lockers セクションの Add counties をクリックします。
OpenCart 4
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_sameday_easybox.ocmod.zip を選択します。ファイル名を変更しないでください。OpenCart 4 は拡張機能のコードをファイル名から読み取るため、名前を変更したパッケージは動作しません。
2. パッケージは同じページのインストール済み拡張機能の一覧に表示されます。その横の Install（緑色の + ボタン）をクリックします。
3. Extensions > Extensions に移動し、拡張機能の種類 Shipping を選択します。VibeFox Sameday Easybox を見つけ、Install（緑色の + ボタン）をクリックしてから、Edit（鉛筆のボタン）をクリックします。
4. ライセンスキーと設定は、OpenCart 3 の手順 4 から 7 までと同じように入力します。設定ページとその項目は両方のバージョンで同じです。cron の URL だけが異なります（easybox ロッカーを参照）。
インストール後は、Enable/Disable をオンにして保存するまで、この方法はオフのままです。アンインストール後に拡張機能を再インストールした場合は、保持されていた設定が再び使用されますが、配送方法はオフの状態で始まります。
設定
すべての設定は拡張機能のページにあります：Extensions > Extensions > Shipping > VibeFox Sameday Easybox > Edit。セクションは左側に一覧表示されます。ページ下部の Save ボタンを押すと、ページを再読み込みせずにページ全体が保存されます。この拡張機能の変更権限を持つ管理者ユーザーだけが設定を保存できます。
設定の上には、接続状況が表示されます。Sameday のホスト、easybox ロッカーの数、一覧が更新された時刻、または Sameday がユーザー名かパスワードを拒否したことです。また、設定上の問題も表示されます。例えば、認証情報がない、料金がない、見積もり用の為替レートがない、郡がない、キログラムの重量クラスがない、あるいは選択した国が Sameday の国の外にあるといった問題です。
一部のエラーは保存を止め、何も保存されません：Enter a valid name (1-64 characters, without < > ; = # { }).、Sort order must be a whole number.、無効な税クラスまたはジオゾーン。その他の問題は 1 つの値だけに影響します。すべての料金と上限は、小数点としてカンマまたはピリオド（4,99 または 4.99）を受け付けます。無効な数値や負の数は保存されません。警告でフィールドが示され、以前の値が保持されます。
一般
Enable/Disable: チェックアウトでこの方法を表示または非表示にします。Extensions > Extensions > Shipping における拡張機能の状態です。既定値：オフ。
Name: お客様に表示される配送方法の名称。既定値：Sameday easybox。最大 64 文字。
Tax class: --- None ---（既定値）は、料金が確定していることを意味します。税クラスを指定すると、OpenCart はそのクラスの税を料金に加算します。
Sort order: チェックアウトの配送方法の中でこの方法が表示される位置。整数で指定します。
Sameday アカウント（API）
保存すると、拡張機能は Sameday にログインし、サービス、受取ポイント、easybox ロッカーの一覧を読み込みます。一覧は毎日更新されます。
API username: Sameday の API ユーザー名。
API password: Sameday の API パスワード。再表示されることはありません。保存済みのパスワードをそのまま使う場合は、フィールドを空のままにしてください。ユーザー名を空にすると、パスワードも削除されます。Sameday が拒否した場合、10 分間は再試行されません。
Sameday country: Sameday アカウントの国：Romania (api.sameday.ro)（既定値）、Hungary (api.sameday.hu)、または Bulgaria (api.sameday.bg)。その国のロッカーが提示され、この配送方法はその仕向先の国に対してのみ表示されます。
Test mode: デモ用の認証情報を使って、Sameday のデモ API（sameday-api.demo.zitec.com）を使用します。
料金（セクションのタイトルにストアの既定通貨が表示されます）
適用の順序は次のとおりです：Sameday の見積もり（Pickup point と Easybox service が設定されている場合）、次に国別の料金表、最後に代替料金です。料金表の値はストアの既定通貨で入力します。別の通貨で支払うお客様には、換算後の料金が表示されます。
Pickup point: Sameday が荷物を集荷する、お客様の Sameday 受取ポイントです。ログインに成功すると、アカウントの受取ポイントの一覧になり、既定のものが自動的に選ばれます。それまでは、ID を入力するフィールドです。Sameday の見積もりに必要です。料金表だけを使う場合は、- not set (price table only) - を選択します。
Easybox service: easybox 配送用の Sameday サービスで、通常は「Locker NextDay」（コード LN）であり、自動的に選択されます。Sameday の見積もりに必要です。
Exchange rate of the estimate: Sameday は、Sameday の国の通貨（RON、HUF、BGN。ユーロで販売するブルガリアのストアは EUR）で見積もりを出します。ストアが別の通貨で販売している場合は、Sameday の通貨 1 単位の、ストアの通貨での値を入力してください（例：0.20）。レートは 0 より大きい必要があります。これがない場合、見積もりは使用されず、料金表が適用されます。レフとユーロは、固定レートで自動的に換算されます。
Table price: Per order は料金を 1 回だけ請求します。Per item (price x quantity) は、商品の数量を掛けて請求します。これは料金表の料金と代替料金に適用されます。Sameday の見積もりは常に荷物全体についてのものです。
Country prices: 仕向国と荷物の重量ごとの料金です。Add country をクリックして行を追加し、削除ボタンで行を削除します。各行には Price 列と重量の列があります：XS は 1 kg まで、S は 1～2 kg、M は 2～3 kg、L は 3～5 kg、XL は 5 kg 超です。重量の列が 0 または空欄の場合は、Price 列が使用されます。* Default の行は、独自の行がない国に使用されます。新しい行は、すべての料金が 0 の * Default として始まります。これは送料無料を意味します。保存する前に国を選択して料金を入力するか、行を削除してください。同じ国が 2 つの行にある場合、保存時には最初の行だけが残り、その旨の警告が表示されます。セルが 0 以上の数値でない場合、表は保存されません。
Fallback cost: Sameday の見積もりがなく、料金表に仕向先の行がない場合に使用されます。その場合に配送方法を表示しないなら、空欄のままにしてください。
Free shipping from: easybox の配送が無料になるカートの小計（配送が必要な商品、割引後、税抜き）。小計がこの金額に達すると、この方法は無料で提示され、料金は照会されません。無料配送を提示しない場合は、空欄のままにしてください。
利用可否
Minimum weight (kg): カートの重量がこれより軽い場合、この方法を非表示にします。重量は、商品の重量クラスから換算されます。空欄または 0 は、上限なしを意味します。
Maximum weight (kg): これより重い荷物には easybox 配送を提示しません。既定値：30。Sameday 契約の上限と easybox の箱のサイズを確認してください。空欄または 0 は、上限なしを意味します。最小重量が最大重量より大きい場合は保存されません。警告が表示され、以前の値が保持されます。
Minimum cart subtotal: カートの小計（配送が必要な商品、割引後、税抜き）がこの金額に達した場合にのみ、この方法を提示します。空欄は最小値なしを意味します。
Geo zone: このジオゾーン内の住所に対してのみ、この方法を提示します。All Zones（既定値）は、制限なしを意味します。ジオゾーンは System > Localisation > Geo Zones で管理します。Ignore shipping zones がオンの場合は確認されません。
Ignore shipping zones: オンの場合、ジオゾーンは確認されず、下で選択した国に対してこの方法が提示されます（リストが空の場合は Sameday の国）。オフの場合は、上のジオゾーンのみが適用されます。
Countries (ignore zones mode): このモードの仕向先の国。Sameday の国以外の国はスキップされ、ページで警告されます。このフィールドは、Ignore shipping zones がオンの場合にのみ使用されます。
easybox ロッカー
Locker list: 読み込まれている easybox ロッカーが、いくつの都市に、いくつあり、いつ読み込まれたかを表示します。Refresh the locker list now で再読み込みします。一覧は、設定の保存時と、1 日を超えて古くなった後のチェックアウトのリクエスト時（最大で 1 時間に 1 回）に更新されます。毎日固定の更新を行うには、ここに表示されている URL を、サーバーの cron ジョブから 1 日 1 回呼び出してください。OpenCart 3 では https://your-store/index.php?route=extension/shipping/vfd_sameday_easybox/cron&token=(token)、OpenCart 4 では https://your-store/index.php?route=extension/vfd_sameday_easybox/shipping/vfd_sameday_easybox.cron&token=(token) のようになります。URL は設定に表示されたとおりに正確にコピーしてください。URL には秘密のトークンが含まれます。正しいトークンがない場合はエラーを返し、Sameday には接続しません。この方法が無効のときは、何もしません。
Counties: OpenCart に、Sameday の国の郡がいくつあるかを表示します。ない場合は、Add counties をクリックしてください。拡張機能は、その国の郡を System > Localisation > Zones に追加し、住所フォームの Region / State フィールドにそれらが表示されるようになります。既に存在する郡は二重に追加されません。OpenCart 4.1 にはすでに 3 か国すべての郡があるため、そこではこのボタンは不要です。
詳細設定
Debug log: 料金の計算、API の呼び出し、ロッカーの選択を storage/logs/vfd_sdeb_debug.log.php に書き込みます。このファイルは Web から読み取ることはできません。API のエラーは常に記録されます。パスワード、トークン、お客様の個人情報は記録されません。ファイルが 5 MB に達すると、新しいログが開始されます。作業が終わったら、ログをオフにしてください。
Log: デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログを空にします。
Remove data on uninstall: オンの場合、拡張機能をアンインストールすると、設定、キャッシュされた Sameday のデータ、ログが削除されます。オフ（既定値）の場合、設定は保持されます。ロッカーの一覧とキャッシュは常に削除されます。注文に保存されたロッカーは常に保持されます。
インポート / エクスポート
Export: Download JSON をクリックすると、設定が JSON ファイルとして保存されます。API パスワードはエクスポートされません。
Import: 以前にエクスポートした JSON を貼り付けて、Import をクリックします。値はフォームと同じチェックを通過します。保存済みのパスワードは保持されます。
チェックアウトでの動作
OpenCart が配送方法を表示するとき、拡張機能に Sameday easybox の料金を問い合わせます。拡張機能は、ジオゾーン（または Ignore shipping zones の国）、Sameday アカウントの配送先の国、API の認証情報と利用可能なロッカーの一覧、カートの重量、最小カート小計を確認します。Requires Shipping が Yes に設定された商品のみが対象です。小計は、クーポン割引後、税抜きのこれらの商品の価格です。送料無料が適用される場合、お客様は費用なしでこの方法を確認できます。
それ以外の場合、お客様が市区町村と郡を入力すると、拡張機能は Sameday に見積もりを依頼します。受取ポイントとサービス、荷物の重量、お客様の番地、市区町村、郡、郵便番号を送信します。氏名、メールアドレス、電話番号は送信されません。ブカレストは、公式の Sameday プラグインと同様に「Sector 1」として送信されます。見積もりはストアの通貨に換算されます。見積もりがない場合（未設定、市区町村や郡がまだ未入力、エラー、為替レートがない）、料金は国の料金表から、次に代替料金から取得されます。料金がない場合、この方法は非表示になります。料金は、選択した Tax class の税を含めて、お客様の通貨で表示されます。
Sameday の問題がチェックアウトを妨げることはありません。見積もりは 1 時間キャッシュされます。エラーは 10 分間キャッシュされます。タイムアウトまたはサーバーエラーの後、5 分間は見積もりを要求しません。リクエストは 15 秒でタイムアウトします。チェックアウト中、ロッカーの一覧は Sameday ではなく、お使いのサーバーから読み込まれます。
この拡張機能は、AWB（出荷）の作成、ラベルの印刷、荷物の追跡、代金引換の処理を行いません。自宅までのクーリエ配送や Sameday の地図ウィジェットもありません。Sameday eAWB ポータルまたは普段お使いのツールで、注文に表示されたロッカー ID を使って AWB を作成してください。
OpenCart 4 では、お客様はチェックアウトページの配送方法ブロックで Choose をクリックし、Shipping method options のウィンドウで Sameday easybox を選択します。料金は OpenCart 3 と同じです。
受取ポイント
お客様がこの方法を選択すると、その下に easybox locker のブロックが表示され、2 つのリストがあります：- Select city - と - Select easybox locker -。配送先住所の都市にロッカーがある場合は、その都市が自動的に選択されます。各ロッカーには、名称と住所が表示されます。選択は直ちにチェックアウト用に保存されるため、配送ステップを再度開いても保持されます。
ロッカーの選択は必須です。選択しないと、お客様は次に進めず、"Please choose a Sameday easybox locker." と表示されます。お客様が Continue をクリックすると、サーバーは選択されたロッカーが一覧にあるかを確認します。改ざんされたロッカー ID や削除されたロッカー ID は、"The selected easybox locker is not available any more. Please choose another easybox locker." で拒否されます。一覧を読み込めない場合、お客様には "The easybox lockers could not be loaded. Please try again in a moment or choose another shipping method." と表示されます。注文とともに保存される名称と住所は、ブラウザではなく一覧から取得されます。
注文ページ、メール、請求書：ロッカーは注文の配送方法に追加されます。例えば "Sameday easybox: 名称 - 住所"（方法の名称、次にロッカー）です。お客様は注文確認、注文履歴、注文メールでこれを確認でき、あなたは請求書でこれを確認できます。
管理画面の注文ページ：Sales > Orders で、注文ページには Sameday easybox locker のパネルがあり、名称、住所、Sameday AWB 用の Locker ID が表示されます。easybox の注文にロッカーがない場合、パネルには "No easybox locker was selected for this order." と表示されます。このパネルは、この方法がオフの間も表示されます。
OpenCart 4 では、Shipping method options のウィンドウで、Sameday easybox のオプションの下に easybox locker のブロックが表示されます。ワンページのチェックアウトでは住所が変わることがあるため、ウィンドウを開くたびに都市の一覧が読み込み直されます。ウィンドウの Continue ボタンは、有効なロッカーがないと先に進めず、同じメッセージが表示されます。OpenCart 4 は、チェックアウトごとに注文を 1 つ保持し、購入者が再度確定するたびにその注文を更新します。注文のロッカーも一緒に更新されます。管理画面の注文ページのパネルは、History セクションの上に表示されます。
ライセンスキー
この拡張機能は、vibefox.net で取得した VibeFox ライセンスキーで動作します。License — VibeFox Sameday Easybox のライセンスブロックは、Extensions > Extensions > Shipping > VibeFox Sameday Easybox > Edit ページの設定より上にある最初のブロックです。License key にキーを貼り付け、Activate をクリックします。その後、ブロックにはキーがマスクされた状態、ステータス（例：ライセンスの有効期限の日付とドメイン）、および次のボタンが表示されます：Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このストアからキーを削除）。その下には Product: opencart-shipping-sameday-easybox の行と、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 のアカウントで解放してください。
有効なキーがない場合、Sameday easybox の配送方法はチェックアウトでお客様に表示されず、料金の照会も計算も行われません。同じブラウザで管理画面にログインしている管理者ユーザーには、ストアでこの配送方法が (unlicensed — visible to admins only) と表示された状態で引き続き見えるため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 ではこのプレビューは利用できません。ストアは管理画面のログインを認識しないため、有効なキーがない場合は全員にこの方法が非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると 7 日間非表示になります。既存の注文は影響を受けません。
ライセンスの期限が切れても、拡張機能は動作を続けますが、アップデートとサポートには更新が必要です。管理画面の Dashboard または Edit ページを開くと、ステータスが自動的に再確認されます。キーの入力後最初の 14 日間は 1 日に 1 回、その後は 1 週間に 1 回です。cron ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスのステータスは常に削除されます。
トラブルシューティング
チェックアウトに Sameday easybox が表示されない：ライセンスが有効であること、Enable/Disable がオンであること、API のユーザー名とパスワードが入力されていること、設定ページに "Connected to Sameday" と表示されていること、仕向先の国が Sameday アカウントの国であることを確認してください。料金が利用可能であること（Sameday の見積もり、国の行、* Default の行、または Fallback cost）、重量と小計の上限、Geo zone、Ignore shipping zones の国を確認してください。商品の Requires Shipping が Yes に設定されていることを確認してください。理由を Log フィールドで確認するには、Debug log をオンにしてください。
Sameday が API のユーザー名またはパスワードを拒否した：それらを確認して、もう一度保存してください。デモ用の認証情報は Test mode がオンのときのみ、本番用の認証情報はオフのときのみ機能します。それまでは、保存済みのロッカー一覧があればそれが提示され、Sameday の見積もりは使用されません。
料金が Sameday ではなく、私の料金表から来ている：見積もりには、Pickup point、Easybox service、Sameday の国の郡、そして、ストアの通貨が Sameday の通貨と異なる場合は Exchange rate of the estimate が必要です。見積もりは、お客様が市区町村と郡を入力した後にのみ要求されます。Sameday に接続できない場合やエラーを返す場合は、料金表または代替料金が使用されます。理由はログにあります。
ロッカーの一覧が古い、または表示されない：Refresh the locker list now をクリックするか、設定を保存してください。更新に失敗した場合は、以前の一覧が使用され、その旨がステータスに表示されます。
誤って送料が無料になっている：Free shipping from と、Price が 0 の Country prices の行を確認してください。特に、Add country で追加して未入力のままの * Default の行に注意してください。
重量の上限または重量の列が一致しない：単位が "kg" の重量クラスがないとページに警告が出る場合は、System > Localisation > Weight Classes でキログラムの重量クラスを追加してください。
ページに "Warning: You do not have permission to modify VibeFox Sameday Easybox!" と表示される：管理者のユーザーグループは、設定を閲覧のみできる可能性があります。System > Users > User Groups で、そのグループに extension/shipping/vfd_sameday_easybox（OpenCart 3）または extension/vfd_sameday_easybox/shipping/vfd_sameday_easybox（OpenCart 4） の変更権限を付与してください。
アンインストール
Extensions > Extensions に移動し、種類 Shipping を選択して、VibeFox Sameday Easybox の横にある Uninstall（赤色の − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスのステータスは常に削除されます。OpenCart は、Enable/Disable、Sort order、Tax class、Geo zone を常にリセットします。保存されたロッカーの一覧、アカウント確認の結果、すべてのキャッシュは常に削除されます。Remove data on uninstall がオンの場合、その他の設定、cron トークン、ログも削除されます。オフの場合は保持され、拡張機能を再インストールしたときに再び使用されます。既存の注文は、保存されたロッカーを保持します。
OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に移動し、インストール済み拡張機能の一覧で VibeFox Sameday Easybox の横にある Uninstall（オレンジ色の − ボタン）をクリックしてから、アップロードしたパッケージを削除するために Delete（赤いゴミ箱ボタン）をクリックしてください。
Sameday と easybox は、それぞれの所有者の商標です。この拡張機能は Sameday と提携しておらず、Sameday による承認も受けていません。