Manual Módulo MetaDados (Contabilização) 03/05/2014 MetaDados Sumário 1. Visão Geral da Solução............................................................................................................................................................ 3 1.1. Pré-requisito ............................................................................................................................................................................. 4 1.1.1. Novos Módulos, Documentos, Transações, Funções e Relatórios no Módulo de Segurança ................................................. 4 1.1.2. Acesso dos Perfis aos Documentos, Transações, Funções e Relatórios no Módulo de Segurança ..................................... 10 1.1.3. SGBD Oracle ou Microsoft SQL Server 2005 ou Posterior .................................................................................................... 14 1.1.4. Nova Seção [METADADOS] nos Arquivos de Inicialização ................................................................................................... 14 1.1.5. Novas Variáveis “CTB_BD_METADADOS”, “CTB_GERAR_ARQS_AUX” e “CTB_GERAR_ARQS_ITF” ............................ 16 2. Como Utilizar esta Solução .................................................................................................................................................... 17 2.1. Configuração Necessárias ..................................................................................................................................................... 17 2.1.1. Configurar as novas Variáveis no Módulo de Contabilidade .................................................................................................. 18 2.1.2. Reconfigurar o Layout das Interfaces Integradas no Módulo de Contabilidade ..................................................................... 20 2.2. Passo a Passo ....................................................................................................................................................................... 21 2.2.1. Gerar as Informações para Contabilização nos Módulos Legados ........................................................................................ 21 2.2.2. Gerar os Relatórios de Contabilização no Módulo MetaDados .............................................................................................. 28 2.2.3. Integrar as Informações de Contabilização no Módulo de Contabilidade .............................................................................. 33 2.2.4. Gerar os Relatórios de Contabilização no Módulo de Contabilidade ..................................................................................... 35 2.2.5. Consultar a Origem dos Lançamentos Contábeis no Módulo de Contabilidade (Rastreabilidade) ........................................ 37 2.3. Dicas de Produtividade .......................................................................................................................................................... 44 2.3.1. Variáveis CTB_GERAR_ARQS_AUX e CTB_GERAR_ARQS_ITF ....................................................................................... 44 2.3.2. Esquemas Contábeis com Lançamentos Sintéticos no Módulo Parâmetros ......................................................................... 45 2.3.3. Interfaces com Layout “Banco de Dados METADADOS” no Módulo de Contabilidade ......................................................... 49 2.3.4. Gerar Informações de Contabilização Analíticas no Módulo de Contas Correntes ................................................................ 49 2.3.5 Gerar a Contabilização Selecionando a Opção “Gerar Relatórios” no Módulo de Contas Correntes .................................... 51 2 Versão 1.0 MetaDados 1. Visão Geral da Solução O novo Módulo MetaDados e sua base de dados foram desenvolvidos para agregar melhorias no Módulo de Contabilidade e nos demais módulos legados da Totvs Financial Services – Core Banking que utilizam a Rotina de Contabilização padrão, também conhecida pelo seu nome técnico, a “TBARQS”, como é o caso dos módulos de Contas Correntes, CrediMaster, Depósitos à Prazo, Rating e Parâmetros. As melhorias agregadas por este novo módulo são as seguintes: Melhora substancial na performance de execução da Rotina de Contabilização padrão, principalmente quando executada com elevados volumes de operações diárias de contabilização; Permitir que os relatórios de contabilização “Razão Auxiliar”, “Boletim de Contabilização (Slips)”, “Extrato de Contas Controladas” e “Resumo dos Esquemas não Processados”, antes gerados compulsoriamente em arquivos e apenas durante a execução da Rotina de Contabilização padrão, possam passar a ser gerados a qualquer tempo pelos usuários, seja através da interface WEB do novo Módulo MetaDados, antes mesmo das informações terem sido integradas no Módulo de Contabilidade da Totvs Financial Services – Core Banking, ou então, após as informações já terem sido integradas, através das novas funcionalidades de relatórios que passaram a estar disponíveis neste módulo, com base nas informações mantidas na base de dados do novo Módulo MetaDados; Proporcionar a rastreabilidade entre os lançamentos contábeis gerados pela Rotina de Contabilização padrão e os respectivos fatos geradores (operações de origem) nos módulos legados da Totvs Financial Services – Core Banking, através de uma nova funcionalidade de consulta que foi disponibilizada na tela de manutenção dos lançamentos do Módulo de Contabilidade da Totvs Financial Services – Core Banking que, além da consulta, também permite a exportação das informações em planilhas; Permitir que quaisquer módulos legados, desde já, possam vir a gerar as informações de contabilização exclusivamente em banco de dados, no layout MetaDados (não posicional), ao invés de gera-las em arquivos de contabilização, melhorando a segurança pela restrição do acesso a estas informações aos perfis de acesso que estiverem devidamente autorizados no Módulo de Segurança da Totvs Financial Services – Core Banking e proporcionando uma melhoria de performance ainda mais significativa durante a geração das informações de contabilização. Os módulos que geram um elevado volume diário de operações de contabilização, como por exemplo, o Módulo de Cartões e o Módulo CrediMaster, são fortes candidatos a serem customizados em breve, para passarem a gerar as suas informações de contabilização diretamente na base de dados do Módulo MetaDados; Permitir que a Rotina de Contabilização padrão, desde já, passe a armazenar as informações geradas para contabilização no Módulo de Contabilidade da Totvs Financial Services – Core Banking, processadas segundo as configurações dos Esquemas Contábeis, exclusivamente em banco de dados ao invés de arquivos de contabilização no layout padrão ITMC (posicional) ou em algum outro layout específico, melhorando a segurança pela restrição do acesso a estas informações aos perfis de acesso que estiverem devidamente autorizados no Módulo de Segurança da Totvs Financial Services – Core Banking; Os módulos de Open e SPB utilizam uma Rotina de Contabilização específica ao invés da Rotina de Contabilização padrão (TBARQS) e, uma vez que as melhorias citadas inicialmente foram agregadas somente na Rotina de Contabilização padrão, neste momento somente os módulos legados da Totvs Financial Services – Core Banking que já utilizam a Rotina de Contabilização padrão é que se beneficiaram destas melhorias. Os módulos que utilizam uma Rotina de Contabilização específica gradualmente passarão a ter estas melhorias também, seja pela incorporação destas melhorias nas respectivas Rotinas de Contabilização específicas ou pela adoção da Rotina de Contabilização padrão por estes módulos, em substituição às respectivas Rotinas de Contabilização específicas, segundo uma avaliação técnica que determinará a melhor abordagem em cada caso. Os módulos com interface 100% WEB, como é o caso, por exemplo, do Módulo de Cartões e do Módulo IFRS, não executam a Rotina de Contabilização (TBARQS), nem a rotina padrão e nem uma rotina específica. Estes módulos apenas geram arquivos de contabilização no layout MetaDados (não posicional), mas sem submetê-los à execução pela Rotina de Contabilização. Estes arquivos gerados, por sua vez, são submetidos à Rotina de Contabilização padrão (TBARQS) somente quando a integração Versão 1.0 3 MetaDados contábil destes módulos WEB é executada através do Módulo de Contabilidade da Totvs Financial Services – Core Banking. Com isto, os módulos com interface 100% WEB também se beneficiarão das melhorias agregadas pelo novo Módulo MetaDados, uma vez que os seus arquivos de contabilização serão processados pela Rotina de Contabilização padrão (TBARQS), no Módulo de Contabilidade da Totvs Financial Services – Core Banking. 1.1. Pré-requisitos 1.1.1. Novos Módulos, Documentos, Transações, Funções e Relatórios no Módulo de Segurança Para ter acesso às NOVAS transações, será necessário habilita-las no Sistema de Segurança, conforme segue. O procedimento de instalação/disponibilização do novo Módulo MetaDados, a ser realizado pela área de TI/Infra, já contempla as configurações necessárias no Módulo de Segurança para que o novo módulo possa ser utilizado pelos usuários. Desta forma, os procedimentos descritos a seguir somente deverão ser executados caso a área de TI/Infra ainda não tenha feito isto através dos scripts de instalação do novo módulo. No Módulo de Segurança, o novo Módulo MetaDados deverá ser configurado na aba “Sistemas” da tela acessada através do ícone com a mesma descrição, conforme a figura seguinte. O novo módulo deverá ser cadastrado obrigatoriamente com a sigla “MD”, o nome “MetaDados”, tipo de sistema “Interno”, acesso web obrigatoriamente selecionado e acesso usuário SuperUser podendo estar selecionado ou não, de acordo com a política de segurança de cada instituição. Figura 1 – Sistema Segurança 4 Versão 1.0 MetaDados Após o novo Módulo MetaDados (sigla MD) ter sido cadastrado, deverá ser cadastrado um novo Documento para ele, com a Sigla “IMPR”, Nome igual a “Impressão” e Ordem igual a “1”, conforme a figura a seguinte. Figura 2 – Sistema Segurança Após o Documento “Impressão” ter sido cadastrado, deverá ser cadastrada uma nova Transação para ele, com a Sigla “RELA”, Nome igual a “Relatórios” e Ordem igual a “1”, conforme a figura a seguinte. Versão 1.0 5 MetaDados Figura 3 – Sistema Segurança Ainda no Módulo de Segurança, os quatro novos relatórios deverão ser cadastrados para o Módulo MetaDados na aba “Relatórios” da tela acessada através do ícone com a mesma descrição, com as siglas e nomes de acordo com a tabela e as figuras seguintes: Sigla REL_BOL_CTB REL_EXT_CTA_CTR REL_RAZ_AUX REL_RES_ESQ_PRC Nome Objeto Seleção Boletim de Contabilização (Slips) Extrato de Contas Controladas Razão Auxiliar Resumo dos Esquemas não Processados 6 Versão 1.0 MetaDados Figura 4 – Cadastramento de Relatórios Figura 5 – Cadastramento de Relatórios Versão 1.0 7 MetaDados Figura 6 - Cadastramento de Relatórios Figura 7 - Cadastramento de Relatórios 8 Versão 1.0 MetaDados 1.1.2 Acesso dos Perfis aos Documentos, Transações, Funções e Relatórios no Módulo de Segurança Para que o usuário possa utilizar esta solução, o perfil do mesmo deverá ter acesso aos seguintes documentos, transações, funções e relatórios dos módulos a seguir. Módulo MetaDados (sigla MD): Siglas e descrições padrões no módulo de Segurança Breve descrição Documento/Relatório Transação Função IMPR RELA -xImpressão de Relatórios: utilizar para pesquisar por Impressão Relatórios Módulo e Data as informações geradas para contabilização, em formato MetaDados, e selecionálas para serem consideradas na geração dos novos relatórios deste módulo. REL_BOL_CTB Relatório Boletim de Contabilização (Slips): utilizar Boletim de Contabilização (Slips) para visualizar sinteticamente os lançamentos contábeis gerados para a interface em questão por Esquema Contábil, de acordo com a Carteira, Subcarteira, Operação, Liquidez, Tipo de Correção e Tipo de Conteúdo dos registros de origem. REL_EXT_CTA_CTR Relatório Extrato de Contas Controladas: utilizar para Extrato de Contas Controladas visualizar os lançamentos contábeis gerados para a interface em questão por Conta Contábil controlada, de acordo com a configuração “Emitir Razonete dos Lançamentos” dos Registros dos Esquemas Contábeis. REL_RAZ_AUX Relatório Razão Auxiliar: utilizar para visualizar Razão Auxiliar analiticamente os lançamentos contábeis gerados para a interface em questão por Esquema Contábil, de acordo com a Carteira, Subcarteira, Operação, Liquidez, Tipo de Correção e Tipo de Conteúdo dos registros de origem. REL_RES_ESQ_PRC Relatório Resumo dos Esquemas não Processados: Resumo dos Esquemas não Processados utilizar para visualizar um sumário das quantidades de registros de origem que não foram considerados no processamento da contabilização, agrupadas pelo motivo pelo qual o processamento dos mesmos não foi possível. Versão 1.0 9 Funcionalidade NOVA/Alterada NOVA NOVA NOVA NOVA NOVA MetaDados Módulo Contabilidade (sigla MC): Siglas e descrições padrões no módulo de Segurança Documento Transação Função CFGE EMPR ALTR – Configurar Empresa Alterar Empresa SAVE – Salvar INTG INT2 Integração Contábil Configuração INTG INT1 Integração Contábil Integração LCTO Lançamentos LCTO Lançamentos ALTR Alterar RETR Buscar SAVE Salvar EXCL Integrar RETR Buscar -x- – – – – – Breve descrição Configuração de Variáveis Internas: utilizar para configurar as novas variáveis URL_METADADOS e HTTP_RECEIVE_TIMEOUT, necessárias para permitir o acesso aos relatórios do novo Módulo MetaDados diretamente a partir do Módulo de Contabilidade. Configuração da Integração Contábil: utilizar para alterar a configuração do layout de origem de cada interface de integração que for gerada pela Rotina de Contabilização padrão (de “Padrão TotalBanco” para “Banco de Dados METADADOS”). Integração Contábil: utilizar para executar a Rotina de Contabilização padrão, integrar as informações contábeis geradas pelos módulos legados de origem e, depois de realizada a integração, consultar os relatórios “Razão Auxiliar”, “Boletim de Contabilização (Slips)”, “Extrato de Contas Controladas” e “Resumo dos Esquemas não Processados” do novo Módulo MetaDados, diretamente na tela de Integração, sem necessidade de acessar o novo módulo. Consulta e Manutenção de Lançamentos: utilizar para consultar o detalhamento da origem (Fato Gerador) de cada um dos Lançamentos de um Lote Contábil gerado a partir da Integração Contábil (Rastreabilidade). 10 Funcionalidade NOVA/Alterada Alterada Alterada Alterada Alterada Versão 1.0 MetaDados Módulo Parâmetros (sigla TA): Siglas e descrições padrões no módulo de Segurança Documento Transação Função CTBL CTBE SAVE Tabelas de Contabilização Executar Contabilização Breve descrição Funcionalidade NOVA/Alterada Contabilização de Arquivos MetaDados: utilizar para Alterada executar a Rotina de Contabilização padrão, considerando as informações contidas em qualquer arquivo no layout MetaDados (não posicional), apenas com a finalidade de homologação de alterações nas configurações dos Esquemas Contábeis do módulo através do qual o arquivo em questão foi gerado. Após a execução desta transação, que passará a gerar as informações de contabilização diretamente na base de dados do Módulo MetaDados, os relatórios de contabilização “Razão Auxiliar”, “Boletim de Contabilização (Slips)”, “Extrato de Contas Controladas” e “Resumo dos Esquemas não Processados” poderão ser gerados a partir do novo Módulo MetaDados, antes mesmo da execução, no Módulo de Contabilidade, da integração dos lançamentos gerados. Módulo Contas Correntes (sigla CC): Siglas e descrições padrões no módulo de Segurança Documento Transação Função CNTB CNTB SAVE Rotinas Especiais Contabilidade Iniciar – Contabilidade Versão 1.0 Breve descrição Funcionalidade NOVA/Alterada Geração da Contabilização: utilizar para gerar a Alterada contabilização de Contas Correntes e executar a Rotina de Contabilização padrão para o arquivo gerado no layout MetaDados (não posicional). Após a execução desta transação, que passará a gerar as informações de contabilização diretamente na base de dados do Módulo MetaDados, os relatórios de contabilização “Razão Auxiliar”, “Boletim de Contabilização (Slips)”, “Extrato de Contas Controladas” e “Resumo dos Esquemas não Processados” poderão ser gerados a partir do novo Módulo MetaDados, antes mesmo da execução, no Módulo de Contabilidade, da integração dos lançamentos gerados. 11 MetaDados Módulo CrediMaster (sigla CF): Siglas e descrições padrões no módulo de Segurança Documento Transação Função PROC INSA -xProcessamento Interfaces Saída Breve descrição Funcionalidade NOVA/Alterada Geração da Contabilização: utilizar para gerar a Alterada contabilização do Credimaster e executar a Rotina de Contabilização padrão para o arquivo gerado no layout MetaDados (não posicional). Após a execução desta transação, que passará a gerar as informações de contabilização diretamente na base de dados do Módulo MetaDados, os relatórios de contabilização “Razão Auxiliar”, “Boletim de Contabilização (Slips)”, “Extrato de Contas Controladas” e “Resumo dos Esquemas não Processados” poderão ser gerados a partir do novo Módulo MetaDados, antes mesmo da execução, no Módulo de Contabilidade, da integração dos lançamentos gerados. Módulo Depósitos à Prazo (sigla DP): Siglas e descrições padrões no módulo de Segurança Documento Transação Função PROC ABRT – Abertura - x Processamento FECH – Fechamento REEX – Reexecução Breve descrição Funcionalidade NOVA/Alterada Geração da Contabilização: utilizar as rotinas de Alterada Abertura, Fechamento ou Reexecução (Contabilização) para gerar a contabilização dos Depósitos à Prazo e executar a Rotina de Contabilização padrão para o arquivo gerado no layout MetaDados (não posicional). Após a execução de uma destas três transações, que passará a gerar as informações de contabilização diretamente na base de dados do Módulo MetaDados, os relatórios de contabilização “Razão Auxiliar”, “Boletim de Contabilização (Slips)”, “Extrato de Contas Controladas” e “Resumo dos Esquemas não Processados” poderão ser gerados a partir do novo Módulo MetaDados, antes mesmo da execução, no Módulo de Contabilidade, da integração dos lançamentos gerados. 12 Versão 1.0 MetaDados Módulo Rating (sigla RT): Siglas e descrições padrões no módulo de Segurança Documento Transação Função RATI PROC EXCL Classificação Processamento Contabilizar (Rating) Breve descrição Funcionalidade NOVA/Alterada Geração da Contabilização: utilizar para gerar a Alterada contabilização do Rating e executar a Rotina de Contabilização padrão para o arquivo gerado no layout MetaDados (não posicional). Após a execução desta transação, que passará a gerar as informações de contabilização diretamente na base de dados do Módulo MetaDados, os relatórios de contabilização “Razão Auxiliar”, “Boletim de Contabilização (Slips)”, “Extrato de Contas Controladas” e “Resumo dos Esquemas não Processados” poderão ser gerados a partir do novo Módulo MetaDados, antes mesmo da execução, no Módulo de Contabilidade, da integração dos lançamentos gerados. ATENÇÃO: dependendo dos módulos incluídos no contrato de fornecimento de software celebrado com a TOTVS, o cliente poderá não ter acesso à parte dos módulos ou transações citados acima, ou mesmo a nenhum deles. Este documento, portanto, não representa, de modo algum, compromisso da TOTVS em disponibilizar todos módulos e transações citados. Para usufruir desta solução, também serão necessários os requisitos técnicos adicionais a seguir. 1.1.3. SGBD Oracle ou Microsoft SQL Server 2005 ou Posterior O novo Módulo MetaDados, as melhorias agregadas ao Módulo de Contabilidade e aos demais módulos legados da Totvs Financial Services – Core Banking que utilizam a Rotina de Contabilização padrão (TBARQS), como é o caso dos módulos de Contas Correntes, CrediMaster, Depósitos à Prazo, Rating e Parâmetros, são compatíveis somente com o SGBD Oracle e com o SGBD Microsoft SQL Server versão 2005 ou posterior. Portanto, NÃO são compatíveis e, desta forma, não podem ser disponibilizados em ambientes que utilizam o SGBD Sybase ou versões do Microsoft SQL Server anteriores à versão 2005. 1.1.4. Nova Seção [METADADOS] nos Arquivos de Inicialização A Rotina de Contabilização padrão (TBARQS) que é utilizada pelos módulos de Contas Correntes, Contabilidade, CrediMaster, Depósitos à Prazo, Rating e Parâmetros, passará a processar e gerar informações de contabilização diretamente na base de dados do novo Módulo MetaDados. Por isto, será necessário acrescentar uma nova seção, chamada [METADADOS], nos respectivos arquivos de inicialização (.INI) destes módulos, conforme descrito a seguir. Os nomes dos arquivos de inicialização citados a seguir são os nomes padrão, mas podem variar de acordo com a instalação de cada módulo em cada instituição usuária. Versão 1.0 13 MetaDados Módulo Contas Correntes Contabilidade CrediMaster Depósitos à Prazo Rating Parâmetros Arquivo de Inicialização (Nome padrão) CcorSrv.ini Contabil.ini CrediMaster_srv.ini Deprazo.ini Rating_srv.ini Tabelas.ini Se a base de dados do novo Módulo MetaDados estiver em um SGBD Microsoft SQL Server 2005 ou superior, a nova seção [METADADOS] deverá ser acrescentada nos arquivos de inicialização citados anteriormente de acordo com o modelo a seguir: [METADADOS] DBMS=MSS SQL Server ServerName=NOME_SERVIDOR_SQLSERVER Database=NOME_BD_METADADOS LogId=LOGIN_SQLSERVER LogPass=SENHA_SQLSERVER CRYPT=N Se a base de dados do novo Módulo MetaDados estiver em um SGBD Oracle, a nova seção [METADADOS] deverá ser acrescentada nos arquivos de inicialização citados anteriormente de acordo com o modelo a seguir: [METADADOS] DBMS=O90 ServerName=NOME_SERVIDOR_ORACLE LogId=LOGIN_BD_METADADOS LogPass=SENHA_BD_METADADOS DBParm=DecimalSeparator=',',DisableBind=1,DelimitIdentifier='No', CommitOnDisconnect='No' CRYPT=N Por utilizarem uma Rotina de Contabilização específica ao invés da Rotina de Contabilização padrão (TBARQS), os módulos de Open e SPB, neste momento, não precisarão ter a nova seção [METADADOS] acrescentada aos seus respectivos arquivos de inicialização (.INI), pois as suas Rotinas de Contabilização específicas ainda NÃO acessam a base de dados do novo Módulo MetaDados. Somente à medida que estes módulos passarem a adotar a Rotina de Contabilização padrão ou que as suas Rotinas de Contabilização específicas tiverem incorporadas as melhorias agregadas pelo novo Módulo MetaDados é que a seção [METADADOS] precisará ser efetivamente incluída também nos arquivos de inicialização (.INI) destes módulos. No entanto, é possível incluir desde já a seção [METADADOS] nos arquivos de inicialização destes módulos e, neste caso, nenhum erro será gerado pelos mesmos uma vez que, por enquanto, esta seção sequer será considerada pelas suas Rotinas de Contabilização específicas. 1.1.5. Novas Variáveis “CTB_GERAR_ARQS_ITF” “CTB_BD_METADADOS”, “CTB_GERAR_ARQS_AUX” e O procedimento de instalação/disponibilização do novo Módulo MetaDados, a ser realizado pela área de TI/Infra, já contempla a realização das configurações padrão das variáveis CTB_BD_METADADOS, CTB_GERAR_ARQS_AUX e CTB_GERAR_ARQS_ITF, na tabela t400vars do esquema de banco de dados BASICO, necessárias para que as melhorias do 14 Versão 1.0 MetaDados novo módulo sejam ativadas e efetivamente utilizadas pela Rotina de Contabilização padrão (TBARQS). Desta forma, os procedimentos descritos a seguir somente deverão ser executados caso a área de TI/Infra ainda não tenha feito isto através dos scripts de instalação do novo módulo ou no caso da configuração padrão de alguma destas variáveis precisar ser alterada para atender a necessidades específicas de cada instituição usuária dos módulos da Totvs Financial Services – Core Banking. A configuração da variável CTB_BD_METADADOS indica se a base de dados do novo Módulo MetaDados deverá ser utilizada pela Rotina de Contabilização padrão (TBARQS), ou seja, se está disponível e deve ser utilizado o novo módulo e as melhorias que o mesmo agrega aos demais módulos. Enquanto o novo Módulo MetaDados e sua base de dados não estiverem devidamente instalados, é esperado que esta variável não esteja configurada ou então que esteja configurada com “N”, correspondente a NÃO, indicando que a base de dados do Módulo MetaDados NÃO está disponível e/ou NÃO deverá ser utilizada pela Rotina de Contabilização padrão. Após o novo Módulo MetaDados e sua base de dados estarem devidamente instalados, é recomendado que esta variável seja configurada com “S”, correspondente a SIM, indicando que a base de dados do Módulo MetaDados está disponível e deverá ser utilizada pela rotina. Para alterar a configuração desta variável, o seguinte comando SQL deverá ser executado na tabela t400vars do banco de dados BASICO: update t400vars set vr_vrv = 'S' -- 'S' = Sim e 'N' = Não where nm_vrv = 'CTB_BD_METADADOS' A configuração da variável CTB_GERAR_ARQS_AUX indica se a Rotina de Contabilização padrão (TBARQS) deverá ou não gerar os arquivos auxiliares dos relatórios de contabilização que, por sua vez, tornaram-se obsoletos e serão descontinuados em breve porque passaram a estar disponíveis para geração a qualquer tempo, através do novo Módulo MetaDados. Enquanto o novo Módulo MetaDados e sua base de dados não estiverem devidamente instalados, é esperado que esta variável não esteja configurada ou então que esteja configurada com “S”, correspondente a SIM, indicando que a Rotina de Contabilização padrão deverá gerar os arquivos auxiliares dos relatórios de contabilização. Após o novo Módulo MetaDados e sua base de dados estarem devidamente instalados, é recomendado que esta variável seja configurada com “N”, correspondente a NÃO, indicando que a Rotina de Contabilização padrão NÃO deverá gerar os arquivos auxiliares dos relatórios de contabilização, uma vez que os mesmos estarão disponíveis para geração através do novo módulo. Para alterar a configuração desta variável, o seguinte comando SQL deverá ser executado na tabela t400vars do banco de dados BASICO: update t400vars set vr_vrv = 'S' -- 'S' = Sim e 'N' = Não where nm_vrv = 'CTB_GERAR_ARQS_AUX' A configuração da variável CTB_GERAR_ARQS_ITF indica se a Rotina de Contabilização padrão (TBARQS) deverá ou não gerar os arquivos de interface de contabilização, seja no layout padrão ITMC (posicional), utilizado para integração dos lançamentos no Módulo de Contabilidade da Totvs Financial Services – Core Banking, ou em outro layout específico pré-definido, utilizado para integração dos lançamentos gerados pela rotina em sistemas de contabilidade de outros fornecedores. Nos casos em que o Módulo de Contabilidade da Totvs Financial Services – Core Banking fizer parte da solução que está sendo utilizada, o novo Módulo MetaDados torna desnecessária a geração de arquivos de interface de contabilização no layout padrão ITMC, uma vez que, neste caso, os lançamentos sempre serão gerados pela Rotina de Contabilização padrão diretamente na base de dados do novo módulo, local a partir do qual o Módulo de Contabilidade da Totvs Financial Services – Core Banking poderá passar a integrar os lançamentos. No entanto, nos casos em que um sistema de contabilidade de outro fornecedor fizer parte da solução, a geração de arquivos de interface de contabilização no layout específico do fornecedor permanecerá sendo necessária mesmo com a utilização do novo Módulo MetaDados, pois é somente através do arquivo de interface de contabilização gerado no layout específico que os lançamentos poderão ser integrados no sistema de contabilidade de outros fornecedores. Desta forma, enquanto o novo Módulo MetaDados e sua base de dados não estiverem devidamente instalados, é recomendado que a variável CTB_GERAR_ARQS_ITF não esteja configurada ou então que esteja configurada com “S”, correspondente a SIM, indicando que a Rotina de Contabilização padrão deverá gerar os arquivos de interface de contabilização. Após o novo Módulo MetaDados e sua base de dados estarem devidamente instalados, se o Módulo de Contabilidade da Totvs Financial Services – Core Banking fizer parte da solução que está sendo utilizada, é recomendado que esta variável seja configurada com “N”, correspondente a NÃO, indicando que a Rotina de Contabilização padrão NÃO deverá gerar os arquivos de interface de Versão 1.0 15 MetaDados contabilização no layout padrão ITMC, pois o Módulo de Contabilidade poderá integrar os lançamentos diretamente a partir da base de dados do novo Módulo MetaDados. Após o novo Módulo MetaDados e sua base de dados estarem devidamente instalados e se, por outro lado, o sistema de contabilidade de outro fornecedor fizer parte da solução que está sendo utilizada, é recomendado que esta variável seja configurada com “S”, correspondente a SIM, indicando que a Rotina de Contabilização padrão deverá gerar os arquivos de interface de contabilização no layout específico pré-definido, de forma que os lançamentos gerados pela rotina possam ser integrados em sistemas de contabilidade de outros fornecedores. Para alterar a configuração desta variável, o seguinte comando SQL deverá ser executado na tabela t400vars do banco de dados BASICO: update t400vars set vr_vrv = 'S' -- 'S' = Sim e 'N' = Não where nm_vrv = 'CTB_GERAR_ARQS_ITF' 2. Como Utilizar esta Solução Esta seção descreve de que maneira o usuário poderá utilizar esta solução de modo eficaz. Siga os passos indicados para usufruir plenamente desta facilidade fornecida pela TOTVS. De fato, normalmente, para que uma solução possa funcionar plenamente, são necessárias algumas configurações. Estas configurações estão descritas no item “Configurações Necessárias”. Uma vez que as configurações necessárias foram feitas da maneira correta, o item “Passo a Passo” descreve como, efetivamente, utilizar a solução, através de uma sequência de passos. 2.1 Configurações Necessárias As configurações descritas abaixo são NECESSÁRIAS para que a solução possa ser utilizada plenamente e corretamente. 2.1.1 Configurar as novas Variáveis no Módulo de Contabilidade Nos casos em que o Módulo de Contabilidade da Totvs Financial Services – Core Banking fizer parte da solução que está sendo utilizada, será necessário configurar adequadamente as variáveis URL_METADADOS e HTTP_RECEIVE_TIMEOUT para que o Módulo de Contabilidade possa acessar, de forma integrada, as funcionalidades de relatórios do novo Módulo MetaDados. Estas variáveis deverão ser configuradas através da tela de Configuração de Variáveis Internas, que pode ser acessada através do botão “Variáveis”, disponível na aba “Empresa” da tela “Configurações Empresa”, conforme destacado na figura a seguir: 16 Versão 1.0 MetaDados Figura 8 – Configurações Empresa A configuração da variável URL_METADADOS é utilizada pelo Módulo de Contabilidade para acessar diretamente os relatórios do novo Módulo MetaDados, através do protocolo HTTP. Esta variável deverá ser configurada com a sintaxe “http://<IP>:<PORTA>/jsp_md/resource/ services/RelatorioService/emitir”, considerando que o item “<IP>” deverá ser substituído pelo endereço IP ou pelo nome do servidor de aplicações WEB onde o novo Módulo MetaDados estiver instalado e o item “<PORTA>” deverá ser substituído pelo número da porta na qual o contexto da aplicação estiver configurado para receber as requisições, sendo que geralmente é utilizada a porta 8080, conforme o exemplo da figura a seguir: Figura 9 – Configurações de variáveis internas Versão 1.0 17 MetaDados A configuração da variável HTTP_RECEIVE_TIMEOUT é utilizada pelo Módulo de Contabilidade para configurar adequadamente o tempo de resposta (timeout) no acesso direto aos relatórios do novo Módulo MetaDados, através do protocolo HTTP. O tempo de resposta recomendado inicialmente é de 300.000 milissegundos, o que equivale a 5 minutos. No entanto, para instituições com grandes volumes de transações de contabilização diárias pode vir a ser necessário aumentar o tempo de resposta configurado, sempre em milissegundos, até que este seja o suficiente para que relatórios com grandes quantidades de lançamentos contábeis possam ser processados e transmitidos em tempo hábil, do novo Módulo MetaDados para o Módulo de Contabilidade, conforme o exemplo da figura a seguir. Figura 10 – Configurações de variáveis internas 2.1.2 Reconfigurar o Layout das Interfaces Integradas no Módulo de Contabilidade Nos casos em que o Módulo de Contabilidade da Totvs Financial Services – Core Banking fizer parte da solução que está sendo utilizada, para que as melhorias que estão sendo agregadas pelo novo Módulo MetaDados possam ser usufruídas completamente através deste módulo é indispensável que os lançamentos contábeis das interfaces passem a ser integrados através da aba “Integração” da tela “Integração Contábil” e não mais através da aba “Movimento” da tela “Interfaces”, cuja rotina de importação que será descontinuada em breve. Para que uma interface passe a ser integrada sempre através da aba “Integração” da tela “Integração Contábil”, é necessário configurar a mesma na aba “Configuração” desta tela, selecionando o Layout de Integração adequado, conforme será detalhado a seguir. A partir do momento em que uma interface estiver devidamente configurada na Integração Contábil, a integração dos lançamentos contábeis da mesma não será mais permitida através da aba “Movimento” da tela “Interfaces”, na qual passará a ser exibida a mensagem “Integração contábil ativada para esta interface. Ver pasta Integração.”, orientando o usuário a utilizar a rotina de Integração. Será necessário configurar adequadamente o Layout de Integração, mas apenas dos módulos legados da Totvs Financial Services – Core Banking que utilizam a Rotina de Contabilização padrão (TBARQS), como é o caso dos módulos de Contas Correntes (CC e MV), CrediMaster (CF), Depósitos à Prazo (DP) e Rating (RT). Para estes módulos, na aba “Configuração” da tela “Integração Contábil”, o campo “Layout” deverá ser configurado com “BD METADADOS – Banco de Dados METADADOS”, conforme o exemplo da figura a seguir. Esta nova opção de layout indica para a rotina de integração contábil que os lançamentos 18 Versão 1.0 MetaDados a serem integrados deverão ser obtidos diretamente na base de dados do novo Módulo MetaDados, ao invés de serem obtidos a partir de arquivos de interface. Figura 11 – Configurações Por utilizarem uma Rotina de Contabilização específica ao invés da Rotina de Contabilização padrão (TBARQS), os módulos de Open e SPB, por enquanto, deverão ter o Layout de Integração configurado como “TB PADRAO – Padrão TotalBanco”, pois as suas Rotinas de Contabilização específicas ainda NÃO acessam a base de dados do novo Módulo MetaDados. Esta opção de layout, pré-existente, indica para a rotina de integração contábil que os lançamentos a serem integrados deverão ser obtidos a partir de arquivos de interface, ao invés de serem obtidos diretamente na base de dados do novo Módulo MetaDados. Somente à medida que estes módulos passarem a adotar a Rotina de Contabilização padrão ou que as suas Rotinas de Contabilização específicas tiverem incorporadas as melhorias agregadas pelo novo Módulo MetaDados é que o Layout de Integração destes módulos também poderá ser configurado como “BD METADADOS – Banco de Dados METADADOS”. Por apenas gerarem arquivos de contabilização no layout MetaDados (não posicional), mas sem submetê-los à execução pela Rotina de Contabilização (TBARQS), os módulos com interface 100% WEB, como é o caso, por exemplo, do Módulo de Cartões e do Módulo IFRS, deverão ter o Layout de Integração configurado como “TB PADRAO – Padrão TotalBanco”. Versão 1.0 19 MetaDados 2.2 Passo a Passo 2.2.1 Gerar as Informações para Contabilização nos Módulos Legados Os módulos legados da Totvs Financial Services – Core Banking que utilizam a Rotina de Contabilização padrão (TBARQS) na geração das informações de contabilização, como é o caso dos módulos de Contas Correntes, CrediMaster, Depósitos à Prazo e Rating, passarão a gerar os lançamentos a serem contabilizados diretamente na base de dados do novo Módulo MetaDados, mas os procedimentos a serem executados pelo usuário para a geração das informações para contabilização praticamente não sofreram alteração, conforme será detalhado a seguir. Por utilizarem uma Rotina de Contabilização específica ao invés da Rotina de Contabilização padrão (TBARQS) na geração das informações de contabilização, os módulos de Open e SPB, por enquanto, permanecerão gerando os lançamentos a serem contabilizados em arquivos de interfaces no layout MetaDados, ao invés de gera-los diretamente na base de dados do novo Módulo MetaDados, como é o caso dos módulos que utilizam a Rotina de Contabilização padrão. Da mesma forma que o local onde os lançamentos são gerados por estes módulos, os procedimentos a serem executados pelo usuário para a geração das informações para contabilização também não sofreram nenhuma alteração. Por apenas gerarem arquivos de contabilização no layout MetaDados (não posicional), mas sem submetê-los à execução pela Rotina de Contabilização (TBARQS), os módulos com interface 100% WEB, como é o caso, por exemplo, do Módulo de Cartões e do Módulo IFRS, por enquanto, também permanecerão gerando os lançamentos a serem contabilizados em arquivos de interfaces no layout MetaDados, ao invés de gera-los diretamente na base de dados do novo Módulo MetaDados, como é o caso dos módulos que utilizam a Rotina de Contabilização padrão. Da mesma forma que o local onde os lançamentos são gerados por estes módulos, os procedimentos a serem executados pelo usuário para a geração das informações para contabilização também não sofreram nenhuma alteração. 1.1.1.1 2.2.1.1 Módulo de Contas Correntes No Módulo de Contas Correntes a geração das informações de contabilização deverá ser realizada através do menu “Ferramentas Rotinas Especiais... Contabilidade”, conforme a figura a seguir. 20 Versão 1.0 MetaDados Figura 12 – Sistema de Contas Correntes Na tela de geração das informações de contabilização, após informar a “Data da Contabilização”, é importante que a opção “Gerar relatório” passe a ser sempre selecionada conforme a figura a seguir, pois, desta forma, após gerar o arquivo de interface de contabilização no layout MetaDados (não posicional) o Módulo de Contas Correntes também executará a Rotina de Contabilização padrão (TBARQS), gerando os lançamentos e os relatórios de contabilização para o arquivo gerado. Após serem preenchidos estes campos, basta clicar no botão “Iniciar” para executar a rotina, conforme a figura a seguir. As vantagens de o Módulo de Contas Correntes passar a sempre executar a Rotina de Contabilização padrão (TBARQS) são as seguintes: Os lançamentos a serem contabilizados já serão gerados diretamente na base de dados do novo Módulo MetaDados, de onde o Módulo de Contabilidade poderá passar a obtê-los de forma direta, desde que seja configurado adequadamente para isto, conforme descrito no item 2.1 deste documento, ao invés de fazê-lo a partir de um arquivo de interface de contabilização, proporcionando significativa redução no tempo necessário para integração dos lançamentos no Módulo de Contabilidade; Os relatórios de contabilização poderão passar a ser acessados a partir do Módulo MetaDados, antes mesmo que os lançamentos contábeis gerados sejam integrados no Módulo de Contabilidade da Totvs Financial Services – Core Banking. Versão 1.0 21 MetaDados Figura 13 – Sistema de Contas Correntes 2.2.1.2 Módulo CrediMaster No Módulo CrediMaster geralmente a interface de contabilização está configurada para ser gerada automaticamente (no processamento da rotina de Fechamento), através do campo “Processamento” da aba “Grupos/Interfaces” da tela “Configurações” que, por sua vez, pode ser acessada através do menu “Ferramentas Configuração... Configuração Básica”, conforme a figura a seguir. 22 Versão 1.0 MetaDados Figura 14 – Sistema de Crédito No entanto, caso a geração das informações de contabilização esteja configurada para ser executada manualmente, então a mesma deverá ser realizada através da aba “Interfaces Saída” da tela “Processamento”. Após selecionar o item “Interface: Contábil” basta clicar no botão “Iniciar” para executar a rotina, conforme indicado na figura a seguir. Versão 1.0 23 MetaDados Figura 15 – Sistema de Crédito 2.2.1.3 Módulo Depósitos à Prazo No Módulo Depósitos à Prazo a geração das informações de contabilização é realizada durante a execução da rotina de Fechamento, que está disponível através da aba “Fechamento” da tela “Processamento”. Para executar a rotina basta clicar no botão “Iniciar Fechamento”, conforme a figura a seguir. 24 Versão 1.0 MetaDados Figura 16 – Depósito a Prazo O Módulo Depósitos à Prazo também permite reexecutar a geração das informações de contabilização para datas retroativas, para as quais a rotina de Fechamento já tenha sido executada. Esta funcionalidade está disponível através da aba “Reexecução” da tela “Processamento”. Para executar a rotina basta selecionar a interface “Contabilização”, informar a data de geração e clicar no botão “Iniciar Reexecução”, conforme a figura a seguir. Versão 1.0 25 MetaDados Figura 17 – Depósito a Prazo 2.2.1.4 Módulo Rating No Módulo Rating a geração das informações de contabilização deverá ser realizada através da aba “Processamento” da tela “Classificação (Rating)”. Após informar a data de Competência e selecionar/marcar a empresa cujas informações de contabilização deverão ser geradas, para executar a rotina basta clicar no botão “Contabilizar”, conforme indicado na figura a seguir. 26 Versão 1.0 MetaDados Figura 18 – Rating 2.2.2 Gerar os Relatórios de Contabilização no Módulo MetaDados Logo após os lançamentos contábeis terem sido gerados diretamente na base de dados do novo Módulo MetaDados pelos módulos legados da Totvs Financial Services – Core Banking que utilizam a Rotina de Contabilização padrão (TBARQS), como é o caso dos módulos de Contas Correntes, CrediMaster, Depósitos à Prazo e Rating, os relatórios de contabilização “Razão Auxiliar”, “Boletim de Contabilização (Slips)”, “Extrato de Contas Controladas” e “Resumo dos Esquemas não Processados” já poderão ser gerados pelos usuários através da interface WEB do novo Módulo MetaDados, antes mesmo dos lançamentos contábeis terem sido integrados no Módulo de Contabilidade da Totvs Financial Services – Core Banking. Por utilizarem uma Rotina de Contabilização específica ao invés da Rotina de Contabilização padrão (TBARQS) na geração das informações de contabilização, os módulos de Open e SPB, por enquanto, permanecerão gerando os relatórios de contabilização em arquivos e, como as suas informações de contabilização não serão geradas diretamente na base de dados do novo Módulo MetaDados, no caso destes módulos os relatórios de contabilização não estarão disponíveis para geração através da interface WEB do novo Módulo MetaDados. Por apenas gerarem arquivos de contabilização no layout MetaDados e não submetê-los à execução pela Rotina de Contabilização (TBARQS), os módulos com interface 100% WEB, como é o caso, por exemplo, do Módulo de Cartões e do Módulo IFRS, por enquanto, também não terão as suas informações de contabilização geradas diretamente na base de dados do novo Módulo MetaDados e por isto, antes dos lançamentos contábeis terem sido integrados no Módulo de Contabilidade da Totvs Financial Services – Core Banking, os relatórios de contabilização destes módulos não estarão disponíveis para geração através da interface WEB do novo Módulo MetaDados. No caso destes módulos WEB, somente após os lançamentos contábeis terem sido integrados no Módulo de Contabilidade da Totvs Financial Services – Core Banking é que os relatórios de contabilização Versão 1.0 27 MetaDados estarão disponíveis para geração através da interface WEB do novo Módulo MetaDados e também através do próprio Módulo de Contabilidade, como detalhado mais adiante, no item 2.2.4. Para a geração dos relatórios de contabilização no novo Módulo MetaDados, após efetuar o seu login o usuário deverá acessar este módulo clicando no ícone correspondente, na tela de seleção de módulos com interface WEB, conforme o exemplo na figura a seguir. Figura 19 – MetaDados Após acessar o novo Módulo MetaDados, na tela de definição da Abrangência deverão ser selecionadas a Empresa e a Unidade para as quais se deseja gerar os relatórios de contabilização, conforme a figura a seguir. Figura 20 – Definição de Abrangência Após selecionar a Empresa e Unidade na tela de definição da Abrangência, o menu “Impressão Relatórios” deverá ser acessado, conforme a figura a seguir. 28 Versão 1.0 MetaDados Figura 21 – Impressão de Relatórios No campo “Módulo” estarão disponíveis para seleção as siglas das interfaces dos módulos para os quais já existem informações de contabilização na base de dados do novo Módulo MetaDados, considerando apenas os MetaDados de contabilização da Empresa que foi selecionada na tela de definição de Abrangência, conforme a figura a seguir. Figura 22 – Impressão de Relatórios Após selecionar o Módulo, informar um intervalo de Datas a ser pesquisado e clicar no botão “Pesquisar”, serão listados os MetaDados de contabilização que foram encontrados de acordo com os parâmetros informados e com a Empresa que foi selecionada na tela de definição de Abrangência, conforme a figura a seguir. Versão 1.0 29 MetaDados Figura 23 – Impressão de Relatórios Entre os MetaDados de contabilização que foram encontrados, deverá ser selecionado aquele para o qual se pretende obter os relatórios de contabilização e então, para gerar um dos relatórios deverá ser clicado no ícone de impressão (Impressora) correspondente ao relatório pretendido: Boletim de Contabilização (Slips), Extrato de Contas Controladas, Razão Auxiliar ou Resumo dos Esquemas não Processados, conforme indicado na figura a seguir. Figura 24 – Impressão de Relatórios Após ser clicado no ícone de impressão (Impressora) correspondente ao relatório pretendido, o mesmo será gerado em um arquivo no formato PDF, que poderá ser salvo no desktop do usuário e/ou impresso, conforme destacado na figura seguinte. 30 Versão 1.0 MetaDados Figura 25 – Impressão de Relatórios Caso o usuário opte por salvar o relatório de contabilização gerado, a pasta de destino e o nome sugerido para o arquivo PDF poderão ser alterados, conforme o exemplo da figura a seguir. Figura 26 – Windows Explorer Versão 1.0 31 MetaDados 2.2.3 Integrar as Informações de Contabilização no Módulo de Contabilidade No Módulo de Contabilidade da Totvs Financial Services – Core Banking, a integração dos lançamentos deverá ser sempre realizada através da aba “Integração” da tela “Integração Contábil” e não mais através da aba “Movimento” da tela “Interfaces”. Enquanto os lançamentos a serem integrados ainda não estiverem disponíveis nas interfaces de integração que estiverem configuradas com o Layout “BD METADADOS – Banco de Dados METADADOS”, como deverá ser o caso dos módulos de Contas Correntes (CC e MV), CrediMaster (CF), Depósitos à Prazo (DP) e Rating (RT), que utilizam a Rotina de Contabilização padrão (TBARQS), conforme descrito anteriormente no item 2.1, nesta tela poderá ser observado que, ao invés de ser exibido o nome do arquivo de interface seguido da informação “não disponível”, será exibida a informação “METADADOS não disponível”, indicando que os lançamentos a serem integrados ainda não estão disponíveis na base de dados do novo Módulo MetaDados. Após os lançamentos estarem disponíveis na base de dados para integração, no caso destas interfaces, será exibida a Data/Hora em que os mesmos foram gerados pelo respectivo módulo legado, conforme a figura a seguir. Após selecionar a(s) interface(s) a ter(em) os seus lançamentos integrados, para iniciar a rotina de integração basta clicar no botão “Integrar”, que pode ser visualizado na figura a seguir. Figura 27 – Sistema Contabilidade Após a integração ter sido concluída, basta clicar no botão “...” para acessar a tela “Detalhes do Painel de Controle”, na qual poderão ser visualizadas informações detalhadas sobre a integração. 32 Versão 1.0 MetaDados No caso de interfaces de integração que estiverem configuradas com o Layout “BD METADADOS – Banco de Dados METADADOS”, como deverá ser o caso dos módulos de Contas Correntes (CC e MV), CrediMaster (CF), Depósitos à Prazo (DP) e Rating (RT), que utilizam a Rotina de Contabilização padrão (TBARQS), conforme descrito anteriormente no item 2.1, a terceira aba, através da qual é possível consultar TODOS os lançamentos contábeis que foram integrados para a interface, será exibida com o título “Tabela” e com a informação “Tabela METADADOS” no cabeçalho do relatório, indicando que os lançamentos foram integrados a partir da base de dados do novo Módulo MetaDados, conforme a figura a seguir. Figura 28 – Painel de Controle No caso de interfaces de integração que NÃO estiverem configuradas com o Layout “BD METADADOS – Banco de Dados METADADOS”, seja por utilizarem uma Rotina de Contabilização específica ao invés da Rotina de Contabilização padrão (TBARQS), como é o caso dos módulos de Open (OP) e SPB (SP), seja por apenas gerarem arquivos de contabilização no layout MetaDados (não posicional), mas sem submetê-los à execução pela Rotina de Contabilização (TBARQS), como é o caso dos módulos com interface 100% WEB como, o Módulo de Cartões (TX) e o Módulo IFRS (LE), cujas interfaces deverão estar configuradas com o Layout “TB PADRAO – Padrão TotalBanco”, a terceira aba será exibida com o título “Arquivo” e com a informação “Arquivo” seguida do caminho e nome do arquivo de interface no cabeçalho do relatório, indicando que os lançamentos foram integrados a partir do respectivo arquivo de interface, conforme a figura a seguir. Versão 1.0 33 MetaDados Figura 29 – Painel de Controle 2.2.4 Gerar os Relatórios de Contabilização no Módulo de Contabilidade Após os lançamentos contábeis das interfaces terem sido integrados conforme descrito no item 2.2.3, os relatórios de contabilização “Razão Auxiliar”, “Boletim de Contabilização (Slips)”, “Extrato de Contas Controladas” e “Resumo dos Esquemas não Processados” do novo Módulo MetaDados poderão ser gerados diretamente a partir do Módulo de Contabilidade da Totvs Financial Services – Core Banking, mas somente se a interface de contabilização em questão foi gerada pelos módulos legados da Totvs Financial Services – Core Banking que utilizam a Rotina de Contabilização padrão (TBARQS), como é o caso dos módulos de Contas Correntes (CC e MV), CrediMaster (CF), Depósitos à Prazo (DP) e Rating (RT), ou que a interface de contabilização em questão foi gerada pelos módulos legados da Totvs Financial Services – Core Banking que apenas geram arquivos de contabilização no layout MetaDados sem submetê-los à execução pela Rotina de Contabilização (TBARQS), como é o caso dos módulos com interface 100% WEB como, por exemplo, o Módulo de Cartões (TX) e o Módulo IFRS (LE). No caso das interfaces de contabilização destes módulos WEB, de fato, somente após os lançamentos contábeis terem sido integrados no Módulo de Contabilidade é que os relatórios de contabilização estarão disponíveis para geração, seja através da interface WEB do novo Módulo MetaDados, como visto no item 2.2.2, ou diretamente através do Módulo de Contabilidade. Por utilizarem uma Rotina de Contabilização específica ao invés da Rotina de Contabilização padrão (TBARQS) na geração das informações de contabilização, as interfaces dos módulos de Open (OP) e SPB (SP), por enquanto, permanecerão gerando os relatórios de contabilização em arquivos e, como as suas informações de contabilização não serão geradas diretamente na base de dados do novo Módulo MetaDados, no caso destes módulos os relatórios de contabilização não estarão disponíveis para geração, nem através da interface WEB do novo Módulo MetaDados, nem através do Módulo de Contabilidade. Após a integração de uma interface ter sido concluída, basta clicar no botão “...” da aba “Integração” da tela “Integração Contábil” para acessar a tela “Detalhes do Painel de Controle”, na qual poderão ser visualizadas informações detalhadas sobre a integração e os relatórios de contabilização “Razão Auxiliar”, “Boletim de Contabilização (Slips)”, “Extrato de Contas Controladas” e “Resumo dos Esquemas não Processados” do novo Módulo MetaDados poderão ser gerados a partir dos respectivos botões da aba “Mensagens de Aviso”, destacados na figura seguinte. 34 Versão 1.0 MetaDados Figura 30 – Painel de Controle Após ser clicado no botão correspondente ao relatório pretendido, o mesmo será gerado pelo novo Módulo MetaDados em um arquivo no formato PDF que será salvo pelo Módulo de Contabilidade na pasta de destino e com o nome que o usuário selecionar, conforme o exemplo da figura a seguir. Figura 31 – Windows Explorer Após o arquivo no formato PDF correspondente ao relatório ter sido salvo, caso o aplicativo Adobe Acrobat Reader (AcroRd32.exe) esteja instalado corretamente no desktop do usuário, o mesmo será executado automaticamente para que o relatório possa ser visualizado, conforme o exemplo da figura a seguir. Versão 1.0 35 MetaDados Figura 32 – Erros No entanto, se ao invés do Adobe Acrobat Reader outro aplicativo visualizador de arquivos PDF estiver instalado no desktop do usuário, para visualizar o conteúdo do relatório basta dar um duplo-clique sobre o arquivo PDF em questão. 2.2.5 Consultar a Origem dos Lançamentos Contábeis no Módulo de Contabilidade (Rastreabilidade) Após os lançamentos contábeis das interfaces terem sido integrados com sucesso, conforme descrito no item 2.2.3, além da geração dos relatórios de contabilização, descrita no item 2.2.4, a consulta aos registros de origem de cada um dos lançamentos contábeis integrados também estará disponível a partir do Módulo de Contabilidade da Totvs Financial Services – Core Banking, mas somente se a interface de contabilização integrada foi gerada pelos módulos legados da Totvs Financial Services – Core Banking que utilizam a Rotina de Contabilização padrão (TBARQS), como é o caso dos módulos de Contas Correntes (CC e MV), CrediMaster (CF), Depósitos à Prazo (DP) e Rating (RT), ou se a interface de contabilização em questão foi gerada pelos módulos legados da Totvs Financial Services – Core Banking que apenas geram arquivos de contabilização no layout MetaDados sem submetê-los à execução pela Rotina de Contabilização (TBARQS), como é o caso dos módulos com interface 100% WEB como, por exemplo, o Módulo de Cartões (TX) e o Módulo IFRS (LE). Por utilizarem uma Rotina de Contabilização específica ao invés da Rotina de Contabilização padrão (TBARQS), as informações de contabilização das interfaces dos módulos de Open (OP) e SPB (SP) não serão geradas diretamente na base de dados do novo Módulo MetaDados e, por isto, no caso das interfaces destes módulos não haverá possibilidade de acessar a consulta aos registros de origem dos lançamentos contábeis integrados. Após a integração de uma interface ter sido concluída com sucesso no Módulo de Contabilidade da Totvs Financial Services – Core Banking, a consulta aos registros de origem de cada um dos lançamentos contábeis integrados estará disponível a partir da aba “Lançamentos” da tela de mesma descrição (Lançamentos). O acesso à consulta dos registros de origem, no entanto, estará disponível (visível) somente após ter sido selecionado o Lote de Lançamentos Contábeis que foram integrados, através do botão “Selecionar Lote”, destacado na figura seguinte. 36 Versão 1.0 MetaDados Figura 33 – Sistema Contabilidade Após clicar no botão “Selecionar Lote” da aba de lançamentos será exibida a tela de “Cadastro de Lotes”, na qual o usuário deverá clicar diretamente no botão “Buscar”, sem ser necessário informar nenhum outro campo desta tela, conforme destacado na figura seguinte. Versão 1.0 37 MetaDados Figura 34 – Cadastro de Lotes Após clicar no botão “Buscar” da tela de “Cadastro de Lotes” será exibida a tela “Consultar”, na qual o usuário, opcionalmente, poderá informar a Data e/ou o Número do Lote de Lançamentos para pesquisar o Lote de Lançamentos que pretende consultar os registros de origem. Embora o campo Data não seja de preenchimento obrigatório nesta tela, é recomendado que o usuário informe pelo menos o conteúdo deste campo para que a quantidade de lotes retornados pela pesquisa seja menor e, desta forma, a identificação e a seleção do Lote pretendido seja facilitada. Após clicar no botão “Buscar”, na parte inferior desta tela serão exibidos os Lotes de Lançamentos que atendem às condições de consulta informadas. Para selecionar um destes lotes, basta clicar sobre a linha correspondente ao mesmo e então clicar no botão “OK”, conforme destacado na figura seguinte. Figura 35 – Consultar 38 Versão 1.0 MetaDados Após clicar no botão “OK” da tela “Consultar”, a tela de “Cadastro de Lotes” voltará a ser exibida, desta vez já preenchida com as informações do Lote de Lançamentos que foi selecionado anteriormente. Nesta tela, o usuário deverá clicar diretamente no botão “OK”, conforme destacado na figura seguinte. Figura 36 – Cadastro de Lotes Após clicar no botão “OK” da tela de “Cadastro de Lotes”, a aba “Lançamentos” da tela de mesma descrição (Lançamentos) voltará a ser exibida, desta vez já preenchida com os lançamentos contábeis do lote que foi selecionado anteriormente. A consulta aos registros de origem dos lançamentos contábeis de um lote que foi integrado estará disponível somente nos casos descritos no início desta seção 2.2.5. Caso esteja disponível para o lote selecionado, para realizar a consulta basta selecionar o lançamento contábil que se pretende consultar clicando sobre qualquer campo do mesmo (uma linha pontilhada indicará o lançamento selecionado) e então clicar no ícone que representa uma lupa, localizado na parte inferior da tela, à direita do número do lançamento que estiver selecionado, conforme destacado na figura seguinte. Versão 1.0 39 MetaDados Figura 37 – Sistema Contabilidade Após clicar no ícone da aba de “Lançamentos” que representa uma lupa, a tela “Detalhamento do Lançamento Contábil” será exibida com o lançamento que foi selecionado anteriormente já posicionado na parte superior e com os seus respectivos registros de origem já listados na parte inferior da tela. Para consultar os registros de origem de outro lançamento do lote, basta utilizar a barra de scroll vertical que está disponível na parte superior da tela, à direita, conforme destacado na figura a seguir. Sempre que outro lançamento for exibido na parte superior, os respectivos registros de origem deste lançamento serão listados automaticamente na parte inferior da tela, onde as barras de scroll vertical e horizontal poderão ser utilizadas para navegação entre os registros de origem e visualização de todos os seus campos. Na parte superior da tela, além das informações do lançamento contábil que também estão disponíveis na aba “Lançamentos” da tela anterior, também é exibida a Carteira, Subcarteira, Operação, Liquidez, Tipo de Correção e Conteúdo que determinaram o Esquema Contábil considerado na contabilização dos registros de origem exibidos. Na parte inferior da tela também é exibida a quantidade de registros de origem do lançamento que está sendo exibido na parte superior da tela, conforme pode ser observado na figura seguinte. 40 Versão 1.0 MetaDados Figura 38 – Detalhamento do Lançamento Contábil Utilizando as barras de scroll vertical e horizontal que estarão disponíveis na parte inferior da tela “Detalhamento do Lançamento Contábil”, o usuário poderá visualizar o conteúdo do campo de valor cuja soma resultou no valor do lançamento contábil que está sendo visualizado na parte superior da tela. O campo de valor dos registros de origem varia conforme o lançamento contábil que estiver sendo visualizado e os seus valores sempre estarão destacados na cor azul, com fundo na cor cinza, conforme o exemplo da figura a seguir. Na parte inferior da tela “Detalhamento do Lançamento Contábil” também está disponível o botão “Exportar”, através do qual o usuário poderá exportar em planilhas Excel (.xls) os registros de origem do lançamento contábil que estiver sendo exibido no momento, conforme destacado na figura a seguir. Versão 1.0 41 MetaDados Figura 39 – Detalhamento do Lançamento Contábil Após clicar no botão “Exportar” da tela “Detalhamento do Lançamento Contábil”, o usuário poderá selecionar a pasta e o nome do arquivo de destino dos registros de origem do lançamento em questão. Por padrão, no nome sugerido para o arquivo está incluído o número do lançamento cujos registros de origem estão sendo exportados, conforme o exemplo da figura a seguir. Figura 40 – Windows Explorer Após os registros de origem terem sido exportados com sucesso, será exibida uma mensagem informativa correspondente, conforme o exemplo da figura a seguir. 42 Versão 1.0 MetaDados Figura 41 – Mensagem Atenção A planilha Excel gerada na exportação conterá todos os campos de todos os registros de origem do lançamento que foi selecionado previamente, conforme o exemplo da figura a seguir. Figura 42 – Detalhamento do Lançamento Contábil 2.3 Dicas Produtividade 2.3.1 Variáveis CTB_GERAR_ARQS_AUX e CTB_GERAR_ARQS_ITF No item 1.1.5 foram descritas as variáveis CTB_GERAR_ARQS_AUX e CTB_GERAR_ARQS_ITF, suas finalidades e os procedimentos necessários para a configuração das mesmas. Nos casos em que os arquivos auxiliares dos relatórios de contabilização NÃO precisarem ser gerados, é recomendado que a variável CTB_GERAR_ARQS_AUX seja configurada com “N”, correspondente a NÃO, conforme descrito no item 1.1.5. De forma análoga, nos casos em que é desnecessária a geração de arquivos de interface de contabilização no layout padrão ITMC, também é recomendado que a variável CTB_GERAR_ARQS_ITF seja configurada com “N”. Versão 1.0 43 MetaDados A importância da recomendação para que estas duas variáveis sejam configuradas com “N” sempre que isto for possível e a consequência disto, que é a não geração dos arquivos correspondentes, deve-se ao fato de que esta configuração é um dos aspectos importantes que contribuirá para que sejam efetivamente usufruídas as melhorias citadas no item 1 (Visão Geral da Solução), principalmente a melhora na performance de execução da Rotina de Contabilização padrão e a melhora na segurança do acesso às informações pela sua restrição a somente os perfis que estiverem devidamente autorizados no Módulo de Segurança da Totvs Financial Services – Core Banking. 2.3.2 Esquemas Contábeis com Lançamentos Sintéticos no Módulo Parâmetros A configuração dos Registros dos Esquemas Contábeis, no Módulo Parâmetros, para que sejam gerados lançamentos contábeis sintéticos ao invés de serem gerados lançamentos contábeis analíticos é fundamental e necessária para que possa ser de fato usufruída a melhora substancial na performance de execução da Rotina de Contabilização padrão, principalmente quando executada com elevados volumes de operações diárias de contabilização, conforme foi citado no item 1 (Visão Geral da Solução). Isto se deve ao fato de que a Rotina de Contabilização padrão foi alterada para que os registros de origem que são gerados pelos sistemas legados da Totvs Financial Services – Core Banking sejam pré-consolidados antes de serem submetidos ao processamento segundo os Esquemas Contábeis configurados. A pré-consolidação proporciona, em média, uma redução superior a 90% na quantidade total de registros de origem submetidos à contabilização, o que garante uma redução substancial no tempo total de execução da rotina, principalmente quando executada com volumes elevados de operações diárias de contabilização. No entanto, somente se TODOS os Registros dos Esquemas Contábeis estiverem configurados para gerar os lançamentos contábeis sintéticos é que a rotina de pré-consolidação poderá ser executada e, consequentemente, o ganho de performance poderá ser efetivamente obtido. A geração de lançamentos contábeis sintéticos reduz significativamente a quantidade de lançamentos contábeis que serão integrados no Módulo de Contabilidade da Totvs Financial Services – Core Banking sem alterar, evidentemente, os totais dos valores que precisam ser contabilizados. Se pelo menos um dos Registros dos Esquemas Contábeis estiver configurado para gerar os lançamentos contábeis analíticos a rotina de pré-consolidação NÃO poderá ser executada e, consequentemente, o ganho de performance NÃO poderá ser efetivamente obtido. Além disto, a geração de lançamentos contábeis analíticos aumenta significativamente a quantidade de lançamentos contábeis que serão integrados no Módulo de Contabilidade da Totvs Financial Services – Core Banking. A configuração dos Esquemas Contábeis e dos seus Registros é realizada no Módulo Parâmetros, através da aba “Esquemas” da tela “Contábeis” (Tabelas de Contabilização). Para buscar os Esquemas Contábeis que estiverem configurados para a contabilização de uma interface de integração deve ser clicado no botão “Buscar”, destacado na figura a seguir. 44 Versão 1.0 MetaDados Figura 43 – Sistema Parâmetros Na tela “Consultar” que é exibida na sequência, o usuário deverá selecionar a Empresa na qual estão cadastrados os Esquemas Contábeis e, caso pretenda configurar apenas os Esquemas Contábeis de uma determinada interface contábil, deverá informar também a sigla da interface em questão. Após clicar no botão “Buscar” desta tela, caso apenas os campos Empresa e Interface tenham sido informados, serão exibidos TODOS os Esquemas Contábeis da interface em questão, com o primeiro deles já selecionado. Para retornar à tela anterior, basta clicar no botão “OK”, destacado na figura seguinte. Versão 1.0 45 MetaDados Figura 44 – Consultar Após retornar para a aba “Esquemas” com os dados do Esquema Contábil sendo exibidos, o usuário deverá clicar no botão “Alterar” e depois no botão “Registro Contábil”, destacado na figura a seguir. 46 Versão 1.0 MetaDados Figura 45 – Sistema Parâmetros Na tela “Registro Contábil” TODOS os registros que estão cadastrados para o Esquema Contábil deverão ser verificados e, quando for o caso, ter o conteúdo do campo “Agrupamento” reconfigurado para “Lançamentos Sintéticos”, conforme destacado na figura a seguir. Após TODOS os registros que estão cadastrados para o Esquema Contábil terem sido verificados e, quando for o caso, reconfigurados, o usuário deverá clicar no botão “Fechar”, conforme a figura a seguir. Figura 46 – Registro Contábil Após retornar para a aba “Esquemas”, caso algum Registro Contábil tenha sido alterado, para efetivar as alterações o usuário deverá clicar no botão “Salvar”, destacado na figura a seguir. Versão 1.0 47 MetaDados Figura 47 – Sistema Parâmetros A verificação e, quando for o caso, a alteração da configuração do campo “Agrupamento” da tela “Registro Contábil” deverá ser realizada em TODOS os Registros de TODOS os Esquemas Contábeis da Interface em questão. 2.3.3 Interfaces com Layout “Banco de Dados METADADOS” no Módulo de Contabilidade No item 2.1.2 foi descrita a necessidade de que as interfaces passem a ter os seus lançamentos contábeis integrados no Módulo de Contabilidade sempre através da aba “Integração” da tela “Integração Contábil”, não devendo mais ser importados através da aba “Movimento” da tela “Interfaces”. Além disto, também foi descrita a necessidade de configurar adequadamente o tipo do Layout de Integração das interfaces dos módulos legados recomendados, bem como o procedimento necessário para fazer isto. Nos casos descritos no item 2.1.2 é recomendada a configuração do Layout de Integração “BD METADADOS – Banco de Dados METADADOS”, indicando para a rotina de integração contábil que os lançamentos a serem integrados deverão ser obtidos diretamente na base de dados do novo Módulo MetaDados, ao invés de serem obtidos a partir de arquivos de interface. A importância desta recomendação deve-se ao fato de que esta configuração é mais um dos aspectos que contribuirá para que sejam efetivamente usufruídas as melhorias citadas no item 1 (Visão Geral da Solução), dentre elas, a melhora na performance de execução da Rotina de Contabilização padrão e a melhora na segurança do acesso às informações, que passarão a estar armazenadas em Banco de Dados, pela sua restrição a somente os perfis que estiverem devidamente autorizados no Módulo de Segurança da Totvs Financial Services – Core Banking. 2.3.4 Gerar Informações de Contabilização Analíticas no Módulo de Contas Correntes O Módulo de Contas Correntes da Totvs Financial Services – Core Banking permite que as informações de contabilização sejam geradas na interface de contabilização de forma Analítica, quando são detalhadas por conta corrente, ou de forma Sintética, 48 Versão 1.0 MetaDados quando são totalizadas por Modalidade, Carteira, Subcarteira, Operação, dentre outras informações. A geração das informações de contabilização de forma Analítica implica em um número maior de registros de origem na interface de contabilização quando comparado ao número de registros de origem gerados de forma Sintética que, justamente por ser menor, demanda um tempo total de geração menor em relação ao tempo de geração de uma interface gerada de forma Analítica, embora reduza consideravelmente o nível de detalhamento das informações de contabilização geradas que, desta forma, não poderão ser listadas por conta corrente no relatório de contabilização chamado Razão Auxiliar, o que dificulta bastante a rastreabilidade entre os lançamentos contábeis gerados e os seus respectivos registros de origem (fatos geradores). Uma vez que a Rotina de Contabilização padrão (TBARQS) que era utilizada pelo Módulo de Contas Correntes até então ainda não possuía as melhorias relacionadas à performance que estão sendo agregadas com a disponibilização desta nova versão, a opção natural para a maioria das instituições usuárias deste módulo era a geração das informações de contabilização de forma Sintética, reduzindo favoravelmente o tempo de geração, mas, por outro lado, prejudicando o nível de detalhamento das informações de contabilização geradas e, consequentemente, dificultando a rastreabilidade. Considerando a versão da Rotina de Contabilização padrão que ainda não possuía as melhorias desta nova versão, a geração das informações de contabilização de forma Analítica era indicada apenas para instituições com um volume bastante reduzido de contas correntes. Este cenário está sendo alterado com a disponibilização das melhorias agregadas pelo novo Módulo MetaDados no Módulo de Contabilidade e nos demais módulos legados da Totvs Financial Services – Core Banking que utilizam a Rotina de Contabilização padrão (TBARQS), dentre eles o Módulo de Contas Correntes, conforme detalhado no item 1 (Visão Geral da Solução). Isto porque, uma vez que um dos principais itens agregados pela nova versão é justamente a melhora substancial na performance de execução da Rotina de Contabilização padrão, principalmente quando executada com elevados volumes de operações diárias de contabilização, a opção pela geração das informações de contabilização de forma Sintética, até então geralmente motivada para solucionar problemas de performance, deixa de ser a mais indicada, pois tem como efeito colateral dificultar a rastreabilidade. Diante deste novo cenário proporcionado pela disponibilização da nova versão da Rotina de Contabilização padrão e para que as informações de contabilização geradas pelo Módulo de Contas Correntes deixem de ter restrições em relação à sua rastreabilidade, é recomendado que, a partir da utilização da nova versão do Módulo de Contas Correntes, independentemente do volume de contas correntes existente, as informações de contabilização passem a ser geradas sempre de forma Analítica ao invés de serem geradas de forma Sintética, como era feito até então pela maior parte das instituições usuárias deste módulo. No entanto, esta recomendação somente deverá ser adotada se também for adotada a recomendação descrita no item 2.3.2, que garante o ganho de performance na execução da Rotina de Contabilização padrão. Desta forma, através da geração das informações de contabilização (registros de origem) de forma analítica (item 2.3.4) será garantida a rastreabilidade das informações e através da geração dos lançamentos contábeis de forma sintética (item 2.3.2), será garantida a boa performance da Rotina de Contabilização padrão. A nova Consulta a Origem dos Lançamentos Contábeis (Rastreabilidade), disponível na nova versão do Módulo de Contabilidade, possibilita que, a partir dos lançamentos contábeis sintéticos que foram integrados, possam ser visualizados os respectivos registros analíticos de origem (fatos geradores). No Módulo de Contas Correntes, a configuração da forma de contabilização sintética ou analítica é feita no campo “Contabilizar” da aba “Global” da tela “Configurações Básicas” que, por sua vez, pode ser acessada através do menu “Ferramentas Configuração... Configuração Básica”, conforme indicado na figura a seguir. Versão 1.0 49 MetaDados Figura 48 – Sistema de Contas Correntes 50 Versão 1.0 MetaDados Para que a nova configuração do campo “Contabilizar” seja mantida e considerada nas próximas gerações da interface de contabilização, deverá ser clicado no botão “Salvar”, conforme indicado na figura a seguir. Figura 49 – Sistema de Contas Correntes 2.3.5 Gerar a Contabilização Selecionando a Opção “Gerar Relatórios” no Módulo de Contas Correntes No item 2.2.1.1 foram descritas as vantagens e a necessidade de que o campo “Gerar relatório” passe a estar sempre selecionado para a geração das informações de contabilização do Módulo de Contas Correntes da Totvs Financial Services – Core Banking, o que significará que, após gerar o arquivo de interface de contabilização no layout MetaDados, o Módulo de Contas Correntes também executará a Rotina de Contabilização padrão, gerando diretamente na base de dados do novo Módulo MetaDados os lançamentos contábeis a serem integrados. A importância desta recomendação deve-se ao fato de que esta configuração é mais um dos aspectos que contribuirá para que sejam efetivamente usufruídas as melhorias citadas no item 1 (Visão Geral da Solução), dentre elas, a melhora na performance de execução da Rotina de Contabilização padrão e a melhora na segurança do acesso às informações geradas, que passarão a estar armazenadas em Banco de Dados, pela sua restrição a somente os perfis que estiverem devidamente autorizados no Módulo de Segurança da Totvs Financial Services – Core Banking. Versão 1.0 51