VibeFox Cargoson for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

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

PHP: 8.0 以降。

Cargoson アカウント（リアルタイム料金の場合のみ）: リアルタイム料金は Cargoson の運賃料金 API を使用します。運賃料金の照会には、API アクセスを含む Cargoson のサブスクリプション（執筆時点では Advanced プラン以上）が必要です。API キーは Cargoson アカウントで発行されます。プランに API 設定が表示されない場合は、Cargoson サポートにお問い合わせください。料金は、そのアカウントに接続された配送業者と料金表から取得されます。固定料金のみを利用する場合は、Cargoson アカウントは不要です。

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

インストール

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

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

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

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

5. 配送料の計算方法を選択し、該当するセクションを入力します。固定料金、およびリアルタイム料金の場合は API キーと集荷先の郵便番号です（設定を参照）。

6. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーンに VibeFox Cargoson を追加するか、Ignore shipping zones をオンにして国を選択します。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox Cargoson。設定はすべての配送ゾーンに適用されます。ゾーンに方法を追加すると、ゾーンのウィンドウには 1 つのフィールドだけが表示されます:

Title (zone): このゾーンで購入者に表示される名称。空欄にすると、全体の Method title を使用します。

設定を保存するたびに、キャッシュされた Cargoson の料金は消去されます。小数はピリオドまたはカンマで入力できます。

General

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

Method title: カートとチェックアウトに表示される配送方法の名称。初期値: Cargoson。ゾーンごとに上書きできます。

Shipping cost: 料金の計算方法。

Fixed prices (table below): 料金は Price per country and size の表から取得されます。Cargoson アカウントは不要です。

Cargoson live prices (API): カートごとに Cargoson へ料金を問い合わせます。Cargoson が料金を返さない場合、そのカートではこの方法は表示されません。

Cargoson live prices, fixed prices if the API fails: Cargoson へ料金を問い合わせます。Cargoson が応答しない、API キーを拒否する、またはそのルートに配送業者がない場合は、固定料金が使用されます。

リアルタイム料金が表示されない理由は、WooCommerce のログに記録されます。購入者に表示されることはありません。

Cargoson API（リアルタイム料金の場合のみ必要）

API key: Cargoson アカウントの API キー。cargoson.com にのみ送信され、購入者に表示されることも、ログに記録されることもありません。

Carrier: 使用する料金。購入者に表示される料金は 1 つです。

Any carrier (cheapest price): Cargoson が返す最も安い料金。これが初期値です。

DPD, Omniva, Smartpost / Posti, Venipak, UPS, FedEx, DHL, GLS: この配送業者の最も安い料金のみを使用します。一致の判定は、Cargoson が返す配送業者名によって行われます（Omniva の場合の AS Eesti Post など、正式名称も含みます）。

Package type code: 料金照会とともに送信される Cargoson の荷姿コード。初期値: CLL。Cargoson API の例では EUR（EUR パレット）と FIN（FIN パレット）が使われています。小包の場合は、Cargoson アカウントの荷姿コードを使用してください。注文は、カートの合計重量を 1 個の荷物として送信されます。

Price currency: Cargoson アカウントに登録されている料金の通貨（3 文字のコード）。初期値: EUR。API は通貨コードなしで金額を返します。

Currency conversion rate: 料金の通貨がストアの通貨と異なる場合にのみ必要です。1 Cargoson 通貨単位 = X ストア通貨単位。空欄のままにすると、そのような料金は拒否されるため、購入者が誤った通貨で支払うことはありません。

Ship from (collection address)（リアルタイム料金で使用）

Collection country: 出荷元の国。初期値はストアの国です。

Collection postcode: 出荷元の郵便番号。Cargoson で必須です。空欄で、集荷国がストアの国である場合は、WooCommerce > Settings > General のストアの郵便番号が使用されます。

Cargoson に送信される集荷日は、当日です。週末の場合は、次の月曜日です。

Fixed prices（Shipping cost が Fixed prices の場合に使用、およびリアルタイム料金の代替として使用）

Price per country and size: 国の表。Price 列があり、ストアの通貨でカート重量ごとの料金を設定します: XS は 1 kg まで、S は 2 kg まで、M は 3 kg まで、L は 5 kg まで、XL は 5 kg 超。サイズの料金が空欄または 0 の場合は Price 列の料金が使用されます。Price 列が空欄の場合は、そのサイズには固定料金がないことを意味します。Add country をクリックすると行を追加し、× をクリックすると行を削除します。* Default の行は、独自の行がないすべての国に適用されます。行がない国（* の行がない場合）には固定料金がないため、その国ではこの方法は表示されません。

Fixed price applies: Per order は料金を 1 回だけ請求します。Per item (price × quantity) はカート内の商品数を掛けて計算します。Cargoson のリアルタイム料金は、常に出荷ごとに適用されます。

