USPS 接続：リアルタイム料金・ラベル発行・追跡
USPS Developer Portal で Consumer Key と Consumer Secret を取得し、Integration に入力、テスト、サービスマッピング後に料金照会・出荷開始。
USPS コネクタは USPS API で料金取得、ラベル購入、追跡を行います。OAuth 認証情報のペア — Consumer Key と Consumer Secret — で料金と追跡をカバーします。ラベル購入には別途 USPS の支払いアカウント識別子が必要です。
前提条件#
- USPS Developer Portal（developers.usps.com）へのアクセスと、Apps 配下のアプリ。Consumer Key と Consumer Secret はそのアプリページにあります。
- まず環境を決める：本番の前にテスト環境（TEM）で確認。
- 料金と追跡には OAuth のペアだけが必要で、アカウント欄は不要です。
- ラベル購入前に、USPS の支払いアカウント識別子を用意：CRID、MID、EPS。これらはラベル購入時に必要で、この接続の作成時に入力するものではありません。
認証情報の取得#
- USPS Developer Portal（developers.usps.com）→ Apps → アプリを開く。
- アプリページで Consumer Key をコピー。これは OAuth の client_id として使用。
- 同じアプリページで Consumer Secret をコピー。これは OAuth の client_secret として使用。
- Consumer Secret はすぐに安全に保管。紛失したら USPS Developer Portal で再生成。
Integration への入力#
- Integration → コネクタマーケットプレイス → USPS → 新規接続。
- Consumer Key（client_id）、必須：USPS Developer Portal のアプリページの Consumer Key を貼付。ウィザードの表示名は「Consumer Key」です。
- Consumer Secret（client_secret）、必須：同じアプリページの Consumer Secret を貼付。暗号化保存、再表示なし。
- Use sandbox（sandbox）、任意：「true」でテスト環境 TEM（apis-tem.usps.com）を使用。空欄で本番（apis.usps.com）。
- CRID / MID / EPS はここにはありません：ラベル購入用の支払いアカウント識別子で、この接続ウィザードの項目ではありません。ラベル購入前に用意してください。
接続テスト#
接続テストをクリック。テストは Consumer Key と Consumer Secret で OAuth トークンに交換し、認証情報が使えるか確認するだけです。料金照会、ラベル購入、追跡確認はしません。通過すればキー、シークレット、選択した環境が一致。失敗時はエラーを控え、他の設定を変える前に下の FAQ を確認。
Mapping / テンプレート選択#
USPS は注文 Mapping 不要。ここでマッピングするのは配送サービスです：接続設定で、社内で使う各配送サービスを対応する USPS サービスに紐付け、実際に使うサービスだけを有効にし、料金比較で本当に提供するサービスだけが見積もられるようにします。
有効化#
有効化後、出荷時に料金比較とラベル購入で利用でき、追跡更新が返って出荷に反映されます。最初の実際のラベル前に、支払いアカウント識別子（CRID / MID / EPS）が用意できているか確認してください。接続テストでは確認されません。最初は Runs / Logs で数件確認してから無人運用にしてください。
よくある質問#
テストが 401 で失敗する
Consumer Key または Consumer Secret が間違っています：2 つの値の取り違え、またはコピー時の欠落・余分なスペースにより、USPS がトークン交換を拒否しています。
USPS Developer Portal（developers.usps.com）→ Apps → アプリに戻り、Consumer Key を Consumer Key 欄、Consumer Secret を Consumer Secret 欄にそのままコピーし、再テストしてください。
テスト環境と本番の混用
環境と想定が一致していません：Use sandbox に「true」が入りテスト環境 TEM を呼んでいるのに本番としてテストしている、または本番用に空欄なのにテストの挙動を期待しています。
テストしたい環境に設定を合わせ、再テストしてください：テスト環境では Use sandbox に「true」、本番では空欄。両方使う場合は接続を分けてください。
テストは通るがラベル購入に失敗する
支払い側の準備ができていないとこうなります：テストは料金と追跡のための OAuth 交換だけを確認し、ラベル購入には別途 USPS の支払いアカウント識別子 — CRID、MID、EPS — が必要です。
ラベル購入前に CRID、MID、EPS を用意してください。これらは接続ウィザードの項目ではないため、テスト通過ではカバーされません。用意できたら再度購入し、それでも失敗する場合は Runs / Logs のエラーを確認してください。
ラベル購入済みだが追跡が更新されない
追跡の更新は USPS のタイミングで届くもので即時ではなく、USPS にまだ渡していないラベルには表示する動きがありません。
荷物を実際に渡したか確認し、しばらく待って再確認してください。24 時間経っても届かない場合は、Runs / Logs でその出荷の追跡エラーを確認してください。