Moeda
Criado por Igor Ribeiro em 03 de setembro de 2026
Atualizado por Igor Ribeiro em 03 de setembro de 2026
Moeda
Cadastro e gerenciamento de moedas com histórico de cotações. Essencial para conversão automática de valores em transações que envolvem moedas estrangeiras.
Visão Geral da Moeda
A rotina Moeda faz parte do módulo Financeiro do ERP, dentro do grupo Cadastros. Ela é o lugar onde o sistema guarda as moedas que a empresa utiliza (por exemplo, Dólar Americano, Euro, Real) e o histórico de cotações de cada uma dessas moedas ao longo do tempo.
Essas informações não servem apenas para consulta: elas são usadas automaticamente por outras rotinas do ERP sempre que é preciso converter um valor lançado em moeda estrangeira para a moeda padrão da empresa, ou o caminho inverso. Isso acontece, por exemplo, em documentos financeiros e operações que envolvem valores em dólar, euro ou qualquer outra moeda diferente da moeda padrão utilizada pela empresa.
Em resumo: cadastrar corretamente as moedas e manter as cotações atualizadas nesta rotina garante que os valores convertidos automaticamente em outras partes do sistema estejam corretos.
As informações de moedas e cotações são fundamentais para o funcionamento correto de outras rotinas do sistema que dependem de conversão de valores automática.
Vídeo Tutorial da Moeda
Pré-requisitos e Contexto de Acesso da Moeda
Para visualizar a listagem e consultar as moedas cadastradas, o usuário precisa ter a permissão “ListViewDeMoeda” associada ao seu perfil de acesso no sistema.
Além dessa permissão de visualização, cada ação de manutenção sobre o cadastro de moedas exige uma permissão própria:
- Para incluir uma nova moeda: “Moeda/Novo”
- Para editar uma moeda já existente: “Moeda/Editar”
- Para excluir uma moeda: “Moeda/Excluir”
- Para exportar a listagem de moedas: “Moeda/Exportar”
- Para importar moedas: “Moeda/Importar”
Não existe nenhuma rotina ou cadastro anterior que precise ser feito antes de criar uma moeda: o cadastro de moeda pode ser o primeiro passo. Porém, para que as cotações lançadas aqui sejam efetivamente usadas em outras rotinas do sistema (como conversões de valores), é necessário que a moeda já esteja cadastrada previamente.
Processo de Criação: Passo a Passo da Moeda
Acessar a rotina
O usuário acessa o caminho Financeiro > Cadastros > Moeda e aciona a opção de novo cadastro. Como alternativa a preencher tudo manualmente, também é possível trazer moedas já prontas de um catálogo interno do próprio sistema, usando o recurso de importação (os detalhes desse recurso estão descritos na Seção 8, “Estrutura Técnica e Comportamento do Sistema da Moeda”).
Preencher os dados principais
O usuário informa o código, o nome e o símbolo da moeda, além de selecionar a classificação do tipo de moeda. A explicação detalhada de cada um desses campos está na Seção 5, “Descrição de Cada Campo da Tela da Moeda”.
Informar cotações (etapa opcional)
Ainda durante a criação, o usuário pode incluir uma ou mais cotações da moeda, cada uma com sua respectiva data e o valor correspondente naquela data. Essa etapa não é obrigatória no momento da criação: as cotações também podem ser incluídas depois, quando o usuário editar a moeda já cadastrada.
Salvar
Ao confirmar o cadastro, o sistema grava a moeda e, se houver, também grava as cotações que foram informadas. Em seguida, o sistema exibe a mensagem de confirmação “Moeda inserida com sucesso.”
Descrição de Cada Campo da Tela da Moeda
Código
Descrição: É o número que identifica de forma única cada moeda dentro do sistema. É por meio desse código que o sistema reconhece qual moeda está sendo referenciada em outras telas e rotinas.
Comportamento: Funciona como a chave do cadastro, ou seja, é o valor principal usado para localizar e referenciar essa moeda a partir de outras partes do sistema. Por ser a chave do cadastro, não pode ser alterado depois que a moeda é criada (ver Seção 7, “Processo de Edição da Moeda”).
Impacto: Esse código aparece internamente em documentos e lançamentos financeiros que utilizam a moeda cadastrada, servindo de referência para o sistema localizar as informações corretas dessa moeda.
Nome
Descrição: É o nome da moeda propriamente dito, como por exemplo “DÓLAR AMERICANO” ou “EURO”.
Comportamento: Esse campo é usado pelo sistema quando o usuário faz uma busca na grade principal de moedas: ao digitar um texto no campo de busca, o sistema retorna as moedas cujo nome contém o texto digitado. O nome também é o que aparece nas telas de outras rotinas do sistema em que o usuário precisa escolher uma moeda.
Impacto: Esse nome é exibido em todas as listas de seleção de moeda espalhadas pelo sistema, ajudando o usuário a identificar visualmente qual moeda está escolhendo.
Símbolo
Descrição: É a sigla ou símbolo que representa a moeda, como “USD” para dólar americano ou “EUR” para euro.
Comportamento: O sistema exibe esse símbolo junto ao valor da cotação em algumas telas, ajudando a identificar rapidamente a que moeda aquele valor se refere.
Impacto: Aparece em conjunto com valores convertidos em outras partes do sistema, facilitando a identificação de qual foi a moeda de origem daquele valor.
Tipo de Moeda
Descrição: Campo usado para classificar a moeda de acordo com um tipo pré-definido pelo sistema.
⚠ Informação incompleta: Comportamento e Impacto não disponíveis na documentação de origem. Validar com analista responsável quanto às opções disponíveis nesse campo e ao efeito prático no comportamento do sistema.
Data da Cotação
(item da grade de cotações)
Descrição: É a data em que o valor de cotação informado junto a ela é considerado válido. Cada moeda pode ter várias cotações cadastradas, uma para cada data.
Comportamento: Se o usuário salvar uma edição da moeda com uma cotação cuja data tenha um ano incorreto (ano igual ou anterior a 1900) ou sem o valor da cotação preenchido, o sistema descarta essa cotação automaticamente e sem exibir nenhum aviso ao usuário (ver detalhes na Seção 9, Regra 1, “Regras de Negócio e Restrições da Moeda”).
Impacto: Essa data é usada por outras rotinas do sistema para localizar qual é a cotação vigente da moeda em um determinado dia, por exemplo, no momento de converter um valor.
Valor da Cotação
(item da grade de cotações)
Descrição: É o valor da cotação da moeda referente à data informada no campo “Data da Cotação”. Normalmente, esse valor representa quanto a moeda estrangeira equivale em relação à moeda padrão utilizada pela empresa.
Comportamento: Esse valor é usado pelo sistema sempre que outra rotina precisa converter um valor lançado nessa moeda estrangeira.
Impacto: Se não existir nenhuma cotação cadastrada para a data de que o sistema precisa, o sistema utiliza automaticamente o valor “1” no lugar da cotação real (ou seja, não faz nenhuma conversão), em vez de impedir a operação de continuar. Isso está detalhado na Seção 9, Regra 3, “Regras de Negócio e Restrições da Moeda”.
Utilização e Consulta de Registros da Moeda
Consulta Direta do Usuário
O usuário localiza moedas já cadastradas por meio da grade principal da tela de Moeda, digitando parte do código ou parte do nome da moeda no campo de busca disponível. A grade de resultados é organizada em páginas e permite ordenar os registros encontrados.
Consultas Internas do Sistema
Além dessa consulta feita diretamente pelo usuário, o sistema também realiza, internamente, dois tipos de consulta especializada sobre as moedas cadastradas. Essas consultas não são operadas diretamente pelo usuário nesta tela, mas é importante que ele saiba que elas existem, pois explicam o comportamento de outras telas do sistema que envolvem seleção de moeda:
Retorna apenas as moedas que já possuem alguma cotação com valor efetivamente lançado.
Retorna apenas as moedas cuja cotação mais recente é anterior à data de hoje e tem valor maior que zero. Essa consulta é usada, por exemplo, para oferecer ao usuário, em telas de seleção de outras rotinas, apenas as moedas estrangeiras que já possuem uma cotação válida cadastrada.
Processo de Edição da Moeda
Depois que a moeda é cadastrada, o usuário pode alterar o nome, o símbolo, o tipo de moeda e a lista de cotações. O campo Código não pode ser alterado após a criação, pois ele é a chave que identifica a moeda de forma única no sistema.
Ao salvar uma edição, é importante que o usuário saiba que o sistema descarta automaticamente e sem aviso qualquer cotação que esteja com data inválida (ano igual ou anterior a 1900) ou sem o valor preenchido.
Recomendação: Como esse descarte acontece silenciosamente, recomenda-se que o usuário confira a grade de cotações depois de salvar a edição, para garantir que todas as cotações que ele pretendia manter ou incluir realmente foram gravadas (detalhes na Seção 9, Regra 1, “Regras de Negócio e Restrições da Moeda”).
Não foi identificado, na documentação de origem, nenhum histórico de alterações visível ao usuário para o cadastro de moedas. Ou seja, não há uma tela onde o usuário possa consultar quem alterou o quê e quando, nesse cadastro.
Estrutura Técnica e Comportamento do Sistema da Moeda
Consulta de Cotações Automática
As cotações cadastradas nesta rotina são consultadas automaticamente por outras partes do sistema sempre que é necessário converter um valor lançado em moeda estrangeira. Por exemplo, ao calcular o valor equivalente na moeda padrão da empresa para um título financeiro ou documento que foi lançado em outra moeda, o sistema busca aqui a cotação correspondente à data necessária.
Importação de Catálogo Interno
A rotina também oferece um recurso de importação de moedas a partir de um catálogo interno, ou seja, uma lista de moedas já conhecida e mantida dentro do próprio sistema (não é uma consulta feita em tempo real a uma fonte externa). Ao usar esse recurso de importação, o comportamento é o seguinte:
- As moedas do catálogo que ainda não existem no cadastro do usuário são criadas automaticamente.
- As moedas do catálogo cujo código já existe no cadastro só têm o nome atualizado se o usuário marcar explicitamente essa opção durante a importação.
Caso o usuário não marque essa opção, as moedas já existentes permanecem exatamente como estavam, e o sistema não avisa ao usuário quais moedas foram ignoradas nesse processo (detalhes na Seção 9, Regra 2, “Regras de Negócio e Restrições da Moeda”).
A documentação de origem menciona duas funcionalidades relacionadas à consulta automática de cotação junto ao Banco Central: uma para obter o símbolo da moeda padrão do sistema e outra para atualizar automaticamente a cotação de uma moeda consultando o Banco Central. Essas duas funcionalidades não puderam ser confirmadas como efetivamente disponíveis e funcionando na versão do sistema analisada. Antes de orientar o usuário a utilizá-las, é necessário confirmar com o analista ou desenvolvedor responsável se elas estão disponíveis na versão em uso (detalhes na Seção 9, Regra 5, “Regras de Negócio e Restrições da Moeda”).
Regras de Negócio e Restrições da Moeda
Cotações inválidas são descartadas silenciosamente
Quando o usuário salva a edição de uma moeda, o sistema ignora automaticamente qualquer cotação cuja data esteja incorreta (com ano igual ou anterior a 1900) ou cujo valor não tenha sido preenchido. Essas cotações inválidas são simplesmente descartadas pelo sistema, sem que nenhuma mensagem de aviso seja exibida ao usuário. Por esse motivo, é recomendável que o usuário sempre confira a grade de cotações depois de salvar, para se certificar de que todas as cotações desejadas foram realmente gravadas.
Importação não sobrescreve moedas existentes
Quando o usuário importa moedas a partir do catálogo interno do sistema, as moedas cujo código já existe no cadastro só têm o nome atualizado se o usuário selecionar explicitamente essa opção durante a importação. Caso contrário, a moeda que já estava cadastrada permanece exatamente como estava antes da importação. Além disso, o sistema não informa ao usuário quais moedas foram ignoradas durante esse processo, portanto o usuário não recebe um retorno detalhado sobre o resultado da importação.
Sem cotação, sistema usa valor “1”
Quando alguma rotina do sistema precisa da cotação atual ou mais recente de uma moeda e não encontra nenhuma cotação cadastrada para a data necessária, o sistema utiliza o valor “1” no lugar da cotação (o que equivale a não fazer nenhuma conversão), em vez de bloquear a operação que estava sendo realizada. Essa regra evita que processos dependentes de cotação sejam interrompidos, mas o usuário deve estar atento, pois esse comportamento pode mascarar o fato de que uma determinada moeda está sem cotação atualizada, levando a valores convertidos incorretamente sem que nenhum erro seja exibido.
Consulta com texto inválido é bloqueada
Ao pesquisar as cotações de uma moeda utilizando um texto que o sistema não consiga interpretar nem como data, nem como valor numérico, a operação é bloqueada, e o sistema exibe a mensagem: “Consulta inválida. Código da moeda: [código]. Mensagem: Parâmetro de pesquisa inválido.”
Integração Banco Central não confirmada
Existem duas funcionalidades relacionadas a uma possível integração automática com o Banco Central: uma para obter o símbolo da moeda padrão do sistema e outra para atualizar automaticamente a cotação de uma moeda consultando o Banco Central. Essas funcionalidades não puderam ser confirmadas como presentes e funcionando na versão do sistema analisada nesta documentação. Validar com analista responsável se essas funcionalidades estão disponíveis na versão em uso, antes de orientar o usuário a utilizá-las.
Exclusão sem verificação de dependências
Ao excluir uma moeda, o sistema não verifica antecipadamente se essa moeda está sendo utilizada em outros cadastros, documentos ou lançamentos financeiros. Se existirem dependências que impeçam a exclusão, a operação pode falhar por uma restrição interna do sistema, sem apresentar ao usuário uma mensagem de negócio explicando o motivo real do bloqueio, diferente do que ocorre em outras rotinas do sistema, que tratam esse tipo de situação com uma mensagem específica e mais clara para o usuário.
