VibeFox Loggi for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

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

PHP: 8.0 以降。

Loggi アカウント（リアルタイム料金のみ必要）: リアルタイムの料金は、法人アカウント向けに Loggi が発行する API キーを使って Loggi GraphQL API を利用します。Loggi のアカウントマネージャーまたは Loggi 統合サポート（integracoes@loggi.com）にお問い合わせください。Loggi API のドキュメントは docs.api.loggi.com にもあります。必要な値は 3 つです: Loggi アカウントのメールアドレス、API キー、ストアの数値 ID。Loggi アカウントに新しい Loggi REST プラットフォーム API（client ID と secret）の認証情報しかない場合、リアルタイム料金は利用できず、固定料金が使われます。固定料金のみを使う場合、Loggi アカウントは不要です。

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

インストール

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

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

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

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

5. Loggi API のメールアドレス、API キー、Shop ID、集荷先住所を入力します。ストアの通貨が BRL でない場合は BRL 為替レートも入力します。安全策として固定料金を追加します（「設定」を参照）。

6. WooCommerce > Settings > Shipping > Shipping zones で、ブラジル向けの配送ゾーンに VibeFox Loggi を追加します。または Ignore shipping zones を有効にして国を選択します。

設定

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

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

ページ上部の警告は、設定が不完全であることを示します: API 認証情報がない、集荷先住所がない、または BRL 為替レートがない。設定を保存するたびに、キャッシュされた Loggi の料金はクリアされます。

全般

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

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

Loggi API（リアルタイム料金）（固定料金のみを使う場合は認証情報を空欄のままにします）

API e-mail: Loggi アカウントのメールアドレス。API キーはこのアカウントに属します。

API key: Loggi の API キー。Loggi にのみ送信され、ログには記録されません。

Shop ID: Loggi ダッシュボードにおけるストアの数値 ID（pk）。正の数値のみ受け付けます。それ以外の値はエラーで拒否され、保存済みの値が維持されます。

Staging: テスト用の認証情報で Loggi のステージング環境を使用します。ステージングと本番では、アカウントとキーが異なります。初期値: オフ。

Pickup address: Loggi が荷物を集荷する場所を 1 行で入力します: 番地、地区、市区町村、州、CEP（例: Rua Example, 123 - Bairro, São Paulo - SP, 01310-100）。ストアの住所がブラジルにある場合は、空欄にすると WooCommerce > Settings > General のストア住所が使われます。集荷先住所がないと Loggi は見積もりできず、固定料金のみが使われます。

BRL exchange rate: Loggi の料金はブラジルレアルです。ストアの通貨が BRL の場合、このフィールドは不要です。それ以外の場合は、1 BRL がストアの通貨でいくらになるかを入力します（例: 0.16）。入力しないと、リアルタイム料金は使用されません。小数点区切りとして、ピリオドとカンマのどちらも使えます。

固定料金（ストアの通貨で）

固定料金は、Loggi API が設定されていない場合、ブラジル以外の送付先の場合、完全な CEP がない場合、そして Loggi が料金を返さない場合（API がダウン、キーが拒否された、住所が対象外など）に使用されます。

Price table: 送付先の国ごとに 1 行です。+ Add country をクリックして行を追加し、×印をクリックして削除します。独自の行がないすべての国には * All other countries を選びます。各行には Base price と重量列があります: XS ≤1 kg、S ≤2 kg、M ≤3 kg、L ≤5 kg、XL >5 kg。重量列が空欄（または 0）の場合は基本料金が使われます。基本料金が 0 の場合は送料無料になります。"9.99" と "9,99" のどちらも受け付けます。保存時には、空の行と同じ国の 2 行目は削除されます。

Price for countries not in the table: Loggi のリアルタイム料金がなく、表に送付先の国の行（および * の行）もない場合に使用されます。この場合に方法を非表示にするには空欄にします。

Fixed price applies: 固定料金の計算方法。Loggi のリアルタイム料金はカート全体を対象とするため、掛け算されることはありません。

条件

Minimum weight (kg): カートがこの重量より軽い場合、方法を非表示にします。0 は制限なしを意味します。

Maximum weight (kg): カートがこの重量より重い場合、方法を非表示にします。初期値: 30。0 は制限なしを意味します。

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

Free shipping from: カートの小計（割引後、税抜き）がこの金額以上の場合、Loggi 配送は無料になります。空欄にすると送料無料はありません。

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

Tax status: Taxable は WooCommerce の税金を送料に加算し、None は加算しません。ストアの価格と Loggi の料金にすでに税金が含まれている場合は None を選びます。

配送ゾーンを使わない場合の提供範囲

Ignore shipping zones: この方法がどの配送ゾーンにも追加されていなくても、下記の国向けに Loggi を提供します。

