Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice
minLevel0

01. VISÃO GERAL

Configurações necessárias para o registro de boletos online do banco Bradesco. Existem dois serviços de comunicação com o banco Bradesco, abaixo iremos destacar algumas características de cada serviço e como utilizar:


Totvs custom tabs box
tabsCobrança via WS, Cobrança via API
ids01,02
Totvs custom tabs box items
defaultyes
referencia01

Para a utilização é necessário solicitar a ativação do serviço de registro de boletos por webservice em seu contrato junto ao banco. Vale ressaltar que essa versão não tem algumas funcionalidades, como por exemplo, registro de boleto hibrido (Boleto com QR Code PIX), alteração e cancelamento dos boletos, sendo assim aconselhamos os clientes que possuem essa configuração ativa, migrarem para o serviço Cobrança por API (Serviço ainda em desenvolvimento, no momento não esta disponível para uso)

Informações
titleRede interna

Para a comunicação do Protheus com o banco é necessário configurar a segurança de rede, caso necessário, para aceitar a saída da faixa de IP referente ao DNS: 

https://cobranca.bradesconetempresa.b.br/

Totvs custom tabs box items
defaultno
referencia02

Para utilização é necessário solicitar ao gerente da conta, para que sejam habilitados os seguintes serviços:

  • 175 - Registro via Webservice
  • 182 - Cobrança com QR Code

Esse novo mecanismo de comunicação com o Bradesco, possui algumas funcionalidades que a Cobrança por WS não possuía, como por exemplo, alteração e cancelamento de boletos, transmissão do boleto hibrido (Boleto com QR Code PIX), sendo assim, novas implementações só serão feitas nesse novo formato de comunicação. 

Aviso
titleFuncionalidade em desenvolvimento

O serviço Cobrança por API está em fase de desenvolvimento e em breve entrará em testes com clientes piloto, portanto ainda não está liberada em nenhum release do Protheus!

Será liberado através de pacote de expedição acumulado do módulo financeiro em data ainda a ser informada.

Essa página poderá sofrer alterações até a data de liberação da funcionalidade!

Informações
titleRede interna

Para a comunicação do Protheus com o banco é necessário configurar a segurança de rede, caso necessário, para aceitar a saída da faixa de IP referente ao DNS: 

https://openapi.bradesco.com.br

https://proxy.api.prebanco.com.br


02. CERTIFICADO DIGITAL

Para promover a integração sistêmica de registro on-line de Boletos de Cobrança Bradesco, é necessário possuir Certificado Digital ICP Brasil do tipo A1.

Importar pela rotina CFGX060 - Documento de referencia: https://tdn.totvs.com/x/viabEg.

A validação do certificado digital pelo (NGF) Novo Gestor Financeiro, se dará pela confirmação dos arquivos "CERT" e "KEY" que deverão estar gravados no caminho \CERT\NGF\{nome do arquivo}.

O nome dos arquivos deve ser composto por:

"nome do certificado".pem;
"nome do arquivo chave do certificado".pem.

Obs.: Caso os nomes dos arquivos sejam iguais o usuário pode usar os texto "_key" e "_cert" para diferencia-los.

A estrutura das pastas deverão ser criados abaixo do caminho informado no RootPath do arquivo server INI.


03. DADOS UTILIZADOS NO LAYOUT

  • Para habilitar a configuração de um layout para o Banco Bradesco deve ser informado no campo A6_BCOOFI  ( Banco oficial )  o código do Bradesco 237.
  • Em seu layout, a agência possui 4 posições (sem digito) e a conta 7 posições (sem digito).  Caso o cadastro no sistema (SA6) esteja incorreto, será necessário o ajuste.


    Informações
    titleImportante

    É necessário o cadastro correto do dígito verificador da conta no campo Dv Conta (A6_DVCTA).

    Caso o cadastro esteja incorreto na tabela de bancos (SA6), o ajuste deve ser realizado em sua subconta no Cadastro Parâmetros de bancos (tabela SEE) nos campos Age. Oficial (EE_AGEOFI), Cta. Oficial (EE_CTAOFI) e DV Cta.Ofic. (EE_DVCTOFI).

    Exemplo de conta que precisa ser adequada : Conta 12345-6

    No cadastro do banco, campo Nro Conta (A6_NUMCOM) = 123456 e DV Conta (A6_DVCTA) = vazio, o ajuste em sua sub conta deve ser Cta. Oficial (EE_CTAOFI) = 12345 e DV Cta.Ofic. (EE_DVCTOFI) = 6

  • O código da carteira/ modalidade de cobrança é configurado na subconta (tabela SEE) pela rotina Parâmetros de Banco (FINA130) no campo Cód. Carteira (EE_CODCART).
  • Se o nosso número for gerado pelo sistema, esse deve ser configurado na subconta (tabela SEE) pela rotina Parâmetros de Banco (FINA130) nos campos Faixa Inicio (EE_FAXINI) , Faixa Fim (EE_FAXFIM) e Faixa atual (EE_FAXATU).
  • O endereço do cliente deve ter o número separa por vírgula para que seja encaminhado corretamente ao sistema do banco.
  • O layout do banco não permite o envio de Instruções de Cobrança, configuradas em Parâmetros de Banco, Aba Outros, Mensagem 1, Mensagem 2.

