...
| Deck of Cards |
|---|
|
| Card |
|---|
| id | passo1 |
|---|
| label | Configurar Credenciais |
|---|
| 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. | Aviso |
|---|
A configuração deve ser realizada para cada filial que for gerar Boletos Híbridos. |
|
| Card |
|---|
| id | passo2 |
|---|
| label | Carta de Cobrança |
|---|
| 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. | Aviso |
|---|
A configuração deve ser realizada para cada filial que for gerar Boletos Híbridos. |
|
| Card |
|---|
| id | passo3 |
|---|
| label | Configurar leiaute |
|---|
| 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 pela equipe técnica do ERPpelo 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 . 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 esta 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() ja já listada na 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) |
|
| Card |
|---|
| id | passo4 |
|---|
| label | Copiar leiaute |
|---|
| 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:
| Expandir |
|---|
|
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.
| Aviso |
|---|
| 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). |
|
| Expandir |
|---|
|
É 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)"
| Aviso |
|---|
| 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 um 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.
