VibeFox Sameday Easybox for PrestaShop — ヘルプ
要件
PrestaShop: 8.0 から 9.x。
PHP: 8.0 以降。古いバージョンの PHP では、モジュールをインストールできません。
Sameday API のユーザー名とパスワード: API へのアクセスは、ルーマニア、ハンガリー、ブルガリアの Sameday ビジネスアカウントに含まれます。Sameday のアカウントマネージャーまたは Sameday の統合チームにお問い合わせください。認証情報は、多くの場合 eAWB ポータル（eawb.sameday.ro、.hu、.bg）と同じです。デモ API の場合、Sameday からは別のテスト用認証情報が提供されます。API のユーザー名とパスワードがないと、購入者がロッカーを選択できないため、配送業者は表示されません。
住所フォームの県: Sameday の見積もりには、配送先住所の県が必要です。PrestaShop には、既定でルーマニア、ハンガリー、ブルガリアの県がありません。モジュールが県を追加できます（下記の easybox ロッカー を参照）。県がない場合、料金は料金表または代替送料から決まります。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. 管理画面で Modules > Module Manager を開き、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら Configure をクリックするか、後でモジュール一覧から VibeFox Sameday Easybox を見つけて Configure をクリックします。
3. 設定ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。
4. Sameday の API username と API password を入力し、Sameday country を選択して、Save をクリックします。ページに「Sameday に接続済み ... easybox ロッカー」と表示されるはずです。Pickup point と Easybox service は、アカウントから自動入力されます。
5. 料金を設定します。ショップの通貨が Sameday の通貨と異なる場合は Exchange rate of the estimate、そして Country prices の行（例: * Default）または Fallback cost を設定します。
6. ページに、Sameday の国に対応する県がないと表示された場合は、easybox ロッカー セクションの Add counties をクリックします。
インストール時、モジュールは配送時間のテキスト Delivery to a Sameday easybox locker を設定した配送業者 Sameday easybox を作成します。すべての顧客グループとルーマニアのゾーンに割り当てられます。ゾーン、顧客グループ、配送時間、ロゴは Shipping > Carriers で変更できます。そこで料金を設定しないでください。料金は常にモジュールから取得されます。
設定
すべての設定は、モジュールの Configure ページにあり、6 つのセクションに分かれています。どのセクションの Save ボタンを押しても、ページ全体が保存されます。
設定の上には、接続ステータスが表示されます。Sameday のホスト、ロッカーの数、一覧が更新された日時、または Sameday がユーザー名またはパスワードを拒否したことが表示されます。また、認証情報がない、料金がない、見積もり用の為替レートがない、県がない、モジュールが認識できないショップの重量単位がある、配送業者が見つからないといった設定の問題も一覧表示されます。
すべての料金と制限は、小数点として、カンマまたはピリオドを使用できます（4,99 または 4.99）。無効な数値や負の数値は保存されません。警告でフィールドが示され、以前の値が維持されます。
一般
Enable/Disable: 配送業者を有効または無効にします。Shipping > Carriers の配送業者のステータスと同じ意味です。
Name: 購入者に表示される配送方法の名前（配送業者の名前）。既定値: Sameday easybox。
Tax status: None は、価格が確定していることを意味します。税ルールを設定した Taxable では、PrestaShop がその配送税を価格に加算します。
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 の集荷ポイントです。ログインに成功すると、アカウントの集荷ポイントの一覧になり、既定のものが自動的に選択されます。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 は料金を一度だけ請求します。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 つの行にある場合、保存時には最初の行のみが残り、警告が表示されます。セルが有効な数値でない場合、料金表は保存されません。
Fallback cost: Sameday の見積もりがなく、国の料金表に配送先の行がない場合に使用されます。その場合に配送業者を提供したくない場合は、空のままにしてください。
Free shipping from: easybox 配送が無料になるカート小計（配送が必要な商品、割引適用後、税抜き）です。小計がこの金額に達すると、配送業者は無料で提供され、料金の照会は行われません。送料無料を提供しない場合は、空のままにしてください。
利用条件
Minimum weight (kg): カートがこれより軽い場合、配送業者を非表示にします。重量は、ショップの重量単位（kg、g、lb、oz）から換算されます。空または 0 は、制限なしを意味します。
Maximum weight (kg): これより重い荷物には、easybox 配送を提供しません。既定値: 30。Sameday の契約の制限と easybox のボックスサイズを確認してください。空または 0 は、制限なしを意味します。最大重量より大きい最小重量は保存されません。警告が表示され、以前の値が維持されます。
Minimum cart subtotal: カート小計（配送が必要な商品、割引適用後、税抜き）がこの金額に達した場合にのみ、配送業者を提供します。
Ignore shipping zones: オンにすると、配送業者は、ゾーンが配送業者に設定されていない場合でも、以下で選択した国（リストが空の場合は Sameday の国）に対して提供されます。その場合、配送業者は、後から作成されたゾーンを含むすべての有効なゾーンに紐付けられます。再びオフにすると、配送業者は以前のゾーンに戻ります。オフの場合、配送業者は Shipping > Carriers のゾーンでのみ提供されます。
Countries (ignore zones mode): このモードの配送先の国です。Sameday の国以外の国はスキップされ、ページに警告が表示されます。このフィールドは、Ignore shipping zones がオンの場合にのみ使用されます。
easybox ロッカー
Locker list: 読み込まれた easybox ロッカーの数、都市の数、読み込み日時を表示します。Refresh the locker list now で再読み込みします。一覧は、設定の保存時に更新され、1 日以上経過している場合は、チェックアウトのリクエストの後に更新されます。毎日固定の更新を行うには、サーバーの cron ジョブから、ここに表示される Cron URL を 1 日 1 回呼び出します。URL には秘密のトークンが含まれています。トークンがない場合はエラーが返され、Sameday には接続されません。
Counties: Sameday の見積もりには、住所の県が必要です。PrestaShop に Sameday の国の県（states）がない場合は、Add counties をクリックします。モジュールは、ルーマニア、ハンガリー、ブルガリアの県と、その国の住所フォームの県フィールドを追加します。既に存在する県は、二重に追加されません。設定されると、ページに県の数が表示されます。
詳細設定
Debug log: 料金計算、API 呼び出し、ロッカーの選択を、モジュールのフォルダにある logs/vfd_sdeb_debug.log.php ファイルに書き込みます。このファイルはウェブから読み取れません。API のエラーは常に記録されます。パスワード、トークン、顧客の個人データは記録されません。下の Log フィールドには、ファイルの末尾が表示され、Clear log ボタンがあります。作業が終わったらログをオフにしてください。
Remove data on uninstall: オンにすると、モジュールをアンインストールしたときに、設定と配送業者が削除されます。オフの場合、アンインストールでは配送業者がオフになるだけです。ロッカーの一覧とキャッシュは常に削除されます。注文に保存されたロッカーは、常に保持されます。
チェックアウト時の動作
ショップがカートの送料を計算すると、PrestaShop はモジュールに Sameday easybox 配送業者の料金を問い合わせます。モジュールは、次の条件を確認します。Sameday アカウントの配送先の国、API 認証情報と利用可能なロッカーの一覧、Ignore shipping zones の国、カートの重量、最低カート小計。配送が不要な商品（バーチャル商品）は計算に含まれません。送料無料が適用される場合、購入者は配送業者を無料で表示されます。
それ以外の場合、購入者が市区町村と県を入力すると、モジュールは Sameday に見積もりを要求します。集荷ポイントとサービス、荷物の重量、購入者の住所（番地、都市、県、郵便番号）を送信します。氏名、メールアドレス、電話番号は送信されません。ブカレストは、Sameday の公式プラグインと同様に「Sector 1」として送信されます。見積もりはショップの通貨に換算されます。見積もりがない場合（未設定、まだ都市または県がない、エラー、為替レートがない）は、国の料金表から料金が取得され、それでもない場合は代替送料が使用されます。料金がない場合、配送業者は非表示になります。
Sameday の問題がチェックアウトを妨げることはありません。見積もりは 1 時間キャッシュされます。エラーは 10 分間キャッシュされます。タイムアウトまたはサーバーエラーの後、5 分間は見積もりを要求しません。リクエストは 15 秒でタイムアウトします。チェックアウト中、ロッカーの一覧は Sameday ではなく、お使いのサーバーから読み込まれます。
この配送業者は、Classic テーマ（PrestaShop 8）と Hummingbird テーマ（PrestaShop 9）の配送ステップで動作します。
本モジュールは、AWB（配送伝票）の作成、ラベルの印刷、荷物の追跡、代金引換には対応していません。宅配便による自宅への配送や Sameday の地図ウィジェットはありません。AWB は、注文に表示されたロッカー ID を使って、Sameday eAWB ポータルまたは普段お使いのツールで作成してください。
集荷ポイント
購入者が配送業者を選ぶと、その下に easybox locker ブロックが表示されます。このブロックには 2 つのリストがあります: - Select city - と - Select easybox locker - です。配送先住所の都市にロッカーがある場合は、自動的に選択されます。各ロッカーには、名前と住所が表示されます。選択内容はすぐにカートに保存されるため、配送ステップが更新されたり、ページが再読み込みされたりしても保持されます。
ロッカーは必須です。ロッカーがないと、購入者は次に進めず、「Sameday easybox ロッカーを選択してください。」と表示されます。購入者が Continue をクリックすると、サーバーは選択されたロッカーが一覧にあるかを確認します。偽造されたロッカー ID や削除されたロッカー ID は、「選択された easybox ロッカーは利用できなくなりました。別の easybox ロッカーを選択してください。」というメッセージで拒否されます。一覧を読み込めない場合、購入者には「easybox ロッカーを読み込めませんでした。しばらくしてからもう一度お試しいただくか、別の配送方法を選択してください。」と表示されます。注文に保存される名前と住所は、ブラウザではなく一覧から取得されます。注文が確定すると、そのロッカーは変更されません。
管理画面の注文ページ: 名前、住所、Sameday AWB 用の Locker ID を含む Sameday easybox locker ブロックです。easybox の注文にロッカーがない場合、ブロックには「この注文では easybox ロッカーが選択されていません。」と表示されます。
注文確認ページと注文履歴ページ: Sameday easybox locker: 名前と住所が表示されます。
注文メール: ロッカーの名前と住所が、注文確認メールの配送業者情報に追加されます。ショップへの新規注文メール（Mail alerts モジュール）にも Locker ID が含まれます。
ライセンスキー
本モジュールは、vibefox.net から取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Sameday Easybox は、Modules > Module Manager > VibeFox Sameday Easybox > Configure の設定の上にある最初のブロックです。License key にキーを入力し、Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス（例: ライセンスの有効期限日と使用中のドメイン）、そして次のボタンが表示されます。Check now はステータスを再確認します。Change key は別のキーを入力します。Remove key はこのショップからキーを削除します。その下には Product: presta-shipping-sameday-easybox の行と、vibefox.net のアカウントを開くリンク Manage licenses and domains in your account があります。キーを変更できるのは、このモジュールの Configure 権限を持つ従業員だけです。ブロックの文言は管理画面の言語に従います（英語とロシア語が含まれます）。
キーが受け付けられない場合、ブロックに理由が表示されます（例: Key not found、This key belongs to another product、Domain limit reached、または License expired on と日付）。ショップのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックします。ライセンスサーバーに接続できない場合、モジュールは最後に確認できたステータスで動作を続けます。
1 つのキーは 1 つのドメインで機能します。ドメインとは、メインショップのドメインを指し、マルチストア構成でも同様です。ショップからキーを削除しても、そのドメインの枠は解放されません。枠は vibefox.net のアカウントで解放してください。
有効なキーがない場合、Sameday easybox 配送業者はチェックアウト時に購入者に表示されず、料金の照会や計算も行われません。PrestaShop のフロントエンドは、バックオフィスにログインしていることを認識しないため、配送業者はあなたにも表示されません。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れた場合も、モジュールは動作し続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キーを入力してから最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは必要ありません。モジュールをアンインストールすると、ライセンスキーとライセンスのステータスは常に削除されます。このモジュールの Reset ではデータは削除されないため、キーとステータスは保持されます。
トラブルシューティング
Sameday easybox がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、API のユーザー名とパスワードが入力されていること、Configure ページに「Sameday に接続済み」と表示されていること、配送先の国が Sameday アカウントの国であることを確認します。料金が利用可能であること（Sameday の見積もり、国の行、* Default の行、または Fallback cost）、重量と小計の制限を確認します。Shipping > Carriers で、配送業者が購入者の国のゾーンと顧客グループを対象にしていることを確認するか、Ignore shipping zones をオンにします。商品ページでは、商品が特定の配送業者に限定されている場合もあります。理由を Log フィールドで確認するには、Debug log をオンにします。
Sameday が API のユーザー名またはパスワードを拒否した: 内容を確認して、もう一度保存してください。デモ用認証情報は Test mode がオンの場合のみ、本番用認証情報はオフの場合のみ機能します。それまでは、保存済みのロッカー一覧がある場合はそれが提供され、Sameday の見積もりは使用されません。
料金が Sameday ではなく、自分の料金表から来ている: 見積もりには、Pickup point、Easybox service、住所フォームの県、そしてショップの通貨が Sameday の通貨と異なる場合は Exchange rate of the estimate が必要です。見積もりは、購入者が都市と県を入力した後にのみ要求されます。Sameday に接続できない場合やエラーが返された場合は、料金表または代替送料が使用されます。理由はログに記録されます。
ロッカー一覧が古い、または表示されない: Refresh the locker list now をクリックするか、設定を保存してください。更新に失敗した場合は、以前の一覧が使用され、ステータスにその旨が表示されます。ショップがメンテナンスモードの場合、cron サーバーの IP が許可されていない限り、cron URL はショップの他の部分と同様にブロックされます。
送料が誤って無料になっている: Free shipping from と、Price が 0 の Country prices の行を確認してください。特に、+ Add country で追加して未入力のままになっている * Default の行に注意してください。
重量制限や重量の列が一致しない: ページに、ショップの重量単位が不明であるという警告が表示される場合は、International > Localization（Local units）で kg、g、lb、または oz を設定してください。
ページに Sameday easybox 配送業者が見つからないと表示される: 配送業者が Shipping > Carriers で削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。リセットしても、既存の配送業者の設定とステータスは保持されます。
アンインストール
Modules > Module Manager を開き、VibeFox Sameday Easybox の横にあるメニューから Uninstall を選択します。ライセンスキーとライセンスのステータスは常に削除されます。保存済みのロッカー一覧、アカウントの確認結果、すべてのキャッシュは、常に削除されます。Remove data on uninstall がオンの場合は、配送業者が削除されます（注文は履歴を保持します）。また、設定とログも削除されます。オフの場合は、配送業者がオフになるだけで、すべての設定は保持されます。モジュールを再インストールすると、保存されていた配送業者は以前のステータスに戻ります。既存の注文は、保存されたロッカーを保持します。
Sameday と easybox は、それぞれの所有者の商標です。本モジュールは Sameday とは提携しておらず、Sameday による推奨も受けていません。