Histórico da Página

Protheus - Guia Cloud TOTVS - TDN

Índice

01. VISÃO GERAL

Enquanto as Fintechs são empresas do mercado financeiro que utilizam tecnologia para oferecer serviços convencionais, a Techfin vai além: trata-se de uma empresa de tecnologia e dados, que oferece serviços financeiros personalizados e mais competitivos para ajudar as empresas a superar os desafios dos seus negócios.

A TOTVS Techfin chega ao mercado com o objetivo de revolucionar as soluções de crédito, pagamentos e serviços, usando para isso o poder da tecnologia, nessa pagina será possível avaliar as configurações necessárias para as integrações da Techfin com o Protheus.

02. PRODUTOS

INDICADORES TECHFIN

Para iniciar o Wizard de configuração, o usuario deverá digitar WizardTF1 na tela inicial

Image Removed

Clicar em OK

Image Removed

Verificar se os requisitos iniciais estão atendidos e Clicar em Avançar

Image Removed

Digitar um usuario com poder de Administrador sua senha, e escolher as empresas que serão configuradas e clicar em Avançar

Image Removed

Escolha o Produto a ser configurado, no caso, será o TOTVS Mais Prazo ou TOTVS Antecipa e Clicar em Avançar

Image Removed

Aceitar a verificação do compartilhamento dos parâmetros

Image Removed

Digitar o ClientID e a Client Secret, enviadas pela Techfin

Preencher os parametros de acordo com o solicitado

Image Removed

Deck of Cards

id	Cenario
effectType	fade

Deck of Cards

id	Cenario
effectType	fade

Card

id	1
label	Wizard de Configuração
effectType	fade

Card

id	1
label	TOTVS Antecipa
effectType	fade

Para maiores informações sobre a integração do TOTVS Antecipa, consulte o link a seguir:

Integração Protheus x TOTVS Antecipa

Card

id	1
label	TOTVS Painel Financeiro
effectType	fade

Para maiores informações sobre a integração do TOTVS Painel Financeiro, consulte o link a seguir:

Integração Protheus x TOTVS Painel Financeiro

Card

label	TOTVS Mais Prazo

Expandir

title	Implantação

Para iniciar a implementação do TOTVS Mais Prazo será necessário:

1) Aplicar a última expedição continua do Protheus, juntamente com o diferencial de dicionário através do UPDDISTR, de acordo com a sua versão da Release.

2) Efetuar os cadastros dos seguintes Itens:

Fornecedor Supplier;
Natureza Financeira;
Motivo de Baixa que não movimenta banco e carteira pagar (P)

3) Executar o wizard de acordo com os passos conforme a aba Wizard de Configuração

Expandir

title	Operação

A operação consiste em agendar a execução pelo FINA137F, que é o JOB responsável por requisitar as movimentações junto a TechFin e executá-las no Protheus.

Fluxo das operações:

1) O JOB FINA137F com agendamento e periodicidade de 1 em 1 hora, fará uma requisição junto ao TechFin para receber a mensagem, contendo as movimentações a serem executadas no Protheus. O cliente poderá ajustar sua periodicidade, no entanto, recomendamos nunca aumentar demasiadamente esse intervalo, afim de manter o portal da Techfin, o mais sincronizado possível com o Protheus

2) Após a movimentação feita no Protheus, o sistema enviará a Techfin que as operações foram realizadas no Protheus. Mantendo assim o Protheus e o Portal Techfin, sincronizados.

3) Os títulos que poderão ser negociados são os que possuem código de barras cadastrados.

Expandir

title	Baixa de Titulos

A Baixa dos Titulos será realizada com o motivo de baixa configurada no Wizard, lembrando que o Motivo de Baixa, não movimenta banco, por essa razão essa baixa não será exibida no extrato bancário. Seu historico será enviado pela Plataforma.

Image Removed

Essa baixa não movimentará banco, observe que o motivo de baixa é TEC, a mesma escolhida no wizard cadastrada previamente, com a opção Movimenta Banco = "N", o Historico "BOLETO PAGO" é enviado pela Techfin, a data de baixa é a data de processamento.

Expandir

title	Inclusões de Novos Titulos

