Manual Operacional - Integração SGE x Protheus

...

Projeto: FS007779 (873247-874083) - Parte 1

...

Todas as funcionalidades descritas neste manual têm como base do que está descrito nos documentos:

• Especificação Anexo I – Detalhamento Funcional – FS007779 – Parte 1
• Especificação Anexo I – Detalhamento Funcional – FS007779 – Parte 2
• Análise de Impacto I - Especificação - FS007780 (873247 – 874083) – Integração RM com Protheus – Parte 2 - * Integração Financeira e Contábil entre Contratos Corporativos TOTVS (Turma in Company) e Protheus.
• Especificação Anexo I – Detalhamento Funcional – FS007779 – Parte 3
• Detalhamento Funcional – FS008363 – Pagamento On-line (Cartão de Crédito)

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 os seguintes campos disponíveis:

• Natureza Financeira: campo em formato lista, onde o 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: 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 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 informa a série que será utilizada pelo Serviço, quando gerar o Pedido no Protheus.

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

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

Expandir
title Parâ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.
Expandir
title Parâ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. Image Removed É 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
title Anexo Customizado no Cadastro de Serviços
Delay dos lançamentos considerados para exportação de pedido de venda em minutos: Determina o delay, em minutos, para que os pedidos de venda sejam exportados para o Protheus. Ou seja, se o job de Exportação de Pedido de Venda seja executado às 14h:00m e o parâmetro possua o valor de delay de 5 min, somente serão enviados para o Protheus aqueles lançamentos que foram criados até o horário de 13h:55m. Este campo deverá ser preenchido com um valor inteiro, positivo e, quando não preenchido, terá o delay de 2 minutos por padrão. 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. Image Added É 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
title Anexo 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 partir do Serviço selecionado, são disponibilizados os seguintes campos para preenchimento:  Natureza Financeira: 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. Produto: 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: 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: usuário informa a série que será utilizada pelo Serviço, quando gerar o Pedido no Protheus. Prefixo: 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 Added

Image Removed
Image Removed

Expandir
title Processo 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
Expandir
title Processo 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 title Pontos 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: Ativo Passivo Despesas Receitas Variações Patrim e Financ – Ativa Variações Patrim e Financ – Passiva 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.

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.
Image Removed
Fig.1 – Menu do Anexo
Image Removed
Fig.2 – Visão do Anexo
Image Removed
Fig.3 – Formulário de Edição

Expandir
title Anexo customizado de Item Contábil no cadastro de Modalidade
Pré-requisitos Não se aplica.Image Removed Descrição do Processo1. No TOTVS Educacional usuário acessa menu processo Disponibilização do anexo customizado “Item Contábil” em TOTVS Educacional | 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
Expandir
title Anexo customizado de Dados Financeiros no cadastro de Matriz Aplicada
Detalhamento do processo Image Added Image Added O lookup visível nesta tela apresentará os registros da tabela SITEMCONTABILPROTHEUS filtrados pela Coligada do contexto. A informação aqui definida será gravada na tabela customizada ZIPMODALIDADEITEMCONTABIL com base nos itens contábeis provenientes do Protheus. Não será possível incluir manualmente um novo item contábil sem que seja validado na tabela SITEMCONTABILPROTHEUS. Image Added Para cada modalidade podem ser vinculados vários itens contábeis. Na Coligada 2, o menu de Modalidade não está disponível no mesmo caminho. Para acessá-lo, é necessário visualizar o cadastro do Curso, clicar no nome da Modalidade e em seguida, selecionar o anexo. Caso seja necessário acessar lista de Modalidades, basta clicar no botão logo a frente do nome da Modalidade, selecionar o item desejado e clicar em Editar Image Added

Expandir
title Anexo customizado de Dados Financeiros no cadastro de Matriz Aplicada
Pré-Requisitos Não se aplica. Descrição do processo Disponibilização do anexo customizado “Dados financeiros – Integração Protheus” em TOTVS Educacional | Currículo e Oferta | Estrutura curricular | Matriz curricular | Anexos | Matriz Aplicada. Image Added Detalhamento do processo Nesta tela haverá dois campos que farão referência às tabelas SITEMCONTABILPROTHEUS (Item Contábil) e SCLASSEVALORPROTHEUS (Classe de Valor) filtrados pela Coligada do contexto. A informação aqui definida será gravada na tabela customizada ZIPMATRIZDADOSFINANCEIROS. Image Added Ao salvar o registro a customização validará os seguintes pontos caso o Item Contábil esteja preenchido: O Curso da Matriz Aplicada associada ao anexo que está sendo salvo possui Modalidade? O Item Contábil informado está vinculado à Modalidade do Curso? Caso alguma das afirmativas acima não seja verdadeira, será emitida uma mensagem de consistência e não será possível salvar o anexo. Para cada Matriz Aplicada poderá ser vinculado apenas um Item Contábil e uma Classe de Valor.

No momento que o usuário salvar o anexo de Dados Financeiros se o Item Contábil estiver preenchido serão realizadas as seguintes validações:

1. O Curso da Matriz Aplicada associada ao anexo que está sendo salvo possui Modalidade?
2. O Item Contábil informado está vinculado à Modalidade do Curso (Req. 04)?

Se o Curso da Matriz Aplicada não possuir Modalidade de Curso associada, ou se a Modalidade do Curso da Matriz Aplicada não estiver associada ao Item Contábil informado (Req.04), será exibida mensagem de erro, impossibilitando salvar o anexo.
Portanto, só será possível salvar o anexo se o Item Contábil e a Modalidade estiverem vinculados no TOTVS Educacional.
PONTOS DE ATENÇÃO:
1. Nesta interface, o usuário poderá incluir e editar registros. O usuário poderá selecionar somente Itens Contábeis e Classes de Valor vindos do Protheus, não podendo incluir manualmente sem que sejam validados nas tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS respectivamente.
2. As informações serão armazenadas em uma tabela customizada (ZIPMATRIZDADOSFINANCEIROS).
3. Para cada Matriz Aplicada poderá ser vinculado apenas um Item Contábil e uma Classe de Valor.
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.
Image Removed
Fig.1 – Menu Anexo
Image Removed

Detalhamento do processo

No momento que uma Matriz Aplicada for salva, se houver Item Contábil vinculado, a Customização fará as seguintes validações:

• O Curso da Matriz Aplicada que está sendo salva possui Modalidade?
• O Item Contábil da Matriz Aplicada está vinculado à Modalidade do Curso?
• A Matriz Aplicada que está sendo salva possui Centro de Custo?
• O Item Contábil e o Centro de Custo da Matriz Aplicada estão associados entre si no Protheus?

Caso alguma das afirmativas acima não seja verdadeira, será emitida uma mensagem de consistência e não será possível salvar a Matriz Aplicada

O vínculo entre Item Contábil e Centro de Custo será validado no Protheus a partir da view IIFR_CTA010_VW. A consulta é por Coligada e para tal será considerada a Empresa Protheus parametrizada. O valor do campo EMPRESAPROTHEUS deverá ser recuperado da tabela ZPARAMETROTEMPLATE e passado como filtro para a View.

