Histórico da Página
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
(Obrigatório)
Informações Gerais
Especificação | |||
Produto |
TOTVS Obras e Projetos | Módulo |
Projeto1
IRM/EPIC1
Requisito/Story/Issue1
Subtarefa1
Apropriação de Custos |
Segmento Executor |
Construção & Projetos |
Chamado/Ticket |
País | ( |
X) Brasil ( |
X) Argentina ( |
X) |
México ( |
X) Chile ( |
X) Paraguai ( |
X) Equador |
Outros
<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>.
( |
X) Colômbia | ||
Outros |
As opções descritas neste tópico estão disponíveis |
quando o TOP estiver integrado com o BackOffice PROTHEUS através do modelo |
Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos).
EAI 2.0 ou EAI 1.0 |
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 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.
Informações | ||
---|---|---|
| ||
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:
Parâmetros no TOP
Para parametrizar o processo vá em: "Parâmetro de Projetos | Apropriação | Apropriação BackOffice” e preencha os seguintes campos:
(Obrigatório)
Objetivo
- 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
- 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.
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 Documento | Datas de Apropriação |
Notas fiscais | Data de Criação |
Data de Emissão | |
Baixas de estoque | Data de Emissão |
Contas a pagar | Data 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
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:
Consistê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.
<Nesta etapa informar o objetivo da especificação do requisito, ou seja, o que a funcionalidade deve fazer. Exemplo: Permitir que o usuário defina o percentual mínimo em espécie (dinheiro), a referência mínima para calculo dos débitos do aluno e o período de validade do parâmetro de negociação>.
(Obrigatório)
Definição da Regra de Negócio
Opcional
Protótipo de Tela
Protótipo 01 – Parâmetros BackOffice
Parâmetros Customizáveis
Será possível customizar um filtro para os grupos de produtos.
Detalhes?
Parâmetros PROTHEUS
Não existem parâmetros relacionados a este processo.
Opcional
Fluxo do Processo
<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>.
Opcional
Dicionário de Dados
(Opcional)
Grupo de Perguntas
(Opcional)
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.
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.
Executando e agendando o processo com parâmetro "Importar toda a Planilha" desmarcado.
Neste processo é permitido informar tarefas e períodos inicial e final.
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.
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 . |
Informações | ||
---|---|---|
| ||
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 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.
(Opcional)
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 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.
Detalhes Tecnicos
IDPRJ | IDTRF | QUANTIDADE | PRECOUNITARIO | ACRESCIMO | DESCONTO | VALORTOTAL | DATAAPROPRIACAO | MOEDA | TIPOAPROP | CODCFO | IDPRD | CODUND | NUMERODOC | NUMEROITMDOC | ORIGEMAPROP | IDISM |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|