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

TOTVS Obras e Projetos

Módulo

Contratos

Segmento Executor

Construção e Projetos

Projeto1

R_C&P_TOP010

IRM1

PCREQ-8788

Requisito1

PCREQ-8792

Subtarefa1

PDR_CP_TOP010-34

Chamado2

 

Release de Entrega Planejada

12.1.10

Réplica

Não

País

(X) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

Pré-Requisitos para melhor entendimento da especificação:

http://wikihelp.totvs.com.br/WikiHelp/PRJ/PRJ.Contrato.aspx

IntegraçãoTOP x Protheus (Mensagem Única e Stored Procedure)

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

Com o objetivo de atender principalmente ao Mercado Internacional (MI), será implementado no TOTVS Obras e Projetos (TOP), no modulo de contratos, o conceito de Moeda do Contrato, que possibilita que um determinado contrato possa trabalhar com valores que serão cotados de forma diferente em relação ao utilizado no projeto, isto é, a moeda do contrato será prioritária em relação à moeda do projeto.

Definição da Regra de Negócio

A contratação de bens e serviços no Mercado Internacional geram pagamentos e/ou recebimentos em moedas estrangeiras. Dessa forma, é necessário que o módulo de contratos do TOP se adeque à essa necessidade, possibilitando assim, que todos os valores que de alguma forma estão relacionados a um contrato, possam ser tratados considerando a moeda na qual o contrato foi definido, diferente da moeda na qual o projeto foi orçado e planejado. Considerando toda essa premissa, vários pontos no TOP, principalmente no módulo de contratos, deverão ser modificados e essas alterações serão detalhadas a seguir.


1. Parâmetro para definição de utilização de Moeda no Contrato

  • Deverá ser criado um novo parâmetro de projeto "Utilizar moeda no contrato", para que possa ser definido se será permitido, no cadastro de contratos, a informação da moeda do contrato;O parâmetro deverá ter o seguinte texto "Utilizar moeda no contrato" e . Este parâmetro estará presente na aba Geral nos parâmetros de contrato (Protótipo 01);
  • Também deverá ser criado um parâmetro de projeto, que estará habilitado se o parâmetro acima estiver marcado, que define qual será a data de conversão utilizada para a busca da cotação, quando houver necessidade, "Data Base de Conversão da Moeda" (Protótipo 01);
  • Caso exista algum contrato que já possui alguma moeda definida, esse parâmetro não poderá ser desmarcado e um alerta deverá ser exibido na tela de parâmetros do projeto (Protótipo 02).

2. Cadastro de Contratos

  • No cadastro de contratos, na tela de edição, deverá ser possível informar a moeda que será adotada no contrato (Protótipo 03);
  • Esse novo campo, "Moeda", estará disponível para todos os tipos de contratos;
  • Essa moeda poderá ser diferente da moeda do projeto;
  • Contratos que já possuem tarefas associadas não poderão ter a moeda do contrato alterada;

3. Associação de Itens ao Contrato

  • Na associação de itens (tarefas) ao contrato poderão ser associadas qualquer tarefa da EAP (Estrutura Analítica de Projeto), porém, essa associação será realizada considerando a moeda do contrato. Nas As opções  de associação "Valor Unitário (com BDI)" e , "Custo Unitário" , deverá ser adicionado o texto "Cotação", caso o projeto utilize e "Nenhum", estarão desabilitadas quando o projeto utilizar moeda no contrato e a mesma seja diferente da moeda do projeto. Selecionada uma dessas opções ao associar a tarefa, deverá acontecer uma conversão de valores, onde a cotação utilizada será baseada no parâmetro de projeto "Data Base para Conversão" que é definido em Parâmetros de Projeto / Cálculo / Outros. Se selecionada a opção "Nenhum", o valor contrato deverá ser informado manualmente onde deverá considerar a moeda do contrato (Protótipo 04), e a terceira opção estará marcada, pois o Valor Contratado deverá ser informado manualmente;
  • A descrição das colunas "Valor Unitário", "Custo Unitário", "Custo Parcial" e "Valor Parcial" deverão ser alteradas para que apresentem a moeda do projeto e a coluna "Valor Unitário Contratado" a moeda utilizada no contrato (Protótipo 04);
  • Esse processo deverá continuar a considerar os parâmetros o parâmetro "Permitir contratação de serviços com valor superior ao orçado (Contratos a Pagar)" e "Não associar itens/objetos em mais 100% da quantidade orçada (Contratos a Pagar)", porém, deverá ser considerada uma margem de erro pois será necessário realizar uma conversão de valores para que a validação esteja correta, e nesse caso, pode acontecer de essa mesma conversão não atingir exatamente o valor orçado.

    3.1. Detalhamento de Itens Contratados
  • Para contratos que utilizam detalhamento de itens, os insumos no qual a moeda do preço for diferente da moeda do contrato, deverão ter seus valores convertidos, considerando a moeda do contrato e também a Data Base para Conversão;
    • A descrição das colunas "Valor Unitário Orçado" e "Custo Unitário Orçado" deverão, também, ser alteradas para que apresentem a moeda do projeto e a coluna "Valor Unitário Contratado" a moeda utilizada no contrato (Protótipo 04).

