> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como usar um campo personalizado como variável nos modelos e mensagens

Quando você precisa de uma informação que não existe entre as variáveis prontas do Groner, por exemplo o número da nota fiscal ou o número do contrato de outro sistema, crie um **campo personalizado** no negócio. Cada campo personalizado gera uma variável que você pode usar nos modelos de documento, nas propostas e nas mensagens de WhatsApp.

---

## Passo a passo: criar o campo

1. Acesse **Configurações > Sistema & Desenvolvedor > Campos personalizados**.
2. Crie o campo no **negócio**, com um título simples, **sem acento**, por exemplo **Numero NF**.
3. Preencha o campo nos negócios.

## Como fica o nome da variável

A variável é montada a partir do **Código** do campo, que nasce do título na criação, sem espaços, sem acentos e sem caracteres especiais:

- Em documentos e propostas: `[[Campo` + título + `Projeto]]`. Para o campo "Numero NF", fica `[[CampoNumeroNFProjeto]]`.
- Em mensagens de WhatsApp: `[[CampoNumeroNFWhatsAppProjeto]]`.

> **Atenção:** letras com acento são removidas do nome da variável. O título "Número da NF", por exemplo, gera `[[CampoNmerodaNFProjeto]]`. Por isso, prefira títulos sem acento.

## Onde ver o nome certo

Na edição do campo, o quadro **Variável para modelos e fórmulas** mostra a variável e copia com um clique. No editor de modelos, abra o painel **Variáveis**, busque o campo e use **Copiar variável**. Se o campo acabou de ser criado e não aparece, clique em **Recarregar variáveis**.

## Cuidados

- **Não altere o Código do campo depois de usar a variável.** Mudar só o título não muda a variável, mas mudar o **Código** na edição do campo muda, e os modelos que usavam o nome antigo deixam de preencher.
- A variável funciona para campos do **negócio**. Campos personalizados não geram variável própria para o contato.
- Se o campo estiver vazio no negócio, a variável aparece como "-" no documento.

<!-- groner-suporte:veja-tambem:inicio -->

## Veja também

- [O que são Campos Personalizados?](https://ajuda.groner.app/pt-br/article/o-que-sao-campos-personalizados-x9sz2l/)
- [Como Configurar Campos Personalizados](https://ajuda.groner.app/pt-br/article/como-configurar-campos-personalizados-1ehny3x/)
- [O que são Variáveis](https://ajuda.groner.app/pt-br/article/o-que-sao-variaveis-19g45cs/)
- [Onde usar as Variáveis](https://ajuda.groner.app/pt-br/article/onde-usar-as-variaveis-p8cars/)

<!-- groner-suporte:veja-tambem:fim -->