Conecte o seu sistema
à Flagy.
API REST de pedidos e cardápio, webhooks em tempo real e integração com os marketplaces pelo padrão aberto Open Delivery. Documentação pública, sem intermediário — você fala direto com a Flagy.
Três formas de conversar
com a Flagy.
API REST
Seu sistema lê a loja e o cardápio, consulta pedidos e cria pedidos — com token por loja e escopos de permissão. Ideal para ERP, PDV e painéis próprios.
Webhooks
A Flagy avisa o seu sistema na hora que um pedido entra ou muda de status — POST em JSON, assinado com um segredo, com novas tentativas se falhar.
Marketplaces
Os pedidos do iFood, 99Food, Keeta e Pedidos10 na mesma fila, pelo padrão aberto Open Delivery. Em desenvolvimento.
A API de pedidos
e cardápio.
Base https://menu.flagy.com.br/{sua-loja}/api/v1. Autenticação por Bearer token, criado em Configurações › API e webhooks no painel, com os escopos que você escolher.
| Método | Rota | O que faz | Escopo |
|---|---|---|---|
| GET | /loja | Nome, se está aberta agora e os horários | leitura |
| GET | /cardapio | Categorias e produtos com preço e disponibilidade | leitura |
| GET | /pedidos | Pedidos recentes (filtros: desde, status, limite) | leitura |
| GET | /pedidos/{codigo} | Um pedido com todos os itens | leitura |
| POST | /pedidos | Cria um pedido (itens, cliente, modalidade, pagamento) | pedidos |
| POST | /pedidos/{codigo}/status | Muda o status (confirmado, em_preparo, pronto, em_rota, entregue, cancelado) | pedidos |
O pedido chega
no seu sistema na hora.
Cadastre um endereço e os eventos que quer receber. A Flagy manda um POST em JSON, assinado no cabeçalho X-Flagy-Assinatura (HMAC com o seu segredo). Se o seu servidor falhar, tenta de novo em 1 min, 5 min, 30 min, 2 h e 6 h.
| Evento | Quando dispara |
|---|---|
| pedido.criado | Chegou um pedido novo (de qualquer canal) |
| pedido.status | Um pedido mudou de status |
| produto.disponivel | Um produto foi pausado ou voltou |
Todos os apps de delivery,
na mesma fila.
A Flagy está adotando o Open Delivery — o padrão aberto da Abrasel que o iFood, a 99Food, a Keeta e o Pedidos10 já falam. Um conector, todos os apps: os pedidos entram na sua fila, com a comissão separada no faturamento, e o status volta pra cada plataforma. Em desenvolvimento.