Visión general de eventos

Fire notifica a tu sistema los cambios en tiempo real vía webhooks — peticiones HTTP 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.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

Todos los eventos comparten la misma estructura de nivel superior:

{
  "event": "event.type",
  "id": "evt_abc123",
  "createdAt": "2025-01-15T14:30:00Z",
  "data": { }
}

Campo	Tipo	Descripción
`event`	string	Identificador del tipo de evento
`id`	string	ID único del evento — úsalo para deduplicación
`createdAt`	string	Timestamp ISO 8601
`data`	object	Payload específico del evento

Headers de la petición

Header	Descripción
`Content-Type`	`application/json`
`X-Fire-Event`	Tipo de evento (p. ej. `menu.updated`)
`X-Fire-Signature`	Firma HMAC-SHA256 — consulta Autenticación
`X-Fire-Delivery`	ID único del intento de entrega

Deduplicación

Usa el campo 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 cualquier 2xx en menos de 10 segundos para confirmar la recepción. Procesa de forma asíncrona para evitar timeouts.

​Eventos de canal