OTTO Retouren-API 2026: Rücksendungen automatisch verfolgen
Die OTTO Return-Shipments-API liefert Status zu angekündigten Rücksendungen. So binden Sie sie an und schließen die Lücke zur eigentlichen Retourenbearbeitung.
Die Kurzfassung: OTTOs Return-Shipments-API liefert Informationen zu Rücksendungen, die Kunden im OTTO-Marktplace angekündigt haben, inklusive drei Status: ANGEKÜNDIGT, UNTERWEGS und ZUGESTELLT. Die API deckt ausschließlich den Transportweg der Rücksendung ab, nicht die eigentliche Retourenbearbeitung wie Annahme oder Erstattung. Abfragen laufen über drei Endpunkte, nach Tracking-Nummer, nach Rücksendungs-ID oder als paginierte Liste, mit einem Standardlimit von 25 Ergebnissen pro Abruf.
Für Sie als Händler ist diese Einordnung wichtig, weil die API Transparenz über den physischen Rückweg schafft, aber die eigentliche Entscheidung über Annahme, Ablehnung oder Erstattung weiterhin in Ihrem eigenen Prozess liegt. Dieser Leitfaden erklärt die Endpunkte im Detail, zeigt einen sinnvollen Abfrage-Workflow und wie MarketplAIce die Lücke zur vollständigen Retourenautomatisierung schließt.
Die drei Endpunkte der Return-Shipments-API im Detail
Der erste Endpunkt ruft eine einzelne Rücksendung anhand von Carrier und Tracking-Nummer ab und findet dabei nur Sendungen, die in den letzten 30 bis 42 Tagen angekündigt wurden, je nach Paketdienstleister. Die Tracking-Nummer ist bei Paketsendungen Pflicht, bei Speditionssendungen optional.
Der zweite Endpunkt ruft eine Rücksendung anhand ihrer Rücksendungs-ID ab und deckt dabei einen deutlich längeren Zeitraum ab, nämlich Rücksendungen der vergangenen zwölf Monate. Der dritte Endpunkt liefert eine paginierte Liste aller Rücksendungen, gefiltert über einen Zeitstempel-Parameter, der Sendungen ab einem bestimmten Ankündigungs- oder Aktualisierungsdatum zurückgibt, mit einem Cursor für die nächste Ergebnisseite.
Die drei verfügbaren Status sind bewusst einfach gehalten: ANGEKÜNDIGT bedeutet, dass der Kunde die Rücksendung im Marketplace angemeldet hat, UNTERWEGS bedeutet die Übergabe an den Paketdienstleister, und ZUGESTELLT kann sowohl die Zustellung an Sie als auch die Ankunft an einem Verteilzentrum oder Paketshop bedeuten. OTTO selbst erhält nicht immer den finalen Zustellstatus, sodass eine als ZUGESTELLT markierte Sendung noch einige Tage bis zum tatsächlichen Eingang bei Ihnen benötigen kann.
Was die API nicht abdeckt und warum das wichtig ist
Die Dokumentation macht explizit klar, dass die API keine weiteren Informationen zur Retourenbearbeitung liefert. Ob eine Rücksendung angenommen wurde, ob der Artikelzustand den Erwartungen entspricht oder ob eine Erstattung ausgelöst wurde, bleibt außerhalb des Funktionsumfangs dieser Schnittstelle.
Für Ihren eigenen Prozess bedeutet das: Die Return-Shipments-API eignet sich ausschließlich für die Transportüberwachung, nicht als vollständige Retouren-Workflow-Lösung. Sie wissen über die API, dass eine Rücksendung unterwegs ist und wann sie voraussichtlich bei Ihnen eintrifft, aber nicht, in welchem Zustand der Artikel ankommt oder ob eine Erstattung bereits ausgelöst wurde.
Diese Lücke müssen Sie mit eigenen Prozessen schließen, etwa einer Wareneingangsprüfung, die den Artikelzustand dokumentiert, und einer separaten Erstattungslogik in Ihrem ERP oder Shopsystem. Wie sich eine hohe Retourenquote zusätzlich auf Zahlungsmethoden und Kontostatus auswirken kann, zeigt der Beitrag zu Otto Retourenquote, Zahlarten und Sperrung, der die Konsequenzen einer unkontrollierten Retourenquote im Detail behandelt.
In 5 Schritten: Die Return-Shipments-API sinnvoll einbinden
Ein strukturierter Abfrage-Workflow verhindert, dass Sie entweder zu selten oder mit unnötig hoher Frequenz abfragen.
- Richten Sie einen regelmäßigen Abruf der Listen-Endpunkt mit dem Zeitstempel-Parameter ein, um nur neue oder aktualisierte Rücksendungen seit der letzten Abfrage zu erhalten.
- Verfolgen Sie den Cursor für die nächste Ergebnisseite konsequent, damit bei hohem Rücksendungsvolumen keine Einträge übersprungen werden.
- Mappen Sie die drei API-Status auf Ihre eigenen internen Workflow-Stufen, etwa "erwartet", "im Transit" und "physisch eingetroffen, Prüfung ausstehend".
- Ergänzen Sie den ZUGESTELLT-Status um einen internen Puffer von einigen Tagen, bevor Sie eine Rücksendung als überfällig markieren, da OTTO nicht immer den finalen Zustellstatus erhält.
- Verknüpfen Sie die über die API erhaltene Rücksendungs-ID mit Ihrer eigenen Wareneingangsprüfung, damit Transportstatus und tatsächliche Bearbeitung in einem System zusammenlaufen, statt in zwei getrennten Tabellen gepflegt zu werden.
Der vierte Schritt wird häufig unterschätzt. Ohne diesen Puffer entstehen unnötige interne Eskalationen bei Rücksendungen, die laut API bereits zugestellt sind, aber in Wahrheit erst in einem Verteilzentrum liegen.
Wie MarketplAIce die Lücke zur vollständigen Retourenautomatisierung schließt
Die Return-Shipments-API liefert wertvolle, aber isolierte Transportdaten. Für eine vollständige Steuerung braucht es die Verknüpfung mit Bestand, Kosten und Retourenquote über alle Marktplätze hinweg, nicht nur für OTTO.
MarketplAIce verbindet Retourendaten mit Bestands- und Preissignalen über 15 Dimensionen und erkennt dadurch frühzeitig, wenn eine steigende Rücksendungsquote bei einem bestimmten Produkt auf ein strukturelles Problem hindeutet, etwa eine ungenaue Produktbeschreibung oder eine falsche Größentabelle. Das geschieht kanalübergreifend, sodass sich ein Muster, das sich zuerst auf Otto zeigt, auch für Amazon, Kaufland, Temu und eBay prüfen lässt, bevor es sich dort wiederholt.
Für Agenturen mit mehreren OTTO-Partnerkonten reduziert das den Aufwand, Retourendaten für jeden Mandanten einzeln auszuwerten, weil Auffälligkeiten automatisch markiert statt manuell durchsucht werden.
Wenn Sie prüfen möchten, wie sich Ihre eigenen Rücksendungsmuster über die Marktplätze hinweg auswerten lassen, testen Sie MarketplAIce 14 Tage kostenlos: Jetzt registrieren. Welcher Tarif zu Ihrem Retourenvolumen passt, zeigt die Preisübersicht.
Was Sie diese Woche tun können
Prüfen Sie zuerst, ob Ihr aktueller Retourenprozess überhaupt auf API-Daten zugreift oder ob Sie Rücksendungen noch manuell im Partner-Connect-Interface nachschlagen. Letzteres ist bei wachsendem Volumen der größte Zeitfresser im Backoffice.
Legen Sie danach fest, welcher interne Puffer nach einem ZUGESTELLT-Status sinnvoll ist, bevor eine Rücksendung als überfällig gilt. Das verhindert unnötige interne Nachfragen bei Sendungen, die laut OTTO zwar zugestellt sind, aber real erst unterwegs zu Ihnen.
Wenn Sie mehrere Marktplätze parallel betreiben, lohnt sich frühzeitig die Frage, ob eine kanalübergreifende Retourenauswertung nicht ohnehin aussagekräftiger ist als eine isolierte OTTO-Betrachtung.
FAQ
Welche Status liefert die OTTO Return-Shipments-API?
Drei Status: ANGEKÜNDIGT, wenn der Kunde die Rücksendung angemeldet hat, UNTERWEGS nach Übergabe an den Paketdienstleister, und ZUGESTELLT, was sowohl die Zustellung an Sie als auch die Ankunft an einem Verteilzentrum bedeuten kann.
Erfährt man über die API, ob eine Rücksendung angenommen oder erstattet wurde?
Nein, die Dokumentation sagt ausdrücklich, dass die API keine weiteren Informationen zur Retourenbearbeitung liefert. Annahme, Artikelzustand und Erstattung müssen Sie über eigene Prozesse abbilden.
Wie weit zurück kann ich Rücksendungen über die API abrufen?
Über die Tracking-Nummer finden Sie Rücksendungen der letzten 30 bis 42 Tage, je nach Paketdienstleister. Über die Rücksendungs-ID lassen sich Rücksendungen der vergangenen zwölf Monate abrufen.
Ist die Tracking-Nummer bei jeder Rücksendung Pflicht?
Bei Paketsendungen ist die Tracking-Nummer Pflicht, bei Speditionssendungen ist sie optional. Das sollten Sie bei der Gestaltung Ihres Abfrage-Workflows berücksichtigen.
Wie viele Ergebnisse liefert die Listen-Abfrage pro Aufruf?
Standardmäßig 25 Ergebnisse pro Abruf. Über den Cursor-Parameter für die nächste Seite lassen sich weitere Ergebnisse paginiert abrufen.
Warum sollte ich nach einem ZUGESTELLT-Status noch einen internen Puffer einplanen?
Weil OTTO nicht immer den finalen Zustellstatus erhält. Eine als ZUGESTELLT markierte Sendung kann tatsächlich erst an einem Verteilzentrum oder Paketshop angekommen sein und noch einige Tage bis zum physischen Eingang bei Ihnen benötigen.
Wie ergänzt MarketplAIce die reinen Transportdaten der API?
MarketplAIce verknüpft die Rücksendungsdaten mit Bestands- und Preissignalen über 15 Dimensionen und erkennt kanalübergreifend, wenn eine steigende Retourenquote auf ein strukturelles Produktproblem hindeutet, statt nur den Transportstatus einzelner Sendungen zu zeigen.
Über den Autor
Jorginho Engelmeyer ist Founder von MarketplAIce und seit über acht Jahren im Amazon- und Marktplatz-Advertising tätig. Mehr zu seinem Hintergrund finden Sie auf der Expertise-Seite.