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 Itaú.
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 Itaú. O TOTVS Gestão Financeira disponibiliza dois modelos de registro:
- Permite registro de boleto online: Define se o convênio permite utilizar o registro de boleto online.
- Ambiente: Define o ambiente que será feito o registro do boleto no Banco.
- Modelo de Registro Online: Define o modelo do registro online: v1 ou v2.
- URL do serviço de registro de cobrança: Deve ser informada a URL do serviço de registro do boleto disponibilizada pelo banco.
- URL do sistema autorizador: Deve ser informado a URL do sistema autorizador que retornará o token de acesso ao serviço de registro de cobrança.
- Chave: Parâmetro de acesso ao serviço de registro de boleto fornecido pelo banco.
- Client Id: Código de acesso ao sistema autorizador fornecido pelo banco.
- Client Secret: Senha de acesso ao sistema autorizador fornecido pelo banco.
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 principal:
- tipo_carteira_titulo
- valor_cobrado
Campo da seção "juros":
Campo da seção "sacador avalista":
- sacador_avalista.cpf_cnpj_sacador_avalista
Campo da seção grupo de "desconto":
- grupo_desconto1.data_desconto
- grupo_desconto1.tipo_desconto
- Permite registro de boleto online: Define se o convênio permite utilizar o registro de boleto online.
- Ambiente: Define o ambiente que será feito o registro do boleto no Banco.
- Modelo de Registro Online: Define o modelo do registro online: v1 ou v2.
- URL do serviço de registro de cobrança: Deve ser informada a URL do serviço de registro do boleto disponibilizada pelo banco.
- URL do sistema autorizador: Deve ser informado a URL do sistema autorizador que retornará o token de acesso ao serviço de registro de cobrança.
- Client Id: Código de acesso ao sistema autorizador fornecido pelo banco.
- Client Secret: Senha de acesso ao sistema autorizador fornecido pelo banco.
- Certificado digital: Informe o certificado digital obtido pela empresa.
- Caminho do arquivo de chave privada: Informe o caminho onde se encontra o arquivo pertinente a chave privada. Caso o certificado digital for do tipo PKCS #12 (arquivo .pfx) que já contempla a chave privada, não será necessário informar esse caminho.
IMPORTANTE: Não é possível efetuar o cancelamento online do registro do boleto na mesma data que ocorreu o registro online. Nesse caso, o cancelamento deverá ser efetuado através do processo de cancelamento de remessa de boleto. Obs: Esta regra é do banco Itaú e não da aplicação.
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 principal:
- data.dado_boleto.codigo_carteira
- data.dado_boleto.valor_total_titulo
Campo da seção "juros":
- data.dado_boleto.juros.codigo_tipo_juros
Campo da seção "sacador avalista":
- data.dado_boleto.sacador_avalista.pessoa.nome_pessoa
- data.dado_boleto.sacador_avalista.pessoa.nome_fantasia
- data.dado_boleto.sacador_avalista.pessoa.tipo_pessoa.numero_cadastro_pessoa_fisica
- data.dado_boleto.sacador_avalista.pessoa.tipo_pessoa.numero_cadastro_nacional_pessoa_juridica
Campo da seção grupo de "desconto":
- data.dado_boleto.desconto.codigo_tipo_desconto
- data.dado_boleto.desconto.descontos1.quantidade_dias_desconto
- data.dado_boleto.desconto.descontos1.valor_desconto
- data.dado_boleto.desconto.descontos1.percentual_desconto
- data.dado_boleto.desconto.descontos2.quantidade_dias_desconto
- data.dado_boleto.desconto.descontos2.valor_desconto
- data.dado_boleto.desconto.descontos2.percentual_desconto
- data.dado_boleto.desconto.descontos3.quantidade_dias_desconto
- data.dado_boleto.desconto.descontos3.valor_desconto
- data.dado_boleto.desconto.descontos3.percentual_desconto
Campo da seção "beneficiário":
- data.beneficiario.id_beneficiario
Campo da seção "protesto":
- data.dado_boleto.protesto.protesto
- data.dado_boleto.protesto.codigo_tipo_protesto
- data.dado_boleto.protesto.quantidade_dias_protesto
Campo da seção "instrucao_cobranca" (permitido até 3 instruções de cobrança):
- data.dado_boleto.instrucao_cobranca1.codigo_instrucao_cobranca
- data.dado_boleto.instrucao_cobranca1.quantidade_dias_apos_vencimento
- data.dado_boleto.instrucao_cobranca1.dia_util
- data.dado_boleto.instrucao_cobranca2.codigo_instrucao_cobranca
- data.dado_boleto.instrucao_cobranca2.quantidade_dias_apos_vencimento
- data.dado_boleto.instrucao_cobranca2.dia_util
- data.dado_boleto.instrucao_cobranca3.codigo_instrucao_cobranca
- data.dado_boleto.instrucao_cobranca3.quantidade_dias_apos_vencimento
- data.dado_boleto.instrucao_cobranca3.dia_util
Campo da seção "dados_individuais_boleto":
- data.dado_boleto.dados_individuais_boleto.data_vencimento
- data.dado_boleto.dados_individuais_boleto.valor_titulo
- data.dado_boleto.dados_individuais_boleto.texto_uso_beneficiario
- data.dado_boleto.dados_individuais_boleto.texto_seu_numero
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 Itaú deve ser realizado de acordo com o manual de cobrança online do banco. Ressaltamos que o layout da v1 é totalmente diferente da v2, então o cadastro de layout de registro online deve ser refeito na migração da v1 para v2. Demonstramos alguns exemplos de campos nas guias referente a cada modelo de registro online (item 2).
IMPORTANTE:
- De acordo com o layout do banco pode ocorrer 5 (cinco) descontos, portanto o nome do campo deverá ser 'grupo_desconto1.', 'grupo_desconto2.' sucessivamente de acordo com número de vezes que ocorre. Seguir a mesma regra para o grupo de rateio e grupo de e-mail do pagador.
- O campo Data da Multa será calculado a partir da Data de Vencimento do boleto acrescido do parâmetro Dias de Atraso configurado na etapa Valor Líquido do Lançamento Financeiro.
Tempo aproximado para leitura: 5 minutos