> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Eine Anbindung an einen Versanddienstleister anfragen

> Bitte Zippendo, einen Versanddienstleister hinzuzufügen, der nicht im Tab „Alle Versanddienstleister“ steht, über „Anbindungsanfragen“, mit der Website des Versanddienstleisters, seinen Test-Zugangsdaten und der Anmeldemethode.

Wenn der Versanddienstleister, den du nutzt, nicht im Tab **Alle Versanddienstleister** steht, kannst du Zippendo bitten, die Verbindung zu bauen. Du schickst die Website des Versanddienstleisters, Links zur Dokumentation und **Test**-Zugangsdaten. Zippendo baut und testet die Verbindung mit KI. Wenn sie fertig ist, verbindest du den Versanddienstleister wie jeden anderen.

Für einen Versanddienstleister, der schon unter **Alle Versanddienstleister** steht, siehe [Zugangsdaten für Versanddienstleister](/docs/de/how-to/carrier-credentials). Die vollständige Anleitung steht unter [Versanddienstleister](/docs/de/tutorials/carriers).

## Deine Anfragen

Klicke in der Seitenleiste auf **Anbindungsanfragen**. Die Seite heißt **Anbindungsanfragen** und listet deine Anfragen unter **Deine Anfragen** auf. Klicke oben auf **Versanddienstleister anfragen**, um eine neue zu senden.

Die Liste hat diese Spalten: **Versanddienstleister**, **Status**, **Anmeldemethode**, **Gesendet** und **Zuletzt aktualisiert**. Klicke auf eine Zeile, um die Details zu sehen. Wenn du noch keine Anfragen hast, steht auf der Seite „Keine Anbindungsanfragen“ und es gibt die Schaltfläche **Versanddienstleister anfragen**.

<Frame caption="Die Seite „Anbindungsanfragen“ vor deiner ersten Anfrage">
  <img src="https://mintcdn.com/zippendo/QneClDeTTsGTsMz3/images/de/how-to/request-carrier-integration/01-request-list-light.png?fit=max&auto=format&n=QneClDeTTsGTsMz3&q=85&s=4fe516e25bc66a50cbf977e2502986fe" alt="Seite „Anbindungsanfragen“ ohne Anfragen und mit der Schaltfläche „Versanddienstleister anfragen“" className="block dark:hidden" width="2880" height="1800" data-path="images/de/how-to/request-carrier-integration/01-request-list-light.png" />

  <img src="https://mintcdn.com/zippendo/QneClDeTTsGTsMz3/images/de/how-to/request-carrier-integration/01-request-list-dark.png?fit=max&auto=format&n=QneClDeTTsGTsMz3&q=85&s=4ba096156c4e42a7758aa8836066a454" alt="Seite „Anbindungsanfragen“ ohne Anfragen und mit der Schaltfläche „Versanddienstleister anfragen“" className="hidden dark:block" width="2880" height="1800" data-path="images/de/how-to/request-carrier-integration/01-request-list-dark.png" />
</Frame>

### Status

| Status | Was er bedeutet |
| - | - |
| **Ausstehend** | Du hast die Anfrage gesendet. Sie wartet darauf, dass Zippendo sie freigibt. |
| **Freigegeben** | Zippendo hat die Anfrage angenommen. Die Arbeit kann beginnen. |
| **In Arbeit** | Zippendo baut die Verbindung. |
| **Wartet auf Prüfung** | Die Verbindung ist gebaut und wartet auf eine Prüfung durch das Zippendo-Team. |
| **Abgeschlossen** | Der Aufbau ist fertig. |
| **Veröffentlicht** | Der Versanddienstleister ist bereit. Du kannst ihn unter **Alle Versanddienstleister** verbinden. |
| **Abgelehnt** | Zippendo hat die Anfrage nicht angenommen. |
| **Fehlgeschlagen** | Der Aufbau war nicht erfolgreich. |

## Eine Anfrage senden

