Guida al connettore5 minuti di lettura9 tool MCP7 lingue

Spartoo Marketplace MCP: ordini e scorte

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.

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

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

Spartoo Marketplace

Spartoo Marketplace

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

tool

9

Regione

INTL

Categoria

E-commerce

Autenticazione

API credentials

Env vars richieste

SPARTOO_HOSTSPARTOO_PARTNER_KEY
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

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.

Spartoo 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 → 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.

  1. Accedi al back office del marketplace Spartoo e apri Documentazione, poi Webservices e qualsiasi pagina di servizio, ad esempio Esportazione ordini.
  2. La riga Webservice URL indica l'indirizzo del servizio web del tuo sito Spartoo, ad esempio https://sws.spartoo.eu o https://sws.spartoo.it. Metti la parte prima di /mp/ in SPARTOO_HOST.
  3. Nella stessa pagina la riga partner mostra il tuo codice unico quando sei connesso. Mettilo in SPARTOO_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:ss con 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_info invece 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

StrumentoCosa fa
spartoo_list_ordersElenca gli ordini effettuati da una data, eventualmente solo quelli in uno stato. Per ordine sotto root.orders.order: orders_id, clienti…
spartoo_get_orderLegge 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_orderAccetta 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_orderSegna 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_orderAnnulla 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_returnsElenca i resi registrati da un momento, eventualmente solo quelli in uno stato. Per reso sotto root.returns.return: return_id…
spartoo_get_returnLegge 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_statusControlla se uno dei tuoi prodotti è sul sito Spartoo. Restituisce sotto root.products.product il tuo riferimento, uno stato (OK sul sito…
spartoo_update_stockImposta 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?

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.

Guide correlate

Connettori

Spartoo Marketplace MCP con ChatGPT

Servizi web del marketplace Spartoo per i venditori: ordini con dettagli del cliente e di 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.

Connettori

Spartoo Marketplace MCP con Claude

Servizi web del marketplace Spartoo per i venditori: ordini con dettagli del cliente e di 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.

Connettori

Spartoo Marketplace MCP con Microsoft Copilot

Servizi web del marketplace Spartoo per i venditori: ordini con dettagli del cliente e di 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.

Connettori

Spartoo Marketplace MCP con Cursor

Servizi web del marketplace Spartoo per i venditori: ordini con dettagli del cliente e di 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.

Connettori

Spartoo Marketplace MCP con Gemini CLI

Servizi web del marketplace Spartoo per i venditori: ordini con dettagli del cliente e di 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.

Connettori

Spartoo Marketplace MCP con Meta Muse

Servizi web del marketplace Spartoo per i venditori: ordini con dettagli del cliente e di 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.