---
title: Shippo für Versand verbinden
description: Fügen Sie einen Shippo API-Schlüssel hinzu, bestätigen Sie die Verbindung und trennen Sie Shippo sicher.
---

Verbinden Sie Shippo, wenn Sie möchten, dass Runner Ihr Shippo-Konto für Versand und
Fulfillment verwendet. Die Verbindung verwendet einen API-Schlüssel, der von Shippo bereitgestellt wird.

## Bevor Sie beginnen

**Eingabepfad:** **Projekt → Apps → Store Apps → Shippo**

Sie benötigen:

- ein Shippo-Konto und einen aktuellen Shippo API-Schlüssel;
- die Berechtigung, dieses Konto mit dem Runner-Workspace zu verbinden; und
- das Bewusstsein, dass das Trennen von Shippo seinen Schlüssel entfernt und es für alle Projekte im
  Workspace deaktiviert.

Fügen Sie den API-Schlüssel nicht in den Chat oder die Dokumentation ein.

## Shippo-Steuerelemente und Ergebnisse

| Steuerelement | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Verbinden** | Öffnet das Shippo-Setup. | Runner fragt nach dem **Shippo-API-Schlüssel**. |
| **Shippo-API-Schlüssel** | Identifiziert Ihr Shippo-Konto. | Runner überprüft das Schlüsselformat und zeigt einen Fehler an, während der Wert ungültig ist. |
| Augensymbol | Ermöglicht es Ihnen, den Wert auf Tippfehler zu überprüfen. | Schaltet das Feld zwischen verborgenem und sichtbarem Text um. Blenden Sie es erneut aus, bevor Sie Ihren Bildschirm freigeben. |
| Dialog **Verbinden** | Reicht den Schlüssel ein. | Bei Erfolg schließt Runner den Dialog, löscht das Feld und ändert die Karte in verbunden. |
| **Abbrechen** oder schließen | Beendet das Setup ohne Einreichung. | Runner löscht den eingegebenen Schlüssel aus dem Dialog. |
| Löschen oder **Trennen** | Startet die Entfernung. | Runner öffnet **Shippo trennen?** mit der Workspace-weiten Auswirkung. |
| Bestätigung **Trennen** | Entfernt die gespeicherte Verbindung. | Runner entfernt den API-Schlüssel und deaktiviert Shippo für alle Workspace-Projekte. |

## Verbinden Sie Shippo

1. Öffnen Sie **Projekt → Apps**.
2. Suchen Sie **Shippo** und wählen Sie **Verbinden**.
3. Kopieren Sie den API-Schlüssel aus dem Shippo-Konto, das Sie verwenden möchten.
4. Fügen Sie ihn in **Shippo-API-Schlüssel** ein.
5. Wenn Runner einen ungültigen Schlüssel meldet, kehren Sie zu Shippo zurück und kopieren Sie ihn erneut, anstatt das
   Geheimnis durch Vermutung zu bearbeiten.
6. Wählen Sie **Verbinden** im Dialog.
7. Warten Sie auf die Erfolgsmeldung und bestätigen Sie, dass die Karte ihr verbundenes Trennungssteuerelement anzeigt.
8. Verwenden Sie sichere Testdaten, um den Versand-Workflow zu überprüfen, bevor Sie sich darauf für Kundenbestellungen verlassen.

## Trennen oder ersetzen Sie den Schlüssel

Wählen Sie das Trennungssteuerelement der Karte und lesen Sie **Shippo trennen?**. Bestätigen Sie nur, wenn es
akzeptabel ist, den Schlüssel zu entfernen und Shippo für jedes Projekt im Workspace zu deaktivieren.

Um einen anderen Schlüssel zu verwenden, trennen Sie die aktuelle Integration, bestätigen Sie, dass die Karte nicht mehr verbunden ist, und schließen Sie dann den Verbindungs-Workflow mit dem Ersatzschlüssel ab.

## Wenn Shippo nicht verbunden wird

- **Ungültiger API-Schlüssel** bedeutet, dass der Wert nicht dem akzeptierten Shippo-Schlüsselformat entspricht.
- **Fehler beim Verbinden von Shippo** bedeutet, dass Runner den Anbieter-Verbindung nicht abgeschlossen hat. Halten Sie den Schlüssel privat, bestätigen Sie, dass er in Shippo aktuell ist, und versuchen Sie es erneut von der Karte.
- Wenn der Dialog geschlossen wird, aber die Karte nicht verbunden wird, aktualisieren Sie Apps, bevor Sie erneut einreichen.
- Wenn das Trennen fehlschlägt, nehmen Sie an, dass der vorhandene Schlüssel noch aktiv ist.
- Eine verbundene Karte beweist nicht, dass Tarife, Etiketten, Spediteure oder eine bestimmte Sendung
  funktionieren. Überprüfen Sie diese Operationen separat mit sicheren Testdaten.

## Verwandte Anleitungen

- [App verbinden, verwalten und erneut verbinden](./connect-manage-reconnect)
- [4PX Fulfillment verbinden](./4px-fulfillment)
- [Fehlerbehebung bei einer App-Verbindung](./troubleshooting)
