VibeFox Correos CityPaq for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 7.0 以降。インストールされ、有効になっている必要があります。WooCommerce がないとプラグインを有効化できません。

PHP: 8.0 以降。

Correos API 認証情報（リアルタイムのロッカー一覧にのみ必要）: Correos CityPaq の一覧は、Correos の "terminals" API から有効なロッカーを読み込みます。Correos の開発者ポータルで "terminals" API を開き、アプリケーションについて Request access を使用してください。Correos は法人顧客からのリクエストを承認し、client ID と client secret を送信します。これらはポータルの My applications にも表示されます。購入者が自分でロッカーを入力する場合、または貴店のリストから選択する場合は、API 認証情報は不要です。

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

インストール

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

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

3. 設定を開きます。WooCommerce > Settings > Shipping > VibeFox Correos CityPaq を開くか、Plugins ページでプラグイン名の下にある Settings をクリックします。

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

5. 料金表を入力し、購入者がロッカーを選択する方法を決めます（「設定」を参照）。

6. WooCommerce > Settings > Shipping > Shipping zones で、スペイン向けの配送ゾーンに VibeFox Correos CityPaq を追加するか、Ignore shipping zones を有効にします。

設定

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

Title (zone): このゾーンのチェックアウトに表示されるこのオプションの名前。空欄にすると、全体の Name が使われます。

設定の上部に表示される警告では、料金表に使用できる行がない場合、選択したロッカーの方法が機能しない場合（一覧にロッカーがない、API 認証情報がない）、Correos API の直近のエラーを確認できます。料金と金額は小数点のカンマまたはピリオドを受け付けます。

一般

CityPaq ロッカーはスペインにのみ存在するため、この方法が他の国に提供されることはありません。

Enable/Disable: すべてのゾーンで、この方法を一括で有効または無効にします。

Name: チェックアウトで購入者に表示される配送方法の名前。既定値: Correos CityPaq。

Tax status: Taxable は料金表の料金に WooCommerce の税金を加算し、None は加算しません。

料金（セクションの見出しには貴店の通貨が表示されます）

Price table: Spain (ES) の行、および/またはデフォルトの * の行。各行には基本料金 Price と、包装サイズ XS（1 kg まで）、S（2 kg まで）、M（3 kg まで）、L（5 kg まで）、XL（5 kg 超）の任意料金を設定できます。サイズ料金が 0 または空欄の場合は基本料金が使われます。+ Add row をクリックして行を追加し、× をクリックして行を削除します。Correos との契約料金を貴店の通貨で入力してください。一致する行がない場合、この方法は表示されません。無効な料金と重複した行は、保存時に通知されます。

Calculation type: 包装サイズの判定方法。

Per order (size by the total cart weight): カート全体に対して 1 つの料金を、合計重量によって選択します。これが既定値です。

Per item (size by each item weight, multiplied by quantity): 商品ごとに、その商品のサイズの料金を数量倍して、合計します。

商品の重量は、貴店の重量単位（kg、g、lbs、oz）から kg に換算されます。

条件

Min weight (kg): カートがこれより軽い場合、この方法を非表示にします。0 は上限なしを意味します。

Max weight (kg): カートがこれより重い場合、この方法を非表示にします。既定値: 30。CityPaq は 30 kg までの荷物を受け付けるためです。0 は上限なしを意味します。

Minimum order amount: カートの小計（割引後、税抜き）がこの金額に達した場合のみ、この方法を表示します。空欄の場合は常に表示します。

Excluded shipping classes: カートに、これらの WooCommerce 配送クラスに属する商品が含まれている場合、この方法を非表示にします。例: ロッカーに入らない大型商品。本プラグインは荷物の寸法を確認しません。

送料無料

Free shipping: 下記の金額以上で CityPaq の配送を無料にします。

Free shipping from: この方法が 0 になるカート小計（割引後、税抜き）。Free shipping が有効な場合にのみ使用されます。

CityPaq ロッカーの選択

Locker selection: 注文前に購入者がロッカーを選択する方法。既定値: 購入者がロッカーを入力します。

Customer chooses from the Correos CityPaq list (Correos API, credentials below): 購入者は、配送先住所の郵便番号にある有効な CityPaq ロッカーを確認でき、別の 5 桁の郵便番号を検索することもできます。郵便番号にロッカーがない場合は、同じ地域のロッカー、次に同じ県のロッカーが表示され、近い郵便番号が優先されます。各ロッカーには、名称、住所、郵便番号、市町村、営業時間が表示されます。一覧を読み込めない場合、または何も見つからない場合は、購入者がロッカーを手動で入力します。

Customer enters the locker (code or address from the Correos finder): ロッカーコード（例: S0000213D）または住所の必須入力欄です。公式の Correos CityPaq ファインダーへのリンクが表示されます。

Customer chooses from my list of lockers (below): My lockers のロッカーを使った必須のドロップダウンです。購入者の郵便番号に近いロッカーが先頭に表示されます。

Do not ask for a locker: チェックアウトでロッカーの確認は行いません。

API 認証情報なしで Correos の一覧を選んだ場合、または My lockers が空の状態で貴店の一覧を選んだ場合、購入者にはロッカーを手動で入力するよう求められます。

My lockers: Locker selection が貴店の一覧に設定されている場合に使用されます。1 行に 1 つのロッカー: CODE | Name | Address | Postal code | City。コードと名前は必須です。無効な行と重複した行は、保存時に通知されます。

