---
title: 配送用に Shippo を接続する
description: Shippo API キーを追加し、接続を確認し、Shippo を安全に切断します。
---

Shippo を接続して、Runner が配送とフルフィルメント用に Shippo アカウントを使用するようにします。
接続は Shippo によって提供される API キーを使用します。

## 開始する前に

**エントリパス:** **プロジェクト → アプリ → ストアアプリ → Shippo**

必要なもの:

- Shippo アカウントと現在の Shippo API キー;
- Runner ワークスペースにそのアカウントを接続する権限; および
- Shippo を切断するとそのキーが削除され、ワークスペース内のすべてのプロジェクトで無効になることの認識。

API キーをチャットまたはドキュメントに貼り付けないでください。

## Shippo コントロールと結果

| コントロール | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| **接続** | Shippo セットアップを開きます。 | Runner は**Shippo API キー**を要求します。 |
| **Shippo API キー** | Shippo アカウントを識別します。 | Runner はキー形式をチェックし、値が無効な間はエラーを表示します。 |
| 目のアイコン | タイプミスの値を検査できます。 | フィールドを非表示と表示テキスト間で切り替えます。画面を共有する前に再度非表示にします。 |
| ダイアログ**接続** | キーを送信します。 | 成功時、Runner はダイアログを閉じ、フィールドをクリアし、カードを接続済みに変更します。 |
| **キャンセル**または閉じる | 送信せずにセットアップを終了します。 | Runner は入力されたキーをダイアログからクリアします。 |
| 削除または**切断** | 削除を開始します。 | Runner は**Shippo を切断しますか?**をワークスペース全体の影響と共に開きます。 |
| 確認**切断** | 保存された接続を削除します。 | Runner は API キーを削除し、ワークスペース内のすべてのプロジェクトで Shippo を無効にします。 |

## Shippo を接続する

1. **プロジェクト → アプリ**を開きます。
2. **Shippo**を見つけて、**接続**を選択します。
3. 使用する予定の Shippo アカウントから API キーをコピーします。
4. **Shippo API キー**に貼り付けます。
5. Runner が無効なキーを報告する場合は、Shippo に戻ってキーを再度コピーします。
   シークレットを推測で編集しないでください。
6. ダイアログで**接続**を選択します。
7. 成功メッセージを待ち、カードが接続された切断コントロールを表示していることを確認します。
8. 顧客注文に依存する前に、安全なテストデータで配送ワークフローを確認します。

## キーを切断または置き換える

カードの切断コントロールを選択し、**Shippo を切断しますか?**を読みます。
キーを削除し、ワークスペース内のすべてのプロジェクトで Shippo を無効にすることが許容可能な場合のみ確認します。

別のキーを使用するには、現在の統合を切断し、カードが接続されていないことを確認してから、
置き換えキーで接続ワークフローを完了します。

## Shippo が接続しない場合

- **無効な API キー**は、値が受け入れられた Shippo キー形式と一致しないことを意味します。
- **Shippo への接続に失敗しました**は、Runner がプロバイダー接続を完了しなかったことを意味します。
  キーをプライベートに保ち、Shippo で現在であることを確認し、カードから再試行します。
- ダイアログが閉じても接続されたカードが表示されない場合は、再度送信する前にアプリを更新します。
- 切断に失敗した場合は、既存のキーがまだアクティブであると仮定します。
- 接続されたカードは、レート、ラベル、キャリア、または特定の出荷が機能することを証明しません。
  安全なテストデータでそれらの操作を個別に確認します。

## 関連ガイド

- [アプリを接続、管理、再接続する](./connect-manage-reconnect)
- [4PX フルフィルメントを接続する](./4px-fulfillment)
- [アプリ接続のトラブルシューティング](./troubleshooting)