VibeFox Australia Post for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 5.0 以降。インストールされ、有効になっている必要があります。WooCommerce がなければ、本プラグインは有効化できません。
PHP: 8.0 以降。
Australia Post PAC API キー（リアルタイム料金の場合のみ必要）: リアルタイム料金は、Australia Post Postage Assessment Calculator（PAC）API を使用します。キーは無料です。Australia Post Developer Centre（developers.auspost.com.au）に登録して PAC API キーを取得してください。発送元となるオーストラリアの 4 桁の郵便番号も必要です。国ごとの固定料金だけを使用する場合は、API キーは不要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_australia_post フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます。WooCommerce > Settings > Shipping > VibeFox Australia Post を開くか、プラグインページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. Rate source を選択します。リアルタイム料金を使用する場合は、PAC API キー、発送元の郵便番号を入力します。ストアの通貨が AUD 以外の場合は、AUD 換算レートも入力します（「設定」を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で、VibeFox Australia Post を配送ゾーンに追加します。または、Ignore shipping zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります。WooCommerce > Settings > Shipping > VibeFox Australia Post です。設定はすべての配送ゾーンに適用されます。配送ゾーンに方法を追加すると、ゾーンのウィンドウには 1 つの項目だけが表示されます。
Title (zone): このゾーンで購入者に表示される名称です。空欄にすると、全体の Method title が使用されます。
設定を保存するたびに、キャッシュされた Australia Post の料金がクリアされます。リアルタイム料金を選択しているのに API キー、発送元の郵便番号、AUD 換算レートのいずれかが未入力の場合は、保存後に警告が表示されます。
一般
Enable/Disable: すべてのゾーンでこの方法をまとめて有効または無効にします。
Method title: チェックアウトで購入者に表示される配送方法の名称です。ゾーンごとに独自のタイトルで置き換えることができます。既定値: Australia Post。
Tax status: Taxable は配送料に WooCommerce の税金を加算します。None は加算しません。
Rate source: 料金の計算方法です。
エラーの詳細はログに記録され、購入者には表示されません。
Australia Post API（リアルタイム料金）（固定料金の場合は不要）
PAC API key: 無料の Australia Post PAC API キーです。AUTH-KEY ヘッダーで Australia Post に送信されます。
Ship-from postcode: 荷物を発送する 4 桁のオーストラリアの郵便番号です。例: 2000。
Domestic service: オーストラリア国内への配送に使用します（最大 22 kg、各辺 105 cm まで）。Parcel Post（既定）または Express Post を選択します。
International service: オーストラリア国外への配送に使用します（最大 20 kg）。International Standard（既定）、International Express、International Courier から選択します。
Remove GST: 国内の API 料金を 1.1 で割ります。Australia Post の国内料金には 10% の GST が含まれています。WooCommerce が配送料に税金を自分で加算する場合（Tax status = Taxable）は、GST の二重課税を避けるためにこの設定を有効にしてください。国際郵便には GST はかからず、変更されることはありません。
AUD → (your currency) rate: Australia Post の料金は AUD 建てです。ストアの通貨が AUD 以外の場合は、1 AUD が何単位の通貨に相当するかを入力します（例: 0.61）。これを入力しない場合、リアルタイム料金は使用されません。ストアの通貨が AUD の場合は、空欄のままにします。小数点の区切りには、ピリオドとカンマのどちらも使用できます。
リアルタイム料金の荷物設定
カートは 1 つの荷物として送信されます。商品の重量とサイズは、ストアの単位から kg と cm に変換されます。以下の値は、重量やサイズが設定されていない商品に使用されます。
Default product weight (kg): 重量が設定されていない各商品に使用します。Australia Post へのリクエストと、Min cart weight / Max cart weight のチェックで使用されます。既定値: 1。
Default parcel length (cm): カート内のどの商品もサイズが設定されていない場合に使用します。既定値: 22。
Default parcel width (cm): カート内のどの商品もサイズが設定されていない場合に使用します。既定値: 16。
Default parcel height (cm): カート内のどの商品もサイズが設定されていない場合に使用します。既定値: 8。
固定料金（固定料金の場合に使用し、リアルタイム料金のフォールバックとしても使用されます）
Country prices: 2 文字の国コード（AU、NZ、US など）と、ストアの通貨による料金の表です。+ Add row をクリックして国を追加し、削除ボタンで行を削除します。他のすべての国には * を使用します。料金が設定されていない国（* の行もない場合）には固定料金が適用されないため、その国では方法が非表示になります。料金を追加するまで、表は空です。
Fixed price per: Order は料金を 1 回だけ請求します。Item (price × quantity) は、カート内の商品数を掛けて請求します。これは固定料金にのみ適用されます。リアルタイム料金は常に荷物全体で計算されます。
条件
Min cart weight (kg): カートの重量がこの値未満の場合、この方法を非表示にします。0 は制限なしを意味します。
Max cart weight (kg): カートの重量がこの値を超える場合、この方法を非表示にします。既定値: 22。0 は制限なしを意味します。Australia Post の荷物の制限: 国内 22 kg、国際 20 kg。
Minimum order amount: カートの小計がこの金額に達した場合にのみ、この方法を表示します。空欄にすると常に表示されます。
Excluded shipping classes: カート内のいずれかの商品に、これらの WooCommerce 配送クラスが設定されている場合、この方法を非表示にします。
Free shipping: 下に指定した金額以上で送料を無料にします。
Free shipping from: 送料が無料になるカートの小計です。この場合、API へのリクエストは行われません。
配送ゾーンを使用しない場合の提供範囲
Ignore shipping zones: どの配送ゾーンが一致するかに関係なく、下に指定した国でこの方法を提供します。
Countries: このモードの配送先の国です。空欄にすると、ストアが配送先とするすべての国を使用します。Ignore shipping zones と併用する場合にのみ使用されます。
詳細設定
Debug log: 料金の計算を WooCommerce > Status > Logs に記録します。ソースは「vfd-australia-post」です。API のエラーは常に記録されます。API キーと購入者の郵便番号は記録されません。
Remove data on uninstall: オンにすると、プラグインを削除したときに、その設定、ゾーンの方法、キャッシュされた料金が削除されます。プラグインを無効化しても、何も削除されません。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまずカートの重量、Minimum order amount、Excluded shipping classes を確認します。送料無料が適用される場合、料金は 0 となり、Australia Post へのリクエストは送信されません。
固定料金モードでは、料金は表から取得されます。リアルタイム料金モードでは、プラグインは荷物の重量を Australia Post に送信します。国内配送の場合は、発送元と配送先の郵便番号および荷物のサイズも送信します。国際配送の場合は、配送先の国を送信します。国内のリアルタイム料金は、購入者が 4 桁の郵便番号を入力した後にのみ問い合わせます。荷物が Australia Post の制限（国内は 22 kg または 105 cm、国際は 20 kg）を超える場合は、リクエストは送信されません。AUD の料金はお使いの為替レートで換算され、Remove GST が有効な場合は国内料金から GST が差し引かれます。
成功した各応答は 1 時間キャッシュされるため、同じカートで新たなリクエストが発生することはありません。失敗したリクエストは 10 分間キャッシュされるため、チェックアウトは更新のたびに Australia Post の応答を待つ必要がありません。API のエラーが購入者に表示されることは決してありません。方法は非表示になるか、フォールバックモードでは固定料金が使用されます。
この方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。
本プラグインが行うのは料金の計算だけです。配送ラベル、eParcel や MyPost Business の発送データ、マニフェストは作成せず、荷物の追跡も行わず、購入者がパーセルロッカーや郵便局を選択することもできません。カートは常に 1 つの荷物として計算されます。手紙、satchel、契約料金（eParcel）は対象外です。
ライセンスキー
本プラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは、WooCommerce > Settings > Shipping > VibeFox Australia Post の上部にあります。キーを License key に貼り付けて、Activate をクリックします。ブロックには、ライセンスの有効期限や、お使いのドメインなどのステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで Australia Post は購入者に表示されません。ただし、ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示された状態で表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインのページと WooCommerce のページに通知が表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れてもプラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Australia Post が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、購入者の国のゾーンにこの方法が追加されていることを確認してください（または、Ignore shipping zones がオンで、その国が許可されていること）。カートの重量制限、Minimum order amount、Excluded shipping classes も確認してください。固定料金モードでは、その国または * に料金が設定されていることを確認してください。
リアルタイム料金が表示されない: Debug log をオンにし、チェックアウトを再読み込みして、WooCommerce > Status > Logs（ソース「vfd-australia-post」）を開きます。ログに理由が表示されます。API キーや発送元の郵便番号がない、まだ 4 桁の配送先郵便番号が入力されていない、荷物が制限を超えている、AUD 換算レートがない、または Australia Post のエラーメッセージが表示されている、などです。Live rates, fixed price if the API gives no rate を設定していれば、問題を解決している間も、購入者には固定料金が表示されます。
ストアの通貨が AUD ではない: AUD → (your currency) rate に為替レート（1 AUD が何単位のストア通貨に相当するか）を入力してください。固定料金は常にストアの通貨で設定されます。
配送料に GST が二重に課税される: Australia Post の国内料金には 10% の GST が含まれています。Tax status が Taxable の場合は、Remove GST をオンにしてください。
料金が高すぎる、または低すぎる: 商品の重量とサイズ、および Parcel for live rates の既定値を確認してください。Item (price × quantity) の場合、固定料金は商品数に応じて掛け算されます。
変更後に料金が古いままに見える: 設定ページを保存してください。キャッシュされた Australia Post の料金がクリアされます。
ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。たとえば、キーが別のドメインで既に使用されている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化すると、すべてのデータが保持されます。削除するには、無効化したうえで Plugins ページから削除してください。このプラグインのライセンスキーとライセンスのステータスは、常に削除されます。設定、ゾーンの方法、キャッシュされた料金は、Remove data on uninstall がオンになっていた場合にのみ削除されます。それ以外の場合は、後で再インストールするために保持されます。既存の注文は、配送の明細を保持します。
Australia Post は、その所有者の商標です。本プラグインは Australia Post と提携しておらず、Australia Post による承認も受けていません。