Árvore de páginas


Atenção

Este conjunto de funcionalidades estará disponível a partir do release 12.1.33

01. VISÃO GERAL

Com o objetivo de facilitar a configuração inicial da rotina de conciliação, foi desenvolvido um wizard que auxiliará na adequação das estruturas das tabelas utilizadas nesse processo.

Além disso, esta ferramenta também possibilitará a carga inicial dos novos dados nos registros já gravados do sistema (registros legados), dessa forma, será possível utilizar a rotina de conciliação nos dados antigos do PROTHEUS.



02. PRIMEIROS PASSOS

Para utilizar o wizard de configuração, são necessários alguns pré-requisitos:


01. FONTES COMPILADOS

Arquivos CTBA930.PRW, CTBA930a.PRW, CTBA930b.PRW, CTBA930c.PRW e CTBA930d.PRW compilados no repositório de objetos.



02. DICIONÁRIO DE DADOS


Baixar o pacote de atualização de dicionários necessários para implementação do Conciliador e executar o UPDDISTR. O pacote de dicionário deverá criar em seu banco de dados as tabelas QLB, QLC e QLC, além de incluír os campos CV3_IDORIG e CV3_IDDEST na tabela já existente CV3.





Confira: Atualizador de dicionário e base de dados - UPDDISTR


Atenção

O compartilhamento de tabelas de conciliação (QLC - Cabeçalho de conciliação e QLD - Itens da conciliação) devem ser iguais e compatíveis com a maneira em que se deseja trabalhar as conciliações.

Para conciliar e consultar conciliações de mais de uma filial por vez, as tabelas QLC e QLD deverão estar em modo compartilhado, por padrão, serão criadas em modo exclusivo.



03. DBACCESS E LIB


O Conciliador irá utilizar campos do tipo "Unique Identifier" ou "UUID" para relacionar um registro conciliado a outro em diferentes tabelas, para lidar com esses tipos de campos, são necessárias versões de DBAccess e Lib possam lidar com este tipo de campo.

    • A versão mínima de DBAccess deve ser a versão 21.1.1.8.
      Para conferir a versão de seu DBAccess, acesse o DBMonitor. A versão fica na aba 'Informações'


Para atualizar seu DBAccess confira: DBAccess - Como atualizar o DBAccess


    • A versão mínima de Lib deve ser a versão 20220725.
      Para conferir sua versão de Lib atual, abra o Protheus e acesse o menu Ajuda>Sobre.




03. POSTGRESQL


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


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


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



03. EXECUÇÃO DA ROTINA

Antes de executar o Wizard, ative o parâmetro MV_PRJOVER preenchendo o seu conteúdo com '.T.' nos grupos de empresa que deseja utilizar, conforme o exemplo abaixo.



Com este parâmetro ativado, será possível a inclusão de campos de identificação única nas tabelas que serão conciliadas

Para utilizar o Wizard de Configurações, nos parâmetros iniciais do sistema, deve ser informado o programa inicial: WIZARDUUID.



04. APRESENTAÇÃO


Ao confirmar a tela anterior, será exibida a tela de apresentação do Wizard:

Por motivos de segurança do ambiente, apenas o usuário administrador pode acessa-lo. Após informar a senha, clique em 'Avançar'



Selecione o grupos de empresas que deseja utilizar no processamento e clique em 'Avançar'



05. OPÇÕES NO WIZARD

Após a tela de abertura serão exibidas as opções disponíveis para processamento.

Serão quatro opções para auxiliar a configuração inicial da base de dados para o uso do conciliador.



Siga todas as etapas do Wizard de acordo com a sequência apresentada no momento de implantação, não pule etapas para que não ocorram erros no processo

Siga a sequencia:

1º - Importar configurações de match (QLB)*
2º - Gerar SDF com os campos de ID
3º - Popular os campos de ID
4º - Popular Rastreamento Contábil


Importante*

