Automação e Agentes de IA · Integração Omie — O Omie tem API oficial. O que falta é ligar o ERP ao resto da empresa.
A Composto Web conecta o Omie aos outros sistemas da empresa pela API oficial dele. O cliente fechado no CRM vira cadastro no ERP, o pedido entra sem redigitação e a baixa do financeiro chega a quem precisa saber dela. Tudo pelos serviços que a documentação do Omie publica, sem robô operando tela.
Onde a integração manual aparece
O ERP está certo. O problema é tudo o que chega a ele digitado.
Quando o Omie concentra faturamento e financeiro, cada sistema ao redor que não fala com ele vira uma pessoa copiando dados de uma tela para outra, todos os dias.
O vendedor fecha a proposta no CRM e alguém do administrativo recadastra o cliente no Omie, com o CNPJ digitado de novo e o endereço às vezes diferente do original.
O pedido da loja virtual ou do portal chega por e-mail ou planilha e é lançado à mão, então o faturamento só começa quando essa pessoa encontra tempo na agenda.
O comercial pergunta no grupo se o boleto já foi pago, porque a baixa registrada no Omie não aparece em nenhum dos sistemas que ele abre durante o dia.
Uma integração feita às pressas parou depois de uma troca da chave de acesso, e ninguém percebeu até o primeiro pedido não aparecer para faturar.
O que dá para conectar pela API do Omie
A lista de APIs do Omie é organizada por módulo. Cada escopo abaixo parte de um serviço publicado na documentação oficial, e o projeto usa só os que o seu processo pede.
Clientes e fornecedores a partir do CRM
O serviço de cadastro de clientes do Omie inclui, altera, consulta e lista clientes e fornecedores, e tem método de upsert, que cria ou atualiza o mesmo registro numa chamada só. O campo de código de integração guarda o identificador do CRM, e o cliente não é duplicado quando a proposta é refeita.
Pedido de venda sem redigitação
Pedidos de venda de produto podem ser incluídos, consultados e listados pela API, que também informa o status do pedido e permite trocar a etapa dele. O pedido nascido na loja, no portal ou no CRM entra com o código de origem, e o andamento do faturamento volta para quem vendeu.
Contas a receber visíveis fora do financeiro
O módulo de finanças publica serviços de contas a receber, contas a pagar, boletos, PIX e extrato de conta corrente. Com eles, o título criado no Omie e o recebimento lançado nele podem ser lidos por quem cobra e por quem atende, sem pedir ao financeiro que confira um por um.
Estoque, compras e serviços quando o processo pede
A documentação lista APIs de consulta e movimento de estoque, pedidos de compra, ordens de produção, ordens de serviço e contratos de serviço. Entram no projeto quando o gargalo da empresa está nesses pontos, e ficam de fora quando não estão.
Webhook com fila e reprocessamento
O Omie avisa por webhook quando um evento acontece, enviando a notificação para o endereço configurado no aplicativo. Montamos o receptor que responde rápido, guarda a notificação e processa depois, como a própria documentação recomenda, com alerta quando alguma coisa fica parada.
Onde esta integração termina
Conecta o Omie pela API oficial. Não configura o Omie nem substitui o suporte dele.
Integração com o Omie (esta página)
- O Omie já é o ERP da empresa, e o problema está nos sistemas ao redor que não falam com ele.
- O dado que precisa circular está nos serviços que a API oficial publica.
- A conexão é desenhada, construída, monitorada e mantida pela Composto Web.
Software Sob Medida
- O sistema do outro lado é antigo e não oferece nenhum meio de troca de dados.
- A regra no meio do caminho é tão própria da empresa que precisa virar um sistema.
Parametrização fiscal, plano de contas e configuração interna do Omie ficam com a contabilidade e com o próprio Omie. A integração respeita o que está configurado lá e não altera nada disso por conta própria.
Quando faz sentido conversar
Vale a pena quando o Omie é o centro e alguém vive de abastecê-lo.
Empresa que usa só o Omie, sem outro sistema em volta, não precisa de integração. Estes são os sinais de que a sua precisa.
Existe um CRM, uma loja ou um sistema próprio, e os clientes de lá são recadastrados no Omie.
Pedidos são lançados no Omie a partir de e-mail, planilha ou outra tela.
Quem atende o cliente não sabe se o título foi pago sem perguntar ao financeiro.
Já existe uma integração com o Omie, mas ninguém sabe dizer se ela está rodando hoje.
Como conduzimos a integração com o Omie
Antes da primeira chamada à API, decidimos qual sistema manda em cada dado e o que acontece quando os dois discordam.
ETAPA 01
Imersão
Listamos por onde cliente, pedido e título passam antes e depois do Omie, quem digita o quê e em que momento a informação atrasa ou diverge entre as áreas.
ETAPA 02
Engenharia
Escolhemos os serviços da API que resolvem o caso, o código de integração de cada registro, a direção da sincronização e a forma de respeitar os limites de consumo que o Omie publica.
ETAPA 03
Construção
Construímos as chamadas e o receptor de webhook sobre um aplicativo de teste do Omie, com a chave de acesso guardada fora do código e o registro de cada envio.
ETAPA 04
Homologação
A integração roda ao lado do lançamento manual. Cada diferença entre o que ela gravou e o que a equipe lançaria é explicada antes de a digitação parar.
ETAPA 05
Gestão e Sustentação
Acompanhamos fila, erro e bloqueio por consumo, e ajustamos a conexão quando o Omie muda um serviço ou quando a empresa gera uma nova chave de acesso.
O que muda quando o Omie para de depender de digitação
Pedido pronto para faturar no mesmo dia
O pedido entra no Omie quando é fechado, e o faturamento deixa de esperar a fila de lançamento manual.
Um cadastro de cliente só
Com o código de integração guardado, CRM e Omie falam do mesmo cliente, e a correção feita num lado chega ao outro.
Financeiro fora do papel de mensageiro
Quem vende e quem atende enxergam a situação do título sem abrir pedido de ajuda ao financeiro.
Dúvidas mais comuns
O que perguntam antes de integrar o Omie
“Precisamos entregar a senha do Omie?”
Não. A API usa a chave de acesso do aplicativo, formada por App Key e App Secret, que só um usuário administrador da conta obtém. A chave fica guardada no servidor da integração, nunca em planilha ou mensagem. Gerar uma chave nova invalida as integrações que usam a antiga, então a troca é combinada com a manutenção.
“A API do Omie aguenta o nosso volume?”
O Omie publica limites de consumo por endereço IP e por combinação de IP, chave de aplicativo e método, além de um teto de requisições simultâneas. A integração é desenhada dentro deles: agrupa consultas, guarda o que já foi lido e espaça as tentativas, porque erro repetido no mesmo método leva a bloqueio temporário.
“E se o nosso sistema estiver fora do ar quando o Omie avisar?”
A documentação dos webhooks descreve novas tentativas e uma fila de reprocessamento que guarda o evento por alguns dias. Ela também diz que os eventos de um mesmo grupo seguem em ordem e que uma falha segura os seguintes, por isso o receptor responde rápido e trata a notificação depois.
“Já temos uma integração com o Omie. Dá para aproveitar?”
Depende do que ela faz e de como foi construída. O diagnóstico lê o que existe, confere se usa a API oficial e o código de integração, e diz com clareza se vale ajustar o que está lá ou refazer.
“Dá para usar agente de IA junto?”
Dá, quando há uma decisão no meio do fluxo: classificar um pedido fora do padrão ou responder ao cliente sobre a situação do título, por exemplo. O dado continua entrando e saindo pela API do Omie, e o agente só age sobre o que a integração entrega a ele.
Frentes relacionadas
Voltar para Integrações entre SistemasIntegrações entre sistemas
Como a Composto Web conecta CRM, ERP e canais.
O que é webhook
O aviso que o sistema manda quando algo muda.
O que é API
O conceito por trás desta integração.
RPA ou integração por API
Por que a API oficial vem antes do robô de tela.
Entrada automática de pedidos
O mesmo problema visto pelo processo.
Fontes citadas
- Portal do desenvolvedor Omie: As APIs do Omie podem ser consumidas por SOAP ou JSON, e a integração usa a chave de autenticação do aplicativo.
- Omie: lista de APIs: Serviços organizados por módulo: Geral, CRM, Finanças, Compras, Estoque e Produção, Vendas e NF-e, Serviços e NFS-e e Painel do Contador.
- Omie: API de clientes: Inclusão, alteração, consulta, listagem e upsert de clientes e fornecedores, com o campo codigo_cliente_integracao para o código do sistema de origem.
- Omie: API de pedidos de venda: Inclusão, consulta e listagem de pedidos de venda de produto, consulta de status e troca de etapa, com o campo codigo_pedido_integracao.
- Omie: API de contas a receber: Inclusão, alteração, consulta, listagem e upsert de contas a receber, lançamento e cancelamento de recebimento.
- Omie: chave de acesso para integrações: App Key e App Secret são obtidos por usuário administrador; gerar uma nova chave exige atualizar as integrações existentes.
- Omie: características dos webhooks: Envio por POST, eventos em ordem dentro do grupo, novas tentativas e fila de reprocessamento; o destino deve responder rápido e guardar o dado para processar depois.
- Omie: limites de consumo da API: Limites por endereço IP e por IP, App Key e método, teto de requisições simultâneas e bloqueio temporário após erros repetidos.
Próximo passo
Se alguém da equipe passa o dia abastecendo o Omie com o que outro sistema já sabe, comece por aí.
No diagnóstico olhamos com você os sistemas em volta do Omie, o que é digitado hoje e qual serviço da API resolve cada passagem.
- Sistemas que trocam dados com o Omie e em que sentido
- Serviços da API do Omie que cobrem cada passagem
- Ordem de implantação, começando pelo que mais se digita