Atualização Documentos Bradesco 2025

Author: Maxwbh

specs/Bradesco/4008-524-0311-layout-da-cobranca-bradesco-versao-ingles.pdf

@@ -0,0 +1,104 @@
+# Documentação Completa para o Banco Bradesco - Versão 2025
+
+## Introdução
+
+Esta documentação fornece detalhes técnicos para a geração de boletos bancários, arquivos de remessa e retorno no formato CNAB 240, com ênfase nas particularidades do Banco Bradesco (código 237) para o ano de 2025. Adicionalmente, inclui informações sobre a integração de QR Code Pix no boleto (BolePix ou boleto híbrido), conforme as regulamentações do Banco Central do Brasil (BCB), incluindo a Resolução BCB nº 443/2024 (alterada pela nº 515/2025 e nº 506/2025), que torna obrigatório o QR Code Pix em boletos acima de R$ 200 a partir de fevereiro/2025 para pagamentos instantâneos.
+
+As especificações baseiam-se nos manuais oficiais do Bradesco, padrões FEBRABAN e atualizações para Pix via API ou CNAB. Para implementação em Oracle Database 19c e Oracle APEX 24.2, são fornecidos exemplos em PL/SQL para geração de arquivos e boletos, incluindo QR Code.
+
+## Geração de Boleto
+
+O boleto do Bradesco segue o padrão FEBRABAN para código de barras e layout da ficha de compensação. O documento "Layout da Cobrança Bradesco" (versão 05, julho/2008, com atualizações para 2025 via API) e o "Manual Técnico Operacional Bloquetos de Cobrança" da FEBRABAN definem as regras.
+
+### Layout do Boleto
+
+- **Formato Geral**: A4 ou contínuo, com dimensões da ficha de compensação (95-108 mm altura x 170-216 mm largura). Gramatura mínima 75 g/m², fundo branco, impressão preta ou azul.
+- **Campos Obrigatórios**:
+  - Logotipo Bradesco.
+  - Código do banco (237).
+  - Linha digitável (5 campos com DVs).
+  - Local de pagamento: "Pagável em qualquer banco até o vencimento".
+  - Dados do beneficiário (nome, CNPJ, agência/conta).
+  - Dados do pagador (nome, CPF/CNPJ, endereço).
+  - Valor, vencimento, número do documento.
+  - Instruções (juros, multa, desconto).
+- **Código de Barras**: Intercalado 2 de 5 (44 posições):
+  - Pos. 1-3: 237.
+  - Pos. 4: 9 (Real).
+  - Pos. 5: DV (Módulo 11).
+  - Pos. 6-9: Fator vencimento (dias desde 07/10/1997; em 2025 ~10200+).
+  - Pos. 10-19: Valor.
+  - Pos. 20-44: Campo livre (carteira 09/19, agência, conta, nosso número com 11 dígitos + DV).
+
+Exemplo linha digitável: 23790.00009 01234.567890 12345.678901 2 1234567890123.
+
+Para Oracle 19c/APEX 24.2: Use PL/SQL para calcular DV (função Módulo 11) e gerar PDF com bibliotecas como PL/PDF.
+
+```plsql
+FUNCTION calcular_dv_mod11(p_numero VARCHAR2) RETURN NUMBER IS
+  v_soma NUMBER := 0;
+BEGIN
+  FOR i IN REVERSE 1..LENGTH(p_numero) LOOP
+    v_soma := v_soma + TO_NUMBER(SUBSTR(p_numero, i, 1)) * (CASE WHEN MOD(i, 8) = 0 THEN 9 ELSE MOD(i, 8) + 1 END);
+  END LOOP;
+  RETURN 11 - MOD(v_soma, 11);
+END;
+```
+
+Em APEX: Crie relatório com região para boleto, usando item BLOB para imagem do código de barras.
+
+### Integração de QR Code Pix (BolePix)
+
+O BolePix Bradesco integra Pix ao boleto via API Developers ou CNAB 240 (códigos "P1" para com QR Code, "P2" sem).
+
+- **Geração**: Via API Pix v2.6.1: Envie JSON com chave Pix, valor, vencimento. Retorna QR Code dinâmico (EMV format). Obrigatório para boletos > R$ 200/2025.
+- **Vantagens**: Liquidação 24/7, conciliação automática.
+- **Payload EMV**: Inclui GUI "BR.GOV.BCB.PIX", chave, valor, etc. Calcule CRC16.
+
+Em Oracle 19c/APEX: Use APEX_BARCODE.GET_QRCODE_PNG para gerar QR de payload.
+
+```plsql
+v_blob := APEX_BARCODE.GET_QRCODE_PNG(p_content => v_payload_emv, p_size => 10);
+```
+
+Insira no PDF do boleto ao lado do código de barras.
+
+## Arquivo Remessa CNAB 240
+
+Padrão FEBRABAN v10.11 (2023, vigente 2025), com particularidades Bradesco (versão agosto/2022).
+
+### Estrutura
+
+- **Header Arquivo** (0): Banco 237, tipo 1 (remessa).
+- **Header Lote** (1): Serviço 01 (cobrança).
+- **Detalhe** (3): Segmentos P (título), Q (pagador), R (descontos), Y (Pix).
+- **Trailer Lote** (5).
+- **Trailer Arquivo** (9).
+
+Particularidades: Carteira 09 (registrada), Nosso Número 11 dígitos + DV. Para Pix, use "P1" em campo específico.
+
+Em Oracle 19c: Use UTL_FILE para escrever linhas de 240 chars.
+
+```plsql
+UTL_FILE.PUT_LINE(v_file, RPAD('0' || '000000123' || ..., 240, ' '));
+```
+
+Em APEX: Processo para gerar e download arquivo.
+
+## Arquivo Retorno CNAB 240
+
+Similar à remessa, tipo 2 (retorno). Segmentos T/U para liquidações (incluindo Pix).
+
+Códigos ocorrência: 06 (liquidação), com detalhes Pix se aplicável.
+
+Processamento em Oracle: Parse linhas com SUBSTR e atualize tabelas.
+
+## Fontes para Novas Versões
+
+- Site Bradesco: https://banco.bradesco/html/pessoajuridica/solucoes-integradas/outros/layout-de-arquivo.shtm (Layouts CNAB 240, versão agosto/2022, vigente 2025).
+- PDF Multipag Pix: https://wspf.banco.bradesco/wsValidadorUniversal/Content/Pdf/Multipag_Bradesco_PIX_240_posicoes.pdf (com particularidades Pix).
+- API Developers Bradesco: https://developers.bradesco/ (Manual API Pix v2.6.1 para QR Code).
+- FEBRABAN: https://portal.febraban.org.br/pagina/3053/33/pt-br/layout-240 (Padrão CNAB 240 v10.11, 31/07/2023).
+- Fórum ACBr: https://www.projetoacbr.com.br/forum/topic/86141-implementa%C3%A7%C3%A3o-da-consulta-espec%C3%ADfica-e-2-via-de-boleto-bradesco-com-qr-code-via-api-developers/ (Atualizações API 2025).
+
+Verifique o site Bradesco para atualizações pós-2025. Para testes, use ambiente de homologação via API.