Guida al connettore11 minuti di lettura27 tool MCP7 lingue

Skroutz MCP con Cursor: ordini e scorte

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

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

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

Skroutz

Skroutz

Skroutz Marketplace (Smart Cart) API for sellers on the Greek and Cypriot marketplace: read, accept and schedule orders, Set as Ready, tracking, invoice uploads, returns, Fulfilled by Skroutz stock, purchase orders and suppliers, bulk price and stock updates and CPS orders. API token from the merchants panel.

tool

27

Regione

INTL

Categoria

E-commerce

Autenticazione

API credentials

Env vars richieste

SKROUTZ_API_TOKEN
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 di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Configurazione guidata

Collega Skroutz a Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Skroutz 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 Skroutz

Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.

Skroutz · 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 → Skroutz, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Skroutz + Cursor

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Prerequisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nel negozio in-app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

SKROUTZ_API_TOKEN

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti.

  1. Accedi al pannello dei commercianti di Skroutz e apri Servizi, Skroutz Marketplace (la pagina delle impostazioni di Smart Cart).
  2. Genera il token API e incollalo in SKROUTZ_API_TOKEN. Un negozio ha un token attivo: generare un nuovo token termina il precedente, quindi un token utilizzato da un'altra integrazione smette di funzionare lì.
  3. Facoltativo, per aggiornamenti di prezzo e stock in blocco: in Prodotti, Aggiornamenti Feed genera il token API Prodotti e incollalo in SKROUTZ_PRODUCTS_TOKEN.
  4. Facoltativo, per ordini CPS del tuo negozio online: in Παραγγελίες καταστήματος, Αυτόματη διαχείριση (ordini del negozio, gestione automatica) genera il token CPS e incollalo in SKROUTZ_CPS_TOKEN.

Ogni chiamata invia il token come Authorization: Bearer con il tipo di media application/vnd.skroutz+json; version=3.0. Il controllo di installazione legge l'ordine demo DEMO-OPEN, che prova il token del marketplace senza toccare dati reali.

Dove iniziare: l'API non ha una lista di ordini. Gli ordini raggiungono un negozio tramite il webhook degli ordini, il pannello dei commercianti e le email degli ordini, quindi chiedi all'utente il codice dell'ordine (come 191128-1234567) e leggilo con skroutz_get_order. I codici demo DEMO-OPEN, DEMO-ACCEPTED, DEMO-REJECTED, DEMO-INVOICE, DEMO-FBS, DEMO-STORE-PICKUP e DEMO-RETURN sono sicuri da leggere, accettare e rifiutare per testare: nulla viene memorizzato.

Ordini: un ordine aperto porta accept_options e reject_options e deve essere gestito prima di expires_at. Accettalo con skroutz_accept_order, inviando un id della posizione di ritiro e l'id di una delle finestre di ritiro di quella posizione (le finestre differiscono per posizione). Skroutz poi prenota il corriere e il PDF del voucher appare in courier_voucher. Gli ordini espressi vengono accettati automaticamente da Skroutz. skroutz_reject_order è installato disattivato: un rifiuto non può essere annullato e conta contro il negozio. Per cambiare il ritiro di un ordine accettato, leggilo con action_options 1 subito prima e usa skroutz_reschedule_order_pickup (una data da reschedule_options) o skroutz_relocate_order_pickup (un id da relocate_options); le liste si riducono nel tempo. skroutz_request_preorder_voucher crea il voucher di un preorder accettato in anticipo.

Imposta come Pronto: quando un ordine mostra set_as_ready_required vero, Skroutz Last Mile lo ritira solo dopo skroutz_set_order_ready; scaricare il voucher non lo segna più come pronto (dal 30 marzo 2026). Segnare in anticipo può spostare il ritiro a una finestra precedente. skroutz_set_order_not_ready annulla prima del ritiro. I negozi con set_as_ready_required falso non ne hanno bisogno.

Spedizione e documenti: skroutz_update_tracking_details invia il corriere e il codice di tracciamento per gli ordini Fulfilled by Merchant (FBM) solo. skroutz_upload_invoice e skroutz_upload_credit_invoice prendono un link pubblico al PDF, PNG o JPG (massimo 7 MB); il connettore lo scarica e carica il file, uno per ordine, sostituendo un caricamento precedente.

