Modelo de integração
O Fire é event-driven e bidirecional:- O Fire emite eventos quando ocorrem transições de negócio relevantes — um pedido é completado, um pedido é cancelado, um documento fiscal é autorizado. Você recebe esses eventos através de Integration Flows que você configura no dashboard do Fire.
- O Fire recebe pedidos injetados pelo seu sistema via API REST.
order.completed, order.cancelled, order.invoiced e order.reversed.
Um caso de uso comum é um orquestrador de agregadores — um sistema que conecta o Fire a vários agregadores de delivery (iFood, Keeta, 99, Rappi, etc.) e gerencia o fluxo de pedidos entre eles. O modelo de integração funciona igual para qualquer outro tipo de cliente (POS, ERP, faturamento, analítica).
Como os eventos são entregues
O Fire não é um único endpoint de webhook global. Cada cliente configura um ou mais Integration Flows no dashboard, com escopo na sua account, vendor e (opcionalmente) lojas específicas. Quando ocorre um evento de negócio, o Fire executa cada flow ativo que combina. Cada flow é um grafo de nós que você define — tipicamente um nó HTTP que faz POST para o seu endpoint, mas também pode transformar, ramificar ou chamar serviços internos do Fire. Veja Visão geral de eventos para o modelo event-driven completo e Integration Flows para entender como funciona a assinatura.O que você constrói
Sua integração precisa:
Tanto receber eventos quanto chamar a API exigem autenticação. Veja Autenticação para saber como as credenciais são emitidas e usadas em cada lado.
Próximos passos
Conceitos-chave
Entenda os blocos de construção da integração com o Fire.
Quickstart
Coloque sua integração no ar de ponta a ponta.
Tratar eventos de pedido
Construa um handler de webhook em 10 minutos.
Visão geral de eventos
O modelo de eventos completo — envelope, entrega, retentativas.