Configuração de Contas

01. VISÃO GERAL

Essa tela apresenta o cadastro de Bancos do sistema (tabela SA6 - Bancos) e mostra o tipo de integração ativa para cada banco, conforme a legenda da coluna Integração.

Legenda	Descrição
	Banco sem configuração de leiaute - borderôs de cobrança que utilizam esse banco não permitem integração.
	Banco configurado para integração através do Boleto Híbrido Techfin.
	Banco configurado para integração direta com os bancos (não participa da integração do produto Boleto Híbrido Techfin). IMPORTANTE: Essa modalidade será descontinuada em 31/03/2026, conforme comunicado já publicado neste link.

Nessa tela temos as seguintes funcionalidades:

Configurar credencias de acesso à plataforma da Techfin;
Indicação da Carta de Cobrança a ser utilizada no envio do e-mail;
Configuração do leiaute para cada banco;
Cópia de leiaute existente para banco não configurado.

02. FUNCIONALIDADES

Configurações de comunicação entre ERP Protheus e a plataforma RaaS.
Aqui precisaremos informar os dados de acesso cadastrados no RaaS, previamente contratado com a equipe da TOTVS TECHFIN.

Após informar os dados de acesso e confirmar, o Protheus faz a validação de conexão junto a plataforma e exibe a mensagem de "sucesso" caso as informações estejam válidas. A partir de então o sistema ja está ativado para comunicação com a Techfin.

A configuração deve ser realizada para cada filial que for gerar Boletos Híbridos.

A configuração de Carta de Cobrança, para envio de e-mail, é necessário para que a transmissão de boletos envie as notificações cadastras.

Primeiramente será necessário criar a carta através do menu Atualizações → Cadastros → Cartas de Cobrança. Mais informações a respeito do cadastro na documentação da rotina aqui.

Na sequencia informar qual cadastro de Carta será considera no envio dos e-mails., conforme demonstrado abaixo.

A configuração deve ser realizada para cada filial que for gerar Boletos Híbridos.

Aqui é possível especificar a origem do dado para cada campo do leiaute. Pode-se utilizar de dados ja existentes no sistema, como também é possível (em alguns campos) criar regras específicas para compor determinado campo. Nesse caso a customização (código fonte com a regra de negócio que irá retornar o valor a ser enviado) é de responsabilidade de desenvolvimento pelo cliente.

A configuração do leiaute pode ser ajustada para um Banco que já possui integração ativa (legenda "Techfin") e para os demais bancos que ainda não possuem. Nesse último caso a configuração será realizada e o cadastro do banco terá o campo Cfg API Ativa (A6_CFGAPI) atualizado para 4=Techfin, indicando que está liberado para efetuar registro de cobranças através da Techfin.

Note que no exemplo acima, para o campo Abatimento, podemos utilizar a regra padrão do sistema (SomaAbat() já listada e sugerida em tela), como podemos especificar um valor fixo (R$ 10,00 conforme demostrado) ou especificar uma customização qualquer a ser processada em tempo de execução no momento da transmissão.

Informações

Sempre que uma expressão for aplicada em um campo de VALOR, é essencial incluir uma proteção de arredondamento para garantir que o valor seja sempre retornado com duas casas decimais.

Exemplo: round(SE1->E1_SALDO * 0.10, 2)

Essa opção permite replicar um leiaute ja existente para um outro banco, facilitando a configuração pois não exige digitação de todas as regras novamente.

03. CONFIGURAÇÃO DO LEIAUTE

Neste tópico iremos listar a regra de negocio dos campos que existem para configuração do leiaute de integração com a TECHFIN, sendo eles:

Abatimento

Neste campo poderá ou não ser informado um valor de abatimento para o boleto.

Onde poderá ser:

1. Vazio - Caso o valor original já esteja calculado com a dedução dos valores de abatimento ou não exista abatimento para o boleto.
2. Valor Abatimento (SomaAbat()) - Calculo padrão do sistema conforme a expressão: "SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)" .
3. Expressão definida pelo usuário.
  - O resultado da expressão será atribuído ao campo “Abatimento”. Para as macros-execuções a expressão a ser executada deverá ser válida. Para informar uma expressão clique na “Engrenagem” que está ao lado do campo.

Importante

Caso o valor original já esteja calculado com a dedução dos valores de abatimento, o campo "Abatimento" não deve ser preenchido para que não ocorra uma duplicidade no valor de abatimento.

Caso o campo "Abatimento" seja preenchido o campo "Valor Original" deverá conter o valor cheio (Sem a dedução do abatimento).

Valor original

É possível informar o valor original já deduzindo o valor do abatimento. Basta clicar na engrenagem no campo "Valor Original" e informar uma expressão válida:

Exemplo:

- "SE1->E1_SALDO - SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)"

Importante

Caso o valor original já esteja calculado com a dedução dos valores de abatimento, o campo "Abatimento" não deve ser preenchido para que não ocorra uma duplicidade no valor de abatimento.

Caso o campo "Abatimento" seja preenchido o campo "Valor Original" deverá conter o valor cheio (Sem a dedução do abatimento).

04. LEIAUTE TECHFIN x LEIAUTE BANCOS

Podemos observar que independente do banco que será utilizado, o leiaute da Techfin é único e sempre apresenta o mesmo formulário para configuração. Entretanto, cada banco possui regras especificas para determinado campo do leiaute, como por exemplo regras de aplicação de Juros após o vencimento (juros por dia, ao mês, percentual, valor, etc).

No momento do cadastro do leiaute, é importante observar a particularidade de cada banco sobre os campos que serão enviados, pois caso tenhamos uma configuração inválida devido à restrição de algum banco sobre o uso de determinada regra, teremos uma falha no momento de registrar a cobrança do boleto.

05. PARÂMETROS

MV_NGFCART - Código da carta de cobrança utilizado no envio dos boletos por e-mail.

Árvore de páginas