Resi: skroutz_get_return legge un reso tramite il suo codice (come R-111111-1111111, dal webhook dei resi o dal pannello dei commercianti; i returns di un ordine forniscono solo un uuid e id di tracciamento). skroutz_handle_return (decidi un reso in attesa di revisione prima di review.expires_at, inclusa l'invio di una parte mancante a spese del negozio) e skroutz_submit_service_inspection (rapporto tecnico su un articolo difettoso, come link a un file) sono installati disattivati, perché portano a rimborsi, sostituzioni o spedizioni a pagamento. skroutz_file_compensation_request è disattivato anch'esso: richiede denaro a Skroutz per articoli restituiti, e tramite questo connettore solo per motivi che non necessitano foto.

Fulfilled by Skroutz: skroutz_list_fbs_products (stock nei magazzini Skroutz), skroutz_list_fbs_purchase_orders, skroutz_list_fbs_purchase_order_items, skroutz_list_fbs_suppliers, skroutz_create_fbs_supplier e skroutz_update_fbs_supplier. skroutz_create_fbs_purchase_order è disattivato, perché le spese di magazzino derivano da esso. Le liste sono paginate con page e vengono con meta.pagination (100 righe a pagina). Un negozio senza FBS riceve 401 qui.

API Prodotti (richiede SKROUTZ_PRODUCTS_TOKEN): skroutz_validate_product_updates controlla un lotto senza cambiare nulla; skroutz_update_products (disattivato) aggiorna disponibilità, prezzo e quantità di fino a 500 prodotti esistenti e variazioni, in modo asincrono; skroutz_get_product_update_status riporta successo, no_change o fallimento per prodotto. I prezzi qui sono centesimi di euro interi (1050 è 10,50 EUR), mentre gli importi degli ordini sono in euro decimali. Non crea prodotti: quelli provengono dal feed XML. Un 422 che dice che l'XML è in fase di scansione significa riprovare più tardi.

Ordini CPS (richiede SKROUTZ_CPS_TOKEN): skroutz_get_cps_order legge una vendita del tuo negozio online tramite il tuo numero d'ordine, con ricavi e commissioni; skroutz_reject_cps_order (disattivato) lo rifiuta in modo che non venga addebitata alcuna commissione.

Note di campo: i tempi sono ISO 8601 con il fuso orario di Atene (+02:00 in inverno, +03:00 in estate). Etichette come finestre di ritiro, motivi di rifiuto e stati CPS sono in greco. Gli id degli articoli sono stringhe brevi (l39vKqxqwe); shop_uid è il tuo id prodotto. Gli errori portano un array errors con un code e messages: 422 order_status significa che l'ordine non è in uno stato per quell'azione. Un token marketplace errato o sostituito risponde 403. Il connettore non gestisce mai denaro: rifiuti, decisioni sui resi, richieste di risarcimento, ordini di acquisto e aggiornamenti di prodotto in blocco sono installati disattivati affinché un admin possa attivarli deliberatamente.

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 Skroutz.

Strumenti disponibili

StrumentoCosa fa
skroutz_get_orderLeggi un ordine di Skroutz Marketplace (Smart Cart) tramite il suo codice: stato (aperto, accettato, rifiutato, annullato, scaduto, spedito, consegnato…
skroutz_accept_orderAccetta un ordine aperto: Skroutz poi prenota il corriere e emette il voucher (arriva sull'ordine come courier_voucher). Invia un…
skroutz_reject_orderRifiuta un ordine aperto, sia per articolo con un id di motivo da reject_options (con available_quantity quando il motivo ha…
skroutz_reschedule_order_pickupSposta il ritiro del corriere di un ordine accettato a un'altra data. Leggi l'ordine con action_options 1 subito prima e invia uno dei suoi…
skroutz_relocate_order_pickupSposta il ritiro del corriere di un ordine accettato a un'altra delle posizioni di ritiro del negozio, mantenendo la data e la fascia oraria di ritiro. Il corriere è…
skroutz_set_order_readySegna un ordine accettato come imballato e pronto per la spedizione (Imposta come Pronto). Richiesto per i negozi i cui ordini mostrano set_as_ready_required vero…
skroutz_set_order_not_readyAnnulla Imposta come Pronto su un ordine accettato che il corriere non ha ancora ritirato. Skroutz cerca di spostare il ritiro alla data originale.…
skroutz_update_tracking_detailsInvia il corriere e il codice di tracciamento di ciascuna spedizione di un ordine Fulfilled by Merchant (FBM), in modo che il cliente possa seguirlo. Solo per FBM…
skroutz_request_preorder_voucherRichiedi ora il voucher del corriere di un preorder accettato, quando il prodotto è arrivato prima della data di spedizione pianificata (il pannello Crea…
skroutz_upload_invoiceCarica la ricevuta o la fattura di un ordine da un link al file (PDF, PNG o JPG, massimo 7 MB). Un file per ordine: un nuovo caricamento…
skroutz_upload_credit_invoiceCarica la fattura di credito di un ordine che è stato annullato, restituito, parzialmente restituito o restituito al mittente dopo la sua ricevuta o fattura…
skroutz_file_compensation_requestChiedi a Skroutz di risarcire il negozio per articoli restituiti, inviati come JSON senza foto, quindi solo per motivi che non necessitano…
skroutz_get_returnLeggi un reso tramite il suo codice: stato (in attesa di revisione del commerciante, in restituzione, in attesa di revisione fisica, in attesa di ispezione del servizio, restituito…
skroutz_handle_returnDecidi un reso in stato di attesa di revisione del commerciante con una delle sue handle_options: approva, un rifiuto come non difettoso (con commento quando…
skroutz_submit_service_inspectionInvia il risultato dell'ispezione tecnica di un articolo restituito difettoso (reso in stato di attesa di ispezione del servizio): l'id dell'articolo, uno dei suoi…
skroutz_list_fbs_productsElenca i prodotti Fulfilled by Skroutz (FBS) del negozio memorizzati nei magazzini Skroutz: id, shop_uid (il tuo id prodotto), attivo (acquistabile dal…
skroutz_list_fbs_purchase_ordersElenca gli ordini di acquisto Fulfilled by Skroutz del negozio (stock inviato ai magazzini Skroutz): codice, created_at, expected_date e received_at.…
skroutz_list_fbs_purchase_order_itemsElenca gli articoli di un ordine di acquisto Fulfilled by Skroutz: product_id, shop_uid, attivo, expected_quantity e actual_quantity…
skroutz_create_fbs_purchase_orderAnnuncia un nuovo ordine di acquisto Fulfilled by Skroutz: lo stock che consegnerai a un magazzino Skroutz, con la data prevista, il fornitore…
skroutz_list_fbs_suppliersElenca i fornitori Fulfilled by Skroutz del negozio: id (usalo per ordini di acquisto), codice, nome, indirizzo, città, area, codice_postale, telefono…
skroutz_create_fbs_supplierAggiungi un fornitore Fulfilled by Skroutz (che spedisce stock al magazzino Skroutz per te) con un codice unico, nome, indirizzo, città, area, codice…
skroutz_update_fbs_supplierCambia i campi di un fornitore Fulfilled by Skroutz; solo i campi che invii cambiano. Risponde success: true
skroutz_validate_product_updatesControlla un lotto di aggiornamenti di prodotto (disponibilità, prezzo in centesimi, quantità, variazioni) senza cambiare nulla: Skroutz esegue ogni controllo…
skroutz_update_productsAggiorna disponibilità, prezzo (centesimi di euro) e quantità di fino a 500 prodotti esistenti e le loro variazioni in un lotto; non crea…
skroutz_get_product_update_statusLeggi l'esito di un aggiornamento di lotto di prodotto: stato (in_progress mentre qualsiasi prodotto è in attesa, poi completato), created_at, e per prodotto…
skroutz_get_cps_orderLeggi un ordine CPS (una vendita nel tuo negozio online proveniente da Skroutz, pagata tramite commissione) tramite il codice d'ordine che il tuo negozio gli ha dato: data…
skroutz_reject_cps_orderRifiuta un ordine CPS in modo che Skroutz non addebiti commissioni su di esso, con una delle sue reject_options (user_cancel, user_return, non consegnato…

Esempi di prompt

  • "Mostra l'ordine 251114-3920517 con i suoi articoli, le sue opzioni di ritiro e quando scade."
  • "Accetta l'ordine 251114-3920517 per la prima finestra di ritiro del mio magazzino di Atene."
  • "L'ordine 251112-1187340 ha bisogno di Imposta come Pronto: è pronto per essere segnato, e quando è il ritiro?"
  • "Cosa dice il reso R-251110-2045318, e entro quando devo rivederlo?"
  • "Quante unità di ciascun prodotto ho nei magazzini Skroutz?"

FAQ

Da dove provengono i token? Dal pannello dei commercianti di Skroutz, e sono tre token separati: il token API del marketplace sotto Servizi, Skroutz Marketplace (ordini, resi, Fulfilled by Skroutz), il token API Prodotti facoltativo sotto Prodotti, Aggiornamenti Feed per aggiornamenti di prezzo e stock in blocco, e il token CPS facoltativo per ordini del tuo negozio online. Generare un nuovo token marketplace termina il vecchio.

Può elencare i miei ordini? No. L'API di Skroutz non ha una lista di ordini: gli ordini raggiungono un negozio tramite il webhook, il pannello dei commercianti e le email degli ordini. Dai all'AI il codice dell'ordine (come 251114-3920517) e legge l'ordine. I codici demo come DEMO-OPEN sono sicuri per i test.

Quali strumenti sono installati disattivati? skroutz_reject_order e skroutz_reject_cps_order, perché un rifiuto non può essere annullato, gli strumenti per i resi skroutz_handle_return, skroutz_submit_service_inspection e skroutz_file_compensation_request, skroutz_create_fbs_purchase_order, che porta a spese di magazzino, e skroutz_update_products.

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 Skroutz a Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Skroutz con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. Senza codice e senza server da gestire.

Guide correlate

Connettori

Skroutz MCP con ChatGPT: ordini e scorte

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Connettori

Skroutz MCP con Claude: ordini e scorte

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Connettori

Skroutz MCP con Microsoft Copilot

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Connettori

Skroutz MCP con Gemini CLI: ordini e scorte

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Connettori

Skroutz MCP con Meta Muse: ordini e scorte

API di Skroutz Marketplace (Smart Cart) per i venditori nel mercato greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Fulfilled by Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.

Connettori

Skroutz MCP server: ordini, scorte e resi

API di Skroutz Marketplace (Smart Cart) per venditori nel marketplace greco e cipriota: leggi, accetta e programma ordini, Imposta come Pronto, tracciamento, caricamenti di fatture, resi, stock Gestito da Skroutz, ordini di acquisto e fornitori, aggiornamenti di prezzo e stock in blocco e ordini CPS. Token API dal pannello dei commercianti.