VibeFox Jadlog for PrestaShop — ヘルプ
要件
PrestaShop: 8.0〜9.x。
PHP: 8.0 以降。モジュールは古い PHP バージョンではインストールできません。
Jadlog 契約（リアルタイム送料と Pickup 拠点用）: リアルタイム送料と Pickup 拠点の一覧は、Jadlog Embarcador API から取得されます。契約締結後、Jadlog のフランチャイズ先からアクセス権が発行されます。必要なものは、Embarcador API トークン、契約に登録された発送者の CNPJ（または CPF）、当座口座（conta corrente）、そして契約番号（お持ちの場合）です。固定料金のみを使用する場合は、Jadlog 契約は不要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. 管理画面で Modules > Module Manager に進み、Upload a module をクリックします。モジュールの ZIP ファイルを選択してください。
2. アップロードが完了したら Configure をクリックします。後で探す場合は、モジュール一覧から VibeFox Jadlog を見つけて Configure をクリックしてください。
3. Configure ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。
4. API トークンを貼り付け、CNPJ、当座口座、契約番号、発送元 CEP を入力し、Jadlog サービスを選択します。ショップのデフォルト通貨が BRL でない場合は、BRL の為替レートを入力してください。必要に応じて固定料金またはフォールバック費用を追加します（「設定」を参照）。Save をクリックしてください。
5. Jadlog Pickup 受け取り拠点も提供する場合は、Enable Jadlog Pickup をオンにして Save をクリックしてください。
インストール時に、モジュールは 2 つの配送業者を作成します。Jadlog（宅配、オン、配送日数の表示テキスト Jadlog delivery to your address）と Jadlog Pickup（オフ、配送日数の表示テキスト Pickup at a Jadlog Pickup point）です。どちらもブラジルのゾーンとすべての顧客グループに紐づけられます。ゾーン、顧客グループ、配送日数、ロゴ、サイズ制限は Shipping > Carriers で変更できます。そこで料金を設定しないでください。料金は常にモジュールから取得されます。
設定
すべての設定はモジュールのページにあります。Modules > Module Manager > VibeFox Jadlog > Configure です。設定は 2 つの Jadlog 配送業者の両方に適用されます。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。保存するたびに、キャッシュされた Jadlog 送料と Pickup 拠点の一覧も消去されます。
ページ上部には、設定が不完全な場合の警告が表示されます。API トークンがない（固定料金のみが使用され、Pickup 拠点は一覧表示できません）、API トークンも固定料金もない（この方法は表示されません）、CNPJ または当座口座がない、発送元 CEP がない、BRL で販売しないショップに BRL の為替レートがない、モジュールが認識しないショップの重量または寸法の単位がある（その場合、重量は kg、寸法は cm として扱われます。単位は International > Localization の Local units で設定してください）、または削除された Jadlog 配送業者がある、といった内容です。保存時には、誤った値も報告されます。8 桁に満たない CEP、14 桁に満たない CNPJ（CPF の場合は 11 桁）、無効な数値、最大重量より大きい最小重量（両方の重量は保存済みの値を維持します）、不明な国、料金表の無効な料金などです。
General
Enable/Disable: Jadlog の宅配を有効または無効にします。Shipping > Carriers の配送業者のステータスと同じスイッチです。
Method title: カートとチェックアウトに表示される宅配の配送業者名です。デフォルトは Jadlog です。必須項目です。
Tax status: None、または税ルールを選択した Taxable を指定します。2 つの Jadlog 配送業者の両方に保存されます。Jadlog の料金は最終的な配送業者の料金です。PrestaShop がこれらの料金に税を加算しないようにする場合は、None を選択してください。
Jadlog live prices
リアルタイム送料は、8 桁の完全な CEP を持つブラジルの住所についてのみ取得されます。
API token: Jadlog から提供された Embarcador トークンです。「Bearer」の語の有無にかかわらず貼り付けられます。固定料金のみを使用する場合は空欄のままにしてください。保存後、フィールドは空になり、Saved - leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。
Remove the saved API token: チェックボックスをオンにして Save をクリックすると、保存済みのトークンが削除されます。
CNPJ: Jadlog 契約に登録された発送者の CNPJ（14 桁）または CPF（11 桁）です。ドット、スラッシュ、ハイフンを含めることができます。
Current account (conta corrente): Jadlog の当座口座番号です。これと CNPJ がない場合、Jadlog は見積もりを出せず、固定料金のみが使用されます。
Contract number: フランチャイズ先から契約番号が発行されている場合の、Jadlog 契約番号です。
Origin CEP: 荷物を発送する郵便番号で、8 桁です。00000-000 の形式で保存されます。ショップの住所がブラジルにある場合、空欄のままにすると Shop Parameters > Contact > Stores のショップの郵便番号が使われます。
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）から選択します。Jadlog Pickup（40）は 2 つ目の配送業者です。
Insurance type: Normal (N)（デフォルト）、または Jadlog 契約で合意された Own insurance policy (A - apolice) を選択します。
Volumetric weight: Jadlog は実重量と容積重量のうち大きい方で請求します。
BRL exchange rate: Jadlog はブラジルレアルで見積もります。ショップのデフォルト通貨が BRL の場合、このフィールドは不要です。そうでない場合は、デフォルト通貨で 1 BRL が何にあたるかを入力してください（例: 0.16）。Jadlog の料金にこのレートが掛けられ、Jadlog に送信される申告注文金額は BRL に戻されます。レートがない場合、リアルタイム送料は使用されず、固定料金のみが適用されます。小数点とカンマのどちらも小数の区切りとして受け付けられます。
Delivery time: Jadlog から返された配送日数を、チェックアウト時に Jadlog 配送業者の下と、各 Pickup 拠点の横に表示します（例: "Delivery time: 3 business days"）。デフォルトではオンです。配送日数は常に注文とともに保存されます。
Jadlog Pickup
Jadlog Pickup サービス（40）を提供する 2 つ目の配送業者です。API トークンが必要です。拠点がない場合、この配送業者は表示されません。
Enable Jadlog Pickup: Jadlog Pickup 配送業者を有効または無効にします。Shipping > Carriers でのステータスと同じスイッチです。インストール後はオフです。
Jadlog Pickup carrier name: チェックアウトにおけるこのオプションの名称です。デフォルトは Jadlog Pickup です。必須項目です。
Points to show: 提供する Pickup 拠点の数で、1〜10 の範囲です。デフォルトは 5 です。
Fixed prices（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 (other countries) を使用してください。料金が一つも入力されていない行は、保存時に削除されます。
Fallback cost: Jadlog も表も料金を提供しない場合に使用されます。この場合に配送業者を非表示にしたい場合は、空欄のままにしてください。
Fixed price applies: Per order は料金を 1 回だけ請求します。Per item (price x quantity) は、カート内の商品数を掛けて請求します。これは固定料金とフォールバック費用にのみ適用されます。Jadlog の料金は、カート全体をすでにカバーしています。
Conditions
Minimum weight (kg): カートがこれより軽い場合、配送業者を非表示にします。0 は制限なしを意味します。
Maximum weight (kg): カートがこれより重い場合、配送業者を非表示にします。デフォルトは 150 です。0 は制限なしを意味します。
Minimum order amount: カートの小計（配送が必要な商品、割引後、税抜き）がこの金額に達した場合にのみ、配送業者を表示します。常に表示する場合は空欄のままにしてください。
Free shipping from: 配送が無料になるカートの小計（割引後、税抜き）です。無料配送がない場合は空欄のままにしてください。
Availability without shipping zones
Ignore shipping zones: 配送業者がその国のゾーンに紐づいていなくても、下記の国に対して Jadlog を提供します。オンにすると、両方の配送業者がすべての有効なゾーンに紐づけられ、後から作成されたゾーンにも紐づけられます。再びオフにすると、配送業者は以前のゾーンに戻ります。
Countries: 配送業者自身のゾーン以外で、このモードの対象となる宛先の国です。すべての国を許可する場合は空欄のままにしてください。このフィールドは Ignore shipping zones がオンの場合にのみ使用されます。
Advanced
Debug log: すべての Jadlog のリクエストとレスポンスを、モジュールのフォルダにある logs/vfd_jdlg_debug.log.php に記録します。このファイルはウェブから開くことはできません。API のエラーは、このオプションがオフでも常に記録されます。トークン、CNPJ、口座は記録されず、顧客の CEP は短縮されます。作業が終わったらログをオフにしてください。
Log: ログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログを空にできます。
Remove data on uninstall: オンの場合、モジュールをアンインストールすると、Jadlog のすべての設定と配送業者が削除されます。オフの場合、アンインストールは配送業者をオフにするだけです。キャッシュされた料金は常に削除されます。注文は変更されません。
チェックアウトでの動作
配送ステップで、PrestaShop は各 Jadlog 配送業者の料金をモジュールに問い合わせます。対象になるのは実物の商品のみです。バーチャル商品は重量に加算されず、注文金額にも含まれません。モジュールはまず条件を確認します。カートの重量と最低注文金額、そして Ignore shipping zones がオンの場合は許可された国です。カートの小計が Free shipping from に達した場合は送料無料となり、Jadlog への料金のリクエストは送信されません。
8 桁の完全な CEP を持つブラジルの配送先住所の場合、モジュールは発送元と宛先の CEP、重量、お客様の CNPJ、当座口座、契約、サービス、保険の種類、申告注文金額を Jadlog に送信します。返された料金はショップのデフォルト通貨に換算され、顧客のカート通貨で表示されます。重量のないカートは 0.1 kg として見積もられます。リアルタイム料金がない場合（トークンがない、住所がブラジル国外、CEP が不完全、BRL の為替レートがない、Jadlog のエラー）、モジュールは Price per country の表を使用し、その後 Fallback cost を使用します。どちらも料金を提供しない場合、そのカートでは配送業者は非表示になります。
各料金は 1 時間キャッシュされるため、同じカートで新たなリクエストが発生することはありません。失敗したリクエストは 10 分間キャッシュされます。Jadlog が応答しない、サーバーエラーを返す、またはトークンを拒否する場合、10 分間は API が再度呼び出されません。API のタイムアウトは 10 秒です。顧客に API のエラーが表示されることはありません。理由はログに記録されます。
注文がある配送業者を Shipping > Carriers で編集すると、PrestaShop はそれを新しいバージョンの配送業者として保存します。モジュールは新しいバージョンに自動的に追従します。
モジュールが行うのは、料金の計算と Pickup 拠点の一覧表示のみです。Jadlog の配送伝票の作成、ラベルの印刷、集荷の依頼、発送の取り消し、荷物の追跡は行いません。Pickup 拠点の地図は表示せず、Jadlog に国際的な見積もりも依頼しません。その他の国には固定料金を使用してください。
Pickup 拠点
Jadlog Pickup 配送業者は、ブラジルの住所に対してのみ、かつ API トークンが保存されている場合にのみ提供されます。顧客が 8 桁の完全な CEP を入力すると、モジュールは Jadlog に、最も近い有効な Pickup 拠点を問い合わせ、配送業者の下に最大 Points to show 件の拠点を、それぞれの料金付きで表示します（例: "拠点名 — 料金 (3 business days) — 住所"）。一覧がまだキャッシュされていない場合は、顧客が配送業者を選択した時点で読み込まれるため、配送ステップが Jadlog の応答を待つことはありません。
各拠点の料金は Jadlog に問い合わせられます。Jadlog がある拠点の料金を返さない場合は固定料金が使用され、どの料金もない拠点は除外されます。Pickup 拠点の一覧は 12 時間キャッシュされます。配送業者の料金は、選択された拠点の料金です。拠点が選択される前は、料金のある最も近い拠点の料金になります。他の拠点に料金がある限り、料金のない拠点によって配送業者が非表示になることはありません。顧客が拠点を選択すると、配送ステップが新しい料金で更新されます。
拠点の選択は必須です。拠点がなければ顧客は先に進めず、Please select a Jadlog Pickup point. と表示されます。モジュールは、その拠点が配送先 CEP の Jadlog 一覧に含まれているかを確認します。含まれていない場合、顧客には The selected Jadlog Pickup point is not in the Jadlog list for this CEP. Please choose the point again. と表示されます。CEP が不完全な場合、近くに拠点がない場合、または Jadlog が利用できない場合は、配送業者の下にメッセージが表示されます。
API トークンがない場合、8 桁の CEP がない場合、Jadlog が利用できない場合、または近くに有効な拠点がない場合、Jadlog Pickup 配送業者は非表示になります。拠点のない注文は発送できません。
注文
Jadlog 配送業者で注文が行われると、モジュールは Jadlog のサービスを保存します。また、Jadlog がそれを返した場合は、営業日単位の配送日数も保存します。Jadlog Pickup の注文の場合は、Pickup 拠点の名称、住所、ID も保存します。
管理画面の注文ページには Jadlog ブロックが表示され、Jadlog service、Delivery time が含まれます。Jadlog Pickup の場合は、Pickup point、Pickup point address、Pickup point ID も表示されます。顧客は注文確認ページと注文の詳細で、選択された拠点を確認できます。拠点は注文確認メールの配送業者名に追加されます。ショップの新規注文メール（メールアラートモジュールを使用している場合）にも、拠点の ID が含まれます。
発送は Jadlog のシステムで自分で登録してください。注文には、そのために必要なサービスと Pickup 拠点の ID が表示されます。
ライセンスキー
このモジュールは、vibefox.net で入手する VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Jadlog は、Modules > Module Manager > VibeFox Jadlog > Configure ページの最初のブロックで、設定の上にあります。キーを License key に入力し、Activate をクリックしてください。その後、ブロックにはキーがマスクされて表示され、ステータス（ライセンスの有効期限日やドメインなど）と、ボタン Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このショップからキーを削除）が表示されます。その下には、Product: presta-shipping-jadlog の行と、Manage licenses and domains in your account のリンクがあり、vibefox.net のアカウントが開きます。キーを変更できるのは、モジュールの Configure 権限を持つ従業員だけです。ブロックのテキストは管理画面の言語に従います（英語とロシア語を含みます）。
キーが受け付けられない場合、ブロックにその理由が表示されます。例：Key not found、This key belongs to another product、Domain limit reached、License expired on と日付。ショップのアドレスを変更した後、またはアカウントでドメインの枠を解放した後に、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認されたステータスのまま動作し続けます。
1 つのキーは 1 つのドメインで使用できます。メインショップのドメインを指し、マルチストア構成でも同様です。ショップからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウト時に Jadlog の配送業者は購入者に表示されず、料金も計算されません。PrestaShop のストアフロントは、管理画面にログインしていることを認識しないため、配送業者は管理者にも表示されません。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れた場合も、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。管理画面で作業している間、ステータスは自動的に再確認されます。キーを入力後最初の 14 日間は 1 日 1 回、その後は週に 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
チェックアウトに Jadlog が表示されない: ライセンスが有効であること、そして Enable/Disable（または Enable Jadlog Pickup）がオンであることを確認してください。Shipping > Carriers で、配送業者が顧客の国のゾーンと顧客のグループをカバーしているか確認するか、Ignore shipping zones をオンにしてください。モジュールのページ上部の警告、重量制限、Minimum order amount を確認してください。顧客がまだ 8 桁の完全な CEP を入力していない場合は、固定料金のみが使用できるため、Price per country に行を追加するか、Fallback cost を設定してください。また、商品ページで商品を特定の配送業者に限定することもできます。
固定料金のみが表示される: Debug log をオンにして、チェックアウトを再読み込みし、モジュールのページにある Log フィールドを確認してください。理由が表示されます。CNPJ または当座口座がない、発送元 CEP がない、宛先 CEP が不完全、BRL の為替レートがない、または Jadlog のエラーメッセージです。
ログに HTTP 401 または 403 が出る: Jadlog が API トークンを拒否しました。Jadlog のフランチャイズ先で確認してください。このエラーの後、API は 10 分間停止します。設定を保存すると停止が解除されるので、すぐに再試行できます。
Pickup 拠点が表示されない: Jadlog Pickup 配送業者には、Enable Jadlog Pickup、API トークン、ブラジルの 8 桁の完全な CEP が必要です。CEP の近くに Jadlog の有効な拠点がない場合、配送業者は非表示になります。理由はログで確認してください。
料金が自分の通貨ではなくレアルで表示される: BRL exchange rate（ショップのデフォルト通貨で 1 BRL が何にあたるか）を入力してください。
料金が低すぎる、または高すぎるように見える: 商品の重量と寸法を入力してください。重量のないカートは 0.1 kg として見積もられ、容積重量には寸法が必要です。
Jadlog の料金に税が加算される: Tax status を None に設定してください。
変更後に料金が古いままに見える: モジュールのページで Save をクリックしてください。キャッシュされた Jadlog 料金と Pickup 拠点の一覧が消去されます。
Jadlog の配送業者が見つからないと表示される: Shipping > Carriers で配送業者が削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。
アンインストール
Modules > Module Manager に進み、VibeFox Jadlog の横のメニューを開いて Uninstall を選択してください。ライセンスキーとライセンスステータスは、常に削除されます。キャッシュされた料金と Pickup 拠点の一覧は、常に削除されます。Remove data on uninstall がオンの場合、両方の配送業者が削除され（注文は履歴を保持します）、設定とログも削除されます。オフの場合、配送業者はオフになるだけで、すべての設定は保持されます。モジュールを再インストールすると、配送業者は以前のステータスに戻ります。注文とともに保存された Jadlog のサービス、配送日数、Pickup 拠点は、常に保持されます。
Jadlog は、それぞれの所有者の商標です。本モジュールは Jadlog と提携しておらず、Jadlog の承認も受けていません。