Image Modified 1. No TOTVS Educacional usuário acessa o menu Customização | Importação de Cadastros Básicos do Protheus para o TOTVS Educacional (SGE). 2. É exibida tela customizada de Job para agendamento ou execução imediata. Se usuário desejar executar o processo imediatamente: 3. Rotina customizada executa processo de importação de cadastros básicos. 4. Caso contrário, usuário preenche as parametrizações de agendamento e os dados são gravados nas tabelas do gerenciamento de processos (para posterior execução quando forem atingidas as condições (data/hora) do agendamento. 5. Fim do Processo. Não se aplica. - Detalhamento de Processos Específicos
O objetivo deste requisito é efetuar a importação de cadastros básicos do barramento IIF para o TOTVS Educacional. Será criado um processo customizado que poderá ser executado manualmente ou agendado para executar com intervalos de tempo parametrizados pelo usuário. A tela para agendamento/execução do processo estará disponível no menu TOTVS Educacional | Customização | Importação – Cadastros Básicos. Ao ser executado, o processo irá consultar Views disponíveis no barramento IIF referentes aos cadastros do Protheus. São elas: Cadastros | Mnemônico Tabela Protheus | View Barramento | Tabela do RM que será alimentada | Centro de Custo | CTT | IIFR_CTT010_VW | GCCUSTO | Item Contábil | CTD | IIFR_CTD010_VW | SITEMCONTABILPROTHEUS | Classe de Valor | CTH | IIFR_CTH010_VW | SCLASSEVALORPROTHEUS | Natureza Financeira | SED | IIFR_SED010_VW | TTBORCAMENTO | Moeda | CTO | IIFR_CTO010_VW | GMOEDA | Banco | SA6 | IIFR_SA6010_VW | GBANCO, GAGENCIA, FCONTA, FCXA | Produto | SB1 | IIFR_SB1010_VW | TPRODUTO | Plano de Contas | CT1 | IIFR_CT1010_VW | CCONTA |
Todos os registros das Views consultadas deverão retornar o código da Empresa no Protheus. Através dele, será buscada a Coligada do TOTVS Educacional, na tabela de parâmetros ZPARAMETROSTEMPLATE. O registro será gerado no TOTVS Educacional para a Coligada associada à Empresa do Protheus. São exceções os cadastros de Natureza Financeira, Moeda e Produto que serão globais. Segue abaixo detalhamento dos campos de cada entidade à ser importada para o TOTVS Educacional.
Centro de Custo View - IIFR_CTT010_VW |
| Tabela do RM que será alimentada: GCCUSTO |
| Campo View | Campo TOTVS Educacional | CTT_FILIAL
Duas primeiras posições do campo indicam a Empresa Protheus | ZPARAMETROSTEMPLATE.CODIGO = EMPRESAPROTHEUS ZPARAMETROSTEMPLATE.CODCOLIGADA GCCUSTO.CODCOLIGADA | CTT_CUSTO | GCCUSTO.CODCCUSTO | CTT_DESC01 | GCCUSTO.NOME | CTT_RES | GCCUSTO.CODREDUZIDO | CTT_BLOQ | GCCUSTO.ATIVO | R_E_C_N_O_ | Utilizado para dar retorno ao barramento – Concluído ou Falha |
Além dos campos detalhados na coluna Campo TOTVS Educacional, será necessário preencher:
- "Envia para SPED Contábil" (GCCUSTO.ENVIASPED) com valor = F.
- "Data da Inclusão" (GCCUSTO.DATAINCLUSAO) com a data corrente.
Item Contábil View - IIFR_CTD010_VW |
| Tabela do RM que será alimentada: SITEMCONTABILPROTHEUS |
| Campo View | Campo RM | CTD_FILIAL
Duas primeiras posições do campo indicam a Empresa Protheus | ZPARAMETROSTEMPLATE.CODIGO = EMPRESAPROTHEUS ZPARAMETROSTEMPLATE.CODCOLIGADA SITEMCONTABILPROTHEUS.CODCOLIGADA | CTD_ITEM | SITEMCONTABILPROTHEUS.ITEMCONTABIL | CTD_DESC01 | SITEMCONTABILPROTHEUS.DESCRICAO | R_E_C_N_O_ | Utilizado para dar retorno ao barramento – Concluído ou Falha |
Classe de Valor View - IIFR_CTH010_VW |
| Tabela do RM que será alimentada: SCLASSEVALORPROTHEUS |
| Campo View | Campo TOTVS Educacional | CTH_FILIAL
Duas primeiras posições do campo indicam a Empresa Protheus | ZPARAMETROSTEMPLATE.CODIGO = EMPRESAPROTHEUS ZPARAMETROSTEMPLATE.CODCOLIGADA SCLASSEVALORPROTHEUS.CODCOLIGADA | CTH_CLVL | SCLASSEVALORPROTHEUS.CLASSEVALOR | CTH_DESC01 | SCLASSEVALORPROTHEUS.DESCRICAO | CTH_CLASSE | SCLASSEVALORPROTHEUS.TIPO | CTH_BLOQ | SCLASSEVALORPROTHEUS.STATUS | R_E_C_N_O_ | Utilizado para dar retorno ao barramento – Concluído ou Falha |
- Natureza Financeira (SED):
Natureza Financeira View - IIFR_SED010_VW |
| Tabela do RM que será alimentada: TTBORCAMENTO |
| Campo View | Campo TOTVS Educacional | ED_FILIAL | TTBORCAMENTO.CODCOLIGADA = 0 (Global) | ED_CODIGO | TTBORCAMENTO.CODTBORCAMENTO | ED_DESCRIC | TTBORCAMENTO.DESCRICAO | ED_TIPO | TTBORCAMENTO.SINTETICOANALITICO | ED_COND | TTBORCAMENTO.NATUREZA | ED_BLOQ | TTBORCAMENTO.INATIVO | R_E_C_N_O_ | Utilizado para dar retorno ao barramento – Concluído ou Falha |
Moeda View - IIFR_CTO010_VW |
| Tabela do RM que será alimentada: TTBORCAMENTO |
| Campo View | Campo TOTVS Educacional | CTO_SIMB | GMOEDA.SIMBOLO | CTO_DESC | GMOEDA.DESCRICAO | R_E_C_N_O_ | Utilizado para dar retorno ao barramento – Concluído ou Falha |
Ao importar o cadastro de Bancos do Protheus, serão preenchidas quatro tabelas no TOTVS Educacional: GBANCO, GAGENCIA, FCONTA e FCXA. Importante: O cadastro de Bancos do Protheus é por Empresa e Filial. O cadastro de banco de TOTVS Educacional é por Coligada. Para resolver este conflito, o cliente disponibilizará na View as informações consolidadas por Empresa, de modo que possam ser importadas para o TOTVS Educacional por Coligada. Banco, Agência e Conta View - IIFR_SA6010_VW |
| Tabelas do RM que serão alimentadas: GBANCO, GAGENCIA, FCONTA |
| Campo View | Campo TOTVS Educacional | A6_FILIAL
Duas primeiras posições do campo indicam a Empresa Protheus | ZPARAMETROSTEMPLATE.CODIGO = EMPRESAPROTHEUS ZPARAMETROSTEMPLATE.CODCOLIGADA GBANCO.CODCOLIGADA, GAGENCIA.CODCOLIGADA, FCONTA.CODCOLIGADA | A6_COD | GBANCO.NUMBANCO | A6_NOME | GBANCO.NOME | A6_NREDUZ | GBANCO.NOMEREDUZIDO | A6_COD | GAGENCIA.NUMBANCO | A6_AGENCIA | GAGENCIA.NUMAGENCIA | A6_END | GAGENCIA.RUA | A6_BAIRRO | GAGENCIA.BAIRRO | A6_MUN | GAGENCIA.CIDADE | A6_CEP | GAGENCIA.CEP | A6_EST | GAGENCIA.ESTADO | A6_TEL | GAGENCIA.TELEFONE | A6_COD | FCONTA.NUMBANCO | A6_AGENCIA | FCONTA.NUMAGENCIA | A6_NUMCON | FCONTA.NROCONTA | R_E_C_N_O_ | Utilizado para dar retorno ao barramento – Concluído ou Falha |
Importante: No cadastro do Protheus, o Banco se repete para cada Agência e Conta cadastrada. Ele deverá ser gravado na tabela GBANCO do TOTVS Educacional apenas uma vez, verificando se já foi importado através do código A6_COD igual a GBANCO.NUMBANCO. O mesmo vale para Agência do Banco, que só precisa ser gravada na tabela GAGENCIA quando não existir outro registro para o mesmo Banco (GAGENCIA.NUMBANCO) com o campo A6_AGENCIA igual a GAGENCIA.NUMAGENCIA. Cada Conta importada (vínculo entre Banco, Agência e Conta) deverá gerar uma Conta Caixa no TOTVS Educacional. Ao gerar a Conta Caixa, será necessário preencher os campos básicos (a aba Integração bancária. Os campos serão preenchidos conforme abaixo:
Conta Caixa View - IIFR_SA6010_VW |
| Tabelas do RM que serão alimentadas: FCXA |
| Campo View | Campo TOTVS Educacional | A6_FILIAL
Duas primeiras posições do campo indicam a Empresa Protheus | ZPARAMETROSTEMPLATE.CODIGO = EMPRESAPROTHEUS ZPARAMETROSTEMPLATE.CODCOLIGADA FCXA.CODCOLIGADA | A6_CONTA | FCXA.CODCXA | A6_CONTA | FCXA.DESCRICAO | A6_COD | FCXA.NUMBANCO | A6_AGENCIA | FCXA.NUMAGENCIA | A6_NUMCON | FCXA.NROCONTA |
Produto View - IIFR_SB1010_VW |
| Tabela do RM que será alimentada: TPRODUTO |
| Campo View | Campo TOTVS Educacional | B1_FILIAL | TPRODUTO.CODCOLIGADA = 0 (Global) | B1_COD | TPRODUTO.CODIGOPRD | B1_DESC | TPRODUTO.NOMEFANTASIA | B1_DESC | TPRODUTO.DESCRICAO | B1_ATIVO | TPRODUTO.INATIVO | B1_UM | TPRODUTODEF.CODUNDCONTROLE | R_E_C_N_O_ | Utilizado para dar retorno ao barramento – Concluído ou Falha |
O cadastro de Produtos do TOTVS Educacional será Global, equivalente ao cadastro compartilhado do Protheus. Todos os registros serão importados com o tipo igual a Serviço (TPRODUTO.TIPO = S). Todos serão importados como último nível (TPRODUTO.ULTIMONIVEL = 1) e não serão importados grupos e subgrupos do Protheus. Além dos campos definidos acima, será preenchido ainda o campo TPRODUTO.DTCADASTRAMENTO, com a data corrente. Importante: todos os produtos que estiverem disponíveis no barramento (View) serão importados para o TOTVS Educacional. É responsabilidade do Cliente/Protheus classificar os produtos cadastrados a fim de identificar os que precisam ser enviados ao TOTVS Educacional.
Plano de Contas View - IIFR_CT1010_VW |
| Tabela do RM que será alimentada: CCONTA |
| Campo View | Campo TOTVS Educacional | CT1_FILIAL
Duas primeiras posições do campo indicam a Empresa Protheus | ZPARAMETROSTEMPLATE.CODIGO = EMPRESAPROTHEUS ZPARAMETROSTEMPLATE.CODCOLIGADA CCONTA.CODCOLIGADA | CT1_CONTA | CCONTA.CODCONTA | CT1_RES | CCONTA.REDUZIDO | CT1_DESC01 | CCONTA.DESCRICAO | CT1_NORMAL | CCONTA.NATUREZA | CT1_CLASSE | CCONTA.ANALITICA | CT1_BLOQ | CCONTA.INATIVA |
Além dos campos definidos acima, serão preenchidos os campos: - "Natureza da Conta para Emissão de SPED" (CCONTA.NATSPED) com o valor "Não Informada";
- "Data de Inclusão" (CCONTA.DATAINCLU) com a data corrente.
Ao executar, o processo customizado irá fazer a conexão com o barramento IIF e consultar as Views pré-definidas para cada cadastro. Para cada registro selecionado em cada uma das Views, será executada funcionalidade nativa do TOTVS Educacional para inclusão/atualização do registro no banco de dados, sendo validadas todas as regras de negócio padrão. Após validações, as tabelas correspondentes do TOTVS Educacional serão preenchidas com os dados das Views. As Views do barramento deverão retornar apenas registros ainda não importados pelo TOTVS Educacional. Para isso, ao finalizar a importação dos dados, a customização deverá executar uma procedure do barramento (IIFR_STATUS_REPLICACAO_PRC) que será responsável por marcar o registro como já integrado. Desta forma, o barramento conseguirá mostrar nas Views apenas os registros pendentes de integração. A procedure IIFR_STATUS_REPLICACAO_PRC deverá receber o mnemônico da tabela, o R_E_C_N_O_ do registro do Protheus e o status do registro: 'C' para Concluído ou 'F' para Falha. Assinatura da Procedure: IIFR_STATUS_REPLICACAO_PRC(TABELA, R_E_C_N_O_, STATUS DEFAULT 'C'). Exemplo: IIFR_STATUS_REPLICACAO_PRC('CTT', 1807, 'C'). Ao final do processo, será gerado um log da execução, contendo informações como: Views consultadas, número de registros importados e mensagem de erro, caso ocorra. Este log será gravado em tabelas nativas do TOTVS Educacional e estará disponível para visualização através da interface - menu Ambiente, Gerenciamento de Jobs. Importante:
- Somente os cadastros mencionados acima serão sincronizados de forma automática através do processo de importação.
- As informações de Empresa/Coligada e Filial não serão sincronizadas entre os dois sistemas, sendo necessário realizar o cadastro manual nos dois sistemas. As Views consultadas nestes requisitos deverão trazer o código da Empresa (duas primeiras posições do campo Filial-Protheus), possibilitando a associação entre a Empresa (Protheus) e a Coligada (TOTVS Educacional).
- A regra para ocultar/mostrar registros integrados ou não nas Views e a criação do pacote para atualização de registros processados são tratados pelo barramento e é de responsabilidade do Cliente.
- A pedido do cliente, a chave R_E_C_N_O_ do Protheus não será armazenada no TOTVS Educacional. Segundo o cliente, como este é um número sequencial, ele poderá não refletir o código correto em determinadas situações.
- Não será necessário preencher o Código da Filial no cadastro das entidades importadas acima no TOTVS Educacional. Portanto, não utilizaremos o Código da Filial do Protheus nesta importação.
- Não está prevista integração de dados de Parâmetros de Banco, Contrato de Banco e Dados do convênio. Estas parametrizações deverão ser informadas manualmente nos dois sistemas.
- Não está prevista integração de dados de Tipo de Documento (X5), já que será utilizado apenas um código que será fixo no Protheus.
As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS. Image Modified Fig.1 – Tela de Agendamento e Execução do Job |