04. CONFIGURAÇÃO DO LAYOUT

Para a utilizar o registro online de boletos para o Bradesco, deve-se observar a seguinte regra:

  • Porcentagem Juros Mensal: Neste campo, deve ser informado o valor mensal de juros.

     Como padrão, disponibilizamos o campo E1_PORCJUR já multiplicado por 30, respeitando a seguinte regra: juros diário X 30 dias = juros mensal

  • Qtde dias multa: Neste campo, deve ser informado a quantidade de dias após o vencimento na qual a multa será cobrada. Se este campo não for informado, caso seja configurado multa por valor ou multa por percentual, por padrão o sistema utilizará um dia após o vencimento.

    Somente serão permitidos valores maiores ou igual a um e valores menores ou igual a 999: qtdeDiasMulta >= 1 e qtdeDiasMulta <= 999


  • Número do documento: Neste campo deverá ser informado qual será o número do documento que será transmitido ao banco e posteriormente impresso no boleto.

      Onde poderá ser:

    1. Número do Título (E1_NUM)
    2. ID CNAB (E1_IDCNAB)
    3. Expressão definida pelo usuário.
      • O resultado da expressão será atribuído ao campo “Número do documento”. Para as macros-execuções a expressão a ser executada deverá ser válida. Para informar uma expressão clique na “Engrenagem” que está ao lado do campo.



  • Aceite: Este campo indica o reconhecimento formal da divida (assinatura no documento) pelo pagador, deverá ser informado os valores:
    • Sim - Quando existe a necessidade do pagador reconhecer/aceitar a cobrança.
    • Não - Quando não existe a necessidade de reconhecimento da cobrança.

  • Beneficiário Filial: Neste campo deverá ser informado qual filial que será utilizada para a transmissão e impressão do boleto. 

Os dados cadastrados nessa filial serão utilizados na transmissão e na impressão:


Aviso
titleAtenção

Caso este campo não esteja preenchido a Filial Atual (Filial Logado ou Filial configurada no agendamento) será utilizada no dados da transmissão e impressão do boleto.


  • Valor Abatimento: Neste campo poderá ou não ser informado um valor de abatimento para o boleto.  

       Onde poderá ser:

    1. Vazio - Caso o valor nominal já esteja calculado com a dedução dos valores de abatimento ou não exista abatimento para o boleto.
    2. Valor Abatimento (SomaAbat()) - Calculo padrão do sistema conforme a expressão: "SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)" .
    3. Expressão definida pelo usuário.
      • O resultado da expressão será atribuído ao campo “Valor Abatimento”. Para as macros-execuções a expressão a ser executada deverá ser válida. Para informar uma expressão clique na “Engrenagem” que está ao lado do campo.


É possível informar o valor nominal já deduzindo o valor do abatimento. Basta clicar na engrenagem no campo "Valor Nominal" e informar uma expressão válida:

Exemplo:

    • "SE1->E1_SALDO - SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)"


Aviso
titleImportante

Caso o valor nominal já esteja calculado com a dedução dos valores de abatimento, o campo "Valor Abatimento" não deve ser preenchido para que não ocorra uma duplicidade no valor de abatimento.

