Marktplätze: Retouren
marktplatz_retouren
Was das Tool macht
Listet die Retouren auf den verbundenen Marktplätzen (nur wo der Betreiber das Retourenmodul nutzt): Status (wartet auf deine Annahme, unterwegs, eingegangen, abgeschlossen, abgelehnt, storniert, nicht angekommen), Grund je Position, Rückweg (Post, Abgabestelle, Abholung, ohne Rücksendung), Paketdienst und Trackingnummer der Rücksendung, Prüfergebnis und je Position Artikel und bereits erstatteter Betrag. Standard: offene Retouren (wartet auf Annahme, unterwegs, eingegangen). Mit nurErstattungOffen nur eingegangene Retouren ohne Erstattung. Abgleich mit JTL-Retouren: marktplatz_abgleich_jtl. Nur Lesezugriff.
Eingaben
| marktplatzoptional | Name des Marktplatzes; ohne Angabe alle verbundenen |
| statusoptional | offen (Standard), wartet_auf_annahme, unterwegs, eingegangen, abgeschlossen, abgelehnt_storniert_verloren |
| seitTagenoptional | Nur Retouren, die in den letzten X Tagen geändert wurden (für abgeschlossene, Standard 30) |
| bestellnummeroptional | Nur Retouren zu dieser Bestellnummer des Marktplatzes |
| nurErstattungOffenoptional | true = nur eingegangene Retouren, für die noch nichts erstattet wurde |
| limitoptional | Maximale Anzahl, Standard 20 |
Die Eingaben füllt die KI aus deiner Frage. Du musst dir keine Parameternamen merken.
So wird gerechnet
Der Rechenweg in der Reihenfolge, in der das Tool arbeitet: Abruf, Filter, Berechnung, Ausgabe. Aus dem Tool-Code abgeleitet, damit nachvollziehbar ist, warum eine Zahl so ist. Dieselbe Auskunft liefert das Tool kiuser_tool_logik direkt im KI-Chat.
- 1Prüft im Profil, ob der Marktplatz das Retourenmodul nutzt; sonst Hinweis statt Abruf.
- 2Liest die Retouren über die Mirakl Seller API (RT11) mit dem Shop-API-Key - Standard: offene (wartet auf Annahme, unterwegs, eingegangen) unabhängig vom Alter; abgeschlossene und abgelehnte nur aus den letzten seitTagen Tagen (Standard 30). Höchstens vier Seiten.
- 3Holt die zugehörigen Bestellungen (OR11) für Artikel, SKU und Preis je Position und die bereits erstatteten Beträge.
- 4Übersetzt Status, Grund je Position (19 Standardgründe), Rückweg und Ablehnungsgrund (Originalcode in Klammern); zeigt Paketdienst und Trackingnummer der Rücksendung und das Prüfergebnis.
- 5Sortierung: wartet auf Annahme, dann eingegangen, dann unterwegs, jeweils älteste zuerst. nurErstattungOffen behält eingegangene Retouren, bei denen keine Position einen Erstattungsbetrag hat.
Annahmen und Grenzen
- Nur Marktplätze mit Retourenmodul; führt der Marktplatz Retouren selbst (z.B. über seinen Kundenservice), liefert die Schnittstelle keine.
- Nur Lesezugriff: Annehmen, als eingegangen markieren und erstatten laufen im Seller-Backoffice bzw. über JTL.
- Die Adresse wird nur mit PLZ, Ort und Land ausgegeben.
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.