Resumen
Gestión de restaurantes iiko y Syrve a través de la iikoCloud API (Syrve Cloud API): organizaciones y grupos de terminales, menú y menús externos, listas de parada, pedidos de entrega y de mesa, reservas, mensajeros, tipos de pedido y pago, descuentos y clientes leales. Inicio de sesión en la API desde el back office web.
Configuración guiada
Conecta iiko a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta iiko con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para iiko
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Connectors → iiko, pega el inicio de sesión de la API y elige iiko o Syrve como host de la API y los caminos de lealtad, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
iiko
Gestión de restaurantes iiko y Syrve a través de la iikoCloud API (Syrve Cloud API): organizaciones y grupos de terminales, menú y menús externos, listas de parada, pedidos de entrega y de mesa, reservas, mensajeros, tipos de pedido y pago, descuentos y clientes leales. Inicio de sesión en la API desde el back office web.
Configuración
Configurar toma aproximadamente 5 minutos.
- Inicia sesión en el back office web (iikoWeb para iiko, Syrve Web / Syrve App para Syrve) como administrador y abre la configuración de la API en la nube (Integraciones, claves API; llamadas Configuración de API o Configuración de API en Vivo en versiones anteriores).
- Crea un inicio de sesión de API (clave API) para este conector: dale un nombre, elige las organizaciones a las que puede acceder y una fecha de caducidad (máximo 2 años). Copia la clave; una nueva clave tiene 36 caracteres y puede mostrarse solo una vez.
- Pégala en
IIKO_API_LOGIN. Elige tu producto dos veces: el host de la API enIIKO_API_HOSTy el mismo producto enIIKO_LOYALTY_API(iiko y Syrve nombran los caminos de lealtad de manera diferente). - Opcional: coloca el id de tu restaurante principal en
IIKO_ORGANIZATION_IDdespués de la primera llamadaiiko_list_organizations, para que las herramientas que toman una organización puedan omitirlo.
El conector intercambia el inicio de sesión de la API en /api/1/access_token por un token de portador que dura 1 hora y lo renueva automáticamente. iiko marca esta llamada de inicio de sesión como obsoleta a favor de /api/v2/access_token, que también necesita una aplicación registrada en el portal de desarrolladores; si iiko desactiva la llamada antigua, la verificación de configuración informa un inicio de sesión fallido.
Por dónde empezar: iiko_list_organizations proporciona los ids de organización que necesita cada herramienta. iiko_list_terminal_groups lista las instalaciones de POS de una organización y iiko_check_terminal_groups_alive indica si están en línea.
Menú: iiko_list_external_menus y iiko_get_external_menu leen los menús preparados para los canales de entrega, con precios por organización. iiko_get_nomenclature lee el menú completo del back office (grande; documentado para Syrve, ya no en la referencia de iiko, así que prefiere el menú externo en iiko). iiko_get_stop_lists muestra lo que está fuera de stock por grupo de terminal; iiko_add_to_stop_list y iiko_remove_from_stop_list lo cambian y están instalados desactivados (necesitan un inicio de sesión de API con el derecho adicional de lista de parada).
Pedidos de entrega: iiko_list_deliveries_by_date_and_status (la vista general diaria), iiko_search_deliveries (búsqueda de texto y filtro de problemas), iiko_list_deliveries_by_phone, iiko_get_deliveries_by_id. Estos están garantizados para los últimos 7 días; iiko_list_delivery_history_by_phone llega hasta 90 días. Estados: No confirmado, Esperando Cocción, Listo para Cocinar, Cocción Comenzada, Cocción Completada, Esperando, En Camino, Entregado, Cerrado, Cancelado. iiko_create_delivery y iiko_cancel_delivery están instalados desactivados: un pedido creado llega a la cocina y una cancelación no se puede deshacer.
Pedidos de mesa y reservas: iiko_get_table_orders_by_id y iiko_list_table_orders_by_table leen pedidos para comer en el local. Para reservas, iiko_list_reserve_terminal_groups, luego iiko_list_restaurant_sections (salones y mesas), iiko_list_reserves (lo que está reservado a partir de un momento) y iiko_get_reserves_by_id (los detalles). El conector no crea reservas.
Diccionarios: iiko_list_order_types, iiko_list_payment_types, iiko_list_discounts, iiko_list_cancel_causes, iiko_list_couriers. Rara vez cambian: léelos una vez por conversación, no por pedido.
Lealtad: iiko_get_customer encuentra a un cliente por teléfono, correo electrónico o número de tarjeta y muestra los saldos de la billetera; iiko_list_customer_transactions lista los movimientos de bonificación; iiko_list_customer_categories y iiko_list_loyalty_programs describen el programa. iiko_create_or_update_customer guarda los datos maestros del cliente. El conector nunca recarga, retiene o cancela una billetera y no registra pagos.
Comandos: crear o cancelar una entrega y cambiar una respuesta de lista de parada a la vez con un correlationId; el POS ejecuta el comando después. Lee el resultado con iiko_get_command_status (En Progreso, Éxito, Error).
Formatos: los ids son UUIDs. Las fechas son yyyy-MM-dd HH:mm:ss.fff sin zona horaria: los tiempos de pedido y reserva son locales para la terminal (ver la zona horaria en iiko_list_terminal_groups), las fechas de informes de lealtad son UTC. Las sumas están en la moneda de la organización. Casi cada llamada es un POST con un cuerpo JSON, también las lecturas.
Límites: iiko agrupa los métodos (diccionarios, menú, listas de parada, lectura de pedidos y otros) y limita cada grupo por intervalo de tiempo, generalmente un minuto; sobre el límite, cada llamada de ese grupo responde 429 hasta que finaliza el intervalo. Los límites para métodos de pedido y lista de parada crecen con el número de restaurantes. Pide varias organizaciones en una llamada en lugar de una llamada por cada una, almacena en caché diccionarios y menús, y no sondees pedidos individuales. Repetir solicitudes idénticas o fallidas en bloque puede bloquear el inicio de sesión de la API.
Errores: una respuesta de error tiene errorDescription y a menudo error (un código) más un correlationId para citar al soporte de iiko. 401 significa que el token o el inicio de sesión de la API fue rechazado, 400 indica el campo incorrecto, 408 significa que el POS no respondió a tiempo (el restaurante puede estar fuera de línea).
Requisitos previos: IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN
Instalar el conector 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
Abre http://localhost:3000/connectors/store, elige iiko y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
iiko_list_organizations | Lista las organizaciones (restaurantes) a las que puede acceder el inicio de sesión de la API: id, nombre y código, además de país, dirección, coordenadas, configuraciones de zona horaria… |
iiko_list_terminal_groups | Lista los grupos de terminales (las instalaciones de POS a las que se envían los pedidos) de una o más organizaciones: por organización los grupos con id… |
iiko_check_terminal_groups_alive | Verifica si los grupos de terminales están en línea en este momento: por grupo de terminal esAlive verdadero o falso. Úsalo antes de decirle a alguien que un restaurante… |
iiko_get_nomenclature | Lee el menú completo (nomenclatura) de una organización tal como se exportó desde el back office: grupos, categorías de productos, productos (platos… |
iiko_list_external_menus | Lista los menús externos (los menús preparados para sitios y aplicaciones de entrega en el back office web) y las categorías de precios de la cuenta: id… |
iiko_get_external_menu | Lee un menú externo con sus categorías de ítems, ítems, tamaños, precios por organización, grupos de modificadores, alérgenos, valores nutricionales… |
iiko_get_stop_lists | Lee las listas de parada (artículos fuera de stock): por organización y grupo de terminal los artículos con productId, sizeId, sku, balance (restante… |
iiko_list_order_types | Lista los tipos de pedido por organización: id, nombre, orderServiceType (Común para pedidos de mesa, DeliveryByCourier, DeliveryByClient para… |
iiko_list_payment_types | Lista los tipos de pago: id, código, nombre, paymentTypeKind (Efectivo, Tarjeta, Externo, Tarjeta de Lealtad y otros), paymentProcessingType, el terminal… |
iiko_list_discounts | Lista los descuentos y recargos configurados en el back office por organización: id, nombre, porcentaje o suma fija, modo, suma mínima de pedido… |
iiko_list_cancel_causes | Lista las causas de cancelación de entrega: id, nombre y isDeleted. Se necesita un id para cancelar una entrega. Solo lectura; almacena la respuesta |
iiko_list_deliveries_by_date_and_status | Lista pedidos de entrega y recogida por fecha de entrega y estado: por organización los pedidos con id, posId, creationStatus y el pedido… |
iiko_list_deliveries_by_phone | Encuentra los pedidos de entrega recientes de un número de teléfono (garantizado para los últimos 7 días): los mismos detalles del pedido que… |
iiko_list_delivery_history_by_phone | Encuentra pedidos de entrega más antiguos de un número de teléfono en el historial de pedidos (guardados 90 días): los mismos detalles del pedido, agrupados por organización, como máximo… |
iiko_search_deliveries | Busca pedidos de entrega por texto (búsqueda por prefijo en número de pedido, nombre del cliente, teléfono o dirección) con filtros por fecha, estado, tipo de servicio… |
iiko_get_deliveries_by_id | Lee hasta 200 pedidos de entrega por id: creationStatus (Éxito, En Progreso, Error con errorInfo) y el pedido completo con estado, cliente… |
iiko_get_table_orders_by_id | Lee pedidos de mesa (para comer en el local) por id: creationStatus y el pedido con tableIds, estado (Nuevo, Factura, Cerrado, Eliminado), camarero, cliente… |
iiko_list_table_orders_by_table | Lista los pedidos de mesa (para comer en el local) de mesas dadas, opcionalmente por estado y fecha de creación: los mismos detalles que iiko_get_table_orders_by_id.… |
iiko_list_reserve_terminal_groups | Lista los grupos de terminales de las organizaciones dadas que aceptan reservas de mesa y banquetes: id, nombre, dirección y zona horaria, y el… |
iiko_list_restaurant_sections | Lista las secciones del restaurante (salones) de grupos de terminales que aceptan reservas, con sus mesas: id y nombre de la sección, y por mesa id… |
iiko_list_reserves | Lista las reservas y banquetes reservados en secciones de restaurante a partir de un tiempo de inicio: id, tableIds, estimatedStartTime, durationInMinutes y… |
iiko_get_reserves_by_id | Lee reservas y banquetes por id: creationStatus, isDeleted y la reserva con cliente, teléfono, número de invitados, mesas, inicio estimado… |
iiko_list_couriers | Lista los empleados que son mensajeros de entrega, por organización: id, nombre, apellido, nombre para mostrar, código y isDeleted. Solo lectura |
iiko_get_customer | Busca un cliente de lealtad (invitado) por teléfono, correo electrónico, número de tarjeta, pista de tarjeta o id: id, nombre, apellido, teléfono, correo electrónico, cumpleaños, sexo… |
iiko_list_customer_categories | Lista las categorías de clientes (invitados) del programa de lealtad de una organización: id, nombre, isActive y isDefaultForNewGuests. Solo lectura |
iiko_list_loyalty_programs | Lista los programas de lealtad de una organización: id, nombre, descripción, programType, isActive, fechas de validez, walletId, y el marketing… |
iiko_list_customer_transactions | Lista las transacciones de lealtad de un cliente en un período (acumulaciones y cancelaciones de bonificación, recargas de billetera, cupones): tipo, typeName, suma… |
iiko_create_or_update_customer | Crea un cliente de lealtad o actualiza uno encontrado por id, teléfono o tarjeta: nombre, teléfono, correo electrónico, cumpleaños, sexo, comentario, estado de consentimiento y… |
iiko_get_command_status | Verifica el resultado de un comando (creando o cancelando una entrega, cambiando una lista de parada): estado En Progreso, Éxito o Error con… |
iiko_create_delivery | Crea un pedido de entrega o recogida en el POS. Es un comando: la respuesta lleva un correlationId y orderInfo con creationStatus… |
iiko_cancel_delivery | Cancela un pedido de entrega, con una causa de cancelación. No se puede deshacer y los artículos ya impresos se cancelan. Es un comando: verifica el… |
iiko_add_to_stop_list | Coloca productos en la lista de parada de un grupo de terminal, con la cantidad restante (0 para agotado). Los invitados ya no pueden pedir un agotado… |
iiko_remove_from_stop_list | Retira productos de la lista de parada de un grupo de terminal, para que puedan ser pedidos nuevamente. Necesita un inicio de sesión de API con el derecho adicional para cambiar la lista de parada… |
Ejemplos de solicitudes
- "¿Qué pedidos de entrega de hoy aún no están en camino, por restaurante?"
- "¿Qué hay en la lista de parada en cada grupo de terminal en este momento?"
- "¿Están en línea todos nuestros grupos de terminal POS?"
- "Muestra las reservas para esta noche a partir de las 18:00 en el restaurante principal, con salón y mesa."
- "Encuentra al invitado con teléfono 79161234567 y muestra el saldo de bonificación y las últimas transacciones."
Próximos pasos
¿Te ha sido útil esta guía?