FedEx 接続：リアルタイム料金・ラベル発行・追跡

最終更新 2026-11-01

FedEx Developer Portal のプロジェクトで API Key と Secret Key を取得し、9 桁の FedEx Account Number とともに Integration に入力、テスト、サービスマッピング後に料金照会・出荷を開始。

FedEx コネクタは FedEx API でリアルタイム料金取得、ラベル購入、追跡、ラベル取消を行い、すべてご自身の FedEx アカウントで処理します。料金とラベル費用は入力した FedEx Account Number に請求されます。

FedEx 接続手順：まずプロジェクト認証情報、次に口座番号、テスト、サービスマッピング、有効化。

前提条件#

9 桁の FedEx Account Number を持つ FedEx アカウント。料金とラベルはこのアカウントに請求されます。
FedEx Developer Portal → My Projects へのアクセス。そこにプロジェクトの API Key と Secret Key が表示されます。
まず環境を決めてください。サンドボックスでテストする場合は sandbox に true、本番は空欄。サンドボックスと本番の認証情報は混用できません。選んだ環境の認証情報を使ってください。

認証情報の取得#

API Key の取得：FedEx Developer Portal → My Projects → プロジェクト → API Key。この API Key はそのプロジェクトの OAuth Client ID です。表示どおりにコピーしてください。
Secret Key の取得：同じプロジェクトで Secret Key を開きます。これは OAuth Client Secret です。完全な値は生成時にのみ完全に表示されるため、その場で安全に保管してください。紛失した場合はポータルで再生成してください。
FedEx Account Number の取得：fedex.com → My Profile → Account Management で、9 桁の発送アカウント番号をコピー。料金とラベルはこのアカウントに請求されます。
警告——プロジェクトを混ぜないこと：Track と Rate / Ship は別々の Developer Portal プロジェクトに属し、それぞれ独自の API Key と Secret Key を持つ場合があります。1 つの接続では、必ず同じプロジェクトの API Key と Secret Key を使ってください。一方のプロジェクトの Key と他方の Secret を混ぜると失敗します。

Integration への入力#

Integration → コネクタマーケットプレイス → FedEx → 新規接続。
API Key：FedEx Developer Portal → My Projects → プロジェクトで取得した API Key を貼付。そのプロジェクトの OAuth Client ID です。シークレットとして保存され、再表示されません。
Secret Key：同じプロジェクトの Secret Key を貼付。上の API Key とペアになっていることを確認してください。別プロジェクトの Secret Key は使わないこと。例えばこの接続が Rate / Ship 用なのに Track プロジェクトのものを使うなど。シークレットとして保存され、再表示されません。
FedEx Account Number：fedex.com → My Profile → Account Management の 9 桁の発送アカウント番号を入力、例 123456789。各桁を確認してください。接続テストではこの番号は検証されませんが、料金とラベルはこの番号に請求されます。
Use sandbox、任意：サンドボックスを使う場合は true、本番は空欄。true の場合はサンドボックスプロジェクトの認証情報とのみ組み合わせ、空欄の場合は本番プロジェクトの認証情報とのみ組み合わせてください。

接続テスト#

接続テストをクリック。テストは API Key と Secret Key を OAuth トークンに交換し、選んだ環境で認証情報が使えるか確認するだけです。FedEx Account Number の検証も料金照会も行いません。そのため、テスト合格は Key と Secret の確認のみです。口座番号が間違っていると、その後の料金取得やラベル発行は失敗します。失敗した場合はエラーを控え、下の FAQ を確認してください。

Mapping / テンプレート選択#

FedEx は注文 Mapping 不要です。荷物を扱い、注文は扱いません。ここでマッピングするのはサービスです。各 FedEx サービスをご自身の対応する社内サービスにマッピング（サービスマッピング）し、実際に発送に使う FedEx サービスだけを有効にしてください。料金比較とラベル購入はこのマッピングに従うため、注文は意図したサービスだけを見積・購入します。

FedEx 出荷フロー：見積、ラベル購入、追跡、取消。すべて Integration 経由。

有効化#

有効化後、出荷時に料金比較とラベル購入で利用でき、追跡更新が自動で戻って出荷に反映され、不要になったラベルは同じ接続で取消できます。最初は Runs / Logs で数件、特に初回の料金照会と初回ラベルを確認してから無人運用してください。

よくある質問#

テストが 401 で失敗する

API Key か Secret Key が間違っているか、プロジェクトをまたいで混ざっています。例えば Rate / Ship プロジェクトの API Key と Track プロジェクトの Secret Key の組み合わせです。FedEx は同じプロジェクトの Key と Secret のペアのみを受け付けるため、混ざったペアは拒否されます。

FedEx Developer Portal → My Projects で 1 つのプロジェクトだけを開き、その同じプロジェクトの API Key と Secret Key を余分なスペースなしでコピーし直し、両フィールドを置き換えて再テストしてください。

サンドボックスと本番の認証情報が混ざっている

環境と認証情報が一致していません。sandbox フィールドは true がサンドボックス、空欄が本番を示しますが、API Key と Secret Key がもう一方の環境のプロジェクトのものであるため、FedEx がトークン交換を拒否します。

1 つの環境を選び、すべてを一致させてください。テスト時は Use sandbox を true にしてサンドボックスプロジェクトの認証情報を入力。本番出荷時は Use sandbox を空欄にして本番プロジェクトの認証情報を入力。その後再テストしてください。

テストは合格するが料金取得やラベル発行が失敗する

FedEx Account Number が間違っています。テストは OAuth トークンを交換するだけで口座番号を一切確認しないため、入力ミスや誤った口座でもテストに合格します。障害は料金取得やラベル発行でその口座に請求しようとしたときに初めて現れます。

fedex.com → My Profile → Account Management で口座を確認し、FedEx Account Number フィールドをそこに表示される正確な 9 桁の番号に修正して、料金照会またはラベル発行を再試行してください。

ラベル作成済みだが追跡が更新されない

追跡の更新は FedEx のタイミングで届くもので即時ではありません。そのため、新しいラベルはしばらく動きが表示されないことがあります。荷物をまだ FedEx に渡していない場合も、報告すべきスキャンはまだありません。

まず荷物を FedEx に渡したか確認してください。荷物が FedEx ネットワークに入った後も追跡が表示されない場合は、Runs / Logs で追跡エラーを確認し、追跡に使う接続に Track プロジェクトの API Key と Secret Key が入っているか確認してください。Rate / Ship のペアではありません。