Versão inicial: 1.0.0

Identifiação: “237“, “Bradesco” ou “BRA“

Parâmetros obrigatórios

• AGENCIA_NUMERO – (Letras ou Inteiro) Agência com quatro dígitos, sem do digíto verificador (DV);
• AGENCIA_DV – (Letras ou Inteiro) Dígito verificador da agência com uma única posição ;
• CARTEIRA – (Letras ou Inteiro) Dois dígitos indicando a cartera: 06, 09, 16, 19, …;
• CONTA_CORRENTE_NUMERO – (Letras ou Inteiro) Conta corrente com sete dígitos sem o DV;
• CONTA_CORRENTE_DV – Somente o dígito verificador da conta corrente com 1 caracter (Letras ou Inteiro);
• NOSSO_NUMERO – (Letras) Número sequencial único com 11 posições que identifica a cobrança no banco e no seu sistema, este será o código compartilhado e será retornado pelo banco nos arquivos de retorno, assim como no extrato da conta;
• DATA_VENCIMENTO – (Data) Data de vencimento do boleto;
• VALOR_BOLETO (Número) – Valor nominal do boleto.

---

Registro de boleto on-line (WebService)

O envio é feito conforme o “MANUAL TÉCNICO E LAYOUT REGISTRO ON-LINE DE BOLETOS DE COBRANÇA BRADESCO”, versão 2.0 de 03/2018. Não tem PIX integrado.

• CERTIFICADO (Letras): Caminho completo do certificado (A1), usado na assinatura e envio das mensagens.
• SENHA (letras): Senha do certificado.

OBS: Esta rotina não dá suporte a emissão de PIX vinculado.

---

Registro de boleto + PIX (híbrido) (WebService)

IMPORTANTE: Esta funcionalidade é EXPERIMENTAL, sem suporte ou garantia de continuidade. Última revisão: 29/Jan/2025.

O Bradesco permite a emissão do PIX vinculado a um boleto, conforme manual do Bradesco intitulado “MANUAL E LAYOUT API DE COBRANÇA com QR CODE Outubro/2024 Versão 4.1“. Para isso, você deve usar os seguintes parâmetros na função de inicialização “Boleto – WebService – Inicializar“:

• “HIBRIDO” (Lógico): Deve ser passado verdadeiro (true) indicando que o boleto será híbrido (com PIX);
• “client_id” (Letras): Também chamado pelo Bradesco de “Client Key”, é um UUID fornecido pelo banco (EX: “00000000-1111-2222-3333-4444444444444”).
• “CER” (Letras): Certificado em formato PEM, pode ser o caminho absoluto (EX: “C:\temp\certificado.per”), ou o conteúdo do arquivo (EX: “—–BEGIN CERTIFICATE—–…” );
• “KEY” (Letra): Chave privada do certificado em formato PEM, pode ser passado o caminho ou conteúdo.

O certificado e chave fornecida (CER e KEY) devem ser os mesmo cadastrados no banco.

Na função de geração do boleto (“Boleto – WebService – Incluir Boleto“) observar os campo obrigatórios, em especial:

• CARTEIRA
• AGENCIA_NUMERO
• DOCUMENTO_ESPECIE
• DOCUMENTO_NUMERO
• CONVENIO_NUMERO
• CONTA_CORRENTE_NUMERO

Observações e Restrições

1. Esta API não disponibiliza consulta e/ou baixa de boletos.
2. A API fornecida é pobre em relação a mensagens de erro, retornando mensagens genéricas, infelizmente não temos como dar suporte aos erros de forma detalhada. Favor encaminhar diretamente ao suporte do Bradesco (responsável pela API).

---

Geração da Remessa via Arquivo

Utilize a função “Boleto – Criar Arquivo de Remessa CNAB” passando os seguintes parâmetros:

• BENEFICIARIO_NOME – Nome da empresa;
• BENEFICIARIO_DOCUMENTO – CNPJ da empresa;
• AGENCIA_NUMERO;
• AGENCIA_DV;
• CONTA_CORRENTE_DV;
• BENEFICIARIO_CODIGO – (027 a 046) Código da Empresa;
• ARQUIVO_DATA_GERACAO;
• ARQUIVO_NUM_SEQUENCIAL – (111 a 117) Nº Seqüencial de Remessa

No envio dos itens (boletos) devem ser observados os seguintes campos (além dos obrigatórios na impressão do boleto):

• DOCUMENTO_ESPECIE – Uma dos seguintes códigos com dois digitos:
  • 01-Duplicata
  • 02-Nota Promissória
  • 03-Nota de Seguro
  • 04-Cobrança Seriada
  • 05-Recibo
  • 10-Letras de Câmbio
  • 11-Nota de Débito
  • 12-Duplicata de Serv.
  • 99-Outros.
• DESCONTO_DATA_LIMITE – Data limite para concessão de desconto;
• INSTRUCAO_COBRANCA1 e INSTRUCAO_COBRANCA2 – Com os códigos de instrução de cobrança (pode ser 0 / Zero).