EM BREVE - Novo Rateio Por Evento

Atenção

Essa funcionalidade está em construção e será liberada em breve.

01. VISÃO GERAL

O Rateio por Evento (CTBA271) foi projetado para aprimorar a gestão dos rateios em seu ambiente.

Agora, você pode cadastrar novas regras de rateio utilizando um novo campo, chamado "Evento de Rateio". Ele oferece uma abordagem mais simplificada para definir origens e destinos de rateio, assim, você pode ter uma regra de rateio com diferentes origens.

Neste cadastro é possível definir critérios precisos para a distribuição de valores, permitindo uma configuração personalizada com base em diferentes eventos contábeis. Além disso, ela oferece transparência e rastreabilidade aprimoradas, permitindo o registro e a consulta detalhada das regras cadastradas.

02. PRIMEIROS PASSOS

02.1. REQUISITOS MÍNIMOS

02.1.2. DICIONÁRIOS:

No rateio utilizaremos a nova tabela QLL, confira se o dicionário de dados de seu ambiente já possuí essas tabelas antes de acessar a nova rotina de Rateio por Evento.

02.1.3. PORTA MULTI PROTOCOLO

Para a utilização do novo Rateio por Evento é necessária a ativação da porta multi protocolo no appserver.ini do seu ambiente Protheus.

- - - Na seção GENERAL, deve-se incluir a chave “App_Environment”, cujo valor deve ser o nome do ambiente que os serviços rodarão.
    - Na seção DRIVERS, deve-se habilitar a porta multiprotocolo na chave “MultiProtocolPort” com o valor = 1.
    - Por padrão a conexão SSL está ativa na porta multiprotocolo, os detalhes das configurações estão disponíveis na documentação Application Server - Porta Multiprotocolo. Para desabilitar a conexão por SSL é necessário informar a chave “MultiProtocolPortSecure = 0”

Para mais informações sobre essa configuração acesse a página Application Server - Porta Multiprotocolo.

Exemplo:

03. POSTGRESQL

Caso esteja utilizando banco de dados Postgres confira se sua fonte de dados ODBC está configurada corretamente conforme a documentação:

- - - DBAccess - Como fazer para criar uma fonte de dados para uso com o PostgreSQL - Windows

É necessário habilitar a chave MemoInQuery no DBAccess.ini

- - - DBAccess - Seção [Environment], chave MemoInQuery

Essas configurações são essenciais para o correto funcionamento do Rateio-por evento em ambientes que utilizam banco de dados PostgreSQL.

03. NOVO CADASTRO DE RATEIO POR EVENTO (CTBA271)

Introdução:
O Cadastro de Rateio por Evento apresenta uma nova funcionalidade que proporciona maior flexibilidade e precisão na gestão de rateios. As regras são criadas com base em um evento de rateio, que permite ter 'n' origens para 'n' destinos.

Para facilitar ainda mais a gestão, oferecemos a funcionalidade de importação de um arquivo .csv, contendo todo o registro de rateio previamente configurado. Essa facilidade permite uma abordagem eficiente para trabalhar com grandes conjuntos de dados de rateio.

03.1. UTILIZANDO O NOVO CAMPO DE EVENTO DE RATEIO

Na rotina de Rateio por Evento introduzimos um novo campo de "Evento de Rateio", utilizando a rotina de Cadastro de Evento - CTBA111 como facilitador para o Cadastro de Rateio por Evento. O funcionamento desse campo é detalhado da seguinte maneira:

1. Acesso à Rotina Cadastro de Evento (CTBA111):

Inicie a rotina CTBA111 para realizar o cadastro.

2. Inclusão de Evento de Rateio:

Ao adicionar um evento de rateio, você encontrará as seguintes opções:

Origem:

Entidades de origem referem-se a lançamentos contábeis considerados para a geração dos rateios.
Campo "Ent. Base": Representa os lançamentos que serão considerados como origem. Por exemplo, ao selecionar 1-Débito, todos os campos relacionados a Débito serão utilizados como origem, como Conta Débito, Centro de Custo Débito, entre outros.

Partida:

