Fábrica de Software TOTVS BH

Atalhos

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

Versões comparadas

Versão antiga 18

changes.mady.by.user Ana Luiza Martins Moreira

Gravado em

comparado com

Nova versão 19

changes.mady.by.user Ana Luiza Martins Moreira

Gravado em

Chave

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

...

Projeto: FS007779 (873247-874083) - Parte 1

Data: 18/09/2017


Todas as funcionalidades descritas neste manual têm como base do que está descrito no documento “Especificação Anexo I – Detalhamento Funcional – FS007779 – Parte 1". 


Expandir
titleParâmetros da Customização

Descrição do processo


Parâmetros necessários para a Integração de dados entre o TOTVS Educacional (SGE) e o Protheus.


Detalhamento do processo


A tela de parâmetros esta disponível em TOTVS Educacional | Customização | Parâmetros da Integração - TOTVS Educacional (SGE) x Protheus e exibe uma visão com a lista de parâmetros disponíveis para configuração. São eles:



  • Servidor Barramento: endereço de acesso ao banco de dados correspondente ao barramento IIF disponibilizado pelo cliente.

  • Usuário: usuário para conexão com o banco de dados do barramento IIF.

  • Senha: senha do usuário informado para conexão com banco de dados do barramento IIF. O campo é salvo criptografado.

  • Empresa Protheus: código da Empresa do Protheus correspondente à Coligada da parametrização no TOTVS Educacional. Este campo é utilizado para efetuar o De-Para entre Coligada e Empresa.

  • Habilita Integração: campo que define se a integração estará habilitada (valor igual a um) ou desabilitada (valor igual a zero). Este parâmetro é verificado antes de cada gatilho que efetua importação ou exportação de dados referentes à integração (plug-ins, processos customizados). Caso esteja desmarcado, os gatilhos não são executados.

  • Condição de Pagamento: código da condição de pagamento que é utilizada ao enviar o Pedido para o Protheus. O cadastro de condição de pagamento do Protheus não é sincronizado com o TOTVS Educacional (SGE) sendo sempre enviado no pedido o valor parametrizado neste campo (Atualmente o cliente utiliza a condição de pagamento = 9).

  • Código do Tipo de Baixa – Cancelamento: código do tipo de baixa por cancelamento que será enviado ao Protheus, nas situações de cancelamento de lançamentos.

  • Código do Tipo de Baixa – Cartão de Crédito: código do tipo de baixa por cartão de crédito que será enviado ao Protheus, nas situações de baixa de lançamento com a forma de pagamento igual a cartão de crédito.


Os campos acima são de preenchimento livre. Não existe lista para buscar os cadastros e selecionar os códigos. Os códigos devem ser informados diretamente nos campos.



É necessário fazer o cadastro dos parâmetros em todas as Coligadas que utilizarão a integração. As informações são armazenadas em tabela customizada (ZPARAMETROTEMPLATE), por coligada.


O acesso à parametrização é pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.


Importante: O preenchimento dos parâmetros é de responsabilidade do cliente. Para o correto funcionamento da customização, todos os dados devem estar parametrizados corretamente.



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. A tela possui  A partir do Serviço selecionado, são disponibilizados os seguintes campos disponíveispara preenchimento: 


  • Natureza Financeira: campo em formato lista, onde o usuário  usuário pode selecionar o código da natureza financeira que será utilizada para Serviço. A lista de Naturezas é 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: usuário 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 Automático de Importação de Cadastros Básicos (Protheus => SGE).


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


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


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


Estas informações são imprescindíveis para os serviços utilizados na integração com Protheus e os dados serão armazenados em tabela customizada por Serviço e Coligada.

Os dados das TES serão consultados diretamente no barramento IIF (visão do banco de dados: IIFR_SF4010_VW) e, portanto, não ficarão gravados em nenhuma tabela do TOTVS Educacional.

Além dos campos do anexo customizado, é necessário configurar no Serviço a Natureza orçamentária, que será utilizada no processo de Exportação de Pedido de Venda.


Image Added

Image AddedOs dados informados nesta interface são armazenados 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.Image Removed
Image Removed

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

Pré-requisitos

Não se aplica.


Descrição do processo


Importação de cadastros básicos do barramento IIF para o TOTVS Educacional.


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:

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:


Image Modified


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:

    1. Ativo

    2. Passivo

    3. Despesas

    4. Receitas

    5. Variações Patrim e Financ – Ativa

    6. Variações Patrim e Financ – Passiva

    7. Resultado exercício


Análise de Impacto


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.



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.


...