Expandir
title Processo customizado para validar Item Contábil e Centro de Custo no cadastro de Matriz Aplicada
Pré-Requisitos Não se aplica. Descrição do processo Disponibilização do plugin no evento do Botão Salvar/OK do cadastro de Matriz Aplicada acessado através do menu TOTVS Educacional | Fluxo do Processo Image Removed Descrição do Processo 1. No TOTVS Educacional usuário acessa menu Currículo e Oferta | Estrutura curricular | Matriz curricular | Anexos | Matriz Aplicada | Anexos | Dados Financeiros – Integração Protheus . 2. Interface customizada do anexo é exibida. 3. Usuário insere/altera 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 | Matriz curricular | Anexos | Matriz Aplicada, será criado um anexo customizado para que seja informado o Item Contábil e a Classe de Valor vinculados às Matrizes Aplicadas. Neste anexo, serão disponibilizados dois campos do tipo lista que farão referência às tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS. Os registros exibidos nas listas serão filtrados pela Coligada do contexto. As informações serão armazenadas em uma tabela customizada (ZIPMATRIZDADOSFINANCEIROS) cujo detalhamento de dados segue abaixo.	ZIPMATRIZDADOSFINANCEIROS
Propriedade	Descrição
CODCOLIGADA	Código da Coligada do Contexto
IDHABILITACAOFILIAL	Identificador da Matriz Aplicada
IDITEMCONTABIL	Identificador do Item Contábil
IDCLASSEVALOR	Identificador da Classe de Valor

Expandir
title Anexo customizado de Dados Financeiros no cadastro de Turma
Pré-requisitos Não se aplica. Descrição do processo Disponibilização do anexo customizado “Dados financeiros – Integração Protheus” em TOTVS Educacional | Currículo e Oferta | Oferta | Turmas. Detalhamento do processo Nesta tela haverá dois campos que farão referência às tabelas SITEMCONTABILPROTHEUS (Item Contábil) e SCLASSEVALORPROTHEUS (Classe de Valor) filtrados pela Coligada do contexto. A informação aqui definida será gravada na tabela customizada ZIPTURMADADOSFINANCEIROS. Image Added Ao salvar o registro a customização validará os seguintes pontos caso o Item Contábil esteja preenchido: O Curso da Turma associada ao anexo que está sendo salvo possui Modalidade? O Item Contábil informado está vinculado à Modalidade do Curso ? Caso alguma das afirmativas acima não seja verdadeira, será emitida uma mensagem de consistência e não será possível salvar o anexo. Para cada Turma poderá ser vinculado apenas um Item Contábil e uma Classe de Valor. Dependendo da situação, o Item Contábil pode ser informado na Turma ou na Matriz Aplicada. Nos casos onde for informado em ambos, o Item Contábil da Turma deve prevalecer para a integração.

• Descrição do Processo

1. No TOTVS Educacional usuário acessa Currículo e Oferta | Oferta | Turmas | Anexos | Dados Financeiros – Integração Protheus.
2. Interface customizada é exibida.
3. Usuário insere/altera/exclui registro.
4. Rotina armazena informações em tabela customizada.
5. Fim do fluxo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

No TOTVS Educacional por meio do menu Currículo e Oferta | Oferta | Turmas, será criado um anexo customizado para que seja informado o Item Contábil e a Classe de Valor vinculados às Turmas.
Neste anexo, serão disponibilizados dois campos do tipo lista que farão referência às tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS. Os registros exibidos nas listas serão filtrados pela Coligada do contexto.
As informações serão armazenadas em uma tabela customizada (ZIPTURMADADOSFINANCEIROS) cujo detalhamento de dados segue abaixo.

No momento que o usuário salvar o anexo de Dados Financeiros se o Item Contábil estiver preenchido serão realizadas as seguintes validações:

1. O Curso da Turma associada ao anexo que está sendo salvo possui Modalidade?
2. O Item Contábil informado está vinculado à Modalidade do Curso (Req. 04)?

Se o Curso da Turma não possuir Modalidade de Curso associada, ou se a Modalidade do Curso da Turma não estiver associada ao Item Contábil informado (Req.04), será exibida mensagem de erro, impossibilitando salvar o anexo.
Portanto, só será possível salvar o anexo se o Item Contábil e a Modalidade estiverem vinculados no TOTVS Educacional.
PONTOS DE ATENÇÃO:
1. Nesta interface, o usuário poderá incluir e editar registros. O usuário poderá selecionar somente Itens Contábeis e Classes de Valor vindos do Protheus, não podendo incluir manualmente sem que sejam validados nas tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS respectivamente.
2. As informações serão armazenadas em uma tabela customizada (ZIPTURMADADOSFINANCEIROS).
3. Para cada Turma poderá ser vinculado apenas um Item Contábil e uma Classe de Valor.
4. Dependendo da situação, o Item Contábil pode ser informado na Turma ou na Matriz Aplicada. Nos casos onde for informado em ambos, o Item Contábil da Turma deve prevalecer para a integração.
5. 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.
Image Removed
Fig.1 – Menu do Anexo
Image Removed
Fig.2 – Anexo Dados financeiros – Integração Protheus

Expandir
title Processo customizado para validar Item Contábil e Centro de Custo no cadastro de Matriz AplicadaTurma
Pré-requisitos Não se aplica.  Descrição do Processo1. No TOTVS Educacional usuário acessa processo Disponibilização do plugin no evento do Botão Salvar/OK do cadastro de Turma acessado através do menu TOTVS Educacional | Currículo e Oferta | Estrutura Curricular | Matrizes curriculares | Anexos | Matriz Aplicada. 2. Visão nativa é exibida. 3. Usuário inclui/altera registro e clica em salvar. 4. Item Contábil e Modalidade vinculados? 4.1. Sim. Executa passo 5. 4.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Matriz Aplicada. 5. Item Contábil e Centro de Custo vinculados? 5.1. Sim. Informações da Matriz Aplicada são salvas. 5.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Matriz Aplicada 6. Fim do processo. Detalhamento de Cálculos Não se aplica. Detalhamento de Processos Específicos Será criado um plugin customizado que interceptará o evento do botão Salvar/OK do cadastro de Matriz Aplicada acessado através do menu TOTVS Educacional | Currículo e Oferta | Estrutura curricular | Matriz curricular | Anexos | Matriz Aplicada. No momento que o usuário salvar uma Matriz Aplicada e se houver Item Contábil vinculado à ela, serão realizadas as seguintes validações. O Curso da Matriz Aplicada que está sendo salva possui Modalidade? O Item Contábil da Matriz Aplicada (Req. 05) está vinculado à Modalidade do Curso (Req. 04)? A Matriz Aplicada que está sendo salva possui Centro de Custo? O Item Contábil e o Centro de Custo da Matriz Aplicada estão associados entre si no Protheus? Se alguma das condições acima não for satisfeita, uma mensagem customizada será exibida ao usuário e ele será impossibilitado de salvar a Matriz Aplicada. Portanto, o usuário só conseguirá salvar as informações se o Item Contábil e a Modalidade estiverem vinculados no SGE e se o Item Contábil e o Centro de Custo estiverem vinculados no Protheus. Para essa validação, o Protheus disponibilizará uma View (IIFR_CTA010_VW) que informará o vínculo entre Item Contábil e Centro de Custo. A consulta deverá ser feita por Coligada. Para isso, será considerada a Empresa Protheus parametrizada através do Req. 01. O valor do campo EMPRESAPROTHEUS deverá ser recuperado da tabela ZPARAMETROTEMPLATE e passado como filtro para a View.
Expandir
title Anexo customizado de Dados Financeiros no cadastro de Turma
ZIPTURMADADOSFINANCEIROS
Propriedade	Descrição
CODCOLIGADA	Código da Coligada do Contexto
CODTURMA	Código da Turma
IDITEMCONTABIL	Identificador do Item Contábil
IDCLASSEVALOR	Identificador da Classe de Valor