Entidades de partida são os lançamentos contábeis contra a origem, considerados para a geração dos rateios.
Campo "Ent. Base": As informações de partida são o oposto da origem. Utilizando o exemplo acima, todos os registros de débito representam a origem, enquanto as informações de crédito representam a partida. Exemplo: Conta Crédito, Centro de Custo Crédito, etc.
Campo "Cód. Rateio": Código do Evento de Rateio que utilizará o Evento de Rateio para Origem e Partida.

Observação:

As informações de Contra-Partida serão informadas no Cadastro de Rateio por Evento (CTBA271).

Essa implementação visa simplificar e otimizar o processo, proporcionando maior controle e eficiência na gestão de eventos de rateio. Certifique-se de seguir essas orientações ao utilizar o novo campo de evento de rateio.

Exemplo de Utilização:

Explicação:

Ent. Base = Débito - Os lançamentos de origem levarão em conta os lançamentos contábeis a débito.

Conta Débito = 1101001 – Conta Contábil que será verificada para rateio.

C Custo Deb = 01001 – Centro de Custo que será verificado para rateio.

Conta Credit = 1110210 – Conta Contábil que será utilizada como Partida nos lançamentos de rateio.

C Custo Crd = CC000008 – Centro de Custo que será utilizado como Partida nos lançamentos de rateio.

03.2. INCLUINDO UMA NOVA REGRA DE RATEIO POR EVENTO

Princípios da funcionalidade

Na rotina Novo Rateio por Evento (CTBA271) estão disponíveis:

- - Dados do cabeçalho: Código do rateio (Automático), Descrição, Tipo (Movimentos Mês ou Saldo Acumulado), Percentual base e Bloqueado;
  - Dados de origem: Entidades contábeis utilizadas na composição do saldo a ser rateado, são preenchidas automaticamente após salvar a regra de rateio.
  - Dados de partida: Entidades contábeis utilizadas na partida do lançamento de rateio que será gerado, são preenchidas automaticamente após salvar a regra de rateio.
  - Dados de destino: Entidades contábeis, percentuais e valores com os quais serão gerados os lançamentos do rateio.

Dados do cabeçalho

Informe a descrição, o tipo da regra (movimento mês ou saldo acumulado), o percentual de base, e o código do evento de rateio.

Itens de Contra-Partida:
Aqui são detalhadas todas as entidades relacionadas às Contra-Partidas que serão geradas no rateio, abrangendo elementos como Conta Contábil, Centro de Custo, e outros similares. Inclua um ou mais itens para continuar.

Caso não seja informado a entidade contábil obrigatória, é exibido uma mensagem de atenção informando ao usuário que estão faltando dados ou existem dados incorretos.

Essas definições proporcionam uma visão abrangente e organizada das informações necessárias ao realizar a inclusão de dados no sistema. Certifique-se de preencher adequadamente cada seção de acordo com as especificações do seu processo contábil.

03.3. IMPORTANDO UM ARQUIVO DE RATEIO

Caso necessário é possível importar um arquivo .csv com todos os dados de rateio. Para isso clique no botão 'Importar Arquivo' e escolha o arquivo a ser importado.

Importante:

É possível gerar um arquivo com múltiplas filiais, porem, para que a rotina faça a importação corretamente o compartilhamento da tabela CTQ deve ser compartilhado a nível de filial.

Para o De/Para ser aplicado nas contas deve-se informar o código da regra de de/para na coluna CTQ_REGRA do arquivo .csv importado.

Em caso de divergência no arquivo, o processo de rateio é acionado, e o botão 'Log' é habilitado, fornecendo detalhes sobre os problemas encontrados.

Acesse o link abaixo para fazer o download de um arquivo .csv de exemplo, seguindo o formato correto que deve ser empregado.

RATEIO-TESTE.csv

03.4. IMPORTANDO ITENS NA TELA DE CONTRA-PARTIDA DO RATEIO

Se necessário, o sistema também oferece a opção de importar itens de Contra-Partida do rateio. Basta clicar na opção 'Importar' e selecionar o arquivo desejado para importação. Em situações em que houver divergências no arquivo, o botão 'Log' será habilitado para fornecer detalhes sobre os problemas identificados. Essa funcionalidade facilita a entrada eficiente de dados, garantindo que eventuais incongruências sejam identificadas e comunicadas de maneira transparente por meio do registro de log.

