Histórico da Página
Registro Boleto Online Itaú
Características do Requisito
Linha de Produto: | RM |
Segmento: | Construção & Projetos |
Módulo: | TOTVS Gestão Financeira |
Requisito/Story/Issue: | FINANCEIRO01-24 |
Descrição
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ú.
Procedimento para Configuração
No TOTVS Gestão Financeira, menu Movimentações Bancárias | Controle Bancário | Convênio, devem ser feitas as configurações do convênio para o registro de boleto online:
- 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 bancoBanco.
- Modelo de Registro Online: Define o modelo do registro online: v1 ou v2. Caso o certificado digital No modelo v2 o ambiente de teste não irá salvar Código de barras e IPTE, pois é apenas um ambiente para validação.
- URL do serviço de registro do boleto: Deve ser informada a URL do serviço de registro do boleto disponibilizada pelo bancoBanco.
- 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.Banco (campo disponível somente no modelo "v1")
- Client Id: Código de acesso ao sistema autorizador fornecido pelo bancoBanco.
- Client Secret: Senha de acesso ao sistema autorizador fornecido pelo bancoBanco.
- Certificado digital: Informe o certificado digital obtido pela empresa (campo disponível somente no modelo "v2")
- Caminho do arquivo de chave privada: Informe o caminho onde se encontra o arquivo pertinente a chave privada (campo disponível somente no modelo "v2"). 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.
Atenção:
- Deve ser informado o CNPJ do beneficiário/cedente na
- página Dados Adicionais.
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 feita de acordo com o manual de cobrança online do banco, da seguinte maneira:
Obs.: O Layout da v1 é totalmente diferente da v2, então o cadastro de layout de registro on-line deve ser refeito na migração da v1 para v2. Veja abaixo alguns exemplos:
Exemplos para os campos da seção principal:
- v1
- tipo_carteira_titulo
- valor_cobrado
- v2
- data.dado_boleto.codigo_carteira
- data.dado_boleto.valor_total_titulo
Exemplo para os campos da seção "juros":
- v1
- juros.tipo_juros
- v2
- data.dado_boleto.juros.codigo_tipo_juros
Exemplos para os campos da seção "sacador avalista":
- v1
- sacador_avalista.cpf_cnpj_sacador_avalista
- v2
- 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
Exemplos para os campos da seção grupo de "desconto":
- v1
- grupo_desconto1.data_desconto
- grupo_desconto1.tipo_desconto
- v2
- 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
Exemplo para os campos da seção "beneficiário":
- v2
- data.beneficiario.id_beneficiario
Exemplos para os campos da seção "protesto":
- v2
- data.dado_boleto.protesto.protesto
- data.dado_boleto.protesto.codigo_tipo_protesto
- data.dado_boleto.protesto.quantidade_dias_protesto
Exemplos para os campos da seção "instrucao_cobranca"
- v2 - Permitido até 3 instrução 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_cobranca1.dia_util
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.
- Ao utilizar o modelo 'v2' do registro online, não será 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.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas