VibeFox CTT for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

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

PHP: 8.0 以降。

CTT e-commerce アカウント（リアルタイム料金と CTT の受取ポイントのみ必要）: リアルタイム料金と CTT の受取ポイントへの配送は、CTT の e-commerce API を使用します。enviosecommerce.ctt.pt で CTT の e-commerce アカウントが必要です（CTT Expresso の契約者の場合。または CTT に見積もりを依頼してください）。そのアカウントのキー管理ページで、公開キーと秘密キーのペアを作成します。App ID（X-APPID）は、貴社の連携用に CTT が発行します。CTT の e-commerce 担当者に問い合わせてください。CTT はまた、App ID でどの API 機能（料金見積もり、CTT の受取ポイント）を使えるかを決めます。最後に、アカウント内の CTT の Carrier ID が必要です。キーを保存すると、設定ページにアカウント内の運送業者が表示されます。価格表と宅配だけを使う場合は、API キーは不要です。

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

インストール

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

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

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

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

5. 価格表に入力します（少なくとも Portugal または * Default の行）。必要に応じて CTT の API キーと Carrier ID を入力し、Live rates をオンにします（設定の項を参照）。

6. WooCommerce > Settings > Shipping > Shipping zones で、ポルトガルのゾーンを開くか作成し、VibeFox CTT を追加します。メソッドの設定でタイトルと配送タイプを選びます。または、Ignore shipping zones をオンにして国を選択します。

設定

価格、API キー、条件は 1 つのページにまとめられています: WooCommerce > Settings > Shipping > VibeFox CTT。これらはすべての配送ゾーンに適用されます。ゾーンにメソッドを追加すると、ゾーンのウィンドウに 2 つのフィールドが表示されます:

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

Delivery: To the customer's address（デフォルト）または To a CTT point or parcel locker chosen at checkout。CTT の受取ポイントには、全体設定で CTT の API キーと Carrier ID が必要です。1 つのゾーンにメソッドを 2 回追加すると、宅配と CTT の受取ポイント配送を並べて提供できます。

設定の上部に表示される警告は、ポルトガルの料金が未設定の場合、API キーが不完全な場合、Carrier ID が未入力の場合、ストアの通貨に為替レートがない場合、CTT API への接続に失敗した場合を知らせます。設定を保存するたびに、キャッシュされた CTT の応答は消去されます。

全般

Enable/Disable: すべてのゾーンでこのメソッドを一括で有効化または無効化します。

Name: チェックアウトに表示される配送方法の名前（例: "CTT Expresso"）。デフォルトは CTT です。ゾーンの Title があれば、そちらが優先されます。

Tax status: Taxable は WooCommerce の配送税（例: IVA）を料金に上乗せします。None は料金が確定額であることを意味します。

CTT e-commerce API（リアルタイム料金、CTT の受取ポイント）（任意。キーがない場合は価格表が使われます）

Public key: CTT e-commerce アカウントのキー管理ページにある公開キー。

Private key: すべてのリクエストの署名に使われる秘密キー（HMAC-SHA256）。CTT に送信されることはなく、ログに書き込まれることもありません。

App ID (X-APPID): CTT が貴社の連携用に発行したアプリケーションキー。

Carrier ID: アカウント内の CTT 運送業者の ID。リアルタイム料金と CTT の受取ポイント検索に使われます。キーを保存すると、アカウントの運送業者がこの欄の下に一覧表示され、CTT の受取ポイントに対応しているものには印が付きます。

Live rates: 購入者が番地、郵便番号、都市を入力すると、CTT に料金（見積もり）を問い合わせます。住所が不完全な間、および CTT が料金を返さない場合は、価格表が使われます。CTT はこの料金を見積もりと呼びます。デフォルトはオフです。

Service ID: 任意。CTT が複数のサービスを返した場合、この ServiceId のサービスが使われます。空欄にすると、最も安いサービスが使われます。

Exchange rate: CTT の料金はユーロで表示されます。ストアの通貨が異なる場合は、CTT の通貨 1 単位がストアの通貨で何単位に相当するかを入力します。入力しない場合、別の通貨でのリアルタイム料金は使われず、価格表が適用されます。

Default product size (cm): 寸法のない商品について CTT に送信される、縦 x 横 x 高さ。デフォルトは 30x20x15 です。寸法のある商品は、その商品自身の寸法を使います。寸法は cm に、重量はストアの単位から g に換算されます。

料金（セクションのタイトルにストアの通貨が表示されます）

CTT 契約または CTT の公開料金表の料金を、ストアの通貨で入力します。リアルタイム料金がオフの場合、この表が料金を決定します。オンの場合は、予備の料金として使われます。

Price table: 仕向地ごとに 1 行。国、Portugal - Azores (PT-AC)、Portugal - Madeira (PT-MA)、または * Default (other destinations) を選びます。各行には基本の料金（Price）と、任意のサイズ別料金があります。サイズは XS（1 kg まで）、S（2 kg まで）、M（3 kg まで）、L（5 kg まで）、XL（5 kg 超）です。サイズ料金が空欄（または 0）の場合は基本料金が使われます。両方が空欄の行では、メソッドは表示されません。Azores の行は、ポルトガルの郵便番号 9500-9999 に適用されます。Madeira の行（Porto Santo を含む）は、9000-9499 に適用されます。これらがない場合は Portugal の行が適用されます。+ Add destination をクリックすると行を追加でき、× をクリックすると削除できます。料金は小数点またはカンマで入力できます。無効な行は保存時に通知されます。

