Como Extrair Dados de Boleto Bancário
para Excel para Conciliação de Pagamentos
O sistema brasileiro de Boleto Bancário processa cerca de 37 bilhões de transações por ano, cada uma regida por um padrão preciso da FEBRABAN que define onde cada dígito do código de barras de 44 caracteres pertence. No entanto, a maioria das equipes financeiras que lidam com pagamentos transfronteiriços ainda extrai esses dados da mesma forma que fazia antes de o padrão existir: manualmente. Entre o PDF que chega de um fornecedor brasileiro e o lançamento final de conciliação na sua planilha existe uma lacuna de digitação manual, copiar e colar e conferência visual que a própria estrutura do documento foi projetada para eliminar.
Principais Conclusões
- 37 bilhões de transações de Boleto por ano — todas construídas sobre um padrão FEBRABAN que coloca cada um dos 44 dígitos do código de barras em uma posição previsível.
- O mesmo padrão estruturado que permite a qualquer scanner bancário verificar um pagamento em milissegundos ainda exige que um humano leia e digite cada campo em uma linha da planilha.
- Defina suas colunas uma vez — Código de Barras, Vencimento, Valor, Beneficiário — e extraia dezenas de Boletos em lote para uma única linha do Excel por documento.
O que é um Boleto Bancário e por que ele tem dois conjuntos de números?
Um Boleto Bancário — frequentemente abreviado apenas como Boleto — é um instrumento de pagamento regulamentado emitido por bancos brasileiros. Pense nele como um híbrido entre uma fatura e um comprovante de pagamento: o beneficiário o emite por meio do banco, e o pagador o utiliza para efetuar o pagamento em qualquer um dos mais de 40.000 locais no Brasil — bancos, casas lotéricas, supermercados, agências dos Correios ou pelo internet banking.
Todo Boleto contém um código de barras de 44 dígitos otimizado para leitura óptica e uma linha digitável de 47 dígitos projetada para digitação manual em caixas eletrônicos e aplicativos bancários. Ambos representam o mesmo pagamento — apenas o codificam de forma diferente.
Os 44 dígitos do código de barras são divididos em cinco seções definidas pelo padrão de layout de código de barras da FEBRABAN (Layout - Código de Barras - Versão 7):
| Posições | Campo | Exemplo | Finalidade |
|---|---|---|---|
| 1–3 | Código do banco | 001 | Identifica o banco emissor (001 = Banco do Brasil, 237 = Bradesco, 341 = Itaú) |
| 4 | Código da moeda | 9 | 9 = Real brasileiro (R$) |
| 5 | Dígito verificador geral | 3 | Verifica a integridade de todo o código de barras usando módulo-11 |
| 6–9 | Fator de vencimento | 3737 | Dias desde a data-base (07/10/1997) — converte-se na data de vencimento |
| 10–19 | Valor | 0000000100 | Valor em centavos (R$1,00 neste exemplo) |
| 20–44 | Campo livre | 0500940144816060680935031 | Definido pelo banco: nosso número, agência, conta, carteira — varia conforme o banco |
Desde 2018, por determinação da FEBRABAN, todos os Boletos devem ser registrados (boletos registrados) — o banco emissor é notificado de cada Boleto no momento da criação, não apenas quando é pago. O sistema mais antigo de boleto sem registro, em que os bancos só tomavam conhecimento de um Boleto quando ele era apresentado para pagamento, foi descontinuado para reduzir fraudes e melhorar a rastreabilidade. Hoje, todo Boleto que você recebe segue a mesma estrutura padronizada, com registro completo no banco.
Para uma visão mais ampla do cenário de documentos brasileiros — incluindo a Nota Fiscal Eletrônica (NF-e), o sistema obrigatório de fatura eletrônica do país — consulte nosso guia completo sobre documentos fiscais e financeiros brasileiros.
O Gargalo no Processamento de Boletos que as Equipes de Conciliação Conhecem Bem
Um único Boleto contém cerca de uma dúzia de pontos de dados relevantes para a conciliação de pagamentos. Mas, ao contrário de uma fatura, em que os dados são conceitualmente conectados (itens → subtotal → impostos → total), os dados de um Boleto são projetados para a execução do pagamento, não para o registro contábil. O código de barras codifica o valor e a data de vencimento, mas não informa para que foi o pagamento, qual fatura ele referencia ou se o pagador já enviou a remessa correspondente.
Essa incompatibilidade de design cria um problema específico de fluxo de trabalho para as equipes financeiras:
O custo real não é a velocidade de digitação. É o ciclo de conciliação: extração manual → correspondência manual → verificação manual de status. Cada etapa introduz um atraso e um possível erro, e com 37 bilhões de transações por ano, esses atrasos se acumulam em uma ineficiência estrutural em todo o sistema de pagamentos B2B.
Como Extrair Dados de Boleto para Excel — Passo a Passo
A extração de Boletos não exige um fluxo de trabalho complexo. A estrutura do documento é padronizada e os campos necessários para a conciliação são claramente definidos. A única peça que falta é uma ferramenta capaz de lê-los em qualquer formato — seja o Boleto recebido como PDF de um portal bancário, um print de um aplicativo móvel ou um comprovante impresso digitalizado.
O processo funciona em três etapas:
Experimente com um print ou PDF de Boleto abaixo — sem necessidade de cadastro:
Os arquivos são processados com segurança e não são armazenados.
Quais Campos do Boleto São Mais Relevantes para a Conciliação de Pagamentos
Nem todo campo de um Boleto é igualmente útil para a conciliação. A tabela a seguir mapeia os campos que realmente impulsionam a correspondência de pagamentos, o acompanhamento de status e os relatórios — organizados por como são usados na prática, não por onde aparecem no documento.
| Campo (inglês) | Termo em português | Uso na conciliação |
|---|---|---|
| Bar Code (44 digits) | Código de barras | Identificador principal — corresponde à referência do código de barras nos itens do extrato bancário. Use-o para vincular pagamentos a contas a receber. |
| Readable Line (47 digits) | Linha digitável | Versão legível do código de barras. Útil quando um print do Boleto não inclui o gráfico do código de barras. |
| Due Date | Vencimento | Determina o prazo de pagamento e o risco de protesto. Acompanhe o status vencido vs. pendente por faixa de antiguidade. |
| Amount | Valor | Valor principal para correspondência de pagamentos. Cruze com os créditos do extrato bancário. |
| Our Number | Nosso número | Referência interna atribuída pelo banco — geralmente o item mais próximo de um ID de transação exclusivo para conciliação. |
| Beneficiary | Beneficiário / Cedente | Identifica a entidade recebedora. Essencial ao conciliar pagamentos entre múltiplas subsidiárias ou unidades de negócio. |
| Payer | Pagador / Sacado | Identifica quem efetuou o pagamento. Use para relatórios de envelhecimento de contas a receber e acompanhamento de clientes. |
| Portfolio | Carteira | Tipo de acordo de cobrança entre o beneficiário e o banco. Útil para cálculo de tarifas e mapeamento de categorias de conciliação. |
| Your Number | Número do documento / Seu número | Campo opcional em que o beneficiário insere sua referência interna de fatura ou contrato — o vínculo mais direto entre um pagamento de Boleto e seus próprios registros. |
O código de barras é a chave de conciliação mais confiável, pois aparece tanto no Boleto quanto no extrato bancário. Se for possível extrair apenas um campo, extraia o código de barras. O Nosso número é a segunda melhor âncora quando o código de barras não está disponível.
E o Processamento em Lote de Dezenas de Boletos?
O fluxo de extração descrito acima funciona da mesma forma, seja processando um Boleto ou cem. O modelo de Processamento Prioritário em Lote foi projetado para o volume que a conciliação B2B realmente gera: faça o upload de todos os Boletos de um determinado período, defina suas colunas uma vez e deixe a IA extrair cada arquivo com base nas mesmas definições de campo. A saída é um único arquivo Excel com uma linha por Boleto — pronto para importar no seu ERP ou ferramenta de conciliação.
Se você precisa conciliar Boletos com extratos bancários regularmente, considere configurar uma rotina mensal de extração: colete todos os Boletos emitidos e recebidos durante o mês, extraia-os em lote e concilie a planilha resultante com o extrato mensal do seu banco. Todo o processo leva minutos em vez de horas e, como cada campo é extraído com base nas mesmas definições de coluna, você elimina o erro de conciliação mais comum — formatos de campo incompatíveis entre Boletos de bancos diferentes.
Por exemplo, um lote de 50 Boletos de uma variedade de emissores — Banco do Brasil, Bradesco, Itaú, Santander — exigiria anteriormente que um funcionário abrisse cada PDF, localizasse os dígitos do código de barras, a data de vencimento e o valor, digitasse-os em uma planilha e, em seguida, verificasse manualmente se os totais correspondem ao extrato bancário. Com a extração em lote, esses 50 PDFs são carregados em menos de um minuto, a extração é executada em paralelo e a saída chega como um único arquivo estruturado com todas as 50 linhas prontas para conciliação — sem necessidade de manipular cada documento individualmente.
Perguntas Frequentes Sobre Extração de Dados de Boletos
A extração funciona para boletos registrados e sem registro?
Desde 2018, todos os Boletos emitidos no Brasil são registrados. O formato sem registro foi descontinuado pela FEBRABAN. Se você estiver processando Boletos atuais, eles seguem a estrutura padrão de código de barras de 44 dígitos descrita acima. Boletos sem registro mais antigos podem ter layouts de campo ligeiramente diferentes, mas os campos principais de identificação — código do banco, valor, vencimento — seguem a mesma codificação FEBRABAN.
Qual a diferença entre os números de 44 e 47 dígitos?
O código de barras de 44 dígitos é a versão legível por máquina, utilizada por scanners de código de barras. A linha digitável de 47 dígitos é a versão legível por humanos, que inclui três dígitos verificadores extras — um inserido em cada um dos três primeiros blocos — para que um caixa bancário ou ATM possa validar o número à medida que é digitado. Ambos codificam as mesmas informações de pagamento. Alguns PDFs de Boleto exibem apenas um formato; a ferramenta de extração consegue ler qualquer um deles.
Boletos podem chegar como PDFs criptografados?
Sim — alguns bancos e plataformas de pagamento enviam PDFs de Boleto com proteção por senha. A ferramenta de extração suporta PDFs protegidos por senha, desde que você forneça a senha. Para Boletos recorrentes da mesma fonte, é possível salvar a senha previamente para que os anexos criptografados sejam desbloqueados automaticamente ao chegarem.
E se o Boleto estiver manuscrito ou danificado?
Os documentos de Boleto Bancário são sempre gerados e impressos por computador, portanto, manuscritos e danos ao documento são raros. No entanto, se um Boleto foi manuseado fisicamente — dobrado, rasgado ou manchado — a IA ainda consegue ler campos parcialmente obstruídos, desde que o código de barras ou a linha digitável estejam intactos. Impressões desbotadas ou de baixo contraste são o problema de qualidade mais comum, e a extração lida com elas com a mesma precisão que documentos limpos.
Posso extrair dados do XML do Boleto em vez do PDF?
Alguns bancos fornecem dados de Boleto como XML ou JSON por meio de suas APIs. Se você tiver acesso programático a esses arquivos, a extração de dados estruturados é um processo diferente da extração visual de PDFs/imagens. O método descrito neste artigo é para quando você recebe Boletos como documentos visuais — PDFs, capturas de tela ou scans impressos — que ainda é o padrão dominante em transações B2B transfronteiriças, onde o destinatário não possui uma integração direta com todos os bancos brasileiros.
Boletos são emitidos em outras moedas além do BRL?
Praticamente todos os Boletos são denominados em Real Brasileiro (BRL). A posição do código da moeda (posição 4 do código de barras de 44 dígitos) é sempre 9 para BRL. Embora os padrões da FEBRABAN suportem tecnicamente outros códigos de moeda (2 para USD comercial, 14 para EUR), estes são extremamente raros na prática e quase nunca encontrados no processamento padrão de Boletos B2B.
O padrão recorrente em cada Boleto que você processará é a padronização — um código de barras de 44 dígitos, uma estrutura de campos fixa e um sistema bancário regulamentado que define exatamente onde cada dado reside. A lacuna não são dados faltantes. É a tradução desse formato padronizado para as linhas da sua planilha de conciliação. A extração semântica elimina essa etapa de tradução por completo — não prevendo onde um campo pode aparecer, mas entendendo o significado de cada campo, independentemente de o Boleto vir do Banco do Brasil, Bradesco ou de um print de plataforma de pagamento.