VibeFox Bob Go for PrestaShop — ヘルプ
要件
PrestaShop: 8.0～9.x。
PHP: 8.0 以降。古い PHP バージョンではモジュールをインストールできません。
Bob Go アカウント（リアルタイム送料の場合のみ必要）: Bob Go は API キーを使用しません。Bob Go アカウント（bobgo.co.za）が必要で、Bob Go アカウントでショップを WooCommerce の販売チャネルとしてインストール（Sales channels）し、そのチャネルで「Rates at checkout」を有効にしておく必要があります。サービス、料金、ルールは Bob Go で設定します。固定料金のみを使用する場合、Bob Go アカウントは不要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. 管理画面で Modules > Module Manager に移動し、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら Configure をクリックします。後で探す場合は、モジュール一覧で VibeFox Bob Go を見つけて Configure をクリックします。
3. Configure ページ上部のライセンスブロックで、VibeFox ライセンスキーを License key に入力し、Activate をクリックします（「ライセンスキー」を参照）。
4. Bob Go アカウントで、ショップを販売チャネルとしてインストールします。そのチャネルで「Rates at checkout」を有効にし、サービスと料金を設定します。
5. Configure ページで、ショップのドメイン、発送元住所（出荷元）を確認します。ショップの通貨が ZAR でない場合は、ZAR 換算レートも確認します（「設定」を参照）。ショップの南アフリカの住所に州が設定されていない場合は、Add South African provinces をクリックします。Save をクリックします。
インストール時に、モジュールは配送時間テキスト Courier delivery (South Africa) を持つ Bob Go 配送業者を作成します。配送業者は有効で、すべてのゾーンとすべての顧客グループに割り当てられ、デフォルトで Bob Go のリアルタイム送料を使用します。ゾーン、顧客グループ、配送時間、ロゴ、サイズ制限は Shipping > Carriers で変更できます。ここで料金を設定しないでください。料金は常にモジュールから取得されます。
設定
すべての設定はモジュールのページにあります: Modules > Module Manager > VibeFox Bob Go > Configure。設定は配送業者のすべてのゾーンに適用されます。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。保存するたびに、キャッシュされた Bob Go の送料も消去されます。数値は小数点またはカンマを小数点区切りとして入力できます。値が正しくない場合、ページにエラーが表示され、何も保存されません。数値ではない値（"…" must be a number.）、負の金額または重量（"…" must be a number of 0 or more.）、0 以下の ZAR conversion rate、Maximum weight より大きい Minimum weight、または 64 文字を超える Method title の場合です。
フォームの上部には、リアルタイム送料が機能しない場合に警告が表示されます: Live rates are not requested: your store currency is … — set the "ZAR conversion rate".、南アフリカの住所に州がない場合（下の 南アフリカの州 を参照）、またはショップの重量または寸法の単位が認識されず kg または cm として扱われている場合です。単位は International > Localization（Local units）で設定します。
一般
Enable Bob Go: 配送業者を有効または無効にします。これは Shipping > Carriers の配送業者ステータスと同じスイッチです。
Method title: 顧客に表示される配送業者名です。Bob Go のサービス（例: 「The Courier Guy - Economy」）は、チェックアウトでこの名前の下に Bob Go の名前で表示されます。デフォルト: Bob Go。必須、最大 64 文字です。
Shipping cost: 料金の計算方法です。
リアルタイム送料が取得できない理由はログに記録されます。顧客には表示されません。
Bob Go アカウント
このセクションでは、Bob Go で必要な設定を説明し、ショップのドメインに対する Bob Go からの最新の応答を表示します: connected、the WooCommerce channel is not installed on Bob Go (HTTP 404)、"Rates at checkout" is not enabled for this channel (HTTP 401)、エラーコード付きの request failed、または no connection。
Store domain: Bob Go はショップをドメインで識別します。空欄のままにすると、プレースホルダーとして表示されるショップのドメインが使用されます。Bob Go 上のチャネルが別のアドレスにインストールされている場合にのみ、別のドメインを入力してください（例: サブフォルダにあるショップの場合は example.co.za/shop）。スキームと末尾のスラッシュは削除されます。
ZAR conversion rate: Bob Go は南アフリカ・ランド（ZAR）で見積もります。ショップのデフォルト通貨が ZAR でない場合は、1 ZAR がお使いの通貨でいくらになるかを入力します（例: 0.05）。送料はこのレートで換算され、商品価格は ZAR で Bob Go に送信されます。お使いの通貨で Bob Go のリアルタイム送料を使用したくない場合は空欄のままにします（固定料金は引き続き機能します）。レートは 0 より大きい必要があります。ショップの通貨が ZAR の場合は空欄のままにします。
Delivery dates: チェックアウトで各サービスの横に、Bob Go が推定した配送日の範囲を表示します。推定日は常に注文と一緒に保存され、注文ページで確認できます。
発送元（出荷元住所）
発送元住所は、送料のリクエストごとに Bob Go に送信されます。Shop Parameters > Contact > Stores のショップ住所が同じ国にある場合、空欄の項目はそこから補完されます。
Origin country: 発送元の国です。デフォルト: 南アフリカ。Bob Go は南アフリカ国内の配送のみを行います。
Origin province: 南アフリカの州、または Store province (if in South Africa)。
Origin city / suburb: 発送元の都市または地区です（例: ヨハネスブルグ）。
Origin postal code: 発送元の郵便番号です（例: 2001）。
Origin street address: 発送元の番地です。
南アフリカの州: PrestaShop には南アフリカの州がないため、その国の顧客の住所には州が設定されていませんが、Bob Go では州が必要です。Add South African provinces をクリックすると、9 つの州（コード EC、FS、GP、KZN、LP、MP、NC、NW、WC）が南アフリカの州として追加され、南アフリカの住所に州の項目が表示されます。コードまたは名前で既に存在する州は再度追加されません。ボタンをクリックするまで何も変わりません。州が設定されると、項目には South African addresses have a province と、その件数が表示されます。
固定料金（Shipping cost が Fixed prices (below) の場合に使用され、また Bob Go が送料を返さない場合の代替として使用されます）
Price per country: 国ごとに 1 行です。2 文字の国コード、等号、ショップのデフォルト通貨での料金（税抜き）を入力します（例: ZA=99.99）。その他のすべての国には * を使用します（例: 次の行に *=199.99）。形式の異なる行は保存時に削除され、ページには警告として一覧表示されます。
Flat price: 上の行がない国に適用される料金です。空欄のままにすると、その国では配送業者が非表示になります。
Fixed price applies: Per order は料金を 1 回だけ請求します。Per item (price × quantity) は、カート内の商品数を掛けた金額を請求します。Bob Go のリアルタイム送料は常に出荷全体に対するものです。
条件
Minimum weight: カートの重量がこの値未満の場合、配送業者を非表示にします（kg 単位）。0 は制限なしを意味します（デフォルト）。
Maximum weight: カートの重量がこの値を超える場合、配送業者を非表示にします（kg 単位）。0 は制限なしを意味します（デフォルト）。両方の制限を設定する場合、最小値は最大値を超えることはできません。
Minimum order amount: カートの小計（配送が必要な商品、割引後、税抜き）がこの金額以上の場合にのみ配送業者を表示します。空欄のままにすると、常に表示されます。
Free shipping: 下記の注文金額に達した場合に送料無料を有効にします。
Free shipping from: 送料無料となるカートの小計（割引後、税抜き）です。Free shipping が有効な場合にのみ使用されます。この場合、Bob Go に送料はリクエストされません。
Tax: 配送業者の税ルール、または No tax（デフォルト）です。Bob Go の送料には通常すでに消費税が含まれています。その場合は、税を二重に請求しないように No tax のままにします。
配送ゾーンを使わない場合の提供
Ignore shipping zones: 有効にすると、配送業者はすべてのゾーン（後で作成されたゾーンを含む）に関連付けられ、下記の国に対して提供されます。無効にすると、Shipping > Carriers で配送業者に設定されたゾーンでのみ提供されます。以前に設定されていたゾーンは元に戻されます。
Countries: このモードでの配送先の国です。空欄のままにすると、発送可能なすべての国が対象になります。Ignore shipping zones が有効な場合にのみ使用されます。
詳細設定
Debug log: 送料の計算と Bob Go へのリクエストを、モジュールフォルダ内の logs/vfd_bobg_debug.log.php に記録します。このファイルは Web から開くことはできません。顧客の住所は記録されません。この設定が無効でも、Bob Go のエラーは記録されます。作業が終わったら、ログをオフにしてください。
Log: ログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログが空になります。
Remove data on uninstall: 有効にすると、モジュールをアンインストールしたときに、Bob Go の設定、配送業者、キャッシュされた送料、ログが削除されます。注文と一緒に保存された Bob Go のサービスは保持されます。無効にすると、再インストールに備えてすべてが保持されます。
チェックアウトでの動作
配送の手順で PrestaShop はモジュールに Bob Go の料金を問い合わせます。対象となるのは実物の商品のみです。バーチャル商品は重量に加算されず、注文金額にも含まれません。モジュールはまず配送先の国（Ignore shipping zones を使用）、カートの重量、Minimum order amount を確認します。送料無料が適用される場合、配送業者は無料として表示され、Bob Go へのリクエストは送信されません。
リアルタイムモードでは、モジュールはショップのドメイン、発送元と配送先の住所（州を含む）、カートの商品を Bob Go に送信します。商品価格は ZAR で送信されます。リアルタイム送料は、顧客が市区町村または郵便番号を入力した後にのみリクエストされます。ショップの通貨が ZAR でない場合、ZAR の送料は ZAR conversion rate で換算されます。料金はショップのデフォルト通貨で計算され、その後、顧客のカートの通貨で表示されます。
Bob Go の配送業者の下に、顧客には Choose a delivery service: と、Bob Go のサービスごとに 1 つのオプションが表示されます。各オプションにはサービス名、料金、そして Delivery dates が有効な場合は推定配送日が含まれます。最初のサービスがデフォルトで選択されています。顧客が別のサービスを選ぶと、その選択はすぐに保存され、配送業者の料金とカートの合計が更新されます。配送業者の料金は、選択したサービスの料金と同じです。住所に対してそのサービスが提供されなくなった場合、顧客には This service is not available for your address any more. Please choose another one. と表示されます。保存に失敗した場合のメッセージは The service could not be saved. Please try again. です。サービス一覧は Classic テーマと Hummingbird テーマで動作します。
送料は、完全なリクエストごとに 1 時間キャッシュされるため、同じカートで新たにリクエストが発生することはありません。失敗したリクエストは 5 分間キャッシュされ、タイムアウトは 12 秒です。これにより、Bob Go の障害がチェックアウトの更新のたびに遅延を生じさせることはありません。リクエストが失敗してもチェックアウトが止まることはありません。配送業者は非表示になるか、代替モードでは固定料金が使用されます。理由はログに記録されます。
注文が入った後に Shipping > Carriers で配送業者を編集すると、PrestaShop はそれを新しいバージョンの配送業者として保存します。モジュールは自動的に新しいバージョンに従います。
モジュールは送料を表示するだけです。出荷、送り状、ラベルの作成、荷物の追跡、Bob Go への注文同期、通知の送信は行いません。出荷処理には Bob Go のダッシュボードを使用してください。集荷ポイントやロッカーの選択機能はありません。Bob Go が配送するのは南アフリカ国内のみです。
注文
注文が確定すると、選択された Bob Go のサービス、そのコード、配送の推定日が注文と一緒に保存されます。その後のカートの変更や Bob Go の料金の変更によって、これらが変わることはありません。
管理画面の注文ページには、Bob Go ブロックが表示され、Bob Go service（名前とコード）と Estimated delivery が含まれます。顧客は、アカウントの注文詳細ページで Bob Go service と Estimated delivery を確認できます。固定料金または送料無料の注文には、Bob Go のサービスはありません。
ライセンスキー
本モジュールは、vibefox.net の VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Bob Go は、設定の上にある Modules > Module Manager > VibeFox Bob Go > Configure の最初のブロックです。キーを License key に入力し、Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス（ライセンスの有効期限日やお使いのドメインなど）、Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このショップからキーを削除）のボタンが表示されます。その下には Product: presta-shipping-bob-go の行と、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 アカウントで枠を解放してください。
有効なキーがない場合、Bob Go の配送業者はチェックアウトで顧客に表示されず、送料も計算されません。PrestaShop のフロントエンドは、管理画面にログインしていることを認識しないため、配送業者はお客様にも表示されません。キーを購入する前にモジュールを設定することはできますが、チェックアウトでのテストはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れてもモジュールは動作し続けますが、アップデートとサポートには更新が必要です。管理画面で作業している間、ステータスは自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは必ず削除されます。
トラブルシューティング
チェックアウトに Bob Go が表示されない: ライセンスが有効であること、Enable Bob Go がオンであることを確認してください。Shipping > Carriers で、配送業者が顧客の国のゾーンと顧客のグループを対象にしていることを確認するか、Ignore shipping zones をオンにして Countries を確認してください。重量の制限と Minimum order amount を確認してください。固定料金モードでは、その国、*、または Flat price に料金が設定されていることを確認してください。商品ページで、商品を特定の配送業者のみに制限している場合もあります。
Bob Go の送料が表示されない: モジュールのページを開きます。Bob Go アカウントのセクションには、Bob Go からの最新の応答が表示されます。"The WooCommerce channel is not installed on Bob Go"（HTTP 404）は、ショップのドメインが Bob Go の販売チャネルとして登録されていないことを意味します。Store domain を確認してください。"Rates at checkout is not enabled"（HTTP 401）は、そのチャネルでこの機能が無効になっていることを意味します。また、顧客が市区町村または郵便番号を入力していること、ZAR 以外の通貨のショップでは ZAR conversion rate が設定されていることも確認してください。Debug log をオンにし、チェックアウトを再読み込みして、Log の項目を確認してください。Bob Go live rates, fixed prices if Bob Go returns no rates を使用している場合、問題を修正するまでの間も、顧客には固定料金が適用されます。
ショップの通貨が ZAR ではない: Bob Go は ZAR で見積もります。1 ZAR がショップの通貨でいくらになるかを入力してください。入力しない場合、モジュールは Bob Go に送料をリクエストしません。固定料金は引き続き機能します。
南アフリカの住所に州がないという警告が表示される: 発送元（出荷元住所） セクションの Add South African provinces をクリックしてください。既存の顧客住所は、編集されたときにのみ州が設定されます。
配送料に税金が二重に請求される: Bob Go の送料には通常、消費税が含まれています。Tax を No tax に設定してください。
変更後に送料が古いままに見える: モジュールのページで Save をクリックしてください。これにより、キャッシュされた Bob Go の送料が消去されます。Bob Go アカウントでの変更は、1 時間のキャッシュが切れた後、または設定を保存したときに反映されます。
Bob Go の配送業者が見つからないと表示される: 配送業者は Shipping > Carriers で削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。
アンインストール
Modules > Module Manager に移動し、VibeFox Bob Go の横にあるメニューを開き、Uninstall を選択します。ライセンスキー、ライセンスステータス、キャッシュされた送料は常に削除されます。Remove data on uninstall が有効な場合、配送業者は削除され（注文の履歴は残ります）、設定、ログ、未完了のカートのサービス選択が削除されます。無効な場合、配送業者は無効化されるだけで、すべての設定が保持されます。モジュールを再インストールするか Reset を実行すると、保存されていた配送業者は以前の状態に戻ります。有効だった配送業者は再び有効になり、無効だった配送業者は無効のままです。注文と一緒に保存された Bob Go のサービスは、常に保持されます。
Bob Go は各所有者の商標です。本モジュールは Bob Go と提携しておらず、Bob Go による推奨もされていません。