VibeFox J&T Express for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 5.0 以降。インストールされ、有効になっていること。WooCommerce がない場合、プラグインは有効化できません。
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 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_jt_express フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます。WooCommerce > Settings > Shipping > VibeFox J&T Express、またはプラグインの一覧ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. 料金表と/または予備の送料を入力します。マレーシアのリアルタイム見積もりを使う場合は、J&T API の認証情報、発送元の郵便番号も入力してください。ストアの通貨が MYR でない場合は、通貨換算レートも入力します（設定を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーンに VibeFox J&T Express を追加するか、Ignore shipping zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox J&T Express。これらの設定はすべての配送ゾーンに適用されます。配送ゾーンにこの方法を追加する際、ゾーンのウィンドウには 1 つの項目しかありません:
Title (zone): このゾーンで購入者に表示される名前です。空欄のままにすると、全体の Method title が使用されます。
設定を保存するたびに、キャッシュされた J&T の見積もりは消去されます。リアルタイム見積もりの設定が一部だけの場合、ページ上部の警告に不足している設定が表示されるか、通貨換算レートが未設定であることが示されます。
一般
Enable/Disable: すべてのゾーンでこの方法を一度にオンまたはオフにします。デフォルト: on。
Method title: カートとチェックアウトに表示される配送方法の名前です。ゾーンごとに上書きできます。デフォルト: J&T Express。
Tax status: Taxable を選ぶと、料金にストアの配送税が加算されます。None を選ぶと加算されません。J&T の料金に請求したいものがすべて含まれている場合は None を選んでください。
J&T Express Malaysia API（リアルタイム見積もり）（任意。マレーシアの配送先住所向け。4 つの認証情報すべてが必要です）
VIP customer code: J&T Express の VIP 顧客コードです。
VIP API key: VIP コードと一緒に J&T Express から渡された API キー（パスワード）です。ログには記録されません。
API account: J&T Express の API アカウント名です。
API private key: API アカウントの秘密鍵です。リクエストの署名（SHA-256）にのみ使用されます。J&T に送信されることはなく、ログにも記録されません。
Sender postcode: 荷物を発送するマレーシアの郵便番号です。ストアがマレーシアにある場合は、空欄にすると WooCommerce > Settings > General のストアの郵便番号が使われます。保存時にスペースは削除されます。
Currency conversion rate: J&T Express Malaysia の見積もりは MYR 建てです。ストアの通貨が MYR でない場合は、1 MYR がご自身の通貨で何単位に相当するかを入力してください（1 MYR = X）。この値がないと、リアルタイム見積もりは使用されず、代わりに料金表または予備の送料が使われます。ストアの通貨が MYR の場合は空欄のままにしてください。見積もりはそのまま使用されます。小数点としてピリオドとカンマのどちらも使用できます。
料金表と予備（マレーシア以外の国向け。リアルタイム見積もりが設定されていない場合、または 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 も料金表も料金を提供できない場合に使用される料金です。その場合にこの方法を非表示にするには、空欄のままにします。
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): カートがこれより重い場合、この方法を非表示にします。デフォルト: 50。0 は上限なしを意味します。
Excluded shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、この方法を非表示にします。
配送ゾーンを使わない場合の提供範囲
Ignore shipping zones: どの配送ゾーンにも追加されていなくても、下記の国向けにこの方法を提供します。オフの場合、この方法は追加されたゾーンにのみ表示されます。
Countries: このモードの配送先の国です。空欄にすると、発送可能なすべての国が使用されます。このフィールドは Ignore shipping zones が有効な場合にのみ使用されます。
詳細設定
Debug log: 料金の計算内容を WooCommerce > Status > Logs に、ソースは vfd-jt-express として書き込みます。このオプションがオフでも、J&T API のエラーは常に記録されます。キー、パスワード、購入者の郵便番号は書き込まれません。作業が終わったらログをオフにしてください。
Remove data on uninstall: オンにすると、プラグインを削除したときに、その設定、ゾーンの配送方法、キャッシュされた見積もりが削除されます。プラグインを無効化しても、何も削除されません。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまず条件を確認します: 配送先の国、カートの重量、最低小計、除外する配送クラスです。カートの小計が Free shipping from に達している場合、その国に料金が設定されていれば、料金 0 でこの方法が表示されます。料金が設定されているとは、Country prices の行、Fallback cost、または J&T のリアルタイム見積もりのいずれかがあることです。J&T に問い合わせるのは、料金表と予備の送料で料金が得られない場合のみです。
それ以外の場合、料金は最初に料金を提供できた情報源から取得されます:
1. J&T のリアルタイム見積もり: 4 つの API 認証情報と発送元の郵便番号がすべて設定されており、配送先の国がマレーシアで、購入者が 5 桁の郵便番号を入力しており、MYR 以外のストアの場合は換算レートが設定されている場合にのみ使用されます。プラグインは J&T に、発送元と配送先の郵便番号、カートの重量（0.1 kg 以上）を送信して、標準サービス EZ（荷物 1 個）を要求し、返された MYR の料金をストアの通貨に換算します。
2. Country prices: 配送先の国の行、または * の行にある、カートの重量区分の料金です。
3. Fallback cost.
これらのいずれからも料金が得られない場合、この方法は非表示になります。Per item は料金表と予備の料金にのみ適用されます。
J&T からの各応答は 1 時間キャッシュされるため、同じカートで新たなリクエストが発生することはありません。失敗したリクエストは 10 分間キャッシュされるため、チェックアウトは更新のたびに J&T の応答を待つことはありません。リクエストのタイムアウトは 10 秒です。J&T がエラー、0 の料金、または応答なしを返した場合、購入者にエラーは表示されません。料金表または予備の料金が使用され、その理由がログに記録されます。
この方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。
プラグインが計算するのは送料だけです。送り状、託送状、ラベルの作成、集荷の予約、荷物のキャンセルや追跡は行わず、購入者が受け取り場所を選ぶこともできません。出荷と追跡は、いつも通り J&T のアカウントで行ってください。本プラグインは、公式の J&T Express Malaysia プラグインのリクエスト形式に合わせて作られています。本番運用を開始する前に、J&T のアカウントで料金を確認してください。
ライセンスキー
このプラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox J&T Express の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ライセンスの有効期限日やご自身のドメインなどのステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。枠は vibefox.net のアカウントで解放してください。
有効なキーがない場合、J&T Express はチェックアウトで購入者に表示されません。ログインしているストアの管理者には表示され、(unlicensed — visible to admins only) と表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインの一覧ページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。
ライセンスが期限切れになっても、プラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
J&T Express がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、購入者の国のゾーンにこの方法が追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。重量の制限、Minimum subtotal、Excluded shipping classes を確認してください。Country prices にその国の行、または * の行があること、もしくは Fallback cost が設定されていることを確認してください。Debug log をオンにして、WooCommerce > Status > Logs を確認してください。
料金が J&T ではなく料金表から来ている: リアルタイム見積もりには、4 つの API 認証情報、発送元の郵便番号、5 桁の郵便番号を含むマレーシアの配送先住所、そして MYR 以外のストアの場合は Currency conversion rate が必要です。設定ページ上部の警告を確認してください。J&T がリクエストを拒否した場合、または応答しない場合、エラーはログに記録され、料金表または予備の料金が使用されます。失敗したリクエストは 10 分後に再試行されます。
フィリピンまたはインドネシアのリアルタイム見積もりがない: J&T は、これらの国向けに公開された見積もり API を提供していません。これらの国では料金表と予備の送料を使用してください。
ある国が誤って送料無料になる: その行の基本料金が 0 になっています（空欄の基本料金は 0 として保存されます）。基本料金を入力するか、行を削除してください。
変更後に料金が古いように見える: 設定ページを保存してください。キャッシュされた J&T の見積もりが消去されます。
開発者向けフック: フィルター vfd_jtex_quote_request は見積もりリクエストの本文（サービスタイプなど）を変更し、vfd_jtex_api_url は見積もりのエンドポイントを変更します。標準フィルター woocommerce_shipping_vfd_jt_express_is_available は提供範囲を制御します。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。例えば、そのキーが別のドメインで既に使われている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認された状態で動作し続けます。
アンインストール
プラグインを無効化しても、すべてのデータは保持されます。完全に削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。設定、ゾーンの配送方法、キャッシュされた見積もりは、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールする際のために残ります。既存の注文は、配送の明細行を保持します。
J&T Express は、各所有者の商標です。本プラグインは J&T Express と提携しておらず、その推奨も受けていません。