Calculation: 表の料金がどのように決まるか。

CTT のリアルタイム料金は、常に出荷全体に対するものです。

条件

Min weight (kg): メソッドが表示されるために必要なカートの最小重量。0 は制限なしを意味します。

Max weight (kg): カートの重量がこの値を超えると、メソッドは非表示になります。デフォルトは 30 です（CTT の荷物は最大 30 kg）。0 は制限なしを意味します。

Minimum order amount: カートの小計（割引後、税抜き）がこの金額に達した場合のみ、メソッドを表示します。空欄にすると常に表示されます。

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

送料無料

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

Free shipping from: このメソッドが 0 円になる、カートの小計（割引後、税抜き）。メソッドに料金が設定されている場合にのみ適用されます。Free shipping がオンの場合にのみ使われます。

配送ゾーンを使わない場合の提供条件

Ignore shipping zones: 購入者のゾーンにメソッドが含まれない場合でも、下記の国でメソッドを提供します。

Countries: このモードの仕向国。デフォルトは Portugal です。空欄にすると、貴店が発送するすべての国を使います。このフィールドは Ignore shipping zones がオンの場合にのみ使われます。

詳細設定

Debug log: 料金計算と CTT API の呼び出しを、WooCommerce > Status > Logs のソース vfd-ctt に記録します。CTT API のエラーは、この設定がオフでも常に記録されます。キー、トークン、購入者の住所は記録されません。

Remove data on uninstall: オンの場合、プラグインを削除すると、その設定とゾーンのメソッドが削除されます。プラグインを無効化してもデータは削除されません。注文は変更されません。

チェックアウト時の動作

購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまず、カートの重量、最低注文金額、除外された配送クラスを確認します。Live rates がオンで住所が完全な場合、プラグインは配送先住所と、カートの各行について数量、グラム単位の重量、cm 単位の寸法を CTT に送信し、返された料金を表示します。それ以外の場合、または CTT が料金を返さない場合（API エラー、タイムアウト、対応地域外、貴社の App ID で機能が有効化されていない場合）は、料金は価格表から取得されます。送料無料が適用される場合、料金は 0 です。

CTT の料金は 1 時間キャッシュされるため、同じカートで新たなリクエストが発生することはありません。失敗したリクエストは 5 分間記憶されるため、チェックアウトは更新のたびに CTT を待つことはありません。API のタイムアウトは 12 秒です。

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

API キーを入力すると、プラグインは配送先住所、商品の重量と寸法、およびストアの URL を CTT に送信し、料金または最寄りの CTT の受取ポイントを取得します。

プラグインは、発送の作成、ラベルの印刷、集荷の依頼、追跡番号の提供、CTT の受取ポイントの地図表示は行いません。ストア全体で 1 つの価格表と 1 セットの API 設定があります。ゾーンごとに異なるのは、タイトルと配送タイプだけです。

受取ポイント

ゾーンのメソッドで Delivery が CTT の受取ポイントに設定されている場合、チェックアウトでメソッドの下に検索フィールドとリストが表示されます。配送先住所は自動的に検索されます。購入者は郵便番号または都市名で他の CTT の受取ポイントを検索でき、注文する前にいずれか 1 つを選ぶ必要があります。これはサーバー側でも確認されます。CTT の受取ポイントのリストは 6 時間キャッシュされます。CTT に接続できない場合、購入者にはメッセージが表示され、後で再試行するか、別の配送方法を選べます。

選んだポイントは注文に保存されます。注文管理画面では配送先住所の下に、注文受付ページ、My account > Orders、注文メール（HTML とプレーンテキストの両方）では CTT point として表示されます。

注文管理画面で、CTT の受取ポイントの横にある Change をクリックし、郵便番号または都市名で検索して別のポイントを選びます。変更はすぐに保存され、注文メモが追加されます。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに CTT が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、購入者の国のゾーンにメソッドが追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。仕向地に価格表の行（または * Default の行）があること、カートの重量が Min weight と Max weight の範囲内であること、Minimum order amount に達していること、どの商品も除外された配送クラスに属していないことを確認してください。

購入者が CTT の受取ポイントを選べない: セレクターは、ゾーンのメソッドで Delivery が CTT の受取ポイントに設定されている場合にのみ表示されます。また、公開キー、秘密キー、App ID、Carrier ID がすべて入力されている必要があります。Debug log をオンにして、WooCommerce > Status > Logs を確認してください。

リアルタイム料金が表示されない: 購入者が番地、郵便番号、都市を入力するまで、価格表が使われます。設定の上部の警告とログを確認してください。「405」という応答は、その機能が貴社の App ID に対して有効化されていないことを意味します。CTT に問い合わせてください。ユーロ以外の通貨のストアでは、Exchange rate を入力してください。

CTT API への接続に失敗した: 設定の上部の警告にエラーが表示されます。キーと App ID を確認してください。プラグインは数分後に自動的に再試行します。

税込みか税抜きか: Tax status が Taxable の場合、WooCommerce は配送税を料金に上乗せします。None の場合、料金は確定額です。

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

アンインストール

プラグインを無効化しても、すべてのデータは保持されます。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは常に削除され、キャッシュされた CTT の応答と API トークンも同様です。設定とゾーンのメソッドは、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。注文（選択された CTT の受取ポイントを含む）は一切変更されず、既存の注文は配送の明細を保持します。

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