*Foi implementada uma melhoria que realiza a importação de configurações de Match (QLB) sem que seja necessário utilizar a primeira opção do Wizard. Caso a primeira opção do Wizard esteja desabilitada conforme a imagem abaixo, não é necessário executar o primeiro passo, basta acessar a rotina CTBA940 no menu do Protheus que as configurações de match serão importadas para a tabela QLB, sem que seja necessária a manipulação de arquivos json.


Para que ativar a importação e atualização automática de configurações de match, é necessário ter em seu ambiente o campo QLB_VERSAO e as versões mais atualizadas dos fontes CTBA940 e CTBA940J. Todos estes requisitos já estão contidos nos últimos pacotes de expedição contínua do módulo de Contabilidade Gerencial.



01. IMPORTAR CONFIGURAÇÕES DE MATCH (QLB)


O objetivo da opção "Importar configurações de Match" é preencher a tabela QLB (Configurações de Match) com as regras contidas nos arquivos de configuração ".json".


Lembre-se

Esta opção estará desabilitada caso seu ambiente já possua os pré-requisitos para atualização automática das configurações de conciliação. Caso esta opção esteja desabilitada em seu ambiente, basta acessar o Conciliador Backoffice (CTBA940) por meio do menu do Protheus, no momento de inicialização do Conciliador, as configurações serão incluídas automaticamente, ou atualizadas caso haja necessidade.


Para mais informações, confira:



01. RESUMO

Selecione essa opção para importar para a tabela QLB as configurações de match padrões. Para utilização dessa funcionalidade é necessário ter os arquivos de configuração de conciliação (arquivos .json) para importação. Os arquivos de configuração tc_cfg00xx.json estão contidos nos pacotes de expedição contínua do módulo de Contabilidade Gerencial

Essas configurações são utilizadas pelo conciliador na montagem dinâmica da tela e também no processamento das regras de Match. Com essas configurações carregadas na tabela QLB, será possível utilizar a próxima opção do Wizard que realiza a geração do arquivo SDF.



02. IMPORTANDO CONFIGURAÇÕES

Escolher a opção "Importar configurações de Match (QLB)" e clicar no botão avançar:


Será exibida a tela de apresentação da opção selecionada:



Ao clicar em avançar, o sistema ira abrir uma janela para seleção do diretório.



Certifique-se que os arquivos tc_config estão na pasta selecionada.


Após selecionar, o sistema fará a leitura dos arquivos ".json" contidos na pasta.

Os arquivos encontrados serão apresentados na tela para que usuário escolha as configurações que deseja importar.

Selecione os Arquivos/Empresas que deseja processar e clique em finalizar.


Caso a configuração já exista, o sistema perguntará se o usuário pretende sobrescreve-la:

Confirme a ação clicando em Sim ou Não, de acordo com o desejado.


Após, o término do processamento, o sistema retornará para a tela de opções:


Ao encerrar o Wizard, a mensagem de Processamento Finalizado é exibida, ao confirmar, o wizard retornará para a tela de opções.




02. GERAR SDF COM CAMPOS DE ID


O objetivo da opção Gerar SDF com campos de ID é facilitar a criação dos campos de ID necessários para utilização do conciliador.

01. RESUMO

Esta opção fará a leitura das configurações contidas na tabela QLB e, com as tabelas de origem e destino encontradas, fará a sugestão para criação dos campos XXX_MSUIDT, onde XXX representa o código da tabela utilizada na conciliação.

Esta opção não irá criar os campos no banco, ela ira gerar um arquivo SDF na pasta \systemload\ para posterior execução do UPDDISTR.



02. GERANDO SDF

Escolher a opção "Gerar SDF com campos de ID" e clicar no botão Avançar.


Será exibida a tela de apresentação da opção selecionada:


Ao clicar em avançar, o sistema fará a leitura das tabelas de origem e destino cadastradas da tabela QLB (Configurações de Match). Será sugerida a criação dos campos XXX_MSUIDT dessas tabelas (onde XXX é o código da tabela encontrada).

