Ficha técnica
| Tipo | Introdução + Demonstração + Atividade Prática + Desafio |
| Bloco | AI no Financeiro · Terceira atividade prática da aula |
| Duração | 18 minutos |
| Ferramenta | Claude Code ou Claude Cowork (modelo Sonnet 4.6) |
| Pré-requisito | AP02 concluída. O Claude já sabe ler a NF-e e devolver JSON com numero_nota, fornecedor, valor_nota e data |
| Entregável | Um relatório de conciliação que separa o que bateu do que precisa de revisão, com o alerta da Grafica Sergipe disparado |
Agora a nota encontra a planilha. A AP02 te deu a NF-e em JSON. A AP03 cruza esse JSON com a planilha de pagamentos pelo número da nota, calcula a diferença e marca o que tá fora do limite. No fim você sai com uma ferramenta que pega, em 2 segundos, exatamente o tipo de erro que custou R$ 8.000 pra Camila numa sexta à tarde.
Por que porcentagem e não valor exato? Porque centavo de arredondamento acontece. ICMS calculado em casas decimais diferentes, troco de boleto, ajuste de frete. Você não quer alerta pra cada R$ 0,02.
Você quer alerta pra erro de verdade. 1% separa o ruído normal do contas a pagar do erro que custa dinheiro. Acima disso, alguém olha. Abaixo, segue o jogo.
A fórmula é uma só, e ela cabe numa linha:
Diferença percentual
diferenca_pct = |valor_pago - valor_nota| / valor_nota * 100
Em palavras: pega a diferença em reais entre o que foi pago e o que a nota dizia, divide pelo valor da nota e multiplica por 100. O resultado é uma porcentagem, e é nela que a régua trabalha.
Até 1%: ok. É arredondamento, ajuste fiscal, centavo de boleto. Passa direto.
Acima de 1%: alerta. Vai pro relatório de revisão antes de qualquer pagamento sair.
A planilha de pagamentos tem 11 linhas e 2 erros de verdade. O gritante: a Grafica Sergipe, nota de R$ 2.000, alguém digitou R$ 10.000 no pagamento. Diferença de 400%. É a história da Camila.
O sutil: a Distribuidora Atlantico, nota de R$ 3.200, pagamento de R$ 3.360. Diferença de 5%. Pequeno pra passar no olho, grande o bastante pra doer. A régua de 1% pega os dois.
E tem 1 quase-erro pra te enganar: a Manutencao Predial, nota de R$ 4.500, pagamento de R$ 4.512,30. Diferença de 0,27%. Arredondamento, NÃO é alerta. Se o Claude marcar essa, a régua tá errada.
O professor mostra a construção da conciliação em 4 prompts encaixados. Cada um adiciona uma camada, em vez de mandar tudo de uma vez. Você vê o Claude pensar passo a passo.
numero_nota como chave de cruzamento.numero_nota e aplica a fórmula da diferença percentual. Sai uma lista com a porcentagem pra cada nota.Depois desses 3, o prompt 4 do lote fecha: pega 11 XMLs e a planilha completa, processa tudo e devolve um relatório. Quantas bateram, quantas precisam de revisão, quais são. É o ponto que a AP01 e a AP02 levavam.
Você podia mandar tudo numa mensagem. Mas quebrar em 4 te ensina a construir: cada prompt é uma camada que o Claude valida antes de seguir. Se algo sai estranho, você sabe em qual passo corrigir.
É o mesmo método pra qualquer fluxo financeiro novo. Reconhecer, calcular, filtrar, escalar.
Quando o Prompt 5 roda em cima da planilha plantada, saem 2 linhas de alerta. A que escreve a história:
Saída esperada do filtro de 1%
ALERTA: Nota 12345, Grafica Sergipe Valor da nota: R$ 2.000,00 Valor pago: R$ 10.000,00 Diferenca: 400% Status: revisar antes de pagar
E a que ninguém pegaria no olho, mas a régua pega:
ALERTA: Nota 12660, Distribuidora Atlantico Valor da nota: R$ 3.200,00 Valor pago: R$ 3.360,00 Diferenca: 5% Status: revisar antes de pagar
Essa é a linha que passou batido pela Camila numa sexta à tarde. O Claude pegou em 2 segundos.
Não foi sorte. Foi a régua certa, aplicada em cima do dado certo, no momento certo. E a Manutencao Predial (0,27%), aquela com cara de erro, nem apareceu na lista. Régua boa não grita à toa.
A copy do alerta pode mudar. O importante é o conteúdo: número da nota, fornecedor, os dois valores, a diferença em porcentagem e o status. Com isso na mesa, quem aprova decide em 10 segundos se o pagamento sai ou volta pra revisão.
Agora você sai do papel e roda a conciliação inteira. Sobe a planilha, ensina o Claude a entender a estrutura, aplica a fórmula, liga o filtro de 1% e por fim joga o lote de 11 notas pra ele processar tudo. 5 passos, 4 prompts. Quando terminar, você tem a Grafica Sergipe gritando alerta e a Manutencao Predial em silêncio.
Na demo você assistiu. Aqui você faz. Suba a planilha, copie os prompts na ordem, observe a saída de cada passo. Não pule etapa. A graça é ver o Claude construir camada por camada.
Baixe a planilha de pagamentos da Idens Academy e jogue na pasta do seu projeto (a mesma pasta da AP02, onde está o XML da nota 12345). São 11 linhas, uma por pagamento.
Detalhamento: abre a planilha rapidinho num editor (Excel, Numbers, Google Sheets) só pra confirmar que ela chegou inteira. Não precisa mexer em nada. O Claude vai ler.
Antes de cruzar nada, peça pro Claude descrever como ele leria a planilha. Isso evita que ele invente coluna ou cruze pelo campo errado. Use o botão Copiar e cole no chat.
O que esperar: o Claude responde listando as colunas que identificou (numero_nota, fornecedor, valor_pago, data) e diz que vai usar o numero_nota como chave pra encontrar a nota correspondente. Se ele fizer isso, tá calibrado pra cruzar.
Agora aplica a fórmula. O Claude já tem o JSON da nota 12345 (da AP02) e acabou de entender a planilha. Esse prompt cruza os dois e calcula a porcentagem pra cada linha.
O que esperar: uma lista das notas com a coluna de diferença percentual. A maioria fica em 0% (bateu certo). A Manutencao Predial sai em 0,27%, a Distribuidora Atlantico em 5% e a Grafica Sergipe em 400%.
Liga o filtro. Só o que passar de 1% deve voltar, com os campos do alerta. Esse é o prompt que pega a Grafica Sergipe e a Distribuidora Atlantico, e ignora a Manutencao Predial.
O que esperar: aparecem 2 linhas, a Grafica Sergipe (nota 12345, R$ 2.000 vs R$ 10.000, 400%) e a Distribuidora Atlantico (nota 12660, R$ 3.200 vs R$ 3.360, 5%). A Manutencao Predial (0,27%) não aparece. Se ela aparecer, o filtro tá errado.
Pra fechar, sobe o zip com as 11 notas e manda o Claude processar tudo de uma vez. É aqui que a ferramenta escala.
Baixe, descompacte na pasta do projeto e cole o prompt:
O que esperar no relatório: 9 bateram (8 com diferença 0% e 1 dentro do limiar, a Manutencao Predial em 0,27%), 2 precisam de revisão (a Grafica Sergipe a 400% e a Distribuidora Atlantico a 5%). Em segundos, sem ler linha por linha. É a régua da Camila funcionando em escala.
Você sai desta atividade com
- A régua de 1% definida e validada num caso real (a Grafica Sergipe e a Distribuidora Atlantico entram, a Manutencao Predial fica de fora).
- O relatório de lote rodado em cima de 11 notas, separando o que bateu do que precisa de revisão.
- O alerta funcionando: nota, fornecedor, os dois valores, a diferença em porcentagem e o status pra revisão.
- Um fluxo reaproveitável: reconhecer, calcular, filtrar, escalar. Os mesmos 4 prompts servem pra qualquer outra conferência financeira que você fizer.
Vocês acabaram de construir isso. Em poucos minutos. Toda empresa tem uma Camila e uma planilha com um zero a mais escondido. A diferença é se tem ou não uma régua rodando antes do pagamento sair.
É a tese do workshop em prática: você descreve o resultado, o Claude faz o trabalho.
Você acabou de pegar o erro de R$ 8.000 da Camila numa planilha fictícia. Agora repete o método com dados reais do seu financeiro. Pode ser qualquer conferência que hoje alguém faz no olho.
O que fazer:
- Escolha 1 conferência crítica que hoje é feita no olho. Sugestões: nota fiscal x pagamento, extrato bancário x lançamento contábil, comissão calculada x meta atingida. Pega a que mais te dá dor de cabeça no fechamento.
- Junte os 2 arquivos: o documento de origem (NF-e, extrato, relatório de vendas) e a planilha de controle. Anonimize se precisar, troque CNPJ por XXXX, mas preserve a estrutura.
- Defina a régua honestamente. Pra nota fiscal x pagamento, 1% costuma servir. Pra extrato, pode ser R$ 1 absoluto. Pra comissão, pode ser 0,5%. Escreva a régua antes de mandar pro Claude.
- Rode os 4 prompts na ordem da atividade: entender a planilha, calcular a diferença, filtrar acima da régua, rodar o lote. Use os mesmos textos do Passo 02 ao 05, trocando só o nome dos arquivos e a régua.
- Compare com o que o seu time encontrou no olho na última conciliação. Se o Claude pegou algo que ninguém viu, você acabou de provar a ferramenta. Se ele perdeu algo, ajusta a régua e roda de novo.
Da NF-e em XML até o relatório de lote com alerta. 3 apostilas, 1 ferramenta de verdade. A próxima nota da Grafica Sergipe, na sua empresa, não passa batido.
A régua tá no ar. O Claude tá pronto. O turno da sexta à tarde acabou de mudar.