POST enviadas a tu endpoint registrado siempre que ocurre algo relevante. Te suscribes a los eventos que te interesan y actúas sobre ellos como tu integración requiera.
Eventos de canal
Los eventos de canal notifican a tu sistema cuando cambia el catálogo de canales de venta. Úsalos para mantener tu mapeo local de canales sincronizado — los IDs de canal son obligatorios al inyectar órdenes y al procesar eventos de publicación.channel.updated
Un canal fue creado o su configuración cambió.
channel.deleted
Un canal fue removido de Fire.
channels.sync
Sync masivo — catálogo completo de canales en lotes de hasta 50.
Eventos de tienda
Los eventos de tienda notifican a tu sistema cuando cambian las configuraciones de tienda. Fire soporta actualizaciones de tienda individuales, eliminaciones explícitas y syncs masivos para onboarding o cambios masivos.store.updated
Una tienda fue creada o su configuración cambió.
store.deleted
Una tienda fue removida de Fire.
stores.sync
Sync masivo — hasta 50 tiendas por lote.
Eventos de menú
Los eventos de menú llevan la definición completa del catálogo para una tienda y canal específicos — categorías, productos, grupos de modificadores y horarios. El payload está listo para reenviarse a sistemas downstream.menu.updated
Un menú fue creado o actualizado. También se usa para indicar la eliminación del menú (payload vacío).
menus.sync
Sync masivo — menús de varias tiendas en lotes de hasta 50.
Eventos de producto
product.updated
Uno o más productos fueron actualizados en todas las tiendas donde aparecen.
product.price_updated
El precio de uno o más productos cambió, acotado a las tiendas y canales afectados.
product.availability_changed
Un producto fue activado o desactivado en una o más tiendas.
Eventos de orden
order.status_changed
El estado de una orden cambió dentro de Fire.
Envelope del evento
Cada evento lleva estos campos bajoevent:
Algunos eventos también llevan
event.timezone (la zona horaria de la cuenta de
origen) además de los campos de arriba. Revisá la página de referencia de cada
evento para confirmar su envelope exacto antes de asumir un campo que no está listado
aquí.Entrega
Fire envía cada evento comoapplication/json al endpoint que configurás por
integración desde el dashboard (Agregadores → Herramientas de desarrollo →
Integraciones de agregadores) — vos das el host, y la ruta es configurable por
integración, por ejemplo https://tuapp.com/webhooks/menu-updated. La entrega va
firmada con HMAC-SHA256 (ver Autenticación); no hay negociación
OAuth en esta vía, a diferencia del flujo Bearer de la API.
Headers de la petición
Deduplicación
Usa el campoevent.id para detectar y descartar entregas duplicadas. Fire puede entregar el mismo evento más de una vez en caso de reintentos.
Cómo responder
Devuelve cualquier2xx en menos de 10 segundos para confirmar la recepción. Procesa de forma asíncrona para evitar timeouts.