Modelo de integración
Fire es el sistema maestro. Emite eventos cada vez que algo relevante cambia y recibe órdenes inyectadas desde sistemas externos. Cualquier sistema que necesite reaccionar a esos eventos — o enviar órdenes hacia Fire — se integra a través de la misma interfaz:- Fire emite eventos cada vez que cambian tiendas, menús o productos, y cuando se actualiza el estado de una orden. Los eventos se entregan a tu sistema mediante llamadas webhook por HTTPS.
- Fire recibe órdenes inyectadas por tu sistema vía la API REST.
Un caso de uso común es un orquestador de agregadores — un sistema que conecta Fire con varios agregadores de delivery (iFood, Keeta, 99, Rappi, etc.) y maneja la publicación y el flujo de órdenes entre ellos. La integración funciona igual para cualquier otro tipo de cliente.
Flujos de datos
Flujo de publicación — Fire emite eventos que tu sistema debe propagar a sistemas downstream (agregadores, plataformas de facturación, ERPs o cualquier sistema que deba mantenerse sincronizado):
Qué construyes
Tu integración necesita:| Responsabilidad | Dirección |
|---|---|
| Exponer un endpoint HTTPS para recibir eventos | Fire → Tu sistema |
| Validar las firmas de los eventos entrantes | Fire → Tu sistema |
| Procesar eventos de publicación (tienda, menú, producto) | Fire → Tu sistema |
| Inyectar órdenes en Fire usando tu API key | Tu sistema → Fire |
| Manejar las actualizaciones de estado de órdenes desde Fire | Fire → Tu sistema |
Próximos pasos
Conceptos clave
Entiende los componentes fundamentales de la integración con Fire.
Autenticación
Configura tus credenciales de API y la validación de firmas de webhook.
Inicio rápido
Pon a funcionar tu integración de extremo a extremo.
Integraciones de agregadores
Configura integraciones, endpoints de webhook y eventos de prueba desde el panel.