VibeFox Chilexpress for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 7.0 以降、インストールおよび有効化済みであること。WooCommerce がないとプラグインは有効化できません。

PHP: 8.0 以降。

Chilexpress API キー（実際の料金のみ）: Chilexpress 開発者ポータル（developers.wschilexpress.com）でアカウントを作成し、2 つの製品を購読してください：Rating (Cotizador) と Coverage (Coberturas / Georreferencia)。製品ごとに個別のサブスクリプションキーがあります。テストキーはテスト環境でのみ動作します。本番キーは、Chilexpress と顧客契約を結んだ法人顧客に発行されます。また、発送元の comuna の Chilexpress county コード（例：STGO）も必要です。固定料金だけを使う場合、API キーは不要です。

VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。

インストール

1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_chilexpress フォルダを /wp-content/plugins/ にアップロードすることもできます。

2. Activate をクリックします。

3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox Chilexpress。または、プラグインページでプラグイン名の下にある Settings をクリックします。

4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。

5. 料金表に入力します。実際の料金を使う場合は、両方のサブスクリプションキーと発送元の origin county コードを入力し、ストアの通貨が CLP でなければ CLP 為替レートも入力して、料金ソースを選択します（設定を参照）。

6. WooCommerce > Settings > Shipping > Shipping zones で、チリ向けの配送ゾーンに VibeFox Chilexpress を追加します。または Ignore shipping zones を有効にして国を選択します。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox Chilexpress。設定はすべての配送ゾーンに適用されます。ゾーンにこの方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます：

Title (zone): このゾーンでチェックアウト時に表示される、この配送オプションの名前。空欄の場合は共通の Name が使われます。

設定ページの上部に問題が表示されます：API 料金が選択されているのにキー、origin county コード、CLP 為替レートのいずれかが不足している場合、または料金表にチリまたは既定（* Default）の行がない場合です。設定を保存するたびに、キャッシュされた料金と comuna の一覧は消去されます。数値は小数点またはカンマで入力できます。無効な数値は保存されず、エラーが表示されます。

一般

Enable/Disable: すべてのゾーンで Chilexpress 配送を一度にオンまたはオフにします。

Name: チェックアウトで購入者に表示される配送方法の名前。Default: Chilexpress。

Tax status: Taxable は（税金が有効な場合）配送料に WooCommerce の税金を加算します。None は加算しません。Chilexpress API の料金は見積もりのとおりに使われます。見積もりにすでに IVA が含まれていて、ストアがその上にさらに税を加算してしまう場合は None を選択してください。

料金

Rate source: 料金の出どころ。

実際の料金はチリ国内の宛先でのみ利用できます。その他の国では常に固定料金が使われます。

Country prices: 宛先国の表です。Price 列と、ストアの通貨で指定する任意のサイズ別料金を含みます。サイズはカートの重量で決まります：XS は 1 kg 以下、S は 2 kg 以下、M は 3 kg 以下、L は 5 kg 以下、XL は 5 kg 超。サイズを 0 のままにすると Price が使われます。+ Add country をクリックすると行が追加され、×をクリックすると削除されます。* Default の行は、独自の行がない国に適用されます。行がない国（* もない場合）には固定料金がありません。料金とサイズ別料金の両方が 0 の行は送料無料になります。

Calculation type: Per order は固定料金を 1 回だけ請求します。Per item (fixed price x number of items) は、固定料金にカート内の商品数を掛けます。Chilexpress API の料金は、常に荷物全体に対して見積もられます。

Chilexpress API（実際の料金）

Test environment: Chilexpress のテスト環境（qaservices.wschilexpress.com）を使用します。テストキーと併用し、本番のストアでは無効にしてください。

Rating API key: Rating (Cotizador) 製品のサブスクリプションキー。

Coverage API key: Coverage (Coberturas / Georreferencia) 製品のサブスクリプションキー。購入者の comuna の Chilexpress county コードを調べるために使われます（チェックアウトの市区町村欄）。

Origin county code: 発送元の Chilexpress county（comuna）コード。2〜5 文字で、例：STGO（Santiago Centro）、PROV（Providencia）、LCON（Las Condes）、VALP（Valparaíso）、CONC（Concepción）。county コードでない値はエラーとして拒否されます。

Service: 料金の計算に使う Chilexpress のサービス。宛先で提供されていない場合は、提供されている中で最安のサービスが使われます。

CLP exchange rate: Chilexpress はチリ・ペソで見積もります。ストアの通貨が CLP でない場合にのみ必要です：ストアの通貨で表した 1 CLP の価格（例：0.001）。設定しないと API の料金は使われません。

利用可能条件

Min weight (kg): 方法が表示されるためのカートの最小重量。0 は制限なしを意味します。

Max weight (kg): このカート重量を超えると、方法は非表示になります。Default: 25。0 は制限なしを意味します。

Minimum subtotal: カートの小計（割引後、税抜き）がこの金額以上の場合にのみ方法を表示します。空欄にすると常に表示されます。

Excluded shipping classes: カート内のいずれかの商品が、これらの WooCommerce 配送クラスに属している場合、方法を非表示にします。

Ignore shipping zones: 方法を配送ゾーンに追加していなくても、下記の国向けに方法を提供します。

Countries: このモードでの宛先国。空欄の場合はストアのすべての配送国が使われます。この欄は Ignore shipping zones が有効な場合にのみ使われます。

送料無料

Free shipping: 送料無料の基準額を有効にします。

