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 Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Skroutz con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. 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 + 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.
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Skroutz. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, 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.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?