In breve
API venditore di Rozetka Marketplace per il più grande marketplace dell'Ucraina: ordini con aggiornamenti sullo stato e sulla bolla di consegna (TTN), stato di pagamento, beni con aggiornamenti di prezzo e stock 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 in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Rozetka Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Claude. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.
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 → Rozetka Marketplace, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Rozetka Marketplace + Claude
API venditore di Rozetka Marketplace per il più grande marketplace dell'Ucraina: ordini con aggiornamenti sullo stato e sulla bolla di consegna (TTN), stato di pagamento, beni con aggiornamenti di prezzo e stock 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.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:
ROZETKA_USERNAME, ROZETKA_PASSWORD_BASE64
Passo 1 — Ottieni le credenziali
L'API accede con il login e la password del cabinet venditore di 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 contenere 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 nuovamente ogni quattro ore. Un login o una password errati vengono segnalati comeincorrect_username_password.
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 la TTN con stato 3 (consegnato al corriere) o 61 (consegna pianificata); una TTN inviata con stato 2 sposta l'ordine a 61. Dopo che una TTN è stata aggiunta, Rozetka traccia il pacco e cambia lo stato da sola. Gli stati 7 e superiori sono per lo più cancellazioni o stati di consegna (ad es. 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).
Beni e prezzi
rozetka_list_goodserozetka_get_goodsleggono i beni del venditore;rozetka_get_goods_countsli conta per scheda del cabinet (errori, moderazione, in attesa di conferma).rozetka_update_goods_price_stockcambia prezzo e stock per uno o più beni tramiteitem_rz_id(l'id di Rozetka,id/rz_item_idnell'elenco dei beni, non l'internoitem_id). I prezzi sono in UAH. Rozetka mantiene un prezzo aumentato di più di 1,5 volte o ridotto di più della metà per la conferma di un manager.- Id degli stati dei beni: 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 strettamente 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 elenco) ->rozetka_list_producers->rozetka_create_goodscon nome in russo e ucraino, prezzo, stock e URL delle immagini. I nuovi beni passano attraverso la moderazione di Rozetka prima di essere mostrati.
Recensioni, domande e chat
- Recensioni del negozio:
rozetka_list_store_reviews(ad es.reply_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 le discussioni 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 non risposte),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 invialo solo dopo che hanno concordato. Scrivi nella lingua del compratore, di solito ucraino. Le risposte e le risposte ai 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 disattivato, perché accettare può rimborsare il compratore; un admin lo attiva deliberatamente. Gli id delle richieste di reso contengono lettere (ad es. AM1234567).
Non incluso: saldi, fatture, pagamenti, ricevute fiscali (PRRO), creazione di bolle di consegna pagate con i corrieri, account manager e cancellazioni. Il connettore non gestisce mai denaro.
Formati e problematiche
- Rozetka risponde HTTP 200 anche quando una chiamata fallisce, con
success: false; il connettore trasforma questo in un errore contenenteerrors.messageeerrors.code, ad es.incorrect_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 un 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 nuovamente con page + 1 fino a quando currentPage è uguale a pageCount. Ordini, recensioni e chat arrivano 20 per pagina; beni, categorie e directory accettano pageSize. Non è pubblicato alcun limite di velocità; 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 autogestite.
Passo 2 — Installa l'adattatore
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
Passo 3 — Aggiungi il connettore in Claude
L'URL del tuo server: in AnythingMCP, apri MCP Servers → il server su cui si trova questo connettore, e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostriYOUR_SERVER_ID.
Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.
- In Claude, apri Plugins (in alcuni piani ancora Customize) → Connectors.
- Clicca su + Add, poi Add custom connector.
- Inserisci un nome, ad es.
Rozetka Marketplace, e l'URL del server MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca su Continue, mantieni le impostazioni rilevate e clicca di nuovo su Continue. - Scegli Sign in now, clicca su Add e accedi a AnythingMCP (OAuth) per consentire l'accesso.
Tutti gli strumenti qui sotto appariranno nella tua chat: inizia a digitare i prompt.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
rozetka_list_orders | Cerca gli ordini di 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 di Rozetka per id con importi, stato e commenti. Usa expand per articoli (acquisti), consegna, compratore (utente), cronologia degli stati… |
rozetka_list_order_statuses | Elenca gli stati degli ordini di 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 beni 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 beni del venditore su Rozetka (prezzi, categoria, descrizione, stato dello stock) tramite l'interno item_id o tramite… |
rozetka_update_order | Cambia lo stato di un ordine di Rozetka, aggiungi il numero della bolla di consegna (TTN) e/o un commento del venditore. Restituisce l'ordine aggiornato. Una TTN è richiesta… |
rozetka_get_order_counts | Conta gli ordini di 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 stock di uno o più beni del venditore in una sola chiamata (aggiornamento di massa). Ogni voce necessita di item_rz_id (l'id di Rozetka, id in… |
rozetka_get_goods_counts | Conta i beni 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 di Rozetka del venditore. Necessita di nome in russo e ucraino, una categoria da… |
rozetka_list_goods_categories | Cerca le categorie di Rozetka in cui il venditore può creare beni, per titolo o id. Restituisce id, titolo ucraino, russo e inglese… |
rozetka_list_category_attributes | Elenca le caratteristiche (attributi) di una categoria di 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 elenco in… |
rozetka_list_producers | Cerca il directory dei produttori (marchi) di Rozetka 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 beni 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 es. AM1234567), status_title, reason_title, order_id, nome dell'oggetto… |
rozetka_get_refund_request | Ottieni una richiesta di reso o rimborso: stato, motivo e sotto-motivo con il commento del compratore, decisione desiderata (decision_title), ordine e oggetto… |
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 es. 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 prompt
- "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 beni 987654 a 1.499 UAH e lo stock 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."
FAQ
Funziona sia con Claude Code che con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Quale login utilizza? Il tuo login del cabinet venditore di Rozetka (seller.rozetka.com.ua), con la password codificata in Base64. Il connettore accede nuovamente ogni quattro ore.
Può cambiare ordini e prezzi? Sì: stato dell'ordine e bolla di consegna (TTN), aggiornamenti di prezzo e stock in massa, nuovi beni, risposte a recensioni, domande e chat con i compratori. Cambiare lo stato di una richiesta di reso è installato disattivato, perché accettare un reso può rimborsare il compratore.
Tocca saldi o pagamenti? No. Saldi, fatture, pagamenti, ricevute fiscali (PRRO) e creazione di bolle di consegna pagate con i corrieri non sono inclusi.
Prossimi passi
- Pagina di atterraggio del connettore
- Collegati a ChatGPT
- Collegati a Cursor
- Collegati a Gemini
- Collegati a Meta Muse
- Collegati a Microsoft Copilot
Questa guida ti è stata utile?