Acesse o link abaixo para fazer o download de um arquivo .csv de exemplo, seguindo o formato correto que deve ser empregado.

ctba271_Item_Rateio.csv

03.5. APLICANDO UMA REGRA DE DE/PARA NO ITENS DE CONTRA-PARTIDA DO RATEIO

Na tela de Itens de Contra-Partida, você encontrará o botão 'Aplicar-De-Para'. Essa opção valida os cadastros de De/Para armazenados na tabela QLL (veja seção 5 deste manual). Se for identificada uma regra que atenda a uma entidade de origem, uma nova tela será aberta, permitindo que o cliente selecione qual regra de De/Para deseja aplicar.

Essa funcionalidade permite que o cliente crie regras diferentes para correção das entidades contábeis durante o processo de inclusão de uma nova regra de rateio.

No exemplo fornecido, o centro de custo informado no item 004 é 000000003. Para este centro de custo, foi identificada uma regra de De/Para avançada no sistema. De acordo com essa regra, quando os 5 primeiros dígitos da entidade de origem forem "00000", a conta contábil deve ser alterada para "00000000000000000102". Veja mais detalhes deste processo na seção 5 deste manual.

Ao selecionar e aplicar essa regra, o sistema preenche o campo QLL_REGRA com o código da regra de De/Para que será utilizada para conversão da entidade contábil definida.

Essa funcionalidade demonstra como o sistema utiliza as regras cadastradas para efetuar alterações dinâmicas nos dados.

04. PARAMETRIZAÇÃO DA ROTINA DE RATEIO OFF-LINE (CTBA280)

Além dos parâmetros já existentes na rotina, foi adicionado a pergunta 'Evento Rateio'. Quando este campo for preenchido a rotina irá executar todos os códigos de regras de rateio vinculadas a este evento.

Data de Referência - Os lançamentos contábeis de rateio serão gerados com a data que se especifica neste parâmetro.

Grupo de características do lançamento contábil de rateio - Nestes parâmetros o usuário indica as características que os lançamentos de rateio gerados terão.

Número do Lote?

Número do Sub-Lote?

Número do Documento?

Cod. Hist. Padrão? O usuário deve possuir cadastro de histórico padrão como precondição para usar este parâmetro.

Cadastro de Rateios - Permite indicar quais cadastros rateio serão usados.

Do Rateio?| Até o Rateio?

Grupo Moedas

Moedas? (Todas|Específica)
Todas - Os lançamentos contábeis de rateio serão gerados para todas as moedas.
Específica - Os lançamentos contábeis de rateio serão para uma moeda escolhida no parâmetro 'Qual Moeda?'.

Qual Moeda? Moeda para gerar os lançamentos contábeis de rateio caso selecionado o parâmetro anterior Moedas = Específica.

Tipo de Saldo? Tipo de Saldo dos lançamentos contábeis de rateio.

Seleciona Filiais (Sim|Não)

Filial de? | Filial até?

Atualiza Saldo?(No Final | Durante)
No Final.- Realiza o reprocessamento de saldos contábeis (CTBA190) após gerar os lançamentos contábeis de rateio na filial corrente.
Durante.- Atualiza os saldos dos lançamentos contábeis durante o processamento de rateio.

Evento Rateio? (Executa todas as regras de rateio vinculadas ao evento selecionado).

Observações

- A rotina Rateio Off-line (CTBA280) não realiza controle de execuções num período dado. Se o usuário realizar n execuções num período, a rotina gerará os lançamentos de rateios para cada execução.
- Os rateios são realizados pelos saldos da entidade nas tabelas CQ's, não pelo lançamento realizado na CT2.
- Se o cadastro de rateio considerar o 'Tipo = Movimento mês' o rateio será feito sobre o saldo da entidade no mês da data de referência.
- Se a fórmula de rateio considerar o 'Tipo = Saldo acumulado' o rateio será feito sobre o saldo da entidade até o mês da data de referência.

04.1. EXECUTANDO O RATEIO OFF-LINE (CTBA280)

Exemplo:

