VibeFox Blue Express for WooCommerce — ヘルプ
要件
WordPress：5.8 以降。
WooCommerce：7.0 以降。インストールされ、有効になっている必要があります。WooCommerce がないとプラグインは有効化できません。
PHP：8.0 以降。
Blue Express アカウント（リアルタイム料金のみ必要）：リアルタイム料金には、Blue Express の電子商取引アカウントとその API キー（x-api-key）が必要です。Blue Express に申請してください：developers.bluex.cl または gpo.integraciones@bx.cl。使用するサービス（EX、PY、MD）が、お客様の Blue Express 契約で有効になっている必要があります。固定料金のみを使う場合、API キーは不要です。
受取ポイント：Blue Express のマップは、お客様のブラウザーから widget-pudo.blue.cl を使って読み込まれます。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックしてください。FTP で vfd_blue_express フォルダーを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックしてください。
3. 設定を開いてください：WooCommerce > Settings > Shipping > VibeFox Blue Express、または プラグインページでプラグイン名の下の Settings をクリックしてください。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックしてください。
5. API キー、サービス、発送元の地区コード（例：SCL）、ストアの通貨が CLP でない場合は CLP の為替レート、そして固定料金（例：CL=4500）を入力してください。「設定」を参照してください。
6. WooCommerce > Settings > Shipping > Shipping zones に進み、チリの配送ゾーンに VibeFox Blue Express を追加してください。方法の設定でタイトルと配送タイプ（宅配、または Blue Express のポイントでの受け取り）を選んでください。両方のオプションを提供するには、2 回追加してください。
設定
主な設定は WooCommerce > Settings > Shipping > VibeFox Blue Express にあります。これらはすべての配送ゾーンに適用されます。方法またはリアルタイム料金を非表示にしてしまう設定（API キーなし、CLP の為替レートなし、固定料金表が空など）についての警告は、ページ上部に表示されます。設定を保存するとキャッシュがクリアされます。
ゾーンの設定（配送ゾーンにこの方法を追加するとき）
Title: このゾーンでお客様に表示される配送方法の名前。空欄にすると、全体の Name が使われます。
Delivery type: As in the global settings（既定）、Home delivery、または Pickup at a Blue Express point (PUDO)。宅配と受け取りの両方を提供するには、1 つのゾーンにこの方法を 2 回追加してください。
全般
Enable/Disable: すべての配送ゾーンでこの方法を有効または無効にします。
Name: チェックアウトに表示される配送方法の名前。ゾーンごとに独自のタイトルを設定できます。既定値：Blue Express。
Tax status: Blue Express の料金には IVA が含まれています。WooCommerce で追加の税金を加えないようにする場合は None、加える場合は Taxable を選んでください。
Blue Express API（リアルタイム料金に必要）
API key: Blue Express の API キー（x-api-key ヘッダー）。未設定の場合は、固定料金のみが使われます。
Service: 料金の計算に使う Blue Express のサービス：Express (EX)（既定）、Prioritario (PY)、または SameDay (MD)。お客様の Blue Express 契約で有効になっている必要があります。
Origin district code: 発送元の Blue Express 地区コード。たとえば、サンティアゴの場合は SCL（既定）。不明な場合は Blue Express にお問い合わせください。
CLP per 1 (your currency): Blue Express の料金はチリ・ペソ（CLP）建てです。ストアが別の通貨を使う場合は、その通貨 1 単位が何 CLP に相当するかを入力してください（例：1050）。未入力の場合、リアルタイム料金は使用されません。ストアの通貨が CLP の場合は無視されます。
料金
Rate source: 料金の計算方法。
Fixed prices: 国ごとに 1 行、COUNTRY_CODE=PRICE の形式で、ストアの通貨で入力します。例：CLP のストアなら CL=4500、EUR のストアなら CL=4.50。小数点としてカンマまたはピリオドを使えます。無効な行は保存時に通知されます。固定料金はどの国にも使えます。
Fixed price per: Order は 1 回だけ料金を請求します。Item (price x quantity) はカート内の商品数を掛けます。これは固定料金にのみ適用されます。API の料金は常に出荷全体に対するものです。
条件
Min weight (kg): カートの重量がこれより軽い場合、この方法を非表示にします。0 は制限なしを意味します。
Max weight (kg): カートの重量がこれより重い場合、この方法を非表示にします。既定値：100。0 は制限なしを意味します。
Minimum order subtotal: カートの小計（ストアの通貨）がこの額以上の場合にのみ、この方法を表示します。空欄にすると常に表示されます。
Excluded shipping classes: カート内のいずれかの商品が選択された WooCommerce の配送クラスに属している場合、この方法を非表示にします。
送料無料
Free shipping: カートの小計がある金額を超えた場合に送料を無料にする機能を有効にします。
Free from subtotal: 送料が無料になるカートの小計（ストアの通貨）。
Blue Express ポイントでの受け取り（PUDO）
Pickup point by default: 有効にすると、Blue Express の方法はお客様が選んだ Blue Express のポイントに配送します。これは Delivery type = As in the global settings のゾーン方法の既定値です。お客様は注文するためにポイントを選ぶ必要があります。
配送ゾーンなしでの利用
Ignore shipping zones: 該当する配送ゾーンにこの方法が追加されていなくても、この方法を提供します。その場合は全体の設定を使用します（ゾーンのタイトルや配送タイプはありません）。
Countries: このモードでの配送先の国。空欄にすると、発送先として設定しているすべての国が対象になります。Ignore shipping zones を使用している場合にのみ有効です。
詳細設定
Debug log: リクエストと判断を WooCommerce > Status > Logs に記録します（ソースは "vfd-blue-express"）。API のエラーは常に記録されます。API キーとお客様の住所は記録されません。
Remove data on uninstall: 有効にすると、プラグインを削除したときに設定と配送ゾーンの方法が削除されます。無効化では設定は削除されません。注文に保存された受取ポイントは保持されます。
チェックアウト時の動作
お客様が配送先住所を入力すると、プラグインはカートの重量、Minimum order subtotal、Excluded shipping classes を確認します。送料無料が適用される場合、料金は 0 となり、Blue Express へのリクエストは送信されません。
リアルタイム料金を取得するには、住所がチリ国内で、地域と都市（コミューン）が含まれている必要があります。プラグインはまず Blue Express にコミューンの認識を依頼し、その後、サービス、発送元の地区、配送先、荷物について料金を問い合わせます。各商品は、重量と寸法を kg と cm に変換して送信されます。重量または寸法のない商品は、0.01 kg、10 x 10 x 10 cm として送信されます。申告価格は CLP で送信されます。CLP の料金はストアの通貨に換算されます。
料金は 1 時間、コミューンのデータは 12 時間キャッシュされます。API 呼び出しが失敗した場合は 5 分間記憶され、タイムアウトは 10 秒です。そのため、API が遅い場合や利用できない場合でも、チェックアウトの更新のたびに遅くなることはありません。API のエラーがお客様に表示されることはありません。方法が非表示になるか、フォールバックモードでは固定料金が使われます。原因はログに記録されます。
この方法は、クラシックチェックアウト、カートおよびチェックアウトのブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。
プラグインは Blue Express で出荷や送り状を作成せず、追跡番号も割り当てず、追跡情報も表示しません。出荷は Blue Express のアカウントで作成してください。コミューンごとの地域別料金表はありません。Blue Express API の料金か、国ごとの固定料金のいずれかを使用してください。リアルタイム料金はチリでのみ利用できます。
受取ポイント
配送タイプが Pickup at a Blue Express point (PUDO) の場合、クラシックチェックアウトとチェックアウトブロックのどちらでも、お客様は Blue Express オプションの下に Choose pickup point が表示されるのを確認できます。ボタンを押すと公式の Blue Express マップが開き、お客様はそこでポイントを選択できます。選択したポイントは名前と住所とともに表示され、ボタンは Change pickup point に変わります。その後、料金は Blue Express の受け取り（PUDO）料金で再計算されます。
ポイントを選ばないと注文できません。お客様には Please choose a Blue Express pickup point. と表示されます。これはサーバー側で確認されます。
選択したポイントは、Blue Express のエージェンシーコード、名前、住所とともに注文に保存されます。管理画面の注文画面では、配送先住所の下に Blue Express pickup point として表示されます。別のポイントを選ぶ、またはエージェンシーコード、名前、住所を手入力する場合は Edit をクリックし、その後 Save pickup point をクリックしてください。変更は注文メモに記録されます。お客様は注文ページと注文メール（HTML とプレーンテキスト）でポイントを確認できます。ストア宛てのメールにもエージェンシーコードが表示されます。既存の注文は、受取ポイントのデータをそのまま保持します。
ライセンスキー
このプラグインは vibefox.net で入手した VibeFox ライセンスキーを使用します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Blue Express の上部にあります。キーを License key に貼り付けて、Activate をクリックしてください。ブロックには、ライセンスが有効な期限やお使いのドメインなどのステータスが表示されます。Check now でステータスを再確認、Change key で別のキーを入力、Remove key でこのサイトからキーを削除できます。Manage licenses and domains in your account のリンクから vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトでお客様に Blue Express は表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページにリマインダーが表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Blue Express が表示されない：ライセンスが有効か、Enable/Disable がオンか、お客様の住所のゾーンにこの方法が追加されているか（または Ignore shipping zones がオンで、その国が許可されているか）を確認してください。設定ページ上部の警告を読んでください。重量制限、Minimum order subtotal、Excluded shipping classes を確認し、固定料金または代替方式を使う場合は、Fixed prices にその国の行があるかも確認してください。
リアルタイム料金が表示されない：Blue Express API only を使用している場合、料金がないとこの方法は非表示になります。Debug log をオンにし、チェックアウトを再読み込みして、WooCommerce > Status > Logs（ソース "vfd-blue-express"）を開いてください。よくある原因は、API キーがない、ストアの通貨が CLP でなく為替レートがない、住所に地域やコミューンがない、Blue Express がコミューンを認識しない、API エラー（API キーが拒否された場合の HTTP 401 や 403 など）です。Blue Express API, fixed price if the API gives no rate の場合、問題を修正している間も、お客様には固定料金が提供されます。
Blue Express の料金に税金が加算される：Blue Express の料金には IVA が含まれています。WooCommerce で追加の税金を加えない場合は、Tax status を None に設定してください。
マップが開かない：マップはお客様のブラウザーから widget-pudo.blue.cl を使って読み込まれます。そのため、このアドレスに接続できる必要があり、サイトでブロックされていないことが必要です。
変更後に料金が古く見える：設定ページを保存してください。キャッシュされた料金とコミューンのデータがクリアされます。
ライセンスブロックにエラーが表示される：ブロックのメッセージに従ってください。たとえば、キーが別のドメインですでに使用されている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できた状態で動作を続けます。
アンインストール
プラグインを無効化すると、すべての設定は保持され、キャッシュのみがクリアされます。削除するには、プラグインを無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスの状態、およびキャッシュは常に削除されます。設定と配送ゾーンの方法は、Remove data on uninstall がオンの場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。注文に保存された受取ポイントは削除されません。
Blue Express は、それぞれの所有者の商標です。このプラグインは Blue Express と提携しておらず、Blue Express による推奨も受けていません。