Páginas filhas
  • Integrations TECHFIN

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Deck of Cards
idCenario
effectTypefade
Card
id1
labelWizard de ConfiguraçãoCon
effectTypefade
Expandir
titleConfiguration Wizard de Configuração

To start the Configuration Wizard, enter WizardTF1 in the homepage


Click OK

Check if the initial requests have been met, and then click Next


Enter Admin user and password, then choose the companies to set and click Next

Choose Product to be set, in this case, TOTVS More Time to Pay or TOTVS Antecipa. Click Next.

Accept parameters sharing verification


Enter ClientID and Client Secret, sent by Techfin

Complete the parameters according to as requested.







Card
id1
labelTOTVS Antecipa
effectTypefade

For further information on the TOTVS Financial Panel Antecipa integration, refer to this link:

Integration Protheus x TOTVS Financial PanelAntecipa

Card
id1
labelTOTVS Painel FinanceiroFinancial Panel
effectTypefade

For further information on the TOTVS Financial Panel integration, refer to this link:

Integration Protheus x TOTVS Financial Panel

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
labelTOTVS Mais Prazo
Expandir
titleImplantaçãoImplementation

To implement TOTVS More Time to PayPara 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 ReleaseApply the last Protheus continuous expedition, along with the dictionary differential through the UPDDISTR, according to the release version

2) Efetuar os cadastros dos seguintes ItensRegisters of these items:

  • Fornecedor Supplying Company Supplier;
  • Natureza FinanceiraFinancial Nature
  • Motivo de Baixa que não movimenta banco e carteira pagar Posting Payment Reason that does not perform any transaction or portfolio payable (P)

3) Executar o wizard de acordo com os passos conforme a aba Wizard de Configuração Execute the o wizard according to the steps of the Configuration Wizard tab.

Expandir
titleOperaçãoOperation

The operation consists of scheduling the execution by FINA137F, which is the JOB in charge of requesting the transactions along with the Techfin and execute them in Protheus. 

Operations flow:

1) JOB FINA137F, with schedule and periodicity at every hour, will perform a request along with the Techfin to receive a message with the transactions to be executed in Protheus. The customer may adjust the periodicity, however, we recommend never to increase this interval too much, in order to keep the Techfin portal as synchronized as possible with Protheus

2) After the operation in Protheus, the system sends to Techfin the operations performed in Protheus. Keeping Protheus and Techfin synchronized.

3) The bills that will be negotiated are the ones with bar code registered

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
titleBaixa de Titulos

The Posting Payment of Bills will be executed with the posting payment reason set in the Wizard, remembering that the Posting Payment Reason does not involve any bank transactions , so this posting is not displayed in the bank statement. The history will be sent through the Platform. 

Image Added

This posting payment does not involve bank transactions. Note the posting reason is TEC, the same one chosen in the wizard previously registered, with the option “Involve Bank Transaction - “N”, the History “BANK SLIP PAID” is sent by the Techfin, the posting date is the processing date

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
titleInclusões de Novos TitulosAddition of New Bills

New bills are added according to the negotiation in the Techfin portal. Values are already added with the embedded interest, as well as the expiration dates agreed. The bar codes are made available properly registered in the bill. 

Note the traceability of the bills and breakdowns according to the images

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



Expandir
titleProrrogação das ParcelasExtension of Installments

You can postpone bills previously negotiated. 

Postponing requests are added as soon as the Techfin Portal is released. 

The requested installments will be changed with new due dates, new bar codes and increased interest negotiated.

The Interests are added via Accessory values - FKD with the code chosen at the

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.



Expandir
titleTabelas e Parâmetros EnvolvidosTables and Parameters

TablesAs Tabelas Envolvidas:

  • SE2 - Tabelas de Contas a PagarAccounts Payable Table
  • SE5 - Tabela de Movimentação BancáriaBank Transaction Table
  • FI8 - Tabela de Naturezas FinanceirasFinancial Natures Table
  • FKC - Códigos Valores AcessóriosAccessory Value Codes
  • FKD - Titulos Bills x Valores AcessóriosAccessory values


ParametersParametros Envolvidos:

  • MV_PRETECFPrefixo dos Titulos negociados, deverá conter o prefixo dos títulos a favor da Prefix of the Bills negotiated must have the prefix of the bills in favor the Supplier
  • MV_TPTECFTipo de Titulos negociados, deverá contém o tipo de título dos títulos a favor da Prefix of the Bills negotiated must have the title of the bills in favor the Supplier
  • MV_NTTECF Natureza de títulos Negociados, deverá conter a natureza financeira cadastrada para os títulos em favor da Nature of Negotiated Bills must have the financial nature registered for the bills in favor of the Supplier
  • MV_FNTECFFornecedor de Titulos negociados, deverá conter o codigo do fornecedor cadastrado para os títulos em favor da Prefix of the Bills negotiated must have the supplier code registered for the bills in favor of the Supplier
  • MV_LFTECF Loja do fornecedor negociados, deverá conter o codigo da loja do fornecedor cadastrado para os títulos em favor da Store of the supplier negotiated must have the supplier store code registered for the bills in favor of the Supplier
  • MV_MBXTECF - Codigo do Motivo de Baixa, dos títulos que foram antecipadosReason of the Posting Code, of the anticipated bills.
  • MV_VATECFCódigo dos valores acessórios, dos títulos negociados em favor da Supplier, que sofreram pedido de prorrogaçãoCode of the accessory values, bills negotiated in favor of the Supplier, which were requested for extension


**** 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)

Important: Sharing parameters must be observed according to the customer’s structure. We suggest the codes of Suppliers and Natures are the same, in all branches, however, in case this is not possible, it must be dealt with exclusively.

Sources:

  • PRW  (In charge of requesting the TOKEN to Carol)
  • PRW  (In charge of the JOB receiving the Json with the bills to be posted/added or edited)
  • PRW (In charge of submitting the POST in the platform to inform the bills were properly operated in Protheus)
  • PRW    (In charge of the Posting Payment/Generation of Bills and Editing Bills routines)
Expandir
titleTechnical Data
Expandir
titleInformações Técnicas
Expandir
titleFINXAPI.PRW

Com a movimentação em mãos, será chamada as seguintes funçõesWith the bank transactions, these functions are called

  • FaBaixaCp() para baixar os titulos informadosto post bills entered
  • FaIncSE2() para incluir os titulos novosto add the new bills
  • FaAltSE2() para alterar os titulos prorrogadosto edit the bills postponed
Expandir
titleAppserver.ini

Após rodar o Wizard, essas tag´s serão acrescidas no After running the Wizard, these tags are added to the appserver.ini

Na sessão In the Environment session

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
titleJson Techfin- TOTVS Mais PrazoMore Time to Pay

[
{
"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
titleHabilitar a Geração de Log´sEnable Logs Generation

To Enable the Logs in the Para Habilitar os Log´s no Console.Log, é necessário incluir no add to the Appserver.Ini a seguinte linha na Sessão this Environment Session, conforme according MP - ADVPL - Como Ativar a função How to Activate the function FWLogMsg.TOTVS Service Central de Atendimento TOTVS

FWLOGMSG_DEBUG = 1



HTML
<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...