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:| Responsabilidade | Direção |
|---|---|
| Configurar um Integration Flow com escopo na sua account/vendor/lojas | Dashboard |
| Expor um endpoint HTTPS para o qual o nó HTTP do flow faz POST | Fire → Seu sistema |
| Autenticar requisições recebidas (Bearer token, API key ou OAuth2 — configurado por flow) | Fire → Seu sistema |
Processar os eventos que te interessam (order.completed, order.cancelled, fiscais) | Fire → Seu sistema |
| Injetar pedidos no Fire usando sua API key | Seu sistema → Fire |
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.