Informações Gerais

Objetivo 

Este documento tem por objetivo apresentar as implementações necessárias para a utilização da nova apropriação da integração TOP x BackOffice Protheus no EAI 2.0, onde sera disponibilizada a revitalização dos parâmetros de apropriação e um novo processo de cálculo do cronograma apropriado.

A nova apropriação estará disponível para clientes com integração via EAI 2.0 e versão 12 do Protheus e 12.1.17 ou superiores do TOP - TOTVS Obras e Projetos.

Definição da Regra de Negócio

Os dados da apropriação serão adquiridos diretamente no BackOffice Protheus no caso das movimentações de Entrada, Estoque e Financeiro. Serão consideradas no TOP as apropriações de serviços/insumos e/ou liberações de medição de contrato.

Fluxos:

Parâmetros no TOP

Para parametrizar o processo vá em: "Parâmetro de Projetos | Apropriação | Apropriação BackOffice” e preencha os seguintes campos: 

Apropriar liberação de período de contratos em:

• Medição: O sistema considera como valor apropriado o valor informado na medição do período do contrato. Ao solicitar os valores apropriados no BackOffice sendo desconsideradas as movimentações originadas destas medições.
• Nota Fiscal: O sistema considera como valor apropriado o valor retornado pelo BackOffice para os documentos de entrada, desconsiderando os valores de medição.

Tipos de documento: 

Define os tipos de documento que serão considerados na pesquisa da apropriação, bem como a data que poderá ser utilizada identificação do período da incidência da apropriação no cronograma.

Considerar o valor do frete :

Se marcado, o sistema soma o valor do frete no total do item. Default: 1.

Campo: MPARAMETRO - APROPFRETE

Considerar o valor do seguro:

Se marcado, o sistema soma o valor de seguro no total do item. Default: 1.

Campo: MPARAMETRO - APROPSEGURO

Considerar o valor da despesa:

Se marcado, o sistema soma o valor de despesa no total do item. Default: 1.

Campo: MPARAMETRO - APROPDESPESA

Valores discriminados de acordo com o tipo de documento

Se marcado, o BackOffice retorna os valores discriminados de acordo com o tipo de documento marcado (Exemplo: Documentos de Entrada, Baixas de Requisição, Financeiro), senão, é enviado o valor agrupado em somente uma descrição “Apropriação”. Default: (0) zero.

Campo: MPARAMETRO - APROPDISCRIMINARVLR

Intervalo de períodos para processamento 

Define os períodos que serão submetidos ao PROTHEUS para processamento ou reprocessamento.

Campo: APROPPERINI e APROPPERFIM 

Automático

Quando atualizado o cronograma de todo o projeto o período inicial é atualizado conforme a data de fechamento contábil do PROTHEUS, desta forma será identificado no projeto um período compatível que será adicionado ao período inicial, ajustando também o período final de acordo com o deslocamento do inicial. Considere deslocamento a diferença entre o período inicial antes do processamento e o identificado pela data de fechamento contábil.

Exemplo:

Evolução dos parâmetros de período inicial e final:

¹Campo APROPPERAUTO 

Início

Será informado manualmente o período inicial da apropriação

Final 

Será informado manualmente o período inicial da apropriação

Caso o usuário opte pela definição manual dos períodos, serão feitas as seguintes consistências:

• Valida a sequência dos períodos e não permite gravar.

Adicionado o controle de segurança para este processo. Quando o sistema não está parametrizado é exibida uma mensagem mesmo com permissão para o usuário.

Parâmetros no Protheus

 Não existem parâmetros relacionados a este processo.

Gerar Apropriação BackOffice PROTHEUS

A apropriação com o BackOffice PROTHEUS é realizada através de mensagem única com a tecnologia EAI 2.0.

O processo poderá ser agendado para cada projeto acessando “Apropriação BackOffice PROTHEUS - Agendado” através do menu executar (F3), podendo ser agendada, por exemplo, diariamente, a execução do cálculo do cronograma apropriado.

E executado somente para a planilha de atividades.

Executando através dos processos da Planilha de Atividades

No processo será permitido informar tarefa e períodos inicial e final. 

Executando através do botão "Gerar Apropriação BackOffice PROTHEUS" do cronograma

Este processo é executado somente para a tarefa relacionada ao cronograma considerando a faixa de períodos dos parâmetros de projeto.

Quando executado para obra ou etapa, o sistema considera o primeiro e o último serviço na hierarquia do código da tarefa.

Image Added

Apropriação de Serviços / Insumos

As apropriações são visualizadas no cronograma da planilha de atividades / relatórios e utilizadas no cálculo do processo de análise de valor agregado.

No cadastro da “Apropriação de Serviços / Insumos” disponível no TOP em “Controle" , está disponível a origem da apropriação. Esta informação permite ao usuário identificar a origem e aplicar filtros. A origem denominada “Padrão” é para itens cadastrados por esta interface de apropriações.

Apropriações originadas de integração não podem ser alteradas ou excluídas. Caso o usuário tente realizar uma destas ações o sistema emite o alerta.

Criado o parâmetro “CONSWSAPROPRIACAOPROTHEUS” que habilita a pesquisa da apropriação diretamente no PROTHEUS. Este parâmetro é inserido automaticamente na integração EAI 2.0. Sendo validado em conjunto com o parâmetro “VERSAOPROTHEUS” que define a versão do PROTHEUS no cliente. Quando informado “11” não será habilitada esta modalidade de integração devido a versão 11 do PROTHEUS não atender às necessidades do processo.