Os campos já existentes na base de dados ficarão com o STATUS "OK" e não serão exportados para o SDF.

Os campos não encontrados, ficarão com o STATUS "Incluir" e serão exportados para o arquivo SDF.

Campos que serão criados com base nas tabelas encontradas no cadastro da QLB:


Clique em avançar para exportar o arquivo SDF para a pasta systemload:
Caso já exista um arquivo diferencial nessa pasta, o sistema perguntará se deve sobrescrevê-lo.


Exemplo de arquivo criado na pasta systemload.

Evidência do arquivo manifest_update com os detalhes do arquivo SDF gerado pela ferramenta.


Após confirmar a gravação do arquivo, o Wizard exibe a mensagem de SDF exportado com sucesso:

Clicando no botão finalizar desta opção, o sistema pergunta se deseja executar o UPDDISTR para criação dos campos:


Se clicar em Sim, o sistema redirecionará para execução do UPDDISTR

Se clicar em Não, o sistema finalizará esta etapa.



Ao finalizar esta etapa do Wizard, a mensagem de Processamento Finalizado é exibida:





03. POPULAR OS CAMPOS DE ID


O objetivo da opção Popular os campos de ID é preencher o código de ID único nos registros já gravados do sistema.

01. RESUMO

O objetivo da opção Popular os campos de ID é preencher o código de ID único nos registros já existentes do sistema. Essa opção é importante para que seja possível a utilização do conciliador nos registros do legado. 

Como os campos são novos, no momento da instalação/configuração da rotina eles estarão sem conteúdo.


02. PREENCHENDO OS IDS

Escolher a opção Popular os campos de ID e clicar no botão Avançar:


Será exibida a tela de apresentação da opção selecionada. No caso desta opção, será exibido um range de datas. 

Esse range representa o período retroativo que se deseja gravar os códigos de ID nos campos XXX_MSUIDT




Atenção

É importante selecionar somente o intervalo que se deseja trabalhar. 

Aconselhamos verificar com cautela essa informação, pois o tempo de processamento dessa rotina é proporcional ao tamanho do período escolhido.


Após clicar em avançar, o sistema exibira a tela com os campos que serão gravados "XXX_MSUIDT".

Além disso, também serão exibidos os campos que serão utilizados na comparação do range de datas para filtrar os registros.


Os campos utilizados para fazer o filtro podem ser editados pelo usuário.

Clicando duas vezes em cima do campo é exibida uma tela com os campos data disponíveis para alteração.


Após a confirmação das tabelas selecionadas, o wizard realizará a gravação dos campos de ID

Campos gravados após processamento da rotina:


Após o processamento da opção, a mensagem de Processamento Finalizado é exibida.

Ao confirmar, o wizard retornará ao menu de opções.





04. POPULAR RASTREAMENTO CONTABIL


A última opção do Wizard é específica para o módulo contábil e não seria possível conciliar os dados contábeis do legado sem esse tratamento.

01. RESUMO

O objetivo da opção Popular Rastreamento Contábil é ser um facilitador da conciliação dos registros já gravados do rastreamento contábil (Tabela CV3), com os códigos UUID. Com este facilitador será possível que os registros do legado sejam conciliados de forma automática, sem a necessidade de conciliações manuais.

Neste passo, os registros das tabelas de origem e de destino (SE1 e CT2, por exemplo) já devem possuir os códigos MSUIDT preenchidos nos registros. O sistema fará a leitura da tabela de rastreamento contábil (CV3) e gravará nos campos CV3_IDORIG e CV3_IDDEST os ID's dos registros de origem e destino (SE1 e CT2, por exemplo). Como os campos são novos, no momento da instalação/configuração da rotina eles estarão em branco.

Dessa forma, será possível fazer a ligação entre a tabela de lançamentos contábeis com as tabelas dos módulos de origem.

