VibeFox Jadlog for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 5.0 以降。インストールされ有効になっている必要があります。WooCommerce がないとプラグインは有効化できません。
PHP: 8.0 以降。
Jadlog 契約（リアルタイム送料と Pickup 拠点用）: リアルタイム送料と Pickup 拠点の一覧は、Jadlog Embarcador API から取得します。契約締結後、Jadlog のフランチャイズ先からアクセス権が発行されます。必要なのは、Embarcador API トークン、契約に登録された発送者の CNPJ（または CPF）、当座口座（conta corrente）、そして契約番号（お持ちの場合）です。固定料金のみを使用する場合、Jadlog 契約は不要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_jadlog フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます: WooCommerce > Settings > Shipping > VibeFox Jadlog。または、プラグインページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. API トークンを貼り付け、CNPJ、当座口座、契約番号、発送元 CEP を入力し、Jadlog サービスを選択します。ストア通貨が BRL でない場合は、BRL 為替レートを入力します。必要に応じて固定料金またはフォールバック費用を追加します（「設定」を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で、ブラジル向けの配送ゾーンに VibeFox Jadlog を追加するか、Ignore shipping zones を有効にして国を選択します。Jadlog Pickup 拠点も提供するには、同じゾーンにこの方法をもう一度追加し、サービスとして Pickup (40) を選択します。
設定
すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox Jadlog。設定はすべての配送ゾーンに適用されます。ゾーンに方法を追加すると、ゾーンのウィンドウに次の 2 つの項目が表示されます。
Title (zone): このゾーンで購入者に表示される名称。空欄の場合は、全体の Method title が使用されます。
Jadlog service (zone): このゾーンの方法で使用するサービス。Same as the global setting を選ぶと、メインの設定ページのサービスを使用します。同じゾーンで、例えば宅配（.Package）と Jadlog Pickup 拠点の両方を提供するには、この方法を 2 回追加します。
ゾーンのタイトルが空で、サービスが Pickup の場合、全体のタイトルに「Pickup」という語が追加されるため、2 つの方法の名称が区別されます。
設定ページの上部には、設定が不完全な場合の警告が表示されます。API トークンがない、CNPJ または当座口座がない、発送元 CEP がない、または BRL 以外で販売しているストアに BRL 為替レートがない場合です。設定を保存するたびに、キャッシュされた Jadlog の送料と Pickup 拠点の一覧が消去されます。
一般
Enable/Disable: すべてのゾーンでこの方法を一度に有効または無効にします。
Method title: カートとチェックアウトに表示される配送方法の名称。既定値: Jadlog。ゾーンごとに上書きできます。
Jadlog のリアルタイム送料
リアルタイム送料は、8 桁の完全な CEP があるブラジル国内の住所に対してのみ取得されます。
API token: Jadlog から提供された Embarcador トークン。「Bearer」という語を付けても付けなくても貼り付けられます。固定料金のみを使用する場合は空欄にします。
CNPJ: Jadlog 契約に登録された発送者の CNPJ（14 桁）または CPF（11 桁）。ドット、スラッシュ、ハイフンを使用できます。桁数が正しくない場合は、プラグインが警告します。
Current account (conta corrente): Jadlog の当座口座番号。これがなく、CNPJ もない場合、Jadlog は見積もりを出せず、固定料金のみが使用されます。
Contract number: フランチャイズ先から発行された場合の、Jadlog 契約番号。
Origin CEP: 荷物を発送する郵便番号（8 桁）。00000-000 の形式で保存されます。ストアの住所がブラジルにある場合は、空欄にすると WooCommerce > Settings > General のストア郵便番号が使用されます。
Jadlog service: 契約のサービス（modalidade）: .Package（3、既定）、.Com（9）、Expresso（0）、Rodoviário（4）、Econômico（5）、Doc（6）、Corporate（7）、Internacional（10）、Cargo（12）、Emergencial（14）、Pickup（40）。Pickup は、購入者の近くにある Jadlog Pickup 拠点を提供します。ゾーンの方法では別のサービスを使用できます。
Insurance type: Normal (N)（既定）または Own insurance policy (A — apólice)。Jadlog 契約で合意された内容に従います。
Volumetric weight: Jadlog は実重量と容積重量のうち大きい方で請求します。
BRL exchange rate: Jadlog はブラジルレアル（BRL）で見積もります。ストア通貨が BRL の場合、この項目は不要です。それ以外の場合は、ストア通貨で 1 BRL の価値を入力します（例: 0.16）。Jadlog の送料にこのレートが掛けられ、Jadlog に送信される申告注文額は BRL に換算し直されます。レートがないと、リアルタイム送料は使用されず、固定料金のみが適用されます。小数点として、ピリオドとカンマのどちらも使用できます。
Delivery time: Jadlog から返された配送日数を、配送方法のタイトルの横に表示します（例: 「Jadlog（3 営業日）」）。既定で有効です。配送日数は常に注文に保存されます。
Jadlog Pickup 拠点（Pickup (40) サービスで使用。API トークンが必要）
Points to show: 表示する Pickup 拠点の数（1〜10）。既定値: 5。
固定料金（API トークンがない場合、Jadlog が対応していない国、および Jadlog が料金を返さない場合に使用）
Price per country: ストア通貨で、Country、Price、XS、S、M、L、XL の列を持つ表。+ Add country をクリックすると行が追加され、×をクリックすると行が削除されます。サイズ列はカートの重量で選ばれます: XS は 1 kg まで、S は 2 kg まで、M は 3 kg まで、L は 5 kg まで、XL は 5 kg を超える場合です。サイズ列が空の場合は Price が使用されます。料金が 0 の場合、その国は送料無料です。それ以外のすべての国には、国として * Default を使用します。料金が設定されていない行は、保存時に削除されます。
Fallback cost: Jadlog も表も料金を出せない場合に使用されます。空欄にすると、その場合はこの方法が非表示になります。
Fixed price applies: Per order は料金を 1 回だけ請求します。Per item (price × quantity) は、カート内の商品数を掛けた金額を請求します。これは固定料金とフォールバック費用にのみ適用されます。Jadlog の料金は、カート全体をすでに対象としています。
条件
Minimum weight (kg): カートの重量がこれより軽い場合、この方法を非表示にします。0 は制限なしを意味します。
Maximum weight (kg): カートの重量がこれより重い場合、この方法を非表示にします。既定値: 150。0 は制限なしを意味します。
Minimum order amount: カートの小計（割引後、税抜き）がこの金額に達した場合にのみ、この方法を表示します。空欄の場合は常に表示します。
Excluded shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかの商品が含まれる場合、この方法を非表示にします。
Free shipping from: カートの小計（割引後、税抜き）がこの金額以上の場合、配送は無料です。空欄の場合は無料配送はありません。
Tax status: Taxable は、配送料に WooCommerce の税金を加算します。None は加算しません。Jadlog の料金は配送業者の最終価格です。WooCommerce で税金を加算したくない場合は、None を選択します。
配送ゾーンなしでの提供
Ignore shipping zones: この方法がどの配送ゾーンにも追加されていなくても、下記の国に対して Jadlog を提供します。このモードでは、全体の Jadlog service が使用されます。
Countries: このモードの配送先の国。空欄の場合は、出荷先として設定したすべての国が使用されます。この項目は、Ignore shipping zones が有効な場合にのみ使用されます。
詳細設定
Debug log: Jadlog へのすべてのリクエストとレスポンスを WooCommerce > Status > Logs に、ソース vfd-jadlog として記録します。API のエラーは、このオプションがオフでも常に記録されます。トークン、CNPJ、口座は決して記録されず、購入者の CEP は短縮されます。完了したらログをオフにしてください。
Remove data on uninstall: 有効にすると、プラグインを削除したときに、すべての Jadlog 設定とゾーンの方法が削除されます。プラグインを無効化しても、設定は削除されません。キャッシュされた料金は常に削除されます。
チェックアウトでの動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに送料を問い合わせます。プラグインはまず条件を確認します: カートの重量、最低注文金額、除外する配送クラス。カートの小計が Free shipping from に達していれば、配送は無料であり、Jadlog への送料リクエストは送信されません。
8 桁の完全な CEP があるブラジル国内の配送先住所の場合、プラグインは Jadlog に、発送元と配送先の CEP、重量、お客様の CNPJ、当座口座、契約、サービス、保険の種類、申告注文額を送信し、返された送料をストア通貨で表示します。重量のないカートは 0.1 kg として見積もられます。リアルタイム送料がない場合（トークンがない、住所がブラジル国外、CEP が不完全、BRL 為替レートがない、Jadlog のエラー）、プラグインは Price per country の表を使用し、次に Fallback cost を使用します。いずれも送料を提供しない場合、そのカートではこの方法は非表示になります。
各送料は 1 時間キャッシュされるため、同じカートで新しいリクエストは発生しません。失敗したリクエストは 10 分間キャッシュされます。Jadlog が応答しない、サーバーエラーを返す、またはトークンを拒否した場合、10 分間は API を再び呼び出しません。API のタイムアウトは 10 秒です。購入者が API エラーを目にすることはありません。理由はログに記録されます。
この方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックで動作します。WooCommerce の高パフォーマンス注文保存機能（HPOS）に対応しています。
本プラグインが行うのは、送料の計算と Pickup 拠点の一覧表示のみです。Jadlog の配送伝票の作成、ラベルの印刷、集荷の依頼、配送のキャンセル、荷物の追跡は行いません。Pickup 拠点の地図は表示せず、Jadlog に国際見積もりも依頼しません。その他の国には固定料金を使用してください。
Pickup 拠点
サービスに Pickup (40) を選択した方法は、ブラジル国内の住所にのみ提供されます。購入者が 8 桁の完全な CEP を入力すると、プラグインは Jadlog に、近くにある有効な Pickup 拠点を問い合わせ、最大 Points to show 件の拠点を提供します。各拠点は、それぞれ個別の送料を持つ独立した配送オプションです。例: 「Jadlog Pickup: 拠点名 — 住所」。購入者は配送オプションを選択することで拠点を選びます。クラシックチェックアウトでも、カートとチェックアウトのブロックでも同じです。
各拠点への送料は Jadlog に問い合わせます。Jadlog が拠点の料金を返さない場合は固定料金が使用され、料金が 1 つもない拠点は除外されます。拠点の一覧は 12 時間キャッシュされます。
API トークンがない場合、8 桁の CEP がない場合、Jadlog が利用できない場合、または近くに有効な拠点がない場合、Pickup の方法は非表示になります。拠点のない注文は発送できません。
注文
注文の配送行には、Jadlog のサービスと、Jadlog が返した場合の営業日単位の配送日数が保存されます。Pickup の注文では、配送行の名称に拠点の名称と住所が含まれ、注文には Pickup 拠点の名称、住所、ID も保存されます。これらは、管理画面の注文画面で配送行の下に表示されます。購入者は、選択した拠点を「ご注文ありがとうございます」ページと注文メールで確認できます。
配送の手続きは、Jadlog のシステムでご自身で行ってください。注文には、そのために必要なサービスと Pickup 拠点の ID が表示されます。
ライセンスキー
本プラグインは、vibefox.net で購入した VibeFox ライセンスキーで動作します。ライセンスブロックは、WooCommerce > Settings > Shipping > VibeFox Jadlog の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ステータス（例: ライセンスの有効期限日と、お客様のドメイン）が表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、Jadlog はチェックアウトで購入者に表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインのページと WooCommerce のページにリマインダーが表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
Jadlog がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、購入者の国のゾーンにこの方法が追加されていること（または Ignore shipping zones がオンで国が許可されていること）を確認してください。設定ページの上部の警告、重量の制限、Minimum order amount、Excluded shipping classes を確認してください。購入者がまだ 8 桁の完全な CEP を入力していない場合、固定料金しか使用できないため、Price per country に行を追加するか、Fallback cost を設定してください。
固定料金しか表示されない: Debug log をオンにし、チェックアウトを再読み込みして、WooCommerce > Status > Logs をソース vfd-jadlog で開いてください。理由が表示されます: CNPJ または当座口座がない、発送元 CEP がない、配送先 CEP が不完全、BRL 為替レートがない、または Jadlog のエラーメッセージ。
ログに HTTP 401 または 403 が出ている: Jadlog が API トークンを拒否しました。Jadlog のフランチャイズ先で確認してください。このエラーの後、API は 10 分間停止します。設定を保存すると停止が解除されるため、すぐに再試行できます。
Pickup 拠点が表示されない: Pickup の方法には、API トークンと、ブラジル国内の 8 桁の完全な CEP が必要です。CEP の近くに Jadlog の有効な拠点がない場合、この方法は非表示になります。理由はログで確認してください。
料金が自分の通貨ではなくレアルで表示される: BRL exchange rate（ストア通貨で 1 BRL の価値）を入力してください。
料金が低すぎる、または高すぎる: 商品の重量と寸法を入力してください。重量のないカートは 0.1 kg として見積もられ、容積重量には寸法が必要です。
変更後も料金が古いまま: 設定ページを保存してください。これにより、キャッシュされた Jadlog の料金と Pickup 拠点の一覧が消去されます。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。例えば、キーが別のドメインで既に使用されている場合は、vibefox.net のアカウントでスロットを解放し、Check now をクリックしてください。サイトの住所が変わった場合は、Check now をクリックして、新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認された状態のまま動作し続けます。
アンインストール
プラグインを無効化しても、すべての設定とゾーンの方法は保持されます。削除されるのは、キャッシュされた料金と Pickup 拠点の一覧のみです。プラグインを削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンスステータス、およびキャッシュされた料金は、常に削除されます。設定とゾーンの方法は、Remove data on uninstall が有効だった場合にのみ削除されます。それ以外の場合は、後日の再インストールのために残ります。既存の注文は、Jadlog のサービスと Pickup 拠点を含む配送行を保持します。
Jadlog は、それぞれの所有者の商標です。本プラグインは Jadlog と提携しておらず、Jadlog によって推奨されているものでもありません。