Obriym CRMObriym CRMCustomer flow workspace
KIFunktionenErste SchrittePreiseRoadmapIntegrationenBlog
DE
  • ukUkrainisch
  • enEnglisch
  • itItalienisch
  • deDeutsch
  • frFrançais
AnmeldenJetzt starten
KIFunktionenErste SchrittePreiseRoadmapIntegrationenBlogAnmeldenJetzt starten
Blog

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.

16. August 2026Aktualisiert 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

  1. 1

    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.

  2. 2

    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.

  3. 3

    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).

  4. 4

    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.

  5. 5

    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.

  6. 6

    Anreicherung

    Aktualisieren Sie bei jedem Durchlauf, nicht nur bei der Anlage, Status, Zahlung, Liefermethode und Versandscheinnummer, sobald Rozetka sie liefert.

  7. 7

    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

Mehr erfahren

Erwähnte Integrationen

  • Rozetka

    Beta

    Der größte Marktplatz der Ukraine: Bestellungen kommen von selbst ins CRM, Status und Bestand gehen zurück ins Verkäuferkonto, und Käuferfragen werden zu Leads mit einem Verantwortlichen und einem nächsten Schritt.

    Mehr erfahren
  • Prom.ua

    Verfügbar

    Bestellungen, Zahlungen und Lieferung kommen von selbst an. Käuferfragen werden zu Leads, die Sie direkt im CRM beantworten, ohne das Prom-Konto zu öffnen.

    Mehr erfahren
  • Nova Poshta

    Verfügbar

    Kein Wechsel in das Kundenkonto des Versanddienstleisters: Der Versandschein wird im CRM erstellt, und die Lieferstatus aktualisieren sich von selbst.

    Mehr erfahren

Beta: Beta: Die Verbindung ist bereits heute möglich; die Funktionen des Kanals werden noch ausgebaut.

Jetzt starten

Starten Sie mit einer echten Bestellung, nicht mit Demodaten.

Registrieren Sie sich, und Ihr Arbeitsbereich wird automatisch erstellt. Verbinden Sie einen Vertriebskanal, legen Sie ein Produkt an und nehmen Sie Ihre erste Bestellung oder Anfrage entgegen – das CRM zeigt Ihnen den nächsten Schritt selbst.

Kostenlos startenSo starten Sie, Schritt für Schritt
Obriym CRMObriym CRMCustomer flow workspace

Obriym CRM ist ein fokussierter Arbeitsbereich für Vertriebsteams und E-Commerce-Abläufe. Leads, Verkaufschancen, Bestellungen und Kundenbindung an einem Ort.

Ein Produkt von OBRIYM

  • crm@obriym.com
  • OBRIYM
  • Serhii Oberemchuk

Individual Entrepreneur Oberemchuk Serhii Oleksandrovych · Staatsregister 178752761226

Produkt

  • CRM für den Handel
  • KI
  • Funktionen
  • Erste Schritte
  • Preise
  • Vergleich
  • Blog
  • Roadmap
  • Integrationen
  • API-Referenz

Unternehmen

  • Über OBRIYM
  • Gründer
  • Kontakt
  • Roadmap

Entwickler

  • Für Entwickler
  • OpenAPI-Spezifikation
  • JS-Widget
  • API zur Lead-Erfassung
  • Bestell-API

©2026Obriym CRM von OBRIYM. Entwickelt für den produktiven Einsatz in Vertrieb und E-Commerce.

NutzungsbedingungenLeistungsbedingungenZahlung und RückerstattungenDatenschutzerklärungUnterauftragsverarbeiterDatenverarbeitungAnbieterangabenDatenlöschungPreiseAPI-Dokumentation