Integrações TECHFIN

Protheus - Guia Cloud TOTVS - TDN

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

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

Clicar em OK

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

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

Escolha o Produto a ser configurado e Clicar em Avançar

Clicar em Avançar.

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

Digitar o ClientID e a Client Secret.

Preencher os parâmetros de acordo com o solicitado para o produto selecionado.

TOTVS Mais Prazo

Prefixo

Prefixo que será utilizado nas novas parcelas no processo de prorrogação.

Tipo

Tipo do título que será utilizado nas novas parcelas no processo de prorrogação.

Natureza Financeira

Natureza que será utilizada nas novas parcelas no processo de prorrogação.

O botão "Pesquisar" permite selecionar uma Natureza já existente e o botão "Incluir" abre uma tela de inclusão com dados sugeridos para o cadastro.

Fornecedor/Loja

Fornecedor e loja para o qual serão geradas as novas parcelas no processo de prorrogação.

O botão "Pesquisar" permite selecionar um Fornecedor já existente e o botão "Incluir" abre uma tela de inclusão com dados sugeridos para o cadastro.

Valor Acessório

Código do valor acessório que será utilizado quando houver alteração de vencimento dos boletos TOTVS Mais Prazo.

O botão "Pesquisar" permite selecionar um Valor Acessório já existente e o botão "Incluir" abre uma tela de inclusão com dados sugeridos para o cadastro.

Motivo Baixa

Motivo que será utilizado nas baixas dos títulos originais.

Esse motivo de baixa não deve movimentar banco e deve ser para carteira pagar (P). Serão listados automaticamente todos os motivos de baixa que estiverem nessa condição e o código MPR será cadastrado automaticamente pelo Wizard.

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

Integração Protheus x TOTVS Antecipa

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

Integração Protheus x TOTVS Painel Financeiro

Implantação

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

1) Verificar os requisitos mínimos:

Binário a partir da versão 7.00.191205P-20200220
DbAccess a partir da versão 20200606
Release Protheus a partir da 12.1.25
Lib Techfin a partir da versão 2.4.0

2) 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.

3) Efetuar os cadastros dos seguintes Itens:

Fornecedor Supplier - fornecedor para o qual serão geradas as novas parcelas no processo de prorrogação
Natureza Financeira - natureza que será utilizada nas novas parcelas no processo de prorrogação
Motivo de Baixa - motivo que será utilizado nas baixas dos títulos originais. Esse motivo de baixa não deve movimentar banco e deve ser para carteira pagar (P)
Tipos de Valores acessórios - código do valor acessório que será utilizado quando houver alteração de vencimento dos boletos TOTVS Mais Prazo.

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

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 10 em 10 minutos, fará uma requisição junto a 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 um retorno que as operações foram realizadas no ERP, mantendo assim o Protheus e o Portal Techfin sincronizados.

Baixa de Titulos

A Baixa dos Títulos será realizada com o motivo de baixa configurado no Wizard, lembrando que o Motivo de Baixa não movimenta banco, e por essa razão não será exibida no extrato bancário.

A data de baixa é a data de processamento e no histórico da baixa ficará gravado o número da negociação TOTVS Mais Prazo

Inclusões de Novos Titulos

A Inclusão dos novos títulos, será efetuada conforme a negociação realizada no portal Techfin.

O valor dos novos títulos será gravado nos campos abaixo, sempre proporcionais à quantidade de parcelas da negociação:

Vlr Título (E2_VALOR) - Valor do boleto original
Acréscimo (E2_ACRESC) - Valor do juros + IOF da operação
IOF (FKF_IOF) - Valor do IOF da operação

As datas de vencimento dos novos títulos estarão de acordo com o que foi selecionado no momento da operação e 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.

Tela da rotina de Complemento do Título, campo de IOF.

Alteração de Vencimento de Títulos TOTVS Mais Prazo

Será possível realizar a alteração de vencimento dos novos títulos que foram gerados no processo de prorrogação.

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

Os Juros serão incluídos via Valores Acessórios (tabela FKD), com o código escolhido no momento do Wizard.

Contabilização

A seguir serão apresentados dois exemplos de parametrizações dos Lançamentos Padronizados para a contabilização das movimentações das integrações TOTVS Mais Prazo.

Importante

Os exemplos abaixo devem ser usados apenas como referência, pois as regras contábeis devem ser validadas com o contador da empresa e os Lançamentos Padronizados adequados de acordo com a regra de negócio e parametrizações já existentes no ambiente.

Para os Lançamentos Padronizados foram considerados os cadastros e parametrizações abaixo:

Conta Contábil

2101010002 = Fornecedores Transitória
2102019999 = (-) Juros a Transcorrer
2102019998 = (-) IOF a Transcorrer
3101010002 = Despesa Juros
3101010003 = Despesa IOF

Outras Parametrizações

