Guida al connettore12 minuti di lettura29 tool MCP7 lingue

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.

HCA cura del team HelpCodeAggiornato 12 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 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 Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Rozetka Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. 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 → Rozetka Marketplace, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Rozetka Marketplace + 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.

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.

  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 contenere 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 nuovamente ogni quattro ore. Un login o una password errati vengono segnalati come incorrect_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_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 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 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).

Beni e prezzi

  • rozetka_list_goods e rozetka_get_goods leggono i beni 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 stock per uno o più beni tramite item_rz_id (l'id di Rozetka, id/rz_item_id nell'elenco dei beni, non l'interno item_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_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 elenco) -> rozetka_list_producers -> rozetka_create_goods con 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=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 le discussioni 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 non risposte), 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 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 contenente errors.message e errors.code, ad es. 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 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 Cursor

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 mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
  2. Salva il file e riavvia Cursor.
  3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
  4. Inizia a chattare: l'agente ora può usare i tool di Rozetka Marketplace.

Strumenti disponibili

StrumentoCosa fa
rozetka_list_ordersCerca 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_orderOttieni 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_statusesElenca 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_goodsCerca 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_goodsOttieni 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_orderCambia 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_countsConta gli ordini di 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 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_countsConta i beni 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 di Rozetka del venditore. Necessita di nome in russo e ucraino, una categoria da…
rozetka_list_goods_categoriesCerca 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_attributesElenca le caratteristiche (attributi) di una categoria di 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 elenco in…
rozetka_list_producersCerca 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_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 beni 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 es. AM1234567), status_title, reason_title, order_id, nome dell'oggetto…
rozetka_get_refund_requestOttieni 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_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 es. 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 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

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.

Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

Questa guida ti è stata utile?

Collega Rozetka Marketplace a Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Rozetka Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. 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 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.

Connettori

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.