In breve
API venditore del marketplace Rozetka per il più grande marketplace dell'Ucraina: ordini con aggiornamenti sullo stato e sulla bolla di consegna (TTN), stato di pagamento, prodotti con aggiornamenti di prezzo e magazzino in massa e nuove inserzioni, recensioni del negozio e domande sui prodotti con risposte, chat con i compratori e richieste di reso. Accedi con il login del cabinet venditore.
Configurazione guidata
Collega Rozetka Marketplace a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Rozetka Marketplace con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Rozetka Marketplace
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Marketplace Rozetka, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Marketplace Rozetka
API venditore del marketplace Rozetka per il più grande marketplace dell'Ucraina: ordini con aggiornamenti sullo stato e sulla bolla di consegna (TTN), stato di pagamento, prodotti con aggiornamenti di prezzo e magazzino in massa e nuove inserzioni, recensioni del negozio e domande sui prodotti con risposte, chat con i compratori e richieste di reso. Accedi con il login del cabinet venditore.
Configurazione
L'API accede con il login e la password del cabinet venditore Rozetka (seller.rozetka.com.ua); non esiste una chiave API separata.
- Inserisci il login del cabinet in
ROZETKA_USERNAME. - Rozetka si aspetta che la password sia codificata in Base64, quindi
ROZETKA_PASSWORD_BASE64deve assumere la forma codificata, non la password in chiaro. Codificala sul tuo computer, ad esempio in un terminaleprintf '%s' 'la-tua-password' | base64, e incolla il risultato. Non usare un codificatore online per una password reale. AnythingMCP accede conPOST /sitese invia il token di sessione come token Bearer. Rozetka mantiene un token attivo mentre viene utilizzato e lo fa scadere dopo 24 ore senza utilizzo; il connettore accede di nuovo ogni quattro ore. Un login o una password errati vengono segnalati comeincorrect_username_password.
Da dove iniziare: rozetka_get_order_counts e rozetka_get_message_counts mostrano cosa è in attesa (nuovi ordini, chat non lette, richieste di reso aperte). Poi rozetka_list_orders con types=4 (nuovi) o types=2 (in elaborazione).
Ordini
rozetka_list_order_statusesmappa ilstatusnumerico di un ordine al suo nome.rozetka_list_ordersfiltra pertypes(1 tutti, 2 in elaborazione, 3 completati, 4 nuovi, 5 in consegna, 6 falliti), stato o date;rozetka_get_orderlegge un ordine. Aggiungiexpand=purchases,delivery,userper articoli, consegna e compratore, estatus_availableper gli stati a cui l'ordine può passare successivamente.rozetka_update_ordercambia lo stato, aggiunge la bolla di consegna (TTN) e un commento del venditore. Flusso abituale: nuovo ordine (1) -> conferma con 2 (in fase di imballaggio) -> aggiungi il TTN con stato 3 (consegnato al corriere) o 61 (consegna pianificata); un TTN inviato con stato 2 sposta l'ordine a 61. Dopo che un TTN è stato aggiunto, Rozetka traccia il pacco e cambia lo stato autonomamente. Gli stati 7 e superiori sono per lo più cancellazioni o stati di consegna (ad esempio 16/42 esaurito, 18 compratore irraggiungibile, 40 compratore ha cambiato idea, 45 cancellato dal compratore): imposta una cancellazione solo quando il venditore lo richiede, non può essere annullata. Controlla primastatus_available.rozetka_get_order_payment_statusindica se un pagamento online è stato pagato, non pagato, in fase di verifica o cancellato (memorizzato nella cache per 5 minuti).
Prodotti e prezzi
rozetka_list_goodserozetka_get_goodsleggono i prodotti del venditore;rozetka_get_goods_countsli conta per scheda del cabinet (errori, moderazione, in attesa di conferma).rozetka_update_goods_price_stockcambia prezzo e magazzino per uno o più prodotti tramiteitem_rz_id(l'id Rozetka,id/rz_item_idnell'elenco dei prodotti, non l'internoitem_id). I prezzi sono in UAH. Rozetka mantiene un prezzo aumentato di oltre 1,5 volte o ridotto di oltre la metà per la conferma di un manager.- Id degli stati dei prodotti: 0 bloccato, 1 attivo, 2 nuovo, 3 in attesa di moderazione, 4 in fase di moderazione, 5 rifiutato dalla moderazione, 6 necessita conferma del moderatore, 7 archiviato, 8 in attesa di moderazione. Stato di vendita: 0 non disponibile, 1 fornitura prevista, 2 chiama, 3 in esaurimento, 4 disponibile, 5 archivia, 6 rigorosamente non disponibile, 7 esaurito, 8 nascosto.
- Nuova inserzione:
rozetka_list_goods_categories(trova la categoria;is_vendor_required1 significa che un produttore è obbligatorio) ->rozetka_list_category_attributes(le sue caratteristiche; aumentapageSize, l'API restituisce 5 per impostazione predefinita) ->rozetka_list_attribute_values(valori consentiti per caratteristiche di tipo lista) ->rozetka_list_producers->rozetka_create_goodscon nome in russo e ucraino, prezzo, magazzino e URL delle immagini. I nuovi prodotti passano attraverso la moderazione di Rozetka prima di essere mostrati.
Recensioni, domande e chat
- Recensioni del negozio:
rozetka_list_store_reviews(ad esempioreply_search=0per recensioni senza risposta,vote=dislikeper quelle negative), poirozetka_reply_store_reviewcon l'iddella recensione e il suoorder_id. - Recensioni e domande sui prodotti:
rozetka_list_goods_commentsconisAnswered=0elenca i thread in attesa del venditore; rispondi conrozetka_reply_goods_comment(parent_id= id del commento,item_id=item.id). - Chat:
rozetka_list_chats(msgType=ordersper chat sugli ordini,itemsper domande sui prodotti,has_response_to_user=0per quelle senza risposta),rozetka_get_chatper leggere i messaggi (questo li segna come letti),rozetka_get_order_chatper trovare la chat di un ordine, erozetka_send_messageconchat_ide iluser_iddel compratore comereceiver_id. - Risposte, risposte e messaggi sono pubblici o raggiungono il compratore: redigi il testo, mostralo al venditore e invia solo dopo che hanno concordato. Scrivi nella lingua del compratore, di solito ucraino. Le risposte e le risposte sui prodotti sono moderate da Rozetka prima di apparire.
Resi: rozetka_list_refund_requests (codici di stato da rozetka_list_refund_statuses), rozetka_get_refund_request per il motivo, la decisione che il compratore desidera e la chat, e rozetka_save_refund_ttn per memorizzare la bolla di ritorno. rozetka_update_refund_status (accetta o rifiuta una richiesta) è installato spento, perché accettare può rimborsare il compratore; un admin lo attiva deliberatamente. Gli id delle richieste di reso contengono lettere (ad esempio AM1234567).
Non incluso: saldi, fatture, pagamenti, ricevute fiscali (PRRO), creazione di bolle di consegna pagate con corrieri, account manager e cancellazioni. Il connettore non gestisce mai denaro.
Formati e problemi
- Rozetka risponde con HTTP 200 anche quando una chiamata fallisce, con
success: false; il connettore trasforma questo in un errore contenenteerrors.messageeerrors.code, ad esempioincorrect_access_token(1020) oaccess_denied(1010, il ruolo dell'account non ha il diritto). - I prezzi sono in UAH. Le date nei filtri sono YYYY-MM-DD; i timestamp arrivano come
YYYY-MM-DD HH:MM:SSsenza fuso orario. - I testi arrivano nella lingua del cabinet (ucraino o russo); le richieste di reso rispondono in ucraino.
Paginazione e limiti: le liste si trovano sotto content con _meta (totalCount, pageCount, currentPage, perPage). Richiama di nuovo con page + 1 fino a quando currentPage è uguale a pageCount. Ordini, recensioni e chat arrivano 20 per pagina; prodotti, categorie e directory accettano pageSize. Non è pubblicato alcun limite di frequenza; evita cicli stretti e preferisci un aggiornamento di massa rispetto a molti singoli.
Accessibilità cloud: api-seller.rozetka.com.ua è pubblico su HTTPS, raggiungibile da AnythingMCP Cloud e da installazioni auto-ospitate.
Prerequisiti: ROZETKA_USERNAME, ROZETKA_PASSWORD_BASE64
Installa il connettore localmente
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Apri http://localhost:3000/connectors/store, scegli Marketplace Rozetka e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
rozetka_list_orders | Cerca gli ordini Rozetka del venditore, 20 per pagina, per gruppo di stato, stato, data di creazione o modifica, id ordine, telefono del compratore o bolla di consegna (TTN).… |
rozetka_get_order | Ottieni un ordine Rozetka per id con importi, stato e commenti. Usa expand per articoli (acquisti), consegna, compratore (utente), cronologia stato… |
rozetka_list_order_statuses | Elenca gli stati degli ordini Rozetka con id, nome ucraino, russo e inglese e gruppo di stato, per leggere lo stato numerico di un ordine |
rozetka_list_goods | Cerca i prodotti del venditore su Rozetka (tutte le schede) per nome, testo, articolo, id lista prezzi o id Rozetka, disponibilità o categoria. Restituisce id… |
rozetka_get_goods | Ottieni i dettagli di uno dei prodotti del venditore su Rozetka (prezzi, categoria, descrizione, stato di magazzino) tramite l'item_id interno o tramite… |
rozetka_update_order | Cambia lo stato di un ordine Rozetka, aggiungi il numero della bolla di consegna (TTN) e/o un commento del venditore. Restituisce l'ordine aggiornato. Un TTN è richiesto… |
rozetka_get_order_counts | Conta gli ordini Rozetka del venditore per gruppo: inProgress (in elaborazione), nuovi, in consegna, inDone (completati), inNotDone (falliti), non visti… |
rozetka_get_order_payment_status | Ottieni lo stato attuale del pagamento di un ordine pagato online: status_payment_id, nome (pagato, non pagato, cancellato, non approvato, parzialmente pagato ...)… |
rozetka_update_goods_price_stock | Aggiorna prezzo e magazzino di uno o più prodotti del venditore in una sola chiamata (aggiornamento di massa). Ogni voce necessita di item_rz_id (l'id Rozetka, id in… |
rozetka_get_goods_counts | Conta i prodotti del venditore per sezione del cabinet: attivi, inattivi, nuovi, in moderazione, in attesa di conferma, in attesa di approvazione… |
rozetka_create_goods | Crea una nuova inserzione di prodotto nel cabinet Rozetka del venditore. Necessita di nome in russo e ucraino, una categoria da… |
rozetka_list_goods_categories | Cerca le categorie Rozetka in cui il venditore può creare prodotti, per titolo o id. Restituisce id, titolo ucraino, russo e inglese… |
rozetka_list_category_attributes | Elenca le caratteristiche (attributi) di una categoria Rozetka, necessarie per i parametri in rozetka_create_goods. Restituisce id, titoli, unità, tipo… |
rozetka_list_attribute_values | Elenca i valori consentiti di una o più caratteristiche in una categoria (id, titolo ucraino, russo e inglese), per parametri di tipo lista in… |
rozetka_list_producers | Cerca il directory dei produttori Rozetka (marca) per nome o id, per il produttore di rozetka_create_goods. Restituisce id, titolo e stato, 100… |
rozetka_list_store_reviews | Cerca le recensioni dei compratori del negozio (non di un prodotto): id, order_id, nome del compratore, commento, voto complessivo (mi piace, medio, non mi piace), voti per… |
rozetka_reply_store_review | Pubblica la risposta pubblica del venditore a una recensione del negozio. Necessita dell'id della recensione e del suo order_id da rozetka_list_store_reviews. Restituisce la risposta… |
rozetka_list_goods_comments | Cerca le recensioni e le domande dei compratori sui prodotti del venditore: id, tipo (commento o domanda), testo, valutazione (voto 1-5), pro e contro, autore… |
rozetka_reply_goods_comment | Pubblica la risposta pubblica del venditore a una recensione o domanda di prodotto. parent_id è l'id del commento e item_id è l'item.id da… |
rozetka_get_message_counts | Conta le chat e le richieste dei compratori non lette e totali: totalUnread, ordersChatUnread, itemsChatUnread, sellerChatUnread, customerRequestsUnread… |
rozetka_list_chats | Cerca le chat del venditore con i compratori: chat sugli ordini, domande sui prodotti o chat eliminate. Restituisce id chat, soggetto, compratore (user_id, nome)… |
rozetka_get_chat | Apri una chat con un compratore, con i suoi messaggi per impostazione predefinita. Restituisce soggetto, user_id del compratore (il receiver_id per rozetka_send_message)… |
rozetka_get_order_chat | Ottieni la chat che appartiene a un ordine, per id ordine: id chat, soggetto, user_id del compratore e, con expand, i messaggi. Usalo per scrivere al… |
rozetka_send_message | Invia un messaggio a un compratore in una chat esistente. Necessita di chat_id e receiver_id (l'user_id del compratore da rozetka_get_chat o… |
rozetka_list_refund_requests | Cerca le richieste di reso e rimborso dei compratori: id richiesta (lettere e numeri, ad esempio AM1234567), status_title, reason_title, order_id, nome dell'articolo… |
rozetka_get_refund_request | Ottieni una richiesta di reso o rimborso: stato, motivo e sottomotivo con il commento del compratore, decisione desiderata (decision_title), ordine e articolo… |
rozetka_list_refund_statuses | Elenca i codici di stato delle richieste di reso e rimborso (status_code con il suo titolo ucraino), per filtrare rozetka_list_refund_requests e… |
rozetka_save_refund_ttn | Salva la bolla di consegna (TTN) del pacco di ritorno su una richiesta di reso, ad esempio quando il venditore invia un sostituto o la spedizione di ritorno del compratore… |
rozetka_update_refund_status | Sposta una richiesta di reso o rimborso in un altro stato (accetta, rifiuta con un motivo, beni ricevuti ...). Accettare una richiesta può portare al… |
Esempi di richieste
- "Quanti nuovi ordini Rozetka e messaggi non letti dei compratori ho?"
- "Mostra l'ordine 123456789 con il compratore, la consegna e gli articoli."
- "Imposta il prezzo dei prodotti 987654 a 1.499 UAH e il magazzino a 20."
- "Quali recensioni del negozio di questa settimana non hanno ancora risposta? Redigi una risposta per ciascuna."
- "Aggiungi la bolla di consegna Nova Poshta 20450000000000 all'ordine 123456789 e contrassegnalo come spedito."
Prossimi passi
Questa guida ti è stata utile?