...
Expandir |
---|
title | Exportação de Pedido de Venda (TOTVS RM x Protheus) |
---|
|
5.4. Req. 04 – Exportação de Pedido de Venda (TOTVS RM Protheus)Este requisito detalha a exportação de títulos financeiros a ser realizada entre o TOTVS Gestão Financeira 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.
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.
5.4.2 Descrição do Processo
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 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. Somente serã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, será enviado para o Protheus o Pedido de Venda e Baixa do(s) título(s) no mesmo momento (utilizando o Id Dependência do barramento, para só processar as baixas após processar o Pedido). A baixa utiliza função FINA070. A baixa do Lançamento no TOTVS RM não será realizada pela customização neste momento, mas sim quando o Protheus retorná-la através de rotina de Importação de Baixa, que será detalhada no documento Especificação Anexo I - Detalhamento Funcional - FS007781 - Parte 3. Somente matrículas realizadas na secretaria poderão ser pagas com Cartão de Crédito. Os demais serviços não possuem esta opção (inscrição no Processo Seletivo, Rematrícula, etc.) e portanto, para eles, não está prevista nenhuma rotina de envio de dados de baixa ao Protheus. 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 receberá 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 |
---|
| - 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.
|
|
5.5. Req. 05 – Exportação de lançamentos contábeis (TOTVS RM Expandir |
---|
title | Exportação de lançamentos contábeis (TOTVS RM x Protheus) |
---|
| |
Este requisito detalha a 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. 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.
5.5.2 Descrição do ProcessoA 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 |
---|
| - 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 | Validação de Inadimplência (Win) |
---|
|
Pré-requisitos Não se aplica.
Descrição do processo Processo customizado para validar a inadimplência do responsável financeiro do aluno no momento da matrícula.
Detalhamento do processo
O processo customizado é acionado quando um usuário matricular um aluno no TOTVS Educacional (SGE). São considerados os seguintes processos de matrícula: - Currículo e Oferta | Alunos | Anexos |Matrículas no Período Letivo | Processos | Alterar Situação de Matrícula
- Matrícula e Avaliação | Matrículas | Processos | Alterar Situação de Matrícula
- Currículo e Oferta | Aluno | Anexos | Cursos/Habilitações | Processos | Matricular aluno
- Currículo e Oferta | Aluno | Processos | Matricular aluno
- Matrícula e Avaliação | Rematrícula Ensino Básico
- Matrícula e Avaliação | Rematrícula Ensino Superior
- Matrícula e Avaliação | Processo Seletivo RM | Matricular
- Matrícula e Avaliação | Matrículas | Processos | Matricular Aluno nas Disciplinas
- Matrícula e Avaliação | Enturmação
- Matrícula e Avaliação | Mais - > Processo Seletivo Terceirizado
- Matrícula e Avaliação | Mais - > Matriculas de disciplinas em lote
Antes da execução dos processos listados acima, um processo customizado consulta a visão IIFR_Z0D010_VW do barramento IIF que valida se o responsável financeiro do aluno está inadimplente. Caso esteja, uma mensagem informativa é exibida para o usuário, que poderá prosseguir ou não com o processo nativo.
|
Expandir |
---|
title | Validação de Inadimplência (Web) |
---|
|
Pré-requisitos Não se aplica.
Descrição do processo
Processo customizado para validar a inadimplência do responsável financeiro do aluno no momento da matricula/rematrícula através do Portal (acesso do aluno).
Detalhamento do processo
Este requisito detalha a disponibilização um processo customizado para validar a inadimplência do responsável financeiro do aluno no momento da matricula. O processo customizado é acionado quando um usuário matricular um aluno no TOTVS Educacional (SGE). São considerados os seguintes processos de matrícula: Coligada SESI: - Menu Matrícula on-line
- Menu Rematrícula
Coligada SENAI:
Antes da execução dos processos listados acima, um processo customizado (custom button) irá consultar a visão IIFR_Z0D010_VW do barramento IIF que irá validar se o responsável financeiro do aluno está inadimplente. Caso esteja, uma mensagem informativa será exibida para o usuário, que poderá prosseguir ou não com o processo nativo.
Nota |
---|
| - A visão verifica a situação do responsável financeiro em todas bases dos sistemas FIERGS
|
|
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 | Anexo customizado de Dados Financeiros no item de contrato do TOTVS Gestão de Estoque, Compras e Faturamento |
---|
|
Pré-requisitos Não se aplica.
Descrição do processo 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 módulo TOTVS Gestão de Estoque, Compras e Faturamento, menu Contratos | Manutenção de Contrato, seleciona o Contrato | Itens | seleciona o Item | Customização | Dados Financeiros – Integração Protheus.

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.

|
Pré-requisitos
Não se aplica.
Descrição do processo
- 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.
Detalhamento do processo
Expandir |
---|
title | Exportação de Pedido de Venda – Contrato Corporativo (TOTVS RM x Protheus) |
---|
|
...
Este requisito detalha a 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.
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.
|
...
...
processo
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 Modified
- 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 Modified
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 Modified
- 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. 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. Fórmulas criadas para o cálculo do Imposto INSS:
- Criação da sentença SQL chamada NATINSS, visível para todas as Colitadas, sistema RM Nucleus:
SELECT COUNT CONT FROM TITMCNT JOIN ZIPCTRDADOSFINANCEIROS ON (TITMCNT.CODCOLIGADA = ZIPCTRDADOSFINANCEIROS.CODCOLIGADA AND TITMCNT.IDCNT = ZIPCTRDADOSFINANCEIROS.IDCNT AND TITMCNT.NSEQITMCNT = ZIPCTRDADOSFINANCEIROS.NSEQITMCNT) JOIN SSERVICO ON (ZIPCTRDADOSFINANCEIROS.CODCOLIGADA = SSERVICO.CODCOLIGADA AND ZIPCTRDADOSFINANCEIROS.CODSERVICO = SSERVICO.CODSERVICO) JOIN TTBORCAMENTO ON ((SSERVICO.CODCOLNATFINANCEIRA = TTBORCAMENTO.CODCOLIGADA or TTBORCAMENTO.CODCOLIGADA = 0) AND SSERVICO.CODNATFINANCEIRA = TTBORCAMENTO.CODTBORCAMENTO) WHERE TTBORCAMENTO.CAMPOLIVRE = 'RETEMINSS' AND TITMCNT.IDCNT = :FRM_000009
- Fórmula da base de cálculo do INSS:
ExECSQL ('NATINSS'); SE (RESULTSQL ('NATINSS', 'CONT') > 0 E KQT * KPU > 91) ENTAO KQT * KPU SENAO 0 FIMSE - Criação da Fórmula 000009 (utilizada na sentença SQL)
TABITM('IDCNT','S')
|
6.3. Novo requisito – Req.03 – Exportação de Lançamentos Contábeis (TOTVS RM Protheus)
Este requisito detalha a 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.
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.
...
Este requisito detalha a 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.
Pré-requisitos
1- 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.
...
Histórico de Atualização das Versões do Documento
Data | Autor | Versão | Descrição das Alterações |
---|
26/10/2017 | Davi Leles Braga Pereira Lacerda | 1.0 | Documento Inicial |
27/11/2017 | Ana Carolina Eleutério Abras | 2.0 | Ajustes durante entrega |
13/12/2017 | Ana Carolina Eleutério Abras | 3.0 | Adicionados requisitos da Análise de Impacto I |