Fábrica de Software TOTVS BH

Atalhos

Páginas filhas
  • Manual - Integração SGE x Protheus

Versões comparadas

Versão antiga 15

changes.mady.by.user Ana Luiza Martins Moreira

Gravado em

comparado com

Nova versão 16

changes.mady.by.user Ana Luiza Martins Moreira

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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 (CTT):
CTT_FILIAL
Duas primeiras posições do campo indicam a Empresa ProtheusAlé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 (CTD):
CTD_FILIAL
Duas primeiras posições do campo indicam a Empresa Protheus
    • Classe de Valor (CTH):
CTH_FILIAL
Duas primeiras posições do campo indicam a Empresa Protheus
    • Natureza Financeira (SED):
    • Moeda (CTO):
    • Banco (SA6):

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.

A6_FILIAL
Duas primeiras posições do campo indicam a Empresa ProtheusImportante: 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:A6_FILIAL
Duas primeiras posições do campo indicam a Empresa Protheus
    • Produto (SB1):
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 (CT1):
CT1_FILIAL
Duas primeiras posições do campo indicam a Empresa Protheus

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

.


Detalhamento do processo


Este processo pode ser executado manualmente ou agendado de acordo com os intervalos parametrizados pelo usuário através da tela disponível em TOTVS Educacional | Customização | Importação de Cadastros Básicos.


Ao ser executado, o processo consulta as views disponíveis no barramento IIF:

Expandir
titleProcesso Automático de Importação de Cadastros Básicos (Protheus => SGE)

Pré-requisitos

Não se aplica.

Image Removed


Descrição do

Processo1. No TOTVS Educacional usuário acessa o menu Customização | Importação de Cadastros Básicos do Protheus

processo

Importação de cadastros básicos do barramento IIF 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.
  • Detalhamento de Cálculos

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

Centro de Custo
View - IIFR_CTT010_VW

Tabela do RM que será alimentada: GCCUSTO

Campo View

Campo TOTVS Educacional

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

Item Contábil
View - IIFR_CTD010_VW

Tabela do RM que será alimentada: SITEMCONTABILPROTHEUS

Campo View

Campo RM

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

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

Banco, Agência e Conta
View - IIFR_SA6010_VW

Tabelas do RM que serão alimentadas: GBANCO, GAGENCIA, FCONTA

Campo View

Campo TOTVS Educacional

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

Conta Caixa
View - IIFR_SA6010_VW

Tabelas do RM que serão alimentadas: FCXA

Campo View

Campo TOTVS Educacional

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

Plano de Contas
View - IIFR_CT1010_VW

Tabela do RM que será alimentada: CCONTA

Campo View

Campo TOTVS Educacional

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

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


Os resultados das consultas criarão seus respectivos registros no TOTVS Educacional na Coligada adequada. 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.

Detalhes dos dados importados podem ser consultados no documento de Especificação Funcional.


Nota
titlePontos de Atenção
  • 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.
  • A máscara do centro de custo do RM deverá ser do tamanho 20 (número máximo no Protheus) e sem pontos, para não ser obrigatória a validação de níveis cadastrados. Ela deverá ser definida em TOTVS Gestão Contábil | Ambiente | Parâmetros | TOTVS Gestão Contábil | Lançamentos | Centro de Custos.
  • Para que a natureza seja Global, é necessário preencher o parâmetro Será global (Parâmetro em TOTVS Gestão de Estoque, Compras e Faturamento | Ambiente | Parâmetros | Tabelas | Natureza Orçamentária/Financeira).
    A máscara da natureza precisa ser configurada para atender os requisitos do código do Protheus, e eventualmente, alguns códigos do Protheus precisarão ser ajustados, já que não são aceitos alguns caracteres no campo código. O quadro abaixo define as possibilidades no RM:

