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.price_updated
O preço de um ou mais produtos mudou, restrito às lojas e canais afetados.
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
Cada evento leva estes campos sobevent:
Alguns eventos também trazem
event.timezone (o fuso horário da conta de origem)
além dos campos acima. Confira a página de referência de cada evento para o
envelope exato antes de assumir um campo que não está listado aqui.Entrega
O Fire envia cada evento comoapplication/json para o endpoint que você configura
por integração no dashboard (Agregadores → Ferramentas de desenvolvedor →
Integrações de agregadores) — você fornece o host, e o caminho é configurável por
integração, por exemplo https://suaapp.com/webhooks/menu-updated. A entrega é
assinada com HMAC-SHA256 (veja Autenticação); não há
negociação OAuth nesse caminho, diferente do fluxo Bearer da API.
Headers da requisição
Deduplicação
Use o campoevent.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 qualquer2xx em até 10 segundos para confirmar o recebimento. Processe de forma assíncrona para evitar timeouts.