Integração com Omie
A integração com Omie conecta o ERP aos outros sistemas da empresa (CRM, loja virtual, planilhas, prefeitura, banco) pela API oficial e pelos webhooks do Omie. A LHCX mapeia o fluxo, define o de-para dos campos e entrega a integração com logs, reprocessamento e alertas.
O que dá para integrar com o Omie
O Omie publica APIs por módulo no Portal do Desenvolvedor, consumidas em JSON ou SOAP com a chave do aplicativo da própria empresa. Na prática, quase tudo o que se digita no Omie pode chegar por integração, e quase tudo o que está no Omie pode sair para outro sistema.
Cadastros de clientes, fornecedores e produtos
Clientes que nascem no CRM ou na loja virtual entram no Omie sem redigitação. O código de integração (por exemplo, codigo_cliente_integracao) liga o registro do outro sistema ao do Omie e evita cadastro duplicado.
Pedidos de venda
Pedido fechado no e-commerce, no CRM ou em uma planilha vira pedido de venda no Omie, com cliente, itens e condições conferidos antes do envio.
Contas a pagar e a receber
Lançamentos financeiros criados a partir de notas, contratos ou cobranças, e consulta de títulos em aberto para relatórios e cobrança.
Extrato e apoio à conciliação
O extrato de conta corrente pode ser lido pela API e comparado com os lançamentos, para apontar o que não bateu antes do fechamento.
NFS-e e ordens de serviço
Notas de serviço recebidas de prefeituras (como São Bernardo do Campo, no padrão GINFES, ou cidades no GissOnline) viram contas a pagar; ordens de serviço e NFS-e emitidas podem ser consultadas pela API.
CRM, planilhas e dashboards
Oportunidades e contas do CRM do Omie sincronizadas com outras ferramentas, e dados financeiros e de vendas levados para Google Sheets ou dashboards.
Webhook do Omie: como funciona e o que exige
O webhook é o caminho do Omie para avisar outro sistema assim que algo acontece (um produto alterado, um cadastro incluído), em vez de o outro sistema perguntar de tempos em tempos. Ele é configurado na Área do Desenvolvedor, em Aplicativos, por um usuário com perfil de administrador, que informa a URL do endpoint e marca os eventos desejados.
Segundo a Central de Ajuda do Omie, os eventos são enviados por POST e processados em fila, na ordem em que acontecem, por aplicativo e por endpoint. Isso muda a forma de construir o lado que recebe:
- Qualquer resposta HTTP 2XX marca o evento como processado; o endpoint precisa responder em até 7 segundos na fila principal
- Em caso de falha, o Omie tenta de novo até 3 vezes e depois move o evento para uma fila de reprocessamento, que tenta a cada 10 minutos por até 5 dias
- Enquanto um evento falha, os seguintes do mesmo grupo ficam parados: um endpoint lento atrasa todos os outros avisos
- A recomendação oficial é responder 2XX o mais rápido possível e guardar o dado para processar depois
- Trocar a URL do endpoint vale só para eventos novos; os que já estavam na fila seguem para o endereço antigo
Limites da API do Omie que a integração precisa respeitar
Integração que ignora os limites funciona no teste e trava no primeiro dia de volume. Os números abaixo são os publicados pela Central de Ajuda do Omie e podem mudar; a integração lê o erro devolvido e espera antes de tentar de novo.
Requisições por minuto
Até 240 por minuto para cada combinação de IP, App Key e método, e até 960 por minuto por IP. Acima disso a API responde "Too many requests".
Requisições simultâneas
Até 4 simultâneas por IP, App Key e método nas consultas; inclusões e alterações não aceitam chamadas simultâneas.
Consultas repetidas e erros em sequência
A mesma consulta ao mesmo registro dentro de 60 segundos não traz os dados de novo. Erros repetidos sem tratamento podem bloquear o método por 30 minutos (HTTP 425).
Listagens paginadas
Listagens trazem os registros por página e, em alguns métodos, só os últimos 30 dias quando o período não é informado. A carga inicial precisa paginar e filtrar por data.
Credenciais fora do navegador
O próprio Omie orienta não chamar a API direto do navegador, o que expõe a chave do aplicativo. A chamada sai de um servidor ou de uma ferramenta de automação.
Como a LHCX faz a integração
- 01
Diagnóstico do fluxo
Entendemos o caminho do dado hoje: onde ele nasce (CRM, loja, planilha, prefeitura, banco), quem digita no Omie, quanto tempo leva e onde dá erro.
- 02
Mapeamento de campos e regras
Montamos o de-para entre os sistemas (cliente, produto, categoria, conta corrente, forma de pagamento) e as regras de exceção: o que fazer com cadastro incompleto, item sem código ou nota duplicada.
- 03
Construção da integração
Chamadas à API e recebimento de webhooks em n8n ou em código, conforme volume e complexidade, com credenciais guardadas no servidor e respeito aos limites de requisição.
- 04
Logs, reprocessamento e alertas
Cada envio fica registrado com o retorno do Omie. O que falhou pode ser reprocessado sem duplicar lançamento, e a equipe é avisada quando algo precisa de decisão humana.
- 05
Teste com dados reais e virada
Rodamos em paralelo com o processo atual por um período curto, comparamos os resultados e só então desligamos a digitação manual.
n8n, conector pronto ou código?
Conectores prontos (como a Pluga, usada no nosso guia de integração do NFE.io com o Omie) resolvem fluxos padrão com pouca regra. O n8n faz sentido quando o fluxo tem várias etapas, validações ou exceções, e pode rodar em servidor próprio. Código dedicado entra quando volume, regras fiscais ou desempenho pedem. A escolha sai do diagnóstico, não da preferência pela ferramenta.
Leituras sobre Omie e NFS-e no blog da LHCX
NFS-e de São Bernardo do Campo no Omie
Captura de notas do GINFES de São Bernardo do Campo (SP) e os caminhos para levá-las ao Omie.
Ver a páginaNFS-e do GissOnline no Omie
Alternativas de captura em prefeituras que usam o GissOnline e importação no Omie.
Ver a páginaIntegração NFE.io com Omie
Passo a passo com webhook do NFE.io, Pluga e mapeamento de campos.
Ver a páginaAnálise completa do ERP Omie
Contas bancárias, conciliação e formas de pagamento no Omie, na prática.
Ver a páginaAutomações da LHCX
Fluxos entre sistemas com validação, tratamento de exceções, logs e alertas.
Ver a páginaPedir orçamento de integração
Conte quais sistemas precisam conversar com o Omie. Respondemos em até 24 horas.
Ver a página
Fontes
As informações técnicas desta página vêm da documentação oficial do Omie, consultada em outubro de 2026. A LHCX é uma consultoria independente, sem vínculo de parceria com o Omie.
Integração com Omie: dúvidas comuns
O Omie tem API?
Tem. O Omie publica APIs por módulo (cadastros, vendas, finanças, serviços e NFS-e, CRM, entre outros) no Portal do Desenvolvedor, em JSON ou SOAP. A autenticação usa a chave do aplicativo criado na conta da própria empresa.
Como funciona o webhook do Omie?
O Omie envia um POST para a URL configurada sempre que um evento marcado acontece. O endpoint precisa responder 2XX em poucos segundos; se falhar, o Omie tenta de novo e guarda o evento em uma fila de reprocessamento por até 5 dias, segurando os eventos seguintes do mesmo grupo.
Dá para levar NFS-e de São Bernardo do Campo para o Omie automaticamente?
Dá. A captura depende do sistema da prefeitura (em São Bernardo do Campo, o padrão GINFES) e normalmente de certificado digital; depois, a nota vira lançamento no Omie por importação do XML ou pela API de contas a pagar. O caminho certo depende do volume e de quem emite as notas.
Dá para integrar o Omie com n8n?
Sim. O n8n chama a API do Omie por requisições HTTP e recebe os webhooks em um fluxo próprio, com validação, tratamento de erro e reprocessamento.
O Omie é bom para a minha empresa?
Depende do porte, do tipo de operação e de quantos sistemas precisam conversar com o ERP. Na nossa análise completa do ERP Omie, no blog, mostramos pontos fortes e limitações na prática. A integração não resolve um processo mal definido: o diagnóstico vem antes.
Preciso trocar algum sistema para integrar com o Omie?
Na maioria dos casos, não. A integração conecta os sistemas que a empresa já usa ao Omie, pela API e pelos webhooks.
A LHCX é parceira oficial do Omie?
Não. A LHCX é uma consultoria independente de automação e dados. Integramos pela API pública documentada pelo Omie, com o aplicativo e as credenciais da sua empresa.
Quanto custa e quanto tempo leva uma integração com o Omie?
Depende de quantos sistemas, fluxos e regras de exceção estão envolvidos. Depois do diagnóstico, a proposta traz escopo, etapas, prazo e investimento.
Quer integrar o Omie aos seus sistemas? Conte o fluxo que precisa mudar.
Respondemos em até 24 horas com as próximas perguntas e uma proposta objetiva.