VibeFox Bob Go for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 5.0 以降がインストールされ、有効になっていること。WooCommerce がないとプラグインは有効化できません。

PHP: 8.0 以降。

Bob Go アカウント（リアルタイム送料の場合のみ）: Bob Go に API キーはありません。Bob Go アカウント（bobgo.co.za）が必要です。Bob Go アカウントの販売チャネル（Sales channels）として WooCommerce ストアをインストールし、そのチャネルで「Rates at checkout」を有効にして、サービスと料金を Bob Go で設定してください。固定料金のみを使用する場合、Bob Go アカウントは不要です。

VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。

インストール

1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_bob_go フォルダを /wp-content/plugins/ にアップロードすることもできます。

2. Activate をクリックします。

3. Bob Go アカウントで、WooCommerce ストアを販売チャネルとしてインストールします。そのチャネルで「Rates at checkout」を有効にし、サービスと料金を設定してください。

4. 設定を開きます: WooCommerce > Settings > Shipping > VibeFox Bob Go。または、プラグインページでプラグイン名の下にある Settings をクリックします。

5. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。

6. ストアのドメイン、発送元（ship from）の住所、そしてストアの通貨が ZAR でない場合は ZAR 換算レートを確認します（「設定」を参照）。

7. WooCommerce > Settings > Shipping > Shipping zones で、南アフリカの配送ゾーンに VibeFox Bob Go を追加するか、Ignore shipping zones を有効にします。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox Bob Go。これらの設定はすべての配送ゾーンに適用されます。設定を保存するたびに、キャッシュされた Bob Go の送料は消去されます。ゾーンにこの方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます:

Title (zone): このゾーンの固定料金と送料無料に表示される名前です。空欄にすると、全体の Method title が使われます。リアルタイムの Bob Go 送料は、常に Bob Go で設定されたサービス名で表示されます。

一般

Enable/Disable: すべてのゾーンでこの方法を一度に有効または無効にします。

Method title: 固定料金と送料無料の際に購入者に表示されます。ゾーンごとに上書きできます。リアルタイムの Bob Go 送料は Bob Go のサービス名で表示されます（例: 「The Courier Guy - Economy」）。初期値: Bob Go。

Shipping cost: 料金の計算方法です。

リアルタイム送料が表示されない理由はログに記録されます。購入者には表示されません。

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)、またはその他のエラーです。ストアの通貨が ZAR でなく、換算レートも設定されていない場合は、リアルタイム送料が要求されていないことも警告されます。

Store domain: Bob Go はストアをドメインで識別します。空欄の場合は、サイトのドメインが使われます。Bob Go のチャネルが別のアドレスにインストールされている場合のみ、別のドメインを入力してください（例: サブフォルダにあるストアの場合は example.co.za/shop）。

ZAR conversion rate: Bob Go は南アフリカ・ランド（ZAR）で見積もります。ストアの通貨が ZAR でない場合は、1 ZAR がストアの通貨でいくらになるかを入力してください（例: EUR の場合は 0.05）。この値で送料が換算され、商品価格は ZAR で Bob Go に送信されます。空欄のままにすると、お使いの通貨では Bob Go のリアルタイム送料を使用しません（固定料金は引き続き利用できます）。ストアの通貨が ZAR の場合は、空欄のままにしてください。小数点区切りとしてピリオドとカンマのどちらも使用できます。

Delivery dates: Bob Go が返す推定配送日の範囲を、送料の名前に表示します。推定日は常に注文と一緒に保存され、注文画面に表示されます。

発送元（発送元住所）

発送元住所は、送料の問い合わせのたびに Bob Go へ送信されます。WooCommerce > Settings > General で設定したストアの住所が同じ国にある場合、空欄の項目はそこから補われます。

Origin country: 発送元の国です。初期値は南アフリカです。Bob Go は南アフリカ国内のみに配送します。

Origin province: 南アフリカの州、または Store province (if in South Africa) です。

Origin city / suburb: 発送元の都市または郊外です（例: Johannesburg）。

Origin postal code: 発送元の郵便番号です（例: 2001）。

Origin street address: 発送元の番地です。

固定料金（固定モードで使用され、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: カートの小計（割引後、税抜き）がこの金額以上の場合のみ、この方法を表示します。空欄の場合は常に表示します。

Excluded shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれる場合、この方法を非表示にします。

Free shipping: 下で指定した注文金額に達したときに、送料無料を有効にします。

Free shipping from: 送料無料になるカートの小計（割引後、税抜き）です。Free shipping が有効な場合にのみ使用されます。その場合、Bob Go には送料を問い合わせません。

Tax status: Taxable は WooCommerce の税金を送料に加算し、None は加算しません。Bob Go の送料には通常すでに VAT が含まれています。その場合は、税金の二重課税を避けるため None を選択してください。

配送ゾーンなしでの提供

Ignore shipping zones: この方法を配送ゾーンに追加していなくても、下記の国に対して Bob Go を提供します。

Countries: このモードの配送先の国です。空欄の場合は、発送先とするすべての国が使われます。Ignore shipping zones が有効な場合にのみ使用されます。

詳細設定

Debug log: 送料の計算と Bob Go へのリクエストを、WooCommerce > Status > Logs にソース「vfd_bob_go」として記録します。購入者の住所は記録されません。API のエラーは、この設定が無効でも記録されます。

