Leitura Conjunto Nacional

O que é e como funciona na prática

O leitor de conjunto nacional é uma ferramenta simples no papel e chata na execução. Ele serve para extrair os dados dos nossos conhecidos boletos de cobrança — aquele código de barras com 47 dígitos — e transformar em informação estruturada que sistemas bancários conseguem processar. Nada de mágica. É uma questão de OCR orientado a um formato muito específico e de entender as regras da Febraban. O campo bancário pode ser lido de duas formas. A primeira, mais comum, é através de scanner com resolução adequada. A segunda, mais barata, é usar a câmera do celular ou uma webcam qualquer. O resultado muda muito dependendo do equipamento e da qualidade do boleto impresso.

Leitura conjunto nacional: o guia que você vai precisar consultar várias vezes

Aqui vai o passo a passo que eu uso no dia a dia, depois de já ter perdido horas tentando fazer funcionar com equipamentos ruins. 1. Prepare o documento O boleto precisa estar legível. Isso parece óbvio, mas a maioria dos problemas começa aqui. Boleto amassado, fotocópia de cópia, tinta borrada — o leitor não vai conseguir extrair o campo corretamente. Use um scanner com pelo menos 200dpi. Se for usar câmera, evite reflexo e certifique-se de que o campo do código de barras está reto e bem enquadrado.

2. Posicione a região de leitura O campo bancário padrão Febraban fica localizado na faixa inferior do boleto, à direita do código de barras. São nove linhas com valores numéricos distribuídos em campos específicos. O leitor precisa focalizar exatamente essa área. Ferramentas mais básicas erram porque tentam ler o documento inteiro. O certo é delimitar a ROI (region of interest) manualmente ou com detecção automática pelos cantos do código de barras. 3. Execute a leitura

Existem múltiplas bibliotecas e softwares no mercado. Os mais confiáveis que eu já testei incluem o boleto-reader de código aberto e as soluções proprietárias de adquirentes como Cielo, Rede e GetNet. A taxa de acerto com um bom scanner e boleto bem impresso gira em torno de 97 a 99%. Com câmera de celular, cai para 85 a 90% em condições ideais, e piora drasticamente se o documento estiver rasgado ou manchado. 4. Valide os dados extraídos Nunca confie cegamente no resultado. Verifique o dígito verificador do campo bancário. A Febraban define um algoritmo de módulo 10 com pesagem específica que permite confirmar se os números lidos estão consistentes. Se o DV não bater, releia. Na minha experiência, isso corrige entre 3% e 5% dos erros de primeira leitura.

5. Transforme em informação útil Os 47 dígitos do código de barras se decompoem da seguinte forma: primeiros 4 dígitos = banco, seguidos por carteira, moeda, configuração nominal, agência e conta, dígitos de controle, valor, campo livre. O campo livre é onde cada instituição coloca suas informações de identificação do título — nosso sacado, nosso número de registro, data de emissão. Sem interpretar o campo livre corretamente, você tem os números mas não sabe a quem pagar nem qual vencimento consultar.

Problemas que eu enfrentei e como resolvi

Uma vez processei uma remessa com mais de dois mil boletos em um dia. Metade deles eram de clientes diferentes, com formatos de campo livre distintos. O leitor padrão falhava em cerca de 120 documentos porque alguns emitentes usavam campos livres não padronizados. A solução foi criar um mapeamento manual por cliente — uma tabela que relacionava o emissor ao layout do campo livre correspondente. Depois de configurar isso, a taxa de sucesso subiu para 99,3%. Gastei cerca de 3 horas na configuração inicial, mas economizei horas de retrabalho posterior. Outro problema recorrente: boletos emitidos por sistemas legados que geram códigos de barras com espaçamento irregular entre os dígitos. O OCR trata cada barra como independente e pode agrupar errado. A workaround foi aplicar um pré-processamento de dilatação e erosão na imagem antes da leitura, usando OpenCV com um kernel de 2x2 pixels. Isso uniu segmentos quebrados e melhorou a precisão em alguns casos.

Onde obter

Bibliotecas open source como a biblioteca Python boleto-reader ou o projeto brasilapi no GitHub oferecem funcionalidades básicas gratuitas. Para uso empresarial com SLA e suporte, as próprias instituições financeiras fornecem SDKs de leitura de conjunto nacional para seus clientes corporativos. Custo varia de gratuito a R$200 a R$500 mensais por unidade processadora, dependendo do volume. A principal limitação que eu vejo as empresas subestimarem é a variabilidade de qualidade dos documentos entrantes. Leitura conjunto nacional funciona muito bem no laboratório. Na prática, você recebe boleto fotografado com celular, fotocópia colorida de fotocópia, documento com rasura, e aí a coisa desandou. Nenhuma ferramenta do mundo resolve isso completamente. Outro ponto: a mudança de padrão. A Febraban atualiza periodicamente as regras do campo bancário. O que funcionava em 2022 pode não gerar resultados idênticos em 2026 sem ajustes. Mantenha suas bibliotecas atualizadas e testem com amostras reais a cada nova release.

E se o volume for alto o suficiente, considere a alternativa de não ler boletos imagem. Muitas instituições oferecem integração via arquivo LoteCNAB ou API direta de compensação. É mais trabalho de implementação inicial, mas elimina completamente a dependência de OCR e reduz o erro para próximo de zero. O que eu recomendo mesmo é começar simples, com uma boa câmera e uma biblioteca confiável, validar contra um banco de dados conhecido, e só escalar quando o processo estiver enxuto. Errar leitura de conjunto nacional custa dinheiro direto — pagamento que deixa de ser compensado, título que vence e não é quitado, cliente que cobra e você não consegue localizar o registro.