Caso o campo "Valor Abatimento" seja preenchido o campo "Valor Nominal" deverá conter o valor cheio (Sem a dedução do abatimento). Caso exista abatimento será exibida uma mensagem no corpo do boleto informando o valor do abatimento já calculado.



  • Tipo Protesto: Neste campo deverá ser informado qual forma de protesto será enviado na transmissão e posteriormente impresso no boleto.

Os quais poderão ser:

    1. DISPENSAR - Não envia protesto para a transmissão, sendo este o valor padrão.
    2. DIAS CORRIDOS PARA PROTESTO - Envia para transmissão protesto utilizando o campo Qtde. Dias Protesto como dias corridos após a data do vencimento
    3. DIAS ÚTEIS PARA PROTESTO - Envia para transmissão protesto utilizando o campo Qtde. Dias Protesto como dias úteis após a data do vencimento

  • Qtd. Dias Protesto: Neste campo deverá ser informado a quantidade de dias do protesto após o vencimento que será enviado na transmissão e posteriormente impresso no boleto.

Quais valores são permitidos:

    1. Vazio - Será enviado para a transmissão quantidade de dias com o valor 0.
    2. EE_DIASPRT - Será utilizado no envio o valor do campo EE_DIASPRT da subconta utilizada no borderô, sendo este o valor padrão.
    3. Expressão definida pelo usuário. - O resultado da expressão será atribuído ao campo “Qtd. Dias Protesto”. Para as macros-execuções a expressão a ser executada deverá ser válida. Para informar uma expressão clique na “Engrenagem” que está ao lado do campo.

Aviso
titleAtenção ao Protesto

O Banco Bradesco permite apenas protesto com quantidade de dias no mínimo de 5 dias. Se enviado um valor menor que 5 dias será retornada a mensagem "Prazo para protesto inválido" ou "Dias para instrução de protesto inválido".


  • Nosso Número: Número sequencial de 11 posições usado para identificação do título no banco.
    1. Gerar pelo sistema - Será gerado um sequencial de 11 posições baseado no campo EE_FAXATU (O valor do campo EE_FAXATU deve ser correspondente a um sequencial de 11 caracteres, caso o tamanho do campo seja maior, utilizar zeros a esquerda).
    2. Gerar pelo banco -O sequencial será gerado pelo banco.

  • Boleto Híbrido (Boleto + PIX): Define se irá utilizar QR Code PIX para pagamento no boleto (boleto híbrido disponível apenas para Cobrança por API).


05. PROBLEMAS COMUNS

  • ERRO DE CONSISTENCIA: DADOS INCONSISTENTES - 0840 (6)
    • Essa mensagem pode estar retornando quando o serviço não está ativo no contrato. Para confirmação envie um e-mail no canal de suporte do Bradesco [email protected] informando o retorno "ERRO DE CONSISTENCIA: DADOS INCONSISTENTES - 0840 (6)" e solicite para verificar se o serviço de registro de boletos por webservice está ativo em seu contrato. Será necessário informar seu CNPJ, número de agência e número da conta. 
  • NEGOCIAÇÃO INEXISTENTE
    • Caso o banco retorne essa mensagem no momento da transmissão do boleto, significa que algumas informações podem estar incorretas, sendo elas:
      • Agencia - Verificar o código da agencia informado no cadastro de bancos (A6_AGENCIA) ou parâmetros de banco (EE_AGEOFI) Veja o tópico 3
      • Conta - Verificar o código da conta informado no cadastro de bancos (A6_NUMCON) ou parâmetros de banco (EE_CTAOFI) Veja o tópico 3
      • Carteira - Verifique a carteira informada no parâmetros de banco (EE_CODCART)
    • Se todas as informações estiverem corretas, recomendamos entrar em contato com o banco.


06. CONFIGURAÇÃO DE BOLETO

Permite que o usuário configure como será a impressão do boleto.

  • Imprime abatimento
    • Como mensagem - O valor do abatimento será impresso nas mensagens do boleto
    • Campo desconto/abatimento - O valor do abatimento no titulo será impresso no (-) Desconto/Abatimento do boleto

Aviso
titleImportante
  • Não é possível utilizar as opções "Como mensagem" e "Campo desconto/abatimento" em conjunto. 
  • Após a transmissão do boleto as alterações realizadas no campo Imprime abatimento não serão aplicadas aos boletos já transmitidos. As alterações serão aplicadas somente aos boletos transmitidos após a alteração.