Fire
Fire es el OS de gestión de restaurantes y la fuente de verdad para órdenes, tiendas, menús, productos y canales de venta. Cualquier cambio hecho en Fire es la versión autoritativa que puede producir eventos a los que tu sistema reaccione.Tu sistema
Tu sistema es la integración que construyes. Se conecta a Fire mediante:- Recibir eventos desde Fire a través de uno o más Integration Flows, y actuar sobre ellos (publicar a agregadores, sincronizar un sistema de facturación o ERP, disparar workflows internos, etc.).
- Inyectar órdenes en Fire cuando sea necesario.
Canales de venta
Los canales de venta son los agregadores (iFood, Keeta, 99, Rappi, etc.) y los canales directos (POS, kiosko, app, web) configurados dentro de Fire para una tienda. Cada canal tiene un ID único en Fire. Si tu sistema necesita inyectar órdenes o mapearlas a sistemas upstream, debe obtener la lista de canales una vez y mantenerla en cache.Eventos
Hoy Fire emite cuatro tipos de evento en producción:| Evento | Cuándo dispara |
|---|---|
order.completed | Una orden inyectada se recibe completa y está pagada (status=COMPLETED, paymentStatus=SUCCEEDED). |
order.cancelled | Una orden inyectada se cancela desde el backoffice o vía un adaptador externo. |
order.invoiced | Solo Brasil — SEFAZ autoriza el documento fiscal de la orden vía tu proveedor fiscal. |
order.reversed | Solo Brasil — SEFAZ confirma la cancelación de un documento fiscal previamente autorizado. |
Integration Flows
Un Integration Flow es cómo tu sistema se suscribe a eventos. Configuras los flows en el dashboard de Fire en Settings → Integration Flows, asignando a cada flow un scope de account, vendor y (opcionalmente) tiendas específicas. Un flow es un grafo de nodos — típicamente un trigger seguido de un nodo HTTP que hace POST del cuerpo del evento a tu URL — pero también puede transformar, ramificar, loggear o llamar servicios internos de Fire antes de salir. El nodo HTTP del flow es dueño de la petición: método, URL, headers, autenticación y el template del body que define lo que tu endpoint recibe. Fire no impone un envelope fijo — la mayoría de equipos parten del template canónico de ejemplo que el dashboard incluye.Órdenes
Las órdenes se inyectan en Fire vía la API REST. Cada payload de orden debe incluir el ID de canal de venta de Fire para que Fire pueda asociarla con el canal y la configuración de tienda correctos. Una vez inyectada y pagada, la orden produce un eventoorder.completed; las cancelaciones producen order.cancelled.