Árvore de páginas

Versões comparadas

Chave

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

FINI050 ACCOUNTPAYABLEDOCUMENT

Produto:

Microsiga Protheus

Versões:11 e 12

Ocorrência:

Mensagem ACCOUNTPAYABLEDOCUMENT

Passo a passo:

Mensagem ACCOUNTPAYABLEDOCUMENT

De/Para e tag's utilizados do XML para a Versão 2.002 e 3.001:

OBS. As tag's que utilizam de/para, estão com o ALIAS e CAMPO informados.

TagAliasCampoGrava
DocumentPrefix

E2_PREFIXO
DocumentParcel

E2_PARCELA
DocumentTypeCode

E2_TIPO
VendorInternalIdSA2A2_CODE2_FORNECE ; E2_LOJA
DocumentNumber

E2_NUM
FinancialNatureInternalIdSEDED_CODIGOE2_NATUREZ
IssueDate

E2_EMISSAO
DueDate

E2_VENCTO
RealDueDate

E2_VENCREA
NetValue

E2_VALOR ; E2_VLCRUZ
Observation

E2_HIST
Origin

E2_ORIGEM
CurrencyInternalIdCTOCTO_MOEDAE2_MOEDA
BankCode

E2_FORBCO
BankBranch

E2_FORAGE
CheckingAccountNumber

E2_FORCTA
BranchKey

E2_FAGEDV
CheckingAccountNumberKey  E2_FCTADV
CostCenterInternalId

E2_CCUSTO
AccountingCodeDebit


De/Para e tag's utilizados do XML somente para a Versão 3.001:

Tag                                         AliasCampo        Grava                            
AccountingAccountDebitCT1CT1_CONTA
E1
E2_DEBITO
AccountingCodeCredit
AccountingAccountCreditCT1CT1_CONTA
E1
E2_CREDIT
CostCenterDebit
CostCenterDebit CTTCTT_CUSTO
E1
E2_CCD
CostCenterCreditCTTCTT_CUSTO
E1
E2_CCC
DepartamentDebit
AccountingItemDebitCTDCTD_ITEM
E1
E2_ITEMD
DepartamentCredit
AccountingItemCreditCTDCTD_ITEM
E1
E2_ITEMC
ClassValueDebitCTHCTH_CLVL
E1
E2_CLVLDB
ClassValueCreditCTHCTH_CLVL
E1
E2_CLVLCR
Observações:
  • Busca as informações bancárias do parâmetro MV_CXFIN quando for título antecipado
  • Utilizado o parâmetro MV_SLMNATR quando FinancialNatureInternalId não for informado
  • Utilizado a origem
FINI040 quando
  • / Origin não for informado

01. VISÃO GERAL

A Apidnfdsnfkjsdfbdskfsdf

sdfhsdkjfhsdkf

02. DETALHAMENTO

...

idCenario
effectTypefade

...

id1
labelWizard de Configuração
effectTypefade

...

titleWizard de Configuração

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

Card
id1
labelTOTVS Antecipa
effectTypefade

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

Integração Protheus x TOTVS Antecipa

Card
id1
labelTOTVS Painel Financeiro
effectTypefade

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

Integração Protheus x TOTVS Painel Financeiro

...

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

...

titleBaixa 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. 

...

titleInclusõ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

Image Removed

...

titleProrrogaçã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

...

titleTabelas 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:

...

**** 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)
  • retorna conteúdo invalido ou vazio.

ApportionmentDistribution


Rateio de centro de Custo

Produto:Protheus
Versões A partir da Versão P12.1.25 - Desenvolvido na Versão P12.1.33
Implementação

Foi realizado a implementação do Rateio do centro de Custo, item Contábil e classe de valor no envio e recebimento. Caso seja enviado mais de um centro de Custo, Item Contábil ou Classe valor o sistema estando configurado para realizar o Rateio de Centro de Custo o sistema vai realizar o Rateio gravando as tabelas 'SEV' (Múltiplas Naturezas por Titulo) e 'SEZ' (Distribuição de Naturezas em Centro de Custo)   

OBS.: O parâmetro MV_MULNATP deverá ser configurado como Verdadeiro para que as tabelas SEV e SEZ sejam alimentadas, caso o parâmetro esteja configurado como Falso somente as informações da tabela 'SE2' (Títulos a Pagar) serão gravados.

Nota
titleNota de Atenção

O rateio de centro de custo não está implementado para Múltiplas Naturezas, ou seja, será gerado apenas um registro na SEV com a natureza indicada no título com 100% do valor.

Integração

Informações que deverão ser cadastradas para que seja realizado o Rateio do Centro de Custo.

Conforme cadastro da tabela XXF De/Para e tag's utilizados do XML para as versões 2.002 e 3.001:

Tag                                     AliasCampo            Grava                           
FinancialNatureInternalIdSEDED_CODIGO

E2_NATUREZ,

EZ_NATUREZ,

EV_NATUREZ

CostCenterInternalIdCTTCTT_CUSTO

EZ_CCUSTO 

CV4_CCD

AccountingItemInternalIdCTDCTD_ITEM EZ_ITEMCTA
ClassValueInternalIdCTHCTH_CLVLEZ_CLVL
VendorInternalIdSA2A2_COD

E2_FORNECE,

EZ_CLIFOR,

EV_CLIFOR 

CurrencyInternalIdCTOCTO_MOEDAE2_MOEDA
Parâmetros:

MV_MULNATP = .T. ( .F. Default) - Se ativado permite utilizar o rateio Multi-Naturezas X Cento de Custos (gravação nas Tabelas: SEV/SEZ);
MV_TPRATRM(1) = 1 (1 Default) - Permite efetuar o rateio Contábil (gravação na Tabela CV4)

Nota
titleImportante

(1) Novo Parâmetro disponível a partir de Agosto/2022 - Release 12.1.33 em diante.

Ambos os parâmetros seguirão a seguinte regra, caso exista informação na mensagem pela TAG <ApportionmentDistribution>:

MV_TPRATRM(1)MV_MULNATPEstrutura de Gravação
DEFAULT (1).T.AMBOS os rateios: CV4 e (SEV/SEZ)
2DEFAULT (.F.)CV4 - Rateio Contábil
2.T.SEV/SEZ - Rateio MultiNatureza X CC
DEFAULT (1)DEFAULT (.F.)CV4 - Rateio Contábil

...

titleInformações Técnicas
Expandir
titleFINXAPI.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
titleAppserver.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
titleJson 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": []
}
}
]

...

titleHabilitar 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

...

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>

...