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 da carteira de cobrança registrada do Banco Santander.

      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 Santander. Obs: A partir dos patchs 12.1.2410.222 e 12.1.2502.138 o sistema dispõe do modelo 'v2' do registro online.


  • Ambiente: Define o ambiente que será feito o registro do boleto no banco.
  • URL do serviço de registro do boletoDeve ser informada a URL do serviço de registro do boleto disponibilizada pelo banco. Para o banco Santander é a URL do serviço de cobrança. (https://ymbcash.santander.com.br/ymbsrv/CobrancaV3EndpointService)
  • URL do serviço do ticket de segurançaDeve ser informada a URL do serviço do ticket de segurança disponibilizado pelo banco.  (https://ymbdlb.santander.com.br/dl-ticket-services/TicketEndpointService)
  • Cód. Estação: Deve ser informado o código da estação do convênio gerada pelo banco.
  • Certificado digital: Deve ser informado o certificado digital que foi cadastrado junto ao banco. 

ImportanteConforme manual disponibilizado pelo banco, o cliente deverá adquirir um certificado digital junto a uma empresa certificadora, e efetuar o cadastramento no ambiente de segurança do banco enviando o arquivo no formato ".CER" referente ao certificado adquirido. Requisitos: Certificado tipo Client de 2048 bits.


Conforme detalhado no item 3 deste documento, é possível customizar o dado a ser enviado no registro online. Abaixo, seguem alguns exemplos de cadastro de campo no layout do registro online:

Campo da seção "documentKind": Deve ser obrigatoriamente informado com o tipo de espécie do documento, conforme uma das opções válidas indicadas pelo manual do banco:


Exemplo de preenchimento do campo do layout do registro online na associação do layout nos anexos do cadastro do convênio:

Outras opções que podem ser usadas no valor fixo:

  • DUPLICATA_MERCANTIL
  • DUPLICATA_SERVICO
  • NOTA_PROMISSORIA
  • NOTA_PROMISSORIA_RURAL
  • RECIBO
  • APOLICE_SEGURO
  • BOLETO_CARTAO_CREDITO
  • BOLETO_PROPOSTA
  • BOLETO_DEPOSITO_APORTE
  • CHEQUE
  • OUTROS

Campo da seção "payer":

  • dados.payer.name
  • dados.payer.city

Campo da seção "beneficiary":

  • dados.beneficiary.name
  • dados.beneficiary.documentType
  • dados.beneficiary.documentNumber

Campo da seção "discount":

  • dados.discount.type
  • dados.discount.discountOne.limitDate
  • dados.discount.discountOne.value

Campo da seção "sharing":

  • dados.sharing.code
  • dados.sharing.value


IMPORTANTE:

  • De acordo com o layout do banco podem ocorrer 3 (três) descontos, portanto o nome do campo deverá ser 'discount/discountOne.', 'discount/discountTwo.' e 'discount.discountThree.'.
  • Os campos de desconto "limitDate" e "value" são pares, se um deles for informado, obrigatoriamente o outro também deve ser (regra do banco).

      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 no cadastro do convênio.

O cadastro do layout do registro online do Santander deve ser realizado de acordo com o manual de cobrança online do banco. Demonstramos alguns exemplos de campos na guia referente ao modelo de registro online 'v2' (item 2).