Árvore de páginas

VISUALIZAÇÃO DE MOEDAS SIMULTÂNEAS NO PEDIDO

Produto: Automação da Força de Vendas
Linha de Produto: TOTVS CRM
Segmento: Cross Segmentos
Módulo: Vendas - Moeda
Aplicação: Web/Mobile
Identificador: DTSFAPD-2556

    VISÃO GERAL

Esta atualização melhora a forma como os valores monetários são apresentados, especialmente em transações internacionais. Ela permite aos usuários visualizar e converter automaticamente os valores dos pedidos entre a moeda padrão da tabela de preços e uma moeda alternativa selecionada. Isso facilita o entendimento das transações em diferentes moedas e melhora a precisão dos cálculos de conversão.

    OBJETIVO

Facilitar a gestão de pedidos em múltiplas moedas, permitindo a conversão automática entre a moeda padrão e uma moeda alternativa, de acordo com as cotações atualizadas.

  DETALHES FUNCIONAIS

Funções

  • Conversão de Moedas: Permite a conversão automática de valores entre a moeda padrão da tabela de preços e a moeda selecionada no cabeçalho do pedido.
  • Cotação Diária: Utiliza cotações atualizadas diariamente para garantir precisão na conversão de moedas.
  • Visualização de Valores Convertidos: Mostra os valores nos pedidos nas duas moedas, facilitando a compreensão e comparação dos valores.

  COMO USAR?

Passo a Passo

  1. Selecione e configure as moedas a serem utilizadas nos pedidos.
  2. Na criação do pedido, escolha a moeda alternativa no cabeçalho.
  3. O sistema exibirá automaticamente os valores convertidos no resumo do pedido.


 EXEMPLO PRÁTICO

Desafio Antigo:

Dificuldade em gerenciar pedidos em diferentes moedas e na precisão da conversão de valores monetários.


Solução Atualizada:

Com a nova funcionalidade, ao escolher uma moeda alternativa no pedido, o sistema realiza automaticamente a conversão dos valores baseando-se na cotação diária. Isso garante a exatidão dos valores apresentados e facilita o gerenciamento de transações internacionais.


  DETALHES TÉCNICOS

  1. Banco de dados
    • Pelo tools, opção 3, o sistema deve criar o seguinte campo na tabela cotacaoindexador:
      • idindexadororigem: FK (Foreign Key) para a tabela indexador, nullable.
    • Pelo tools, opção 18, o sistema deve criar um registro na tabela wsconfigpedidocampo (detalhes do registro a ser criado não foram fornecidos).
    • html:contexto nomeentidade label idnativo idnvisivel idneditavel idneditavelcomitens idnobrigatorio idnuniao ordem codigoerp idnexiberelatorio
      CABECALHO MOEDAORIGEM "Moeda Origem" 0 1 1 1 0 2 20

    • Pelo tools, opção 18, o sistema deve criar registro na tabela wsconfigpedidoresumo:

      Chave Label Ordem idnvisivel idnobrigatorio codigoerp idnexiberelatorio idneditavel
      VALOR_FATURADO_MOEDAORIGINAL 0 0 0 0 0 0
      VALOR_PENDENTE_MOEDAORIGINAL 0 0 0 0 0 0
      VALOR_TOTAL_BRUTO_MOEDAORIGINAL 0 0 0 0 0 0
      VALOR_TOTAL_COM_IMPOSTOS_MOEDAORIGINAL 0 0 0 0 0 0
  2. Telas de configuração
    • Na tela Configuração > Configuração Pedido > Busca Cabeçalho:
      • Implementar novo registro MOEDAORIGEM.
      • Para o registro MOEDAORIGEM, as colunas "Editável" e "Editável com Itens" não devem ter ação, recebendo o valor "-".
    • Na tela Configuração > Configuração Pedido > Resumo:
      • Implementar novos registros (detalhes dos registros a serem implementados não foram fornecidos).

      • Campos
        VALOR_FATURADO_MOEDAORIGINAL
        VALOR_PENDENTE_MOEDAORIGINAL
        VALOR_TOTAL_BRUTO_MOEDAORIGINAL
        VALOR_TOTAL_LIQUIDO_MOEDAORIGINAL
        VALOR_TOTAL_DESCONTOS_MOEDAORIGINAL
        VALOR_TOTAL_COM_IMPOSTOS_MOEDAORIGINAL
        VALOR_DESCONTO_RESUMO_MOEDAORIGINAL
        VALOR_TOTAL_FORMULA_MOEDAORIGINAL
      • A coluna "Editável" não deve ter ação para esse registro, recebendo o valor "-"
  3. Implementação no pedido
    • Nos ambientes Web/Android, no pedido de venda:
      • No cabeçalho, criar o campo "Moeda Origem", cujo comportamento de tela é associado ao metadado de código "MOEDAORIGEM".
      • O valor do campo "Moeda Origem" será fixo, trazido do campo de banco de dados tabelapreco.idindexador referente à tabela de preço selecionada no cabeçalho.
    • Na pesquisa de opções selecionáveis do campo cotacaoindexador:
      • Na cláusula associada ao registro "INDEXADOR_IDINDEXADOR", o sistema deverá alterar o filtro (detalhes específicos do novo filtro não foram fornecidos).
      • 
        
                                        /* select * from cotacaoindexador
        	where (idindexador = ${indexador selecionado no cabeçalho}
        		or idindexadororigem = ${indexador selecionado no cabeçalho})
        		and (idindexador = ${indexador origem}
        		or  idindexadororigem = ${indexador origem})
          
      • Nos itens do pedido:
        • Na pesquisa do campo "Tabela preço" dos itens, aplicar um filtro fixo para trazer apenas tabelas de preço cujo campo tabelapreco.idindexador seja o mesmo do campo "Moeda Origem".
        • No cálculo do preço de tabela:
          • Se cotacaoindexador.idindexadororigem for igual ao campo de tela "Moeda origem" e cotacaoindexador.idindexador for igual ao campo de tela "Moeda", o sistema deve multiplicar o preço da tabela tabelaprecoproduto pelo fator do campo cotacaoindexador.valor.
          • Se cotacaoindexador.idindexadororigem for igual ao campo de tela "Moeda" e cotacaoindexador.idindexador for igual ao campo de tela "Moeda origem", o sistema deve dividir o preço da tabela tabelaprecoproduto pelo fator do campo cotacaoindexador.valor.
      • No resumo do pedido:
        • Implementar novos elementos de tela referentes aos registros de metadados especificados (detalhes dos registros de metadados a serem implementados não foram fornecidos).

      • Campo Implementação Associada
        VALOR_FATURADO_MOEDAORIGINAL Valor faturado: ${Cifrão da moeda associada à tabela de preço} ${Valor convertido à moeda associada à tabela de preço} / ${Cifrão da moeda selecionada no cabeçalho} ${Valor convertido à moeda selecionada no cabeçalho}
        VALOR_PENDENTE_MOEDAORIGINAL Valor pendente: ${Cifrão da moeda associada à tabela de preço} ${Valor convertido à moeda associada à tabela de preço} / ${Cifrão da moeda selecionada no cabeçalho} ${Valor convertido à moeda selecionada no cabeçalho}
        VALOR_TOTAL_BRUTO_MOEDAORIGINAL Valor total bruto: ${Cifrão da moeda associada à tabela de preço} ${Valor convertido à moeda associada à tabela de preço} / ${Cifrão da moeda selecionada no cabeçalho} ${Valor convertido à moeda selecionada no cabeçalho}
        VALOR_TOTAL_LIQUIDO_MOEDAORIGINAL Valor total líquido: ${Cifrão da moeda associada à tabela de preço} ${Valor convertido à moeda associada à tabela de preço} / ${Cifrão da moeda selecionada no cabeçalho} ${Valor convertido à moeda selecionada no cabeçalho}
        VALOR_TOTAL_DESCONTOS_MOEDAORIGINAL Valor total descontos: ${Cifrão da moeda associada à tabela de preço} ${Valor convertido à moeda associada à tabela de preço} / ${Cifrão da moeda selecionada no cabeçalho} ${Valor convertido à moeda selecionada no cabeçalho}
        VALOR_TOTAL_COM_IMPOSTOS_MOEDAORIGINAL Valor total com impostos: ${Cifrão da moeda associada à tabela de preço} ${Valor convertido à moeda associada à tabela de preço} / ${Cifrão da moeda selecionada no cabeçalho} ${Valor convertido à moeda selecionada no cabeçalho}
        VALOR_DESCONTO_RESUMO_MOEDAORIGINAL Valor desconto resumo: ${Cifrão da moeda associada à tabela de preço} ${Valor convertido à moeda associada à tabela de preço} / ${Cifrão da moeda selecionada no cabeçalho} ${Valor convertido à moeda selecionada no cabeçalho}
        VALOR_TOTAL_FORMULA_MOEDAORIGINAL Valor total fórmula: ${Cifrão da moeda associada à tabela de preço} ${Valor convertido à moeda associada à tabela de preço} / ${Cifrão da moeda selecionada no cabeçalho} ${Valor convertido à moeda selecionada no cabeçalho}

      • Cálculo do valor monetário associado à moeda de origem:
        • Se o campo cotacaoindexador.idindexadororigem for igual ao campo de tela "Moeda origem" e o campo cotacaoindexador.idindexador for igual ao campo de tela "Moeda":
          • O sistema deve realizar a divisão do valor monetário de referência pelo fator do campo cotacaoindexador.valor.
        • Se o campo cotacaoindexador.idindexadororigem for igual ao campo de tela "Moeda" e o campo cotacaoindexador.idindexador for igual ao campo de tela "Moeda origem":
          • O sistema deve realizar a multiplicação do valor monetário de referência pelo fator do campo cotacaoindexador.valor.

PERGUNTAS FREQUENTES

  • question_answerQual é o objetivo principal dessa atualização?
    Facilitar a gestão de pedidos em múltiplas moedas, permitindo conversões automáticas entre a moeda padrão e uma moeda alternativa escolhida, melhorando a precisão dos cálculos.