Rozetka non invia webhook: per sapere di un nuovo ordine il venditore deve interrogare la Seller API. Per questo il CRM interroga la tua area ogni 15 minuti e trasforma ciò che riceve in un normale ordine del CRM — righe d’ordine, totale, acquirente, pagamento e consegna. Il tuo manager lavora in un’unica finestra, invece di tenere aperta l’area Rozetka accanto al CRM e copiare i dati a mano. Ogni spazio di lavoro è isolato: credenziali, catalogo e ordini di un’attività non sono raggiungibili da un’altra.
Cosa fa il connettore
Ordini ogni 15 minuti
Il CRM interroga la Seller API a intervalli regolari e crea gli ordini. Un’esecuzione ripetuta non duplica mai ciò che esiste già — la chiave di idempotenza è costruita sull’ID dell’ordine Rozetka.
Pagamento e consegna sull’ordine
A ogni passaggio vengono aggiornati stato, metodo di pagamento, metodo di consegna e numero della lettera di vettura non appena Rozetka li restituisce.
Stati di ritorno nell’area
Un manager cambia lo stato nel CRM e il connettore accede alla Seller API e aggiorna l’ordine sul lato Rozetka. Una transizione ambigua non viene scritta affatto.
I prodotti Rozetka nel catalogo
Le inserzioni pubblicate vengono importate: uno SKU esistente viene collegato, uno sconosciuto diventa una bozza nella coda di revisione — nulla entra nel tuo catalogo senza una tua decisione.
Pubblicazione tramite file dei prezzi
L’API di Rozetka non può creare un prodotto, il suo file dei prezzi sì. Il CRM ne serve uno a un link permanente, tu colleghi quel link nella tua area una volta sola e da quel momento i nuovi prodotti del catalogo arrivano da soli su Rozetka e passano la moderazione.
Idoneità prima dell’invio
Rozetka richiede nome, prezzo, foto, marca e caratteristiche e segnala un rifiuto dopo ore senza indicare il prodotto. Il CRM lo verifica in locale secondo le regole di Rozetka stessa: un elenco di ciò che non partirà, collegato a ogni prodotto.
Prezzi e giacenze di ritorno su Rozetka
Ogni ora il CRM aggiorna prezzo e quantità delle inserzioni già esistenti. La quantità viene inviata solo per i prodotti di cui tieni davvero traccia della giacenza.
Le domande degli acquirenti diventano lead
Lo stesso passaggio raccoglie i messaggi dalle pagine prodotto e crea un lead con origine «Rozetka», con un responsabile e un prossimo passo.
Dettagli tecnici
Esattamente cosa fa il connettore con la Seller API — per chi vuole verificarlo sulla propria area.
- Base dell’API
- api-seller.rozetka.com.ua
- Autenticazione
- Login + password del venditore → un token di 24 ore. Le credenziali sono cifrate a riposo.
- Lettura degli ordini
- GET /orders/search con righe, consegna e acquirente espansi
- Cursore
- Rozetka filtra gli ordini solo per data, quindi il cursore è giornaliero e a ogni passaggio viene riletto un giorno in più — così un ordine a cavallo della mezzanotte non va mai perso
- Scrittura dello stato
- PUT /orders/{id} dopo il login
- Prezzi e giacenze
- PUT /items/update-price-stock/{id} — abbinati per SKU (article = SKU)
- Pubblicazione dei prodotti
- Un file dei prezzi XML (yml_catalog) a un link permanente che Rozetka recupera da sola; l’ID dell’offerta deriva dall’ID del prodotto nel CRM e non cambia mai, e l’article coincide con lo SKU
- Categorie
- Il tuo albero di categorie con rz_id — il collegamento a una categoria Rozetka; i suggerimenti derivano dalle inserzioni che hai già lì dopo un’importazione
- Valuta
- Grivne. Un prodotto con prezzo in un’altra valuta viene saltato anziché convertito a un cambio inventato.
- Pianificazione
- Ordini e messaggi ogni 15 minuti, catalogo ogni ora, più un pulsante manuale «Sincronizza ora»
Corrispondenza degli stati CRM → Rozetka
Gli stati di Rozetka sono numerici e dipendono dalla configurazione della singola area, quindi la corrispondenza vive in un unico blocco che verifichiamo su un account reale. Una transizione di cui il connettore non è sicuro non viene inviata.
Consegna e lettera di vettura
Rozetka gestisce la consegna dei propri ordini, quindi qui il CRM legge anziché comandare.
- Metodo di consegna e numero della lettera di vettura arrivano da Rozetka nel blocco spedizione dell’ordine — a ogni passaggio, non una sola volta alla creazione.
- Se spedisci tu, una lettera di vettura Nova Poshta può essere creata direttamente dall’ordine del CRM, con indirizzo e destinatario compilati dai dati dell’acquirente.
- Il ritiro in sede è un metodo di consegna a pieno titolo, non un campo di testo libero: non ha corriere né numero di tracciamento e sull’ordine appare come «Ritiro in sede».
- Lo stato di consegna non sovrascrive mai lo stato dell’ordine: quando un manager imposta lo stato a mano, il CRM lo considera autorevole e il poller non lo sovrascrive.
Nessuna direzione di scrittura è attiva di default
Arrivi con prodotti che esistono già sia nel CRM sia su Rozetka. Per questo la lettura funziona subito, mentre ogni direzione di scrittura — prezzi, giacenze, stati, pubblicazione tramite il file dei prezzi — viene attivata separatamente dal titolare e solo dopo una prova a vuoto che mostra esattamente cosa cambierebbe senza cambiare nulla. La pubblicazione ha la sua prova a vuoto: indica ogni prodotto che non entrerebbe nel file, e perché. Un file dei prezzi vuoto non viene mai servito — potrebbe far sparire le tue inserzioni. Il connettore non elimina né archivia mai prodotti, né nel CRM né sul marketplace.
Configurazione
- 1
Aggiungi il connettore Rozetka
Impostazioni → Integrazioni → Connettori delle piattaforme. Il primo passaggio chiede solo un nome.
- 2
Incolla il login del venditore
Login e password della tua area Seller API. Premi «Verifica della connessione» — il CRM esegue un vero accesso e indica se l’accesso agli ordini funziona.
- 3
Attiva le direzioni che vuoi
Gli ordini iniziano a fluire da soli. La prova a vuoto mostra cosa accadrebbe a prezzi e giacenze — e solo dopo attivi la scrittura.
- 4
Collega il file dei prezzi se pubblichi dal CRM
Copia il link del file dei prezzi dalla pagina del connettore e aggiungilo come file dei prezzi XML nell’area Rozetka. Le categorie del file dei prezzi vengono abbinate alle categorie Rozetka lì — senza, i prodotti non vengono pubblicati.
Domande frequenti
Come collego Rozetka al CRM?
Aggiungi il connettore Rozetka in Impostazioni → Integrazioni, incolla login e password della tua area Seller API e premi «Verifica della connessione». Una volta superata, gli ordini iniziano ad arrivare da soli — nessun worker e nessun codice da parte tua.
Mi serve uno sviluppatore?
No. Interrogare Rozetka, riconciliare gli ordini e aggiornare gli stati è compito del CRM. Uno sviluppatore serve solo se vuoi scrivere nel CRM dal tuo sistema — per questo esiste un’API REST pubblica.
Quanto in fretta un ordine Rozetka compare nel CRM?
Entro 15 minuti: Rozetka non invia webhook, quindi il CRM interroga la Seller API a intervalli regolari. È un compromesso della piattaforma, non una nostra scelta — ed è per questo che l’orario dell’ultimo polling riuscito è visibile nell’interfaccia.
Consegna e numero della lettera di vettura vengono importati?
Sì. Metodo di consegna e numero della lettera di vettura arrivano da Rozetka nel blocco spedizione dell’ordine e si aggiornano a ogni passaggio. Se spedisci tu, una lettera di vettura Nova Poshta può essere creata direttamente dall’ordine.
Posso gestire prezzi e giacenze dal CRM?
Sì. Per le inserzioni già esistenti su Rozetka il CRM le abbina per SKU e aggiorna prezzo e quantità ogni ora. I nuovi prodotti partono tramite il file dei prezzi: l’API di Rozetka non può creare un’inserzione, quindi il CRM serve il tuo catalogo come file dei prezzi XML a un link che colleghi una volta nell’area, e Rozetka crea i prodotti da lì.
Posso pubblicare un nuovo prodotto su Rozetka dal CRM?
Sì — tramite il file dei prezzi. La Seller API di Rozetka non può creare prodotti (aggiorna solo prezzo e giacenza di un articolo già esistente), quindi il CRM serve il tuo catalogo come file dei prezzi XML a un link permanente. Il titolare attiva quella direzione dopo una prova a vuoto e incolla il link nell’area Rozetka; da quel momento i nuovi prodotti vi arrivano da soli e passano la moderazione di Rozetka come qualsiasi altro prodotto di un venditore.
Cosa succede al mio catalogo alla prima importazione?
Nulla senza una tua decisione. Un prodotto il cui SKU il CRM conosce già viene semplicemente collegato all’inserzione. Un prodotto che non conosce diventa una bozza nella coda di revisione, dove lo attivi oppure lo unisci a una scheda esistente.
Posso rispondere agli acquirenti di Rozetka dal CRM?
Le domande dalle pagine prodotto diventano lead del CRM con la loro cronologia e un manager assegnato. Le risposte si scrivono ancora nell’area Rozetka — la chat bidirezionale per questo canale non è ancora aperta.
È lo stesso schema di Prom?
L’acquisizione è condivisa — entrambi i marketplace vengono interrogati a intervalli e passano da un unico livello di acquisizione degli ordini, quindi idempotenza e scarichi di magazzino si comportano allo stesso modo. La scrittura è costruita separatamente sulla Seller API di Rozetka: prendiamo il contratto di ogni piattaforma dalla sua documentazione ufficiale, mai da un altro connettore.
Spesso collegati insieme
Prom.ua
DisponibileOrdini, pagamenti e consegne arrivano da soli. Le domande degli acquirenti diventano lead a cui rispondi direttamente dal CRM, senza aprire l’area Prom.
Scopri di piùNova Poshta
DisponibileNiente passaggi nell’area riservata del corriere: la lettera di vettura si crea nel CRM e gli stati di consegna si aggiornano da soli.
Scopri di piùMonobank
BetaL’acquirente paga una fattura, il CRM riceve da Monobank una conferma firmata, registra il pagamento sull’ordine e avvisa subito il tuo team. Niente riconciliazione manuale degli estratti conto.
Scopri di piùOLX
DisponibileOgni richiesta su un’inserzione diventa un lead e l’intera conversazione vive nella posta in arrivo condivisa, accanto agli altri canali. Il tuo team risponde dal CRM, senza aprire OLX.
Scopri di piùTelegram
DisponibileI clienti scrivono al tuo bot Telegram e nessuna richiesta va persa: i messaggi arrivano nella pipeline con la fonte «telegram» in automatico.
Scopri di piùBeta: Beta: collegabile già oggi; le funzionalità del canale sono ancora in fase di rifinitura.
Collega Rozetka
Ordini del marketplace, pagamento, consegna e giacenze nello stesso spazio di lavoro del resto dei tuoi canali.
Inizia gratis