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ça: Deve 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ça: Deve 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 boletos. O 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"







