Histórico da Página
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: | ||
Integração | TOP 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 serviço contrato foi contratadodefinido, 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á 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:
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).
- 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).
Informações | ||
---|---|---|
| ||
Disponível somente na Integração TOP x Protheus (Mensagem Única). |
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.
Informações | ||
---|---|---|
| ||
Disponível somente na Integração TOP x Protheus (Mensagem Única). |
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 incluída na visão de itens do pedido, uma coluna "Moeda" que indique a moeda do contrato para os itens que estão vinculados à um contrato que possui moeda diferente da moeda do projeto :
- 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;
Rotina | Tipo de Operação | Opção de Menu | Regras de Negócio |
[ACAA040 – Parâmetros] | [Alteração] | [Atualizações -> Acadêmico-> Tesouraria] | - |
[ACAA050 – Negociação Financeira] | [Envolvida] | [Atualizações -> Acadêmico-> Tesouraria] | - |
[ACAA060 – Cadastro de Pedidos] | [Criação] | [Atualizações -> Acadêmico-> Cadastros] | - |
Protótipo de Tela
Protótipo 01
Protótipo 02
Protótipo 03
Protótipo 04
Protótipo 05
Protótipo 06
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
Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/
Índice | Chave |
01 | <FI9_FILIAL+FI9_IDDARF+FI9_STATUS> |
02 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF> |
03 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO> |
Campo | <AAA_PERESP> |
Tipo | <N> |
Tamanho | <6> |
Valor Inicial | <Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. |
Mandatório | Sim ( ) Não ( ) |
Descrição | <Referência Mínima para Cálculo> |
Título | <Ref.Calc.> |
Picture | <@E999.99> |
Help de Campo | <Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação> |
(Opcional)
Grupo de Perguntas
<Informações utilizadas na linha Protheus>.
Nome: FINSRF2
X1_ORDEM | 01 |
X1_PERGUNT | Emissão De |
X1_TIPO | D |
X1_TAMANHO | 8 |
X1_GSC | G |
X1_VAR01 | MV_PAR01 |
X1_DEF01 | Comum |
X1_CNT01 | '01/01/08' |
X1_HELP | Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório |
(Opcional)
Consulta Padrão
<Informações utilizadas na linha Protheus>
Consulta: AMB
Descrição | Configurações de Planejamento |
Tipo | Consulta Padrão |
Tabela | “AMB” |
Índice | “Código” |
Campo | “Código”; ”Descrição” |
Retorno | AMB->AMB_CODIGO |
- (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.
11. 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 Valor Previsto do contrato, porém nessa conversão deverá ser utilizada a Data Início do período do contrato.
12. 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.
13. 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 em 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
14. 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.
15. 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.
16. 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: 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: As mensagens utilizadas são ACCOUNTRECEIVABLEDOCUMENTREPLACE e ACCOUNTPAYABLEDOCUMENTREPLACE, e também já 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 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:
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;
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
Protótipo 05
Protótipo 06
Protótipo 07
(Opcional)
Estrutura de Menu
<Informações utilizadas na linha Datasul>.
Procedimentos
Procedimento |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Módulo |
|
|
|
Programa base |
|
|
|
Nome Menu | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Registro padrão | Sim | Sim | Sim |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Release de Liberação |
|
|
|
Programas
Programa |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Nome Externo |
|
|
|
Nome Menu/Programa | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Nome Verbalizado[1] | (Max 254 posições) | (Max 254 posições) | (Max 254 posições) |
Procedimento |
|
|
|
Template | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) |
Tipo[2] | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Categoria[3] |
|
|
|
Executa via RPC | Sim/Não | Sim/Não | Sim/Não |
Registro padrão | Sim | Sim | Sim |
Outro Produto | Não | Não | Não |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Query on-line | Sim/Não | Sim/Não | Sim/Não |
Log Exec. | Sim/Não | Sim/Não | Sim/Não |
Rotina (EMS) |
|
|
|
Sub-Rotina (EMS) |
|
|
|
Localização dentro da Sub Rotina (EMS) |
|
|
|
Compact[4] | Sim/Não | Sim/Não | Sim/Não |
Home[5] | Sim/Não | Sim/Não | Sim/Não |
Posição do Portlet[6] | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right |
Informar os papeis com os quais o programa deve ser vinculado |
|
|
|
Cadastro de Papéis
<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.
<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.
Código Papel | (máx 3 posições) |
Descrição em Português* |
|
Descrição em Inglês* |
|
[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.
[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante
[3] Categorias são obrigatórias para os programas FLEX.
[4] Obrigatório quando o projeto for FLEX
[5] Obrigatório quando o projeto for FLEX
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|