Natureza dos novos títulos = MAISPRAZO
Motivo de Baixa usado na baixa do título original = MPR
Variável de contabilização do Valor Acessório (para casos com Alteração do Vencimento) = MPR001

Cenário 1 - Utilizando a conta (-) Juros e IOF a Transcorrer

Neste cenário, no momento da inclusão da nova parcela, o valor do Juros e do IOF serão contabilizados em uma conta a Transcorrer. Quando esta nova parcela for baixada, os valores do juros e IOF serão baixados da conta a Transcorrer e lançados em uma conta de Despesa Juros e Despesa IOF.

Campo	Conteúdo
Cod Lanc Pad	510
Sequencial	001
Descrição	INC TIT PAGAR - FORNECEDOR / TRANSITORIA
Tipo Lcto	1 - Débito
Cta Débito	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",2101010002,SA2->A2_CONTA)
Cta Crédito
Vlr Moeda 1	SE2->E2_VALOR
Histórico	"INC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	510
Sequencial	002
Descrição	INC TIT PAGAR - JUROS A TRANSCORRER
Tipo Lcto	1 - Débito
Cta Débito	2102019999
Cta Crédito
Vlr Moeda 1	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",SE2->E2_ACRESC - FKF->FKF_IOF,0)
Histórico	"INC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	510
Sequencial	003
Descrição	INC TIT PAGAR - IOF A TRANSCORRER
Tipo Lcto	1 - Débito
Cta Débito	2102019998
Cta Crédito
Vlr Moeda 1	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO", FKF->FKF_IOF ,0)
Histórico	"INC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	510
Sequencial	004
Descrição	INC TIT PAGAR - FORNECEDOR
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	SA2->A2_CONTA
Vlr Moeda 1	SE2->E2_VALOR + IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",SE2->E2_ACRESC,0)
Histórico	"INC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	515
Sequencial	001
Descrição	EXC TIT PAGAR - FORNECEDOR
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",2101010002,SA2->A2_CONTA)
Vlr Moeda 1	SE2->E2_VALOR
Histórico	"EXC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	515
Sequencial	002
Descrição	EXC TIT PAGAR - JUROS A TRANSCORRER
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	2102019999
Vlr Moeda 1	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",SE2->E2_ACRESC - FKF->FKF_IOF, 0)
Histórico	"EXC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	515
Sequencial	003
Descrição	EXC TIT PAGAR - IOF A TRANSCORRER
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	2102019998
Vlr Moeda 1	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",FKF->FKF_IOF, 0)
Histórico	"EXC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	515
Sequencial	004
Descrição	EXC TIT PAGAR - FORNECEDOR / TRANSITORIA
Tipo Lcto	1 - Débito
Cta Débito	SA2->A2_CONTA
Cta Crédito
Vlr Moeda 1	SE2->E2_VALOR + IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",SE2->E2_ACRESC,0)
Histórico	"EXC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	530
Sequencial	001
Descrição	BX TIT PAGAR - FORNECEDOR
Tipo Lcto	1 - Débito
Cta Débito	SA2->A2_CONTA
Cta Crédito
Vlr Moeda 1	SE5->E5_VALOR - MPR001
Histórico	"BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	530
Sequencial	002
Descrição	BX TIT PAGAR - TRANSITORIA / BANCO
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR",2101010002,SA6->A6_CONTA)
Vlr Moeda 1	SE5->E5_VALOR
Histórico	"BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	530
Sequencial	003
Descrição	BX TIT PAGAR - DESPESA JUROS
Tipo Lcto	1 - Débito
Cta Débito	3101010002
Cta Crédito
Vlr Moeda 1	SE5->E5_VLACRES + MPR001 - POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, 'FKF_IOF')
Histórico	"BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	530
Sequencial	004
Descrição	BX TIT PAGAR - JUROS A TRANSCORRER
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	2102019999
Vlr Moeda 1	IIF(ALLTRIM(SE5->E5_NATUREZ)=="MAISPRAZO",SE5->E5_VLACRES - POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, FKF_IOF'), 0)
Histórico	"BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	530
Sequencial	005
Descrição	BX TIT PAGAR - DESPESA IOF
Tipo Lcto	1 - Débito
Cta Débito	3101010003
Cta Crédito
Vlr Moeda 1	POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, 'FKF_IOF')
Histórico	"BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	530
Sequencial	006
Descrição	BX TIT PAGAR - IOF A TRANSCORRER
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	2102019998
Vlr Moeda 1	IIF(ALLTRIM(SE5->E5_NATUREZ)=="MAISPRAZO",POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, FKF_IOF'), 0)
Histórico	"BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	531
Sequencial	001
Descrição	EXC BX TIT PAGAR - FORNECEDOR
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	SA2->A2_CONTA
Vlr Moeda 1	SE5->E5_VALOR - MPR001
Histórico	"EXC BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	531
Sequencial	002
Descrição	EXC BX TIT PAGAR - TRANSITORIA / BANCO
Tipo Lcto	1 - Débito
Cta Débito	IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR",2101010002,SA6->A6_CONTA)
Cta Crédito
Vlr Moeda 1	SE5->E5_VALOR
Histórico	"EXC BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	531
Sequencial	003
Descrição	EXC BX TIT PAGAR - DESPESA JUROS
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	3101010002
Vlr Moeda 1	SE5->E5_VLACRES + MPR001 - POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, 'FKF_IOF')
Histórico	"EXC BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	531
Sequencial	004
Descrição	EXC BX TIT PAGAR - JUROS A TRANSCORRER
Tipo Lcto	1 - Débito
Cta Débito	2102019999
Cta Crédito
Vlr Moeda 1	IIF(ALLTRIM(SE5->E5_NATUREZ)=="MAISPRAZO",SE5->E5_VLACRES - POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, 'FKF_IOF'),0)
Histórico	"EXC BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	531
Sequencial	005
Descrição	EXC BX TIT PAGAR - DESPESA IOF
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	3101010003
Vlr Moeda 1	POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, 'FKF_IOF')
Histórico	"EXC BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	531
Sequencial	006
Descrição	EXC BX TIT PAGAR - IOF A TRANSCORRER
Tipo Lcto	1 - Débito
Cta Débito	2102019998
Cta Crédito
Vlr Moeda 1	IIF(ALLTRIM(SE5->E5_NATUREZ)=="MAISPRAZO",POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, 'FKF_IOF'),0)
Histórico	"EXC BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Cenário 2 - Despesa na Inclusão das Novas Parcelas

