Como podemos ajudar?

Configuração de Moeda

A tela de Moeda (menu Admin > Moeda) define, para o sistema, qual é a unidade monetária usada nos lançamentos financeiros, contratos, boletos, relatórios e telas de cobrança. É aqui que fica registrado, por exemplo, que o provedor trabalha em Real (R$), em Guarani (₲) ou em qualquer outra moeda, além de detalhes como o símbolo exibido nas telas, se a moeda usa centavos e qual é a menor fração aceita em uma cobrança.

Essa configuração precisa ser revisada antes de qualquer lançamento financeiro real (geração de mensalidade, débito avulso, boleto, venda, etc.), porque o sistema grava a moeda usada em cada contrato e em cada movimentação financeira no momento em que elas são criadas. Uma vez que o cliente é cadastrado, contratos são gerados e mensalidades começam a ser cobradas usando a moeda vigente naquele momento, essa referência fica presa aos registros. O próprio sistema trata a moeda padrão como algo praticamente definitivo: o campo "Moeda padrão" da tela de Configurações do sistema é bloqueado para edição justamente para evitar inconsistência entre as moedas já usadas e as carteiras de cobrança já criadas. Ou seja: configurar a moeda errada e só perceber depois, com o sistema já em uso, não é um ajuste simples de campo — é um problema que normalmente exige suporte técnico para ser corrigido.

1. Passo a passo para cadastrar/configurar uma moeda

1. Acesse o menu Admin > Moeda.
2. Clique em Adicionar (ou abra um registro existente para editar).
3. Preencha os campos da aba Moeda:
   • Sigla: o símbolo que vai aparecer nas telas e documentos (ex.: R$, ₲, US$). Limite de 8 caracteres.
   • Código: o código ISO 4217 da moeda, com 3 letras (ex.: BRL para Real, PYG para Guarani, ARS para Peso argentino). Usado para integrações e documentos fiscais.
   • Descrição: o nome completo da moeda (ex.: "Real brasileiro"). É o texto que aparece nos combos de seleção em outras telas.
   • Usar centavos: define se os valores devem ser exibidos e impressos com casas decimais (centavos) ou apenas como número inteiro. Moedas como o Guarani paraguaio, por exemplo, normalmente não usam centavos na prática.
   • Situação: se a moeda está ativa ou não. Uma moeda desativada deixa de aparecer para seleção em novos contratos/lançamentos.
   • Moeda no singular / Moeda no plural: o nome por extenso da unidade monetária, no singular e no plural (ex.: "real" / "reais"), usado na extenso de valores em documentos como boletos.
   • Centavo no singular / Centavo no plural: o nome da subunidade (ex.: "centavo" / "centavos"). Esses dois campos só são obrigatórios e ficam editáveis quando "Usar centavos" está marcado como Sim — se estiver como Não, o sistema limpa e bloqueia esses campos automaticamente.
   • Valor de conversão: a taxa de conversão desta moeda em relação à moeda padrão do sistema (ver explicação detalhada abaixo). Esse campo fica oculto quando você está editando a própria moeda padrão, pois nesse caso a taxa é sempre 1.
   • Múltiplo de arredondamento: define a menor fração prática aceita em uma cobrança nessa moeda. Exemplos: 1000 para Guarani (cobranças fecham em múltiplos de mil) ou 0.05 para o Franco Suíço. O valor 0 significa "sem arredondamento".
4. Clique em Salvar.

Se essa for a primeira moeda cadastrada (ou a única em uso), ela deve ser marcada como moeda padrão do sistema. Isso é feito na tela Admin > Configurações, no campo Moeda padrão — que, por segurança, fica bloqueado para edição depois de definido pela primeira vez. Se for necessário trocar a moeda padrão depois que o sistema já está em produção, é preciso acionar o suporte da Quaza, pois essa troca afeta diretamente os valores já registrados em contratos e carteiras.

2. O que é o "Valor de conversão" e como ele afeta os cálculos

O Valor de conversão só existe (e só é visível) para moedas que não são a moeda padrão. Ele representa quantas unidades da moeda padrão equivalem a 1 unidade dessa moeda secundária. Na tela, o próprio sistema deixa isso explícito trocando o rótulo do campo para "Equivale a" e mostrando ao lado a sigla da moeda padrão, para deixar claro o sentido da conversão.

Esse valor é usado pelo sistema sempre que é preciso:

• Converter um valor lançado em uma moeda secundária para a moeda padrão (por exemplo, para somar totais em relatórios financeiros e no fluxo de caixa, que sempre consolidam tudo na moeda padrão).
• Converter um valor da moeda padrão para uma moeda secundária.
• Converter entre duas moedas secundárias diferentes — nesse caso o sistema faz o cálculo em duas etapas, usando a moeda padrão como referência intermediária (moeda A → moeda padrão → moeda B).

Por isso, se o valor de conversão estiver errado, todo relatório, totalizador ou tela que precise somar ou comparar valores entre moedas vai apresentar números incorretos — mesmo que o valor individual lançado em cada contrato esteja certo na moeda original dele. O sistema, inclusive, bloqueia operações quando detecta uma taxa zerada: se a moeda de destino da conversão tiver "Valor de conversão" igual a zero, a operação é interrompida com o aviso "Moeda [nome] possui taxa de conversão zero. Configure a taxa antes de realizar operações." — e o próprio cadastro da moeda já impede salvar uma moeda secundária sem uma taxa maior que zero.