Para este rastreamento, a busca de dados será feita conforme o Tracker Contábil do Protheus. Para identificar o registro de origem e o destino serão tomados como base os campos CV3_RECORI e CV3_RECDES que guardam os RECNOS (Posição do(s) registros nas tabelas do Protheus) dos registros que contidos nas tabelas de origem e na tabela de contabilização (CT2 - Lançamentos contábeis), sendo assim, uma premissa para realizar o rastreamento contábil por meio deste facilitador dos campos, é que os campos que guardam os RECNOs estejam integros e reflitam a realidade das tabelas de origem e a tabela CT2



02. POPULANDO RASTREAMENTO CONTÁBIL

Escolher a opção Popular Rastreamento Contábil:


Será exibida a tela de apresentação da opção selecionada.

No caso desta opção, será exibido um range de datas. 

Esse range representa o período retroativo que se deseja gravar os códigos de ID nos campos da tabela CV3-Rastreamento Contábil.


Atenção

É importante selecionar somente o intervalo que se deseja trabalhar. 

Aconselhamos verificar com cautela essa informação, pois o tempo de processamento dessa rotina é proporcional ao tamanho do período escolhido.


Após clicar em avançar, o sistema exibirá os campos "XXX_MSUIDT" das tabelas que possuem configurações de match cadastradas com a tabela de lançamentos contábeis CT2.

Selecione os tabelas/Empresas que deseja processar e clique em Finalizar.





Após selecionar as tabelas/empresas, será exibida uma mensagem de confirmação informando como será realizado o preenchimento do rastreamento contábil.


Para continuar basta apenas confirmar.



O sistema fará a gravação dos campos CV3_IDORIG com os dados da tabela de origem (SE1, por exemplo) e CV3_IDDEST com os dados da tabela de destino CT2 - Lançamentos contábeis.

Após o processamento da opção, a mensagem de Processamento Finalizado é exibida:


Ao finalizar o wizard retorna ao menu de opções.



03. COMO FUNCIONA A BUSCA DE REGISTROS ENTRE AS TABELAS? (EXEMPLO DE RASTREAMENTO)


Para exemplificar, serão utilizados estes dois registros abaixo na tabela CV3.
São dois registros de contabilização (uma partida a débito e uma partida a crédito) de um titulo a receber (SE1), ou seja, 1 registro na tabela SE1 para 2 registros na tabela CT2.
Como pode ser visto, ambos estão com os campos CV3_IDORIG e CV3_IDDEST em branco.



Para encontrar o registro de origem, o wizard ira procurar na tabela contida no campo CV3_TABORI, os registros com que possuem os R_E_C_N_Os contidos nos campos CV3_RECORI.
No exemplo, na tabela SE1 será procurado o registro de R_E_C_N_O 10903.

Para encontrar os registros de contabilização, o wizard ira procurar na tabela CT2 os registros que possuem os R_E_C_N_Os contidos nos campos CV3_RECDES.
No exemplo, será procurado os registros de R_E_C_N_Os 25709 e 25714.




Encontrando o registro na origem, é possível ver que o título a receber já possui seu código de identificação única no campo E1_MSUIDT.



O mesmo ocorre com os registros na CT2_MSUIDT.

Sendo possível encontrar os registros de origem e destino da contabilização, utilizando o facilitador de Rastreamento contábil do WIZARDUUID, o sistema poderá rastrear de forma correta e gravar na tabela CV3 os campos de ID de origem e ID de destino.

Executando o rastreamento contábil no Wizard:


Após execução do WIZARDUUID, os campos CV3_IDORIG e CV3_IDDEST já estarão devidamente preenchidos com os identificadores de suas respectivas tabelas.


No conciliador, os registros já podem ser conciliados de forma automatica.






Após executar as 4 etapas do wizard de configuração inicial, seu ambiente esta preparado para a utilização do Conciliador. Confira a documentação:

Conciliador Backoffice - CTBA940 - P12 - Contabilidade Gerencial


06. INFORMAÇÕES RELACIONADAS