Variáveis do Sistema
As Variáveis são atalhos de texto que você usa dentro de templates e documentos. Em vez de digitar sempre o mesmo conteúdo (como o nome do leiloeiro ou um endereço), você cria uma variável e a referencia pelo nome — quando o documento é gerado, o sistema substitui pelo valor cadastrado.
Como acessar
Configurações · Cadastro Básico → Variáveis.
O que você vê nesta tela
No topo, um aviso lembra a sintaxe de uso: dentro de templates, escreva o nome da variável entre chaves duplas, no formato {{chave}}. Ainda no aviso, há a opção Mostrar internas, que exibe também as variáveis fornecidas pelo próprio sistema.
A tabela traz:
| Coluna | O que é |
|---|---|
| # | Número interno da variável (variáveis do sistema vêm marcadas com "sys") |
| Nome | A chave da variável, exibida pronta para uso no formato {{nome}}, com um botão para copiar |
| Valor | O texto que a variável resulta quando usada |
| Descrição | Explicação de para que serve |
| Status | Ativa, Inativa ou Sistema (no caso das internas) |
O filtro de busca (por nome ou valor) e o filtro de Status (Todas / Apenas ativas / Apenas inativas) ficam acima da tabela.
O que dá pra fazer aqui
Cadastrar uma nova variável
- Clique em Nova variável.
- Preencha o Nome da variável — use letras, sem espaços nem acentos (ex.:
LEILOEIRO.NOME). Esse é o identificador que você vai referenciar no template. - Preencha o Valor (o que a variável vai resultar, ex.: o nome real do leiloeiro). É obrigatório.
- (Opcional) Escreva uma Descrição.
- Defina o Status (Ativa/Inativa).
- Clique em Cadastrar.
Editar uma variável
Dê um duplo clique na linha ou clique no botão Editar (lápis). Ajuste os campos e clique em Atualizar. No modal de edição há também o botão Excluir.
Copiar a variável para usar em um template
Clique no botão de copiar ao lado do nome (na coluna Nome). O sistema copia o texto pronto no formato {{nome}} para você colar no template ou documento.
Excluir uma variável
Clique no botão Excluir (lixeira) na linha e confirme. A exclusão é permanente (não há lixeira de recuperação). Atenção: templates que usam essa variável deixarão de substituir o {{nome}} correspondente.
Erros comuns e impactos
- Usar a variável com nome errado no template: se o
{{nome}}digitado no documento não bater exatamente com o nome cadastrado (maiúsculas/minúsculas incluídas), o texto fica sem substituição. Use o botão de copiar para evitar erros de digitação. - Excluir uma variável ainda em uso: os templates não dão erro, mas o trecho
{{nome}}passa a aparecer literalmente (ou vazio) no documento gerado. - Variável inativa: uma variável com status Inativa continua cadastrada, mas não é aplicada nos templates. Use isso para desativar temporariamente sem perder o cadastro.
Dicas e observações
- As variáveis marcadas como Sistema (internas) são somente leitura: não podem ser editadas nem excluídas. Elas só aparecem quando você liga a opção Mostrar internas.
- Use nomes claros e padronizados (por exemplo, prefixos como
LEILOEIRO.,EMPRESA.) para facilitar o uso nos templates. - Antes de excluir uma variável, verifique se ela não está sendo usada em documentos importantes.