Você recebeu ou gerou um boleto com valor R$ 0,00 e ficou em dúvida se isso é um erro ou se é intencional? Boletos de valor zero existem e têm usos específicos — mas também podem indicar um bug no sistema emissor. Este guia explica quando é esperado e quando é problema.
Quando boleto de valor zero é intencional
1. Boleto de cadastro (registro antecipado)
Alguns bancos permitem o registro de um boleto sem valor definido para depois atualizar o valor via arquivo CNAB. É raro hoje em dia, mas algumas integrações antigas usam esse fluxo.
2. Cobrança com valor aberto
Certos sistemas emitem boletos para que o pagador preencha o valor — comum em doações, associações ou acordos onde o valor é definido pelo pagador. O banco aceita qualquer valor acima de zero.
3. Boleto cancelado ou baixado
Um boleto que foi baixado (cancelado antes do pagamento) pode aparecer com valor zero em alguns sistemas de consulta. Não é para pagar.
4. Template ou exemplo
Sistemas de teste frequentemente geram boletos com R$ 0,00 para validar a estrutura sem comprometer valores reais.
Quando boleto de valor zero é um erro
Bug no sistema emissor
O motivo mais comum. Algum campo de valor ficou em branco ou null no banco de dados, e o sistema formatou como zeros. Sintomas:
- Código de barras gerado corretamente, mas campo de valor zerado
- O DV do boleto está correto (o que descarta adulteração)
- Outros boletos do mesmo sistema têm valores corretos
Falha no preenchimento do arquivo CNAB
Se o boleto foi gerado via CNAB e o campo de valor não recebeu padding de zeros adequado, alguns bancos interpretam como zero. Veja erros comuns em arquivos CNAB.
Conversão de moeda ou rounding
Em sistemas que lidam com valores fracionados muito pequenos, um arredondamento incorreto pode zerar o valor.
O que fazer se você recebeu um boleto com valor zero
- Não pague — um boleto de R$ 0,00 geralmente aceita qualquer valor inserido pelo pagador.
- Contate o emissor para confirmar o valor correto e solicitar novo boleto.
- Valide o boleto no Validador de Boleto do Toolspace para verificar se os DVs estão corretos (isso confirma se a linha digitável em si é válida, mas não garante que o valor é o correto).
O que fazer se você gerou um boleto com valor zero
Se você é o desenvolvedor ou responsável pelo sistema:
- Verifique se o campo de valor está chegando como
null,""ou0antes da formatação. - Adicione validação: rejeite a emissão de boleto com valor ≤ 0.
- Se usar CNAB, verifique o padding: valor
R$ 150,00=0000000015000(11 dígitos, 2 decimais implícitos, zeros à esquerda).
# Exemplo de formatação correta de valor em Python
valor_reais = 150.00
valor_centavos = int(round(valor_reais * 100))
campo_valor = str(valor_centavos).zfill(11) # "00000015000"
Posso pagar R$ 0,00 num boleto de valor aberto?
Tecnicamente, alguns bancos processam o pagamento com valor zero — o credor recebe R$ 0,00. Isso não faz sentido como transação e pode gerar inconsistência no sistema do credor. Não faça isso; entre em contato com o emissor.
Perguntas frequentes
Boleto com valor zero tem DV válido? Pode ter — o DV é calculado sobre os dígitos do código de barras, incluindo o campo de valor zerado. Um DV válido não garante que o valor está correto.
O banco processa um boleto de R$ 0,00? Depende do banco e da modalidade. Alguns rejeitam automaticamente; outros processam e cobram tarifa sobre uma transação de zero reais.
Como identificar um boleto cancelado? No sistema de consulta do banco (ex.: consulta de títulos via internet banking), boletos cancelados aparecem com status "Baixado" ou "Cancelado". O valor zerado pode ser artefato de exibição.
Boleto com valor zerado é fraude? Raramente — fraude normalmente altera o valor para cima, não para zero. Valor zero costuma ser erro técnico. Mas sempre confirme com o emissor antes de pagar.
Conclusão
Um boleto com valor R$ 0,00 pode ser intencional (cobrança com valor aberto, template de teste) ou um bug no sistema emissor. Em caso de dúvida, não pague e solicite confirmação ao emissor. Para verificar se o boleto em si é estruturalmente válido, use o Validador de Boleto do Toolspace.