Como conectar o Omie aos KPIs do projeto
Serve pra os KPIs do projeto se atualizarem sozinhos com o financeiro do cliente no Omie: entradas, saídas, geração de caixa, saldo e contas vencidas a pagar e a receber.
Conferido em 07/11/2026
- 1
Em Configurações Gerais, seção Funcionalidades beta, ligue Sistemas conectados (beta). Só o dono ou um administrador do workspace vê essa opção.
- 2
Abra o projeto do cliente, Fontes de dados, sub-aba Sistemas. O projeto precisa ter uma empresa ou um cliente vinculado. Cada sistema tem um Passo a passo com o que lemos e como conectar. No Farol, o botão Sistemas conectados leva para o mesmo lugar.
- 3
Em Omie, clique em Pedir ao cliente e mande o link, que serve uma vez e vale 7 dias. Quem abre precisa ser administrador do Omie: só ele vê a chave, em Meus Aplicativos → engrenagem do aplicativo → Resumo do App → Chave de Integração (API). Ele cola a App Key e a App Secret no link, sem você precisar recebê-las.
- 4
A chave do Omie abre o ERP inteiro, não só a leitura: o Omie não tem chave só de consulta. O consultor.app só faz consultas, mas trate a chave como uma senha. Nunca peça por WhatsApp nem por e-mail. Se o cliente estiver com você, Conectar faz o mesmo na hora.
- 5
Na prévia, confira os números com a tela do Omie: o extrato das contas e o resumo de contas vencidas. A integração está em Beta, então essa conferência é o que garante que o número está certo.
- 6
Clique em Ligar em cada métrica que quiser, criando um KPI novo ou usando um que já existe. O histórico de até 12 meses chega em instantes, e a atualização passa a ser diária.
Erros comuns
- A chave foi recusada: confira se a App Key e a App Secret são do mesmo aplicativo e foram copiadas inteiras. Se alguém clicou em Gerar nova chave no Omie, a anterior parou de valer: cole a nova em Trocar chave.
- Não peça ao cliente para gerar uma chave nova: no Omie, isso desliga todas as integrações que usam a chave atual, como o e-commerce ou o banco. Copie a que já existe.
- O sistema não respondeu: o Omie limita consultas repetidas em menos de um minuto e bloqueia por 30 minutos depois de muitos erros seguidos. Espere alguns minutos e tente de novo.
- Uma conta bancária não entra no saldo: contas inativas e marcadas para não aparecer no fluxo de caixa do Omie ficam de fora, como no próprio Omie.
- Transferência entre contas não aparece nas entradas: ela não é entrada nem saída de caixa; muda só o saldo de cada conta.
- Contas vencidas têm só o valor de hoje: são o atraso do dia, por isso não trazem histórico mês a mês.
- Corrigi um mês e o número não voltou: correção manual vale no lugar do automático. No histórico do KPI, use Voltar ao automático.
- Desconectei e os números continuam: as medições já gravadas ficam. Para cortar o acesso no Omie, o cliente gera uma nova chave, sabendo que isso desliga as outras integrações dele.