A Inclusão dos novos títulos, será efetuada conforme a negociação realizada no portal Techfin, os valores já serão inseridos com os Juros embutidos. Assim como as datas de vencimentos acordadas. Os códigos de barras já serão disponibilizados devidamente cadastrados no titulo.

Observe o rastreio dos títulos e seus desdobramentos conforme as imagens.

Image Removed

Expandir

title	Prorrogação das Parcelas

Será possível a prorrogação dos títulos que foram negociados previamente.

As solicitações de prorrogação serão incluídas assim que estiver liberado pelo Portal Techfin.

Serão alteradas as parcelas solicitadas com novas datas de vencimentos, novos códigos de barras e acrescidas de juros negociados.

Os Juros estão sendo incluídos via Valores Acessórios - FKD, com o código escolhido no momento do Wizard.

Image Removed

Expandir

title	Tabelas e Parâmetros Envolvidos

As Tabelas Envolvidas:

SE2 - Tabelas de Contas a Pagar
SE5 - Tabela de Movimentação Bancária
FI8 - Tabela de Naturezas Financeiras
FKC - Códigos Valores Acessórios
FKD - Titulos x Valores Acessórios

Parametros Envolvidos:

MV_PRETECF – Prefixo dos Titulos negociados, deverá conter o prefixo dos títulos a favor da Supplier

MV_TPTECF – Tipo de Titulos negociados, deverá contém o tipo de título dos títulos a favor da Supplier

MV_NTTECF – Natureza de títulos Negociados, deverá conter a natureza financeira cadastrada para os títulos em favor da SupplierMV_FNTECF – Fornecedor de Titulos negociados, deverá conter o codigo do fornecedor cadastrado para os títulos em favor da SupplierMV_LFTECF – Loja do fornecedor negociados, deverá conter o codigo da loja do fornecedor cadastrado para os títulos em favor da SupplierMV_MBXTECF - Codigo do Motivo de Baixa, dos títulos que foram antecipados.MV_VATECF – Código dos valores acessórios, dos títulos negociados em favor da Supplier, que sofreram pedido de prorrogação

**** Importante: O Compartilhamento dos parâmetros devem ser observados de acordo com a estrutura do cliente, sugerimos que os códigos de Fornecedores e Naturezas sejam os mesmos, em todas as filiais, no entanto, caso isso nao seja possivel, deverá ser tratado de forma exclusiva.

Fontes Envolvidos:

FINA137E.PRW (Resnponsável pela requisição do TOKEN junto a Carol)
FINA137F.PRW (Responsável pelo JOB que recebe o Json com os titulos a serem baixados / incluidos ou alterados)
FINA137G.PRW (Responsável para envio do POST na plataforma para informar que os titulos foram devidamente movimentados no Protheus)
FINXAPI.PRW (Responsavel pelas rotinas de Baixa / Geração de Titulos e Alteração dos titulos)

Expandir

title	Informações Técnicas

Expandir

title	FINXAPI.PRW

Com a movimentação em mãos, será chamada as seguintes funções:

FaBaixaCp() para baixar os titulos informados
FaIncSE2() para incluir os titulos novos
FaAltSE2() para alterar os titulos prorrogados

Expandir

title	Appserver.ini

Após rodar o Wizard, essas tag´s serão acrescidas no appserver.ini

Na sessão Environment

fw-tf-debug=0
fw-tf-carol-endpoint=https://totvstechfindev.carol.ai/api
fw-tf-platform-endpoint=https://fmscash.dev.totvs.io
fw-tf-rac-endpoint=https://admin.rac.dev.totvs.app

Expandir

title	Json Techfin- TOTVS Mais Prazo

