In breve
Gestisci il tuo negozio sul marketplace Vente-unique tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Francia, Italia, Spagna, Belgio, Paesi Bassi, Germania, Portogallo, Polonia e in altri 7 paesi; accedi con la chiave API del negozio dal tuo back office venditore di Vente-unique.
Configurazione guidata
Collega Vente-unique Marketplace a Cursor in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Vente-unique 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 Vente-unique 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 Connectors → Vente-unique Marketplace, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Vente-unique Marketplace + Cursor
Gestisci il tuo negozio sul marketplace Vente-unique tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Francia, Italia, Spagna, Belgio, Paesi Bassi, Germania, Portogallo, Polonia e in altri 7 paesi; accedi con la chiave API del negozio dal tuo back office venditore di Vente-unique.
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:
VENTE_UNIQUE_API_KEY
Passo 1 — Ottieni le credenziali
Paesi: Francia, Italia, Spagna, Belgio, Paesi Bassi, Germania, Portogallo, Polonia, Svizzera, Austria, Norvegia, Danimarca, Svezia, Irlanda e Regno Unito. Ulteriori paesi europei sono serviti dallo stesso negozio.
Chi può vendere: Vente-unique accetta domande sulla sua pagina venditore. Il connettore ha bisogno di un account venditore che Vente-unique ha già aperto.
La configurazione richiede circa 5 minuti.
- Accedi al back office venditore di Vente-unique:
https://venteunique-prod.mirakl.net/login. - Nel back office apri il tuo nome utente (in alto a destra) > Le mie impostazioni utente > Chiave API e clicca su Genera una nuova chiave (o copia la chiave esistente). Incollala in
VENTE_UNIQUE_API_KEY. La chiave viene inviata così com'è nell'intestazioneAuthorization, senzaBearer. Generare una nuova chiave invalida quella vecchia, quindi qualsiasi altro strumento che la utilizza smette di funzionare. - Gli utenti con più negozi sono comuni su Vente-unique. Se il tuo utente ha più di un negozio, imposta
VENTE_UNIQUE_SHOP_IDsull'id numerico del negozio su cui questo connettore dovrebbe funzionare (mostrato nel dashboard del back office accanto a Identifier o Shop ID, e restituito comeshop_iddavente_unique_get_account); per lavorare su più negozi, installa il connettore una volta per negozio. Senza di esso, viene utilizzato il tuo negozio predefinito. - Installa ed esegui
vente_unique_get_account: restituisce il negozio a cui appartiene la chiave.
Da dove iniziare: vente_unique_get_account mostra il negozio dietro la chiave (id, nome, stato, valuta e canali). Per il lavoro quotidiano utilizza vente_unique_list_orders con order_state_codes=WAITING_ACCEPTANCE, vente_unique_list_offers per prezzi e stock e vente_unique_list_threads per messaggi che aspettano una risposta.
Prodotti e offerte concorrenti: vente_unique_get_products cerca i prodotti nel catalogo di Vente-unique per EAN o un altro riferimento e restituisce lo SKU del prodotto del marketplace; vente_unique_list_product_offers elenca le offerte di ogni negozio per i prodotti dati, il miglior prezzo per primo, con circa 5 chiamate al minuto.
Flusso di lavoro degli ordini: un nuovo ordine attende in WAITING_ACCEPTANCE. vente_unique_accept_order accetta (o rifiuta) ogni riga; dopo che il cliente è stato addebitato, l'ordine passa a SHIPPING. Poi vente_unique_update_tracking memorizza il corriere e il numero di tracciamento (i codici dei corrieri provengono da vente_unique_list_carriers) e vente_unique_ship_order conferma la spedizione (SHIPPED). Gli stati successivi sono TO_COLLECT, RECEIVED, CLOSED, REFUSED e CANCELED. Usa vente_unique_list_orders con order_state_codes=WAITING_ACCEPTANCE per la lista delle cose da fare quotidiane e has_incident=true per incidenti aperti; vente_unique_resolve_incident chiude un incidente su una riga d'ordine una volta risolto. I documenti allegati agli ordini (note di consegna, etichette, fatture clienti) sono elencati da vente_unique_list_order_documents.
Scritture: conferma prima. vente_unique_accept_order, vente_unique_update_tracking, vente_unique_ship_order, vente_unique_resolve_incident, vente_unique_accept_return, vente_unique_receive_return, vente_unique_update_offers, vente_unique_reply_thread, vente_unique_create_order_thread e vente_unique_import_products agiscono sul marketplace live. Prima di ogni chiamata, mostra all'utente cosa cambierà (id e righe dell'ordine, numero di tracciamento, SKU dell'offerta con il vecchio e il nuovo prezzo o stock, il testo del messaggio e i destinatari) e aspetta un sì. Rifiutare una riga d'ordine la annulla definitivamente. Nessun strumento qui rimborsa, annulla ordini o sposta denaro; fallo nel back office. vente_unique_import_offers può eliminare offerte (la modalità REPLACE elimina ogni offerta mancante dal file), quindi è installato spento.
Aggiornamento delle offerte (prezzi e stock): vente_unique_update_offers (OF24) sostituisce l'intera offerta. Ogni campo che lasci fuori viene ripristinato: una quantity mancante diventa 0, uno sconto o una descrizione mancanti vengono eliminati. Leggi sempre prima l'offerta (vente_unique_get_offer o vente_unique_list_offers con sku) e rimandala completa con solo la modifica prevista: shop_sku, product_id e product_id_type (da product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (il suo codice), min_quantity_alert, description, discount, all_prices, available_started / available_ended (leggi come available_start_date / available_end_date) e eventuali offer_additional_fields. Lascia update_delete vuoto o update. La chiamata restituisce un import_id; la modifica viene applicata in modo asincrono, quindi controllala con vente_unique_get_offer_import prima di leggere di nuovo l'offerta. I codici di condizione per state_code provengono da vente_unique_list_offer_conditions, i codici della classe logistica da vente_unique_list_logistic_classes.
Importazioni di file: vente_unique_import_products (P41) e vente_unique_import_offers (OF01) prendono l'URL di un file CSV, XLSX o XML nel formato di file richiesto da Vente-unique; il connettore lo scarica e lo carica su Vente-unique. Tracciali con vente_unique_list_product_imports / vente_unique_get_product_import e vente_unique_list_offer_imports / vente_unique_get_offer_import.
Resi: vente_unique_list_returns (RT11) elenca le richieste di reso. Dove Vente-unique lascia decidere al negozio, vente_unique_accept_return accetta o rifiuta una in WAITING_ACCEPTANCE e vente_unique_receive_return conferma che la merce è arrivata. I rimborsi rimangono nel back office.
Messaggi: vente_unique_list_threads elenca le conversazioni (filtra con entity_type=MMP_ORDER e entity_id=<order id> per un ordine; entity_id senza entity_type viene rifiutato), vente_unique_get_thread legge una con i suoi messaggi, vente_unique_reply_thread risponde (destinatario CUSTOMER o OPERATOR, che è Vente-unique) e vente_unique_create_order_thread apre una nuova conversazione su un ordine. I codici di motivo per gli argomenti provengono da vente_unique_list_reasons; lascia il suo locale vuoto a meno che tu non sappia che il marketplace ha quella lingua (un locale inattivo risponde 400).
Denaro: vente_unique_list_invoices (IV01) elenca i documenti contabili che Vente-unique emette al negozio e vente_unique_list_transactions (TL02) le righe di transazione (vendite, commissioni, rimborsi, pagamenti). Se Vente-unique utilizza la Fatturazione Venditore Avanzata, IV01 non restituisce nuovi documenti; usa vente_unique_list_document_requests (DR11) e le transazioni poi.
Liste di riferimento: vente_unique_list_channels (siti nazionali), vente_unique_list_carriers, vente_unique_list_shipping_zones, vente_unique_list_shipping_methods e vente_unique_list_logistic_classes cambiano raramente; leggili una volta per conversazione.
Paginazione: ordini, offerte, fatture e importazioni di prodotti paginano con max (al massimo 100) e offset. Thread, resi, transazioni, richieste di documenti e importazioni di offerte restituiscono un next_page_token; passalo come page_token per ottenere la pagina successiva (tutti gli altri filtri vengono quindi ignorati) fino a quando non è mancante.
Date sono ISO 8601, ad es. 2026-10-01T00:00:00Z; le risposte sono in UTC.
Limiti di frequenza: Ogni API ha il proprio limite e Vente-unique può stringerli. L'elenco delle offerte e degli ordini è destinato all'uso interattivo, le importazioni di prodotti e offerte al massimo ogni 15 minuti, vente_unique_get_account e le liste di riferimento circa una volta al giorno. Un 429 porta un'intestazione Retry-After con i secondi da attendere; non riprovare in un loop.
Errori: 401 significa che la chiave è errata o è stata sostituita da una più recente, 403 che il tuo utente non ha il diritto per questa azione, 404 che l'ordine, l'offerta o il thread non esistono per questo negozio, 400 un parametro errato o un ordine nello stato sbagliato (il messaggio lo nomina, ad es. ORDER_INVALID_STATE).
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 mostraYOUR_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" }
}
}
}
- Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di
YOUR_MCP_API_KEY. - Salva il file e riavvia Cursor.
- Apri Cursor → Settings → MCP e verifica che
anythingmcpsia elencato e connesso. - Inizia a chattare: l'agente ora può usare i tool di
Vente-unique Marketplace.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
vente_unique_get_account | Leggi il negozio dietro la chiave API su questo marketplace (A01): id e nome del negozio, stato, canali, valuta, grado e tasso di approvazione, contatto… |
vente_unique_list_orders | Elenca gli ordini (OR11) con le loro righe, cliente, indirizzo di spedizione, prezzi, stato e incidenti. Filtra per stato (ad es. WAITING_ACCEPTANCE per… |
vente_unique_list_offers | Elenca le offerte del negozio (OF21): SKU, prodotto, prezzo e sconto, tutti i prezzi dei canali, quantità in stock, condizione, tempo di consegna e se… |
vente_unique_get_offer | Leggi un'offerta completa per il suo id offerta (OF22): ogni campo di prezzo, sconto, quantità, condizione, classe logistica, tempo di consegna e personal… |
vente_unique_list_offer_conditions | Elenca le condizioni delle offerte (OF61) che il marketplace accetta, ad es. nuovo o usato, con il codice da inserire in state_code quando si aggiornano le offerte |
vente_unique_list_offer_imports | Elenca le importazioni e gli aggiornamenti delle offerte (OF04), da file e da vente_unique_update_offers: stato (WAITING, RUNNING, COMPLETE, FAILED), righe… |
vente_unique_get_offer_import | Leggi lo stato di un'importazione di offerta o aggiornamento offerta (OF02) per il suo import_id, come restituito da vente_unique_update_offers o… |
vente_unique_export_offers | Avvia un'esportazione di tutte le offerte del negozio come file (OF52), il modo per leggere l'intero catalogo (ogni SKU con prezzo e stock) invece di scorrere vente_unique_list_offers pagina per pagina |
vente_unique_get_offer_export_status | Stato di un'esportazione di offerte avviata con vente_unique_export_offers (OF53): PENDING, COMPLETED o FAILED e, una volta completata, gli URL dei file |
vente_unique_get_offer_export_file | Leggi un file di un'esportazione di offerte completata (OF54): le offerte con SKU, prodotto, quantità, prezzi e gli altri campi esportati, in JSON o CSV |
vente_unique_list_product_imports | Elenca le importazioni di prodotti (P51) con il loro stato (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), i conteggi di trasformazione e i… |
vente_unique_get_product_import | Leggi lo stato di un'importazione di prodotto (P42) per il suo import_id: stato di importazione, motivo, conteggi di trasformazione e i dettagli di integrazione… |
vente_unique_get_products | Cerca prodotti nel catalogo del marketplace per i loro identificatori (P31), ad es. EAN, e ottieni lo SKU del prodotto del marketplace, titolo e categoria.… |
vente_unique_list_product_offers | Elenca le offerte di ogni negozio per i prodotti dati (P11), ordinati per miglior prezzo, per confrontare il tuo prezzo con la concorrenza. Fornisci product_ids… |
vente_unique_list_threads | Elenca i thread di messaggi (M11) con i clienti e Vente-unique: argomento, ordine o offerta collegata, partecipanti, data dell'ultimo messaggio e da quando un… |
vente_unique_get_thread | Leggi un thread di messaggi (M10) con tutti i suoi messaggi, mittenti, destinatari, allegati e l'ordine o l'offerta collegata |
vente_unique_list_returns | Elenca le richieste di reso (RT11) con il loro stato, righe di reso, motivo, RMA, tracciamento e l'ordine collegato. Filtra per stato, ordine o data.… |
vente_unique_list_reasons | Elenca i codici di motivo del marketplace (RE01): incidente, cancellazione, rimborso e motivi di messaggio, con le loro etichette e se il negozio può… |
vente_unique_list_carriers | Elenca i corrieri conosciuti dal marketplace (SH21) con il loro codice, etichetta e URL di tracciamento. Usa il codice come carrier_code in… |
vente_unique_list_invoices | Elenca i documenti contabili che Vente-unique emette al negozio (IV01): fatture e note di credito con periodo, totali con e senza tasse… |
vente_unique_list_transactions | Elenca le righe di transazione del negozio (TL02): importi degli ordini, spedizione, commissioni, rimborsi, crediti manuali e pagamenti, con importo, tipo… |
vente_unique_list_document_requests | Elenca le richieste di documenti contabili (DR11), utilizzate quando Vente-unique esegue la Fatturazione Venditore Avanzata: fatture e note di credito che… |
vente_unique_list_order_documents | Elenca i documenti allegati a uno o più ordini (OR72): note di consegna, etichette di spedizione, fatture clienti e altri file, con id, file… |
vente_unique_list_channels | Elenca i canali di vendita del marketplace (CH11), di solito uno per sito nazionale, con codice ed etichetta. Usa i codici come channel_codes in… |
vente_unique_list_shipping_zones | Elenca le zone di spedizione attive del marketplace (SH11) con codice ed etichetta, ad es. Francia continentale o Corsica. Cambiamenti rari: chiamalo… |
vente_unique_list_shipping_methods | Elenca i metodi di spedizione attivi del marketplace (SH12), ad es. standard, espresso o ritiro, con codice, etichetta, se un numero di tracciamento… |
vente_unique_list_logistic_classes | Elenca le classi logistiche del marketplace (SH31), le fasce di dimensione o peso che decidono i prezzi di spedizione, con codice ed etichetta. Usa il codice come… |
vente_unique_accept_order | Accetta o rifiuta le righe di un ordine in attesa di accettazione (OR21). Ogni riga dell'ordine deve essere elencata. Rifiutare una riga la annulla… |
vente_unique_update_tracking | Imposta il corriere e il numero di tracciamento di un ordine (OR23). Fornisci carrier_code da vente_unique_list_carriers, o carrier_name con carrier_url… |
vente_unique_ship_order | Conferma che un ordine in SPEDIZIONE è stato spedito (OR24); passa a SPEDITO e il cliente viene notificato. Imposta prima il tracciamento con… |
vente_unique_update_offers | Crea o aggiorna offerte, inclusi prezzo e stock (OF24). Sostituisce ogni offerta completamente: ogni campo lasciato fuori viene ripristinato (una mancante… |
vente_unique_reply_thread | Rispondi in un thread di messaggi (M12) al cliente o a Vente-unique. Il messaggio viene consegnato immediatamente e non può essere ritirato: mostra all'utente… |
vente_unique_create_order_thread | Avvia un nuovo thread di messaggi su un ordine (OR43) con il cliente, Vente-unique o entrambi. Il messaggio viene consegnato immediatamente: mostra all'utente il… |
vente_unique_resolve_incident | Contrassegna l'incidente aperto su una riga d'ordine come risolto (OR64), una volta che il problema del cliente è risolto. reason_code deve essere un INCIDENT_CLOSE… |
vente_unique_accept_return | Accetta o rifiuta una richiesta di reso in ATTESA DI ACCETTAZIONE (RT21). Solo quando Vente-unique gestisce i resi nel back office venditore e lascia… |
vente_unique_receive_return | Conferma che la merce di un reso accettato è arrivata nel tuo magazzino (RT25). Il reso passa a RICEVUTO. Agisce sul marketplace live… |
vente_unique_import_products | Invia un file di prodotto al marketplace (P41) per creare o arricchire prodotti nel suo catalogo. file_url è l'indirizzo di un CSV, XLSX o XML… |
vente_unique_import_offers | Importa un file di offerta (OF01) per creare, aggiornare o eliminare offerte in blocco. La modalità REPLACE elimina ogni offerta che non è nel file, e… |
Esempi di prompt
- "Quali ordini di Vente-unique sono in attesa della mia accettazione?"
- "Imposta il tempo di consegna della mia offerta di divano angolare SKU SOF-ANG-GRY a 15 giorni."
- "Su quali canali di vendita vende il mio negozio Vente-unique?"
- "Mostra i messaggi ai clienti sulle date di consegna che aspettano una risposta."
- "Quante offerte ha aggiornato la mia ultima importazione di offerte, e quante righe hanno fallito?"
FAQ
Dove posso ottenere la chiave API di Vente-unique? Nel back office venditore di Vente-unique: il tuo nome utente (in alto a destra), Le mie impostazioni utente, Chiave API, poi Genera una nuova chiave (o copia la chiave esistente). Generare una nuova chiave invalida quella vecchia. Gli utenti con più negozi sono comuni su Vente-unique. Con più di un negozio, imposta VENTE_UNIQUE_SHOP_ID sul negozio su cui questo connettore dovrebbe funzionare.
Chi può vendere su Vente-unique e quali paesi copre? Vente-unique accetta domande sulla sua pagina venditore. Il connettore copre Francia, Italia, Spagna, Belgio, Paesi Bassi, Germania, Portogallo, Polonia, Svizzera, Austria, Norvegia, Danimarca, Svezia, Irlanda e Regno Unito. Ulteriori paesi europei sono serviti dallo stesso negozio.
Può annullare ordini, rimborsare o eliminare offerte? Nessuno strumento rimborsa o annulla un ordine; fallo nel back office di Vente-unique. Rifiutare una riga quando si accetta un ordine la annulla definitivamente, quindi l'AI ti mostra ogni scrittura e aspetta un sì. vente_unique_import_offers è installato spento, perché la sua modalità REPLACE elimina ogni offerta che manca dal file; accendilo nella pagina del connettore solo se l'AI dovrebbe usarlo.
Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.
Prossimi passi
Questa guida ti è stata utile?