Analysen
Rozetka Seller API: Bestellungen abrufen, wenn es keine Webhooks gibt
Rozetka sendet keine Webhooks und filtert Bestellungen nur nach Datum. So sieht deshalb eine zuverlässige Importschleife aus – und die drei Dinge, die eine naive Umsetzung unbemerkt kaputt machen.
Aktualisiert 11. September 2026
Die meisten Integrationen beginnen mit der Frage, wohin Rozetka seinen Webhook senden wird. Die Antwort: nirgendwohin. Die Seller API von Rozetka ist eine Anfrage-API, keine Ereignis-API: Solange Sie nicht nachfragen, ob es neue Bestellungen gibt, erfahren Sie nichts davon.
Das ändert die gesamte Architektur. Statt eines Endpunkts, der wartet, brauchen Sie eine Schleife, die nach Zeitplan läuft, sich merkt, wo sie beim letzten Mal aufgehört hat, und keine Duplikate erzeugt, wenn derselbe Lauf zweimal stattfindet. Unten steht der Vertrag, wie er sich tatsächlich verhält, und die drei Stellen, an denen eine naive Umsetzung unbemerkt Bestellungen verliert.
Der Vertrag: was Sie vor der ersten Anfrage wissen sollten
Die folgenden Werte stammen aus der offiziellen Dokumentation der Seller API. Der Obriym-CRM-Adapter ist nach diesem Vertrag gebaut; Status: Beta.
- Basis
- api-seller.rozetka.com.ua – ein eigener Host, getrennt von der öffentlichen Website
- Authentifizierung
- POST /sites mit dem Login des Verkäufers und dem Base64-codierten Passwort. Die Antwort enthält ein Token, das etwa 24 Stunden gültig ist.
- Bestellungen lesen
- GET /orders/search – immer mit erweiterten Positionen, Lieferung und Käufer, sonst kommt die Bestellung weder mit Produkten noch mit Adresse an
- Zeitfilter
- Nach DATUM, nicht nach Uhrzeit. Der Vertrag bietet keine Genauigkeit „seit dieser Minute“.
- Positionen
- Ein Array von Käufen innerhalb der Bestellung; eine als gelöscht markierte Zeile ist in der Antwort enthalten und muss übersprungen werden
- Status
- Numerisch und abhängig von der Konfiguration des jeweiligen Kontos – keine universelle Liste
- Status schreiben
- PUT /orders/{id} – nach dem Login, mit demselben Token
- Produkte
- GET /items/search zum Lesen; PUT /items/update-price-stock/{id} für Preis und Bestand. Ein Angebot über die API anzulegen ist nicht möglich.
- Währung
- Hrywnja
Die Importschleife
Login und Token
Tauschen Sie Login und Passwort gegen ein Token. Cachen Sie es: Ein Login bei jeder Anfrage erhöht die Latenz und erzeugt unnötiges Rauschen im eigenen Audit-Trail des Marktplatzes.
Cursor lesen
Rufen Sie das gespeicherte Datum des letzten erfolgreichen Laufs ab. Beim allerersten Lauf gehen Sie einen Tag zurück, nicht „die gesamte Zeit“: Den gesamten Verlauf im ersten Lauf zu importieren ist der schnellste Weg zu einem Timeout und einem undurchsichtigen Teilzustand.
Mit Überlappung abfragen
Fragen Sie nach Bestellungen, die seit dem Cursor-Datum MINUS einem Tag geändert wurden. Die Überlappung ist keine Paranoia – sie folgt direkt aus dem reinen Datumsfilter (unten erläutert).
Normalisieren
Bilden Sie die Antwort mit einer reinen Funktion ohne Nebenwirkungen auf Ihr eigenes Bestellmodell ab: So lässt sie sich ganz ohne Netzwerkaufruf gegen eine gespeicherte Payload testen.
Idempotentes Schreiben
Legen Sie die Bestellung unter einem Schlüssel an, der aus der Rozetka-Bestell-ID gebildet wird. Ein wiederholter Lauf erzeugt keine zweite Bestellung – er findet die vorhandene.
Anreicherung
Aktualisieren Sie bei jedem Durchlauf, nicht nur bei der Anlage, Status, Zahlung, Liefermethode und Versandscheinnummer, sobald Rozetka sie liefert.
Cursor schreiben
Und den Cursor erst nach einem erfolgreichen Durchlauf weiterschieben. Ein Cursor, der vor der Verarbeitung vorrückt, verliert genau die Bestellungen, bei denen der Lauf gescheitert ist.
Warum ein täglicher Cursor eine Überlappung braucht
Der Filter „seit Datum X geändert“ hat keine Zeitkomponente. Das heißt, Sie können nicht fragen, was sich in den letzten 15 Minuten geändert hat – nur, was sich heute geändert hat.
Daraus folgt das Problem der Mitternachtsgrenze. Ein Lauf um 23:58 sieht die heutigen Bestellungen und schreibt den Cursor als „heute“. Ein Lauf um 00:03 fragt nach Bestellungen, die seit „heute“ geändert wurden – aber heute ist inzwischen ein anderes Datum, und eine um 23:59 angelegte Bestellung fällt in keine der beiden Abfragen. Sie verschwindet einfach, und das Schlimmste ist, dass nichts fehlschlägt: Die Logs sind sauber, die Zähler grün, und die Bestellung ist nicht da.
Die Abhilfe ist billig: immer ab dem Cursor-Datum minus einem Tag abfragen. Sie lesen jedes Mal bis zu einen Tag bereits bekannter Bestellungen erneut – und genau deshalb ist der vorherige Schritt, die Idempotenz, zwingend und nicht nur wünschenswert. Ohne sie würde die Überlappung täglich Duplikate erzeugen; mit ihr ist die Überlappung kostenlos.
Drei Dinge, die eine naive Umsetzung kaputt machen
- Eine als gelöscht markierte Position kommt in der Antwort neben den aktiven an. Überspringen Sie sie, sonst entsteht eine Bestellung mit einem Produkt, das der Käufer nie gekauft hat, und einer Summe, die nicht zum Konto passt.
- Numerische Status sind nicht universell: Dieselben Zahlen können in verschiedenen Konten verschiedene Zustände bedeuten. Die Zuordnung der Status gehört deshalb in EINEN ausdrücklichen Block, den Sie sehen und prüfen können, nicht als verstreute Konstanten in den Code. Und ein Übergang, bei dem Sie unsicher sind, wird besser nicht gesendet als geraten.
- Der Übergang in die Lieferung erfordert einen Versandschein. „Versendet“ ohne Versandscheinnummer zu setzen ist kein Zustand, in den Rozetka die Bestellung aufnimmt, daher sollte dieser Übergang nicht Teil einer automatischen Rücksynchronisierung sein.
Preise und Bestand: nur das bereits Veröffentlichte
Das Aktualisieren von Preis und Menge funktioniert über die SKU: Das Feld „Artikel“ des Rozetka-Angebots wird mit der Produkt-SKU in Ihrem System abgeglichen. Daraus folgen zwei Dinge. Erstens zählt SKU-Disziplin mehr als jeder Code: Ein Produkt ohne SKU oder eines, das sich durch Groß-/Kleinschreibung oder ein überzähliges Leerzeichen unterscheidet, wird nicht zugeordnet. Zweitens aktualisiert die API nur bestehende Angebote; sie kann kein Produkt anlegen, daher bleibt das Veröffentlichen einer neuen Position eine Aktion im Verkäuferkonto.
Die Menge sollte nur für Produkte gesendet werden, bei denen Sie den Bestand wirklich führen. Ein Produkt auf Bestellung sollte nicht allein deshalb die Menge null erhalten, weil sein Bestandsfeld leer ist – das nimmt es ohne jeden Grund aus dem Verkauf.
Jeder Schreibzugriff auf ein fremdes Konto ist standardmäßig ausgeschaltet
Ein Verkäufer kommt mit Produkten, die bereits auf dem Marktplatz liegen. Das Lesen lässt sich daher sofort einschalten, während jedes Schreiben – Preise, Bestand, Status – auf einen Probelauf wartet, der genau zeigt, was sich ändern würde, ohne etwas zu ändern. Das ist keine Paranoia: Eine einzige fehlerhafte Preisübertragung für den ganzen Live-Katalog kostet mehr als die gesamte Integration.
Häufig gestellte Fragen
Hat Rozetka Webhooks für Bestellungen?
Nein. Die Seller API beantwortet Anfragen, sendet aber keine Ereignisse, daher lassen sich neue Bestellungen nur durch regelmäßiges Abfragen erfassen. Ein praktikables Intervall sind 15 Minuten: Häufiger bringt wegen des reinen Datumsfilters nichts, seltener fällt einem Manager auf.
Wie lange ist ein Token der Seller API gültig?
Etwa einen Tag. Melden Sie sich bei Bedarf an – wenn kein Token vorhanden ist oder es nicht mehr akzeptiert wird – statt bei jedem Aufruf.
Warum ist das Passwort Base64-codiert?
Das schreibt der Login-Vertrag vor. Es ist eine Codierung, keine Verschlüsselung: Das Passwort muss bei Ihnen trotzdem verschlüsselt gespeichert werden, und der Austausch muss über HTTPS erfolgen.
Kann man über die API ein Produkt auf Rozetka anlegen?
Nein. Die API kann bestehende Angebote lesen und deren Preis und Bestand aktualisieren. Eine neue Position wird im Verkäuferkonto angelegt.
Wie vermeide ich doppelte Bestellungen bei einem wiederholten Lauf?
Mit einem Idempotenzschlüssel, der aus der Rozetka-Bestell-ID gebildet und beim Schreiben in die Datenbank erzwungen wird. Das ist eine Voraussetzung, keine Optimierung: Die Cursor-Überlappung liest bekannte Bestellungen jeden Tag erneut.
Brauche ich einen separaten Worker?
In Obriym CRM nein: Das Abfragen ist eingebaut und läuft nach Zeitplan auf der CRM-Seite, der Verkäufer muss also nur sein Login für das Verkäuferkonto speichern. Wenn Sie die Integration selbst bauen, brauchen Sie einen Worker – und die obige Schleife ist dafür geschrieben.
Möchten Sie das lieber nicht selbst bauen?
In Obriym CRM gibt es die Abfrageschleife, die Idempotenz, die Anreicherung der Status und die Rücksynchronisierung bereits – Sie speichern nur Ihr Login für das Rozetka-Konto. Beta: Die Verbindung ist bereits heute möglich; die Funktionen des Kanals werden noch ausgebaut.
Kostenlos testen