Fontes oficiais para documentação bancária¶
Este arquivo registra as fontes oficiais usadas para preencher e revisar os documentos em
docs/bancos/*.md. A regra é: não copiar regra bancária de fonte comunitária sem confirmação
em manual oficial; ao usar um manual, registrar a URL, a versão e a data de consulta.
Fonte regulatória comum¶
- Banco Central do Brasil — Lista de Participantes do STR
- Banco Central do Brasil — Participantes do STR (PDF)
- Banco Central do Brasil — Manual do BR Code / Pix (Bolepix)
Fontes oficiais por banco¶
| Banco | Fontes oficiais | Uso na documentação |
|---|---|---|
| Banco do Brasil (001) | Leiautes de arquivos · API de Cobrança · Manual CNAB 240 (ago/2017) e Especificação de Boleto (jan/2016) | Boleto, CNAB 240/400 e API. |
| Bradesco (237) | Validador de leiautes · Layout CNAB 240 e 400 posições · Especificação de Boleto (ago/2015) | CNAB 240/400 e tabelas de ocorrência. |
| Itaú (341) | CNAB 400 · CNAB 240 · Especificação de Boleto (mar/2015) | Cobrança bancária CNAB. |
| Santander (033) | Layout de arquivos · Cobrança 400 posições H7800 (v2.33, jun/2024) · CNAB 240 H7815 (Multibanco) · Código de barras (v34, set/2021) | CNAB e boleto/código de barras. |
| Caixa (104) | CNAB 400 · CNAB 240 · Manual de Boleto (2020) · Código de barras SIGCB | CNAB e boleto SIGCB. |
| C6 Bank (336) | Manual CNAB · Boleto de Cobrança · Developers | CNAB 400, boleto e APIs. |
| Sicoob (756) | Validador CNAB · Manual de Layout Sicoob (Cobrança) · Sicoobnet Empresarial | CNAB 240/400 e homologação. |
| Sicredi (748) | Cobrança para empresas / manuais CNAB · Manual CNAB 240 e CNAB 400 (ago/2019) · API Pix PJ | CNAB 240/400 e Pix. |
| Banco do Nordeste (004) | Cobrança BNB · Cobrança Eletrônica BNB · Padrão BNB CNAB 400 | CNAB 400. |
| Banrisul (041) | Cobrança Banrisul · Layout Cobrança CNAB 400 e CNAB 240 posições | CNAB 240/400. |
| Ailos (085) | Cooperativas Ailos · Manual Técnico de Cobrança Bancária — 240 Posições | CNAB 240. |
| Unicred (136) | Unicred · Manual de Cobrança Unicred (leiautes CNAB 240 e CNAB 400) | CNAB 240/400. |
Bancos pendentes de manual público localizado¶
Para os bancos abaixo, manter apenas os dados confirmados pelo Banco Central e o layout portado por comparação byte a byte com os vetores de referência, complementando com manual oficial quando obtido no portal do banco ou via canal de homologação:
- Banestes (021)
- Banco de Brasília / BRB (070) — layout DCB obtido via canal de homologação
- CrediSIS (097) — Padronização Boletos de Pagamento, Cooperativa Central de Crédito Noroeste
Brasileiro Ltda., v1.0 (maio/2017): define a composição do nosso número
097XAAAACCCCCCSSSSSS(comX= módulo 11 do CPF/CNPJ do beneficiário). Anterior à IN RFB 2.229/2024 — não cobre CNPJ alfanumérico. - Citibank (745) — layout Citibank de cobrança 400 posições
- Safra (422)
Regra de preenchimento¶
- Registrar no arquivo do banco a URL, a versão do manual e a data de consulta.
- Quando o manual for recebido por gerente/canal privado, registrar nome do documento, versão e data, sem publicar dados sensíveis.
- Enquanto não houver evidência oficial de uma regra, a fonte de verdade é a paridade byte a
byte com vetores de referência (fixtures em
tests/fixtures/), explicitamente anotada nos documentos.
Fixtures de retorno externos (regressão)¶
Além dos vetores próprios, o parser e o validador estrutural são exercitados contra retornos CNAB
reais de terceiros, em tests/fixtures/retorno/externos/ (Caixa 240, HSBC 400, Sicredi 400).
Extraídos do projeto laravel-boleto sob licença
MIT — atribuição completa em externos/NOTICE.md.