3. Provedores que operam com uma única moeda

Mesmo que o provedor só trabalhe com Real (ou apenas uma moeda, seja qual for), esse cadastro é obrigatório — o sistema não funciona sem pelo menos uma moeda cadastrada e marcada como padrão. A diferença é que, nesse cenário, o dia a dia fica mais simples: como só existe uma moeda ativa, o sistema identifica automaticamente que "não há múltiplas moedas" e esconde da tela de contratos, planos de venda e configurações o campo de seleção de moeda — o operador nem vê essa opção no dia a dia, e todo valor lançado é automaticamente considerado na moeda padrão, sem necessidade de conversão. Ou seja, para quem usa uma moeda só, o cadastro é feito uma única vez, na implantação, e depois disso a tela de Moeda praticamente não precisa ser tocada de novo.

4. Erros comuns

Problema	O que acontece	Como resolver
Não definir/errar a moeda padrão logo na implantação	Contratos, grupos de rede e lançamentos financeiros já criados passam a referenciar essa moeda. Depois de haver movimento no sistema, o campo "Moeda padrão" fica travado na tela de Configurações justamente para evitar corromper dados.	Definir a moeda padrão correta antes de cadastrar clientes/contratos. Se o sistema já estiver em uso com a moeda errada, é necessário acionar o suporte da Quaza — não é um ajuste que deve ser feito sozinho.
Cadastrar uma moeda secundária com "Valor de conversão" zerado ou em branco	O cadastro nem salva: o sistema recusa com a mensagem "A taxa de conversão deve ser maior que zero para moedas não-padrão". Se, ainda assim, alguma operação tentar converter usando essa moeda como destino, ela é bloqueada com erro de "taxa de conversão zero".	Preencher o "Valor de conversão" (campo "Equivale a") com a taxa correta em relação à moeda padrão antes de salvar ou de usar essa moeda em qualquer contrato.
Marcar "Usar centavos" incompatível com a realidade da moeda	Se marcado como "Sim" mas os campos "Centavo no singular/plural" ficarem vazios, o sistema impede salvar (são obrigatórios nesse caso). Se marcado errado, os valores exibidos e impressos em boletos/documentos saem com casas decimais indevidas.	Confirmar como a moeda é praticada no dia a dia (usa ou não fração/centavo) e preencher os nomes de singular/plural do centavo sempre que "Usar centavos" estiver ativo.
Desativar (situação = não) a moeda padrão	O sistema não permite: a validação da tela bloqueia com a mensagem "Não é possível desativar a moeda padrão".	Se for necessário aposentar essa moeda, primeiro é preciso trocar a moeda padrão (via suporte) para outra e só então desativar a antiga.
Deixar o "Múltiplo de arredondamento" incoerente com a moeda	Cobranças podem fechar em valores "quebrados" que não fazem sentido prático para aquela moeda (ex.: centavos de Guarani, que na prática não circulam).	Ajustar o múltiplo conforme o costume da moeda — por exemplo, 1000 para Guarani ou 0,05 para Franco Suíço — ou deixar 0 quando não houver necessidade de arredondar.

5. Onde essa configuração aparece depois

A moeda cadastrada aqui não fica isolada na tela de Admin — ela se propaga para praticamente todo o módulo financeiro e comercial do sistema:

• Admin > Configurações: define a Moeda padrão do sistema e a Direção do arredondamento (para cima, para baixo ou para o mais próximo), que juntamente com o "Múltiplo de arredondamento" de cada moeda decide como valores são fechados. Esses campos só aparecem na tela quando existe mais de uma moeda ativa no sistema.
• Grupos de rede (Admin > Grupos): cada grupo pode ter sua própria moeda; se nenhuma for informada, o grupo herda automaticamente a moeda padrão do sistema.
• Contratos de cliente: cada contrato guarda a moeda em que foi criado (campo "Moeda", só exibido quando há mais de uma moeda cadastrada). Planos de venda, valores mensais e o cálculo de descontos de fidelidade usam essa moeda como referência, convertendo para a moeda padrão quando necessário para totalizar.
• Financeiro: movimentações de carteira, pagamentos, débitos e a tela de Fluxo de Caixa somam e exibem saldos considerando a moeda de cada lançamento, convertendo tudo para a moeda padrão nos totalizadores gerais.
• Relatórios financeiros (ex.: relatório de contas): quando há mais de uma moeda em uso, o relatório abre uma coluna por moeda encontrada nos lançamentos, além dos totais consolidados na moeda padrão.
• Boletos e documentos impressos (ex.: recibos): usam a sigla, o nome por extenso (singular/plural) e a configuração de centavos da moeda do contrato/débito para formatar o valor corretamente.

Por isso, revisar a configuração de moeda com atenção logo na implantação evita retrabalho e inconsistências que, depois que o sistema está em produção com contratos e cobranças ativas, só podem ser corrigidas com o apoio do suporte técnico da Quaza.