SenhorPC/AI
Blog

12.286 documentos fiscais depois, o que um agente de IA acerta e onde ele mente

· Alessandro Lucca

Um cliente nosso, uma indústria brasileira com várias unidades, tinha o mesmo problema que quase toda empresa desse tamanho tem: nota fiscal, boleto, fatura e conhecimento de transporte chegando por e-mail e por pasta compartilhada o dia inteiro, e alguém tendo que abrir cada um, ler, conferir se é mesmo para a empresa, achar o pedido de compra correspondente e arquivar no lugar certo.

Hoje quem faz o primeiro passo disso é um agente de IA que chamamos de Charles. Contamos os documentos que ele já leu e classificou: 12.286, medidos na base do cliente no dia 9 de setembro de 2026. Em 20 de junho eram 8.825. São 3.461 documentos em 81 dias, cerca de 43 por dia, todo dia, incluindo os dias em que ninguém estava olhando.

Esse é o número. Agora a parte que quase ninguém publica.

O que ele faz, em português

O documento chega, por e-mail ou por uma pasta no Drive. O agente lê o arquivo e extrai o que interessa: tipo do documento, quem emitiu, para quem foi, CNPJ, número, série, a chave de 44 dígitos, valor e datas. Confere se o destinatário é mesmo a empresa. Procura o número do pedido de compra e valida o formato. Cruza com o painel onde o time de notas fiscais trabalha, classifica por unidade, renomeia o arquivo com um padrão e arquiva.

Depois disso, uma rotina separada casa cada documento com a autorização de pagamento que veio do ERP.

Repare no que ele não faz: ele não aprova pagamento. Ele marca, organiza e deixa pronto. Quem valida é uma pessoa, todo dia. Essa fronteira não é acidente nem timidez, é desenho.

As três vezes que ele errou calado

Erro que estoura é fácil. O sistema para, alguém recebe um alerta, conserta. O problema de verdade é o erro que passa e parece sucesso.

Primeiro: o valor vazio que virava zero. Quando um documento chegava sem valor preenchido, uma linha do código trocava o vazio por zero para a conta não quebrar. A conta não quebrava mesmo. Só que zero cabe dentro de qualquer saldo de pedido, então a conferência dava "confere" e o documento saía carimbado como aprovado sem que ninguém tivesse lido o valor. Encontramos dois documentos assim, já concluídos. E a parte desconfortável: se alguém preencheu o valor depois, esse caso não aparece na nossa busca. Não temos como contar quantos foram no total.

Escrevemos isso ao cliente no mesmo dia, com os dois documentos identificados para ele conferir, e com essa ressalva escrita com todas as letras.

Segundo: o webhook que morreu e ninguém percebeu. Um dos caminhos do sistema dependia de uma chamada externa. A plataforma do outro lado desativou essa chamada sozinha, depois de uma sequência de erros. Resultado: durante quatro meses e meio aquele caminho simplesmente não aconteceu. Nada falhou. Nada avisou. Não havia erro para alertar, porque não havia execução.

Terceiro: dois documentos órfãos. Um pedido chegou do ERP sem a filial preenchida. O campo de unidade ficou vazio, a etapa seguinte morreu, e dois documentos ficaram aprovados no painel sem que o e-mail de aviso saísse para o responsável da unidade. Eles estavam lá, corretos, e ninguém foi avisado.

O que construímos depois disso

As três falhas têm a mesma forma: o sistema não errou, ele emudeceu. E alarme de erro não pega silêncio.

Então existe um segundo programa, separado, cuja única função é perguntar "isto correu?". Ele olha para cada rotina agendada e cobra: a que roda a cada poucos minutos tem que ter rodado na última hora, a diária nas últimas 26 horas, a que depende de chamada externa nas últimas 72. Se alguma não deu sinal, ele avisa.

Duas decisões pequenas nesse programa importam mais do que parecem:

  1. Ele mora fora. Roda em outro provedor, não no mesmo lugar que os agentes que vigia. Vigia hospedado junto do vigiado não vigia nada: se o provedor cai, os dois se calam juntos.
  2. Ele também compara o que está rodando com o que está versionado. Quando alguém edita direto na interface e esquece de salvar a versão, a documentação e a realidade se separam em silêncio. Já aconteceu conosco: o sistema rodou meses com um modelo de IA diferente do que os documentos diziam, e ninguém sabe quando a troca foi feita.

Onde isto não serve

Se o seu volume é de cinco a dez documentos por dia, contratar isto não vale a pena, e dizemos isso antes de você perguntar o preço. O trabalho de montar e manter uma coisa dessas só se paga em fluxo contínuo, e a conta muda bastante conforme seu ERP deixa ou não deixa consultar os dados.

Nesse volume, a saída melhor é você mesmo montar o seu. É exatamente para isso que existe a Imersão SenhorPC/OS: cinco dias para sair com automação própria funcionando, com as mesmas ferramentas que usamos aqui. Sai mais barato e o conhecimento fica com você.

E se você espera um sistema que dispensa conferência humana, também não é aqui. Nada do que está escrito acima elimina a pessoa que valida. O que mudou foi o que ela faz: em vez de digitar 43 documentos por dia, ela confere o que já veio lido, classificado e casado com o pedido.

Por que estamos contando os erros

Porque um caso só com acertos não é um caso, é um anúncio. Todo sistema em produção tem incidentes. A diferença entre um fornecedor e outro não é ter zero problema, é o que acontece no dia em que aparece um: se você fica sabendo pelo fornecedor ou pelo seu contador, se existe registro do que foi corrigido, e se alguém construiu o mecanismo que apanha o próximo.

É isso que fazemos. Não é arrumar computador, é operar um sistema de IA em produção e responder por ele.

Quer ver se isto encaixa no seu fluxo de documentos?
Falar com a SenhorPC