4. Liberação de Período

  • No processo de liberação de períodos, os valores utilizados serão oriundos da medição, seguindo as regras de parametrização de projeto, formulas de contrato, dedução e retenção;
  • Deverá ser enviada a moeda do contrato quando liberado para o financeiro;
  • Em relação ao reajuste, a moeda do contrato deverá ser considerada para a aplicação e não a do projeto;
  • Na inclusão de produtos faturados deverá ser realizado a conversão de cotação em relação ao saldo e valor a deduzir;
  • Nas descrições dos campos de valores, deverá conter a moeda do contrato (Protótipo 05).

5. Gerar integração com Suprimentos/Faturamento

  • No processo de geração de movimento para o suprimentos/faturamento, os valores também são oriundos da medição, não tendo necessidade de conversões;
  • A moeda do contrato deverá ser enviada, juntamente com todos os parâmetros e valores que atualmente são enviados para a geração do movimento.

6. Liberação de Retenção

  • Deverá ser enviada a moeda do contrato quando a retenção for liberada.

7. Adiantamento de Contratos

  • A moeda do contrato deverá ser enviada, juntamente com todos os parâmetros e valores que atualmente são enviados na liberação do adiantamento;
  • No caso de adiantamentos da Argentina, onde o adiantamento é inserido no TOP a partir dos títulos existentes no Protheus, será necessário realizar a conversão de valores caso a moeda do adiantamento seja diferente da moeda do contrato;
  • A descrição das colunas de valores deverão ser alteradas para que apresentem a moeda utilizada no contrato.

8. Atualizar Cronograma pelos Lançamentos da Medição

  • No processo de atualizar cronograma pelos lançamentos da medição deverá, também, ocorrer a conversão de valores no momento em que os valores são lançados no cronograma em caso de a moeda do contrato ser diferente da moeda do projeto.

9. Associar Objetos ao Contrato

  • No processo de associar objetos ao contrato, o Valor Unitário Contratado deverá apresentar os valores convertidos de acordo com a cotação, no caso de a moeda do preço do insumo ser diferente da moeda utilizada no contrato;
  • Nas opções  A associação deverá ser realizada considerando a moeda do contrato. As opções de associação "Valor Unitário" e , "Custo Unitário" , deverá ser adicionado o texto "Cotação", caso o projeto utilize e "Nenhum", estarão desabilitadas quando o projeto utilizar moeda no contrato e a mesma seja diferente da moeda do projeto (Protótipo 06), e a terceira opção estará marcada, pois o Valor Unitário Contratado deverá ser informado manualmente;
  • A descrição das colunas "Valor Unitário Orçado" e "Custo Unitário Orçado" deverão, também, ser alteradas para que apresentem a moeda do projeto e a coluna "Valor Unitário Contratado" a moeda utilizada no contrato (Protótipo 06).

10. Pedido de Material / Pedido de Material Extra

  • Para os pedidos de material e material extra deverão ser realizadas três alterações relacionadas ao contrato de fornecimento de material com moeda diferente da moeda do projeto (Protótipo 07):
    • Incluir coluna "Moeda" na exibição dos itens do pedido de material e material extra;
    • Após criar o período do contrato, e definir o valor da medição, deverá ser realizada a conversão de valores caso a moeda do preço do insumo seja diferente da do contrato;
    • Ao associar o contrato manualmente ao item do pedido, o valor do mesmo deverá, também, ser convertido para a moeda do contrato.

11. Atualizar Consumo pela Apropriação (Timesheet)

  • O processo de atualizar o consumo através da apropriação deverá ser modificado, pois ao incluir o consumo do insumo no contrato, o valor em questão, deverá ser convertido considerando a moeda do contrato em relação à moeda do preço do insumo.

12. Cronograma de Desembolso

  • Ao calcular o cronograma de desembolso considerando contratos, deverá acontecer a conversão do Valor Unitário Contratado de cada insumo contratado e também do Valor Previsto do contrato.

1312. Saldo para Fluxo de Desembolso

  • No processo de saldo para fluxo de desembolso, ao obter a natureza orçamentária relacionada ao contrato, o valor atual de cada item associado deverá ser convertido para a moeda do projeto, e o mesmo deverá acontecer para o valor do contrato e valor previsto que também são utilizados para o cálculo do fluxo de desembolso.