Conditions

Minimum weight (kg): このカート重量未満の場合、この方法を非表示にします。0 は上限なしを意味します。

Maximum weight (kg): このカート重量を超える場合、この方法を非表示にします。初期値: 25。0 は上限なしを意味します。

Minimum order amount: カートの小計（割引後、税抜き）がこの金額以上の場合にのみ、この方法を表示します。空欄にすると常に表示されます。

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

Free shipping: 下記の注文金額に達したときに、送料無料をオンにします。

Free shipping from: 送料が無料になるカートの小計（割引後、税抜き）。Free shipping がオンの場合にのみ使用されます。

Tax status: Taxable は WooCommerce の税設定に従って配送税を加算します。None は加算しません。Cargoson の配送業者料金は通常、税抜きです。料金にすでに税が含まれている場合は、None を選択してください。

Availability without shipping zones

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

Countries: このモードの配送先の国。空欄にすると、配送可能なすべての国を使用します。この項目は Ignore shipping zones がオンの場合にのみ使用されます。

Advanced

Debug log: 料金の計算をすべて WooCommerce > Status > Logs に記録します。ソースは vfd_cargoson です。API のエラーは、この設定がオフでも常に記録されます。API キーと購入者の郵便番号は、記録されることはありません。

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

チェックアウトでの動作

購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を要求します。プラグインはまず条件を確認します: 配送先の国、カートの重量、最低注文金額、除外する配送クラス。送料無料が適用される場合、購入者は無料の料金を受け取り、Cargoson へのリクエストは送信されません。

固定料金モードでは、料金は表から取得されます。リアルタイムモードでは、プラグインは集荷日、集荷国と郵便番号、配送先の国と郵便番号、そして荷姿コードとカートの合計重量（最低 0.1 kg）を含む 1 個の荷物を Cargoson に送信します。商品の重量はストアの単位からキログラムに変換されます。リアルタイム料金は、購入者が郵便番号を入力した後にのみ要求されます。Cargoson は配送業者の料金を返します。プラグインは最も安い料金（設定されている場合は選択した配送業者の料金）を選び、必要に応じてストアの通貨に換算します。

各応答は 1 時間キャッシュされるため、同じカートで新しいリクエストは発生しません。失敗したリクエストは 10 分間キャッシュされるため、チェックアウトは更新のたびに Cargoson の応答を待つ必要がありません。API のタイムアウトは 10 秒です。Cargoson がエラーを返した場合、そのルートの料金がない場合、または換算レートがなく別の通貨の料金になる場合でも、購入者にエラーは表示されません。この方法は非表示になるか、代替モードでは固定料金が使用されます。

この方法は、クラシックチェックアウトとカートおよびチェックアウトのブロックで動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。

プラグインは料金の計算のみを行います。Cargoson での出荷や予約の作成、ラベルの印刷、荷物の追跡は行わず、購入者はパーセルマシンや受取場所を選択できません。カートは合計重量の 1 個の荷物として見積もられます。荷物の寸法は送信されません。表示されるのは最も安い料金のみで、配送業者の一覧は表示されません。

注文

リアルタイム料金が使用された場合、注文の配送行には、見積もりの Carrier、Service、Cargoson service ID が保存されます。これらは注文の編集画面に表示されるため、Cargoson でどの内容を予約すればよいかがわかります。出荷は Cargoson で、または Cargoson の独自の連携機能を使って予約してください。

ライセンスキー

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

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

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

ライセンスの有効期限が切れた後も、プラグインは動作を続けますが、更新とサポートには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。

トラブルシューティング

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

リアルタイム料金が表示されない: WooCommerce > Status > Logs を開き、ソース vfd_cargoson を確認してください。API のエラーは常に記録されます。すべての計算を確認するには Debug log をオンにしてください。よくある原因: 配送先の郵便番号がまだ入力されていない、集荷先の郵便番号がない、API キーが拒否された（キーが誤っているか期限切れ、または Cargoson プランに API アクセスがない）、そのルートや重量に配送業者がない、別の通貨の料金である。Cargoson live prices, fixed prices if the API fails を使用していれば、問題を修正している間も、購入者は固定料金を受け取れます。

Cargoson が荷姿を拒否する: Cargoson アカウントが Package type code で使用している荷姿コードを使用してください。理由はログに表示されます。

別の通貨の料金が拒否される: Price currency を Cargoson の料金の通貨に設定し、Currency conversion rate を入力してください。

変更後にレートが古く見える: 設定ページを保存してください。これにより、キャッシュされた Cargoson の料金が消去されます。

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

アンインストール

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

Cargoson は、それぞれの所有者の商標です。本プラグインは Cargoson と提携しておらず、Cargoson による承認も受けていません。