IA no financeiro · Conciliação bancária, artigo 4 de 4. No artigo 3, geramos a skill e lemos o
SKILL.md. Veja a trilha completa e as outras tarefas.
Passo 9: teste antes de confiar
Não confie nas primeiras execuções, mesmo que pareçam certas. Uma skill que funcionou uma vez não está provada. O kit traz o registro de testes (testes/registro-de-testes.xlsx) com quatro fases:
| Fase | O que fazer | Para avançar |
|---|---|---|
| 1 · Dados de teste | rodar com os dados fictícios do kit | bater 100% com o gabarito |
| 2 · Passado conhecido | rodar com 2 ou 3 períodos que você já conciliou à mão, incluindo um difícil | bater com a sua conciliação em todos |
| 3 · Em paralelo | por 2 a 4 semanas, a skill roda e você continua conciliando como sempre | 10 execuções seguidas sem par errado, sem exceção esquecida e com diferença não explicada zero |
| 4 · Confiança com revisão | você para de refazer tudo, mas sempre revisa Divergências e Pendências e rastreia 10 lançamentos até o documento | continua para sempre |
A fase que mais importa: o passado conhecido
Pegue períodos antigos que já foram conciliados e conferidos. Você já sabe a resposta certa: quais lançamentos formaram par, o que ficou pendente, qual era a diferença. Escolha pelo menos um dia difícil: depois de feriado, fim de mês, dia com estorno.
Como comparar:
- Não mostre a resposta para a skill. A conciliação antiga fica fora da pasta da skill e fora das entradas. Se a IA conseguir ler a resposta, o teste não prova nada.
- Compare item por item, não só a diferença final: saldos, pares, divergências, pendências, fórmulas e as origens de cada linha.
- Separe o tipo de erro. Foi falha da skill, erro no arquivo de origem ou uma mudança legítima no processo? Sem essa separação, você "corrige" a skill para acomodar um dado ruim e cria um problema no período seguinte.
- Anote no registro de testes: data, fase, período, com o que comparou, o resultado e a correção feita.
Teste também a parada
Em cópias controladas, remova um arquivo obrigatório, quebre a continuidade, troque o período. O teste passa quando nenhuma conciliação é criada, existe um aviso de parada e uma linha Parada no registro, e a mensagem diz o que falta. Parar cedo é uma funcionalidade, não uma falha.
Dois casos prontos para você rodar
O registro de testes do kit já traz dois casos sem data, para você executar com a sua skill:
- Execução normal: a folha de Verificação preenchida, com a ponte de saldos fechando, diferença não explicada zero, status e data e hora iguais aos do registro e a revisão em branco.
- Continuidade quebrada: nenhuma conciliação gravada, a linha
Paradae o aviso de parada com a mesma data e hora, sem números de negócio.
Preencha a data, o resultado e quem conferiu.
Toda mudança volta para a fase 2
Mudou o banco, o layout do extrato, uma regra, um módulo ou a versão da skill? Volte ao passado conhecido antes de confiar de novo.
O exemplo: Horizonte Claro em 05/10/2026
Para mostrar o kit funcionando, usei uma empresa fictícia, a Horizonte Claro Ltda., e um dia de conciliação montado de propósito para ser difícil.
A empresa
| Conta | uma conta PJ, num banco fictício |
| Controle interno | ERP, com relatório de movimentos financeiros |
| Recebe por | PIX e cartão (duas maquininhas: Rede e Cielo) |
| Paga | fornecedores por boleto e TED, aluguel em débito automático, tributos |
| Frequência | todo dia útil, conciliando o dia anterior |
| Módulos ligados | Base, PIX, Pagamentos, Cartões e Tarifas |
| Tolerância | até 2 dias úteis entre banco e ERP |
| Agrupamento | um lançamento contra vários nunca é casado automaticamente |
| Quem aprova | o controller |
Os arquivos de entrada
A skill recebe três arquivos do dia, mais as referências e os modelos do kit:
| Arquivo | O que é | O que tem de especial |
|---|---|---|
extrato_2026-10-05.csv | o extrato exportado do internet banking, como sai do banco | formato brasileiro (05/10/2026, 1.500,00); cabeçalho com banco, agência e conta; linhas de SALDO ANTERIOR (10.000,00) e SALDO FINAL (10.855,00) no meio dos movimentos; 13 movimentos, um deles repetido |
movimentos_erp_2026-10-05.xlsx | o relatório de movimentos financeiros do ERP | valores sempre positivos, com o sinal dado pela coluna Tipo (Crédito ou Débito); coluna Status (Lançado ou Cancelado); 11 lançamentos |
conciliacao-2026-10-05_v1.xlsx | a conciliação anterior, da sexta-feira 02/10, feita na segunda | fechou em R$ 10.000,00 nos dois lados; é dela que a skill tira o saldo de partida e confere a continuidade |
Além deles, a skill usa:
- a lista de caminhos, para saber onde estão esses arquivos e onde gravar a saída;
- o calendário de dias úteis, para contar a tolerância de 2 dias;
- o de-para de descrições, para reconhecer "PIX RECEBIDO AURORA" como o cliente Aurora;
- a tabela de tarifas contratadas, para conferir a tarifa do pacote;
- o modelo de saída, o modelo do aviso de parada e o registro de execução.
Ficam fora da pasta da skill, só para conferência depois da execução: o gabarito.md, com a conta feita à mão, e o registro-esperado.csv, com a linha que o registro deveria ganhar.
As armadilhas plantadas
O dia foi montado para testar as situações em que uma conciliação apressada erra:
| Armadilha | Onde está | O que a skill precisa fazer |
|---|---|---|
| Linha repetida | BAN-009, Gama, aparece duas vezes no extrato | contar uma vez só e mandar para Pendências |
| Estorno | TED de R$ 600,00 para a Delta saiu (BAN-011) e voltou (BAN-012) | não casar com o pagamento do ERP; Pendências com prioridade alta |
| Um para vários | ERP-104, cartões R$ 3.200,00 × Rede R$ 1.900,00 + Cielo R$ 1.300,00 | não casar sozinha; Pendências, mostrando a soma |
| Cancelado | ERP-111, Ômega, status Cancelado | deixar fora do cálculo e listar para confirmar |
| Valor diferente | Beta: R$ 1.500,00 no banco × R$ 1.450,00 no ERP | Divergências, com os dois valores |
| Só no banco | tarifa do pacote, R$ 45,00 | Divergências; não lançar no ERP |
| Só no ERP | Boreal, R$ 2.750,00, ainda não caiu | Pendências até o fim da tolerância (07/10) |
| Sinais diferentes | débitos negativos no banco, positivos no ERP | aplicar o sinal pelo Tipo |
| Linhas de saldo no meio | SALDO ANTERIOR e SALDO FINAL no extrato | separar dos movimentos e usar na conferência |
| Descrições diferentes | "PAGTO BOLETO ALFA METAIS" × "Pagamento Fornecedor Alfa" | casar por valor e data; descrição só apoia |
Se a skill somasse a linha repetida, o saldo do banco daria R$ 9.955,00 e não bateria com o saldo informado no extrato. Se somasse o cancelado, o ERP daria R$ 11.900,00. As duas contas erradas são as que uma conferência apressada faria.
O resultado esperado
| Banco | Sistema | |
|---|---|---|
| Saldo anterior | 10.000,00 | 10.000,00 |
| Movimentos do dia | +855,00 | +3.100,00 |
| Saldo final | 10.855,00 | 13.100,00 |
| Diferença (sistema − banco) | 2.245,00 |
A diferença é toda explicada:
| Item | Efeito |
|---|---|
| Boreal: recebimento no sistema que ainda não caiu no banco | +2.750,00 |
| Beta: 1.450,00 no sistema × 1.500,00 no banco | +50,00 |
| Tarifa só no banco | +45,00 |
| Delta: pago no sistema; no banco, saiu e voltou | −600,00 |
| Cartões: 3.200,00 no sistema × 1.900,00 + 1.300,00 no banco | 0,00 |
| Diferença não explicada | 0,00 |
O resultado tem 6 pares, 2 divergências e 5 pendências. O detalhe que mais importa: o TED estornado da Delta e os cartões ficam em Pendências, nunca em Conciliados. O estorno porque o fornecedor não recebeu. Os cartões porque a soma bate, mas uma pessoa precisa aprovar o agrupamento.
O resultado gerado
A folha de Verificação é a primeira coisa que a pessoa revisora vê. Na execução que passou, ela ficou assim:
| Conferência feita pela skill | Resultado |
|---|---|
| Extrato: saldo anterior + movimentos = saldo final (10.000,00 + 855,00 = 10.855,00, sem a linha repetida) | PASSA |
| ERP: saldo anterior + movimentos sem cancelado = 13.100,00 | PASSA |
| Continuidade: saldo anterior igual ao final da conciliação anterior (10.000,00) | PASSA |
| Linha repetida BAN-009 e cancelado ERP-111 fora do cálculo | ALERTA |
| Agrupamentos um para vários (cartões; TED e estorno) não casados automaticamente | ALERTA |
| Diferença não explicada igual a zero e sem erros de fórmula | PASSA |
A ponte de saldos sai do sistema e chega ao banco: 13.100,00 − 95,00 (divergências) − 2.150,00 (pendências) = 10.855,00, com diferença não explicada de 0,00. A decisão e a assinatura ficam em branco, para a pessoa.
A folha de Verificação completa aparece no primeiro artigo da trilha, na seção "O que a skill entrega a cada execução". As demais abas:
Ao terminar, a skill grava uma linha no registro de execução:
data_hora;tarefa;skill;versao;periodo;status;…;saida;itens_processados;itens_para_revisao;motivo;revisor;revisado_em
2026-10-29 08:55;T01;conciliacao-bancaria;2.2;2026-10-05;Concluída com alertas;…;conciliacao-2026-10-29_v1.xlsx;13;7;Diferença totalmente explicada com 2 divergências e 5 pendências para revisão;Pessoa revisora;
O revisado_em, no fim, fica vazio. Quem preenche é a pessoa, depois de revisar.
Como testei o exemplo em sessão limpa
Para saber se a skill funciona, não basta rodar na mesma conversa em que ela foi escrita: ali a IA já sabe demais. O teste do exemplo seguiu este método:
- Sessão nova, sem contexto. Uma conversa que nunca viu a construção da skill, com acesso só a uma pasta preparada para o teste.
- Pasta isolada. Dentro dela, apenas a skill, os arquivos de entrada, os modelos e o registro de execução. O gabarito ficou fora.
- Resultado congelado antes de comparar. Os arquivos gerados tiveram o hash (uma espécie de impressão digital) registrado antes da comparação. Assim, ninguém "ajusta" a saída depois.
- Comparação automática em três frentes: a planilha contra o gabarito, a linha do registro contra a linha esperada e a folha de Verificação contra o modelo.
Foram dois cenários: o dia normal e uma continuidade quebrada (o saldo anterior do extrato não bate com a conciliação anterior, e a skill precisa parar). No pacote atualizado, os arquivos de entrada, as saídas e o relato das tentativas estão em testes-para-estudo/01-exemplo-horizonte-claro/.
Dia normal: passou na terceira tentativa
Tentativa 1 — valores certos, forma diferente. Saldos, quantidades e efeito de cada item bateram com o gabarito. A comparação estrita falhou por detalhes de forma: a skill escreveu BAN-009 (1ª linha) onde o gabarito esperava BAN-009, deixou célula vazia onde o gabarito tinha 0, escreveu o período como 2026-10-05 a 2026-10-05 e separou a lista de arquivos com | em vez de vírgula.
Nada disso era erro de conciliação, mas a skill não dizia qual formato usar. A correção foi fixar o formato de cada campo no guia do registro de execução e na skill.
Tentativa 2 — o modelo não cabia o caso. A folha de Verificação tinha só 4 linhas para "itens que exigem decisão", e o caso tinha 5 pendências. Na primeira tentativa, a skill tinha deixado a quinta de fora. Na segunda, escreveu a quinta numa linha que, no modelo, era só espaçamento, e mexeu na parte fixa da folha.
A correção foi ampliar a seção para 8 linhas e dizer na skill o que fazer quando houver mais itens: avisar que o restante está na aba de origem, sem alterar a folha.
Tentativa 3 — passou em tudo. Planilha, registro e folha bateram, e a seção 5 listou as cinco pendências sem tocar na parte fixa.
O ponto importante: as duas falhas vieram do modelo e da falta de padrão de formato, não das regras de conciliação. Nenhuma regra de pareamento ou de classificação precisou mudar.
Continuidade quebrada: a skill parou
Na pasta de teste, o saldo anterior do extrato foi alterado para não bater com a conciliação anterior. O resultado esperado é parar.
Na segunda tentativa, passou: nenhuma conciliação foi gravada, só o aviso de parada, e o registro ganhou a linha Parada com a mesma data e hora do aviso.
2026-10-29 08:43;T01;conciliacao-bancaria;2.2;2026-10-05;Parada;…;aviso-parada-2026-10-29_v1.xlsx;0;0;Continuidade quebrada entre o saldo anterior do extrato e o saldo final da conciliacao anterior;Pessoa revisora;
O aviso explica o motivo e o que fazer: revisar a conciliação anterior e o saldo do extrato, confirmar qual está certo e pedir nova execução. Ele não traz números de negócio; esses ficam na conversa.
O aviso gravado nesse teste é o mesmo mostrado no primeiro artigo da trilha.
Na primeira tentativa, a skill tinha parado corretamente, mas o nome do aviso, o período, o motivo e o campo de saída no registro saíram fora do padrão. Foi o mesmo problema de formato do dia normal.
O pedido de construção também foi testado
Antes de mexer no artigo, uma sessão sem contexto leu o kit com a ficha em branco e o pedido de construção, sem escrever nenhuma skill. Ela listou as regras que entendeu e fez as perguntas que faria antes de escrever: caminho real do registro, quem é a pessoa revisora, quem recebe o aviso de parada, módulos, tolerância e responsáveis. Era o comportamento esperado: com a ficha vazia, a IA pergunta em vez de inventar.
Até o conferidor erra
Numa das conferências, o verificador do registro acusou 1 falha, e ela foi lida como 0. A tentativa foi registrada como aprovada, e o erro só apareceu na reexecução. O registro foi corrigido e a tarefa reaberta.
Vale para o seu teste: confira também a régua que você usa para conferir, seja um script, uma planilha de comparação ou a sua própria leitura.
Os cinco tipos de empresa que testamos
O kit foi aplicado a cinco empresas fictícias, cada uma com perfil, ficha, fontes, perguntas, SKILL.md, saída e gabarito próprios. O objetivo era ver se a mesma estrutura se adaptava a formas de trabalho diferentes. Elas são os perfis mais comuns, não um limite: o template serve para empresas de qualquer porte e segmento, e o que muda de uma para outra fica na ficha que você preenche.
| Empresa | Perfil | O que variou | Resultado |
|---|---|---|---|
| Boutique Vento Sul | loja, conciliação semanal | PIX, cartão, dinheiro, folha e guias; caixa em planilha | 0 falhas; diferença de R$ 649,00 explicada |
| Clínica Bem Viver | serviços, diária | boletos, PIX, pagamentos, tarifas, folha e impostos retidos | 0 falhas; diferença de R$ 4.164,57 explicada |
| Distribuidora Rota Sul | ERP, diária | duas contas, pagamentos em lote e antecipação | 0 falhas; diferença de R$ −8.211,20 explicada |
| Casa Lume | e-commerce, mensal | marketplace, intermediador, chargeback e devolução | 0 falhas; diferença de R$ 1.967,25 explicada |
| Studio Bela Flor | salão MEI, sem registros | conta pessoal misturada | 0 falhas; 25 de 25 linhas classificadas |
Como ficou a pasta da loja Vento Sul, por exemplo:
Empresa/
├── Automações/
│ ├── conciliacao-bancaria/ ← a skill (SKILL.md + referências + ficha preenchida)
│ └── Lista de caminhos/
│ └── caminhos-entrada.xlsx ← fora da pasta da skill
├── Financeiro/
│ ├── Extratos/extrato_2026-10-05_a_2026-10-11.csv
│ ├── Maquininha/pagfacil_recebiveis_2026-10.csv
│ └── Conciliação Bancária/
│ ├── conciliacao-2026-10-05_v1.xlsx ← a semana anterior
│ └── conciliacao-2026-10-13_v1.xlsx ← a gerada pela skill
└── Loja/caixa_2026-10.xlsx
O que muda na skill de cada perfil
A estrutura é a mesma; o que muda é o que a ficha liga e as regras que ela pede.
- Loja (Vento Sul): liga PIX, cartões, dinheiro e folha. A ficha precisou definir qual lado é o da empresa, o que fazer com recebíveis previstos para depois do período e regras diferentes para a conciliação semanal.
- Clínica (Bem Viver): liga boletos, PIX, pagamentos, tarifas e folha. Impostos retidos não são desconto: a skill confere o percentual e só abre pendência se for diferente do esperado. A conciliação anterior precisa ser a mais recente.
- Distribuidora (Rota Sul): liga pagamentos e antecipação. A skill precisou filtrar a conta certa dentro do ERP, separar a taxa do borderô e dar prioridade às devoluções.
- E-commerce (Casa Lume): liga marketplaces e cartões. Pedido e repasse não podem ser somados duas vezes, e a comissão contratada precisa estar na tabela de taxas.
- Salão MEI (Bela Flor): usa o modo sem registros. A saída central é a aba Extrato classificado, com totais separados de empresa, pessoal, transferências e não identificados.
A rodada de parada
Uma segunda rodada plantou cinco defeitos: extrato incompleto, continuidade quebrada, bloqueio judicial, relatório de marketplace faltando e arquivo do mês errado. As cinco skills pararam e nenhuma gravou planilha. A rodada também mostrou que a mensagem de parada precisa dizer os números, o arquivo esperado, o que falta e outros itens urgentes já vistos.
No pacote atualizado, esse material está em testes-para-estudo/02-cinco-empresas/. Vale comparar as fichas preenchidas: a estrutura é a mesma, mas os módulos, as tolerâncias e as exceções mudam conforme o perfil.
O limite desse teste
Os cinco casos passaram sem falhas, mas quem escreveu cada skill viu os arquivos do próprio caso. Isso pode calibrar as regras aos dados conhecidos. Por isso, o resultado mostra que o kit é consistente, não que ele é robusto em qualquer situação. Na sua empresa, o teste que vale é o da fase 2: períodos que a skill nunca viu.
O que deu errado no caminho
A skill casou os cartões. No primeiro teste com os dados da Horizonte Claro, a skill viu que 1.900,00 + 1.300,00 = 3.200,00 e marcou o lançamento como conciliado. A soma batia, mas ninguém tinha aprovado o agrupamento. O erro virou uma linha no catálogo ("um para vários: Alertar, não casar") e, na versão seguinte do kit, os cartões passaram a ficar em Pendências.
A skill acertou a conta e errou o formato. No teste em sessão limpa, os valores bateram já na primeira tentativa, mas campos como período, lista de arquivos e referências saíram cada um de um jeito. Formato que não está escrito vira escolha da IA. Detalhes na seção "Como testei o exemplo em sessão limpa".
O modelo de saída não comportava o caso. A folha de Verificação tinha 4 linhas para itens de decisão, e o exemplo tinha 5 pendências. A skill improvisou e escreveu numa área fixa da folha. O modelo passou a ter 8 linhas, e a skill passou a saber o que fazer quando houver mais.
O registro de execução não existia. Num teste, o arquivo do registro não tinha sido copiado para a pasta. A skill entregou a conciliação e avisou, sem criar o arquivo por conta própria. Foi o comportamento certo, e a lição foi para o passo a passo: copie o modelo e anote o caminho antes da primeira execução.
Os cinco perfis revelaram buracos no kit. Todos foram corrigidos na versão atual:
| O que os testes mostraram | Como ficou no kit |
|---|---|
| A lista de caminhos marcava a conciliação anterior como obrigatória e, ao mesmo tempo, mandava só alertar se ela faltasse | passou a "Não / Alertar"; na primeira execução, a skill usa o saldo do extrato nos dois lados e avisa |
| Não havia regra para quando dois módulos, ou a ficha e o catálogo, discordam | regra 9 da ficha: vale a coluna Usa? e a regra mais específica; na dúvida, Pendências |
| Não estava claro se dava para reprocessar uma data antiga | regra 10 da ficha: vale a data que a pessoa pedir, e ela aparece no Resumo |
| "Módulo 0" confundia "só a Base" com o modo sem registros | no de-para, 1 = só a Base e 0 = modo sem registros |
| A tabela de taxas não tinha comissão de marketplace | ganhou a aba Marketplaces |
| Impostos retidos viravam pendência mesmo quando estavam certos | o catálogo manda conferir o percentual e só abrir pendência se for diferente |
A ficha ficou para trás em relação ao resto do kit. Ao revisar o kit para este artigo, três trechos da ficha ainda descreviam a versão anterior: a regra de parada dizia "não grava nada" (hoje grava o aviso e a linha Parada), a lista de módulos ia de 2 a 9 (são 13) e as abas de saída não citavam a Verificação. Quando você muda uma peça do kit, confira as outras: ficha, catálogo, modelo de saída e pedido precisam contar a mesma história.
Os testes também revelaram três ajustes de redação na ficha: módulos numerados até 13, a parada que grava o aviso e a linha de registro, e a aba Verificação como primeira aba da saída. Esses ajustes devem acompanhar a próxima versão do template.
O próprio comparador tinha defeito. A ferramenta que conferia as saídas com os gabaritos esperava uma pasta fixa de saída, que duas empresas não usavam. Vale para qualquer teste: confira também a régua que você usa para conferir.
Limites
- A skill não acessa o internet banking, não lança, não paga e não aprova.
- Ela lê arquivos exportados e autorizados; não recebe senha, token nem acesso ao banco.
- Um lançamento contra vários, estornos e casos ambíguos vão para Pendências; ela não decide.
- Cada mudança de banco, layout, regra ou módulo exige voltar aos testes.
- A economia de tempo depende da sua empresa. Meça a sua durante a fase em paralelo.
Ainda não é hora de montar a skill se os saldos não fecham, se contas pessoais e da empresa se misturam sem separação, se ninguém sabe qual é a fonte interna ou se não há responsável pelas pendências. Nesse caso, comece pelo modo sem registros.
Perguntas frequentes
Posso usar o extrato real? Só depois dos testes com dados fictícios e com autorização da empresa. Use o mínimo de dados necessário, numa pasta ou conector aprovado.
Quantos testes são suficientes? O kit sugere: 100% no gabarito dos dados de teste, 2 ou 3 períodos já conciliados (com pelo menos um difícil) e 10 execuções seguidas em paralelo sem par errado, sem exceção esquecida e com diferença não explicada zero. Depois disso, a revisão continua para sempre.
Mudou o banco ou o layout do extrato. E agora? Volte à fase 2: rode de novo com períodos que você já conhece antes de confiar.
Fim da trilha
Esta foi a última parte da conciliação bancária. A trilha completa e as próximas tarefas estão na página da série.
Template de conciliação bancária com IA
Não comece do zero. O template traz tudo o que você viu nesta trilha, pronto para preencher com as regras da sua empresa:
- Ficha de mapeamento modular: perfil da empresa, Base e 13 módulos (boletos, PIX, cartões, marketplace, folha…). Você usa só o que a empresa faz.
- Catálogo com 100 situações de erro e exceção, já classificadas em Corrigir, Alertar e Parar.
- Modelos prontos: planilha de conciliação com fórmulas e folha de Verificação para assinatura, aviso de parada e registro de execução.
- Lista de caminhos, referências (glossário, de-para, calendário de dias úteis, tarifas) e o pedido de construção testado para gerar a skill.
- Testes para estudo: o case Horizonte Claro com gabarito, execuções em sessão limpa e cenários fictícios de perfis variados.
A skill que vai para a rotina é a que você monta com a ficha da sua empresa, e testa antes de confiar.