概要
VibeFox Correios は、OpenCart 3 および OpenCart 4 に Correios（ブラジル郵便）の配送方法を追加します。ブラジルの購入者には、CEP と荷物に応じた PAC、SEDEX などの Correios サービスのリアルタイム料金が表示されます。この料金は、お客様の契約の認証情報を使って Correios 料金 API から計算されます。他の国の購入者や、認証情報を設定していないブラジルの購入者には、国とカートの重量ごとに設定した固定料金が適用されます。
Correios の契約と郵送カード（cartão de postagem）を持つブラジルのストアに適しています。本拡張機能は、チェックアウト時に配送料を計算します。送り状や事前登録の作成、荷物の追跡、配達日数の表示、追加サービスの付加は行いません。また、購入者が Correios の窓口を選ぶことはできません。ストアごとに Correios のサービスは 1 つだけ提供されます。
主な機能
リアルタイムの Correios 料金: 発送元と届け先の CEP、荷物の重量とサイズに基づき、お客様の契約料金で Correios Web Services 料金 API から取得します。
任意のサービスを選択: PAC、SEDEX、SEDEX 12、SEDEX 10、SEDEX Hoje（通常料金または契約用のコード）、Correios Mini Envios、または契約内のその他のサービスコード。サービスは注文と一緒に保存され、管理画面の注文ページに表示されます。
正確な荷物データ: 重量とサイズは、商品の重量単位と長さの単位のクラスから換算されます。重量が設定されていない商品には既定の重量が適用され、Correios の最小サイズが適用されます。箱、封筒、筒の形式に対応しています。
安全な通貨処理: Correios の料金は BRL で設定されています。既定の通貨が異なるストアは BRL のレートを入力する必要があり、入力しない場合はリアルタイム料金は使用されません。料金は購入者の通貨で表示されます。
快適なチェックアウト: 料金は 1 時間、失敗したリクエストは 10 分間キャッシュされます。API トークンは自動的に更新されます。API のエラーが購入者に表示されることはありません。
固定料金: 国ごとの表で、カートの重量（XS から XL まで）ごとの料金と基本料金を、注文単位または商品単位で設定できます。ブラジル以外の国およびフォールバックとして使用されます。
配送ルール: ジオゾーンまたは国のリスト、カートの最小・最大重量、最低注文金額、注文金額に応じた送料無料、税率クラス。
わかりやすい設定ページ: ページを再読み込みせずに 1 つの Save ボタンで保存できるセクション構成、JSON のインポートとエクスポート、テスト用の Homologation モード、拡張機能のページで表示・消去できるデバッグログ（認証情報や購入者の CEP は含まれません）。
要件
OpenCart 3.0.x（3.0.5.0 で検証済み）または OpenCart 4.0.2 以降（4.1.0.3 で検証済み）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれます。リアルタイム料金には、契約の Correios Web Services 認証情報が必要です。具体的には、Meu Correios のユーザー、API のアクセスコード、郵送カード番号です。固定料金は認証情報がなくても利用できます。VibeFox ライセンスキー（vibefox.net で購入。1 つのキーは 1 つのドメインで使用可能）。