<Steps>
  <Step title="Formular öffnen">
    Klicke unter **Anbindungsanfragen** auf **Versanddienstleister anfragen**. Das Fenster **Versanddienstleister anfragen** öffnet sich.
  </Step>

  <Step title="Den Versanddienstleister beschreiben">
    Fülle **Name des Versanddienstleisters** und **Website des Versanddienstleisters** aus. Füge eine **Dokumentations-URL** und eine **Swagger-/OpenAPI-URL** hinzu, wenn der Versanddienstleister sie für Entwickler veröffentlicht.
  </Step>

  <Step title="Die Test-Zugangsdaten hinzufügen">
    Wähle die **Anmeldemethode**, die der Versanddienstleister nutzt, und fülle dann die Felder für die Zugangsdaten aus, die dafür erscheinen. Verwende die Angaben für das Testsystem des Versanddienstleisters, nicht für dein Live-Konto.
  </Step>

  <Step title="Absenden">
    Füge **Notizen** hinzu, wenn wir etwas wissen sollten, und klicke dann auf **Anfrage senden**. Du siehst „Anfrage gesendet“ und die Anfrage erscheint in der Liste als **Ausstehend**.
  </Step>
</Steps>

<Frame caption="Das Formular „Versanddienstleister anfragen“ mit der Anmeldemethode API-Schlüssel">
  <img src="https://mintcdn.com/zippendo/QneClDeTTsGTsMz3/images/de/how-to/request-carrier-integration/02-request-form-api-key-light.png?fit=max&auto=format&n=QneClDeTTsGTsMz3&q=85&s=049aa94e56b4a14e323c9d2e884eef65" alt="Fenster „Versanddienstleister anfragen“ mit Name, Website, Links zur Dokumentation und dem Feld „API-Schlüssel“" className="block dark:hidden" width="2880" height="2800" data-path="images/de/how-to/request-carrier-integration/02-request-form-api-key-light.png" />

  <img src="https://mintcdn.com/zippendo/QneClDeTTsGTsMz3/images/de/how-to/request-carrier-integration/02-request-form-api-key-dark.png?fit=max&auto=format&n=QneClDeTTsGTsMz3&q=85&s=9e8c1de1e42039b92a4dc2ab2cda5fc7" alt="Fenster „Versanddienstleister anfragen“ mit Name, Website, Links zur Dokumentation und dem Feld „API-Schlüssel“" className="hidden dark:block" width="2880" height="2800" data-path="images/de/how-to/request-carrier-integration/02-request-form-api-key-dark.png" />
</Frame>

### Felder

| Feld | Erforderlich | Was du eingibst |
| - | - | - |
| **Name des Versanddienstleisters** | Ja | Der Name des Versanddienstleisters. Bis zu 80 Zeichen: Buchstaben, Zahlen, Leerzeichen und `. & ' + / ( ) _ -`. Andere Zeichen zeigen „Nur Buchstaben, Zahlen und . & ' + / ( ) \_ -“. |
| **Website des Versanddienstleisters** | Ja | Eine vollständige Webadresse, zum Beispiel `https://developer.carrier.com`. |
| **Dokumentations-URL** | Nein | Wo der Versanddienstleister sein System für Entwickler beschreibt. |
| **Swagger-/OpenAPI-URL** | Nein | Eine technische Beschreibungsdatei, falls der Versanddienstleister eine anbietet. Frag beim Versanddienstleister nach, wenn du dir nicht sicher bist. |
| **Anmeldemethode** | Ja | Wie das System des Versanddienstleisters prüft, wer du bist. Sie beginnt mit **API-Schlüssel**. Siehe den nächsten Abschnitt. |
| **Gegen das Live-System des Versanddienstleisters testen** | Nein | Ein Schalter, standardmäßig deaktiviert. Siehe unten. |
| **Notizen** | Nein | Alles andere, was wir über den Versanddienstleister wissen sollten, bis zu 1000 Zeichen. |

