Versões comparadas

Chave

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

Projeto FS007779 (873247-874083) - Integração SGE x Protheus – Parte1


Projeto: FS007779 (873247-874083) - Parte 1


Modelo de Solução



Importante: Observe que no modelo de solução apresentado, conforme solicitado pela FIERGS, não existe comunicação direta entre o TOTVS EDUCACIONAL e o PROTHEUS. Toda integração será via barramento IIF, sendo este responsável por integrar a informação no Protheus.
Nos requisitos descritos abaixo, é mencionado que o TOTVS Educacional disponibiliza ou consulta dados das tabelas do banco de integração. Para tal, serão utilizados Views, Functions, Procedures e Packages a serem disponibilizados pela equipe FIERGS, não sendo realizadas operações (insert, update, delete) diretamente no banco de dados.




Processo Automático de Importação de Cadastros Básicos (Protheus => SGE)
Anexo Customizado de Item Contábil no Cadastro de Modalidade
Anexo Customizado de Dados Financeiros no Cadastro de Matriz Aplicada
Processo Customizado para Validar Item Contábil e Centro de Custo no Cadastro de Matriz Aplicada
Anexo Customizado de Dados Financeiros no Cadastro de Turma
Processo Customizado para Validar Item Contábil e Centro de Custo no Cadastro de Turma

...

Expandir
titleAnexo Customizado no Cadastro de Serviços

Descrição do processo


Criação de um anexo customizado no cadastro de serviços, disponível em TOTVS Educacional | Financeiro/Contábil | Serviços, em que o usuário faz a parametrização de informações necessárias para criação do pedido de venda no Protheus.


Detalhamento do processo


O usuário deve selecionar o Serviço para o qual deseja informar os parâmetros, clicar em Anexos – Integração Protheus (Fig.1). Será exibida tela (Fig.2) com . A tela possui os seguintes campos disponíveis:

  • Natureza Financeira: campo em formato lista, onde o usuário poderá pode selecionar o código da natureza financeira que será utilizada para Serviço. A lista de Naturezas será é obtida através da tabela nativa de Natureza Orçamentária Financeira do TOTVS Educacional (TTBORCAMENTO), que será preenchida com os dados do cadastro de Natureza do Protheus, através do processo definido no Req.03.


  • Produto: campo em formato lista, onde o usuário poderá selecionar o código do produto que será utilizado para o Serviço. A lista de Produtos será obtida através da tabela nativa do TOTVS Educacional (TPRODUTO), que será preenchida com os dados do cadastro de Produtos do Protheus, através do processo definido no Req.03.Processo Automático de Importação de Cadastros Básicos (Protheus => SGE).


  • TES: campo em formato lista, onde o usuário poderá pode selecionar um código de TES que será utilizado para o Serviço. Para seleção da TES, a customização irá consultar consulta a View IIFR_SF4010_VW do barramento IIF que retornará retorna uma lista de registros para o usuário selecionar um item.


  • Série: campo texto onde o usuário informará informa a série que será utilizada pelo Serviço, quando gerar o Pedido no Protheus.


  • Prefixo: campo texto onde o usuário informará informa a o prefixo do documento que será utilizada pelo Serviço, quando gerar o Pedido no Protheus.


Os dados informados nesta interface serão são armazenados em tabela customizada, por Serviço e Coligada. Será necessário informar estes parâmetros para cada serviço que for utilizado pela Integração Protheus.
Cada Serviço poderá ter somente um registro de anexo vinculado. O serviço "MENSALIDADE BALCÃO" por exemplo, na coligada SESI terá apenas uma natureza financeira, produto, TES, serie e prefixo associado. Mas dentro da mesma coligada poderemos ter outro serviço "MENSALIDADE INDUSTRIA' e nele teremos outros anexos, natureza financeira, produto, TES, serie e prefixo associado.
Os dados do cadastro da TES não serão armazenados em tabelas do TOTVS Educacional. A consulta para mostrar a lista será feita diretamente no barramento IIF.
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.





...


Expandir

...

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

...

Image Modified

  • Descrição do Processo

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.

  • 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


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


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 (CTD):


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 (CTH):


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 (CTO):


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

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 (SB1):


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 (CT1):



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:

  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 Modified
Fig.1 – Tela de Agendamento e Execução do Job



Âncora
_Toc488661482
_Toc488661482
Req. 04 – Anexo customizado de Item Contábil no cadastro de Modalidade

...