Expandir
title Processo customizado para validar Item Contábil e Centro de Custo no cadastro de Turma
Descrição do Processo 1. No TOTVS Educacional usuário acessa Currículo e Oferta | Oferta | Turmas. 2. Visão nativa é exibida. 3. Usuário inclui/altera registro e clica em salvar. 4. Item Contábil e Modalidade vinculados? 4.1. Sim. Executa passo 5. 4.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Turma. 5. Item Contábil e Centro de Custo vinculados? 5.1. Sim. Informações da Turma são salvas. 5.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Turma 6. Fim do processo. Detalhamento de Cálculos Não se aplica. Detalhamento de Processos Específicos Será criado um plugin customizado que interceptará o evento do botão Salvar/OK do cadastro de Turma acessado através do menu TOTVS Educacional | Currículo e Oferta | Oferta | Turmas. No momento que o usuário salvar uma Turma e se houver Item Contábil vinculado à ela, serão realizadas as seguintes validações. O Curso da Turma que está sendo salva possui Modalidade? O Item Contábil da Turma (Req. 07) está vinculado à Modalidade do Curso (Req. 04)? A Turma que está sendo salva possui Centro de Custo? O Item Contábil e o Centro de Custo da Turma estão associados entre si no Protheus? Se alguma das condições acima não for satisfeita, uma mensagem customizada será exibida ao usuário e ele será impossibilitado de salvar a Turma. Portanto, o usuário só conseguirá salvar as informações se o Item Contábil e a Modalidade estiverem vinculados no SGE e se o Item Contábil e o Centro de Custo estiverem vinculados no Protheus. Para essa validação, o Protheus disponibilizará uma View (IIFR_CTA010_VW) que informará o vínculo entre Item Contábil e Centro de Custo. A consulta deverá ser feita por Coligada. Para isso, será considerada a Empresa Protheus parametrizada através do Req. 01. O valor do campo EMPRESAPROTHEUS deverá ser recuperado da tabela ZPARAMETROTEMPLATE e passado como filtro para a View.

Histórico de Atualização das Versões do Documento

...

Data

...

Autor

...

Versão

...

Descrição das Alterações

Oferta | Turma. Detalhamento do processo No momento que uma Turma for salva, se houver Item Contábil vinculado, a Customização fará as seguintes validações: O Curso da Turma que está sendo salva possui Modalidade? O Item Contábil da Turma está vinculado à Modalidade do Curso ? A Turma que está sendo salva possui Centro de Custo? O Item Contábil e o Centro de Custo da Turma estão associados entre si no Protheus? Caso alguma das afirmativas acima não seja verdadeira, será emitida uma mensagem de consistência e não será possível salvar a Turma O vínculo entre Item Contábil e Centro de Custo será validado no Protheus a partir da view IIFR_CTA010_VW. A consulta é por Coligada e para tal será considerada a Empresa Protheus parametrizada através do Req. 01. O valor do campo EMPRESAPROTHEUS deverá ser recuperado da tabela ZPARAMETROTEMPLATE e passado como filtro para a View.

Expandir
title Anexo customizado de Dados Financeiros no cadastro do Processo Seletivo
Pré-requisitos Executar o processo de Importação de Cadastros Básicos, disponível no menu Educacional | Customização para importação dos cadastros de Itens Contábeis, Classes de Valor e Centros de Custo. Detalhamento do processo O Anexo "Dados financeiros – Integração Protheus" está disponível no menu Processo Seletivo | Cadastros | Processo Seletivo | Anexo Dados Financeiros – Integração Protheus. O processo não apresenta diferenças entre as Coligadas do SESI e SENAI. Image Added Nesta tela temos três campos que fazem referência às tabelas SITEMCONTABILPROTHEUS, SCLASSEVALORPROTHEUS e SSERVICO filtrados pela Coligada do contexto. As informações definidas aqui são gravadas na tabela customizada ZIPPSDADOSFINANCEIROS e são utilizadas no processo de Exportação de Lançamentos Financeiros (Pedido de Venda) para o Protheus. Para cada Processo Seletivo pode ser vinculado apenas um Item Contábil, uma Classe de Valor e um Serviço. O Centro de Custo deve ser informado no campo nativo do cadastro do Processo Seletivo. Image Added

Expandir
title Criação de Campos Customizados no Cadastro do Contrato
Pré-requisitos Criação da tabela dinâmica BANDEIRACC, para cada Coligada. Os itens da tabela devem ser inseridos com o código correspondente no Protheus. Exemplo: BANRICOMPRAS 002- MASTERCARD 003- VISA 006- VERDECARD O Script para criação dessa tabela com os itens acima está contido no arquivo TOTVS_Custom_Consolidate_All_Parte2.sql. Para manipular os itens da tabela dinâmica, acesse o Módulo Serviços Globais, menu Administração |Tabela Dinâmica. Seleciona a tabela BANDEIRACC e adicione quantos itens forem necessários no Anexo Item de Tabela dinâmica. Detalhamento do processo Os campos customizados estão disponíveis no TOTVS Educacional disponível em TOTVS Educacional | Financeiro/Contábil | Contratos. Image Added Estas informações são relevantes para quando o Aluno ou Responsável optar pelo pagamento do Curso, objeto do Contrato Educacional, via cartão de crédito ao realizar a Matrícula pela Secretaria. Em ocasiões como esta é necessário que os dados sejam enviados para o Protheus durante a integração de Pedido de Venda. Pagamento com Cartão de Crédito: Quando marcado, o NSU e a Bandeira devem ser informados obrigatoriamente. NSU: Número Sequencial Único que identifica a transação realizada com o cartão de crédito, limitado a 8 caracteres. Bandeira: Campo do tipo lista que busca os itens da uma tabela dinâmica (BANDEIRACC) onde o usuário irá cadastrar manualmente os registros de Bandeiras de Cartões de Crédito (VISA, MasterCard, etc.). O campo exibe o código e a descrição da Bandeira do Cartão de Crédito. Image Added Para utilizar o Pagamento por Cartão de Crédito, o usuário deve gerar o Contrato, preencher os campos de Pagamento por Cartão de Crédito e posteriormente executar o processo de Gerar Lançamentos. Após execução deste Processo, não será permitido modificar o valor desses campos. Importante: Durante o processo nativo de matrícula, o usuário possui a opção de gerar o Contrato e os Lançamentos Financeiros do Contrato automaticamente. A geração dos Lançamentos automática não deve ser utilizada para os casos de pagamento por Cartão de Crédito, pois o usuário precisa informar o NSU e a Bandeira antes de gerar os Lançamentos. Após geração do Contrato, o usuário deverá acessá-lo, informar os campos do pagamento e executar o processo Gerar Lançamentos. Se houver um erro por parte do usuário e caso utilize esta opção (Gerar Lançamentos automaticamente no processo da Matrícula), a baixa deverá ser realizada diretamente no Protheus. Após gerar os Lançamentos Financeiros do Contrato estes campos ficarão desabilitados para edição. Nota title Pontos de Atenção Não está prevista nenhuma rotina para preenchimento automático dos campos. O usuário deve preenchê-los manualmente, somente quando o pagamento for realizado com Cartão de Crédito. Não está prevista nenhuma rotina para integrar as Bandeiras dos Cartões de Crédito. Os registros deverão ser inseridos no TOTVS RM manualmente na tabela dinâmica espelhando o cadastro no Protheus (mesmos códigos). Ao salvar um Contrato cuja opção Pagamento com Cartão de Crédito esteja marcada, o usuário será informado que os dados da baixa serão enviados ao Protheus e que, portanto, as informações não poderão mais sofrer alterações após geração dos lançamentos financeiros. A partir desse momento os campos referentes ao cartão ficarão desabilitados e não poderão mais ser alterados.

Expandir
title Exportação de Clientes (TOTVS RM → Protheus)
Pré-requisitos O RM precisa estar parametrizado para permitir Clientes e Fornecedores Globais (em todas as Coligadas). Esse parâmetro é ajustado no caminho: Módulo Backoffice | Gestão Financeira | Ambiente | Parâmetros | TOTVS Gestão Financeira | Selecionar Contas a Pagar - Lançamento | Etapa Cliente/Fornecedor e marcar o parâmetro Permite Globais, conforme imagem abaixo. O campo "Default Cli/For Global" também precisa ser marcado para facilitar os cadastros. Abaixo, segue tela da parametrização. Image Added Detalhamento do processo Esse processo é automático e não precisa ser agendado. Ao acessar as funcionalidades disponíveis no cadastro do Aluno (Educacional | Currículo e Oferta | Aluno) através dos botões: "Cadastrar ALUNO como responsável", "Cadastrar PAI/MÃE como responsável", "Cadastrar RESPONSÁVEL ACADÊMICO como responsável" ou ao incluir ou editar um Cliente no módulo BackOffice | Gestão Financeira | Cadastros | Clientes/Fornecedores a exportação é acionada. Na inclusão ou alteração, a customização aciona a função MATA030 (pacote IIFR_CLIENTE_PCK) e neste momento envia o registro para o Barramento IIF, de onde será lido pelo Protheus. A inclusão/alteração do Cliente será concretizada no TOTVS independente do retorno recebido pelo Protheus. Caso ocorra erro na integração, o usuário poderá visualizar o erro ocorrido e reenviar o registro através interface de log descrita através do Req. 08. Se for necessário alterar alguma informação no cadastro, ele será integrado novamente de forma automática após alteração. A interface de log mostrará também o pacote que foi enviado ao barramento. O Cliente no Protheus é compartilhado, ou seja, utiliza um cadastro único para todas as empresas. Portanto, no TOTVS RM o Cliente deve ser global (coligada 0). O campo complementar IDINTEGRACAO para a FCFOCOMPL receberá o resultado da integração realizada (Id Barramento). Os campos de Endereço (Principal e Pagamento) são de preenchimento obrigatório, já que são obrigatórios no Protheus. São eles: CEP, Rua, Número, Bairro, Estado, Município e País. O campo Data de Nascimento também é obrigatório. Não será permitido salvar o cadastro sem informar estes campos. Nota title Pontos de Atenção Nenhum anexo do cadastro de Clientes Fornecedores será integrado, tampouco acionará a integração no momento que for salvo. Nenhum processo do cadastro de Clientes Fornecedores acionará a integração. Os campos que serão integrados neste Requisito podem ser consultados na Especificação Funcional. Somente serão exportados dados dos registros classificados como Clientes ou Ambos (FCFO.PAGREC = 1 Cliente ou FCFO.PAGREC = 3 Ambos). Somente serão exportados dados de registros globais (coligada 0). Caso seja criado um Cliente não global, a customização irá gerar uma mensagem de erro na interface de log. Através deste requisito serão integrados dados de inclusões e atualizações de Clientes. Não faz parte deste escopo a exclusão de registros. Todos os campos do tipo texto serão tratados antes de serem enviados ao barramento IIF. Serão retirados alguns caracteres especiais e todo tipo de acentuação. Além disso, o texto será enviado em caixa alta.

Expandir
title Exportação de Pedido de Venda (TOTVS RM → Protheus)
Pré-requisitos Deve ser criado o campo complementar IDINTEGRACAO para a FLANCOMPL: Alfanumérico, Tamanho 255, Texto. Este campo receberá o resultado da integração realizada (Id Barramento). A criação deste campo já está contemplada no arquivo TOTVS_Custom_Consolidate_All_Parte2.sql. As Contas Caixas das Filiais e dados dos Convênios para geração do Nosso Número precisam estar configurados para geração dos lançamentos financeiros. Configurar o código do Tipo de Baixa que será exportado para o Protheus no TOTVS Educacional, menu Customização | Parâmetros | Código do Tipo da Baixa – Cartão de Crédito. Esse valor será utilizado no envio da baixa quando os dados do cartão de crédito forem preenchidos. Configurar o código do meio de pagamento, no TOTVS Educacional, menu Customização | Parâmetros | Código do meio de pagamento - Baixa Cartão Secretaria. Descrição do processo Exportação de títulos financeiros a ser realizada entre o TOTVS Gestão Financeira e o Protheus. A integração é realizada de forma automática (Job Server), respeitando os intervalos de tempo pré-definidos pelo usuário no agendamento. O Processo deve ser agendado no TOTVS Educacional, menu Customização | Exportação de Pedido de Venda. Image Added Detalhamento do processo Ao salvar o Contrato no TOTVS Educacional, a customização preenche uma tabela (ZIPLANCAMENTO) com os dados dos lançamentos gerados por contrato. A rotina de exportação consulta a tabela customizada onde estão armazenadas as chaves dos Lançamentos (títulos financeiros) que foram incluídos no TOTVS RM. A customização aciona a função MATA410 para enviar os dados para o barramento IIF de onde serão lidos pelo Protheus.  A interface de log, menu TOTVS Educacional | Customização | Monitor de Log, exibe o pacote que foi enviado ao barramento:  Funcionalidades: - Exportação de Pedido de Venda (Contrato Educacional) - Exportação de Baixa de Lançamentos de Contrato Educacional (Cartão) Caso ocorra erro na integração, o usuário pode reenviar o registro através da interface de log.  Somente são  integrados os lançamentos originados de contratos educacionais ou taxas de inscrição de Processos Seletivos que ao serem salvos geram um registro na tabela customizada ZIPLANCAMENTO e estão pendentes de envio. Após o envio, os registros da tabela ZIPLANCAMENTO referentes aos Contratos exportados terão o campo STATUS atualizado para E (Enviado). Se a flag customizada "Pagamento com Cartão de Crédito" do Contrato estiver marcada, é realizada a baixa do titulo no TOTVS RM e enviado para o Protheus (utilizando o Id Dependência do barramento, para só processar as baixas após processar o Pedido de Venda). A baixa utiliza função FINA070.  As validações de Item Contábil x Modalidade e Item Contábil x Centro de Custo descritas nos Req. 06 e Req 08 do documento Especificação Anexo I - Detalhamento Funcional - FS007779 - Parte 1, são realizadas também antes de salvar o Pedido de Venda ao Protheus, impedindo que seja salvo em caso de inconsistência. O campo complementar IDINTEGRACAO para a FLANCOMPL recebe o resultado da integração realizada (Id Barramento). Concessão de Bolsas: Quando bolsas forem concedidas no decorrer do curso, depois que o Contrato já tiver sido integrado com o Protheus, o usuário deve cancelar manualmente os Lançamentos em aberto no TOTVS Gestão Financeira, adicionar a bolsa às parcelas em aberto e gerar os Lançamentos novamente, para que desta forma, eles sejam gerados com um novo Nosso Número. Não está prevista nenhuma rotina customizada para automatizar este processo. Quando forem concedidas bolsas retroativas (FIES), o usuário deve cancelar os Lançamentos em aberto e tratar o montante a pagar diretamente no Protheus. Não está prevista nenhuma rotina customizada para automatizar este processo. Nota title Pontos de Atenção Contratos com mais de um Cliente deverão gerar pedidos de venda por Cliente. Para contratos de bolsa de 100%, são gerados Lançamentos com o valor zerado no RM, mas esses registros não serão enviados ao Protheus. Alterações e exclusões de lançamentos não são cobertas pela Customização. Acordos serão tratados no Protheus e portanto, se for identificada a criação de um Contrato no TOTVS RM do tipo acordo (SCONTRATO.TIPOCONTRATO), não será gerado Pedido de Venda no Protheus.

Expandir
title Exportação de lançamentos contábeis (TOTVS RM → Protheus)
Pré-requisitos Deve ser criado o campo complementar IDINTEGRACAO para a CPARTIDACOMPL: Alfanumérico, Tamanho 255, Texto. A criação deste campo já está contemplada no arquivo TOTVS_Custom_Consolidate_All_Parte2.sql. Definir o número dos lotes contábeis que serão utilizados (menu Educacional > Ambiente > Parâmetros > Educacional > Integração > Contabilidade). Eles precisam ter três dígitos, já o Protheus possui limite de 6 caracteres e eles serão enviados concatenados com a Sigla SGE. Informar período contábil válido no menu módulo Gestão Contábil, menu Ambiente > Parâmetros > TOTVS Gestão Contábil > Lançamentos > Manutenção de Lançamentos > Período Contábil. A data atual deve estar contemplada no período definido. Efetuar a liberação do período por usuário no Módulo Globais, menu Serviços Globais > Segurança > Usuários > Gestão Contábil > Anexos > Período para Manutenção de Lançamentos Contábeis. Descrição do processo Exportação de lançamentos contábeis a ser realizada entre o TOTVS Gestão Contábil e o Protheus. A integração será automática ao salvar lançamentos contábeis e por isso, não precisa ser agendado. Os lançamentos serão enviados do TOTVS Gestão Contábil para o Protheus. Detalhamento do processo A integração será realizada de forma automática, no sentido TOTVS RM  Protheus no momento em que o usuário acionar o Processo de Gerar Contabilização. Este processo pode ser acionado pelo usuário através dos menus TOTVS Educacional | Financeiro / Contábil | Contratos | Processos | Gerar Contabilização do TOTVS Educacional | Financeiro / Contábil | Contabilização. Ao ser executada, a rotina customizada executará a exportação que irá recuperar os registros de Lançamentos Contábeis que foram incluídos no TOTVS RM e acionará a função CTBA102 para enviar os dados para o barramento IIF de onde serão lidos pelo Protheus. O retorno será salvo em tabela customizada de log. Caso ocorra erro na integração, o usuário poderá reenviar o registro através da interface de log referenciada no Req. 08. A interface de log mostrará também o pacote que foi enviado ao barramento. Deve ser criado pelo cliente o campo complementar IDINTEGRACAO para a CPARTIDACOMPL: Alfanumérico, Tamanho 255, Texto. Este campo receberá o resultado da integração realizada. Nota title Pontos de Atenção Todos os sublotes precisam fechar débito e crédito, ou seja, cada lançamento contábil tem partidas de débito e crédito que devem ser iguais entre si em termos de valores. Todos os campos do tipo texto serão tratados antes de serem enviados ao Protheus. Serão retirados os caracteres especiais e todo tipo de acentuação. Além disso, o texto será enviado em caixa alta. As validações de Item Contábil x Modalidade e Item Contábil x Centro de Custo descritas nos Req. 06 e Req. 08 do documento Especificação Anexo I - Detalhamento Funcional - FS007779 - Parte 1, devem ser realizadas também antes da geração dos Lançamentos Contábeis no RM. Caso haja inconsistência, um erro será gerado no log do processo. Processos Seletivos não geram lançamentos contábeis no TOTVS Gestão Contábil.

Expandir
title Interface de Log e Reenvio de Dados
Pré-requisitos Não se aplica. Descrição do processo Tela de log customizada capaz de apresentar o resultados de todos os registros enviados visível em TOTVS Educacional | Customização | Monitor de log de exportação. Detalhamento do processo Os registros que foram exportados e geraram ocorrências de erros, ficando com status "Pendente", podem ser reprocessados através do processo de 'Reenvio de dados' disponível na visão Monitor de Log de Integrações. Esta tela não permite inclusão, alteração ou exclusão de registro. O campo IDFUNCPROC determina o processo vinculado ao registro de log sendo: Cliquei aqui para fazer dowload da planilha com a lista de funcionalidades. O campo STATUS determinará o status vinculado ao registro de log sendo: S = Sucesso - Registro integrado com "sucesso". E = Erro - Registro apresentou "erro" na integração e poderá ser reprocessado. C = Cancelado - Registro teve seu reprocessamento cancelado e não está disponível para ser integrado. Para o processo de reenvio, se o número da tentativa for menor ou igual ao "Limite Tentativas para Reenvio", parametrizado através do Parâmetros da customização, o processo de reenvio de dados será executado na tentativa de integrar o registro novamente. Neste caso, não será gerado novo log para o registro, o log atual será atualizado com os dados do reenvio e com o número de tentativas de integração incidentes sobre o registro. Caso o número de tentativas seja superior ao limite parametrizado, o processo customizado irá enviar um e-mail para o "Endereço de e-mail responsável' que deverá ser parametrizado do Parâmetros da customização, notificando ao usuário que o registro excedeu ao número de tentativas de integração permitido. O registro terá seu status alterado para "Cancelado" e não será reprocessado.

Expandir
title Customização de Dados Financeiros no item de contrato do TOTVS Gestão de Estoque, Compras e Faturamento
Pré-requisitos Executar o processo de Importação de Cadastros Básicos, disponível no menu Educacional | Customização para importação dos cadastros de Itens Contábeis, Classes de Valor e Centros de Custo. Detalhamento do processo A customização de Dados Financeiros no item do contrato está disponível no módulo TOTVS Gestão de Estoque, Compras e Faturamento, menu Contratos | Manutenção de Contrato, seleciona o Contrato | Itens | seleciona o Item | Tabelas Image Added Nesta tela teremos três campos que farão referência às tabelas SITEMCONTABILPROTHEUS, SCLASSEVALORPROTHEUS e SSERVICO filtrados pela Coligada do contexto. As informações definidas aqui serão gravadas na tabela customizada ZIPCTRDADOSFINANCEIROS e serão utilizadas no processo de Exportação de Lançamentos Financeiros – Contrato Corporativo (Pedido de Venda) para o Protheus. Para cada Item do Contrato poderá ser vinculado apenas um Item Contábil, uma Classe de Valor e um Serviço. O Centro de Custo deverá ser informado no campo nativo do cadastro do Contrato. Image Added