[
{
"cnpj": "53485215000106",
"boletos": {
"pagos": [
{
"platformId": "5",
"erpId": "T1|D MG 01 ||20210121A||NF|000001|01",
"dataMovimento": "2021-01-21",
"valor": 350000,
"historico": "BOLETO PAGO"
}
],
"gerados": [
{
"platformId": "99999900000000001",
"numeroTransacao": "200000001",
"valorTotal": 360000.60,
"juros": 10000.6,
"parcelas": [
{
"numeroParcela": "1",
"valorParcela": 120000.20,
"dataVencimento": "2021-02-21",
"dataEmissao": "2021-01-21",
"numeroLinhaDigitavel": "34191092060023598295680002060004687700002288835",
"numeroCodigoBarras": "34196877000022888351092000235982958000206000",
"historico": "PARCELA GERADA"
},
{
"numeroParcela": "2",
"valorParcela": 120000.20,
"dataVencimento": "2021-03-21",
"dataEmissao": "2021-01-21",
"numeroLinhaDigitavel": "34191092060023598295680002060004687700002288835",
"numeroCodigoBarras": "34196877000022888351092000235982958000206000",
"historico": "PARCELA GERADA"
},
{
"numeroParcela": "3",
"valorParcela": 120000.20,
"dataVencimento": "2021-04-21",
"dataEmissao": "2021-01-21",
"numeroLinhaDigitavel": "34191092060023598295680002060004687700002288835",
"numeroCodigoBarras": "34196877000022888351092000235982958000206000",
"historico": "PARCELA GERADA"
}
],
"boletoOrigem": [
{
"erpId": "T1|D MG 01 ||20210121A||NF|000001|01"
}
]
}
],
"alterados": []
}
},
{
"cnpj": "20412968000132",
"boletos": {
"pagos": [
{
"platformId": "6",
"erpId": "T2|D MG 01 ||20210121C||NF|TST001|01",
"dataMovimento": "2021-01-21",
"valor": 450000,
"historico": "BOLETO PAGO"
}
],
"gerados": [
{
"platformId": "99999900000000002",
"numeroTransacao": "200000002",
"valorTotal": 480000.60,
"juros": 30000.6,
"parcelas": [
{
"numeroParcela": "1",
"valorParcela": 240000.30,
"dataVencimento": "2021-02-22",
"dataEmissao": "2021-01-21",
"numeroLinhaDigitavel": "34191092060023598295680002060004687700002288835",
"numeroCodigoBarras": "34196877000022888351092000235982958000206000",
"historico": "PARCELA GERADA"
},
{
"numeroParcela": "2",
"valorParcela": 240000.30,
"dataVencimento": "2021-03-22",
"dataEmissao": "2021-01-21",
"numeroLinhaDigitavel": "34191092060023598295680002060004687700002288835",
"numeroCodigoBarras": "34196877000022888351092000235982958000206000",
"historico": "PARCELA GERADA"
}
],
"boletoOrigem": [
{
"erpId": "T2|D MG 01 ||20210121C||NF|TST001|01"
}
]
}
],
"alterados": []
}
}
]

Expandir

title	Habilitar a Geração de Log´s

Para Habilitar os Log´s no Console.Log, é necessário incluir no Appserver.Ini a seguinte linha na Sessão Environment, conforme MP - ADVPL - Como Ativar a função FWLogMsg. – Central de Atendimento TOTVS

FWLOGMSG_DEBUG = 1

Card

id	5
label	Extrator de indicadores Financeiros
effectType	fade

Expandir

title	Execução do wizard

Para iniciar o wizard de extração dos dados, o usuário deverá digitar FIN_IND***(Alterar) na tela inicial

Após isso será exibida a tela de apresentação ***(Alterar)

Na tela de login informe o usuário e senha do Protheus, algumas validações serão feitas nesse passo, sendo elas:

Autenticação do usuário
O usuário deve ter acesso ao modulo SIGAFIN (06)

No passo 3 - de grupo de empresas, será exibidos os grupos que o usuário tem acesso, e dois parâmetros de data, que serão utilizados para extração dos indicadores financeiros, algumas validações serão feitas nesse passo, sendo elas:

O usuário deve escolher pelo menos 1 grupo de empresa
O intervalo entre as datas deve ser maior ou igual a 365 dias
O campo "Data ate" dever ser menor ou igual a (Data de hoje - 1)
O conteúdo dos campos "Data de" e "Data Ate" devem ser preenchidos

No passo 4 - será possível visualizar o processamento dos dados

Finalização do wizard ***(Alterar)

Expandir

title	Controle de processamento

Por se tratar de uma funcionalidade que será executada através de JOB caso aconteça algum erro durante o processamento será apresentado da seguinte forma:

Oque impossibilita a leitura, por isso, caso algum erro aconteça solicite ao administrador do sistema que o console log do Protheus seja ligado, para que o erro possa ser coletado e analisado.

...

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave

01. VISÃO GERAL

02. PRODUTOS

INDICADORES TECHFIN