> ## Documentation Index
> Fetch the complete documentation index at: https://docs.armin.cx/llms.txt
> Use this file to discover all available pages before exploring further.
# 8returns
> Retouren im Posteingang prüfen und mit KI-Agenten anmelden.
Die 8returns-Integration bringt Retourenstatus, zurückgesendete Artikel und Versanddetails in Chatarmin CX. So beantwortet dein Team Retourenfragen direkt im Ticket. KI-Agenten können außerdem eine Retoure anmelden und ein Versandlabel mit Sendungsnummer anfordern.
## Wann du es brauchst
Nutze 8returns, um Fragen wie „Was passiert gerade mit meiner Retoure?“ zu beantworten oder die Artikel anzumelden, die ein Kunde zurücksenden möchte. Dein Team sieht bestehende Retouren im Posteingang; neue Retouren meldest du über KI-Agenten-Aktionen an.
## 8returns einrichten
Du brauchst den **API Key** und das **Password** deiner 8returns-API-Verbindung. Die Integration verlinkt auf die [8returns-Seite für die öffentliche API](https://dashboard.returnsportal.online/integrations/public_api).
[Öffne Integrationen](https://armin.cx/app/_/settings/integrations) in deinen Workspace-Einstellungen und wähle **8returns**.
Wenn 8returns nicht in der Liste steht, frag dein Chatarmin-CX-Team nach der Verfügbarkeit für deinen Workspace.
Klick auf **Connect**, um das Formular zu öffnen. Gib **API Key** und **Password** ein und klick zum Speichern auf **Connect**. cx prüft die Zugangsdaten bei 8returns, bevor die Verbindung gespeichert wird. Nach erfolgreicher Verbindung siehst du **Connected**.
Öffne ein Ticket, dessen Kontakt die E-Mail-Adresse einer bestehenden 8returns-Retoure hat. Klappe die **8returns**-Karte im Kundenpanel auf und prüfe Bestellnummer und Retourenstatus. Diese Abfrage erstellt oder ändert keine Retoure.
## 8returns im Posteingang nutzen
cx sucht Retouren über die **E-Mail-Adresse** des Ticket-Kontakts. Klappe die verbundene 8returns-Karte im Kundenpanel auf. Du siehst:
* Bestellnummer und Retourenstatus
* Artikelnamen und Mengen sowie Retourengründe, wenn vorhanden
* Versanddienstleister und Sendungsnummer, wenn 8returns sie liefert
Wenn eine Label-URL vorhanden ist, öffnet ein Klick auf die Sendungsnummer das **Versandlabel**, nicht die Sendungsverfolgung des Versanddienstleisters. Auch Retouren ohne Tracking-Daten zeigen Status und Artikel. Die Karte zeigt zunächst drei Retouren; über die Schaltfläche darunter blendest du weitere Ergebnisse ein.
Die Karte im Posteingang ist schreibgeschützt. Sie hat keine Schaltfläche zum Anmelden einer
Retoure oder Erstellen eines Labels. Nutze dafür die KI-Agenten-Aktion unten.
| Situation | Was du siehst |
| - | - |
| Kontakt ohne E-Mail | Einen Hinweis, eine E-Mail für die Retourensuche hinzuzufügen |
| Keine passenden Retouren | Einen Hinweis, dass keine 8returns-Retouren für diesen Kunden gefunden wurden |
| Verbindung falsch konfiguriert | Einen Konfigurationsfehler statt einer leeren Retourenliste |
| Abfrage schlägt fehl | Einen Hinweis, dass die 8returns-Retouren nicht geladen werden konnten |
## KI-Agenten-Aktionen
Verbinde zuerst 8returns. [Öffne dann KI-Agenten](https://armin.cx/app/_/ai/agents-v2), wähle deinen Agenten und aktiviere die passenden [Aktionen](/de/ai-agents/skills-and-actions). Wähle die verbundenen 8returns-Konten aus, die der Agent nutzen darf.
### Get 8returns return
Diese Lese-Aktion sucht Retouren per **Bestellnummer** oder **Kunden-E-Mail**. Sie liefert Status, Artikel und verfügbare Versanddetails wie Sendungsnummer, Versanddienstleister und Label-URL. Sie braucht keine menschliche Freigabe.
Nutze die Bestellnummer, wenn der Kunde sie nennt. Ansonsten reicht seine E-Mail, statt nur für die Retourensuche nach einer Bestellnummer zu fragen. Sind beide angegeben, nutzt die Suche die Bestellnummer. Die Abfrage verwendet die ersten 50 Suchergebnisse von 8returns, neueste zuerst, und behält exakte Treffer für Bestellnummer oder E-Mail. Sie ist kein vollständiger Export der Retourenhistorie.
### Create 8returns return
Diese Aktion meldet eine Retoure in 8returns an. Dafür braucht sie:
* die **Bestellnummer des Shops**
* jeden Artikel, den der Kunde zurücksenden möchte, mit **SKU** und **Menge**
* eine ausdrückliche Entscheidung, ob ein Versandlabel erstellt werden soll
Übergib die vollständige gewünschte Artikelliste in einem Aufruf. Die Aktion warnt: Gibt es
bereits eine offene Retoure zur Bestellung, werden nicht mitgesendete Artikel als fehlend
markiert.
Um im selben Aufruf ein Label mit Sendungsnummer anzufordern, hinterlege die Methoden-ID aus deinem 8returns-Dashboard im Feld **Return method ID** der Aktion. Beschreibe in den Agenten-Anweisungen, wann ein Label angefordert werden soll. Die Aktion fordert es mit `generateLabel: true` an.
Für eine Retoure ohne Label nutzt du `generateLabel: false`. Dafür kann **Return method ID** leer bleiben. Fordert der Agent ohne konfigurierte Methoden-ID ein Label an, schlägt die Aktion vor der Retourenanmeldung fehl. Sie meldet nicht stillschweigend eine Retoure ohne Label an.
**Create 8returns return** verlangt standardmäßig eine [menschliche Freigabe](/de/ai-agents/human-in-the-loop). Du kannst die Freigabe an der Aktion anpassen. Lass sie aktiviert, solange du deinen Retourenprozess prüfst.
Die Aktion zeigt keinen Labelpreis an und zieht beim Kunden kein Rückporto ein. Geh nicht davon
aus, dass Labels kostenlos sind. Kläre die Labelkosten separat und gib dem Agenten klare
Anweisungen, wer zahlt und wann er ein Label anfordern darf.
### Ergebnis vor der Antwort prüfen
Eine Retoure kann angemeldet sein, obwohl die Labelanforderung fehlgeschlagen ist. Prüfe die Artikel- und Labelergebnisse, bevor du dem Kunden bestätigst, dass seine Retoure oder sein Label bereit ist. Ein erfolgreiches Labelergebnis enthält Sendungsnummer und Versanddienstleister. Eine Label-URL ist nur vorhanden, wenn 8returns sie liefert.
Die Aktion unterdrückt die automatische Kundenbenachrichtigung von 8returns. Die Retourenanmeldung verschickt also kein Label per E-Mail an den Kunden. Aktiviere eine Antwort-Aktion und beschreibe, wie der Agent das bestätigte Ergebnis mitteilen soll. Fehlt ein nutzbares Label, kann er das Ticket an dein Team übergeben.
## Best Practices
* Gib dem Agenten deine Retourenrichtlinie und Eskalationsregeln. Die Aktion prüft selbst keine Rückgabefrist und erstattet kein Geld.
* Prüfe Bestellnummer, SKUs, Mengen und die vollständige Artikelliste, bevor du eine Retoure freigibst.
* Nutze **Get 8returns return** für eine reine Leseprüfung, bevor du Schreib-Aktionen aktivierst. Erstelle keine echte Retoure nur zum Testen der Verbindung.
* Schlägt die Labelerstellung nach der Anmeldung fehl, prüfe die bestehende Retoure in 8returns vor einem erneuten Versuch. Geh nicht davon aus, dass keine Retoure existiert.
## 8returns trennen
Öffne in den [Integrationen](https://armin.cx/app/_/settings/integrations) das **Connected**-Menü des Kontos. Wähle **Disconnect** und bestätige **Delete**, um die Verbindung zu entfernen. Das storniert keine bestehende Retoure in 8returns.
## Fehlerbehebung
### Verbindung schlägt fehl
Prüfe beide API-Zugangsdaten. Wird die Anmeldung abgelehnt, meldet cx: **"We couldn't connect to 8returns. Please check your API Key and Password."**
### Eine Retoure erscheint nicht
Prüfe, ob die E-Mail des Ticket-Kontakts zur Kunden-E-Mail der Retoure passt und ob du das richtige 8returns-Konto verbunden hast. Nutze die KI-Abfrage per Bestellnummer, um eine bestimmte Bestellung zu prüfen. Im Posteingang ist ohne Kontakt-E-Mail keine Suche möglich.
### Ein Label fehlt
Prüfe, ob der Agent ein Label angefordert hat und ob **Return method ID** konfiguriert ist. Schau dir das Aktionsergebnis an: Die Retoure kann trotz fehlgeschlagenem Label existieren. Eine Sendungsnummer garantiert außerdem keine Label-URL.
Schlägt die Verbindung oder Aktion weiterhin fehl, wende dich mit der Fehlermeldung und dem betroffenen Schritt an dein Chatarmin-CX-Team. Teile dabei weder API Key noch Password.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.