Expandir
title Exportação de Pedido de Venda – Contrato Corporativo (TOTVS RM → Protheus)
Pré-requisitos Deve ser criado o campo complementar IDINTEGRACAO para a FLANCOMPL: Alfanumérico, Tamanho 255, Texto. Este campo receberá o resultado da integração realizada (Id Barramento). A criação deste campo já está contemplada no arquivo TOTVS_Custom_Consolidate_All_Parte2.sql. As Contas Caixas das Filiais e dados dos Convênios para geração do Nosso Número precisam estar configurados para geração dos lançamentos financeiros. Descrição do processo Exportação de títulos financeiros a ser realizada entre o TOTVS Gestão de Estoque Compras e Faturamento / Financeiro e o Protheus. A integração será realizada de forma automática (Job Server), respeitando os intervalos de tempo pré-definidos pelo usuário no agendamento. O Processo deverá ser agendado no TOTVS Educacional, menu Customização | Exportação de Pedido de Venda. Detalhamento do processo Ao Faturar uma medição de um Contrato Corporativo do TOTVS Gestão de Estoque, Compras e Faturamento, a customização preenche uma tabela (ZIPLANCAMENTO) com os dados dos lançamentos gerados pelo contrato. A rotina de exportação irá consultar a tabela customizada onde estarão armazenadas as chaves dos Lançamentos (títulos financeiros) que foram incluídos no TOTVS RM. A customização acionará a função MATA410 para enviar os dados para o barramento IIF de onde serão lidos pelo Protheus. O retorno será salvo em tabela customizada de log. Caso ocorra erro na integração, o usuário poderá reenviar o registro através da interface de log descrita através do Req. 08.. A interface de log mostrará também o pacote que foi enviado ao barramento. Além dos lançamentos financeiros originados de Contratos Educacionais ou taxas de inscrição de Processos Seletivos, serão integrados também os lançamentos originados de Contratos Corporativos (Turma In Company) que ao serem salvos geram um registro na tabela customizada ZIPLANCAMENTO e estão pendentes de envio. Após o envio, os registros da tabela ZIPLANCAMENTO referentes aos Contratos exportados terão o campo STATUS atualizado para E (Enviado). Antes de enviar os lançamentos para o Protheus, a customização acionará automaticamente o processo de Inclusão de Boleto disponível em Lançamentos | Processos | Boleto, para que sejam gerados os Boletos referentes aos Lançamentos do Contrato Corporativo, sem necessidade de intervenção do usuário. Para que o Contrato Corporativo gere o Pedido de Venda no Protheus, são necessários os seguintes passos: Passo 1 – Criar um Contrato e seu Item: Acessar o menu Contratos | Manutenção de Contrato | Incluir um novo Contrato. Clicar na aba Itens e incluir um novo Item. Preencha os dados do Item. O tipo de faturamento do Item tem que ser "Por Medição". Image Added Inclua a Medição em Informações Adicionais, selecione o tipo de Medição "Por Valor" e clique em Incluir. Depois disso, o item poderá ser salvo. Após salvar o Item, preencha os dados financeiros no botão Customização, na mesma tela. Salve o Item e o Contrato. Image Added Passo 2 – Faturar a Medição do Contrato (Movimento 2.1.01): Localize o contrato salvo na visão, clique em Anexos | Visualizar Medições do Contrato. Selecione a Medição do Contrato e clique em Faturar Medição. Image Added Na tela que será exibida, o campo Tipo de Movimento estará preenchido com o valor 2.1.01 (caso não esteja, selecione este número) e clique em Executar. Neste momento será gerado o movimento do tipo 2.1.01 que efetuará a geração dos Lançamentos financeiros (Pedido de venda) e a Contabilização da apropriação do Contrato. Se o Job do Pedido de Venda não estiver agendado para execução automática, é necessário executá-lo manualmente no Educacional, menu Customização | Exportação de Pedido de Venda. As validações de Item Contábil x Modalidade e Item Contábil x Centro de Custo descritas nos Req. 06 e Req 08 do documento Especificação Anexo I - Detalhamento Funcional - FS007779 - Parte 1, são realizadas também antes de finalizar o processo de Faturamento da Medição do Contrato, impedindo que seja os lançamentos financeiros sejam salvo em caso de inconsistência. O campo complementar IDINTEGRACAO para a FLANCOMPL receberá o resultado da integração realizada (Id Barramento). Os alunos que pertencem à Turma in Company deverão ser associados ao Contrato no módulo TOTVS Educacional. A não associação de alunos não interfere na geração do Pedido de Venda. Não será possível ter clientes diferentes vinculados ao mesmo Contrato Corporativo, tendo em vista que o movimento que será a origem dos lançamentos financeiros só poder ter um cliente vinculado. Os registros integrados ou não poderão ser visualizados na interface de log, que mostrará o resultado da integração e os erros ocorridos, quando existirem. Essa interface precisa ser monitorada sempre. Caso tenha ocorrido erro o registro deverá ser reprocessado através dessa interface. Quando a Natureza Financeira associada ao Serviço do Contrato (Anexos Dados Financeiros – Item do Contrato) estiver configurada para Reter INSS e o Cliente do Contrato Corporativo for Pessoa Jurídica, o SGE calculará o valor do imposto, subtrairá do valor total do contrato, dividirá o valor entre as parcelas, somando o valor do imposto retido na primeira parcela do contrato. Este cálculo é feito de forma nativa, utilizando o imposto do movimento, fórmulas e consultas, sem necessidade de customização neste momento. Nota title Pontos de Atenção 1. Alterações e exclusões de lançamentos não são cobertas pela Customização. 2. O Centro de Custo utilizado neste requisito deverá ser informado no Item do Contrato. Só será permitido um centro de custo por item de contrato (não permite rateio). Não serão utilizados os centros de Custo da Turma ou Matriz Aplicada. 3. Não haverá tratamento para pagamento com cartão de crédito como existe para o Contrato do TOTVS Educacional. 4. O valor do imposto INSS só será considerado no cálculo quando for superior a R$ 10,00.

