ドキュメントアプリと統合
配送用に Shippo を接続する
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 を接続する
- プロジェクト → アプリを開きます。
- Shippoを見つけて、接続を選択します。
- 使用する予定の Shippo アカウントから API キーをコピーします。
- Shippo API キーに貼り付けます。
- Runner が無効なキーを報告する場合は、Shippo に戻ってキーを再度コピーします。 シークレットを推測で編集しないでください。
- ダイアログで接続を選択します。
- 成功メッセージを待ち、カードが接続された切断コントロールを表示していることを確認します。
- 顧客注文に依存する前に、安全なテストデータで配送ワークフローを確認します。
キーを切断または置き換える
カードの切断コントロールを選択し、**Shippo を切断しますか?**を読みます。 キーを削除し、ワークスペース内のすべてのプロジェクトで Shippo を無効にすることが許容可能な場合のみ確認します。
別のキーを使用するには、現在の統合を切断し、カードが接続されていないことを確認してから、 置き換えキーで接続ワークフローを完了します。
Shippo が接続しない場合
- 無効な API キーは、値が受け入れられた Shippo キー形式と一致しないことを意味します。
- Shippo への接続に失敗しましたは、Runner がプロバイダー接続を完了しなかったことを意味します。 キーをプライベートに保ち、Shippo で現在であることを確認し、カードから再試行します。
- ダイアログが閉じても接続されたカードが表示されない場合は、再度送信する前にアプリを更新します。
- 切断に失敗した場合は、既存のキーがまだアクティブであると仮定します。
- 接続されたカードは、レート、ラベル、キャリア、または特定の出荷が機能することを証明しません。 安全なテストデータでそれらの操作を個別に確認します。