Countries: このモードの送付先の国。空欄にすると、発送先として設定しているすべての国が使われます。このフィールドは Ignore shipping zones が有効な場合にのみ使われます。

詳細設定

Debug log: 料金計算と Loggi へのリクエストをすべて WooCommerce > Status > Logs（ソース vfd-loggi）に記録します。API エラーは、このオプションがオフでも常に記録されます。API キーと購入者の住所は記録されません。

Remove data on uninstall: オンの場合、プラグインを削除すると、Loggi のすべての設定とゾーンの方法が削除されます。プラグインを無効化しても設定は削除されません。

チェックアウト時の動作

購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまず条件を確認します: 配送先の国、カートの重量、最低注文金額、除外する配送クラス。送料無料が適用される場合、購入者は無料でこの方法を確認でき、Loggi へのリクエストは送信されません。

完全な 8 桁の CEP を持つブラジルの住所では、プラグインが Loggi の荷物を作成します。各商品は、最も短い辺が高さになるように回転され、荷物が 55 × 55 × 55 cm と 20 kg の範囲内に収まる限り、1 つの荷物に積み重ねられます。重量や寸法のない商品は、各辺 1 cm として扱われ、各荷物は最低 100 g とされます。Loggi は 1 回の見積もりで 2 つの荷物を受け付けるため、大きなカートは複数のリクエストで送信され、合計額が加算されます。プラグインは、Shop ID、集荷先住所、配送先住所、荷物を Loggi に送信し、Loggi の合計額を BRL からストアの通貨に換算して表示します。

Loggi の各料金は、カート、住所、アカウント、環境ごとに 1 時間キャッシュされるため、同じカートで新たなリクエストが発生することはありません。失敗した見積もりは 10 分間キャッシュされます。Loggi に一切接続できない場合、チェックアウトが更新のたびに Loggi を待たないよう、リクエストは 2 分間停止されます。API のタイムアウトは 10 秒です。

API が設定されていない場合、住所がブラジル以外の場合、または完全な CEP がまだない場合、BRL 為替レートがない場合、商品が Loggi の荷物より大きい場合、カートに 10 個を超える荷物が必要な場合、あるいは Loggi がエラー、拒否された荷物、対象外の住所、合計 0 を返した場合には、代わりに固定料金が使われます。固定料金もなければ、方法は非表示になります。購入者に API エラーが表示されることはありません。理由はログに記録されます。

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

プラグインが行うのは料金の計算だけです。Loggi での注文や出荷の作成、送り状の印刷、荷物の追跡、チェックアウトでの配達日時の表示、受け取り拠点やロッカーの提供は行いません。出荷は Loggi のダッシュボードで作成してください。Loggi はブラジル国内のみに配送します。それ以外の国では固定料金を使用してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに Loggi が表示されない: ライセンスが有効か、Enable/Disable がオンか、購入者の国の配送ゾーンにこの方法が追加されているか（または Ignore shipping zones がオンで、その国が許可されているか）を確認します。設定ページ上部の警告、重量制限、Minimum order amount、Excluded shipping classes を確認してください。購入者がまだ完全な CEP を入力していない場合、または Loggi が料金を返さない場合、この方法には固定料金が必要です: その国の行、* の行、または Price for countries not in the table のいずれかです。

固定料金のみが表示される: WooCommerce > Status > Logs を開き、ソース vfd-loggi を確認します。エラーは常に記録されます。すべての手順を確認するには Debug log をオンにします。よくある原因: API のメールアドレス、キー、または Shop ID が未入力、集荷先住所がない、ストアの通貨が BRL 以外なのに BRL exchange rate がない、完全な 8 桁の CEP がまだない、商品が 55 cm を超える、または 20 kg を超える、あるいは住所が Loggi の提供範囲外。

ログに HTTP 401 または 403 が出る: Loggi が API のメールアドレスまたはキーを拒否しました。Loggi で確認し、Staging の設定が認証情報と一致しているかを確認してください。ステージングと本番のキーは異なります。

ストアで米ドルやユーロを販売している: Loggi は BRL で回答します。BRL exchange rate（1 BRL がストアの通貨でいくらになるか）を入力してください。固定料金は常にストアの通貨で表示されます。

料金が正確でない: 商品の重量と寸法を入力してください。入力しない場合、商品は各辺 1 cm、各荷物は最低 100 g として扱われます。

Per item では Loggi の料金が掛け算されない: これは仕様どおりです。Loggi のリアルタイム料金はカート全体を対象とします。Per item は固定料金にのみ適用されます。

変更後に料金が古く見える: 設定ページを保存してください。キャッシュされた Loggi の料金がクリアされます。

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

アンインストール

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

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