Expandir
title Exportação de Lançamentos Contábeis (TOTVS RM → Protheus)
Pré-requisitos Deve ser criado o campo complementar IDINTEGRACAO para a CPARTIDACOMPL: Alfanumérico, Tamanho 255, Texto. A criação deste campo já está contemplada no arquivo TOTVS_Custom_Consolidate_All_Parte2.sql. Definir o número dos lotes contábeis que serão utilizados (menu Educacional > Ambiente > Parâmetros > Educacional > Integração > Contabilidade). Eles precisam ter três dígitos, já o Protheus possui limite de 6 caracteres e eles serão enviados concatenados com a Sigla SGE. Definir o número dos lotes contábeis que serão utilizados (TOTVS Gestão de Estoque, Compras e Faturamento > Ambiente > Parâmetros > Gestão de Estoque, Compras e Faturamento > Etapa Vendas > Faturamento – Configurar para os Tipos de Movimentos 2.1.01 e 2.2.01). Eles precisam ter três dígitos, já o Protheus possui limite de 6 caracteres e eles serão enviados concatenados com a Sigla SGE. Informar período contábil válido no menu módulo Gestão Contábil, menu Ambiente > Parâmetros > TOTVS Gestão Contábil > Lançamentos > Manutenção de Lançamentos > Período Contábil. A data atual deve estar contemplada no período definido. Efetuar a liberação do período por usuário no Módulo Globais, menu Serviços Globais > Segurança > Usuários > Gestão Contábil > Anexos > Período para Manutenção de Lançamentos Contábeis. Descrição do processo Exportação de lançamentos contábeis a ser realizada entre o TOTVS Gestão Contábil e o Protheus. A integração será automática ao Faturar a Medição do Contrato Corporativo (2.1.01) e ao Incluir Movimento para Contabilização da Competência (2.2.01). Por isso, este processo não precisa ser agendado. Os lançamentos serão enviados do TOTVS Gestão Contábil para o Protheus. Detalhamento do processo Ao efetuar o faturamento da medição do contrato, são criados lançamentos contábeis referentes à apropriação do contrato. Além desses, ao faturar os movimentos de medição do contrato, são gerados lançamentos referentes à contabilização das competências do contrato (processo precisa ser feito mensalmente). Todos os lançamentos contábeis gerados são exportados para o Protheus, no momento em que são criados no RM. A integração será realizada de forma automática, no sentido TOTVS RM  Protheus no momento que o movimento for salvo (faturamento da medição do contrato ou movimento de geração da contabilização). Ao ser executada, a rotina customizada acionará a exportação que irá recuperar os registros de Lançamentos Contábeis que foram incluídos no TOTVS RM e acionará a função CTBA102 para enviar os dados para o barramento IIF de onde serão lidos pelo Protheus. O retorno será salvo em tabela customizada de log. Caso ocorra erro na integração, o usuário poderá reenviar o registro através da interface de log. Os lançamentos contábeis da apropriação do Contrato são gerados no momento em que a medição do Contrato for Faturada (geração do movimento 2.1.01 – conforme descrito no detalhamento do Requisito anterior). Os lançamentos contábeis da competência serão gerados através da criação do movimento de contabilização do contrato (faturamento do movimento 2.1.01 para o 2.2.01). Para isso, é necessário seguir os passos abaixo: Criar o Movimento para Contabilização da Competência do Contrato (2.2.01): Para contabilização da Competência, é necessário entrar no módulo BackOffice – Gestão de Estoque Compras e Faturamento, menu Vendas | Faturamento | Movimentação: Image Added Informe o tipo de movimento 2.1.01 e a Filial informada no Contrato. Será exibida lista dos movimentos gerados a partir das Medições de contratos. Selecione o movimento correspondente à medição/contrato desejado e clique em Processos | Faturar Receber. Será exibida tela do novo movimento. Preencha o campo Data Emissão com a data que o lançamento contábil precisa ser gerado e clique em Salvar/Executar. Após finalizar esse processo, a contabilização da competência será gerada. Para contabilizar nova competência (segundo mês), basta repetir o processo (criar um novo movimento 2.2.01, a partir do mesmo movimento de medição) e informar a data da competência desejada. O campo complementar IDINTEGRACAO da CPARTIDACOMPL receberá o resultado da integração realizada (Id. Barramento). Nota title Pontos de Atenção Todos os sublotes precisam fechar débito e crédito, ou seja, cada lançamento contábil tem partidas de débito e crédito que devem ser iguais entre si em termos de valores. Todos os campos do tipo texto serão tratados antes de serem enviados ao Protheus. Serão retirados os caracteres especiais e todo tipo de acentuação. Além disso, o texto será enviado em caixa alta. As validações de Item Contábil x Modalidade e Item Contábil x Centro de Custo descritas nos Req. 06 e Req. 08 do documento Especificação Anexo I - Detalhamento Funcional - FS007779 - Parte 1, devem ser realizadas também antes da geração dos Lançamentos Contábeis no RM. Caso haja inconsistência, um erro será gerado no log do processo.

Expandir
title Exportação de Cancelamento de Lançamento Financeiro (TOTVS RM → Protheus)
Pré-requisitos Configurar o código do Tipo de Baixa que será exportado para o Protheus no TOTVS Educacional, menu Customização | Parâmetros | Código do Tipo da Baixa – Cancelamento. Esse valor será utilizado no envio do cancelamento (baixa) para o Protheus. Descrição do processo Exportação de cancelamento de títulos financeiros originados por Contratos Corporativos a ser realizada entre TOTVS RM e Protheus. Esse processo é automático e não precisa ser agendado. Detalhamento do processo A customização acionará a função FINA070 (pacote IIFR_CLIENTE_PCK) quando um Lançamento for cancelado no sentido TOTVS RM → Protheus. Neste momento a integração envia um registro de Baixa por Cancelamento para o Barramento IIF de onde serão lidos pelo Protheus. Ao cancelar um movimento de faturamento de medição de Contrato Corporativo - 2.1.01 (caminho: TOTVS Gestão de Estoque, Compras e Faturamento, menu Vendas | Faturamento | Movimento 2.1.01 | Selecionar o movimento e clicar em Processos | Cancelar ou Excluir), os lançamentos financeiros serão cancelados no RM e com isso, a customização será acionada. O cancelamento do Lançamento será concretizado no TOTVS independente do retorno recebido pelo Protheus. Caso ocorra erro na integração, o usuário poderá efetuar o reenvio do registro através da interface de log. Nota title Pontos de Atenção Se for identificado que um Lançamento cancelado no RM já foi baixado no Protheus, ficará a cargo do usuário resolver a situação manualmente. O processo para criação de Contratos Corporativos e a geração de seus respectivos títulos e lançamentos contábeis consiste na criação de três tipos de movimento diferentes: 1.01 – Faturamento Contrato – Contabilização Contrato Efetua a contabilização e geração de lançamento financeiro (título). 2.01 – Apropriação da receita mensal (contabiliza) Ao faturar o movimento 2.1.01 para o 2.2.01, é feita apropriação da receita mensal, que gera outros lançamentos contábeis 2.02 – Conclusão do Contrato No final do faturamento é gerado movimento 2.2.01 apenas para conclusão do ciclo do contrato. Quando for necessário cancelar um faturamento/medição de um contrato, é necessário cancelar os movimentos gerados pelo Contrato Corporativo na ordem inversa: primeiro 2.2.02, 2.2.01 e por último 2.1.01. Para cancelar os movimentos 2.1.01 e 2.2.01, se o processo de “Integrar Lote(s)/ Lançamento(s) ao Lote Oficial” já tiver sido executado, é necessário executar antes o processo “Estornar Contabilidade”. Esse processo envia para o Protheus o estorno dos lançamentos contábeis neste momento. Quando o movimento 2.1.01 é cancelado, ele também envia para o Protheus a baixa do lançamento financeiro e o estorno dos lançamentos contábeis. O mesmo acontece para o movimento 2.2.01 O processo de contabilização da FIERGS foi desenhado para contabilizar o estorno da receita quando o título é baixado no Protheus por cancelamento, procedimento disparado pelo cancelamento dos movimentos 2.1.01 e 2.2.01. Se o RM enviar o estorno no processo de manual de Estornar Contabilidade, a contabilização fica duplicada no Protheus. Importante: Só não são enviados para o Protheus os estornos gerados pelo processo Estornar Contabilidade. Os demais estornos, inclusive o do cancelamento dos movimento são enviados. A mesma regra é válida para SESI e SENAI.