Neste cenário, no momento da inclusão da nova parcela, o valor do Juros e IOF serão contabilizados diretamente nas contas de Despesa Juros e Despesa de IOF.

Campo	Conteúdo
Cod Lanc Pad	510
Sequencial	001
Descrição	INC TIT PAGAR - FORNECEDOR / TRANSITORIA
Tipo Lcto	1 - Débito
Cta Débito	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",2101010002,SA2->A2_CONTA)
Cta Crédito
Vlr Moeda 1	SE2->E2_VALOR
Histórico	"INC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	510
Sequencial	002
Descrição	INC TIT PAGAR - DESPESA JUROS
Tipo Lcto	1 - Débito
Cta Débito	3101010002
Cta Crédito
Vlr Moeda 1	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",SE2->E2_ACRESC - POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, 'FKF_IOF'),0)
Histórico	"INC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	510
Sequencial	003
Descrição	INC TIT PAGAR - DESPESA IOF
Tipo Lcto	1 - Débito
Cta Débito	3101010003
Cta Crédito
Vlr Moeda 1	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, 'FKF_IOF'),0)
Histórico	"INC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	510
Sequencial	004
Descrição	INC TIT PAGAR - FORNECEDOR
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	SA2->A2_CONTA
Vlr Moeda 1	SE2->E2_VALOR + IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",SE2->E2_ACRESC,0)
Histórico	"INC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	515
Sequencial	001
Descrição	EXC TIT PAGAR - FORNECEDOR
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",2101010002,SA2->A2_CONTA)
Vlr Moeda 1	SE2->E2_VALOR
Histórico	"EXC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	515
Sequencial	002
Descrição	EXC TIT PAGAR - DESPESA JUROS
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	3101010002
Vlr Moeda 1	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",SE2->E2_ACRESC - POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, 'FKF_IOF'),0)
Histórico	"EXC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	515
Sequencial	003
Descrição	EXC TIT PAGAR - DESPESA IOF
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	3101010003
Vlr Moeda 1	IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",POSICIONE('FKF', 1, xFilial("FK7")+FK7->FK7_IDDOC, 'FKF_IOF'),0)
Histórico	"EXC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	515
Sequencial	004
Descrição	EXC TIT PAGAR - FORNECEDOR / TRANSITORIA
Tipo Lcto	1 - Débito
Cta Débito	SA2->A2_CONTA
Cta Crédito
Vlr Moeda 1	SE2->E2_VALOR + IIF(ALLTRIM(SE2->E2_NATUREZ)=="MAISPRAZO",SE2->E2_ACRESC,0)
Histórico	"EXC CP " + SE2->E2_PREFIXO+SE2->E2_NUM+SE2->E2_PARCELA+SE2->E2_TIPO + " - TOTVS MAIS PRAZO " + ALLTRIM(SE2->E2_NUM) + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	530
Sequencial	001
Descrição	BX TIT PAGAR - FORNECEDOR
Tipo Lcto	1 - Débito
Cta Débito	SA2->A2_CONTA
Cta Crédito
Vlr Moeda 1	SE5->E5_VALOR - MPR001
Histórico	"BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	530
Sequencial	002
Descrição	BX TIT PAGAR - TRANSITORIA / BANCO
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR",2101010002,SA6->A6_CONTA)
Vlr Moeda 1	SE5->E5_VALOR
Histórico	"BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	531
Sequencial	001
Descrição	EXC BX TIT PAGAR - FORNECEDOR
Tipo Lcto	2 - Crédito
Cta Débito
Cta Crédito	SA2->A2_CONTA
Vlr Moeda 1	SE5->E5_VALOR - MPR001
Histórico	"EXC BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Campo	Conteúdo
Cod Lanc Pad	531
Sequencial	002
Descrição	EXC BX TIT PAGAR - TRANSITORIA / BANCO
Tipo Lcto	1 - Débito
Cta Débito	IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR",2101010002,SA6->A6_CONTA)
Cta Crédito
Vlr Moeda 1	SE5->E5_VALOR
Histórico	"EXC BX CP " + SE5->E5_PREFIXO+SE5->E5_NUMERO+SE5->E5_PARCELA+SE5->E5_TIPO + IIF(ALLTRIM(SE5->E5_MOTBX)=="MPR"," - " + ALLTRIM(SE5->E5_HISTOR),"") + " - " + ALLTRIM(SE2->E2_NOMFOR)

