VibeFox Bob Go for OpenCart — ヘルプ
要件
OpenCart: 3.0.x（3.0.5.0 で動作確認済み）、または 4.0.2 以降（4.1.0.3 で動作確認済み）。
PHP: 8.0 以降。
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 つのドメインで使用できます。
インストール
ダウンロードは、両方の OpenCart バージョン用のパッケージを含む 1 つの zip ファイルです。お使いのコンピューターで解凍してください。README.txt、OpenCart 3 用パッケージ vfd_bob_go-oc3-(version).ocmod.zip、OpenCart 4 用パッケージ vfd_bob_go.ocmod.zip が含まれています。お使いの OpenCart バージョンに対応するパッケージのみをインストールしてください。ライセンスキーは両方のバージョンで同じです。
OpenCart 3
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_bob_go-oc3-(version).ocmod.zip を選択します。この拡張機能は OCMOD の変更を追加しないため、Extensions > Modifications を更新する必要はありません。Installer を使う代わりに、パッケージの upload フォルダーの内容をストアのルートフォルダーにコピーすることもできます。
2. Extensions > Extensions に移動し、拡張機能の種類として Shipping を選択します。VibeFox Bob Go を見つけて Install（緑色の + ボタン）をクリックします。
3. Edit（鉛筆のボタン）をクリックして設定ページを開きます。
4. Edit ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーの項を参照）。
5. Bob Go アカウントで、ストアを販売チャネルとしてインストールします。そのチャネルで "Rates at checkout" を有効にし、サービスと料金を設定します。
6. Edit ページで、ストアのドメイン、出荷元住所（発送元）、およびストアの通貨が ZAR でない場合は ZAR 換算レート（設定の項を参照）を確認します。Enable Bob Go をオンにして、Save をクリックします。
OpenCart 4
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_bob_go.ocmod.zip を選択します。ファイル名は変更しないでください。OpenCart 4 はファイル名から拡張機能のコードを取得するため、名前を変えたパッケージは動作しません。
2. 同じページのインストール済み拡張機能の一覧にパッケージが表示されます。その横の Install（緑色の + ボタン）をクリックします。
3. Extensions > Extensions に移動し、種類 Shipping を選択します。VibeFox Bob Go を見つけて、Install（緑色の + ボタン）をクリックし、次に Edit（鉛筆のボタン）をクリックします。
4. Bob Go を設定し、ライセンスキーと設定を、OpenCart 3 の手順 4 から 6 と同様に入力します。設定ページとそのフィールドは両方のバージョンで同じです。
インストール後は、Enable Bob Go をオンにして保存するまで、この方法はオフのままです。既定ではリアルタイムの Bob Go 料金を使用します。アンインストール後に拡張機能を再インストールすると、保持しておいた Bob Go の設定が再び使用されます。
設定
すべての設定は拡張機能のページにあります: Extensions > Extensions > Shipping > VibeFox Bob Go > Edit。セクションは左側に表示されます。1 つの Save ボタンで、ページを再読み込みせずにページ全体を保存します。保存のたびに、キャッシュされた Bob Go の料金も消去されます。数値は小数点区切りとしてピリオドまたはカンマを使えます。値が正しくない場合は何も保存されず、ページに理由が表示されます。Method title が空、または 64 文字を超えている場合、数値ではない値（"…" must be a number.）、負の金額または重量（"…" must be a number of 0 or more.）、ZAR conversion rate が 0 以下の場合、Minimum weight (kg) が Maximum weight (kg) より大きい場合、または不明な税クラスやジオゾーンの場合です。この拡張機能の変更権限を持つ管理者ユーザーだけが設定を保存できます。
設定の上部には、リアルタイム料金が機能しない場合に警告が表示されます: Live rates are not requested: your store currency is … — set the "ZAR conversion rate".、ストアに南アフリカのゾーン（州）がない場合、または単位が "kg" の重量クラスや単位が "cm" の長さクラスがない場合です。後者の場合、重量と寸法はそのクラスの単位名（kg、g、lb、oz、cm、mm、m、in）に従って換算され、それ以外の単位は kg または cm として扱われます。
全般
設定はすべてのジオゾーンに適用されます。チェックアウトでは、各 Bob Go サービスが配送方法名の下の個別の配送オプションになります。
Enable Bob Go: チェックアウトで Bob Go を表示するか非表示にします。既定値: オフ。
Method title: 購入者に表示される配送方法の名称です。"The Courier Guy - Economy" などの Bob Go サービスは、Bob Go の名称のままこの下に一覧表示されます。既定値: Bob Go。必須、最大 64 文字。
Shipping cost: 料金の計算方法です。
リアルタイム料金がない理由はログに記録されます。購入者に表示されることはありません。
Sort order: チェックアウトの配送方法の中で Bob Go が表示される位置です。整数。
Bob Go アカウント
このセクションでは、Bob Go で必要な設定を、Bob Go アカウント、Sales channels、Rates at checkout へのリンクとともに説明します。また、ストアのドメインに対する 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 または 403）、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 へ送信されます。OpenCart のストア住所は自由記述のため、ストアの国と地域（System > Settings > Store > Local）だけが使用されます。ストアの国が出荷元の国である場合、空欄の州はストアの地域から取得されます。市区町村、郵便番号、番地はここに入力してください。
Origin country: 発送元の国です。既定値: South Africa。Bob Go は南アフリカ国内のみに配送します。
Origin province: 南アフリカの州、または Store region (if in South Africa)。
Origin city / suburb: 発送元の市または地区です。例: Johannesburg。
Origin postal code: 発送元の郵便番号です。例: 2001。
Origin street address: 発送元の番地です。例: 123 Main Street。
固定料金（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 class: 送料の税クラス、または No tax（既定）です。Bob Go の料金には通常すでに付加価値税が含まれています。その場合、送料に税金が二重にかからないよう No tax のままにしてください。
Geo zone: この地域内の住所に対してのみ Bob Go を提供します。All zones（既定）は制限なしを意味します。Ignore shipping zones が有効な場合は使用されません。ジオゾーンは System > Localisation > Geo Zones で管理します。
配送ゾーンなしの利用可否
Ignore shipping zones: 有効にすると、ジオゾーンは確認されず、下の国に対してこの方法が提供されます。
Countries: このモードの配送先の国です。空欄にするとすべての国を許可します。Ignore shipping zones が有効な場合にのみ使用されます。
詳細設定
Debug log: 料金の計算と Bob Go へのリクエストを storage/logs/vfd_bobg_debug.log.php に書き込みます。このファイルは Web から読み取れません。購入者の住所は記録されません。このオプションがオフでも、Bob Go のエラーは記録されます。作業が終わったらログをオフにしてください。ファイルが 5 MB に達すると、vfd_bobg_debug.old.log.php に移動され、新しいログが開始されます。
Log: ログのサイズと最新の記録を表示します。Clear log をクリックすると空にできます。
Remove data on uninstall: 有効にすると、拡張機能をアンインストールしたときに Bob Go の設定、キャッシュされた料金、ログが削除されます。注文とともに保存された Bob Go サービスは残ります。オフ（既定）の場合は、再インストールのためにすべてが保持されます。
インポート / エクスポート
Export: Download JSON をクリックすると、設定を JSON ファイルとして保存します。
Import: 以前エクスポートした JSON を貼り付け、Import をクリックすると設定を復元します。たとえば別のストアに復元する場合に使えます。値は通常の保存と同じように検証されます。
チェックアウトでの動作
OpenCart が配送方法を表示するとき、拡張機能に Bob Go の料金を問い合わせます。Geo zone が設定されていて（かつ Ignore shipping zones がオフ）、住所がそのゾーン外の場合、Bob Go は提供されません。Requires Shipping が Yes に設定された商品だけが対象になります。それ以外の商品は重量に加算されず、注文金額にも含まれません。次に拡張機能は、配送先の国（Ignore shipping zones の場合）、カートの重量、Minimum order amount を確認します。注文金額は、クーポン割引適用後、税抜きで、配送が必要な商品の価格です。ギフト券、ポイント、ストアクレジットは考慮されません。送料無料が適用される場合、購入者には Bob Go (free)（あなたの Method title）が表示され、Bob Go へのリクエストは送られません。
リアルタイムのモードでは、拡張機能はストアのドメイン、出荷元と配送先の住所（州を含む）、カート内の商品を Bob Go に送信します。商品価格は ZAR、重量と寸法、そして商品モデルは SKU として送信されます。南アフリカの住所の場合、OpenCart のゾーンは州コード（EC、FS、GP、KZN、LP、MP、NC、NW、WC）として送信されます。リアルタイム料金は、購入者が市区町村または郵便番号を入力した後にのみ問い合わせられます。ストアの通貨が ZAR でない場合、ZAR の料金は ZAR conversion rate で換算されます。料金は既定の通貨で計算され、その通貨の小数桁に丸められ、選択した Tax class の税額を含めて購入者の通貨で表示されます。
配送方法名の下には、Bob Go のサービスごとに 1 つのオプションが表示されます。サービス名、料金、Delivery dates が有効な場合は括弧内の配送予定日が含まれます。購入者は他の OpenCart の配送オプションと同様に、サービスを選択します。固定料金の場合は、配送方法名のオプションが 1 つだけ表示されます。
OpenCart 4 では、顧客はチェックアウトページの配送方法ブロックで Choose をクリックし、Shipping method options ウィンドウで Bob Go のサービスを選択します。例えば、料金とともに SkyNet - Overnight (by 17/10/2026) が表示されます。この方法は OpenCart 3 と同じように動作します。
料金は完全なリクエストごとに 1 時間キャッシュされるため、同じカートで新たにリクエストが発生することはありません。失敗したリクエストは 5 分間キャッシュされ、タイムアウトは 12 秒です。そのため、Bob Go の障害がチェックアウトの更新ごとに遅延を生むことはありません。リクエストの失敗がチェックアウトを止めることはありません。この方法は非表示になるか、フォールバックモードでは固定料金が使われます。理由はログに記録されます。
この拡張機能は料金の表示のみを行います。発送書類、送り状、ラベルの作成、荷物の追跡、Bob Go との注文同期、通知の送信は行いません。出荷処理には Bob Go のダッシュボードを使用してください。集荷ポイントやロッカーの選択はありません。Bob Go は南アフリカ国内のみに配送します。
注文
選択したサービス名が注文の配送方法になるため、注文メール、Sales > Orders、購入者のアカウントに表示されます。注文が確定すると、Bob Go のサービス、そのコード、配送予定も注文とともに保存されます。その後のカートや Bob Go の料金の変更は、これらを変えません。OpenCart 4 では、チェックアウトで注文は 1 件のみ保持されます。顧客が戻って別の Bob Go サービスで注文を確定し直すと、保存されたサービスが更新されます。別の配送方法または固定料金を選ぶと、そのサービスは削除されます。
管理画面では、Sales > Orders の注文ページに Bob Go のブロックが表示され、Bob Go service（名称とコード）と Estimated delivery が示されます。購入者は、アカウント内の注文詳細ページで Bob Go service と Estimated delivery を確認できます。固定料金または送料無料の注文には Bob Go のサービスはありません。
ライセンスキー
この拡張機能は、vibefox.net で入手した VibeFox ライセンスキーで動作します。License — VibeFox Bob Go のライセンスブロックは、Extensions > Extensions > Shipping > VibeFox Bob Go > Edit の設定より上にある最初のブロックです。License key にキーを入力し、Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス（例えばライセンスの有効期限日とドメイン）、そして Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このストアからキーを削除）のボタンが表示されます。その下には Product: opencart-shipping-bob-go の行と、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 のアカウントで枠を解放してください。
有効なキーがない場合、Bob Go はチェックアウトで顧客に表示されず、料金も計算されません。同じブラウザーで管理画面にログインしている管理者ユーザーには、(unlicensed — visible to admins only) の表示付きで、ストアにこの方法が引き続き表示されます。そのため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 ではこのプレビューは利用できません。ストアは管理画面のログインを認識しないため、有効なキーがない場合、この方法はすべての人から非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× をクリックすると、7 日間非表示になります。既存の注文には影響しません。
ライセンスの期限が切れても、拡張機能は動作し続けますが、アップデートとサポートには更新が必要です。管理画面の Dashboard または Edit ページを開くと、ステータスは自動的に再確認されます。キー入力後の最初の 14 日間は 1 日に 1 回、その後は 1 週間に 1 回です。cron ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは必ず削除されます。
トラブルシューティング
Bob Go がチェックアウトに表示されない: ライセンスが有効であること、Enable Bob Go がオンであることを確認してください。Geo zone を確認するか、Ignore shipping zones をオンにして Countries を確認します。重量の制限と Minimum order amount を確認してください。固定料金モードでは、国、*、または Flat price に料金があることを確認します。商品の Requires Shipping が Yes になっていることも確認してください。
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 を使用している場合は、問題を修正するまでの間も購入者は固定料金を受け取ります。
ストアの通貨がランドではない: Bob Go は ZAR で見積もります。1 ZAR がストアの通貨でいくらになるかを入力してください。これがないと、拡張機能は Bob Go に料金を問い合わせません。固定料金は引き続き機能します。
南アフリカにゾーンがないと警告が表示される: System > Localisation > Zones で南アフリカの州を追加してください。追加しないと、Bob Go は南アフリカの住所の州を受け取れません。
配送料に税金が二重にかかる: Bob Go の料金には通常、付加価値税が含まれています。Tax class を No tax に設定してください。
変更後に料金が古いように見える: 拡張機能のページで Save をクリックしてください。これにより、キャッシュされた Bob Go の料金が消去されます。Bob Go アカウントでの変更は、1 時間のキャッシュ後、または設定を保存したときに反映されます。
ページに "Warning: You do not have permission to modify VibeFox Bob Go!" と表示される: 管理者のユーザーグループは設定の閲覧のみが可能な可能性があります。System > Users > User Groups で、そのグループに extension/shipping/vfd_bob_go（OpenCart 3）または extension/vfd_bob_go/shipping/vfd_bob_go（OpenCart 4）の変更権限を付与してください。
開発者向け: Bob Go の API アドレスは、設定 vfd_bobg_api_url（テスト用）で置き換えることができます。設定ページにはこの項目のフィールドはありません。
アンインストール
Extensions > Extensions に移動し、種類 Shipping を選択して、VibeFox Bob Go の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは常に削除されます。OpenCart は常に Enable Bob Go、Sort order、Tax class、Geo zone をリセットします。キャッシュされた料金は常に削除されます。Remove data on uninstall がオンの場合は、Bob Go の設定とログも削除されます。オフの場合、ほかの設定は保持され、拡張機能を再インストールしたときに再び使用されます。注文とともに保存された Bob Go のサービスは常に残り、既存の注文は配送方法と料金を保持します。
OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に移動し、インストール済み拡張機能の一覧で VibeFox Bob Go の横にある Uninstall（オレンジ色の − ボタン）をクリックしてから、アップロードしたパッケージを削除するために Delete（赤いゴミ箱のボタン）をクリックします。
Bob Go は、それぞれの所有者の商標です。この拡張機能は Bob Go とは提携しておらず、Bob Go による承認も受けていません。