Expandir
title Importação de Acordo (Protheus → TOTVS RM)
Pré-requisitos Template de Acordo: Criar o template do acordo chamado "Acordo SGE" no módulo TOTVS Gestão Financeira, menu Contas a Pagar / Receber | Acordo | Template de Acordo. A classificação financeira (aba Defaults) precisa obrigatoriamente ser preenchida. Depois disso, é necessário parametrizar o identificador do template nos parâmetros da customização. Parametrizar o TOTVS Gestão Financeira e Educacional para gerar apenas lançamentos financeiros do tipo Não Contábeis. Essa parametrização é por Coligada e Filial. Informar parâmetros de Acordo que se encontram nos parâmetros gerais do TOTVS Educacional, menu Ambiente | Parâmetros |Tesouraria | Avançar, aba Geral ½ : Informar os Serviços (Inadimplência e Processo Seletivo). Descrição do processo Integração de Acordos Financeiros a ser realizada entre TOTVS RM e Protheus. A integração será realizada de forma automática (Job Server), respeitando os intervalos de tempo pré-definidos pelo usuário no agendamento. O Processo deverá ser agendado no TOTVS Educacional, menu Customização | Importação de Acordo. Detalhamento do processo As renegociações (acordos) referente a débitos dos alunos serão realizadas diretamente no Protheus, através de rotina customizada pela FIERGS para este fim específico. Os títulos gerados pelas negociações serão enviados para o barramento IIF para serem importados no TOTVS Educacional. Ao ser disparada, a rotina customizada de integração irá ler as informações dos Acordos Financeiros que estarão disponíveis no barramento (view) e acionar rotina nativa para Geração de Acordo disponível em TOTVS Gestão Financeira | Contas a Pagar / Receber | Lançamentos | Processos | Gerar Acordo. Este processo, por sua vez, irá baixar os Lançamentos de origem por acordo e criar os novos, além de gerar um novo Contrato Educacional para o aluno (Contrato do tipo Acordo). As visões consultadas no barramento para importação de Acordo são: Cabeçalho: DDA_IIF.IIFR_RENEGOCIACAO_OUT_VW Contém informações como Data do Acordo e Valor Total. Parcelas Geradas: DDA_IIF.IIFR_TIT_RENEGOCIACAO_OUT_VW Contém informações das Parcelas geradas, como: Data de Vencimento, Nosso Número e Valor. Lançamentos Originais: DDA_IIF.IIFR_TIT_BAIXADO_OUT_VW Contém o Nosso Número dos lançamentos originais, que precisam ser baixados no RM para geração do Acordo. Após importação, o RM informará ao Protheus o status da execução de cada registro, através da função "AtualizaMensagem", disponível no barramento. No caso de Sucesso, o Protheus deverá retirar da visão os registros já processados pelo RM. Os dados da importação estarão disponíveis na interface de log, detalhada no manual da Parte 2 - Req.08. Nota title Pontos de Atenção A Negociação no Protheus realiza os processos de baixa dos títulos de origem e criação dos novos títulos em momentos distintos, ao contrário do TOTVS RM, que realiza esses passos em um só momento. Por isso, para que seja possível acionar a rotina nativa de Geração de Acordos do TOTVS RM, o Protheus não deverá enviar a baixa dos títulos do tipo Acordo ao barramento. A integração será realizada em um só momento, quando o Protheus enviar os novos títulos gerados pela Negociação, disponibilizando as informações descritas neste requisito. Ao cancelar um Acordo no RM, os lançamentos gerados pelo Acordo são cancelados e os lançamentos originais são reabertos. Quando essa operação for necessária (cancelamento do Acordo), será preciso efetuar o cancelamento da negociação no Protheus manualmente, já que não está prevista integração para cancelamento de Acordo/Negociação entre os dois sistemas.

Expandir
title Importação de Baixa (Protheus → TOTVS RM)
Pré-requisitos Parametrizar o TOTVS Gestão Financeira e Educacional para gerar apenas lançamentos financeiros do tipo Não Contábeis. Essa parametrização é por Coligada e Filial. Meio de Pagamento: Informar o código do Meio de Pagamento que será utilizado em todos os Acordos no TOTVS Educacional, menu Customização | Parâmetros | Meio de Pagamento. Campo complementar "TIPODEBAIXA" criado no cadastro de Lançamento (TOTVS Gestão Financeira | Cadastros | Campos Complementares | Lançamento). Descrição do processo Integração de Baixa de Lançamentos Financeiros a ser realizada entre TOTVS RM e Protheus. A integração será realizada de forma automática (Job Server), respeitando os intervalos de tempo pré-definidos pelo usuário no agendamento. O Processo deverá ser agendado no TOTVS Educacional, menu Customização | Importação de Baixa. Detalhamento do processo A Baixa/Cancelamento dos Lançamentos Financeiros será realizada diretamente no Protheus e as informações dos títulos deverão ser enviados para o barramento IIF para serem importados no TOTVS RM. Ao ser disparada, a rotina customizada de integração irá ler as informações dos Lançamentos Financeiros no Protheus que estarão disponíveis na visão DDA_IIF.IIFR_BAIXA_P11_RM_OUT_VW, que contém os dados necessários para realização da baixa ou cancelamento no RM. Através do Nosso Número disponível na visão, a customização irá localizar os lançamentos financeiros correspondentes no TOTVS RM e acionar rotina nativa para inclusão ou cancelamento da Baixa, que por sua vez, irá baixar ou cancelar os lançamentos no TOTVS RM. Para determinar qual a operação será realizada, será verificado o campo "Tipo" disponível na visão do barramento: Baixa Tipo B: Baixa por recebimento realizadas no Protheus, será realizada a baixa do lançamento no TOTVS RM. Baixa Tipo C: Baixa por Cancelamento realizadas no Protheus, será realizado o cancelamento do lançamento no TOTVS RM. Observação: caso existam boletos no TOTVS RM com status de remetido ou registrado, eles serão cancelados, através do processo de Cancelamento de Remessa se Boletos, antes da execução do cancelamento dos lançamentos. Após importação, o RM informará ao Protheus o status da execução de cada registro, através da função "AtualizaMensagem", disponível no barramento. No caso de Sucesso, o Protheus deverá retirar da visão os registros já processados pelo RM. Os dados da importação estarão disponíveis na interface de log, detalhada no manual da Parte 2 - Req.08. Nota title Pontos de Atenção Não está prevista integração de estorno de baixa. Baixas de títulos nativos do Protheus não deverão ser enviadas ao barramento e por isso, não serão importadas pelo TOTVS RM. Baixas de títulos por Acordo não poderão ser enviadas ao barramento e por isso, não serão importadas pelo TOTVS RM. De acordo com a FIERGS, baixas do tipo Acordo possuem um tipo de mensagem específico no barramento IIF e tratamento diferenciado

...

24/07/2017

...

Ana Carolina Eleutério Abras
Alice Viana Machado

...

1.0

...

Documento Inicial

...

27/07/2017

...

Ana Carolina Eleutério Abras
Alice Viana Machado

...

2.0

...

.