</LUMAIRAM>
Manual de uso

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

  1. Baixe e coloque numa pasta só dele

    Baixe o ECONTRAR_COM_IA.exe e mova para uma pasta própria — por exemplo C:\Encontrar com IA\. Não deixe na pasta Downloads: o programa cria alguns arquivos de apoio ao lado dele.

  2. 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.

  3. 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.

  4. 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.

Sempre abra pelo ECONTRAR_COM_IA.exe

Você 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.

Não feche a janela preta

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:

ColunaObrigatória?O que o programa faz com ela
DataSimMostra as datas de todos os lançamentos do grupo.
Descrição históricoSimÉ aqui que ele procura o número da nota.
ValorSimO valor de cada lançamento.
C/DSimSe é crédito ou débito. É o que permite a soma fechar em zero.
LoteNãoSe existir, é levada junto para o resultado.
ContrapartidaNãoSe existir, é levada junto para o resultado.
Usuário de inclusão / alteraçãoNãoSe existirem, ajudam a rastrear quem lançou.
Usa outro ERP ou relatório diferente?

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!

"Faltam colunas: ..."

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.

  1. 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.

  2. Suba o arquivo

    Na área central, escolha o Excel ou CSV. Assim que ele carrega, aparece o painel Assistente de IA: Descobrir Regras Automaticamente.

  3. 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.

  4. 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.

  5. 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.

O que sai do seu computador

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ê escreveO 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.
Número comprido ganha do curto

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.

Agrupou coisa que não tinha nada a ver?

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:

No extrato2300044918
Vira44918

Cortar parcela no final

Com a caixinha marcada, um bloco de quatro dígitos do tipo 0001, 0002 no fim é removido:

No extrato2300023320001
Vira2332

Conforme você digita, aparece uma tabelinha de Prévia mostrando o antes e o depois. Confira ali antes de processar.

Ele não deixa encurtar demais

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:

AbaO que tem dentroO 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.
Onde os perfis ficam

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.

  1. Exporte tudo

    No seu sistema, gere o razão daquele fornecedor sem filtro de data, do primeiro lançamento até hoje.

  2. 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.

  3. 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.

É aqui que aparecem as surpresas

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 acontecePor 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.
Precisa da nossa ajuda?

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 ☕