Eine ungültige Webadresse zeigt „Gib eine gültige URL ein“. Ein leeres Pflichtfeld zeigt „Dieses Feld ist erforderlich“.

### Zugangsdaten für jede Anmeldemethode

Die Felder für die Zugangsdaten ändern sich mit der **Anmeldemethode**. Es werden nur die Felder für den gewählten Typ gesendet.

| Anmeldemethode | Auszufüllende Felder |
| - | - |
| **API-Schlüssel** | **API-Schlüssel**. Wenn das Feld leer ist, siehst du „API-Schlüssel ist erforderlich“. |
| **OAuth 2.0** | **Client-ID**, **Client-Secret** und **Token-URL** (die Webadresse, bei der der Versanddienstleister Zugriff vergibt, zum Beispiel `https://auth.carrier.com/token`). |
| **Benutzername und Passwort** | **Benutzername** und **Passwort**. |
| **Individuell** | Füge unter **Eigene Zugangsdaten** für jede Angabe eine Zeile hinzu, mit einem **Schlüssel** (ihr Name) und einem **Wert**. **Feld hinzufügen** fügt eine Zeile hinzu und **Feld entfernen** entfernt eine. Mindestens eine Zeile braucht einen Namen, sonst siehst du „Füge mindestens ein Schlüssel-Wert-Paar hinzu“. |

Der Versanddienstleister sagt dir, welchen Typ er nutzt. Wenn du dir nicht sicher bist, frag beim Versanddienstleister nach oder wähle **Individuell** und füge jede Angabe hinzu, die du bekommen hast.

<Frame caption="Bei OAuth 2.0 füllst du Client-ID, Client-Secret und Token-URL aus">
  <img src="https://mintcdn.com/zippendo/QneClDeTTsGTsMz3/images/de/how-to/request-carrier-integration/03-request-form-oauth-light.png?fit=max&auto=format&n=QneClDeTTsGTsMz3&q=85&s=c8857fa2170a3c0c9f19725988de9534" alt="Fenster „Versanddienstleister anfragen“ mit der Anmeldemethode OAuth 2.0 und den Feldern Client-ID, Client-Secret und Token-URL" className="block dark:hidden" width="2880" height="2800" data-path="images/de/how-to/request-carrier-integration/03-request-form-oauth-light.png" />

  <img src="https://mintcdn.com/zippendo/QneClDeTTsGTsMz3/images/de/how-to/request-carrier-integration/03-request-form-oauth-dark.png?fit=max&auto=format&n=QneClDeTTsGTsMz3&q=85&s=db541e459ecb8d9848f66e235fc33376" alt="Fenster „Versanddienstleister anfragen“ mit der Anmeldemethode OAuth 2.0 und den Feldern Client-ID, Client-Secret und Token-URL" className="hidden dark:block" width="2880" height="2800" data-path="images/de/how-to/request-carrier-integration/03-request-form-oauth-dark.png" />
</Frame>

### Gegen das Live-System des Versanddienstleisters testen

Lass diesen Schalter in den meisten Fällen deaktiviert. Zippendo testet die neue Verbindung dann mit deinen Angaben gegen das Testsystem des Versanddienstleisters.

Aktiviere ihn nur, wenn der Versanddienstleister kein Testsystem hat. Das Formular sagt: „Aktiviere das nur, wenn der Versanddienstleister keine Testumgebung hat. Dann führen wir die Tests mit den Zugangsdaten oben gegen sein Live-System aus. Lass es deaktiviert, um in der Testumgebung des Versanddienstleisters zu testen.“

Dieser Schalter wirkt sich nur auf die Anfrage aus. Er ist nicht das Kontrollkästchen **Testmodus** bei einem verbundenen Versanddienstleister, siehe [Testmodus](/docs/de/how-to/sandbox-mode).

