In breve
Servizi web del marketplace Spartoo per i venditori: ordini con dettagli del cliente e della consegna, accettazione e spedizione degli ordini con un numero di tracciamento, resi, stato di un prodotto sul sito e aggiornamenti di stock per taglia. Codice partner come campo del modulo, risposte XML lette come JSON.
Configurazione guidata
Collega Spartoo Marketplace a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Spartoo 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 Spartoo 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 → Spartoo Marketplace, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Spartoo Marketplace
Servizi web del marketplace Spartoo per i venditori: ordini con dettagli del cliente e della consegna, accettazione e spedizione degli ordini con un numero di tracciamento, resi, stato di un prodotto sul sito e aggiornamenti di stock per taglia. Codice partner come campo del modulo, risposte XML lette come JSON.
Configurazione
La configurazione richiede circa 3 minuti.
- Accedi al back office del marketplace Spartoo e apri Documentazione, poi Webservices e qualsiasi pagina di servizio, ad esempio Esportazione ordini.
- La riga Webservice URL indica l'indirizzo del servizio web del tuo sito Spartoo, ad esempio
https://sws.spartoo.euohttps://sws.spartoo.it. Metti la parte prima di/mp/inSPARTOO_HOST. - Nella stessa pagina la riga
partnermostra il tuo codice unico quando sei connesso. Mettilo inSPARTOO_PARTNER_KEY. Se la pagina non mostra alcun codice, chiedi al tuo contatto del marketplace Spartoo il codice del servizio web del tuo account.
Dove iniziare: spartoo_list_orders con una data di inizio. spartoo_get_order legge un ordine per il suo id.
Ordini: un ordine arriva in stato 11 (verificato). spartoo_accept_order lo sposta a 2 (in preparazione): dopo di che il suo nome, indirizzo e corriere non possono più cambiare. spartoo_ship_order lo sposta da 2 a 3 (spedito) con il numero di tracciamento del corriere, e Spartoo invia il link di tracciamento al cliente. spartoo_cancel_order (stato 41) è installato disattivato: il cliente viene rimborsato e non può essere annullato. Gli stati 45 (pacco perso) e 47 (pacco non consegnato) sono impostati da Spartoo.
Resi: spartoo_list_returns e spartoo_get_return. Un reso contiene un prodotto. Stati di reso: 2 in attesa di ricezione, 3 rifiutato, 4 pacco ricevuto e reso accettato, 5 pagato, 7 rimborso, 14 in attesa dell'etichetta di reso prepagata del commerciante. Questo connettore non accetta né rifiuta resi.
Prodotti e stock: spartoo_check_product_status indica se un prodotto è sul sito (OK), esaurito (OS), creato ma non ancora online (EC) o sconosciuto (KO), con il motivo. spartoo_update_stock imposta lo stock di una taglia. Entrambi utilizzano i tuoi riferimenti: reference_partenaire è il prodotto in un colore, size_reference una taglia di esso. Stock 0 rimuove la taglia dal sito.
Note sui campi
- Gli id degli ordini e dei resi sono codici brevi come
90D813EA1A2365A8. - Il filtro della data dell'ordine è scritto
YYYY-MM-DD:hh:mm:sscon un due punti tra giorno e ora. Il filtro della data di reso è un timestamp Unix in secondi. Spartoo non documenta il fuso orario. - I prezzi sono numeri decimali nella valuta del sito dell'ordine;
products_final_priceè il prezzo unitario scontato moltiplicato per la quantità. - Un ordine per un punto di ritiro ha
relay_infoinvece dell'indirizzo di consegna. - I valori di testo arrivano come stringhe, numeri inclusi. Un ordine o prodotto in un elenco arriva come un oggetto, diversi come un array.
Errori: ogni risposta porta un codice. 1 significa nessun errore. -1 e -2: il codice partner è mancante o sconosciuto. -3: data o id mancante. -4: formato data errato. -6 e -28: ordine o reso non trovato. -8: numero di tracciamento rifiutato. -9: l'ordine ha già quello stato. -19: ordine errato degli stati (2 solo da 11, 3 solo da 2). -14: prodotto non trovato. -16, -18 e -20: stock non cambiato (non possibile, già quel valore, o la taglia non è più valida). -30: ordine troppo vecchio per essere spedito, contatta Spartoo. -428: account disattivato. -429: troppe richieste in un'ora. Il connettore riporta un codice negativo come una chiamata fallita.
Non coperto: creazione e modifica di prodotti, prezzi e sconti (passano attraverso un file di catalogo XML), bolle di accompagnamento e decisioni sui resi.
Prerequisiti: SPARTOO_HOST, SPARTOO_PARTNER_KEY
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 Spartoo Marketplace e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
spartoo_list_orders | Elenca gli ordini effettuati da una data, eventualmente solo quelli in uno stato. Per ordine sotto root.orders.order: orders_id, clienti… |
spartoo_get_order | Legge un ordine per il suo id: dettagli del cliente e della consegna (o il punto di ritiro in relay_info), metodo di pagamento, nome e prezzo della spedizione, ordine… |
spartoo_accept_order | Accetta un nuovo ordine: lo sposta dallo stato 11 (verificato) a 2 (in preparazione). Dopo di che il nome dell'ordine, l'indirizzo di consegna e il corriere possono… |
spartoo_ship_order | Segna un ordine accettato come spedito con il numero di tracciamento del corriere: lo sposta dallo stato 2 a 3, e Spartoo invia il link di tracciamento a… |
spartoo_cancel_order | Annulla un ordine che non è stato spedito (stato 41). Il cliente non riceve l'ordine e viene rimborsato da Spartoo; non può essere annullato… |
spartoo_list_returns | Elenca i resi registrati da un momento, eventualmente solo quelli in uno stato. Per reso sotto root.returns.return: return_id… |
spartoo_get_return | Legge i resi di un ordine, o un reso per il suo id: id del reso e data, id e nome dello stato, motivo, id dell'ordine e il prodotto restituito… |
spartoo_check_product_status | Controlla se uno dei tuoi prodotti è sul sito Spartoo. Restituisce sotto root.products.product il tuo riferimento, uno stato (OK sul sito… |
spartoo_update_stock | Imposta lo stock di una taglia di un prodotto, in tempo reale. Stock 0 rimuove quella taglia dal sito; un prodotto le cui taglie sono tutte 0 va offline.… |
Esempi di richieste
- "Quali ordini Spartoo sono arrivati da lunedì e devono ancora essere accettati?"
- "Accetta l'ordine 90D813EA1A2365A8 e spediscilo con il tracciamento Royal Mail AB123456789GB."
- "Quali resi sono in attesa di ricezione?"
- "Il mio prodotto REF-BOOT-221 è online, e se no, perché?"
- "Imposta lo stock della taglia 38 di REF-BOOT-221 a 6."
Prossimi passi
Questa guida ti è stata utile?