Informações Técnicas

Tabelas e Parâmetros Envolvidos

Tabelas:

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 - Títulos x Valores Acessórios
FKF - Tabela de Complemento do Título
FI7 - Rastreamento CR

Parâmetros:

MV_PRETECF – Prefixo dos Títulos negociados, deverá conter o prefixo dos títulos a favor da Supplier
MV_TPTECF – Tipo de Títulos 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 Supplier
MV_FNTECF – Fornecedor de Títulos negociados, deverá conter o código do fornecedor cadastrado para os títulos em favor da Supplier
MV_LFTECF – Loja do fornecedor negociados, deverá conter o código da loja do fornecedor cadastrado para os títulos em favor da Supplier
MV_MBXTECF - Código 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 não seja possível, deverá ser tratado de forma exclusiva.

Fontes:

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

Códigos de Lançamento Padrão

As movimentações poderão ser contabilizadas através dos seguintes códigos de Lançamentos Padrão:

510 - Contas a Pagar - Inclusão de Títulos
515 - Contas a Pagar - Exclusão de Títulos
530 - Contas a Pagar - Baixa de Títulos
531 - Contas a Pagar - Cancelamento de Baixas de Títulos

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

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

Clicar em OK.

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

Digitar um usuário com poder de Administrador e sua senha, e escolher as empresas que serão configuradas e Clicar em Avançar.

Escolha o Produto a ser configurado, no caso, será o TOTVS Mais Negócios e Clicar em Fechar.

Clicar em Avançar.

Clicar em Estou Ciente e depois em Fechar.

Digitar o Client ID e Client Secret. Depois Clicar em Avançar.

Para a integração, é necessário cadastrar / associar o Fornecedor (CNPJ do parceiro que fornece o crédito) e Cliente (CNPJ do parceiro que assume o crédito). Neste caso é necessário informar os dados do cadastro no Protheus.

No exemplo acima, a Supplier será o Cliente e Fornecedor dos Títulos a Pagar e Receber gerados no processo.

Logo em seguida, é necessário informar os dados da conta bancária onde as movimentações financeiras serão creditadas e conciliadas. É importante lembrar que estes dados devem ser os mesmos utilizados pelo parceiro (para pagamento e recebimento).

Conta Ponte - ao habilitar essa opção, as rotinas de conciliação irão utilizar a conta transitória para realizar as movimentações financeiras, ao final do processamento verifica se o saldo do banco é positivo, para fazer a transferência para a conta bancária configurada nos "Dados do Banco".

Natureza específica para transferências bancárias ( MNTRANSFDB e MNTRANSFCR ) - caso seja marcada esta opção, as transferências da Conta Ponte para a Conta Corrente serão feitas com as naturezas específicas MNTRANSFDB e MNTRANSFCR. Caso contrário as transferências serão feitas com as mesmas naturezas utilizadas na geração dos Títulos a Pagar e Receber do Mais Negócios.

Atenção

A configuração da Conta Ponte deve ser igual para todos os grupos de empresas configurados para utilização do TOTVS Mais Negócios.

Escolha a opção desejada para a configuração do Schedule no sistema e em seguida Clicar em Finalizar.

Aguarde o processamento da configuração do sistema.

Clicar em Concluir para finalizar o Wizard.

Em seguida, Clicar em Finalizar para fechar a tela.

Para maiores informações sobre a extração de indicadores, consulte o link a seguir:

Extração de Indicadores

Árvore de páginas

Integrações TECHFIN

01. VISÃO GERAL

02. PRODUTOS