Histórico da Página

CONTEÚDO

1. Visão Geral
2. Contas a Pagar Previsto
3. Contas a Pagar Realizado
4. Contas Receber Previsto
5. Contas Receber Realizado
6. Demais infomrações
7. Data Models
8. Flex Fields
9. Demais informações

01. VISÃO GERAL

Esse documento apresenta um modelo visual de como as informação são trabalhadas dentro da Carol, antes de serem enviadas à Gesplam.Image Added

A Carol , possui duas áreas principais uma área de armazenamento , a staging area onde ficam as staging tables, que são as tabelas que armazenam os dados brutos provenientes do ERP e os Data Models que armazenam os goldem records ue foram trabalhados através . Os Data Models são estrutura de dados definidas dentro da Carol, e nessas estruturas são armazenadas as informações resultantes do processamento das pipelines. 

Para mais informações (link da documentação da carol)

No tópico 02 abaixo, é apresentado um modelo visual de como as informação são trabalhadas dentro da Carol, antes de serem enviadas à Gesplam. Cada quadro apresentado dentro  da camada Pipeline, representa uma Common table expression, que é um conjunto nomeado e temporário de resultados, derivado de uma consulta sql (common table expression - CTE). São utilizadas como alternativa à, por exemplo,  subquerys e views, para melhor organização e manutenção das consultas.

Dentro do código das pipelines elas essas CTE's estão dispostas da seguinte forma:

WITH common_table_expression_

...

1 (query_statement_1)

...

,
common_table_expression_2 ( query_statement_2 ),
common_table_expression_n ( query_statement_n )

Cada CTE armazena um conjunto intermediário de registros que são utilizados pelas CTEs seguintes , até que por fim é gerado um CTE final, que contém os registros que atendem à regra de negócio e que serão levados para o Data Models.

02. DATA MODELS

Principais tabelas e campos envolvidos:

02. PRODUTOS

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. 

Image Removed

Image Removed

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

Image Removed

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.

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.

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.

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:

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

Em todos os Data Models (exceto Movimento Bancário) esta previsto o envio do rateio Multi-natureza x Centro de Custo, caso esteja habilitado através dos parâmetros MV_MULNATP e MV_MULNATR.

Sendo assim, uma vez que  título possuir rateio, haverá o envio do registro divido na quantidade de linhas que o valor foi rateado; cada linha com o conteúdo da Natureza do título, Natureza do rateio (EV_NATUREZ) e Centro de Custo distribuído para a Natureza do rateio (EZ_CCUSTO).

03. FLEX FIELDS

A integração permite ainda que campos específicos (ou campos padrão que não fazem parte da integração) sejam levados à Gesplan.

Essa configuração, embora seja contemplada por uma funcionalidade padrão da Carol, deve ser realizada em conjunto com a equipe Gesplan,  para que haja um De/Para entre os sistemas, e a Gesplan seja capaz de identificar a que se refere esse novo dado.

Na Carol, essa configuração é feita dentro do App Settings do tenant do cliente, uma vez cadastrado os pipelines levarão o conteúdo desses campos das staging tables para os data models.

Cada Data Model suporte até 50 campos customizados. A configuração deve seguir uma nomenclatura e deve estar vinculado a um grupo de campo de nome fixo também, conforme descrito abaixo:

O cadastro dos flex fields esta restrito à campos somente das tabelas listadas na coluna Origem do dado. Qualquer outra configuração que indique um campos de outra tabela causará falha na execução do pipeline.

Os flex fields 001, 002 e 003 dos data models Pagar e Receber, não devem ser cadastrados no App settings, eles são reservados para uso exclusivo, já pré definido dentro de cada pipeline:

• Flex Field 001 - Natureza do título (E1 / E2 Natureza)
• Flex Field 002 - Natureza do Rateio do título (EV_NATUREZ)
• Flex Field 003 - Centro de custo do Rateio (EZ_CCUSTO)

4. DEMAIS INFORMAÇÕES

• TOTVS Carol Overview
• https://docs.carol.ai/ 
• Plugin do VSCode para codificação de pipelines SQL