VibeFox J&T Express for OpenCart — ヘルプ
動作環境
OpenCart: 3.0.x（3.0.5.0 で検証済み）または 4.0.2 以降（4.1.0.3 で検証済み）。
PHP: 8.0 以降。
J&T Express Malaysia API アクセス（リアルタイム見積もりのみ）: リアルタイム見積もりは、マレーシアの配送先向けの J&T Express Malaysia でのみ利用できます。4 つの値が必要です。J&T Express Malaysia の Web サイトで J&T VIP アカウントを申し込んでください（拡張機能のページにリンクがあります）。J&T から VIP 顧客コードと VIP API キーが提供されます。API アカウントと、リクエストの署名に使用する秘密鍵は、API 連携のために J&T から発行されます。J&T のアカウントマネージャーにお問い合わせください。J&T のフィリピン、インドネシア、その他の国には公開された見積もり API がないため、それらの国では料金表を使用してください。料金表と予備料金のみを使用する場合、J&T API へのアクセスは不要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
ダウンロードは、両方の OpenCart バージョン向けのパッケージを含む 1 つの zip ファイルです。コンピュータで解凍してください。含まれるのは README.txt、OpenCart 3 用のパッケージ vfd_jt_express-oc3-(version).ocmod.zip、OpenCart 4 用のパッケージ vfd_jt_express.ocmod.zip です。お使いの OpenCart バージョンのパッケージのみをインストールしてください。ライセンスキーは両方のバージョンで同じです。
OpenCart 3
1. 管理画面で Extensions > Installer を開き、Upload をクリックして、ファイル vfd_jt_express-oc3-(version).ocmod.zip を選択します。この拡張機能は OCMOD の修正を追加しないため、Extensions > Modifications を更新する必要はありません。Installer を使う代わりに、このパッケージの upload フォルダの内容をストアのルートフォルダにコピーすることもできます。
2. Extensions > Extensions に移動し、拡張機能の種類で Shipping を選択します。VibeFox J&T Express を見つけて、Install（緑の + ボタン）をクリックします。
3. Edit（鉛筆のボタン）をクリックして設定ページを開きます。
4. Edit ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを貼り付け、Activate をクリックします（ライセンスキーを参照）。
5. 料金表や予備料金を入力します。マレーシアのリアルタイム見積もりを使う場合は、J&T API の認証情報、発送元の郵便番号、そしてストアの既定通貨が MYR でない場合は通貨換算レートも入力します（Configuration を参照）。Enable J&T Express をオンにして Save をクリックします。
OpenCart 4
1. 管理画面で Extensions > Installer を開き、Upload をクリックして、ファイル vfd_jt_express.ocmod.zip を選択します。ファイル名は変更しないでください。OpenCart 4 は拡張機能のコードをファイル名から取得するため、名前を変更したパッケージは動作しません。
2. 同じページの、インストール済みの拡張機能の一覧にパッケージが表示されます。その横の Install（緑の + ボタン）をクリックします。
3. Extensions > Extensions に移動し、拡張機能の種類で Shipping を選択します。VibeFox J&T Express を見つけて、Install（緑の + ボタン）をクリックし、次に Edit（鉛筆のボタン）をクリックします。
4. ライセンスキーと設定は、OpenCart 3 の手順 4 と 5 と同じように入力します。設定ページとその項目は両方のバージョンで同じです。
インストール直後は、Enable J&T Express をオンにして保存するまで配送方法はオフのままです。アンインストール後に拡張機能を再インストールすると、保持されていた J&T Express の設定が再び使用されます。
設定
すべての設定は拡張機能のページにあります: Extensions > Extensions > Shipping > VibeFox J&T Express > Edit。セクションは左側に一覧表示されます。ページ下部の Save ボタンで、ページを再読み込みせずに全体を保存します。保存のたびに、キャッシュされた J&T の見積もりも消去されます。値が正しくない場合は何も保存されず、ページに理由が表示されます。たとえば、配送方法のタイトルが無効、金額が 0 以上の数値ではない、Currency conversion rate が 0、Min weight (kg) が Max weight (kg) より大きい、並び順が整数ではない、といった場合です。設定を保存できるのは、この拡張機能の変更権限を持つ管理者ユーザーだけです。
設定の上に表示される警告（保存のたびに再表示されます）は、リアルタイム見積もりの設定が一部のみ完了していることを知らせます。不足している API 設定を一覧表示したり、ストアの通貨が MYR ではなく換算レートが不足していることを示したりします。System > Localisation > Weight Classes に単位 kg の重量クラスがない場合は、別の警告が表示されます。その場合、商品の重量は単位名（kg、g、lb、oz）に基づいて換算され、その他の単位は kg として扱われます。
一般
配送方法は、選択したジオゾーン、または Ignore shipping zones の国に対して提供されます。このページの設定はすべてのゾーンに適用されます。
Enable J&T Express: チェックアウトで配送方法を表示または非表示にします（この拡張機能の状態）。既定値: オフ。
Method title: カートとチェックアウトで購入者に表示される配送方法の名前。既定値: J&T Express。必須、最大 64 文字で、文字 < > ; = # { } は使用できません。
Tax class: 送料の税クラス、または No tax（既定値）。税クラスを選ぶと、送料に配送税が加算されます。J&T の料金に請求したい内容がすべて含まれている場合は No tax を選択してください。
Sort order: チェックアウトの配送方法の中での、この配送方法の表示位置。整数です。
J&T Express Malaysia API（リアルタイム見積もり）（任意。マレーシアの配送先向け。4 つの認証情報すべてが必要です）
マレーシアの郵便番号ごとに J&T Express Malaysia へ見積もりを要求し、1 時間キャッシュします。認証情報がない場合、およびその他の国では、料金表と予備料金が使用されます。
VIP customer code: J&T Express の VIP コードです。消去すると、保存された VIP API キーも消去されます。
VIP API key: J&T Express が VIP コードとともに発行した API キー（パスワード）です。ログに記録されることはありません。保存後、この欄は空のままになり、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。削除するには、VIP customer code を消去して保存します。
API account: J&T Express の API アカウント名です。消去すると、保存された秘密鍵も消去されます。
API private key: API アカウントの秘密鍵です。リクエストの署名（SHA-256）にのみ使用されます。J&T に送信されることも、ログに記録されることもありません。VIP API キーと同様に、保存後は再表示されません。削除するには、API account を消去して保存します。
Sender postcode: 荷物を発送するマレーシアの郵便番号です（例: 50000）。リアルタイム見積もりには必須です。OpenCart のストア住所は自由入力のテキストのため、郵便番号はそこからは取得されません。
Currency conversion rate: J&T Express Malaysia の見積もりは MYR 建てです。ストアの既定通貨が MYR でない場合は、1 MYR が貴店の通貨でいくらに当たるかを入力します（1 MYR = X）。例: 0.20。この値がない場合、リアルタイム見積もりは使用されず、料金表または予備料金が使われます。既定通貨が MYR の場合、この欄にその旨が表示され、入力は不要です。見積もりはそのまま使用されます。レートは 0 より大きい値である必要があります。
料金表と予備料金（リアルタイム見積もりが設定されていない場合、または J&T が見積もりを返さない場合に、マレーシア以外の国で使用されます。料金は貴店の既定通貨で、税別です）
Country prices: 国ごとに 1 行の表です。Add country をクリックすると行が追加され、削除ボタンで行を削除できます。個別の行がないすべての国には * Any other country を選択します。各行には Base price と、5 つの重量区分があります。XS は 1 kg まで、S は 2 kg まで、M は 3 kg まで、L は 5 kg まで、XL は 5 kg を超える場合です。0 より大きい区分料金は、その区分のカートについて基本料金に代わって使用されます。区分が 0 の場合は基本料金が使用されます。基本料金が 0 の場合は送料無料となり、空の基本料金は 0 として保存されます。行のない国（* 行がない場合）には、料金表による料金は適用されません。
Fallback cost: J&T も料金表も料金を提示できない場合に使用される料金です。その場合に配送方法を非表示にするには空欄にします。0 は送料無料を意味します。
Table / fallback price is: Per order（既定値）は料金を 1 回だけ請求します。Per item (multiplied by the number of items) は、カート内の商品数を掛けた料金を請求します。J&T のリアルタイム見積もりは、常に注文全体に対するものです。
条件
Free shipping from: 送料無料となるカートの小計（配送が必要な商品について、クーポン適用後、税抜き）。送料無料がない場合は空欄にします。
Minimum subtotal: カートの小計がこの金額に達した場合のみ配送方法を表示します。常に表示する場合は空欄にします。
Min weight (kg): カートの重量がこれ未満の場合は配送方法を非表示にします。商品の重量は重量クラスに基づいて換算されます。0 は制限なし（既定値）を意味します。Max weight (kg) より大きくすることはできません。
Max weight (kg): カートの重量がこれを超える場合は配送方法を非表示にします。既定値: 50。0 は制限なしを意味します。
Geo zone: この地理的ゾーン内の住所に対してのみ配送方法を提供します。All zones（既定値）は制限なしを意味します。ジオゾーンは System > Localisation > Geo Zones で管理されます。Ignore shipping zones がオンの場合は使用されません。
配送ゾーンなしでの提供
Ignore shipping zones: ジオゾーンに関係なく、下記の国に対して配送方法を提供します。既定値: オフ。
Countries: このモードの配送先の国です。ストアで有効になっている国から選択します。空欄にするとすべての国を許可します。この欄は Ignore shipping zones がオンの場合にのみ使用されます。
詳細設定
Debug log: 料金計算を storage/logs/vfd_jtex_debug.log.php（OpenCart 4 では system/storage/logs/vfd_jtex_debug.log.php）に書き込みます。このファイルは Web から読み取ることはできません。この設定がオフでも、J&T API のエラーは常に記録されます。キー、パスワード、顧客コード、購入者の郵便番号は書き込まれません。作業が終わったらログをオフにしてください。ファイルが 5 MB に達すると、vfd_jtex_debug.old.log.php に移動され、新しいログが開始されます。
Log: デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると空になります。
Remove data on uninstall: オンの場合、拡張機能をアンインストールすると、J&T Express の設定とログが削除されます。オフ（既定値）の場合は、再インストールに備えて保持されます。キャッシュされた見積もりは常に削除されます。
インポート / エクスポート
Export: Download JSON をクリックすると、設定を JSON ファイルとして保存します。VIP API キーと秘密鍵はエクスポートされません。
Import: 以前にエクスポートした JSON を貼り付け、Import をクリックすると、設定を復元します（例: 別のストアで）。値は通常の保存と同じように検証されます。保存済みのキーは保持されます。
チェックアウトでの動作
OpenCart が配送方法を表示するとき、拡張機能に J&T Express の料金を問い合わせます。Geo zone が設定されていて（かつ Ignore shipping zones がオフの場合）、住所がそのゾーンの外であれば、配送方法は提供されません。Requires Shipping が Yes に設定された商品のみが対象になります。それ以外の商品は重量に加算されず、小計にも含まれません。次に拡張機能は条件を確認します。許可された国（Ignore shipping zones 使用時）、カートの重量、最低小計です。小計は、配送が必要な商品の価格で、クーポン割引後、税抜きの金額です。ギフト券、ポイント、ストアクレジットは考慮されません。小計が Free shipping from に達した場合、料金は 0 となり、J&T へのリクエストは送信されません。
それ以外の場合、料金は最初に料金を提示できるソースから取得されます。
1. J&T のリアルタイム見積もり: 4 つの API 認証情報と発送元の郵便番号がすべて設定されていて、配送先の国がマレーシアであり、購入者が 5 桁の郵便番号を入力していて、ストアの既定通貨が MYR 以外の場合は換算レートも設定されている場合にのみ使用されます。拡張機能は、標準サービス EZ（荷物 1 個）用に、発送元と配送先の郵便番号、カートの重量（0.1 kg 以上）を J&T に送信し、返された MYR の料金を既定通貨に換算します。
2. 国ごとの料金: 配送先の国の行、または * 行の、カートの重量区分に対応する料金です。
3. 予備料金。
いずれも料金を提示しない場合、そのカートでは配送方法が非表示になります。Per item は、料金表と予備料金にのみ適用されます。料金は貴店の既定通貨で計算され、その通貨の小数桁で丸められ、選択した Tax class の税を含めて、購入者の通貨で表示されます。
J&T からの各応答は 1 時間キャッシュされるため、同じカートでは新たなリクエストは発生しません。失敗したリクエストは 10 分間キャッシュされるため、チェックアウトの更新のたびに J&T の応答を待つことはありません。リクエストのタイムアウトは 10 秒です。J&T がエラー、0 の料金、または応答なしを返した場合でも、購入者にエラーは表示されません。料金表または予備料金が使用され、理由がログに記録されます。
OpenCart 4 では、チェックアウトページの配送方法ブロックで購入者が Choose をクリックし、Shipping method options ウィンドウで J&T Express を選択します。この配送方法は OpenCart 3 と同じように動作します。
この拡張機能が計算するのは送料のみです。送り状、輸送伝票、ラベルの作成、集荷の予約、荷物のキャンセルや追跡は行わず、購入者が受け取り場所を選ぶこともできません。注文に何かを追加することもありません。注文には、他の OpenCart の配送方法と同様に、配送方法のタイトルと送料が表示されます。配送の作成と追跡は、いつも通り J&T のアカウントで行ってください。この拡張機能は、公式の J&T Express Malaysia の要求形式に基づいて作成されています。本番稼働の前に、料金を J&T アカウントで確認してください。
ライセンスキー
この拡張機能は、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox J&T Express は、Extensions > Extensions > Shipping > VibeFox J&T Express > Edit ページで設定の上にある最初のブロックです。キーを License key に貼り付けて Activate をクリックします。その後、ブロックにはキーがマスク表示され、ステータス（ライセンスの有効期限日やドメインなど）と、次のボタンが表示されます。Check now はステータスを再確認し、Change key は別のキーを入力し、Remove key はこのストアからキーを削除します。その下には Product: opencart-shipping-jt-express の行と、Manage licenses and domains in your account のリンクがあり、vibefox.net のアカウントが開きます。キーを変更できるのは、この拡張機能の Modify 権限を持つ管理者ユーザーだけです。ブロックのテキストは管理画面の言語に従います（英語とロシア語が含まれます）。
キーが受け付けられない場合、ブロックには理由が表示されます（例: Key not found、This key belongs to another product、Domain limit reached、日付付きの License expired on）。ストアの住所を変更した後、またはアカウントでドメイン枠を解放した後に、Check now をクリックしてください。ライセンスサーバーに接続できない場合、拡張機能は最後に確認できたステータスで動作を続けます。
1 つのキーは 1 つのドメインで使用できます。対象は OpenCart の設定にあるストアの住所です。ストアからキーを削除しても、ドメイン枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、J&T Express の配送方法はチェックアウトで購入者に表示されず、料金も計算されません。同じブラウザで管理画面にログインしている管理者ユーザーには、ストアでこの配送方法が引き続き表示され、(unlicensed — visible to admins only) と印が付きます。そのため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 では、このプレビューは利用できません。ストアは管理画面のログイン状態を認識しないため、有効なキーがない場合は、すべての利用者に対してこの配送方法が非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると、7 日間非表示になります。既存の注文には影響しません。
ライセンスの期限が切れた後も拡張機能は動作しますが、アップデートとサポートには更新が必要です。管理画面の Dashboard または Edit ページを開くと、ステータスが自動的に再確認されます。キー入力後の最初の 14 日間は 1 日に 1 回、その後は週に 1 回です。cron ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
チェックアウトに J&T Express が表示されない: ライセンスが有効であること、Enable J&T Express がオンであることを確認してください。Geo zone を確認してください（または Ignore shipping zones がオンで、その国が Countries に含まれているかを確認）。重量の制限と Minimum subtotal も確認してください。Country prices にその国の行または * 行があるか、Fallback cost が設定されているかを確認してください。商品の Requires Shipping が Yes に設定されているか確認してください。Debug log をオンにして、拡張機能のページの Log 欄を確認してください。
料金が J&T ではなく料金表から来ている: リアルタイム見積もりには、4 つの API 認証情報、発送元の郵便番号、5 桁の郵便番号を持つマレーシアの配送先、そして MYR 以外のストアの場合は Currency conversion rate が必要です。拡張機能のページ上部の警告を確認してください。J&T がリクエストを拒否した場合、または応答しない場合、エラーはログに記録され、料金表または予備料金が使用されます。失敗したリクエストは 10 分後に再試行されます。
フィリピンまたはインドネシアのリアルタイム見積もりがない: J&T はこれらの国向けに公開された見積もり API を提供していません。これらの国では料金表と予備料金を使用してください。
ある国が誤って送料無料になる: その国の行の基本料金が 0 になっています（空の基本料金は 0 として保存されます）。基本料金を入力するか、行を削除してください。Free shipping from も確認してください。
変更後に料金が古いままに見える: 拡張機能のページで Save をクリックしてください。これにより、キャッシュされた J&T の見積もりが消去されます。
ページに "Warning: You do not have permission to modify VibeFox J&T Express!" と表示される: 管理者ユーザーグループは設定を閲覧しかできない可能性があります。System > Users > User Groups で、そのグループに extension/shipping/vfd_jt_express（OpenCart 3）または extension/vfd_jt_express/shipping/vfd_jt_express（OpenCart 4）の変更権限を付与してください。
開発者向け: 他の拡張機能は、OpenCart イベント vfd_jt_express/quote_request で見積もりリクエストの本文（サービスの種類など）を変更できます。また、vfd_jt_express/api_url で見積もりのエンドポイントを変更できます。
アンインストール
Extensions > Extensions に移動し、種類 Shipping を選んで、VibeFox J&T Express の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは常に削除されます。OpenCart は常に Enable J&T Express、Sort order、Tax class、Geo zone をリセットします。キャッシュされた見積もりは常に削除されます。Remove data on uninstall がオンの場合は、J&T Express の設定とデバッグログも削除されます。オフの場合は、その他の設定が保持され、拡張機能を再インストールしたときに再び使用されます。既存の注文は、配送方法と送料をそのまま保持します。
OpenCart 4 では、拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に移動し、インストール済み拡張機能の一覧で VibeFox J&T Express の横にある Uninstall（オレンジ色の − ボタン）をクリックしてから、Delete（赤いゴミ箱のボタン）をクリックして、アップロードしたパッケージを削除します。
J&T Express は、それぞれの所有者の商標です。この拡張機能は J&T Express と提携しておらず、J&T Express による承認もされていません。