Marktplatz · Rozetka
Rozetka – Bestellungen, Status und Bestand in einem CRM
BetaBeta: Die Verbindung ist bereits heute möglich; die Funktionen des Kanals werden noch ausgebaut.
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.
Login → token → order status update
Was der Adapter leistet
Bestellungen alle 15 Minuten
Das CRM fragt die Seller-API nach einem Zeitplan ab und legt die Bestellungen an. Ein wiederholter Lauf dupliziert nie, was bereits existiert – der Idempotenzschlüssel wird aus der Rozetka-Bestell-ID gebildet.
Zahlung und Lieferung direkt an der Bestellung
Bei jedem Durchlauf werden Status, Zahlungsmethode, Liefermethode und Versandschein-Nummer aktualisiert, sobald Rozetka sie zurückgibt.
Status zurück ins Konto
Ein Manager ändert den Status im CRM, der Adapter meldet sich bei der Seller-API an und aktualisiert die Bestellung auf Rozetka-Seite. Ein mehrdeutiger Übergang wird gar nicht geschrieben.
Rozetka-Produkte in den Katalog
Veröffentlichte Angebote werden übernommen: Eine vorhandene SKU wird verknüpft, eine unbekannte wird zu einem Entwurf in der Prüfwarteschlange – nichts landet ohne Ihre Entscheidung in Ihrem Katalog.
Veröffentlichung über eine Preisdatei
Die Rozetka-API kann kein Produkt anlegen – die Preisdatei kann es. Das CRM stellt eine solche Datei unter einem dauerhaften Link bereit, Sie hinterlegen diesen Link einmal in Ihrem Konto, und danach gelangen neue Katalogprodukte von selbst zu Rozetka und durchlaufen die Moderation.
Bereitschaft vor dem Senden
Rozetka verlangt Name, Preis, Foto, Marke und Merkmale und meldet eine Ablehnung erst Stunden später, ohne das Produkt zu nennen. Das CRM prüft das lokal nach den eigenen Regeln von Rozetka: eine Liste dessen, was nicht übertragen wird, jeweils mit dem Produkt verknüpft.
Preise und Bestand zurück zu Rozetka
Das CRM aktualisiert stündlich Preis und Menge bereits vorhandener Angebote. Die Menge wird nur für Produkte gesendet, bei denen Sie den Bestand tatsächlich führen.
Käuferfragen werden zu Leads
Derselbe Durchlauf sammelt Nachrichten von Produktseiten und legt einen Lead mit der Quelle „Rozetka“ an, mit einem Verantwortlichen und einem nächsten Schritt.
Technische Details
- API-Basis
- api-seller.rozetka.com.ua
- Authentifizierung
- Verkäufer-Login + Passwort → ein 24-Stunden-Token. Zugangsdaten werden verschlüsselt gespeichert.
- Bestellungen lesen
- GET /orders/search mit ausgeklappten Positionen, Lieferung und Käufer
- Cursor
- Rozetka filtert Bestellungen nur nach Datum, daher ist der Cursor tageweise und jeder Durchlauf liest einen zusätzlichen Tag erneut – so geht eine Bestellung an der Mitternachtsgrenze nie verloren
- Status schreiben
- PUT /orders/{id} nach der Anmeldung
- Preise und Bestand
- PUT /items/update-price-stock/{id} – Abgleich per SKU (article = SKU)
- Produkte veröffentlichen
- Eine XML-Preisdatei (yml_catalog) unter einem dauerhaften Link, den Rozetka selbst abruft; die Angebots-ID leitet sich von der CRM-Produkt-ID ab und ändert sich nie, und der Artikel entspricht der SKU
- Kategorien
- Ihr eigener Kategoriebaum mit rz_id – der Verknüpfung zu einer Rozetka-Kategorie; Vorschläge stammen nach einem Import aus Angeboten, die Sie dort bereits haben
- Währung
- Hrywnja. Ein Produkt mit Preis in einer anderen Währung wird übersprungen, statt zu einem erfundenen Kurs umgerechnet zu werden.
- Zeitplan
- Bestellungen und Nachrichten alle 15 Minuten, Preis und Bestand, sobald sie sich im CRM ändern, mit einem vollständigen Abgleich alle 6 Stunden, dazu eine manuelle Schaltfläche „Jetzt synchronisieren“
Status-Zuordnung CRM → Rozetka
Lieferung und Versandschein
- Liefermethode und Versandschein-Nummer gelangen von Rozetka in den Sendungsblock der Bestellung – bei jedem Durchlauf, nicht nur einmal bei der Erstellung.
- Wenn Sie selbst versenden, kann direkt aus der CRM-Bestellung ein Nova-Poshta-Versandschein erstellt werden, wobei Adresse und Empfänger aus den Daten des Käufers übernommen werden.
- Selbstabholung ist eine vollwertige Liefermethode und kein Freitextfeld: Sie hat keinen Versanddienstleister und keine Sendungsnummer und wird in der Bestellung als „Selbstabholung“ angezeigt.
- Ein Lieferstatus überschreibt nie den Bestellstatus: Sobald ein Manager den Status von Hand setzt, behandelt das CRM ihn als maßgeblich, und der Poller überschreibt ihn nicht.
Keine Schreibrichtung ist standardmäßig aktiviert
Sie kommen mit Produkten, die bereits im CRM und bei Rozetka existieren. Das Lesen funktioniert daher sofort, während jede Schreibrichtung – Preise, Bestand, Status, Veröffentlichung über die Preisdatei – vom Inhaber separat aktiviert wird, und zwar erst nach einem Probelauf, der genau zeigt, was sich ändern würde, ohne etwas zu ändern. Die Veröffentlichung hat einen eigenen Probelauf: Er nennt jedes Produkt, das es nicht in die Datei schaffen würde, und den Grund. Eine leere Preisdatei wird nie ausgeliefert – sie könnte Ihre Angebote offline nehmen. Der Adapter löscht oder archiviert nie Produkte, weder im CRM noch auf dem Marktplatz.
Einrichtung
- 1
Rozetka-Adapter hinzufügen
Einstellungen → Integrationen → Plattform-Adapter. Im ersten Schritt wird nur ein Name abgefragt.
- 2
Verkäufer-Login einfügen
Login und Passwort Ihres Seller-API-Kontos. Klicken Sie auf „Verbindung testen“ – das CRM führt eine echte Anmeldung durch und meldet, ob der Zugriff auf Bestellungen funktioniert.
- 3
Gewünschte Richtungen aktivieren
Bestellungen laufen von selbst ein. Der Probelauf zeigt, was mit Preisen und Bestand passieren würde – und erst danach schalten Sie das Schreiben ein.
- 4
Preisdatei verbinden, wenn Sie aus dem CRM veröffentlichen
Kopieren Sie den Link zur Preisdatei von der Adapterseite und fügen Sie ihn im Rozetka-Konto als Ihre XML-Preisdatei hinzu. Die Kategorien der Preisdatei werden dort Rozetka-Kategorien zugeordnet – ohne diese Zuordnung werden Produkte nicht veröffentlicht.
Häufige Fragen
- Wie verbinde ich Rozetka mit dem CRM?
- Fügen Sie unter Einstellungen → Integrationen den Rozetka-Adapter hinzu, tragen Sie Login und Passwort Ihres Seller-API-Kontos ein und klicken Sie auf „Verbindung testen“. Sobald der Test besteht, treffen Bestellungen von selbst ein – ohne Worker und ohne Code auf Ihrer Seite.
- Brauche ich einen Entwickler?
- Nein. Rozetka abzufragen, Bestellungen abzugleichen und Status zu aktualisieren, ist Aufgabe des CRM. Einen Entwickler brauchen Sie nur, wenn Sie aus Ihrem eigenen System ins CRM schreiben möchten – dafür gibt es eine öffentliche REST-API.
- Wie schnell erscheint eine Rozetka-Bestellung im CRM?
- Innerhalb von 15 Minuten: Rozetka sendet keine Webhooks, daher fragt das CRM die Seller-API nach einem Zeitplan ab. Das ist ein Kompromiss der Plattform und nicht unsere Wahl – deshalb ist der Zeitpunkt der letzten erfolgreichen Abfrage in der Oberfläche sichtbar.
- Werden Lieferung und Versandschein-Nummer übernommen?
- Ja. Liefermethode und Versandschein-Nummer gelangen von Rozetka in den Sendungsblock der Bestellung und werden bei jedem Durchlauf aktualisiert. Wenn Sie selbst versenden, kann direkt aus der Bestellung ein Nova-Poshta-Versandschein erstellt werden.
- Kann ich Preise und Bestand aus dem CRM verwalten?
- Ja. Für Angebote, die auf Rozetka bereits existieren, ordnet das CRM sie per SKU zu und sendet einen neuen Preis oder eine neue Menge, sobald sie sich im CRM ändert; alle 6 Stunden erfolgt ein vollständiger Abgleich jedes Angebots. Neue Produkte gehen über die Preisdatei: Die Rozetka-API kann kein Angebot anlegen, daher stellt das CRM Ihren Katalog als XML-Preisdatei unter einem Link bereit, den Sie einmal im Konto verbinden, und Rozetka legt die Produkte daraus an.
- Kann ich ein neues Produkt aus dem CRM bei Rozetka veröffentlichen?
- Ja – über die Preisdatei. Die Seller-API von Rozetka kann keine Produkte anlegen (sie aktualisiert nur Preis und Bestand eines bereits vorhandenen Artikels), daher stellt das CRM Ihren Katalog als XML-Preisdatei unter einem dauerhaften Link bereit. Der Inhaber aktiviert diese Richtung nach einem Probelauf und fügt den Link im Rozetka-Konto ein; von da an gelangen neue Produkte von selbst dorthin und durchlaufen die Moderation von Rozetka wie jedes andere Verkäuferprodukt.
- Was passiert mit meinem Katalog beim ersten Import?
- Nichts ohne Ihre Entscheidung. Ein Produkt, dessen SKU das CRM bereits kennt, wird einfach mit dem Angebot verknüpft. Ein unbekanntes Produkt wird zu einem Entwurf in der Prüfwarteschlange, wo Sie es entweder aktivieren oder mit einer bestehenden Karte zusammenführen.
- Kann ich Rozetka-Käufern aus dem CRM antworten?
- Fragen von Produktseiten werden zu CRM-Leads mit Verlauf und einem zugewiesenen Manager. Antworten schreiben Sie weiterhin im Rozetka-Konto – der Chat in beide Richtungen ist für diesen Kanal noch nicht geöffnet.
- Ist das dasselbe Muster wie bei Prom?
- Der Bestelleingang ist gemeinsam – beide Marktplätze werden nach Zeitplan abgefragt und laufen durch dieselbe Schicht für den Bestelleingang, sodass Idempotenz und Bestandsbuchungen sich identisch verhalten. Das Schreiben ist separat gegen die Seller-API von Rozetka gebaut: Wir entnehmen den Vertrag jeder Plattform ihrer eigenen offiziellen Dokumentation, nie einem anderen Adapter.
Mehr erfahren
Häufig gemeinsam verbunden
Prom.ua
VerfügbarBestellungen, 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 erfahrenNova Poshta
VerfügbarKein Wechsel in das Kundenkonto des Versanddienstleisters: Der Versandschein wird im CRM erstellt, und die Lieferstatus aktualisieren sich von selbst.
Mehr erfahrenMonobank
BetaDer Käufer bezahlt eine Rechnung, das CRM erhält von Monobank eine signierte Bestätigung, ordnet die Zahlung der Bestellung zu und informiert Ihr Team sofort. Kein manueller Abgleich von Kontoauszügen.
Mehr erfahrenOLX
VerfügbarJede Anfrage zu einer Anzeige wird zu einem Lead, und die gesamte Unterhaltung liegt im gemeinsamen Posteingang neben Ihren anderen Kanälen. Ihr Team antwortet aus dem CRM – OLX muss nicht geöffnet werden.
Mehr erfahrenTelegram
VerfügbarKunden schreiben Ihrem Telegram-Bot, und keine Anfrage geht verloren: Nachrichten landen automatisch mit der Quelle „telegram“ in der Pipeline.
Mehr erfahren
Beta: Beta: Die Verbindung ist bereits heute möglich; die Funktionen des Kanals werden noch ausgebaut.
Rozetka verbinden
Marktplatzbestellungen, Zahlung, Lieferung und Bestand im selben Arbeitsbereich wie Ihre übrigen Kanäle.