VibeFox Balikobot for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 7.0 以降。インストールされ、有効であること。WooCommerce がないとプラグインは有効化できません。
PHP: 8.0 以降。
Balikobot アカウント（リアルタイム料金とピックアップポイント用）: API アクセスが有効な Balikobot アカウントが必要です。API ユーザーと API キーは、Balikobot のクライアントゾーン（client.balikobot.cz）にあります。Balikobot サポート（podpora@balikobot.cz）が、お客様のアカウントと配送業者の API を有効にします。リアルタイム料金には、Balikobot が "transportcosts" に対応している配送業者とサービスが必要です。ピックアップポイントには、"branchlocator" に対応している配送業者が必要です（例: Česká pošta、Zásilkovna、PPL、DPD、GLS）。不明な場合は Balikobot サポートにお問い合わせください。固定料金は、アカウントがなくても利用できます。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_balikobot フォルダーを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます。WooCommerce > Settings > Shipping > VibeFox Balikobot、またはプラグインページのプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. API ユーザーと API キーを入力し、配送業者、サービスタイプ、料金ソース、国ごとの料金を選択します（「設定」を参照）。受け取りサービスの場合は Pickup point selection を有効にします。
6. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーン（例: チェコ）に VibeFox Balikobot を追加するか、Ignore shipping zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox Balikobot。設定はすべての配送ゾーンに適用されます。配送方法、リアルタイム料金、またはピックアップポイントを非表示にしてしまう設定については、ページ上部に警告が表示されます。設定を保存するたびに、キャッシュされた料金とピックアップポイントは消去されます。配送方法をゾーンに追加すると、ゾーンのウィンドウには次の項目だけが表示されます:
Title (zone): このゾーンの顧客に表示される配送方法名。空欄にすると、全体の Name が使用されます。
一般
Enable/Disable: すべてのゾーンで Balikobot 配送を一括でオンまたはオフにします。
Name: 顧客に表示される配送方法名。ゾーンでは独自の Title で上書きできます。既定値: Balikobot。
Tax status: Taxable は、WooCommerce が料金に配送税を加算することを意味し、None は加算しないことを意味します。Balikobot の料金は通常、税抜きです。
Balikobot API アカウント（リアルタイム料金とピックアップポイントに必要）
API user: クライアントゾーンにある Balikobot の API ユーザー。
API key: クライアントゾーンにある Balikobot の API キー。
Carrier: 料金とピックアップポイントに使用する Balikobot の配送業者: Česká pošta（既定）、Zásilkovna（Packeta）、PPL、DPD、GLS、DHL Express、UPS、TNT、FedEx、Geis、InTime、Uloženka、Toptrans、Pošta bez hranic、Slovenská pošta、SPS（Slovak Parcel Service）、Magyar Posta。Balikobot アカウントで有効化されている必要があります。
Service type: 配送業者の Balikobot サービスコード。既定値: NP。Česká pošta の場合: NP = 郵便局への荷物、NB = Balíkovna への荷物、DR = 自宅配達。その他の配送業者のコードは、Balikobot のクライアントゾーンと API ドキュメントに記載されています。
料金（すべての料金はストアの通貨で表示）
Price source: 料金の計算方法。
Country prices: 配送先の国ごとの固定料金（2 文字の国コード、例: CZ、SK）。その他すべての国には * を使用します。小数点はドットまたはカンマで入力できます。固定モードと、API 失敗時の代替として使用されます。料金がない国（* の行もない国）には、固定料金は適用されません。
Fixed price per: Order は料金を 1 回だけ請求します。Item (price × quantity) は、カート内の商品数を掛けた料金を請求します。これは固定料金にのみ適用されます。Balikobot のリアルタイム料金は、常に荷物全体に対するものです。
Exchange rate: Balikobot の料金通貨（通常は CZK）1 単位をストアの通貨に換算した値（例: 0.04）。Balikobot が別の通貨で料金を返した場合にのみ使用されます。空欄にすると、そのような料金は拒否され、顧客が誤った料金を請求されることはありません。
条件
Min weight (kg): カートがこの重量より軽い場合、配送方法を非表示にします。0 は制限なしを意味します。商品の重量は、ストアの重量単位から換算されます。
Max weight (kg): カートがこの重量より重い場合、配送方法を非表示にします。既定値: 100。0 は制限なしを意味します。
Minimum order amount: カートの小計（割引適用後、税抜き）がこの金額以上の場合にのみ配送方法を表示します。空欄にすると、常に表示されます。
Excluded shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、配送方法を非表示にします。
Free shipping: 以下の金額以上で送料無料を有効にします。
Free shipping from: 送料が無料になるカート小計（割引適用後、税抜き）。この場合、API へのリクエストは行われません。
配送ゾーンなしでの利用可否
Ignore shipping zones: 対応するゾーンに追加されていなくても、以下の国でこの配送方法を提供します。
Countries: このモードの配送先の国。空欄にすると、発送先としているすべての国が対象になります。Ignore shipping zones が有効な場合にのみ使用されます。
ピックアップポイント
Pickup point selection: 顧客はピックアップポイントを選択する必要があります。Česká pošta NP または NB、Zásilkovna などの受け取りサービスに使用します。API ユーザーと API キーが必要です。
Selector width: ピックアップポイントのリストの CSS 幅（例: 100% または 400px）。既定値: 100%。
詳細設定
Debug log: API リクエストと料金計算を WooCommerce > Status > Logs に、ソース "vfd-balikobot" で記録します。API のエラーは常に記録されます。認証情報と顧客の住所は記録されません。
Remove data on uninstall: オンの場合、プラグインを削除すると、その設定とゾーンの配送方法が削除されます。プラグインを無効化してもデータは削除されません。注文に保存されたピックアップポイントは保持されます。
チェックアウト時の動作
顧客が配送先住所を入力すると、プラグインはカートの重量、Minimum order amount、Excluded shipping classes を確認します。送料無料が適用される場合、料金は 0 になり、Balikobot へのリクエストは送信されません。
固定モードでは、料金は Country prices から取得されます。リアルタイムモードでは、プラグインは配送業者、サービスタイプ、配送先の国と郵便番号、およびカートの重量（kg）を Balikobot に送信します。リアルタイム料金は、顧客が郵便番号を入力した後にのみリクエストされます。別の通貨の料金は Exchange rate で換算されます。為替レートが設定されていない場合は拒否されます。
リアルタイム料金は 1 時間キャッシュされるため、同じカートでも新しいリクエストは発生しません。失敗したリクエストは 5 分間キャッシュされ、API のタイムアウトは 12 秒です。これにより、チェックアウトは更新のたびに Balikobot の応答を待つことがありません。API のエラーが顧客に表示されることはありません。配送方法が非表示になるか、代替モードでは固定料金が使用されます。詳細はログに記録されます。
この方法は、クラシックのチェックアウトと、カートおよびチェックアウトのブロックで動作します。WooCommerce の High-Performance Order Storage（HPOS）に対応しています。
プラグインは Balikobot で発送を作成したり、ラベルを印刷したり、集荷を依頼したりはしません。発送は Balikobot のクライアントゾーンで注文してください。荷物の追跡や注文ステータスの更新も行いません。すべてのゾーンで 1 つの配送業者と 1 つのサービスタイプが使用されます。ピックアップポイントは、地図なしのドロップダウンリストとして表示されます。
ピックアップポイント
Pickup point selection が有効な場合、クラシックのチェックアウトとブロックのチェックアウトの両方で、Balikobot のオプションの下にピックアップポイントのリストが表示されます。このリストは、顧客の国、市区町村、郵便番号をもとに、Balikobot の "branchlocator" から読み込まれます。市区町村と郵便番号が入力されるまで、顧客には Enter your city and postcode to see the pickup points. と表示されます。リストは 12 時間キャッシュされます。
選択は必須です。顧客には Please select a pickup point. と表示されます。サーバーは、選択されたポイントが配送先住所に属しているかも確認します。住所を変更した後は、顧客にピックアップポイントを選び直すよう求められます。ポイントを読み込めない場合は、顧客にしばらくしてから再試行するか、別の配送方法を選ぶよう案内されます。
選択されたピックアップポイントは注文に保存されます。管理画面の注文画面では、配送先住所の下に Balikobot pickup point として表示されます。Balikobot の支店 ID と配送業者も併せて表示され、Balikobot で発送を作成するときに必要です。Change をクリックすると、注文住所の近くにある別のポイントを選べます。顧客には、注文ページと注文メール（HTML とプレーンテキスト）で Pickup point として表示されます。既存の注文は、ピックアップポイントのデータをそのまま保持します。
ライセンスキー
このプラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは、WooCommerce > Settings > Shipping > VibeFox Balikobot の上部にあります。キーを License key に貼り付けて、Activate をクリックします。ブロックには、ライセンスの有効期限日などのステータスと、お客様のドメインが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで Balikobot は顧客に表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示されたまま表示されるので、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページにリマインダーが表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Balikobot が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、顧客の国のゾーンに配送方法が追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。設定ページ上部の警告を確認します。重量制限、Minimum order amount、Excluded shipping classes を確認します。固定モードでは、その国または * に料金が設定されているか確認します。
リアルタイム料金が表示されない: Debug log をオンにし、チェックアウトを再読み込みして、WooCommerce > Status > Logs（ソース "vfd-balikobot"）を開きます。ログに原因が表示されます: API 認証情報の不足、まだ郵便番号が入力されていない、配送業者とサービスに対する Balikobot のエラー、または Exchange rate が設定されていない別通貨の料金。Live Balikobot rate, fixed price if the API fails を使用している場合、問題を修正している間も顧客は固定料金を受け取れます。
料金の通貨が正しくない: 固定料金はストアの通貨で設定されています。Balikobot はリアルタイム料金を、Balikobot 契約の通貨（通常は CZK）で返します。ストアの通貨と異なる場合は、Exchange rate を設定してください。
税込みですか？ Balikobot の料金は通常、税抜きです。Tax status を Taxable に設定すると、WooCommerce が配送税を加算します。
リストにピックアップポイントがない: API ユーザーと API キーが設定されていること、配送業者が "branchlocator" に対応していること、顧客が市区町村と郵便番号を入力していることを確認してください。ログで Balikobot のエラーを確認します。
変更後に料金またはピックアップポイントが古いようである: 設定ページを保存してください。キャッシュされた料金とピックアップポイントが消去されます。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、キーが別のドメインで既に使用されている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべての設定は保持され、キャッシュのみが消去されます。削除するには、Plugins ページでプラグインを無効化してから削除してください。このプラグインのライセンスキーとライセンスステータス、およびキャッシュされた料金とピックアップポイントは、常に削除されます。設定とゾーンの配送方法は、Remove data on uninstall がオンの場合にのみ削除されます。それ以外の場合は、後で再インストールするために残されます。注文に保存されたピックアップポイントのデータは、削除されることはありません。
Balikobot は、その所有者の商標です。このプラグインは Balikobot と提携しておらず、Balikobot の承認も受けていません。