VibeFox Purolator for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 5.0 以降。インストールされ、有効になっている必要があります。WooCommerce がないとプラグインは有効化できません。
PHP: 8.0 以降。PHP の SOAP 拡張機能は不要です。
Purolator E-Ship Web Services（リアルタイム料金の場合のみ）: Purolator のウェブサイトにある Purolator E-Ship Resource Centre で E-Ship Web Services に登録してください。Purolator は、開発環境と本番環境それぞれに別のキーとパスワードを発行します。また、Purolator の請求アカウント番号と、発送元となるカナダの郵便番号も必要です。固定料金のみを使用する場合、API キーは不要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_purolator フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます: WooCommerce > Settings > Shipping > VibeFox Purolator。または、Plugins ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. リアルタイム料金を使う場合は Purolator API (live rates) セクションに入力します。テストする場合は、開発用キーで Development environment を有効にします。固定料金や代替料金が必要な場合は、Country prices または Fallback price に入力します（設定を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones の配送ゾーンに VibeFox Purolator を追加するか、Ignore shipping zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox Purolator。設定はすべての配送ゾーンに適用されます。ゾーンに配送方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます:
Title (zone): このゾーンで購入者に表示される名前。空欄にすると、全体の Method title が使われます。
設定を保存するたびに、キャッシュされた Purolator の料金が消去されます。保存された値ではリアルタイム料金が機能しない場合（キー、パスワード、アカウントが未入力、カナダの発送元郵便番号がない、CAD のレートがないなど）、または API の認証情報も固定料金もない場合は、設定の上部に警告が表示されます。
一般
Enable/Disable: すべてのゾーンで配送方法を一度にオンまたはオフにします。
Method title: カートと注文手続きに表示される配送方法の名前。ゾーンごとに変更できます。デフォルト: Purolator。
Tax status: Taxable は送料に WooCommerce の税金を加算し、None は加算しません。下の Canadian sales taxes も参照してください。
Purolator API（リアルタイム料金）
API キー、パスワード、請求アカウント番号を入力すると、料金は Purolator E-Ship Estimating ウェブサービスから取得されます。Purolator から料金が返されない場合は固定料金が使われ、固定料金もなければ配送方法は非表示になります。
API key: 選択した環境用の E-Ship Web Services のキーです。
API password: キーに対応するパスワードです。
Billing account number: Purolator のアカウント番号です。見積もりはこのアカウントの料金を使用します。開発環境では、Purolator のドキュメントに記載されているテスト用アカウントを使用できます。
Development environment: 開発用キーを使い、Purolator の開発環境（devwebservices.purolator.com）を使用します。料金はテストデータです。本番のストアでは無効にしてください。
Ship-from postal code: 荷物を発送するカナダの郵便番号です（例: L4W 5M8）。
Service in Canada: Cheapest available（デフォルト）、Purolator Ground、Purolator Ground 9AM、Purolator Ground 10:30AM、Purolator Ground Evening、Purolator Express、Purolator Express 9AM、Purolator Express 10:30AM、Purolator Express 12PM、Purolator Express Evening のいずれか。
Service to the USA: Cheapest available（デフォルト）、Purolator Ground U.S.、Purolator Express U.S.、Purolator Express U.S. 9AM、Purolator Express U.S. 10:30AM、Purolator Express U.S. 12:00 のいずれか。
International service: Cheapest available（デフォルト）、Purolator Express International、Purolator Express International 9AM、Purolator Express International 10:30AM、Purolator Express International 12:00 のいずれか。
選択したサービスが配送先で提供されていない場合は、利用可能な中で最も安いサービスが使われます。
Canadian sales taxes: カナダの住所の場合、Purolator の合計には GST/HST/PST/QST が含まれます。Tax status が Taxable のときは、税金の二重請求を避けるため Use Purolator prices without GST/HST/PST/QST を有効にしてください。
CAD → (store currency) rate: Purolator の料金は CAD で表示されます。貴店の通貨が CAD でない場合は、1 CAD が貴店の通貨で何単位に相当するかを入力してください（例: 0.68）。入力しないと、リアルタイム料金は使用されません。貴店の通貨が CAD の場合は、空欄のままにしてください。
Default product weight (kg): 重量が設定されていない商品に使用されます。デフォルト: 0.5。重量はストアの単位から換算され、切り上げて整数のポンド単位の合計重量として Purolator に送信されます。
固定料金（API の認証情報がない場合に使用され、API から料金が返されない場合は代替として使われます）
Country prices: ストアの通貨で、国とカート重量ごとに設定する料金です。+ Add country をクリックすると行が追加され、×印をクリックすると行が削除されます。独自の行がないすべての国に適用する行には、* Default (all other countries) を選択します。各行には Base 料金と、サイズごとの列があります: XS は 1 kg まで、S は 1～2 kg、M は 2～3 kg、L は 3～5 kg、XL は 5 kg 超です。サイズの料金が空欄またはゼロの場合は Base が使われます。Base が 0 の場合、または Base が空欄の場合は、そのサイズ料金が設定されていない重量では送料が無料になります。料金が 1 つも設定されていない行と無効な国コードは、保存時に削除されます。1 つの国につき行は 1 つだけ保持されます。
Fallback price: Country prices に行がなく、* の行もない国に適用される料金です。その国では配送方法を非表示にする場合は空欄にします。
Fixed price per: Order は料金を 1 回だけ請求します。Item (price × quantity) は、カート内の商品数を掛けた金額を請求します。これは固定料金にのみ適用されます。リアルタイム料金は、常に発送全体に対して計算されます。
条件
Min cart weight (kg): カートの重量がこの値より軽い場合、配送方法を非表示にします。0 は制限なしを意味します。
Max cart weight (kg): カートの重量がこの値より重い場合、配送方法を非表示にします。デフォルト: 30。0 は制限なしを意味します。
Minimum order amount: カートの小計がこの金額に達した場合にだけ配送方法を表示します。空欄にすると常に表示されます。
Excluded shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、配送方法を非表示にします。
Free shipping from: この金額以上のカート小計で送料が無料になります。配送方法に料金がある場合にのみ適用されます。国ごとの料金または代替料金（この場合は Purolator へのリクエストは送信されません）、またはリアルタイム料金が対象です。空欄にすると、送料無料は提供されません。
これらの条件に使われるカート重量は、重量のない商品を 0 として計算します。料金と重量では、小数点としてカンマまたはピリオドを使用できます。
配送ゾーンを使わない場合の提供
Ignore shipping zones: 配送方法がどの配送ゾーンにも追加されていなくても、下記の国に対して Purolator を提供します。
Countries: このモードでの配送先の国です。空欄にすると、発送先としているすべての国を使用します。このフィールドは Ignore shipping zones が有効な場合にのみ使用されます。
詳細設定
Debug log: 料金の計算を WooCommerce > Status > Logs に記録します（ソースは "vfd-purolator"）。API エラーは、デバッグログがオフでも常に記録されます。API キー、請求アカウント番号、購入者の郵便番号は記録されません。作業が終わったらログをオフにしてください。
Remove data on uninstall: オンにすると、プラグインを削除したときに、その設定、ゾーンの配送方法、キャッシュされた料金が削除されます。プラグインを無効化しても何も削除されません。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまず条件を確認します: 配送先の国、カート重量、最低注文金額、除外する配送クラスです。次に料金を探します: Purolator のリアルタイム料金、国ごとの料金表、代替料金の順です。料金がない場合、配送方法は非表示になります。送料無料が適用される場合、購入者は配送方法を無料で表示されます。
API の認証情報があれば、プラグインは Purolator に Quick Estimate のリクエストを送信します。内容は、請求アカウント、発送元の郵便番号、購入者の市区町村、都道府県または州、国と郵便番号、そしてカートの合計重量（整数のポンド単位）です。カナダでは有効な郵便番号が、米国では有効な ZIP コードが必要です。その他の国は、入力された郵便番号のまま送信されます。寸法（容積重量）は送信されません。Purolator はすべてのサービスの料金を返します。プラグインは選択されたサービス、または最も安いサービスを使用し、設定されていればカナダの売上税を差し引き、CAD から料金を換算します。選択されたサービスは Purolator service として注文と一緒に保存され、管理画面の注文画面に表示されます。
各応答は 1 時間キャッシュされます。失敗したリクエストは 10 分間キャッシュされるため、Purolator の障害があってもチェックアウトの更新のたびに遅くなることはありません。API のタイムアウトは 10 秒です。
Purolator から料金が返されない場合（API が利用できない、認証情報や郵便番号が正しくない、サービスが利用できない、CAD のレートがないなど）、購入者にエラーは表示されません。固定料金が使われます。固定料金がない場合、配送方法は非表示になります。理由はログに記録されます。
この配送方法は、クラシックチェックアウトとカートブロック・チェックアウトブロックの両方で動作します。WooCommerce の高パフォーマンス注文保存（HPOS）に対応しています。
本プラグインは料金の計算だけを行います。Purolator の発送データの作成、送り状の印刷、集荷の予約、返品の処理、荷物の追跡は行いません。Full Estimate（寸法、複数の荷物、署名や危険物などのオプション）は使用せず、配送日を表示せず、複数のサービスを別々の料金として表示せず、為替レートを自動的に取得することもありません。
ライセンスキー
本プラグインは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Purolator のページ上部にあります。キーを License key に貼り付け、Activate をクリックしてください。ブロックには、ライセンスの有効期限や、お使いのドメインなどのステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクからは、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、Purolator はチェックアウトで購入者に表示されません。ログインしている管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインのページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作を続けます。ただし、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
Purolator がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、購入者の国のゾーンに配送方法が追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。重量の制限、Minimum order amount、Excluded shipping classes も確認してください。Purolator から料金が返されない場合、配送方法は国ごとの料金、* の行、または Fallback price がある場合にのみ表示されます。
リアルタイム料金が表示されない: WooCommerce > Status > Logs を開き、ソースで "vfd-purolator" を選択してください。API のエラーは常にここに表示されます。詳細を確認するには Debug log をオンにします。API キーを使う場合、住所には有効な郵便番号（カナダ）または ZIP コード（米国）が必要です。
ログに HTTP 401 が表示される: API キーまたはパスワードが、選択した環境と一致していません。開発用キーは Development environment がオンの場合にのみ、本番用キーはオフの場合にのみ機能します。
料金が Purolator のウェブサイトと異なる: Quick Estimate は、請求アカウントの料金と、整数のポンドに切り上げた合計重量を使用し、容積重量は使用しません。カナダの住所では、合計に売上税が含まれます。WooCommerce が配送料に税金を加算する場合は、Canadian sales taxes を使用してください。料金は CAD → (store currency) rate で換算されます。
変更後も料金が古いまま: 設定ページを保存してください。キャッシュされた Purolator の料金が消去されます。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、キーが別のドメインで既に使われている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインのキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化してもすべてのデータは残ります。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。設定、ゾーンの配送方法、キャッシュされた料金は、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。既存の注文は、配送の明細を保持します。
Purolator はそれぞれの所有者の商標です。本プラグインは Purolator と提携しておらず、Purolator の推奨も受けていません。