In breve
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.
Configurazione guidata
Collega Skroutz a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Skroutz 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 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
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.
Configurazione
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 solo 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 dell'installazione legge l'ordine demo DEMO-OPEN, che prova il token del marketplace senza toccare dati reali.
Da 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 quindi 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 true, 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 false non ne hanno bisogno.
Spedizione e documenti: skroutz_update_tracking_details invia il corriere e il codice di tracciamento solo per ordini Gestiti dal Commerciante (FBM). skroutz_upload_invoice e skroutz_upload_credit_invoice richiedono 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 di reso 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, incluso 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.
Gestito da Skroutz: skroutz_list_fbs_products (stock nei magazzini di 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, nessun cambiamento 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 con il tuo numero d'ordine, con ricavi e commissioni; skroutz_reject_cps_order (disattivato) lo rifiuta affinché non venga addebitata alcuna commissione.
Note sul campo: i tempi sono ISO 8601 con il fuso orario di Atene (+02:00 in inverno, +03:00 in estate). Le 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 muove mai denaro: rifiuti, decisioni sui resi, richieste di risarcimento, ordini di acquisto e aggiornamenti di prodotti in blocco sono installati disattivati affinché un admin li attivi deliberatamente.
Prerequisiti: SKROUTZ_API_TOKEN
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 Skroutz e incolla le variabili d'ambiente elencate sotto Prerequisiti.
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 quindi 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 il slot 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 true… |
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 Gestito dal Commerciante (FBM), affinché 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 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 di… |
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 Gestiti da Skroutz (FBS) del negozio memorizzati nei magazzini di Skroutz: id, shop_uid (il tuo id prodotto), attivo (acquistabile dal… |
skroutz_list_fbs_purchase_orders | Elenca gli ordini di acquisto Gestiti da Skroutz del negozio (stock inviato ai magazzini di Skroutz): codice, created_at, expected_date e received_at.… |
skroutz_list_fbs_purchase_order_items | Elenca gli articoli di un ordine di acquisto Gestito da Skroutz: product_id, shop_uid, attivo, expected_quantity e actual_quantity… |
skroutz_create_fbs_purchase_order | Annuncia un nuovo ordine di acquisto Gestito da Skroutz: lo stock che consegnerai a un magazzino di Skroutz, con la data prevista, il fornitore… |
skroutz_list_fbs_suppliers | Elenca i fornitori Gestiti da Skroutz del negozio: id (usalo per ordini di acquisto), codice, nome, indirizzo, città, area, codice_postale, telefono… |
skroutz_create_fbs_supplier | Aggiungi un fornitore Gestito da Skroutz (che spedisce stock al magazzino di Skroutz per te) con un codice unico, nome, indirizzo, città, area, codice… |
skroutz_update_fbs_supplier | Cambia i campi di un fornitore Gestito da 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_corso 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 che proviene 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 affinché Skroutz non addebiti commissioni su di esso, con una delle sue reject_options (user_cancel, user_return, non_consegnato… |
Esempi di richieste
- "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 esaminarlo?"
- "Quante unità di ciascun prodotto ho nei magazzini di Skroutz?"
Prossimi passi
Questa guida ti è stata utile?