Histórico da Página

Informações Gerais

   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 (Mercado Internacional)" 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 contratocontratos;
• Essa moeda poderá ser diferente da moeda do projeto;
• Contratos em andamento, com medições realizadas não poderão ter a moeda alterado ou cadastrada;Contratos que já possuem tarefas ou insumos 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 for 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 já na moeda do contrato;
• 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. Essa conversão citada deverá utilizar o parâmetro Data Base de Conversão da Moeda como referência, e deverão ser realizadas duas tentativas de conversão, sendo a primeira, onde a cotação existente tem a moeda do contrato referenciada pela moeda do projeto, como por exemplo U$ 1,00 = R$ 4,00, então o valor associado será convertido. Na segunda maneira, a cotação existente tem a moeda do projeto referenciando a moeda do contrato, assim como, R$ 1,00 = U$ 0,25 convertendo então o valor da tarefa para realizar a validação. A margem de erro deverá considerar o valor convertido somado em mais uma unidade da cotação utilizada, como por exemplo:

                                               Image Added                

Outro exemplo:

Moeda do Projeto: Real (R$), Moeda do Contrato: Dólar (U$)
Valor Unitário: R$ 1.000,00, Valor Contratado: U$ 256,00
Cotação 1: 1 U$ = 3,90 R$, Cotação 2: 1 R$ = 0,25 U$
Validação da primeira conversão: (1.000,00 + 3,90(cotação 1)) maior ou igual a (256,00 X 3,90)
Validação da segunda conversão: (1.000,00 X 3,90) + 0,25(cotação 2) maior ou igual a 256,00                                                              

3.1. Detalhamento de Itens Contratados

• • 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, ao calcular o fator que deverá ser utilizado, a moeda do contrato deverá ser considerada para a aplicação e não a do projeto no caso de ambas serem diferentes;
• Na inclusão de produtos faturados deverá ser realizado a conversão de cotação em relação ao saldo e valor a deduzirum filtro, onde somente os movimentos que possuem a moeda do contrato poderão ter os produtos deduzidos, quando o projeto utilizar moeda no contrato e a moeda for diferente da moeda do projeto. Esse mesmo comportamento deverá ocorrer para o anexo de "Produtos Faturados no Contrato";
• 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 sendo ser diferente da moeda do projeto. A data de referência para a conversão será a Data Início do Período.

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 moeda no contrato e a mesma seja e "Nenhum", estarão desabilitadas quando o projeto utilizar moeda no contrato e a mesma for 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);
• Na listagem de insumos o Valor Unitário Contratado, deverá exibir 0(zero), para os insumos que ainda não foram associados.

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 incluída na visão de itens do pedido, uma 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.

• que indique a moeda do contrato para os itens que estão vinculados à um contrato que possui moeda diferente da moeda do projeto (Protótipo 07);
• Não será necessário separar os movimentos gerados no pedido de acordo com a moeda, pois o próprio processo já agrupa os movimentos separadamente em relação ao contrato vinculado.

1112. 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 utilizando o parâmetro Data Base de Conversão da Moeda como referência e e também do do Valor Previsto do contrato, porém nessa conversão deverá ser utilizada a Data Início do período 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 medido/liberado ou o valor atual de cada item associado deverá ser convertido para a moeda do projeto, considerando a Data Início do período do cronograma como referência, 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 do tipo receita, 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 insumoem relação à moeda do projeto do insumo. A data base para a conversão deverá ser a data de início do período do contrato:
  • 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.
    
    Para um melhor entendimento dessa funcionalidade: http://wikihelp.totvs.com.br/WikiHelp/PRJ/PRJ.InsumoReceita.aspx 
    

1415. 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 As mensagens utilizadas são ACCOUNTRECEIVABLEDOCUMENT e ACCOUNTPAYABLEDOCUMENT, e também já possuem o campo CURRENCYCODE, sendo necessário mapeá-lo para o campo de moeda do contrato;
  • Liberação de Retenção: A mensagem utilizada é a As mensagens utilizadas são ACCOUNTRECEIVABLEDOCUMENTREPLACE e ACCOUNTPAYABLEDOCUMENTREPLACE, e também já possui possuem o campo CURRENCYCODE, sendo necessário mapeá-lo para o campo de moeda do contrato.

17. 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 ComprasCompra: 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:

• Em relação à integração TOP x Protheus, essa funcionalidade de moeda diferente para contratos estará disponível a partir da versão 12.1.10 do TOP e 12.x do Protheus.

• 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 convertido	Moeda do Projeto	Moeda do Contrato	Data Base	Cotação	Valor Convertido
  1.500,00	R$	U$	01/01/2016	1,00 U$ = 3,90 R$	384,60 U$

• O processo de Atualizar Consumo pela Apropriação (Timesheet) não será alterado pois para atualizar o consumo a apropriação deverá ter a moeda igual à do contrato, porém essa consistência não será realizada;
• 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.

Protótipo de Tela

Protótipo 01

 Image RemovedImage Added

Protótipo 02

Image RemovedImage Added

Protótipo 03

Protótipo 04

Image Removed Image Added

Protótipo 05 

 Protótipo 06

Image RemovedImage Added

Protótipo 07

Image RemovedImage Added