In breve
Gestione dei ristoranti iiko e Syrve tramite l'iikoCloud API (Syrve Cloud API): organizzazioni e gruppi di terminali, menu e menu esterni, liste di stop, ordini di consegna e al tavolo, prenotazioni, corrieri, tipi di ordine e pagamento, sconti e clienti fedeli. Accesso API dal back office web.
Configurazione guidata
Collega iiko a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega iiko 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 iiko
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 Connectors → iiko, incolla il login API e scegli iiko o Syrve come host API e i percorsi di fedeltà, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
iiko
Gestione dei ristoranti iiko e Syrve tramite l'iikoCloud API (Syrve Cloud API): organizzazioni e gruppi di terminali, menu e menu esterni, liste di stop, ordini di consegna e al tavolo, prenotazioni, corrieri, tipi di ordine e pagamento, sconti e clienti fedeli. Accesso API dal back office web.
Configurazione
La configurazione richiede circa 5 minuti.
- Accedi al back office web (iikoWeb per iiko, Syrve Web / Syrve App per Syrve) come amministratore e apri le impostazioni dell'API cloud (Integrazioni, chiavi API; chiamate Impostazioni API o Impostazioni API Live nelle versioni precedenti).
- Crea un login API (chiave API) per questo connettore: dagli un nome, scegli le organizzazioni a cui può accedere e una data di scadenza (massimo 2 anni). Copia la chiave; una nuova chiave è lunga 36 caratteri e può essere mostrata solo una volta.
- Incollala in
IIKO_API_LOGIN. Scegli il tuo prodotto due volte: l'host API inIIKO_API_HOSTe lo stesso prodotto inIIKO_LOYALTY_API(iiko e Syrve nominano i percorsi di fedeltà in modo diverso). - Facoltativo: inserisci l'id del tuo ristorante principale in
IIKO_ORGANIZATION_IDdopo la prima chiamataiiko_list_organizations, in modo che gli strumenti che richiedono un'organizzazione possano ometterlo.
Il connettore scambia il login API a /api/1/access_token per un token bearer che dura 1 ora e lo rinnova automaticamente. iiko segna questa chiamata di login come deprecata a favore di /api/v2/access_token, che necessita anche di un'app registrata nel portale sviluppatori; se iiko disattiva la vecchia chiamata, il controllo della configurazione riporta un login fallito.
Da dove iniziare: iiko_list_organizations fornisce gli id delle organizzazioni di cui ogni altro strumento ha bisogno. iiko_list_terminal_groups elenca le installazioni POS di un'organizzazione e iiko_check_terminal_groups_alive indica se sono online.
Menu: iiko_list_external_menus e iiko_get_external_menu leggono i menu preparati per i canali di consegna, con prezzi per organizzazione. iiko_get_nomenclature legge il menu completo del back office (grande; documentato per Syrve, non più nel riferimento iiko, quindi preferisci il menu esterno su iiko). iiko_get_stop_lists mostra cosa è esaurito per gruppo di terminali; iiko_add_to_stop_list e iiko_remove_from_stop_list lo modificano e sono installati disattivati (richiedono un login API con il diritto extra della lista di stop).
Ordini di consegna: iiko_list_deliveries_by_date_and_status (la panoramica giornaliera), iiko_search_deliveries (ricerca testuale e filtro problemi), iiko_list_deliveries_by_phone, iiko_get_deliveries_by_id. Questi sono garantiti per gli ultimi 7 giorni; iiko_list_delivery_history_by_phone risale a 90 giorni. Stati: Non confermato, InAttesaCottura, ProntoPerCottura, CotturaIniziata, CotturaCompletata, InAttesa, InViaggio, Consegnato, Chiuso, Annullato. iiko_create_delivery e iiko_cancel_delivery sono installati disattivati: un ordine creato raggiunge la cucina e un'annullamento non può essere annullato.
Ordini al tavolo e prenotazioni: iiko_get_table_orders_by_id e iiko_list_table_orders_by_table leggono gli ordini per il consumo in loco. Per le prenotazioni, iiko_list_reserve_terminal_groups, poi iiko_list_restaurant_sections (sale e tavoli), iiko_list_reserves (cosa è prenotato da un certo orario) e iiko_get_reserves_by_id (i dettagli). Il connettore non crea prenotazioni.
Dizionari: iiko_list_order_types, iiko_list_payment_types, iiko_list_discounts, iiko_list_cancel_causes, iiko_list_couriers. Cambiano raramente: leggili una volta per conversazione, non per ordine.
Fedeltà: iiko_get_customer trova un ospite tramite telefono, email o carta e mostra i saldi del portafoglio; iiko_list_customer_transactions elenca i movimenti bonus; iiko_list_customer_categories e iiko_list_loyalty_programs descrivono il programma. iiko_create_or_update_customer salva i dati anagrafici dell'ospite. Il connettore non ricarica, non detiene né annulla un portafoglio e non registra pagamenti.
Comandi: creare o annullare una consegna e modificare una risposta della lista di stop in una volta con un correlationId; il POS esegue il comando successivamente. Leggi il risultato con iiko_get_command_status (InCorso, Successo, Errore).
Formati: gli id sono UUID. Le date sono yyyy-MM-dd HH:mm:ss.fff senza fuso orario: gli orari di ordine e prenotazione sono locali per il terminale (vedi il fuso orario in iiko_list_terminal_groups), le date del report di fedeltà sono UTC. Le somme sono nella valuta dell'organizzazione. Quasi ogni chiamata è un POST con un corpo JSON, anche le letture.
Limiti: iiko raggruppa i metodi (dizionari, menu, liste di stop, lettura ordini e altri) e limita ogni gruppo per intervallo di tempo, di solito un minuto; oltre il limite ogni chiamata di quel gruppo risponde 429 fino alla fine dell'intervallo. I limiti per i metodi di ordine e lista di stop crescono con il numero di ristoranti. Richiedi più organizzazioni in una chiamata invece di una chiamata ciascuna, memorizza in cache dizionari e menu, e non interrogare singoli ordini. Ripetere richieste identiche o fallite in blocco può bloccare il login API.
Errori: una risposta di errore ha errorDescription e spesso error (un codice) più un correlationId da citare al supporto iiko. 401 significa che il token o il login API è stato rifiutato, 400 indica il campo errato, 408 significa che il POS non ha risposto in tempo (il ristorante potrebbe essere offline).
Requisiti: IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN
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 iiko e incolla le variabili d'ambiente elencate sotto Requisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
iiko_list_organizations | Elenca le organizzazioni (ristoranti) a cui il login API può accedere: id, nome e codice, più paese, indirizzo, coordinate, impostazioni del fuso orario… |
iiko_list_terminal_groups | Elenca i gruppi di terminali (le installazioni POS a cui vengono inviati gli ordini) di una o più organizzazioni: per organizzazione i gruppi con id… |
iiko_check_terminal_groups_alive | Controlla se i gruppi di terminali sono online in questo momento: per gruppo di terminali isAlive vero o falso. Usalo prima di dire a qualcuno un ristorante… |
iiko_get_nomenclature | Legge il menu completo (nomenclatura) di un'organizzazione come esportato dal back office: gruppi, categorie di prodotto, prodotti (piatti… |
iiko_list_external_menus | Elenca i menu esterni (i menu preparati per i siti e le app di consegna nel back office web) e le categorie di prezzo dell'account: id… |
iiko_get_external_menu | Legge un menu esterno con le sue categorie di elementi, articoli, dimensioni, prezzi per organizzazione, gruppi di modificatori, allergeni, valori nutrizionali… |
iiko_get_stop_lists | Legge le liste di stop (articoli esauriti): per organizzazione e gruppo di terminali gli articoli con productId, sizeId, sku, saldo (rimanente… |
iiko_list_order_types | Elenca i tipi di ordine per organizzazione: id, nome, orderServiceType (Comune per ordini al tavolo, DeliveryByCourier, DeliveryByClient per… |
iiko_list_payment_types | Elenca i tipi di pagamento: id, codice, nome, paymentTypeKind (Contante, Carta, Esterno, CartaFedeltà e altri), paymentProcessingType, il terminale… |
iiko_list_discounts | Elenca gli sconti e i sovrapprezzi impostati nel back office per organizzazione: id, nome, percentuale o somma fissa, modalità, somma minima dell'ordine… |
iiko_list_cancel_causes | Elenca le cause di cancellazione della consegna: id, nome e isDeleted. È necessario un id per annullare una consegna. Solo lettura; memorizza la risposta |
iiko_list_deliveries_by_date_and_status | Elenca gli ordini di consegna e ritiro per data di consegna e stato: per organizzazione gli ordini con id, posId, creationStatus e l'ordine… |
iiko_list_deliveries_by_phone | Trova gli ordini di consegna recenti di un numero di telefono (garantito per gli ultimi 7 giorni): gli stessi dettagli dell'ordine come… |
iiko_list_delivery_history_by_phone | Trova ordini di consegna più vecchi di un numero di telefono nella cronologia degli ordini (conservati per 90 giorni): gli stessi dettagli dell'ordine, raggruppati per organizzazione, al massimo… |
iiko_search_deliveries | Cerca ordini di consegna per testo (ricerca per prefisso su numero d'ordine, nome cliente, telefono o indirizzo) con filtri per data, stato, tipo di servizio… |
iiko_get_deliveries_by_id | Legge fino a 200 ordini di consegna per id: creationStatus (Successo, InCorso, Errore con errorInfo) e l'ordine completo con stato, cliente… |
iiko_get_table_orders_by_id | Legge ordini al tavolo (per consumo in loco) per id: creationStatus e l'ordine con tableIds, stato (Nuovo, Fattura, Chiuso, Eliminato), cameriere, cliente… |
iiko_list_table_orders_by_table | Elenca gli ordini al tavolo (per consumo in loco) di tavoli dati, eventualmente per stato e data di creazione: gli stessi dettagli di iiko_get_table_orders_by_id.… |
iiko_list_reserve_terminal_groups | Elenca i gruppi di terminali delle organizzazioni date che accettano prenotazioni di tavoli e banchetti: id, nome, indirizzo e fuso orario, e il… |
iiko_list_restaurant_sections | Elenca le sezioni del ristorante (sale) dei gruppi di terminali che accettano prenotazioni, con i loro tavoli: id e nome della sezione, e per tavolo id… |
iiko_list_reserves | Elenca le prenotazioni e i banchetti prenotati nelle sezioni del ristorante da un orario di inizio: id, tableIds, estimatedStartTime, durationInMinutes e… |
iiko_get_reserves_by_id | Legge prenotazioni e banchetti per id: creationStatus, isDeleted e la riserva con cliente, telefono, numero di ospiti, tavoli, orario di inizio stimato… |
iiko_list_couriers | Elenca i dipendenti che sono corrieri di consegna, per organizzazione: id, nome, cognome, nome visualizzato, codice e isDeleted. Solo lettura |
iiko_get_customer | Cerca un cliente fedeltà (ospite) tramite telefono, email, numero di carta, tracciato carta o id: id, nome, cognome, telefono, email, compleanno, sesso… |
iiko_list_customer_categories | Elenca le categorie di clienti (ospiti) del programma di fedeltà di un'organizzazione: id, nome, isActive e isDefaultForNewGuests. Solo lettura |
iiko_list_loyalty_programs | Elenca i programmi di fedeltà di un'organizzazione: id, nome, descrizione, programType, isActive, date di validità, walletId, e il marketing… |
iiko_list_customer_transactions | Elenca le transazioni di fedeltà di un cliente in un periodo (accrediti e addebiti bonus, ricariche portafoglio, coupon): tipo, typeName, somma… |
iiko_create_or_update_customer | Crea un cliente fedeltà o aggiorna uno trovato per id, telefono o carta: nome, telefono, email, compleanno, sesso, commento, stato di consenso e… |
iiko_get_command_status | Controlla il risultato di un comando (creazione o cancellazione di una consegna, modifica di una lista di stop): stato InCorso, Successo o Errore con… |
iiko_create_delivery | Crea un ordine di consegna o ritiro nel POS. È un comando: la risposta porta un correlationId e orderInfo con creationStatus… |
iiko_cancel_delivery | Annulla un ordine di consegna, con una causa di annullamento. Non può essere annullato e gli articoli già stampati vengono scritti off. È un comando: controlla il… |
iiko_add_to_stop_list | Metti prodotti nella lista di stop di un gruppo di terminali, con la quantità rimanente (0 per esaurito). Gli ospiti non possono più ordinare un esaurito… |
iiko_remove_from_stop_list | Rimuovi prodotti dalla lista di stop di un gruppo di terminali, in modo che possano essere ordinati di nuovo. Richiede un login API con il diritto extra di modificare la lista di stop… |
Esempi di richieste
- "Quali ordini di consegna di oggi non sono ancora in viaggio, per ristorante?"
- "Cosa c'è nella lista di stop in ciascun gruppo di terminali in questo momento?"
- "Tutti i nostri gruppi di terminali POS sono online?"
- "Mostra le prenotazioni per stasera dalle 18:00 nel ristorante principale, con sala e tavolo."
- "Trova l'ospite con telefono 79161234567 e mostra il saldo bonus e le ultime transazioni."
Prossimi passi
Questa guida ti è stata utile?