O que é a linha digitável de um boleto
A linha digitável é a sequência de 47 dígitos impressa na parte superior de um boleto bancário, pensada para ser digitada manualmente (por isso vem dividida em blocos com dígitos verificadores próprios). Ela carrega a mesma informação do código de barras de 44 dígitos, só que em outra organização — cada banco emite tipicamente uma ou outra representação dependendo do canal.
Como funcionam os dígitos verificadores (módulo 10 e módulo 11)
Os 3 primeiros campos da linha digitável têm cada um seu próprio dígito verificador em módulo 10: multiplica-se cada dígito do campo por pesos alternados 2 e 1 (da direita para a esquerda), soma-se os algarismos de produtos maiores que 9, e o dígito verificador é o complemento dessa soma para o próximo múltiplo de 10. O código de barras completo tem um único dígito verificador geral em módulo 11: pesos de 2 a 9 ciclicamente, também da direita para a esquerda; se o resultado da fórmula for 0, 10 ou 11, o dígito verificador correto é 1 (uma exceção que costuma ficar de fora de explicações simplificadas).
Valor e vencimento
O valor do boleto é armazenado em centavos, como um número inteiro de 10 dígitos — por isso ele nunca é exibido com arredondamento de ponto flutuante. Quando o campo de valor vem todo zerado, significa que o boleto foi emitido com "valor a critério do beneficiário", um caso legítimo, não um erro. O vencimento é codificado por um fator — um contador de dias desde 07/10/1997 — que se repete em ciclos de 9.000 dias; esta ferramenta assume que o boleto pertence ao ciclo mais recente possível.
Limitação: boletos de arrecadação/convênio
Boletos de arrecadação — contas de consumo (água, luz, telefone) e tributos — usam uma estrutura de código de barras diferente da do boleto de cobrança bancária padrão, embora também tenham 44 dígitos e sejam identificados pelo primeiro dígito ser 8. Esta ferramenta detecta esse caso e recusa explicitamente a decodificação, em vez de apresentar banco, valor ou vencimento inventados a partir de uma estrutura que não é a que o código realmente usa.