Remove data on uninstall: 有効にすると、プラグインを削除したときに、すべての Bob Go 設定、ゾーンの方法、キャッシュされた送料が削除されます。プラグインを無効化しても、何も削除されません。

チェックアウトでの動作

購入者が配送先住所を入力すると、プラグインはカートの重量、Minimum order amount、Excluded shipping classes を確認します。送料無料が適用される場合、購入者にはこの方法が Bob Go (free) と表示され、Bob Go へのリクエストは送信されません。

リアルタイムモードでは、プラグインはストアのドメイン、発送元と配送先の住所、カート内の商品を Bob Go に送信します。商品価格は ZAR で送信されます。リアルタイムの送料は、購入者が市区町村または郵便番号を入力した後にのみ要求されます。Bob Go が返すすべてのサービスは、Bob Go での名前を付けた個別の配送オプションとして表示されます。Delivery dates が有効な場合は、推定配送日も表示されます。ストアの通貨が ZAR でない場合、ZAR の送料は ZAR conversion rate で換算されます。

送料はカートと住所ごとに 1 時間キャッシュされるため、同じカートで新たなリクエストが発生することはありません。失敗したリクエストは 5 分間キャッシュされ、タイムアウトは 12 秒です。これにより、Bob Go の障害がチェックアウトの更新のたびに遅延を引き起こすことを防ぎます。リクエストが失敗してもチェックアウトが中断されることはありません。この方法は非表示になるか、代替モードでは固定料金が使われます。理由は WooCommerce のログに記録されます。

選択された Bob Go のサービスコードと配送予定日は、注文の配送行と一緒に保存され、注文画面に Bob Go service と Estimated delivery として表示されます。

この方法は、クラシックチェックアウトとカートおよびチェックアウトのブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。

プラグインは送料を表示するだけです。出荷、送り状、ラベルの作成、荷物の追跡、Bob Go への注文同期、メール通知の送信は行いません。出荷処理には、Bob Go のダッシュボード（または Bob Go 独自の注文同期）を使用してください。集荷ポイントやロッカーの選択（Bob Box、Pargo）、チェックアウトでの追加の郊外入力欄には対応していません。Bob Go は南アフリカ国内のみに配送します。

ライセンスキー

このプラグインには、vibefox.net で発行された VibeFox ライセンスキーが必要です。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Bob Go の上部にあります。キーを License key に貼り付け、Activate をクリックしてください。ブロックには、ライセンスの有効期限日やドメインなどの状態が表示されます。Check now で状態を再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。

1 つのキーは 1 つのドメインでのみ使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがない場合、チェックアウトで購入者には Bob Go は表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページにはリマインダーが表示されます。既存の注文には影響しません。

ライセンスの期限が切れても、プラグインは引き続き動作します。ただし、アップデートとサポートには更新が必要です。状態はバックグラウンドで自動的に再確認されます。

トラブルシューティング

チェックアウトに Bob Go が表示されない: ライセンスが有効か、Enable/Disable がオンか、この方法が購入者の国のゾーンに追加されているか（または Ignore shipping zones がオンで、その国が許可されているか）を確認してください。重量制限、Minimum order amount、Excluded shipping classes を確認してください。固定モードでは、その国、*、または Flat price に料金が設定されているか確認してください。

Bob Go の送料が表示されない: プラグインの設定を開いてください。Bob Go account セクションには、Bob Go からの最新の応答が表示されます。「Channel is not installed」（HTTP 404）は、ストアのドメインが Bob Go の販売チャネルではないことを意味します。Store domain を確認してください。「Rates at checkout is not enabled」（HTTP 401）は、そのチャネルで機能が無効になっていることを意味します。また、購入者が市区町村または郵便番号を入力していること、ZAR 以外の通貨のストアでは ZAR conversion rate が設定されていることも確認してください。詳細は、Debug log を有効にして、WooCommerce > Status > Logs（ソース「vfd_bob_go」）で確認できます。Bob Go live rates, fixed prices if Bob Go returns no rates を設定していれば、問題の修正中も購入者は固定料金を受け取れます。

ストアの通貨が ZAR ではない: Bob Go は ZAR で見積もります。1 ZAR がストアの通貨でいくらになるかを入力してください（例: EUR の場合は 0.05）。入力しない場合、プラグインは Bob Go に送料を問い合わせません。固定料金は引き続き利用できます。

送料に税金が二重にかかる: Bob Go の送料には通常 VAT が含まれています。Tax status を None に設定してください。

変更後に送料が古いまま表示される: 設定ページを保存してください。これでキャッシュされた Bob Go の送料が消去されます。Bob Go アカウントでの変更は、1 時間のキャッシュが切れた後、または設定を保存したときに反映されます。

ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。例えば、キーが別のドメインで既に使われている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できた状態で動作を続けます。

アンインストール

プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンス状態は、常に削除されます。設定、ゾーンの方法、キャッシュされた送料は、Remove data on uninstall が有効だった場合にのみ削除されます。それ以外の場合は、後で再インストールする際のために残ります。既存の注文は、配送行を保持します。

Bob Go は、その所有者の商標です。本プラグインは Bob Go と提携しておらず、Bob Go による推奨もされていません。