▶ Tutorial em vídeo: ainda não disponível para esta rotina.

Permissão de Acesso à Rotina

Para acessar a listagem e consulta de moedas, o usuário precisa ter a permissão “Consultar moedas” (ID 135) associada ao seu perfil de acesso.

Permissões por Ação

• Incluir uma nova moeda: permissão “Moeda/Novo” (ID 134)
• Editar uma moeda existente: permissão “Moeda/Editar” (ID 130)
• Excluir uma moeda: permissão “Moeda/Excluir” (ID 131)
• Exportar a listagem: permissão “Moeda/Exportar” (ID 132)
• Importar moedas do catálogo interno: permissão “Moeda/Importar” (ID 133)

Não há dependência de outra rotina ou cadastro prévio para criar uma moeda. Já para lançar cotações e usá-las em outras rotinas do sistema, é necessário que a moeda já esteja cadastrada.

Código

Descrição: Identificador único da moeda no sistema.

Comportamento: Usado como chave do cadastro; é o valor referenciado por outras rotinas ao selecionar uma moeda.

Impacto: Aparece em documentos e lançamentos financeiros que utilizam esta moeda.

Nome

Descrição: Nome da moeda (ex.: “DÓLAR AMERICANO”, “EURO”).

Comportamento: Usado na busca da grade principal (filtra por nome contendo o texto digitado) e nas telas de seleção de moeda em outras rotinas.

Impacto: Exibido nas listas de seleção de moeda do sistema.

Símbolo

Descrição: Símbolo ou sigla da moeda (ex.: “USD”, “EUR”).

Comportamento: Exibido junto ao valor da cotação em algumas telas do sistema.

Impacto: Aparece em conjunto com valores convertidos para facilitar a identificação da moeda de origem.

Tipo de Moeda

Descrição: Classificação do tipo de moeda.

Comportamento: [informação não disponível na análise de código — validar com analista/vídeo do sistema quanto aos valores possíveis e seu efeito]

Impacto: [informação não disponível na análise de código — validar com analista/vídeo do sistema]

Data da Cotação (item da grade de cotações)

Descrição: Data em que o valor de cotação informado é válido.

Comportamento: O sistema descarta silenciosamente, ao salvar uma edição, qualquer cotação cuja data esteja com o ano preenchido incorretamente (ano menor ou igual a 1900) ou sem valor informado — ver Seção 9, Regra 1.

Impacto: Usada por outras rotinas para localizar a cotação vigente em uma determinada data.

Valor da Cotação (item da grade de cotações)

Descrição: Valor da cotação da moeda na data informada, geralmente expresso em relação à moeda padrão do sistema.

Comportamento: Usado nas conversões de valores em moeda estrangeira feitas por outras rotinas do sistema.

Impacto: Se não houver cotação cadastrada para a data necessária, o sistema utiliza o valor “1” (sem conversão) em vez de bloquear a operação — ver Seção 9, Regra 3.

O usuário localiza moedas já cadastradas na grade principal, informando parte do código ou do nome no campo de busca. A grade é paginada e ordenável.

Além da listagem principal, existem consultas especializadas usadas internamente por outras rotinas do sistema: uma retorna apenas moedas que já têm alguma cotação com valor lançado; outra retorna apenas moedas cuja cotação mais recente é anterior à data de hoje e tem valor maior que zero — usada para oferecer somente moedas estrangeiras com cotação válida em telas de seleção.

Após o cadastro, o usuário pode alterar o nome, o símbolo, o tipo e a lista de cotações da moeda. O código não é indicado como editável (é a chave do cadastro).

Atenção: ao salvar uma edição, o sistema descarta silenciosamente qualquer cotação com data inválida ou sem valor preenchido, sem avisar o usuário — recomenda-se conferir a grade de cotações após salvar para garantir que todas as cotações desejadas foram realmente gravadas.

Não há histórico de alterações visível ao usuário identificado nesta análise.

Atenção: duas funcionalidades relacionadas à consulta automática de cotação junto ao Banco Central (obter o símbolo da moeda padrão e atualizar a cotação de uma moeda automaticamente via Bacen) não puderam ser confirmadas como operacionais na análise do código-fonte desta versão — [informação não disponível na análise de código — validar com analista/desenvolvedor].

Ao salvar a edição de uma moeda, o sistema ignora qualquer cotação cuja data esteja incorreta (ano menor ou igual a 1900) ou cujo valor não tenha sido preenchido. Essas cotações são simplesmente descartadas, sem mensagem de aviso ao usuário — vale conferir a grade de cotações após salvar.

Ao importar moedas do catálogo interno do sistema, 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 já cadastrada permanece inalterada, e o sistema não informa ao usuário quais moedas foram ignoradas nesse processo.

Quando uma rotina do sistema busca a cotação atual ou mais recente de uma moeda e não encontra nenhuma cotação cadastrada para a data necessária, o valor “1” é utilizado no lugar (equivalente a nenhuma conversão), em vez de a operação ser bloqueada. Isso evita interromper processos que dependem da cotação, mas pode mascarar o fato de que a moeda está sem cotação atualizada.

Ao pesquisar as cotações de uma moeda usando um texto que o sistema não consiga interpretar como data nem como valor numérico, a operação é bloqueada.

Duas funcionalidades relacionadas à integração automática com o Banco Central — obter o símbolo da moeda padrão do sistema e atualizar automaticamente a cotação de uma moeda a partir do Bacen — dependem de funcionalidades que não puderam ser confirmadas como presentes no código-fonte analisado nesta versão do sistema. [informação não disponível na análise de código — validar com analista/desenvolvedor se essas funcionalidades estão disponíveis na versão em uso antes de orientar o usuário a utilizá-las].

Ao excluir uma moeda, o sistema não verifica previamente se ela está sendo usada por outros cadastros, documentos ou lançamentos. Se houver dependências no banco de dados, a exclusão pode falhar por uma restrição técnica, sem uma mensagem de negócio explicando o motivo.