Árvore de páginas

Versões comparadas

Chave

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

...

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:

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
AccountingCodeDebitCT1CT1_CONTAE1_DEBITO
AccountingCodeCreditCT1CT1_CONTAE1_CREDIT
CostCenterDebitCTTCTT_CUSTOE1_CCD
CostCenterCreditCTTCTT_CUSTOE1_CCC
DepartamentDebitCTDCTD_ITEME1_ITEMD
DepartamentCreditCTDCTD_ITEME1_ITEMC
ClassValueDebitCTHCTH_CLVLE1_CLVLDB
ClassValueCreditCTHCTH_CLVLE1_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




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
idCenario
effectTypefade
Card
id1
labelWizard de Configuração
effectTypefade
Expandir
titleConfiguração EAI
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

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

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

Expandir
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

Expandir
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

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

  • 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
    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": []
    }
    }
    ]

    Expandir
    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

    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>
    
    

    ...