Integración · Operar tienda y pedidos
Fudo API: alcance técnico sujeto a homologación
Alcance técnico estudiado para la API de Fudo: menú, mesas y comandas de salón. Meteor no está homologado por Fudo y hoy no ofrece esta integración.
¿Cómo se conecta Fudo con Meteor?
Esta ficha describe un conector técnico de Meteor construido contra el OpenAPI público de Fudo; no es documentación oficial de Fudo, una integración homologada ni una función disponible para contratar. Meteor no aparece en la lista publicada de partners oficiales de Fudo. El código contempla 7 herramientas para leer menú y mesas, crear y ampliar comandas de salón y consultar el estado de cada plato. No cubre domicilio, para llevar, cobros o caja. La API pública general de Fudo está incluida en Plan Pro, pero Fudo limita las conexiones de sitios propios a desarrollos de uso único del restaurante sin intermediarios y advierte que las integraciones ofrecidas que no aparecen en su listado no están homologadas. Por eso no se conectan credenciales ni se promete implementación hasta contar con autorización u homologación de Fudo y validar el contrato contra una cuenta real.
Alcance estudiado
Lo que contempla el conector técnico de Fudo
Alcance diseñado: de la conversación a la cocina
El código busca cada producto en el menú, toma la mesa del salón y crea la comanda con sus líneas para evitar una transcripción manual. Esto describe el alcance implementado en el conector; no significa que Meteor esté homologado por Fudo ni que hoy pueda conectarlo a una cuenta de un cliente.
El precio sale de la carta, no del modelo
En el diseño técnico, cada plato se carga por su identificador de Fudo y el importe lo pone el producto cargado allí. El modelo no calcula ni redondea totales, y si la búsqueda no encuentra lo pedido, la herramienta devuelve una advertencia en vez de invitar a improvisar.
«¿Cómo va mi pedido?», respondido plato por plato
La herramienta de consulta lee el estado de cada línea: pendiente, preparándose, listo o servido. Ese es el dato que el diseño entregaría al agente en vez de resumir una comanda con un único «en curso» que oculta que los platos avanzan a ritmos distintos.
El cliente pidió algo más
El diseño permite agregar líneas a una comanda abierta, con una aclaración para la cocina cuando hace falta, sin abrir una segunda venta sobre la misma mesa. Sigue limitado a consumo en salón y sujeto a la autorización de Fudo antes de cualquier uso real.
Encontrar la comanda cuando nadie recuerda su número
La herramienta lista las comandas en curso, de la más reciente a la más vieja, para que el diseño pueda ubicar una venta por mesa y hora antes de consultarla o agregarle algo.
7 herramientas
Herramientas implementadas en el conector de Fudo
Son capacidades del código, no una integración disponible para clientes hasta recibir autorización.
| Herramienta | Qué hace |
|---|---|
fudo_listar_categorias | Lista las categorías del menú (entradas, principales, bebidas) con su orden de carta y la cocina a la que se despacha cada una. |
fudo_buscar_productos | Busca platos y bebidas por nombre o por categoría y devuelve su identificador, su precio y si están activos en la carta. Es de donde sale el identificador que pide la comanda. |
fudo_listar_mesas | Lista las mesas con su número y su salón, y marca cuáles tienen una venta abierta cuando Fudo devuelve ese dato. |
fudo_crear_comanda | Crea la comanda de salón sobre una mesa y le carga los platos, que es lo que hace que el pedido llegue a la cocina. Exige la mesa y la cantidad de comensales. |
fudo_agregar_a_comanda | Agrega platos a una comanda que ya está abierta, cuando el cliente pide algo más. |
fudo_consultar_pedido | Devuelve el estado de una comanda, su total, su mesa y en qué va cada plato en la cocina: pendiente, preparándose, listo o servido. |
fudo_listar_pedidos_abiertos | Lista las comandas en curso del local, de la más reciente a la más vieja, para encontrar la de una mesa cuando no tienes su identificador. |
Los límites
Qué NO hace la integración con Fudo
Preferimos decirlo aquí que descubrirlo en la implementación.
-
No es una integración homologada ni disponible para contratar. Meteor no aparece en la lista de partners oficiales de Fudo; Fudo advierte que no brinda soporte ni se responsabiliza por integraciones ofrecidas fuera de ese listado.
-
No toma pedidos a domicilio ni para llevar. Esta API de Fudo solo acepta crear ventas de salón y exige la mesa; los pedidos que no se consumen en el local viven en otra API distinta de Fudo, que no está integrada.
-
No cobra la cuenta ni cierra la caja. Ninguna de las siete herramientas toca pagos, propinas, medios de pago ni el cierre del turno: la comanda entra por aquí y la cobranza sigue haciéndose en Fudo.
-
No inventa el detalle de una comanda. Cuando la respuesta de Fudo no trae las líneas, la herramienta devuelve sus identificadores y avisa que el detalle hay que verlo en el sistema del local, en lugar de rellenar con platos que nadie pidió.
-
No entrega un estado de cocina del pedido entero. El estado fino vive en cada línea, así que una comanda puede tener un plato servido y otro sin empezar: se responde por línea, no con un único estado que promediaría dos cosas distintas.
-
No edita el menú. Lee productos, precios y categorías tal como están cargados en Fudo, pero no crea platos, no cambia importes y no activa ni desactiva nada de la carta.
-
No anula ni corrige una línea ya cargada. Un plato que entró mal se saca desde Fudo, por una persona: el conector no expone la anulación, y una comanda que llega a cocina ya movió trabajo real.
-
No reserva mesas ni afirma siempre cuáles están ocupadas. Marca la ocupación solo cuando Fudo devuelve las ventas activas junto con las mesas, y cuando no las devuelve lo dice en vez de suponerlo.
-
No trae respuestas confirmadas contra una cuenta real. El contrato salió del OpenAPI público de Fudo y el transporte está verificado por sondeo, pero Fudo no ofrece ambiente de pruebas, así que la forma exacta de cada respuesta se confirma con el primer local que lo use.
Antes de empezar
Qué necesitas para conectar Fudo
- 1
Autorización u homologación de Fudo antes de cualquier conexión
Meteor no aparece hoy en la lista de partners oficiales. Fudo limita la conexión de sitios propios a desarrollos de uso único del restaurante sin intermediarios y advierte sobre las integraciones no homologadas. Hasta que Fudo autorice este caso o homologue a Meteor, la conexión no se ofrece ni se solicitan credenciales de clientes.
- 2
Plan Pro y credenciales emitidas por Fudo, después de la autorización
Fudo indica que su API pública de propósito general está incluida en Plan Pro. La cuenta y los permisos siguen bajo las condiciones de Fudo; tener Plan Pro no convierte por sí solo a un intermediario en integración homologada.
- 3
Un usuario de Fudo dedicado a la API
Lo creas en tu panel de Fudo, por ejemplo api@turestaurante. Lo que puede hacer tu Met son exactamente los permisos del rol de ese usuario, así que un rol corto se nota como un rechazo al crear la comanda, no al conectar.
- 4
El salón y el menú cargados en Fudo
La comanda exige la mesa y el identificador de cada producto, y los dos salen de Fudo. Si las mesas o la carta no están cargadas, no hay nada que el conector pueda inventar en su lugar.
Preguntas frecuentes
Preguntas sobre Fudo y Meteor
No. Meteor no aparece en la lista de partners oficiales publicada por Fudo. Esta página documenta código y alcance técnico, no una integración disponible. No se conectará una cuenta real ni se ofrecerá la implementación sin autorización u homologación de Fudo.
No. Por esta API Fudo solo acepta crear ventas de consumo en salón, y además exige la mesa, así que el conector cubre eso y nada más. Los pedidos que salen del local se manejan en otra API distinta de Fudo, que no está integrada, y prometerla sería vender algo que no existe.
No, y está resuelto en el conector. Cada línea se carga por el identificador del producto en Fudo, así que el importe lo pone la carta. Si la búsqueda no encuentra nada, la herramienta devuelve una advertencia explícita en vez de una lista vacía, para que tu Met diga que eso no está en el menú en lugar de improvisar.
Los platos se cargan de a uno y el conector no se detiene en el primer fallo: si entran tres y falla uno, la comanda queda incompleta y la respuesta lo dice con esas palabras, con la lista de lo que entró y de lo que no. Tu Met no puede confirmarte el pedido entero: te dice qué quedó cargado y qué hay que resolver en el local.
No. El conector abre la comanda, le carga platos y consulta cómo va, pero no cobra, no registra propinas y no cierra la caja. Eso se sigue haciendo en Fudo, por una persona, y es deliberado: mover plata sin que nadie intervenga no es lo que resuelve este conector.
Porque es el único estado que sirve para responderle a quien está esperando. La venta tiene un estado propio y grueso, y una mesa real casi nunca está toda en el mismo punto: hay algo servido, algo en la plancha y algo sin empezar. Devolver un único estado ocultaría justo lo que la persona quiere saber.
Todavía no, y conviene decirlo. Fudo publica su contrato completo y por eso cada campo que el conector lee está tipado en ese documento, y el transporte se verificó por sondeo. Lo que falta es la primera cuenta real, porque Fudo no ofrece ambiente de pruebas. Si algo de la respuesta llega distinto, el conector prefiere avisarlo antes que rellenarlo.
Paso a paso
Automatizaciones que usan Fudo
Tareas completas, con los pasos y las herramientas que se ejecutan en cada uno.
Operar tienda y pedidos
Otras integraciones de la misma familia
¿Necesitas evaluar una integración con Fudo?
Primero revisamos autorización y homologación. No solicitamos credenciales ni prometemos una conexión antes de confirmarlas.