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 Meta Muse in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Skroutz con la configurazione guidata e aggiungi il tuo URL MCP a Meta Muse. 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.
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 + Meta Muse
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.
- Accedi al pannello dei commercianti di Skroutz e apri Servizi, Skroutz Marketplace (la pagina delle impostazioni di Smart Cart).
- 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ì. - Facoltativo, per aggiornamenti di prezzo e stock in blocco: in Prodotti, Aggiornamenti Feed genera il token API Prodotti e incollalo in
SKROUTZ_PRODUCTS_TOKEN. - 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 Muse
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.
Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.
- In Muse apri Settings → Connectors e scegli Add custom connector.
- Incolla l'URL del server MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
- In una chat, chiedi a Muse qualcosa che richiede i tool di
Skroutz.
Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
skroutz_get_order | Leggi un ordine di Skroutz Marketplace (Smart Cart) tramite il suo codice: stato (aperto, accettato, rifiutato, annullato, scaduto, spedito, consegnato… |
skroutz_accept_order | Accetta un ordine aperto: Skroutz poi prenota il corriere e emette il voucher (arriva sull'ordine come courier_voucher). Invia un… |
skroutz_reject_order | Rifiuta un ordine aperto, sia per articolo con un id di motivo da reject_options (con available_quantity quando il motivo ha… |
skroutz_reschedule_order_pickup | Sposta 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_pickup | Sposta 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_ready | Segna 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_ready | Annulla 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_details | Invia 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_voucher | Richiedi ora il voucher del corriere di un preorder accettato, quando il prodotto è arrivato prima della data di spedizione pianificata (il pannello Crea… |
skroutz_upload_invoice | Carica 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_invoice | Carica 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_request | Chiedi a Skroutz di risarcire il negozio per articoli restituiti, inviati come JSON senza foto, quindi solo per motivi che non necessitano… |
skroutz_get_return | Leggi 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_return | Decidi 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_inspection | Invia 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_products | Elenca 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_orders | Elenca 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_items | Elenca gli articoli di un ordine di acquisto Fulfilled by Skroutz: product_id, shop_uid, attivo, expected_quantity e actual_quantity… |
skroutz_create_fbs_purchase_order | Annuncia 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_suppliers | Elenca i fornitori Fulfilled by Skroutz del negozio: id (usalo per ordini di acquisto), codice, nome, indirizzo, città, area, codice_postale, telefono… |
skroutz_create_fbs_supplier | Aggiungi 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_supplier | Cambia i campi di un fornitore Fulfilled by Skroutz; solo i campi che invii cambiano. Risponde success: true |
skroutz_validate_product_updates | Controlla un lotto di aggiornamenti di prodotto (disponibilità, prezzo in centesimi, quantità, variazioni) senza cambiare nulla: Skroutz esegue ogni controllo… |
skroutz_update_products | Aggiorna 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_status | Leggi 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_order | Leggi 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_order | Rifiuta 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.
Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.
Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.
Prossimi passi
Questa guida ti è stata utile?