Correos CityPaq 一覧（API）（Correos CityPaq の一覧を使う場合のみ）

このセクションには、Correos 開発者ポータルの "terminals" API ページへのリンクがあります。読み込まれるのはロッカーの一覧のみです。料金は常に料金表から算出されます。

API client ID: Correos 開発者ポータルでのアプリケーションの client_id。

API client secret: Correos 開発者ポータルでのアプリケーションの client_secret。

認証情報またはロッカーの選択を変更すると、キャッシュされたロッカー一覧は消去されます。

配送ゾーンなしでの提供

Ignore shipping zones: どの配送ゾーンにもこの方法が含まれていなくても、スペインのすべての住所に CityPaq を提供します。オフ（推奨）の場合、配送ゾーンに追加した場所でのみ提供されます。

詳細設定

Debug log: デバッグ情報を WooCommerce > Status > Logs に書き込みます。ソースは vfd-correos-citypaq です。このオプションがオフでも、Correos API のエラーは常に記録されます。認証情報と個人データは記録されません。

Remove data on uninstall: オンの場合、プラグインを削除すると、その設定と配送ゾーンの方法が削除されます。プラグインを無効化しても、何も削除されません。注文に保存されたロッカーは保持されます。

チェックアウトでの動作

購入者がスペイン国内の配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはカートの重量、最低注文金額、除外する配送クラスを確認し、スペイン（または * の行）の料金行と包装サイズを見つけて、料金を表示します。送料無料が適用される場合、料金は 0 になります。

購入者が CityPaq を選択すると、その方法の下にロッカーの入力欄が表示されます。有効なロッカーがないと注文は完了できません。この確認はサーバー側でも行われます。カートブロックとチェックアウトブロックを使った注文も対象です。Correos の一覧を使う場合、ロッカーコードは、その購入者に Correos が提示したものだけが受け付けられ、名前と住所は Correos から取得されます。購入者のセッションごとの郵便番号検索回数には上限があります。上限に達すると、購入者はロッカーを手動で入力します。

Correos の一覧は、郵便番号ごとに 12 時間キャッシュされます。失敗したリクエストは 10 分間キャッシュされるため、チェックアウトは更新のたびに Correos の応答を待つことがありません。API のタイムアウトは 12 秒です。購入者に技術的なエラーが表示されることはなく、短いメッセージと手動入力欄が表示されるだけです。

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

本プラグインは、Correos からリアルタイムの料金を取得せず、地図も表示せず、荷物の事前登録、ラベルの印刷、集荷依頼、追跡も行いません。注文に保存されたロッカーを使い、Correos アカウントで発送を作成してください。

受け取りポイント

選択されたロッカーは注文に保存されます。注文管理画面では配送先住所の下に、注文受付ページ、My account > Orders、およびすべての注文メール（HTML とプレーンテキスト）で、CityPaq locker として表示されます。

注文管理画面では、Change CityPaq locker の入力欄でロッカーを変更できます。貴店の一覧から別のロッカーを選ぶか、新しいコードまたは住所を入力してください。Correos の一覧を使う場合、入力されたロッカーコードは Correos で照会されます。現在のロッカーを維持するには、入力欄を空のままにします。変更するたびに、注文にメモが追加されます。

ライセンスキー

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

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

有効なキーがない場合、Correos CityPaq はチェックアウトで購入者に表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示されたうえで引き続き表示されるため、キーを購入する前にプラグインの設定とテストができます。プラグインページと WooCommerce のページにはお知らせが表示されます。既存の注文には影響しません。

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

トラブルシューティング

Correos CityPaq がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、住所がスペイン国内であること、該当する配送ゾーンにこの方法が追加されていること（または Ignore shipping zones がオンであること）を確認してください。料金表にスペインの行または * の行があること、カートが重量制限、Minimum order amount、Excluded shipping classes の範囲内であることも確認してください。

Correos の一覧を選択しているのに、購入者がロッカーを入力しなければならない: API client ID と API client secret が入力されているか確認し、設定の上部にある警告を確認してください。警告には Correos API の直近のエラーが表示されます。HTTP 401/403 は、Correos が認証情報を拒否したことを意味します。認証情報を確認し、アプリケーションが "terminals" API にアクセスできることを確かめてください。エラーの後、次の試行は 10 分後に行われます。

郵便番号にロッカーがない: Correos は、その郵便番号、地域、県に有効なロッカーを見つけられませんでした。購入者は別の郵便番号を検索するか、Correos CityPaq ファインダーで見つけたロッカーを入力できます。

My lockers のドロップダウンが表示されない: My lockers が空であるか、その行が無効です。各行には少なくとも CODE | Name が必要です。

購入者がロッカーコードを見つける場所: ロッカー欄の下にリンクされている Correos CityPaq ファインダーです。

開発者向けの注意: ロッカーは注文メタ _vfd_cpq_locker（どこにでも表示されるテキスト）と、_vfd_cpq_locker_id（Correos の一覧または貴店の一覧から選択された場合のロッカーコード）に保存されます。本プラグインは Correos の本番 "terminals" API を使用します。この API にはサンドボックスが文書化されていません。

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

アンインストール

プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページでプラグインを無効化してから削除してください。このプラグインのライセンスキーとライセンス状態は、常に削除されます。キャッシュされた Correos のロッカー一覧と、直近の API エラーも同様です。設定と配送ゾーンの方法は、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールできるように残ります。注文に保存されたロッカーは削除されることがなく、既存の注文は配送の行を保持します。

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