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 , 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.
Sempre que umaexpressãofor aplicada em um campo deVALOR, é 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:
Neste campo poderá ou não ser informado um valor de abatimento para o boleto.
Onde poderá ser:
Vazio -Caso o valor original já esteja calculado com a dedução dos valores de abatimento ou não exista abatimento para o boleto.
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)" .
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.
Caso o valor original já esteja calculado com a dedução dos valores de abatimento,o campo"Abatimento" não deve ser preenchidopara que não ocorra umaduplicidadeno valor de abatimento.
Caso o campo "Abatimento" seja preenchido o campo "Valor Original" deverá conter o valor cheio (Sem a dedução do abatimento).
É 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:
Caso o valor original já esteja calculado com a dedução dos valores de abatimento,o campo"Abatimento" não deve ser preenchidopara que não ocorra umaduplicidadeno 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.