1413. Insumo Derivado: Derivação de Contratos

  • Para insumo derivado, existe a possibilidade de vincular um contrato de serviço de qualquer projeto na regra de derivação. Existem três funções de fórmulas que complementam essa derivação de contratos que deverão ter o retorno dos valores, previsto, medido e liberado, convertidos de acordo com a moeda do contrato vinculado ao insumo:
    • VLRPDOCNTPLAN(TIPOBUSCA): Resgata o valor previsto do contrato para o período de cronograma;
    • VLRPDOCNTMED(TIPOBUSCA): Resgata o valor medido do contrato para o período de cronograma;
    • VLRPDOCNTREAL(TIPOBUSCA): Resgata o valor liberado do contrato para o período de cronograma.

1514. Contratos de Licitação

  • Não será possível criar contratos de licitação com moeda diferente da moeda do projeto pois no processo de Gerar Contrato não será possível informar a moeda do contrato. 

1615. Relatórios

  • Alguns relatórios deverão ser modificados para que apresentem a moeda do contrato ao lado dos valores que são exibidos, e são eles:
    • Medição Completa: Medição Completa e Medição Completa com Detalhamento de Retenção;
    • Genéricos: Contratos por Projeto, Itens do Contrato, Relação de Contratos por Projeto, Itens Medidos, Pagamento de Medição, Resumo de Medições do Projeto por Contrato e Evolução Financeira.

1716. Integração TOP x Protheus (Mensagem Única)

  • Na integração TOP x Protheus, serão necessárias algumas alterações nos seguintes itens:
    • Pedido de Compra: A mensagem utilizada para essa integração é a ORDER, sendo que o campo CURRENCYCODE já existe na mensagem, porém, do lado Protheus, será necessário analisar a interpretação desse campo para que possa ser inserido no pedido;
    • Nota Fiscal de Entrada: A mensagem utilizada é a INVOICE, e será necessário incluir esse novo campo CURRENCYCODE no qual receberá a moeda do contrato que originou o pedido. Do lado Protheus, será necessário ajustar a interpretação desse novo campo para que possa ser inserido na nota;
    • Liberação de Adiantamento: A mensagem utilizada é a ACCOUNTRECEIVABLEDOCUMENT, e também já possui o campo CURRENCYCODE, sendo necessário mapeá-lo para o campo de moeda do contrato;
    • Liberação de Retenção: A mensagem utilizada é a ACCOUNTPAYABLEDOCUMENTREPLACE, e também já possui o campo CURRENCYCODE, sendo necessário mapeá-lo para o campo de moeda do contrato.

18. Integração por Stored Procedure

  • Na integração por stored procedure, será necessário realizar alterações nas integrações que envolvem Contratos e Pedido de Material, para que a moeda do movimento seja mapeada e enviada ao Protheus, assim como:
    • Pedido de Compra: Deverá ser incluído o campo C7_MOEDA;
    • Solicitação de Compra: Deverá ser incluído o campo CMOEDA;
    • Contas a Pagar: Deverá ser incluído o campo CE2_MOEDA;
    • Contas a Receber: Deverá ser incluído o campo CE1_MOEDA.


  Importante:

  • As conversões citadas anteriormente deverão considerar a cotação existente para uma determinada data como por exemplo a "Data Base para Conversão" existente nos parâmetros do projeto. Um exemplo dessa conversão pode ser visualizada a seguir:

    Valor a ser convertidoMoeda do ProjetoMoeda do ContratoData BaseCotaçãoValor Convertido
    1.500,00R$U$01/01/2016 1,00 U$ = 3,90 R$384,60 U$
  • Atualizar Consumo pela Apropriação (Timesheet)
  • Algumas funcionalidades importantes do módulo de contratos, não necessitarão de alterações na regra de negócio, pois, trabalham com os valores já devidamente convertidos em relação à moeda do contrato, porém, nos campos onde são exibidos os valores deverá ser incluído, junto à descrição, o texto com a informação da moeda do contrato, assim como:
    • Processo de Medição de Item de Contrato;
    • Processo de Realinhar Itens Associados ao Contrato;
    • Processo de Reajustar Itens Associados ao Contrato;
    • Processo de Lançamento de Reajuste Definitivo;
    • Anexo Períodos do Contrato;
    • Anexo Aditivos Contratuais;
    • Anexo Itens Contratados;
    • Anexo Produtos Faturados no Contrato;
    • Anexo de Itens Medidos;
    • Anexo de Retenções Contratuais;
    • Anexo de Objetos do Contrato.

 

Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

Contratos

[Alteração]

[Controle -> Contrato -> Contratos]

-

Protótipo de Tela

Protótipo 01

Protótipo 02

Protótipo 03

Protótipo 04

Image Removed Image Added

Protótipo 05 

 Protótipo 06

Image RemovedImage Added

Protótipo 07

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