A integração com o Omie conecta a Aira ao seu ERP para sincronizar faturas, contratos, pagamentos e documentos fiscais automaticamente.
O que é sincronizado
Webhooks recebidos do Omie
A Aira recebe webhooks do Omie para manter os dados sincronizados. Os tópicos suportados são:
A validação é feita via
appKey + appHash presentes no payload do webhook. Payloads com credenciais inválidas são rejeitados.
O Omie também envia payloads de ping ({ "ping": "omie" }) para verificar a disponibilidade do endpoint — a Aira responde com {"message":"pong"}.
Para ambientes que não são produção, use o mesmo caminho (
/v1/webhooks/omie) e altere apenas o host.Configuração
Habilitar a integração
A integração com o Omie é provisionada pelo time da Aira. Entre em contato com o suporte em contato@useaira.com informando as credenciais da sua conta Omie (app_key e app_secret) para ativação.
Configurar webhooks no Omie
- Acesse o Portal de Desenvolvedor do Omie
- Clique em Adicionar novo webhook
- Informe a URL do endpoint da Aira:
- Selecione todos os tópicos suportados (listados acima)
- Salve a configuração
Módulos de sincronização
Após habilitar, configure quais módulos deseja ativar:- Sincronização de pagamentos: Receber confirmações de pagamento do Omie
- Sincronização de documentos fiscais: Receber NFSe emitidas pelo Omie
Mapeamento de serviços
Para que as faturas sejam criadas corretamente no Omie, configure o mapeamento entre entidades da Aira e serviços do Omie:- Por produto: Cada produto da Aira é mapeado para um serviço do Omie
- Por recurso: Cada recurso é mapeado individualmente
- Por valor mínimo da fatura: Itens de franquia mínima mapeados separadamente
Próximos passos
- Celcash — processe cobranças via PIX e Boleto
- Documentos fiscais — entenda como NFSe são sincronizadas
- Pagamentos — métodos de pagamento disponíveis