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 banco Banestes.

    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"

    • Sem rótulos