Guida al connettore9 minuti di lettura27 tool MCP7 lingue

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.

HCA cura del team HelpCodeAggiornato 9 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 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.

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

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.

  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 solo 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 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

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 quindi 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 il slot 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 true…
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 Gestito dal Commerciante (FBM), affinché 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 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 di…
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 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_ordersElenca 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_itemsElenca gli articoli di un ordine di acquisto Gestito da Skroutz: product_id, shop_uid, attivo, expected_quantity e actual_quantity…
skroutz_create_fbs_purchase_orderAnnuncia 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_suppliersElenca i fornitori Gestiti da Skroutz del negozio: id (usalo per ordini di acquisto), codice, nome, indirizzo, città, area, codice_postale, telefono…
skroutz_create_fbs_supplierAggiungi 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_supplierCambia i campi di un fornitore Gestito da 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_corso 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 che proviene 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 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?

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.

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

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.