Observação: Atualmente, a máscara utilizada no Protheus para FIERGS é ######## (8 números)

  • A máscara do Produto deverá ser configurada para não controlar níveis (Opções para a Máscara: Não controla níveis de máscara) e sem pontos, para não ser obrigatória a validação de níveis cadastrados. Ela deverá ser definida em TOTVS Gestão de Estoque, Compras e Faturamento | Ambiente | Parâmetros | Gestão de Estoque, Compras e Faturamento | Parâmetros Gerais | Tabelas | Produtos | Definições de Produto 1/3. No mesmo caminho, na aba Produto Global, marcar parâmetro Usa Produto Global.
  • O Plano de Contas Contábil deverá estar configurado para não utilizar máscara, nos parâmetros do TOTVS Gestão Contábil, etapa, marcar o campo Não utilizar Máscara. Este parâmetro precisa ser ajustado em todas as coligadas. Além disso, é necessário cadastrar no RM as contas sintéticas, quando não estiverem disponíveis para importação no Protheus. São elas:
  • Ativo
  • Passivo
  • Despesas
  • Receitas
  • Variações Patrim e Financ – Ativa
  • Variações Patrim e Financ – Passiva
  • Resultado exercício


Análise de Impacto

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:
  1. Somente os cadastros mencionados acima serão sincronizados de forma automática através do processo de importação.
  2. 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).
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  • Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.
Image Removed


Ao efetuar a importação do cadastro de Natureza Financeira do Protheus para o RM, o campo ED_CALCINS disponível na visão de Naturezas IIFR_SED010_VW será copiado para o RM. Quando preenchido com 'S', o campo 'Campo Livre' do cadastro da Natureza (TTBORCAMENTO.CAMPOLIVRE) será preenchido com o valor 'RETEMINSS'. Quando o campo estiver preenchido com 'N' ou vazio, o campo 'Campo Livre' ficará vazio.
Image Modified
Essa informação é utilizada para que o SGE identifique quando o imposto INSS precisará ser calculado no Contrato Corporativo. Quando a Natureza com essa configuração estiver associada ao Serviço (Anexo de Dados Financeiros – Item do Contrato Corporativo), o imposto será calculado. A Natureza do Contrato não será utilizada para este cálculo.
O percentual de alíquota do imposto não será importado, já que no TOTVS RM não existe um campo na Natureza para armazenar a informação. A alíquota será parametrizada no TOTVS RM, no Tipo de Movimento gerado a partir do faturamento/medição do contrato.


Expandir
titleAnexo customizado de Item Contábil no cadastro de Modalidade



  • Descrição do Processo

1. No TOTVS Educacional usuário acessa menu Currículo e Oferta | Estrutura curricular | Mais | Modalidades do Curso | Anexos | Item Contábil.
2. Visão customizada do Anexo é exibida.
3. Usuário insere/altera/exclui registro.
4. Rotina armazena informações em tabela customizada.
5. Fim do processo.

  • Detalhamento de Cálculos

Não se aplica.

  • Detalhamento de Processos Específicos

No TOTVS Educacional por meio do menu Currículo e Oferta | Estrutura curricular | Mais | Modalidades do Curso, será criado um anexo customizado para que sejam informados os Itens Contábeis vinculados às Modalidades do Curso.
Neste anexo, será disponibilizado um campo do tipo lookup que referenciará a tabela SITEMCONTABILPROTHEUS. Os registros exibidos no lookup serão filtrados pela Coligada do contexto.
As informações serão armazenadas em uma tabela customizada (ZIPMODALIDADEITEMCONTABIL) cujo detalhamento de dados segue abaixo.

ZIPMODALIDADEITEMCONTABIL


Propriedade

Descrição

CODCOLIGADA

Código da Coligada do Contexto

CODMODALIDADECURSO

Código da Modalidade do Curso

IDITEMCONTABIL

Identificador do Item Contábil


PONTOS DE ATENÇÃO:
1. Nesta interface, o usuário poderá incluir, editar e excluir registros. O usuário poderá selecionar somente Itens Contábeis vindos do Protheus, não podendo incluir manualmente novo Item Contábil sem que seja validado na tabela SITEMCONTABILPROTHEUS.
2. As informações serão armazenadas em uma tabela customizada (ZIPMODALIDADEITEMCONTABIL).
3. Para cada Modalidade poderão ser vinculados vários Itens Contábeis de acordo com a necessidade do usuário.
4. O acesso a esta interface será controlado pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.

  • Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.

Fig.1 – Menu do Anexo

Fig.2 – Visão do Anexo


Fig.3 – Formulário de Edição

...