Encontrar com IA
Este manual mostra, do começo ao fim, como conferir os lançamentos de um fornecedor: o que exportar do seu sistema, como ensinar o programa a reconhecer o número da nota e como ler o resultado. Se você nunca abriu o programa, comece pelo passo 1 e vá seguindo — dá para fazer a primeira conferência em uns dez minutos.
1 Instalar e liberar o acesso
-
Baixe e coloque numa pasta só dele
Baixe o
ECONTRAR_COM_IA.exee mova para uma pasta própria — por exemploC:\Encontrar com IA\. Não deixe na pasta Downloads: o programa cria alguns arquivos de apoio ao lado dele. -
Abra pela primeira vez
Uma janela preta aparece e diz que está verificando o seu acesso. Se o Windows perguntar se confia no programa, clique em Mais informações → Executar assim mesmo.
-
Peça a liberação
Como o seu computador ainda não foi aprovado, abre uma página com o seu Hardware ID e dois botões de WhatsApp. Clique em Ativar meu computador — a mensagem já vai preenchida com o código. É só enviar.
-
Abra de novo depois da aprovação
Assim que avisarmos que liberamos, feche tudo e abra o programa outra vez. Nessa hora ele baixa a versão completa (alguns minutos, uma única vez) e abre sozinho no seu navegador.
ECONTRAR_COM_IA.exeVocê vai notar que apareceu um segundo arquivo, o ECONTRAR_COM_IA - Nucleo.exe. Não crie atalho para ele. É abrindo pelo primeiro que o programa se mantém atualizado — pelo segundo, você fica travado numa versão antiga para sempre.
Ela é o motor do programa. Enquanto você estiver usando a tela no navegador, essa janela precisa continuar aberta. Fechar a janela preta é como desligar o programa.
2 Preparar o arquivo
Exporte diretamente do Alterdata Pack (ou do seu sistema contábil) o razão do fornecedor (ou a conta que você quer conferir) em Excel ou CSV. O programa lê nativamente relatórios com as quatro colunas escritas assim:
| Coluna | Obrigatória? | O que o programa faz com ela |
|---|---|---|
| Data | Sim | Mostra as datas de todos os lançamentos do grupo. |
| Descrição histórico | Sim | É aqui que ele procura o número da nota. |
| Valor | Sim | O valor de cada lançamento. |
| C/D | Sim | Se é crédito ou débito. É o que permite a soma fechar em zero. |
| Lote | Não | Se existir, é levada junto para o resultado. |
| Contrapartida | Não | Se existir, é levada junto para o resultado. |
| Usuário de inclusão / alteração | Não | Se existirem, ajudam a rastrear quem lançou. |
Se o seu escritório utiliza outro sistema (Domínio, Fortes, Questor, Totvs, ContaAzul, Omie, etc.) ou o seu relatório exportado tiver outro formato de colunas, nossa equipe de suporte adapta o conector sob medida para você na contratação de qualquer sistema da Lumairam!
Se aparecer essa mensagem, o nome de alguma coluna obrigatória está diferente na sua planilha. Abra o Excel e renomeie o cabeçalho para o nome exato da tabela acima — inclusive o acento em Descrição histórico.
3 A tela do programa
O programa abre no seu navegador e tem duas áreas:
- Barra lateral (esquerda) — onde você configura: escolhe o perfil do cliente, escreve os padrões, a lista de ignorados e a chave da IA.
- Área central — onde você sobe o arquivo, processa e vê o resultado.
No celular ou numa janela estreita, a barra lateral fica escondida atrás da setinha > no canto superior esquerdo.
4 Deixar a IA achar as regras
Essa é a parte que economiza mais tempo. Em vez de você descobrir na mão como o número da nota aparece no histórico, a IA lê uma amostra do arquivo e monta as regras.
-
Cole a chave do Gemini
Na barra lateral, em Configuração de IA, cole a sua chave da API do Google Gemini. Ela fica salva — você só faz isso uma vez.
-
Suba o arquivo
Na área central, escolha o Excel ou CSV. Assim que ele carrega, aparece o painel Assistente de IA: Descobrir Regras Automaticamente.
-
Clique em "Gerar Padrões Mágicos"
Cinco agentes leem lotes diferentes do arquivo ao mesmo tempo. Numa planilha grande isso leva de alguns segundos a poucos minutos, com barra de progresso.
-
Confira a prévia
Se ele detectar que os códigos começam sempre iguais, mostra uma tabelinha "Código no extrato → Vai agrupar como". Olhe se faz sentido antes de seguir.
-
Aplique ou salve
Aplicar para Testar joga as regras para a barra lateral sem salvar nada — bom para experimentar. Salvar Novo Padrão guarda como um perfil daquele cliente, para usar todo mês.
Só o assistente de IA usa internet, e ele envia apenas uma amostra dos textos de histórico para o Google descobrir o formato dos números. O agrupamento, a soma e o Excel final são feitos dentro da sua máquina. Se você preferir não usar a IA, escreva os padrões na mão (passo 5) e nada do arquivo sai daí.
5 Padrões de captura
O campo Padrões de Captura é a lista do que o programa deve procurar dentro do histórico para identificar a nota. Um por linha.
Você pode escrever de três jeitos
| Você escreve | O que acontece |
|---|---|
1541321 |
Procura esse número em qualquer formatação. Acha também 001.541.321, 1.541.321 e 1541321. É o jeito mais usado. |
"NF 001" |
Entre aspas, a busca é exata: só casa com esse texto do jeito que está escrito. |
NF ### |
Sem aspas com #, cada # vale um dígito qualquer. Serve para pegar uma família inteira de números. |
Se a sua lista tem 123 e 123456, o programa testa primeiro o mais comprido. Assim o 123 não "rouba" um lançamento que na verdade era do 123456. Você não precisa se preocupar com a ordem em que escreveu.
6 Lista de ignorados
O histórico costuma trazer números que parecem nota mas não são: CNPJ, CPF, data, número de contrato, código de banco. O campo Ignorar Texto manda o programa fingir que esses trechos não existem.
Escreva um por linha. Aqui a pontuação conta — se o CNPJ aparece como 12.345.678/0001-99, escreva com os pontos e a barra.
Quase sempre é um CNPJ ou uma data sendo confundida com número de nota. Olhe a coluna Descrição do grupo estranho, ache o número que se repete e jogue ele na lista de ignorados.
7 Encurtar o número capturado
Alguns sistemas gravam a nota com um começo fixo e a parcela colada no fim. Aí a mesma nota vira dois códigos diferentes e o grupo não fecha. O painel ✂️ Encurtar o número capturado resolve isso.
Remover prefixo
Escreva o começo fixo — por exemplo 2300 — um por linha:
Cortar parcela no final
Com a caixinha marcada, um bloco de quatro dígitos do tipo 0001, 0002 no fim é removido:
Conforme você digita, aparece uma tabelinha de Prévia mostrando o antes e o depois. Confira ali antes de processar.
Se cortar o prefixo fosse deixar menos de três dígitos, o programa desiste do corte e mantém o número inteiro. É uma trava para você não acabar com um código sem sentido.
8 Processar e ler o resultado
Com o arquivo carregado e os padrões preenchidos, clique em Processar Arquivo. O resultado vem em duas abas:
| Aba | O que tem dentro | O que fazer |
|---|---|---|
| ✅ Acertos | Grupos cuja soma deu zero: a nota foi lançada e baixada certinho. | Nada. É o que está resolvido. |
| ⚠️ Diferenças Pendentes | Grupos que sobraram com saldo — e as linhas marcadas como sem grupo. |
É aqui que você trabalha. |
As colunas do resultado
- NF — o número que ele usou para agrupar (ou
sem grupo). - Descrição — todos os históricos daquele grupo, um embaixo do outro.
- Data — as datas correspondentes, na mesma ordem.
- Total Ajustado — a soma do grupo, já com débito e crédito com o sinal certo.
- valores — os valores originais de cada lançamento, para você conferir de onde veio a diferença.
O que significa "sem grupo"
São lançamentos em que o programa não achou nenhum dos seus padrões. Eles não somem do relatório — aparecem um por linha nas pendências. Se tiver muita coisa ali, é sinal de que faltou padrão: volte ao passo 4 ou 5, ajuste e processe de novo.
Por último, clique em 📥 Baixar Resultado Consolidado para salvar o Excel com as duas abas, já formatado para anexar no seu papel de trabalho.
9 Salvar perfis por cliente
Cada cliente lança de um jeito. Em vez de reconfigurar tudo todo mês, salve um perfil por cliente.
- Criar — em Salvar / Criar Novo, escreva o nome (ex.:
Transportadora Silva) e clique em 💾 Salvar. - Atualizar — deixe o campo do nome vazio e clique em Salvar: ele grava por cima do perfil que está aberto.
- Trocar — escolha no menu Selecione o Padrão no topo da barra lateral.
- Excluir — botão 🗑️ Excluir. Não dá para apagar o último perfil que sobrou.
Num arquivo config_agrupador.json, na mesma pasta do programa. Guarde uma cópia dele junto com os seus backups: é ali que está todo o trabalho de configuração dos seus clientes.
10 Conferir o histórico inteiro de um fornecedor
O programa não olha só o mês. Quem escolhe o período é você, na hora de exportar do seu sistema — e é justamente no período longo que ele mais rende.
-
Exporte tudo
No seu sistema, gere o razão daquele fornecedor sem filtro de data, do primeiro lançamento até hoje.
-
Use o perfil que você já tem
Se você já configurou esse cliente para o fechamento mensal, o mesmo perfil serve. Não precisa refazer nada.
-
Processe e olhe só as pendências
Notas de anos atrás que ficaram penduradas sem baixa aparecem na aba de diferenças, junto com as do mês corrente.
Diferença antiga costuma passar batido no fechamento mensal, porque ninguém volta atrás. Rodar o histórico completo de um fornecedor grande uma vez por ano é a forma mais rápida de achar baixa em duplicidade, nota lançada e nunca baixada e pagamento a maior.
11 Quando algo dá errado
| O que acontece | Por quê | Como resolver |
|---|---|---|
| "Acesso Não Autorizado" | Seu computador ainda não foi aprovado, ou foi bloqueado. | Clique no botão de WhatsApp da própria tela — o Hardware ID já vai na mensagem. |
| "Sem conexão" | O programa não conseguiu falar com o servidor de licença. | Confira a internet e tente de novo. Se persistir, pode ser firewall do escritório. |
| "Faltam colunas: ..." | Sua planilha não tem alguma das quatro colunas obrigatórias. | Renomeie os cabeçalhos conforme a tabela do passo 2. |
| Quase tudo em "sem grupo" | Os padrões não batem com o histórico desse cliente. | Rode o assistente de IA de novo, ou olhe uma linha real e escreva o padrão na mão. |
| Grupos com notas que não são a mesma | Um CNPJ, contrato ou data está sendo lido como número de nota. | Coloque esse número na lista de ignorados (passo 6). |
| A mesma nota em dois grupos | Prefixo fixo ou parcela no fim do código. | Configure o encurtamento (passo 7) e olhe a prévia. |
| A IA respondeu com erro | Cota da chave estourada ou modelo indisponível. | O programa já tenta outros modelos sozinho. Se insistir, troque o modelo na barra lateral ou espere alguns minutos. |
| Não atualiza nunca | Você está abrindo pelo - Nucleo.exe. |
Abra sempre pelo ECONTRAR_COM_IA.exe. |
Na pasta do programa existe um arquivo casca_run.log com o registro do que aconteceu na última abertura. Mande ele junto com o seu relato pelo WhatsApp que a gente identifica o problema bem mais rápido.
Desenvolvido pela empresa
LUMAIRAM INFORMATION TECHNOLOGY DEVELOPERS
Com muito ❤ e ☕