01. VISÃO GERAL
Configurações necessárias para o registro de boletos online do banco Bradesco.
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.
Rede 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:
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.
Importante
É 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:
- Número do Título (E1_NUM)
- ID CNAB (E1_IDCNAB)
- 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:
Atençã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:
- Vazio - Caso o valor nominal já esteja calculado com a dedução dos valores de abatimento ou não exista abatimento para o boleto.
- 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)" .
- 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)"
Importante
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:
- DISPENSAR - Não envia protesto para a transmissão, sendo este o valor padrão.
- DIAS CORRIDOS PARA PROTESTO - Envia para transmissão protesto utilizando o campo Qtde. Dias Protesto como dias corridos após a data do vencimento
- 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:
- Vazio - Será enviado para a transmissão quantidade de dias com o valor 0.
- EE_DIASPRT - Será utilizado no envio o valor do campo EE_DIASPRT da subconta utilizada no borderô, sendo este o valor padrão.
- 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.
Atençã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.
- 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).
- Gerar pelo banco - O sequencial será gerado pelo banco.
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.
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
Importante
- 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.