Free shipping from: この額以上のカート小計で送料が無料になります。Free shipping が有効な場合にのみ使われます。その場合は API へのリクエストは行われません。

詳細設定

Debug log: API リクエストと料金計算を WooCommerce > Status > Logs に記録します。ソースは vfd-chilexpress です。このオプションがオフでも API エラーは常に記録されます。API キーは記録されません。

Remove data on uninstall: オンの場合、プラグインを削除するとその設定とゾーンの方法が削除されます。無効化では設定は削除されません。既存の注文の配送行は常に残ります。

チェックアウトでの動作

購入者が配送先住所を入力すると、WooCommerce がプラグインに料金を問い合わせます。プラグインはまず条件を確認します：カートの重量、最低小計、除外する配送クラス。送料無料が適用される場合、購入者は無料の料金を受け取り、Chilexpress へのリクエストは送信されません。

チリの住所で料金ソースが API の場合、プラグインは市区町村欄から地域と comuna を取得し、その地域の comuna 一覧（Coverage API）で Chilexpress の county コードを検索します。アクセント、スペース、綴りのバリエーションは無視されるため、Ñuñoa と Nunoa は一致し、Santiago は Santiago Centro と一致します。市区町村欄に直接入力された county コードも受け付けられます。次にプラグインは Rating API へ、発送元と宛先の county コード、カートの重量（最小 0.1 kg）、荷物のサイズ（最も大きい商品の縦と横、高さは積み重ねた合計）、そして申告価格として CLP 建てのカート小計を送信します。Chilexpress はそのサービスを返します。プラグインは選択されたサービス、または最安のサービスを使い、ペソの金額をストアの通貨に換算します。サービス名は注文の配送行に Chilexpress service として保存されます。

料金は 1 時間、comuna の一覧は 7 日間キャッシュされます。失敗したリクエストは 5 分間記憶されるため、遅いまたは利用できない API がチェックアウトの更新のたびに遅延を生むことはありません。API のタイムアウトは 10 秒です。Chilexpress がエラーを返した場合、料金付きのサービスがない場合、または comuna が不明な場合でも、購入者にエラーは表示されません。API のみモードではこの方法は非表示になり、それ以外では固定料金が使われます。理由は WooCommerce のログに書き込まれます。

この方法はクラシックチェックアウトと、カートとチェックアウトのブロックの両方で動作します。WooCommerce の High-Performance Order Storage（HPOS）に対応しています。

プラグインは料金の計算のみを行います。発送伝票や運送依頼（OT）の作成、ラベルの印刷、集荷の予約、荷物の追跡は行いません。発送は Chilexpress のアカウントで手配してください。購入者は Chilexpress の営業所を選べず、comuna のセレクターもありません。購入者は標準の市区町村欄に comuna を入力します。国際配送には固定料金が使われます。

ライセンスキー

プラグインは vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Chilexpress のページ上部にあります。キーを License key に貼り付けて Activate をクリックしてください。ブロックには状態が表示されます。たとえば、ライセンスの有効期限と、お使いのドメインです。Check now で状態を再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除できます。リンク Manage licenses and domains in your account を開くと、vibefox.net のアカウントが開きます。

1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがないと、Chilexpress はチェックアウトで購入者に表示されません。ログインしているストア管理者には、(unlicensed — visible to admins only) と表示された状態で表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページにはリマインダーが表示されます。既存の注文には影響しません。

ライセンスの期限が切れても、プラグインは動作を続けます。ただし、アップデートとサポートには更新が必要です。状態はバックグラウンドで自動的に再確認されます。

トラブルシューティング

Chilexpress がチェックアウトに表示されない: ライセンスが有効か、Enable/Disable がオンか、購入者の国のゾーンに方法が追加されているか（または Ignore shipping zones がオンで、その国が許可されているか）を確認してください。重量の制限、Minimum subtotal、Excluded shipping classes を確認してください。固定料金の場合は、その国または * Default に行があるか確認してください。

実際の料金が表示されず、代わりに固定料金が使われている: まず設定ページ上部の警告を確認してください。警告がなければ Debug log をオンにし、チェックアウトを再読み込みして、WooCommerce > Status > Logs を開いてください（ソースは vfd-chilexpress）。よくある原因：Chilexpress が認識しない comuna（市区町村欄と地域を確認）、別の製品または環境用のキー、Chilexpress のサービスエリア外の宛先。

ログに HTTP 401 または 403 が表示される: サブスクリプションキーが誤っているか、無効であるか、別の製品または環境のものです。テストキーは Test environment をオンにしたときのみ動作します。

別の通貨のストアで API の料金が使われない: CLP exchange rate を入力してください。

API の料金は IVA を含みますか、含みませんか？ Chilexpress の見積もりどおりに使われます。ストアが配送料に税を加算し、見積もりにすでに IVA が含まれている場合は、Tax status を None に設定してください。

変更後に料金が古く見える: 設定ページを保存してください。キャッシュされた料金と comuna の一覧が消去されます。

ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、キーが別のドメインで使われている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認された状態で動作を続けます。

アンインストール

プラグインを無効化しても、すべての設定は保持されます。キャッシュされた料金と comuna の一覧が消去されるだけです。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンス状態、およびキャッシュは常に削除されます。設定とゾーンの方法は、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。既存の注文の配送行は常に残ります。

Chilexpress は、それぞれの所有者の商標です。本プラグインは Chilexpress と提携しておらず、Chilexpress による推奨も受けていません。