Visão geral dos eventos

O Fire notifica seu sistema sobre mudanças em tempo real via webhooks — requisições HTTP POST enviadas para seu endpoint registrado sempre que algo relevante acontece. Você assina os eventos que lhe interessam e age sobre eles como sua integração exigir.

Eventos de canal

Os eventos de canal notificam seu sistema quando o catálogo de canais de venda muda. Use-os para manter seu mapeamento local de canais sincronizado — os IDs de canal são obrigatórios ao injetar pedidos e ao processar eventos de publicação.

channel.updated

Um canal foi criado ou sua configuração mudou.

channel.deleted

Um canal foi removido do Fire.

channels.sync

Sincronização em massa — catálogo completo de canais em lotes de até 50.

Eventos de loja

Os eventos de loja notificam seu sistema quando as configurações de loja mudam. O Fire suporta atualizações de loja individuais, exclusões explícitas e sincronizações em massa para onboarding ou mudanças massivas.

store.updated

Uma loja foi criada ou sua configuração mudou.

store.deleted

Uma loja foi removida do Fire.

stores.sync

Sincronização em massa — até 50 lojas por lote.

Eventos de cardápio

Os eventos de cardápio carregam a definição completa do catálogo para uma loja e canal específicos — categorias, produtos, grupos de modificadores e horários. O payload está pronto para ser encaminhado a sistemas downstream.

menu.updated

Um cardápio foi criado ou atualizado. Também usado para sinalizar a exclusão do cardápio (payload vazio).

menus.sync

Sincronização em massa — cardápios para várias lojas em lotes de até 50.

Eventos de produto

product.updated

Um ou mais produtos foram atualizados em todas as lojas onde aparecem.

product.availability_changed

Um produto foi ativado ou desativado em uma ou mais lojas.

Eventos de pedido

order.status_changed

O status de um pedido mudou dentro do Fire.

Envelope do evento

Todos os eventos compartilham a mesma estrutura de nível superior:

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

Campo	Tipo	Descrição
`event`	string	Identificador do tipo de evento
`id`	string	ID único do evento — use para deduplicação
`createdAt`	string	Timestamp ISO 8601
`data`	object	Payload específico do evento

Headers da requisição

Header	Descrição
`Content-Type`	`application/json`
`X-Fire-Event`	Tipo de evento (ex.: `menu.updated`)
`X-Fire-Signature`	Assinatura HMAC-SHA256 — veja Autenticação
`X-Fire-Delivery`	ID único da tentativa de entrega

Deduplicação

Use o campo id para detectar e descartar entregas duplicadas. O Fire pode entregar o mesmo evento mais de uma vez em caso de retentativas.

Como responder

Retorne qualquer 2xx em até 10 segundos para confirmar o recebimento. Processe de forma assíncrona para evitar timeouts.

​Eventos de canal