Conteúdo:

      1. Registro online

Esta implementação tem como objetivo preparar o TOTVS Gestão Financeira para utilizar o serviço de registro online de cobrança registrada do banco Banestes (via webservice).

Disponível no release 12.1.2406 ou superior (recomendamos utilizar sempre o último patch).

Baixe aqui o manual do banco Banestes.

      2. Procedimento para configuração

Através do cadastro do Convênio, localizado no menu 'Movimentações Bancárias', é necessário habilitar a opção "Permite registro de boleto online" e definir os parâmetros de acordo com os dados fornecidos pelo banco Banestes.


  • Permite registro de boleto online: Define se o convênio permite utilizar o registro de boleto online.
  • Integração com os serviços da AutBank: Define que o banco utiliza o padrão da AutBank para o registro online de boletos.
  • Ambiente: Define o ambiente que será feito o registro do boleto no banco.
  • URL do serviço de registro de cobrançaDeve ser informada a URL do serviço de registro do boleto disponibilizada pelo banco. (https://api.banestes.b.br/cobranca/v2/MetodosWebServerImp)
  • URL de homologação do serviço de registro de cobrançaDeve ser informada a URL de homologação do serviço de registro do boleto disponibilizada pelo banco. (https://sandbox.banestes.b.br/cobranca/v2/MetodosWebServerImp)
  • Usuário: Usuário fornecido pelo banco para autenticar a integração.
  • Senha: Senha fornecida pelo banco para autenticar a integração.

Conforme detalhado no item 3 deste documento, é possível enviar os dados de forma flexível para o banco ao registrar online os boletosO cadastro do layout do registro online do Banestes deve ser feito conforme o manual de cobrança online do banco, onde contempla a descrição de cada campo. Exemplos:

  • titulo.CONTA_CORRENTE
  • titulo.IDENTIFICADOR_RESPONSAVEL_EMITIR_BOLETO
  • titulo.IDENTIFICADOR_RESPONSAVEL_DISTRIBUIR_BOLETO
  • titulo.PERCENTUAL_MORA_ATRASO
  • titulo.PERCENTUAL_MULTA_ATRAS
  • titulo.inscricaoPagador.NOME
  • titulo.inscricaoSacadorAvalista.BAIRRO
  • titulo.inscricaoSacadorAvalista.CEP
  • titulo.PARCELAS_ENTRADA.VALOR_TITULO
  • titulo.PERCENTUAL_MORA_ATRASO
  • titulo.PERCENTUAL_MULTA_ATRASO
  • titulo.DATA_LIMITE_PAGAMENTO
  • titulo.PARCELAS_ENTRADA.VALOR_DESCONTO
  • titulo.PARCELAS_ENTRADA.DATA_DESCONTO

      3. Customização de dados no registro online


Pode ser utilizado o Cadastro de Layout do Registro Online, para enviar dados de forma flexível para o registro online dos boletos para o banco. Para isso deve ser feito o Cadastro de associação de fórmulas e campos do registro online de acordo com o manual de cobrança online do Banrisul.

IMPORTANTE:

Por padrão, o campo responsável por indicar o responsável por emitir o Boleto é 2 (Cliente). Caso o responsável seja o banco, é necessário enviar no campo "titulo.IDENTIFICADOR_RESPONSAVEL_EMITIR_BOLETO" via associação de layout o valor 1, no qual representa o banco conforme o manual do banco.




Por padrão, o campo responsável por indicar o responsável por distribuir o Boleto é 2 (Cliente). Caso o responsável seja o banco, é necessário enviar no campo "titulo.IDENTIFICADOR_RESPONSAVEL_DISTRIBUIR_BOLETO" via associação de layout o valor 1, no qual representa o banco conforme o manual do banco.


O banco espera como juros um percentual mensal, como o TOTVS Gestão financeira trabalha com juro valor fixo ou percentual diário, o que será enviado para o banco será o percentual de juros ao dia do boleto vezes trinta.  Caso queira enviar um valor diferente é possível utilizando a campo da associação de layout "titulo.PERCENTUAL_MORA_ATRASO". O formato deve ser 2 casas e 2 decimais separado por ponto. Ex: 1.00


O banco espera como multa um percentual fixo, como o TOTVS Gestão financeira trabalha com multa valor fixo ou percentual diário, o que será enviado para o banco será o percentual de multa ao dia do boleto vezes trinta.  Caso queira enviar um valor diferente é possível utilizando a campo da associação de layout "titulo.PERCENTUAL_MULTA_ATRASO". O formato deve ser 2 casas e 2 decimais separado por ponto. Ex: 2.00



O sacador/avalista não é obrigatório ser enviado, caso queira enviar é necessário cadastrar os campos abaixo na associação de layout registro online.

    • titulo.inscricaoSacadorAvalista.TIPO_INSCRICAO 
    • titulo.inscricaoSacadorAvalista.NUMERO_INSCRICAO
    • titulo.inscricaoSacadorAvalista.NOME
    • titulo.inscricaoSacadorAvalista.LOGRADOURO
    • titulo.inscricaoSacadorAvalista.BAIRRO
    • titulo.inscricaoSacadorAvalista.CIDADE
    • titulo.inscricaoSacadorAvalista.UF
    • titulo.inscricaoSacadorAvalista.CEP


A data do desconto por padrão é a data de vencimento, caso queira definir um outra data, é necessário cadastrar o campo "titulo.PARCELAS_ENTRADA.DATA_DESCONTO" e definir uma data no formato "yyyy-mm-dd"



Caso queira definir uma data limite de pagamento do boleto, será necessário cadastra o campo "titulo.DATA_LIMITE_PAGAMENTO" e definir uma data no formato "yyyy-mm-dd"