<Frame caption="Gegen das Live-System des Versanddienstleisters testen ist standardmäßig deaktiviert">
  <img src="https://mintcdn.com/zippendo/QneClDeTTsGTsMz3/images/de/how-to/request-carrier-integration/04-request-form-live-light.png?fit=max&auto=format&n=QneClDeTTsGTsMz3&q=85&s=6eccae742cdc2106a45f2c01e8215df6" alt="Fenster „Versanddienstleister anfragen“, gescrollt zum Schalter „Gegen das Live-System des Versanddienstleisters testen“ und zu den Notizen" className="block dark:hidden" width="2880" height="2800" data-path="images/de/how-to/request-carrier-integration/04-request-form-live-light.png" />

  <img src="https://mintcdn.com/zippendo/QneClDeTTsGTsMz3/images/de/how-to/request-carrier-integration/04-request-form-live-dark.png?fit=max&auto=format&n=QneClDeTTsGTsMz3&q=85&s=01373198e68f6a938d257aa67be86981" alt="Fenster „Versanddienstleister anfragen“, gescrollt zum Schalter „Gegen das Live-System des Versanddienstleisters testen“ und zu den Notizen" className="hidden dark:block" width="2880" height="2800" data-path="images/de/how-to/request-carrier-integration/04-request-form-live-dark.png" />
</Frame>

## Eine Anfrage verfolgen

Klicke in der Liste auf eine Anfrage, um ihre Details zu öffnen. Du siehst:

* den Namen des Versanddienstleisters und den Status
* einen Link zur Website des Versanddienstleisters
* deine **Notizen**, falls du welche hinzugefügt hast
* **Fortschritt**: die Schritte des Aufbaus, zum Beispiel **Anfrage gesendet**, **Versanddienstleister wird recherchiert**, **Code für Versandetiketten wird erstellt**, **Code für Sendungsverfolgung wird erstellt**, **Code für Paketshops wird erstellt**, **Code für Versandprodukte wird erstellt**, **Tests laufen** und **Veröffentlicht**. Jeder Schritt ist als **Ausstehend**, **Wird erstellt**, **Erstellt**, **Fehlgeschlagen** oder **Übersprungen** markiert.

Klicke auf **Schließen**, um zur Liste zurückzugehen. Du kannst eine Anfrage hier nicht ändern oder erneut senden. Wenn etwas nicht stimmt, sende eine neue Anfrage.

Wenn der Status **Veröffentlicht** ist, öffne **Versanddienstleister** → **Alle Versanddienstleister** und verbinde den neuen Versanddienstleister wie jeden anderen. Wähle dann seine Versandprodukte wie unter [Versandprodukte und Zusatzleistungen](/docs/de/how-to/carrier-products-and-services) beschrieben.

## Meldungen

| Was du siehst | Was du tun kannst |
| - | - |
| „Anfrage konnte nicht gesendet werden. Versuch es noch einmal.“ | Die Anfrage wurde nicht gesendet. Versuch es gleich noch einmal. |
| „Zu viele Versuche in kurzer Zeit. Warte einen Moment und versuch es noch einmal.“ | Du hast in kurzer Zeit viele Anfragen gesendet. Warte eine Weile und versuch es noch einmal. |
| „Diese Anbindungsanfrage wird bereits bearbeitet. Warte, bis das abgeschlossen ist.“ | Zippendo arbeitet schon an der Anfrage. Warte, bis sich der Status ändert. |
| „Die Bearbeitung dieser Anbindungsanfrage konnte nicht gestartet werden. Versuch es gleich noch einmal.“ | Der Aufbau konnte nicht starten. Versuch es gleich noch einmal. Wenn es weiter fehlschlägt, wende dich an den Zippendo-Support. |

## Siehe auch

* [Zugangsdaten für Versanddienstleister](/docs/de/how-to/carrier-credentials)
* [Unterstützte Versanddienstleister](/docs/de/carriers/supported-carriers)
* [Testmodus](/docs/de/how-to/sandbox-mode)
* [Versandprodukte und Zusatzleistungen](/docs/de/how-to/carrier-products-and-services)
* [Versanddienstleister](/docs/de/tutorials/carriers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.