VibeFox FedEx for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 7.0 以降がインストールされ、有効になっていること。WooCommerce がなければ、本プラグインは有効化できません。
PHP: 8.0 以降。
FedEx アカウントと API キー（リアルタイムの送料を使う場合のみ）: FedEx Developer Portal（developer.fedex.com）で、Rate API を有効にしたプロジェクトを作成し、お使いの FedEx 配送アカウントをリンクして、API Key と Secret Key をコピーしてください。9 桁の FedEx アカウント番号も必要です。テスト用のキーは Sandbox を有効にした場合のみ、本番用のキーは無効にした場合のみ使用できます。本プラグインは OAuth 2.0 を使う FedEx REST API を利用するため、meter number や Web Services のパスワードは不要です。固定料金のみを使う場合は、FedEx のキーは必要ありません。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選んで Install Now をクリックします。FTP で vfd_fedex フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます。WooCommerce > Settings > Shipping > VibeFox FedEx、またはプラグインの一覧ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. API Key、Secret Key、9 桁の FedEx アカウント番号、そして Ship from の住所（郵便番号、および米国とカナダの場合は 2 文字の州コード）を入力します。本番用のキーを使う場合は Sandbox をオフにします。
6. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーンに VibeFox FedEx を追加するか、Ignore shipping zones をオンにして国を選択します。
7. 必要に応じて、代替として固定料金を入力します。
設定
すべての設定は 1 つのページにあります。WooCommerce > Settings > Shipping > VibeFox FedEx です。これらの設定はすべての配送ゾーンに適用されます。ゾーンにこの方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます。
Title (zone): チェックアウトに表示されるこのオプションの名前です。空欄にすると、全体の Name が使われます。
ページの上部には、プラグインからの警告が表示されます。3 つの API 認証情報の一部しか入力されていない、API キーも固定料金もない（この場合、この方法は表示されません）、発送元の郵便番号がない、米国またはカナダの発送元の州コードがない、ストアの通貨が FedEx アカウントの通貨と異なり為替レートが設定されていない、といった内容です。設定を保存するたびに、キャッシュされた FedEx のトークンと送料が削除されます。数値の項目では、小数点またはカンマを入力できます。無効な数値は保存されず、その旨が表示されます。
General
Enable/Disable: すべてのゾーンで FedEx の配送を一度にオンまたはオフにします。既定値: オン。
Name: チェックアウト時に購入者に表示される配送方法の名前です。既定値: FedEx。
Tax status: Taxable を選ぶと、WooCommerce が配送料に税金を加算するため、税抜きの FedEx 料金が使われます。None を選ぶと、FedEx の正味料金がそのまま使われます。既定値: Taxable。
FedEx API（リアルタイムの送料）
キーが入力されていない場合は固定料金が使われます。このセクションには Clear cached FedEx token and rates のリンクがあります。
Sandbox: テスト用のキーで FedEx のサンドボックスを使用します。本番用のキーで実際の送料を取得するには、オフにします。既定値: オン。
API Key: FedEx Developer Portal のプロジェクトの API Key（client_id）です。
Secret Key: 同じプロジェクトの Secret Key（client_secret）です。
FedEx account number: プロジェクトにリンクされた 9 桁の FedEx 配送アカウントです。
Rates: Account rates (your negotiated FedEx prices)（既定値）または List rates (FedEx published prices) を選びます。
Residential delivery: 購入者の住所を住宅向けとして見積もります（FedEx Home Delivery、住宅向け追加料金）。主に法人向けに発送する場合はオフにしてください。既定値: オン。
Box size: ストアの寸法単位で指定する任意の箱のサイズです。例: 30x20x15。指定すると、FedEx が容積重量を適用します。空欄にすると、重量のみで見積もります。
FedEx account currency: FedEx アカウントの通貨です。例: 米国のアカウントなら USD、カナダなら CAD。既定値: USD。FedEx には、ストアの通貨でも見積もるよう常に要求されます。
Exchange rate: FedEx がアカウントの通貨でのみ料金を返し、ストアの通貨が異なる場合にのみ必要です。アカウントの通貨 1 単位をストアの通貨で表した価格で、例: 0.92。設定しない場合、そのような料金は使用されません。
発送元
FedEx が荷物を集荷する住所、またはお客様が荷物を持ち込む住所です。リアルタイムの送料に使われます。
Country: 発送元の国です。既定値: United States。
State / province code: 2 文字の州コードです。米国とカナダでは必須です。例: TN、CA、ON。
City: 発送元の市区町村です。
ZIP / postal code: 発送元の郵便番号です。FedEx が料金を見積もるために必要です。
固定料金
API キーが入力されていない場合に使われ、また FedEx が料金を返さない場合（API に接続できない、キーが誤っている、対応するサービスがないなど）の代替としても使われます。この場合にこの方法を非表示にするには、両方の項目を空欄にしてください。
Country prices: 配送先の国ごとの、ストアの通貨での料金です。1 行に 1 つの国を CC=PRICE の形式で入力します。例: US=12.99 または CA=19,99。その他すべての国には * を使います。例: *=29.99。別の形式の行は無視され、保存時に通知されます。
Fallback cost: どの国の料金にも一致しない場合に使われる、固定の料金です。空欄にするとこの方法は非表示になります。
Fixed price is: Per order は料金を 1 回だけ請求します。Per item (price x number of items) は、料金に商品数を掛けます。これは固定料金にのみ適用されます。FedEx のリアルタイムの送料は、常にカート全体の重量で見積もられます。
条件
Free shipping from: この方法が無料になるカートの小計です。空欄にすると、送料無料は提供されません。
Minimum subtotal: カートの小計がこの金額以上の場合にのみ、この方法を表示します。空欄にすると、常に表示されます。
Min weight (kg): この方法が表示されるために必要なカートの最低重量です。0 は制限なしを意味します。
Max weight (kg): カートの最大重量です。これを超えると、この方法は非表示になります。0 は制限なしを意味します。
Default product weight (kg): 重量が設定されていない商品に使われる重量です。FedEx の送料と上記の重量制限に使われます。既定値: 0.5。
Excluded shipping classes: カートに、これらの WooCommerce の配送クラスのいずれかに属する商品が含まれている場合、この方法を非表示にします。
配送ゾーンを使わない場合の提供
Ignore shipping zones: 配送ゾーンにこの方法が追加されていなくても、下に指定した国に対してこの方法を提供します。ゾーン内でオフにされたゾーン方法は、オフのままです。
Countries: このモードの配送先の国です。空欄にすると、ストアのすべての配送対象国が対象になります。Ignore shipping zones がオンの場合にのみ使われます。
詳細設定
Debug log: API のリクエストと送料の計算を WooCommerce > Status > Logs に、ソースを vfd-fedex として記録します。API のエラーは常に記録されます。キー、トークン、購入者の住所は記録されません。
Remove data on uninstall: オンの場合、プラグインを削除すると、プラグインのすべての設定とゾーン方法が削除されます。プラグインを無効にしても、設定は削除されません。
チェックアウト時の動作
購入者が配送先の住所を入力すると、WooCommerce がプラグインに送料を問い合わせます。プラグインは最初に、カートの重量、最低小計、除外する配送クラスを確認します。送料無料が適用される場合、購入者にはこの方法が FedEx (Free) として表示され、FedEx へのリクエストは送信されません。
それ以外の場合、プラグインは OAuth トークンを取得し、発送元の住所、配送先の住所、カートの重量（kg で、lb や oz を使うストアでは lb で）、設定されている場合は箱のサイズ、そして希望通貨としてストアの通貨を、FedEx の Rate API に送信します。郵便番号を使う国では、購入者が郵便番号を入力した後にのみリクエストを行います。国際配送の場合は、カートの関税評価額を送信します。州コードは、米国とカナダの場合にのみ送信されます。
FedEx は利用可能なサービスを返します。プラグインは、サービスごとに、選択したアカウント料金またはリスト料金を取得し、ストアの通貨の料金を優先し、FedEx アカウントの通貨の料金は設定した為替レートで換算し、換算できない料金は除外します。最も安いサービスが配送方法の名前の下に表示され、その名前は注文の配送行に保存されます。
トークンは環境とキーごとにキャッシュされ、FedEx に拒否された場合は自動的に再取得されます。見積もりは 1 時間キャッシュされます。料金リクエストが失敗した場合は 10 分間、トークンのリクエストが失敗した場合は 5 分間記憶されるため、障害があってもチェックアウトの更新のたびに遅くなることはありません。API のタイムアウトは 15 秒です。FedEx が応答しない場合でも、購入者にエラーは表示されません。固定料金が使われるか、この方法が非表示になります。
この方法は、クラシックのチェックアウトとブロックのチェックアウトの両方で動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。
本プラグインは送料を計算するだけです。FedEx の発送データの作成、ラベルの印刷、集荷の予約、荷物の追跡、購入者による FedEx 拠点の選択はできません。複数ではなく 1 つのオプション（最も安いサービス）を表示し、箱詰めの機能はありません。カートは 1 個の荷物として見積もられます。
ライセンスキー
本プラグインは、vibefox.net で購入した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox FedEx の上部にあります。キーを License key に貼り付けて、Activate をクリックします。このブロックには、ステータス（例: ライセンスの有効期限の日付）とお使いのドメインが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除できます。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで FedEx は購入者に表示されません。ログインしているストア管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されます。そのため、キーを購入する前にプラグインを設定してテストできます。プラグインの一覧ページと WooCommerce のページには、リマインダーが表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れた後も、プラグインは動作を続けます。ただし、アップデートとサポートには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに FedEx が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、そしてこの方法が購入者の国のゾーンに追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。設定ページの上部の警告、重量制限、Minimum subtotal、Excluded shipping classes を確認します。リアルタイムの送料がない場合、この方法には国ごとの料金、* の行、または Fallback cost が必要です。
リアルタイムの送料が表示されない: Debug log をオンにして、チェックアウトを再読み込みし、WooCommerce > Status > Logs を開いて、ソースで vfd-fedex を選択してください。誤ったキー、誤った環境（Sandbox がオフの状態でテスト用のキーを使う、またはオンの状態で本番用のキーを使う）、FedEx のエラーコードは、ここに記録されます。
ストアの通貨が USD ではない: FedEx には、ストアの通貨での料金が要求されます。アカウントが自身の通貨の料金しか返さない場合は、FedEx account currency と Exchange rate を設定してください。為替レートがない場合、そのような料金は無視され、固定料金が使われます。そのため、USD の金額がユーロで表示されることはありません。
「per item」は FedEx の料金を掛け算しますか? いいえ。Per item は固定料金にのみ適用されます。
変更後に料金が古く見える: キーを変更すると、キャッシュは自動的に削除されます。Clear cached FedEx token and rates をクリックすることもできます。
一部のサービスのみを提供したい: 開発者は vfd_fdx_allowed_services フィルターを使ってサービスを制限できます。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、キーが別のドメインで既に使われている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効にしても、すべての設定は保持され、キャッシュされたトークンと料金だけが削除されます。削除するには、プラグインを無効にしてから、Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータス、キャッシュされたトークンと料金、古いログファイルは、常に削除されます。設定とゾーン方法は、Remove data on uninstall がオンになっていた場合にのみ削除されます。それ以外の場合、後で再インストールするために保持されます。既存の注文は、配送行を保持します。
FedEx は、各所有者の商標です。本プラグインは FedEx との提携関係になく、FedEx による推奨もされていません。