HSBC (399)

Manuais oficiais de referência: Layout de Cobrança HSBC (carteiras CNR e CSB). Fontes e portal em fontes-oficiais.md — os PDFs não são redistribuídos, apenas citados.

Implementação: pycobranca/bancos/hsbc.py · Dígito do banco: 9 · PIX: —

Logo empacotado: disponível via logo_do_banco("399") — a marca é do banco (uso nominativo); ver render/logos/NOTICE.md.

Resumo

Legado. A carteira CNR usa data juliana no campo livre. A CSB foi retirada — ver a seção no fim desta página.

Campo livre (posições 20–44 do código de barras)

Carteira CNR (com data juliana):

Posições	Tam.	Conteúdo
1–7	7	Conta
8–20	13	Nosso número
21–24	4	Data juliana do vencimento (dias do ano + último dígito do ano)
25	1	2 (constante)

Carteira CSB (layout padrão): nosso número(13) + agência(4) + conta(7) + 001.

Dígitos verificadores

• Carteira CNR — o nosso número exibido carrega dois dígitos calculados em nosso_numero_formatado(): o 1º é modulo11_flex do nosso número de 13 posições (fatores 9..2 cíclicos, direita→esquerda; resto 10 → 0), seguido da constante 4; o 2º é o módulo 11 (mesmo mapa 10 → 0) da soma de parte1 + conta + data (DDMMAA).
• Carteira CSB — o nosso número não recebe dígito adicional (13 posições diretas).

Validação de campos (geração do boleto)

Tamanhos em dígitos (mín.–máx.); a máscara é descartada e o valor é preenchido com zero à esquerda. Violações vêm em BoletoInvalido.erros (lista) — ver o contrato de erros e a matriz completa.

Campo	Regra
Conta	1–7 dígitos
Nosso número	1–13 dígitos
Carteira	conjunto: CNR

Formatos de exibição

• Nosso número (CNR): 1234567890123046
• Agência/conta: 1234 / 1234567

Exemplo (saída da engine)

Entrada: carteira CNR, agência 1234, conta 1234567, nosso número 1234567890123, R$ 127,50, vencimento 15/08/2026.

Campo livre:      1234567123456789012322762
Código de barras: 39999153900000127501234567123456789012322762
Linha digitável:  39991.23452 67123.456781 90123.227622 9 15390000012750

A carteira CSB foi retirada

carteiras declarava CNR e CSB. A CSB nunca funcionou e foi retirada. O campo livre monta

nosso número (13) + agência (4) + conta (7) + "001"  =  27 posições

e a FEBRABAN reserva 25. Não é ajuste de dígito: sobram duas posições. Qualquer boleto na CSB é recusado com "campo livre deve ter 25 dígitos".

O defeito foi encontrado varrendo todas as carteiras declaradas de todos os bancos pelo verificador FEBRABAN independente — 55 passaram, esta não. Antes disso a carteira nunca havia sido gerada: os exemplos exercitavam só a CNR.

Corrigir precisa do manual do HSBC, que o banco não publica mais — encerrou as operações no Brasil em 2016. Sem ele não dá para saber qual campo encolhe, e adivinhar produziria um boleto que imprime e é recusado no banco. Anunciá-la como suportada era promessa que sempre falhava, então ela saiu de carteiras e é recusada na validação. A composição continua em campo_livre() para quem tiver o manual, e o defeito fica preso em test_o_campo_livre_do_csb_tem_27_posicoes_onde_cabem_25.