VibeFox Ninja Van for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 5.0 以降がインストールされて有効になっていること。WooCommerce がない場合、プラグインは有効化されません。
PHP: 8.0 以降。
Ninja Van 料金表: Ninja Van の発送元アカウントの料金、または Ninja Van の営業担当から受け取った料金を、料金表に入力します。API キーは不要です。インドネシア国内で利用できる任意のリアルタイム料金は、公開されており認証を必要としない Ninja Van Tariff API を使用します。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_ninja_van フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます: WooCommerce > Settings > Shipping > VibeFox Ninja Van。または、Plugins ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. Ninja Van の料金を料金表に入力します。インドネシア向けに必要な場合は Live rates を有効にしてください（設定を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーン（例: 「シンガポール」）に VibeFox Ninja Van を追加するか、Ignore shipping zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox Ninja Van。設定はすべての配送ゾーンに適用されます。ゾーンにこの配送方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます:
Title (zone): このゾーンで購入者に表示される名称。空欄にすると、全体の Method title が使われます。
一般
Enable/Disable: すべてのゾーンでこの配送方法を一度に有効または無効にします。
Method title: カートとチェックアウトで表示される配送方法の名称。ゾーンごとに上書きできます。既定値: Ninja Van。
料金（ストアの通貨で）
Ninja Van の料金表の料金を、ストアの通貨で入力してください。料金表が SGD、MYR、IDR、PHP、THB、VND のいずれかの場合は、先に換算してください。この表は、インドネシア以外のすべての配送先、およびリアルタイム料金が利用できない場合に使用されます。
Price table: 配送先の国ごとに 1 行。+ Add country をクリックすると行が追加され、× をクリックすると削除されます。独自の行がないすべての国には * All other countries を選択します。各行には Base price と重量列があります: XS は 1 kg まで、S は 2 kg まで、M は 3 kg まで、L は 5 kg まで、XL は 5 kg 超。重量列が空欄（または 0）の場合は基本料金が使われます。基本料金が 0 の場合、その国への配送は無料になります。「9.99」と「9,99」のどちらも入力できます。料金が入力されていない行は、保存時に削除されます。
Price for countries not in the table: 表に配送先の国の行がない場合（* の行もない場合）、またはその行にこの重量の料金がない場合に使われます。空欄にすると、この場合は配送方法が表示されません。
Price applies: 料金の計算方法。これはリアルタイム料金にも適用されます。
リアルタイム料金（API）— インドネシア
Ninja Van Tariff API は、インドネシア国内で発送される荷物について、割増料金や割引を含まない標準の配送料を返します。Ninja Van はこの機能をインドネシアのみで提供しています。Live rates が有効な場合、このセクションの下に表示されるステータス行には、発送元のゾーン、不足している換算レート、最後の Tariff API の応答が表示されます。
Live rates: インドネシア国内の配送について、Ninja Van のリアルタイム料金を取得します。既定値: 無効。この設定が無効の場合、チェックアウト中に Ninja Van へは何も送信されません。
Environment: Production (api.ninjavan.co)（既定）または Sandbox — testing only (api-sandbox.ninjavan.co)。
Service level: 料金を照会するサービス: Standard（既定）、Express、Same day、Next day。Ninja Van にそのルートとサービスの料金がない場合は、料金表が使われます。
Ship-from zone code L1 と Ship-from zone code L2: 発送元の地区の L1 と L2 の階層コード（例: ID_A00007_01 と ID_B00069_01）。設定ページにリンクされている Ninja Van のゾーンコード対応表（CSV）から取得します。両方を入力するか、両方を空欄にして、WooCommerce > Settings > General のストアの住所（インドネシア、州、市、市に複数のゾーンがある場合は住所欄の地区（Kecamatan））から自動検出させてください。形式が誤ったコードはエラーメッセージとともに消去されます。
IDR conversion rate: Tariff API はインドネシアルピア（IDR）で料金を返します。ストアの通貨が IDR の場合は、空欄のままにしてください。それ以外の場合は、1 IDR がストアの通貨でいくらになるかを入力します（例: 0.000058）。入力がなければ、リアルタイム料金は使われず、料金表が使われます。
条件
Minimum weight (kg): カートの重量がこの値未満の場合、配送方法を非表示にします。0 は制限なしを意味します。
Maximum weight (kg): カートの重量がこの値を超える場合、配送方法を非表示にします。既定値: 30。0 は制限なしを意味します。
Minimum order amount: カートの小計（割引後、税抜き）がこの金額に達した場合にのみ、配送方法を表示します。空欄にすると常に表示されます。
Free shipping from: カートの小計（割引後、税抜き）がこの金額以上の場合、Ninja Van の配送は無料になります。空欄の場合は送料無料になりません。
Excluded shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、配送方法を非表示にします。
Tax status: Taxable は配送料に WooCommerce の税金を加算します。None は加算しません。料金表の料金にすでに税（GST、SST、VAT）が含まれている場合は、None を選択してください。
配送ゾーンを使わない場合の提供範囲
Ignore shipping zones: 配送方法がどの配送ゾーンにも追加されていなくても、下に指定した国に Ninja Van を提供します。
Countries: このモードでの配送先の国。空欄にすると、発送先とするすべての国が使われます。この項目は Ignore shipping zones が有効な場合にのみ使われます。
詳細設定
Debug log: 料金計算の内容を WooCommerce > Status > Logs に記録します（ソース: vfd_ninja_van）。購入者の住所は記録されません。この設定が無効の場合でも、失敗した Tariff API のリクエストは記録されます。作業が終わったら無効にしてください。
Remove data on uninstall: 有効にすると、プラグインを削除したときに、Ninja Van のすべての設定とゾーンごとの配送方法が削除されます。プラグインを無効にしても、何も削除されません。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce がプラグインに料金を問い合わせます。プラグインはまず条件を確認します: 配送先の国、カートの重量、最低注文金額、除外される配送クラス。送料無料が適用される場合、購入者は無料で配送方法を確認でき、Ninja Van へのリクエストは送信されません。
料金は、国の行（または * の行）から取得されます: 重量列、なければ基本料金、それもなければ Price for countries not in the table。商品の重量は、ストアの重量単位からキログラムに変換されます。料金がない場合、配送方法は非表示になります。
Live rates が有効な場合、インドネシア国内の配送はまず Ninja Van で料金が計算されます。プラグインは、発送元と配送先の住所を Ninja Van のゾーンコードに変換します: 州、市または県（regency）、そして複数のゾーンがある市の場合は、住所欄に書かれた地区（Kecamatan）です。コード、重量、サービスレベルを送信し、料金を IDR からストアの通貨に換算します。Per item の場合は、異なる商品重量ごとに 1 回リクエストを送信します（カートあたり最大 5 回）。
Tariff API は 1 分あたり 20 リクエストまでのため、応答は 6 時間、失敗は 5 分、「このルートの料金なし」は 1 時間キャッシュされます。プラグインが 1 分あたりに送信するリクエストは 18 回を超えません。HTTP 429 の応答を受け取った後は、1 時間停止します。API のタイムアウトは 12 秒です。Ninja Van が応答しない場合、エラーを返した場合、そのルートの料金がない場合、または住所を照合できない場合は、料金表の料金が使われます。エラーはログに記録され、購入者に表示されることはありません。
この配送方法は、クラシックチェックアウトと、カートブロックおよびチェックアウトブロックの両方で動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。
プラグインが行うのは料金の計算だけです。Ninja Van の注文の作成、航空貨物伝票（AWB）の印刷、集荷の手配、荷物の追跡、代金引換（COD）の処理は行いません。これらの作業には Ninja Van Dashboard を使用してください。受け取り拠点（Ninja Points）の選択機能はありません。この配送方法は戸口までの配送です。リアルタイム料金はインドネシア国外では利用できません。
ライセンスキー
本プラグインは、vibefox.net で購入した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Ninja Van の上部にあります。キーを License key に貼り付けて、Activate をクリックします。ブロックには、ライセンスの有効期限や貴社のドメインなどのステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、Ninja Van はチェックアウト時に購入者には表示されません。ログインしているストア管理者には、(unlicensed — visible to admins only) という表示付きで引き続き表示されるため、キーを購入する前にプラグインを設定して試すことができます。プラグインページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは引き続き動作します。ただし、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Ninja Van が表示されない: ライセンスが有効であること、Enable/Disable が有効であること、購入者の国のゾーンに配送方法が追加されていること（または Ignore shipping zones が有効で、その国が許可されていること）を確認してください。重量の制限、Minimum order amount、Excluded shipping classes を確認し、その国、* の行、Price for countries not in the table のいずれかに料金が設定されていることを確認してください。
一部の住所でリアルタイム料金が使われない: 配送先は Ninja Van のゾーンに対応付けられる必要があります: インドネシア、州、市または県（regency）、そして複数のゾーンがある市の場合は、住所欄の地区（Kecamatan）。対応付けられない場合は、料金表の料金が使われます。理由を確認するには Debug log を有効にし、リアルタイム料金（API）— インドネシア の下のステータス行を確認してください。
リアルタイム料金がまったく要求されない: ステータス行に理由が表示されます: ストアの住所がインドネシアにない、または発送元のゾーンを検出できなかった（両方のゾーンコードを入力してください）、あるいは IDR conversion rate が入力されていない。
リクエストの上限に達した（HTTP 429）: リアルタイムのリクエストは 1 時間停止され、その間は料金表の料金が使われます。
料金の通貨: 料金表はストアの通貨です。リアルタイム料金はルピア（IDR）で表示され、ストアの通貨が IDR でない場合は IDR conversion rate で換算されます。
開発者向け: チェックアウトに独自の地区（Kecamatan）入力欄があるサイトでは、vfd_njvn_tariff_zone フィルターを使ってゾーンコードを指定できます。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、キーが別のドメインですでに使われている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスを変更した場合は、Check now をクリックして、新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効にしても、すべてのデータは保持されます。削除するには、プラグインを無効にしてから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。設定、ゾーンごとの配送方法、最後の Tariff API のステータス、キャッシュされたリアルタイム料金は、Remove data on uninstall が有効な場合にのみ削除されます。有効でない場合、後で再インストールするためにそれらは保持されます。既存の注文は、配送の明細を保持します。
Ninja Van は、その所有者の商標です。本プラグインは Ninja Van との提携や Ninja Van による推奨を受けていません。