VibeFox Sameday Easybox for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 7.0 以降。インストールされて有効になっている必要があります。WooCommerce がないとプラグインは有効化できません。
PHP: 8.0 以降。
Sameday API のユーザー名とパスワード: API へのアクセスは、ルーマニア、ハンガリー、ブルガリアの Sameday ビジネスアカウントに含まれます。Sameday のアカウントマネージャーまたは Sameday 連携チームにお問い合わせください。認証情報は eAWB ポータル（eawb.sameday.ro、.hu、.bg）と同じであることがよくあります。デモ API については、Sameday から別のテスト用認証情報が提供されます。API のユーザー名とパスワードがない場合、購入者がロッカーを選べないため、この配送方法は提供されません。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインでのみ使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_sameday_easybox フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます。WooCommerce > Settings > Shipping > VibeFox Sameday Easybox、またはプラグインページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. Sameday の API username と API password を入力し、Sameday country を選んで保存します。ページに "Connected to Sameday ... easybox lockers" と表示されるはずです。Pickup point と Easybox service は、アカウントから自動で入力されます。
6. 料金を設定します。ストアの通貨が Sameday の通貨と異なる場合は Exchange rate of the estimate を設定し、Country prices の行（例: * Default）または Fallback cost を設定します。
7. WooCommerce > Settings > Shipping > Shipping zones で、Sameday の国に対応する配送ゾーンに VibeFox Sameday Easybox を追加するか、Ignore shipping zones を有効にします。
設定
すべての設定は 1 つのページにあります。WooCommerce > Settings > Shipping > VibeFox Sameday Easybox です。設定はすべての配送ゾーンに適用されます。ゾーンにこの方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます。
Title (zone): そのゾーンで購入者に表示される名前です。空欄にすると、全体の Name が使われます。
設定の上には接続ステータスが表示されます。Sameday のホスト、easybox ロッカーの数、一覧の最終更新日時、または Sameday がユーザー名かパスワードを拒否したことを示します。また、認証情報がない、料金がない、見積もりに必要な為替レートがないなど、設定の問題も一覧表示されます。
すべての料金と制限値は、小数点としてカンマまたはピリオドを使用できます（4,99 または 4.99）。無効な数値は、メッセージとともに拒否されます。
一般
Enable/Disable: すべてのゾーンでこの方法を一度にオンまたはオフにします。
Name: 購入者に表示される配送方法の名前です。ゾーンは独自の Title で上書きできます。Default: Sameday easybox。
Tax status: Taxable は送料に WooCommerce の税金を加算し、None は加算しません。
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 の見積もり（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）。設定しない場合、見積もりは使われず、料金表が適用されます。レフとユーロは、固定レートで自動的に換算されます。
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 つの行にある場合、保存時には最初の行だけが残ります。セルが有効な数値でない場合、料金表は保存されません。
Fallback cost: Sameday の見積もりがなく、国別の料金表に配送先の行がない場合に使われます。空欄にすると、その場合この配送方法は提供されません。
Free shipping from: easybox 配送が無料になるカート小計です（割引後、税抜き）。料金が見つかった場合にのみ適用されます。国の行、* Default の行、代替送料（この場合は見積もりを要求しません）、または Sameday の見積もりです。空欄にすると、送料無料は提供されません。
提供条件
Minimum weight (kg): カートの重量がこの値より軽い場合、この方法を非表示にします。重量はストアの重量単位から換算されます。空欄または 0 は、制限なしを意味します。
Maximum weight (kg): この重量を超える荷物には easybox 配送は提供されません。Default: 30。Sameday 契約の制限と easybox ボックスのサイズを確認してください。空欄または 0 は、制限なしを意味します。
Minimum cart subtotal: カート小計（割引後、税抜き）がこの金額に達した場合にのみ、この方法を提供します。
Excluded shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、この方法を非表示にします。
Ignore shipping zones: オンの場合、この方法が対応する配送ゾーンに追加されていなくても、下で選択した国に対してこの方法を提供します。オフの場合は、追加されたゾーンでのみ提供されます。
Countries (ignore zones mode): このモードでの配送先の国です。空欄にすると、Sameday の国が使われます。Sameday の国以外は除外されます。このフィールドは Ignore shipping zones がオンの場合にのみ使用されます。
詳細設定
Debug log: 料金計算、API の呼び出し、ロッカーの選択内容を WooCommerce > Status > Logs に書き込みます（ソースは "vfd-sameday-easybox"）。API のエラーは常に記録されます。パスワード、トークン、購入者の個人情報は記録されません。作業が終わったらログをオフにしてください。
Remove data on uninstall: オンの場合、プラグインを削除すると、設定とこの方法のゾーンインスタンスが削除されます。プラグインを無効化しても、何も削除されません。注文に保存されたロッカーは常に保持されます。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce がプラグインに料金を問い合わせます。プラグインは次の条件を確認します。Sameday アカウントの配送先の国、API の認証情報と利用可能なロッカー一覧、カートの重量、カート最低小計、除外する配送クラスです。次に料金を探します。Sameday の見積もり、国別の料金表、代替送料の順です。料金がない場合、この方法は非表示になります。送料無料が適用される場合、購入者は無料でこの方法を確認できます。
それ以外の場合、購入者が都市と都道府県を入力すると、プラグインは Sameday に見積もりを要求します。集荷ポイント、サービス、荷物の重量、購入者の番地、市区町村、都道府県、郵便番号を送信します。氏名、メールアドレス、電話番号は送信されません。ブカレストは、公式の Sameday プラグインと同様に "Sector 1" として送信されます。見積もりはストアの通貨に換算されます。見積もりがない場合（未設定、都市や都道府県が未入力、エラー、為替レートがない）、料金は国別の料金表から、次に代替送料から取得されます。料金がない場合、この方法は非表示になります。
Sameday の問題がチェックアウトを妨げることはありません。見積もりは 1 時間キャッシュされます。エラーは 10 分間キャッシュされます。タイムアウトやサーバーエラーの後は、5 分間見積もりを要求しません。リクエストは 15 秒でタイムアウトします。チェックアウト時のロッカー一覧は、Sameday からではなく、お使いのサーバーから読み込まれます。
この方法は、クラシックチェックアウトと、カートブロックおよびチェックアウトブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。
本プラグインは、AWB（出荷）の作成、ラベルの印刷、荷物の追跡、代引きの処理を行いません。宅配便による自宅への配送や、Sameday の地図ウィジェットはありません。AWB は、Sameday eAWB ポータルまたは普段お使いのツールで、注文に表示されたロッカー ID を使って作成してください。
ロッカーの選択
購入者がこの方法を選ぶと、その下に easybox locker のブロックが表示され、2 つのリストが表示されます。- Select city - と - Select easybox locker - です。購入者の都市にロッカーがある場合は、その都市が自動的に選択されます。各ロッカーには、名前と住所が表示されます。選択内容は、チェックアウトが更新されたとき、またはページを再読み込みしたときも保持されます。
ロッカーの選択は必須です。選択しないと、チェックアウトは "Please choose a Sameday easybox locker." と表示して停止します。サーバーは、クラシックチェックアウトとブロックチェックアウトの両方で、選択されたロッカーが一覧にあることを確認します。偽造されたロッカー ID や一覧から削除されたロッカー ID は、"The selected easybox locker is not available any more. Please choose another easybox locker." というメッセージとともに拒否されます。注文に保存される名前と住所は、ブラウザではなく一覧から取得されます。
管理画面の注文画面: 配送先住所の下に、Sameday easybox locker として名前と住所、Sameday AWB 用の Locker ID が表示されます。easybox の注文にロッカーがない場合、画面には "No easybox locker was selected for this order." と表示されます。
サンキューページと注文の表示: Sameday easybox locker: と名前および住所です。
注文メール: HTML メールとプレーンテキストメールに、ロッカーの名前と住所が含まれます。管理者向けのメールには Locker ID も含まれます。
データベースでは、ロッカーは注文のメタデータ _vfd_sdeb_locker_id（AWB 用の Sameday ロッカー ID）と _vfd_sdeb_locker_name（名前と住所）に保存されます。
ライセンスキー
このプラグインは、vibefox.net で取得した VibeFox ライセンスキーを使用します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Sameday Easybox の上部にあります。キーを License key に貼り付けて、Activate をクリックします。ブロックには、ライセンスの有効期限日やお使いのドメインなどのステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、Sameday easybox はチェックアウトで購入者に表示されません。ログイン中のストア管理者には表示され、(unlicensed — visible to admins only) と表示されます。そのため、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページにはお知らせが表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作を続けます。ただし、アップデートとサポートには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。
トラブルシューティング
Sameday easybox がチェックアウトに表示されない: ライセンスが有効か、Enable/Disable がオンか、API のユーザー名とパスワードが入力されているか、設定ページに "Connected to Sameday" と表示されているか、配送先の国が Sameday アカウントの国と一致しているかを確認してください。料金が利用可能か（Sameday の見積もり、国の行、* Default の行、または Fallback cost）、重量と小計の制限、Excluded shipping classes、この方法が該当するゾーンに追加されているか（または Ignore shipping zones がオンか）を確認してください。WooCommerce > Status > Logs で理由を確認するには、Debug log をオンにします。
Sameday が API のユーザー名またはパスワードを拒否した: 内容を確認してから、もう一度保存してください。デモ用認証情報は Test mode がオンの場合にのみ有効で、本番用認証情報はオフの場合にのみ有効です。それまでは、保存済みのロッカー一覧がある場合はそれが提供され、Sameday の見積もりは使用されません。
料金が Sameday ではなく、自分の料金表から来ている: 見積もりには Pickup point、Easybox service、そしてストアの通貨が Sameday の通貨と異なる場合は Exchange rate of the estimate が必要です。見積もりは、購入者が都市と都道府県を入力した後にのみ要求されます。Sameday に接続できない場合やエラーが返された場合は、料金表または代替送料が使われます。理由はログに記録されます。
ロッカー一覧が古い、または表示されない: 設定を保存してください。一覧が空の場合、1 時間より古い場合、または前回の読み込みに失敗した場合は、再度読み込まれます。更新に失敗した場合は、前回の一覧が使われ、ステータスにその旨が表示されます。
誤って送料が無料になっている: Country prices で、Price が 0 の行を確認してください。特に、+ Add country で追加して未入力のままにした * Default の行が対象です。
国境をまたぐロッカー: 開発者は vfd_sdeb_countries フィルターを使って配送先の国を追加できます。ロッカー一覧は常にお使いのアカウントのものです。
ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。たとえば、キーが別のドメインで既に使われている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化すると、すべてのデータは保持され、毎日のロッカー一覧の更新だけが停止します。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは、保存されたロッカー一覧、アカウント確認の結果、すべてのキャッシュとともに、常に削除されます。設定とゾーンの配送方法は、Remove data on uninstall がオンの場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。既存の注文は、配送の明細と保存されたロッカーを保持します。
Sameday と easybox は、それぞれの所有者の商標です。本プラグインは Sameday と提携しておらず、Sameday の承認も受けていません。