Guida al connettore10 minuti di lettura29 tool MCP7 lingue

Rozetka MCP Server: ordini, prodotti e scorte

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.

HCA cura del team HelpCodeAggiornato 10 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Rozetka Marketplace

Rozetka Marketplace

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

tool

29

Regione

INTL

Categoria

E-commerce

Autenticazione

Sign-in token

Env vars richieste

ROZETKA_USERNAMEROZETKA_PASSWORD_BASE64
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

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.

Rozetka Marketplace · live via MCP
Condividi
Opus 4.7

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.

  1. Inserisci il login del cabinet in ROZETKA_USERNAME.
  2. Rozetka si aspetta che la password sia codificata in Base64, quindi ROZETKA_PASSWORD_BASE64 deve assumere la forma codificata, non la password in chiaro. Codificala sul tuo computer, ad esempio in un terminale printf '%s' 'la-tua-password' | base64, e incolla il risultato. Non usare un codificatore online per una password reale. AnythingMCP accede con POST /sites e 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 come incorrect_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_statuses mappa il status numerico di un ordine al suo nome. rozetka_list_orders filtra per types (1 tutti, 2 in elaborazione, 3 completati, 4 nuovi, 5 in consegna, 6 falliti), stato o date; rozetka_get_order legge un ordine. Aggiungi expand=purchases,delivery,user per articoli, consegna e compratore, e status_available per gli stati a cui l'ordine può passare successivamente.
  • rozetka_update_order cambia 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 prima status_available.
  • rozetka_get_order_payment_status indica 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_goods e rozetka_get_goods leggono i prodotti del venditore; rozetka_get_goods_counts li conta per scheda del cabinet (errori, moderazione, in attesa di conferma).
  • rozetka_update_goods_price_stock cambia prezzo e magazzino per uno o più prodotti tramite item_rz_id (l'id Rozetka, id/rz_item_id nell'elenco dei prodotti, non l'interno item_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_required 1 significa che un produttore è obbligatorio) -> rozetka_list_category_attributes (le sue caratteristiche; aumenta pageSize, l'API restituisce 5 per impostazione predefinita) -> rozetka_list_attribute_values (valori consentiti per caratteristiche di tipo lista) -> rozetka_list_producers -> rozetka_create_goods con 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 esempio reply_search=0 per recensioni senza risposta, vote=dislike per quelle negative), poi rozetka_reply_store_review con l'id della recensione e il suo order_id.
  • Recensioni e domande sui prodotti: rozetka_list_goods_comments con isAnswered=0 elenca i thread in attesa del venditore; rispondi con rozetka_reply_goods_comment (parent_id = id del commento, item_id = item.id).
  • Chat: rozetka_list_chats (msgType=orders per chat sugli ordini, items per domande sui prodotti, has_response_to_user=0 per quelle senza risposta), rozetka_get_chat per leggere i messaggi (questo li segna come letti), rozetka_get_order_chat per trovare la chat di un ordine, e rozetka_send_message con chat_id e il user_id del compratore come receiver_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 contenente errors.message e errors.code, ad esempio incorrect_access_token (1020) o access_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:SS senza 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

StrumentoCosa fa
rozetka_list_ordersCerca 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_orderOttieni un ordine Rozetka per id con importi, stato e commenti. Usa expand per articoli (acquisti), consegna, compratore (utente), cronologia stato…
rozetka_list_order_statusesElenca 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_goodsCerca 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_goodsOttieni 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_orderCambia 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_countsConta gli ordini Rozetka del venditore per gruppo: inProgress (in elaborazione), nuovi, in consegna, inDone (completati), inNotDone (falliti), non visti…
rozetka_get_order_payment_statusOttieni 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_stockAggiorna 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_countsConta i prodotti del venditore per sezione del cabinet: attivi, inattivi, nuovi, in moderazione, in attesa di conferma, in attesa di approvazione…
rozetka_create_goodsCrea una nuova inserzione di prodotto nel cabinet Rozetka del venditore. Necessita di nome in russo e ucraino, una categoria da…
rozetka_list_goods_categoriesCerca le categorie Rozetka in cui il venditore può creare prodotti, per titolo o id. Restituisce id, titolo ucraino, russo e inglese…
rozetka_list_category_attributesElenca le caratteristiche (attributi) di una categoria Rozetka, necessarie per i parametri in rozetka_create_goods. Restituisce id, titoli, unità, tipo…
rozetka_list_attribute_valuesElenca 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_producersCerca 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_reviewsCerca 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_reviewPubblica 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_commentsCerca 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_commentPubblica 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_countsConta le chat e le richieste dei compratori non lette e totali: totalUnread, ordersChatUnread, itemsChatUnread, sellerChatUnread, customerRequestsUnread…
rozetka_list_chatsCerca 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_chatApri 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_chatOttieni 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_messageInvia 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_requestsCerca 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_requestOttieni 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_statusesElenca 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_ttnSalva 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_statusSposta 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?

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.

Guide correlate

Connettori

Collegare Rozetka MCP a Microsoft Copilot

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.

Connettori

Collegare Rozetka MCP a ChatGPT

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.

Connettori

Collegare Rozetka MCP a 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.

Connettori

Collegare Rozetka MCP a Cursor

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.

Connettori

Collegare Rozetka MCP a Gemini CLI

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.

Connettori

Collegare Rozetka MCP a Meta Muse

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.