A pré-condição é a conta de origem possuir saldo nas tabelas CQ's.
Após executados os processos de rateio (CTBA280) serão gerados os lançamentos.

Importante

Em caso de utilização de entidades contábeis que estão configuradas para que seja obrigatório seu uso em conjunto com outras entidades, é importante que o usuário também informe essas entidades no cadastro de rateio para evitar inconsistências ao gerar os lançamentos de rateio na rotina CTBA280.

Exemplo:

Conta contábil configurada para ser utilizada obrigatoriamente com um centro de custo.

Cadastro de rateio off-line com a entidade obrigatória preenchida.

05. CONFIGURANDO REGRAS DE DE/PARA (Opcional)

Este cadastro permite que o cliente configure regras de De/Para de entidades contábeis para que o sistema faça a auto correção das entidades no inclusão de uma nova regra de rateio por evento.

No menu "Regras de De/Para", é possível cadastrar regras que serão aplicadas no processo de Rateio por Evento. Essas regras constituem um cadastro independente do rateio, proporcionando a flexibilidade de utilizar normas específicas conforme os parâmetros fornecidos.

Este cadastro permite associar ou mapear dados de uma origem para um destino específico. Esse tipo de cadastro é útil em diversos contextos para estabelecer correspondências entre diferentes entidades, exemplo: Quando o centro de custo for 123456789, sistema deve alterar a conta contábil para 222333444555. Essas regras podem ser aplicadas nos itens de contrapartida do Rateio por Evento, permitindo estabelecer relações entre diferentes entidades.

05.1. INCLUINDO UMA REGRA DE DE/PARA

Acesse a opção de "Regras de De/Para" no menu lateral esquerdo.

Temos três tipos de regras de De/Para, simples, composta e avançada:

05.1.1. Simples:

A regra simples consiste em definir uma entidade de origem juntamente com seu destino correspondente, ambos possuindo valores fixos.

2. 05.1.2. Composta:
  1. A regra composta oferece a capacidade de configurar distintos intervalos de posições, adaptando-se ao tamanho do campo de entidade escolhida.
  2. A possibilidade de informar uma condição específica pode ser exemplificada da seguinte maneira:
  1. Origem:
  2. Posição: 1;5
  3. Conteúdo: 00000
  4. Nesse contexto, o sistema realizará uma busca na entidade "Centro de Custo" por todos os valores em que os cinco primeiros dígitos começam com "00000". Se apenas um registro atender a essa condição, o sistema indicará que os dados foram validados com sucesso. Entretanto, se houver mais de um registro, uma tela será aberta, permitindo que o cliente decida entre manter todos os registros que atendem à condição ou filtrar um registro específico. Se a opção for "Manter", a regra será aplicada a todos os centros de custo em que os cinco primeiros dígitos começam com "00000". Caso a escolha seja "Escolher Registro", outra tela será disponibilizada para a seleção da entidade desejada, com os dados já filtrados de acordo com o conteúdo informado.

Destino:

1. 1. Posição: 1;3-4;7
  2. Conteúdo: 000-0000
  3. No caso do "Destino", o sistema procurará na entidade "Conta Contábil" por todos os valores em que os três primeiros dígitos começam com "000" e entre o quarto e o sétimo dígito começam com "0000". Se a condição for atendida e houver apenas um registro que satisfaça essa condição, o sistema informará que os dados foram validados com sucesso. Caso mais de um registro seja encontrado, uma tela será aberta, solicitando que o cliente defina uma entidade específica. Nesse caso, é necessário escolher um registro. (Os dados já estarão filtrados de acordo com o conteúdo informado).
  4. É importante destacar que, no "Destino", a entidade deve ser definida corretamente, sendo necessário que o cliente selecione o registro desejado para que o processo de substituição de valor ocorra conforme o esperado.

1. 05.1.3. Avançada:
  1. A regra avançada oferece a capacidade de configurar distintos intervalos de posições na origem, adaptando-se ao tamanho do campo de entidade escolhida. Já no destino pode-se fixar os primeiros dígitos (prefixo) e buscar o restante da entidade (sufixo) através do código de evento selecionado no cadastro da regra de rateio.
  2. A possibilidade de informar uma condição específica pode ser exemplificada da seguinte maneira: