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

UPS Developer Kit でアプリを作成し、OAuth Client ID / Secret と 6 桁の Shipper Number を Integration に入力、テスト後に料金照会・出荷開始。

UPS コネクタは UPS API でリアルタイム料金取得、ラベル購入、追跡を行います。6 桁の Shipper Number を持つ UPS アカウントが必要です。

前提条件#

• 6 桁の Shipper Number を持つ UPS アカウント。
• UPS Developer Kit へのアクセス（developer.ups.com）。
• テストと本番は別々の認証情報。まずテストモードで開始。

認証情報の取得#

1. UPS Developer Kit でアプリを作成し、OAuth Client ID と Client Secret を控える。
2. UPS アカウントで 6 桁の Shipper Number を確認（請求書の口座番号）。
3. テストモードは UPS のサンドボックス認証情報、本番モードは本番アプリの認証情報を使用。

Integration への入力#

1. Integration → コネクタマーケットプレイス → UPS → 新規接続。
2. Client ID / Client Secret：OAuth アプリ認証情報を貼付。暗号化保存、再表示なし。
3. Shipper Number：6 桁の UPS 口座番号。
4. 環境：まずテスト、料金テスト通過後に本番へ。

接続テスト#

テストはサンプル荷物で実際の料金照会を実行。見積が返れば認証・アカウント・料金の 3 層が正常。失敗時はエラーが断層を示す。

Mapping / テンプレート選択#

UPS は注文 Mapping 不要。接続設定で提供サービス（Ground、2nd Day Air、Next Day Air など）を選択し、比価対象を絞る。

有効化#

有効化後、出荷時に料金比較とラベル購入で利用可能。追跡更新は自動で返送され、出荷に反映。

よくある質問#

認証が失敗する（401）

Client ID / Secret の誤り、またはテスト用認証情報を本番接続に入れた（その逆も）可能性があります。

まず環境の切り替えを確認し、その環境の認証情報をコピーし直してください。

料金照会は失敗するが認証は通る

Shipper Number の誤り、またはそのサービスがアカウントで有効化されていません。

UPS の請求書で Shipper Number を確認してください。

ラベル購入済みだが追跡が更新されない

追跡の更新は UPS のタイミングで届くもので、即時ではありません。

24 時間経っても届かない場合は、Runs / Logs で Webhook エラーを確認してください。