概要
VibeFox The Courier Guy は、南アフリカの The Courier Guy による配送を OpenCart に追加します。The Courier Guy が利用している ShipLogic プラットフォームと連携し、チェックアウトで 2 つの選択肢を提供します。玄関先までのクーリエ配送と、配送方法の手順で購入者が選んだ TCG ロッカーへの配送です。料金は ShipLogic のリアルタイム料金、または独自の料金表から算出されます。
The Courier Guy のビジネスアカウントを持つ南アフリカのストアに適しています。本拡張機能は送料を計算し、購入者がロッカーを選べるようにします。荷物の予約、送り状やラベルの作成、追跡情報の自動更新は行いません。The Courier Guy のポータルで荷物を予約し、その参照番号を注文ページに入力してください。
主な機能
2 つの配送オプション: 玄関先までのクーリエ配送と TCG ロッカー。それぞれに名前があり、設定ページで個別にオン・オフできます。
リアルタイムのクーリエ送料: 住所が完全に入力されると、発送元住所から購入者の住所までの ShipLogic で最も安いサービスの料金を表示します。
ロッカーの選択: 購入者は自分の都市のロッカーを確認でき、別の都市、地区、郵便番号で検索することもできます。次に進む前にロッカーを 1 つ選ぶ必要があります。選択内容はサーバー側で検証されます。
注文へのロッカー情報と追跡: ロッカー情報は注文の配送方法に追加されるため、管理画面、購入者の注文ページ、請求書、注文メールに表示されます。注文の管理画面にある The Courier Guy パネルには追跡参照番号が保存され、購入者はこれをアカウントや注文ステータスのメールで確認できます。
通貨と税: ShipLogic はランド（ZAR）で料金を提示します。ストアで使用する他の通貨では、設定した ZAR 換算レートが使われます。税クラスを設定した場合は税抜きの料金が使われるため、消費税が二重に課されることはありません。
料金表: 国と重量帯ごとの料金を、注文単位または商品単位で設定できます。南アフリカ以外の住所や、リアルタイム料金が得られない場合のために、フォールバック料金も設定できます。
安定したチェックアウト: 料金は 1 時間、ロッカー情報は 6 時間、失敗結果は 10 分間キャッシュされます。ShipLogic に接続できない場合は料金表が使われ、ロッカーを指定した注文も引き続き行えます。
分かりやすい設定ページ: API キー、リアルタイム料金、発送元住所、料金表、条件と提供状況の各セクションがあり、Save ボタンは 1 つだけです。JSON のインポートとエクスポート、デバッグログの表示にも対応しています。
要件
OpenCart 3.0.x（3.0.5.0 で動作確認済み）、PHP 8.0 以降。リアルタイム料金とロッカーには、The Courier Guy のクーリエポータルで取得した ShipLogic API キーが必要です。料金表だけであれば API キーは不要です。vibefox.net で購入した VibeFox ライセンスキーが必要です（1 つのキーは 1 つのドメインで使用できます）。