Páginas filhas
  • ER Apropriação TOP x Protheus EAI 2.0 / EAI 1.0

Versões comparadas

Chave

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

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. 

  

Informações Gerais

Especificação

Produto

RM

TOTVS Obras e Projetos

Módulo

CONSTRUÇÃO E PROJETOS

Projeto1

TOP X PROTHEUS

IRM/EPIC1

 

Requisito/Story/Issue1

 

Subtarefa1

 
Apropriação de Custos

Segmento Executor

 
Construção & Projetos

Chamado/Ticket

2 


País

(

 

X) Brasil  (

 

X) Argentina  (

 

X)

Mexico

México  (

 

X) Chile  (

 

X) Paraguai  (

 

X) Equador

  (

  ) USA  (  ) Colombia   (  ) Outro _____________.

X) Colômbia

Outros

As opções descritas neste tópico estão disponíveis

quanto

quando o TOP estiver integrado com o BackOffice PROTHEUS através do modelo EAI 2.0 ou EAI 1.0



Objetivo

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

 

Na nova solução de apropriação da integração TOP x BackOffice Protheus os dados passam a ser recuperados diretamente do BackOffice Protheus no calculo do cronograma apropriado. Vide Protótipo de Tela 02.

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


Image Added 


Informações
titleImportante

Para que um contrato seja considerado na apropriação, é necessário que a opção 'Apropria Liberação de Período' esteja ativada. Você pode encontrar essa configuração na aba 'Default' na edição do cadastro de contratos.

Se essa opção estiver desativada, o contrato não será apropriado em nenhum dos cenários definidos nas configurações do projeto.



Fluxos:


Image Added


Parâmetros no TOP

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

Image Added


Definição da Regra de Negócio

Parâmetros de Apropriação

Acesso em parâmetro de projetos: “Apropriação | Apropriação BackOffice”. Vide Protótipo 01.

Apropriar liberação de período de contratos em:” está localizado em “Apropriação | Apropriação BackOffice” com as opções “Medição” ou “Nota fiscal”.Quando utilizada a opção “Medição”, o

  • 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
é informado para desconsiderar
  • sendo desconsideradas as movimentações originadas destas medições.
Quando utilizada a opção “Nota Fiscal”, o
  • 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.

Image Removed 

 

Valores discriminados de acordo com o tipo de documento – APROPDISCRIMINARVLR: Se marcado o BackOffice retorna os valores discriminados de acordo com o tipo de documento, senão, é enviado o valor agrupado em somente uma descrição “Apropriação”. Default: (0) zero.

Tipo de DocumentoDatas de Apropriação
Notas fiscaisData de Criação
Data de Emissão
Baixas de estoque Data de Emissão
Contas a pagarData de Emissão
Data de Vencimento
Data de Vencimento Real
 


Considerar o valor do frete – APROPFRETE :

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

 Campo: MPARAMETRO - APROPFRETE


Considerar o valor de do seguro – APROPSEGURO:

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

 Campo: MPARAMETRO - APROPSEGURO


Considerar o valor de da despesa – APROPDESPESA:

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

 

Contas a Pagar

 

  • Considerar o valor da baixa do título / Considerar o valor do título * – APROPVLRBAIXA – Define o valor que é considerado nos títulos financeiros. Default: 0(zero). Este campo é habilitado quando marcado o tipo de documento referente às contas a pagar.

Campo: MPARAMETRO - APROPDESPESA

Considerar o valor de IPI:

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

Campo: MPARAMETRO - APROPIPI


Nota

OBS.: Para o Mercado internacional este parâmetro é utilizado para o IVA. Se marcado considera o mesmo como Desconto no total do item na apropriação e se desmarcado o valor total não é subtraído ou seja contem o IVA.

 


Intervalo de períodos para processamento 

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

 

Campo: APROPPERINI e APROPPERFIM 


Automático

Quando atualizado o cronograma Este intervalo de períodos pode ser informado ou controlado automaticamente pelo sistema quando marcada a opção “Automático” – APROPPERAUTO – A opção de atualização dos parâmetros automaticamente ocorre somente para o processamento de todo o projeto .

 

Quando utilizada a opção automática, o período inicial é atualizado após o processamento de busca das informações no PROTHEUS. É retornado para o processo 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 Exemplo da evolução dos parâmetros de período inicial e final:

Image ModifiedConsistências quando não utilizada a opção automática

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

Image Modified

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

 

 


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 Added








Parâmetros no Protheus

 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


Informações

O valor deduzido e retido será considerado na apropriação .

O sistema exibirá no anexo da planilha de atividade "Apropriações" o valor total  e o Valor total apropriado .

O cronograma passará a exibir o valor apropriado considerando o valor das retenções e deduções .


Image Added





Informações
titleImportação Apropriação (Mercado Internacional)

Importação de Apropriação (Mercado Internacional - Backoffice Protheus) 

Quando for realizada a importação de apropriação e o ambiente estiver configurado para mercado internacional o valor apropriado importado deve respeitar a moeda do projeto e não a moeda do backoffice.

Veja mais detalhes de como cadastrar moeda e cotação neste link: Totvs Obras e Projetos x Backoffice Protheus - Cadastro de moedas e cotações 


Exemplo: Quando for gerado uma solicitação de compra do Totvs Obras e Projetos , de um projeto que utiliza a moeda "R$" ao gerar pedido e compra no backoffice e faturar o mesmo em outra moeda .

Ao executar o processo de importar a apropriação o processo de importação deve considerar a moeda do projeto.




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

Apropriações

de Serviços / Insumos

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

Nos cadastros de “Apropriações No cadastro da “Apropriação de Serviços / Insumos” disponível em “módulo Construção e Projetos | Controle | agrupador Básicono 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

 

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

as

à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 trafegadaOrderAssignmentsInformation

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


IDPRJIDTRFQUANTIDADEPRECOUNITARIOACRESCIMODESCONTOVALORTOTALDATAAPROPRIACAOMOEDATIPOAPROPCODCFOIDPRDCODUNDNUMERODOCNUMEROITMDOCORIGEMAPROPIDISM

















 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.