概要
VibeFox Loggi は、PrestaShop にブラジル国内の Loggi 宅配サービス用の配送業者を追加します。完全な 8 桁の CEP を持つブラジルの住所では、集荷先住所からの注文見積もりとしてカートが Loggi API に送信され、購入者はチェックアウトの配送ステップで Loggi の料金を確認できます。国と重量ごとの固定料金は、安全策として使用されます。
API アクセスのある Loggi 法人アカウントを持つブラジルのショップや、アカウントなしで簡単な Loggi 料金表を使いたいショップに適しています。本モジュールは、チェックアウト時に配送料を計算します。Loggi での注文や出荷の作成、送り状の印刷、荷物の追跡、配達日時の表示、受け取り拠点の提供は行いません。
主な機能
リアルタイムの Loggi 料金: 料金は、Loggi アカウントのメールアドレス、API キー、Shop ID を使い、Loggi GraphQL API の注文見積もりから取得されます。ステージング環境に対応しています。
実際の Loggi 荷物: 重量（グラム）と寸法（cm）はショップの単位から変換されます。商品は最大 55 × 55 × 55 cm、20 kg までの荷物にまとめられ、大きなカートは複数のリクエストで見積もられ、合計額が加算されます。
安全な通貨処理: Loggi の料金はブラジルレアルです。ショップのデフォルト通貨が BRL でない場合は、設定した BRL 為替レートで換算されます。為替レートがない場合は固定料金のみが使用され、モジュールのページに警告が表示されます。
安全策としての固定料金: 国ごとの料金表（重量列 XS から XL、注文単位または商品単位）と、その他すべての国の料金を設定できます。API が設定されていない場合、ブラジル以外の場合、完全な CEP がない場合、または Loggi が料金を返さない場合に使用されます。
高速なチェックアウト: Loggi の料金は 1 時間、失敗した見積もりは 10 分間キャッシュされます。Loggi に接続できない場合、リクエストは 2 分間停止されます。API のエラーが購入者に表示されることはありません。
配送ルール: カートの最小・最大重量、最低注文金額、注文金額以上で送料無料、配送業者の税ルール。
標準の PrestaShop 配送業者: インストール時に配送業者が作成されます。ゾーン、顧客グループ、サイズ制限は通常どおり Shipping > Carriers で管理するか、国のリストに対して Loggi を提供できます。
バックオフィスのデバッグログ: モジュールのページでログを表示・消去できます。API キーと顧客の住所はログに記録されることはありません。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。リアルタイムの料金には、Loggi GraphQL API へのアクセス権を持つ Loggi 法人アカウント（アカウントのメールアドレス、API キー、Shop ID）が必要です。固定料金はアカウントなしで利用できます。vibefox.net で取得する VibeFox ライセンスキー（ドメインごとに 1 つ）。