Informações Gerais

Objetivo 

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

 Image Removed

A nova apropriação estará disponível para clientes com integração via EAI 2.0 ou EAI 1.0 e versão 121.19 (ou superior) 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 são recuperados serão adquiridos diretamente do no BackOffice Protheus no caso de das movimentações de Entrada, Estoque , e Financeiro. Serão recuperados do consideradas no TOP as apropriações de insumo ou liberação serviços/insumos e/ou liberações de medição de contrato.

Vide Protótipo de Tela 02.

Image Added 

Image Removed 

Fluxos:

Image Removed 

Image Added

Parâmetros no TOP

Para parametrizar o processo vá

Definição da Regra de Negócio

Parâmetros de Apropriação: - Acesso em: "Parâmetro de Projetos | Apropriação | Apropriação Back-Office”. Vide Protótipo 01.BackOffice” e preencha os seguintes campos: 

Image Added

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 frete seguro:

Se marcado, o sistema soma

o valor de seguro no total do item. Default: 1.

Campo:

 MPARAMETRO -

 APROPSEGURO

Considerar o valor de seguroda despesa:

Se marcado, o sistema soma

o valor de despesa no total do item. Default: 1.

Campo: MPARAMETRO -

 APROPDESPESA

Considerar o valor de despesaIPI:

Se marcado, o sistema soma o valor de

IPI no total do item. Default: 1.

Campo: MPARAMETRO -

 APROPIPI

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:

Image Modified

¹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ênciasConsistências da definição manual de períodos:

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

• • Valida o período final com o final do cronograma do projeto. Emite alerta a justa para o final e permite a gravação.

Image Removed

Parâmetros PROTHEUS 

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

Segurança

Adicionada o 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.

Image Modified

Parâmetros no Protheus

Consulta Apropriação Back-Office Agendado

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

Importar Apropriações das Tarefas no BackOffice

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 e executado por exemplo diariamente.

E executado somente para a planilha de atividades.

Executando e agendando o processo com parâmetro "Importar toda a Planilha" marcado.

Neste processo o sistema selecionará durante a execução todas as tarefas da planilha de atividades e o intervalo de períodos definidos nos parâmetros de projeto.

Caso o parâmetro de projeto defina a evolução automática do intervalo de períodos e a execução ocorra com sucesso, os períodos inicial e final serão alterados com base na data de fechamento contábil retornada na Mensagem Única.

Image Added Image Added

Executando e agendando o processo com parâmetro "Importar toda a Planilha" desmarcado.

Neste processo é permitido informar tarefas e períodos inicial e final. 

Image Added

Executando através do botão "Importar Apropriações das Tarefas no BackOffice" do cronograma

Este processo é executado somente para a tarefa relacionada ao cronograma e 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 Discriminada 

A visão de apropriações discriminada tem por objetivo mostrar de forma discriminada os registros correspondentes ao cronograma apropriado da planilha de atividades.

Podendo ser exibido como anexo a planilha de atividades ou para todo o projeto pelo executar "apropriações". Nesta visão serão exibidas as apropriações Medição de Contrato, Insumo / Serviços, Integração (Oriundas do BackOffice).Apropriação Discriminada

Apropriação

Permite informar tarefa, período inicial e final. Vide Protótipo 02.

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.

Image Removed

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.

Image Removed 

Protótipo de Tela

Protótipo 01 – Parâmetros Back-Office

 Image Removed

Protótipo 02 - Processo de Consulta Apropriação Agendado

Image Removed

Fluxo do Processo

Dicionário de Dados

Grupo de Perguntas

Image Added

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.

Carga no Protheus de dados de Apropriação dos Pedidos de Compra

Descrição de Negócio

O processo de busca de Apropriações de Custo no Protheus se pauta nas parametrizações de onde deve-se apropriar os Pedidos de Compra para identificar se certas Notas Fiscais devem ou não serem consideras no cálculo.

Esta informação passa a ser trafegada na mensagem Order a partir da integração via EAI 2.0, na versão 3.007 da mensagem Order, mas os Pedidos integrados anteriormente devem ter suas informações também preenchidas. Com este objetivo, e também para permitir atualizar os dados no Protheus em caso de alteração dos parâmetros no RM, foi desenvolvido o processo de carga destas informações.

Este processo se encarrega de obter todos os pedidos de compra da coligada que foram integrados a partir de Pedido de Material, Pedido de Material Extra ou Liberações de Medição e atualizar a informação no Protheus com base nos parâmetros do RM.

Este processo será executado logo após finalizar o processo de conversão para o EAI 2.0 e pode ser acessado pelo menu "Executar" a partir da descrição do processo ou pelo nome da Action (listados abaixo).

Regras de Negócio

Visando evitar problemas de TimeOut e trafego de mensagens muito grandes o processo de carga enviará múltiplas mensagens, com cada uma delas contendo informações de múltiplos Pedidos de Compra, seguindo a regra descrita abaixo para preencher o campo referente ao local de apropriação de cada um dos pedidos.

Valor "Apropriar na Nota Fiscal":

• Todos os Pedidos de Compra originados em Pedidos de Material ou de Pedidos Extra serão marcados para apropriação na Nota Fiscal.
• Pedidos de Compra originados em liberações de período (medição) somente serão marcados para apropriação na Nota Fiscal caso o parâmetro de projeto "Apropriar liberação de período de contratos em:" tenha o valor "Apropriar na Nota Fiscal" e o contrato esteja parametrizado para gerar apropriação na liberação do período.

Valor "Apropriar na Medição":

• Serão enviados como "Apropriar na Medição" todos os Pedidos de Compra originados em liberações de período (medição) caso o parâmetro de projeto "Apropriar liberação de período de contratos em:"  tenha o valor "Apropriar na Medição" e o contrato esteja parametrizado para gerar apropriação na liberação do período.

Valor "Não Apropriar": 

• Serão enviados como "Não apropriar" todos os Pedidos de Compra originados em liberações de período (medição) cujo contrato esteja parametrizado para não gerar apropriação na liberação de período, independente do valor do parâmetro de projeto "Apropriar liberação de período de contratos em:".
  
  

Dados de Processo:

Descrição do Processo: Processo de carga de dados de apropriação nos Pedidos de Compra integrados

Nome do Processo: PrjAtualizaDadosApropOrderProc

Action do Processo: PrjAtualizaDadosApropOrderProcAction

Mensagem trafegada: OrderAssignmentsInformation

Tela do Processo

A rotina permite o processamento por coligada ou a seleção de múltiplas coligadas e agendamento para posterior execução.

Image Added

Detalhes Tecnicos