# Todas as variáveis do contrato, e o que cada uma imprime

> As 37 lacunas que o sistema preenche, agrupadas como no formulário, com o formato exato de cada uma.

## O que você vai conseguir

A lista completa, para consultar enquanto escreve. **Você não precisa digitar
nenhum desses códigos:** clicar na etiqueta do painel insere no ponto onde o
cursor está.

![Painel de variáveis disponíveis com os seis grupos e todas as etiquetas](/Apps/edupay/ajuda/contrato-variaveis.png)
*Os seis grupos do painel são exatamente os seis desta página. O que muda aqui é a coluna do formato — o que cada variável realmente imprime.*

## Aluno

| Variável | O que imprime |
|---|---|
| `%student_name%` | Nome completo |
| `%student_document%` | CPF ou documento, do jeito que está gravado |
| `%student_email%` | E-mail |
| `%student_phone%` | Telefone |
| `%student_birth_date%` | Data de nascimento, como 15/03/1995 |
| `%student_address%` | **Só logradouro e número** |
| `%student_neighborhood%` | Bairro |
| `%student_city%` | Cidade |
| `%student_state%` | Estado, com duas letras |
| `%student_zip%` | CEP |

**Cuidado com `%student_address%`:** ele traz apenas rua e número. Bairro, cidade
e estado têm variáveis próprias, e é você quem monta o endereço completo no
texto.

## Instituição

| Variável | O que imprime |
|---|---|
| `%institution_name%` | Razão social |
| `%institution_trade_name%` | Nome fantasia |
| `%institution_document%` | CNPJ ou CPF da escola |
| `%institution_mec_number%` | Código MEC |
| `%institution_phone%` | Telefone de contato |
| `%institution_email%` | E-mail de contato |
| `%institution_website%` | Site |
| `%institution_address%` | Endereço completo, já montado |
| `%institution_city%` | Cidade |
| `%institution_state%` | Estado |
| `%institution_zip%` | CEP |

Todos vêm de **Configurações › Geral**. Vazio ali, vazio no contrato.

**Repare na diferença:** o endereço da instituição já vem montado; o do aluno,
não.

## Matrícula

| Variável | O que imprime |
|---|---|
| `%enrollment_number%` | O número da matrícula |
| `%enrollment_date%` | Data da matrícula, como 19/02/2026 |
| `%course_name%` | Nome do curso ou da trilha |
| `%course_type%` | **O código interno do tipo**, não o nome |
| `%cohort_name%` | Nome da turma |
| `%start_date%` | Data de início da turma |

**`%course_type%` merece atenção.** Ele imprime a chave interna — `free_course`,
`postgrad`, `school` — e não *Curso Livre* ou *Pós-graduação*. Num contrato, isso
fica estranho. Escreva o tipo à mão ou não use essa variável.

**`%cohort_name%` e `%start_date%` ficam vazios** quando a matrícula não tem
turma escolhida. Se o seu texto depende delas, torne a turma obrigatória no seu
processo.

## Financeiro

| Variável | O que imprime |
|---|---|
| `%total_value%` | O valor total **com o símbolo da moeda** |
| `%enrollment_fee%` | A taxa **com o símbolo**, ou um traço se não houver |
| `%installments_count%` | O número de parcelas |
| `%installment_value%` | O valor de cada parcela **com o símbolo** |
| `%due_day%` | **A palavra "dia" mais o número** — "dia 10" |

**As três variáveis de dinheiro já trazem R$.** Nunca escreva `R$ %total_value%`
— sairia "R$ R$ 4.800,00".

**`%due_day%` já traz a palavra "dia".** Nunca escreva `dia %due_day%` — sairia
"dia dia 10". Este é o erro mais comum, e o artigo ao lado mostra onde ele está
escondido.

## Contrato

| Variável | O que imprime |
|---|---|
| `%signed_date%` | A data em que o contrato foi **gerado**, não assinada |
| `%contract_number%` | O mesmo número da matrícula |

**O nome de `%signed_date%` engana.** Ele grava a data em que o documento foi
criado, no momento da matrícula. Se o aluno assinar cinco dias depois, o texto
continua com a data antiga. Para o fecho do contrato, isso costuma ser aceitável;
para uma cláusula que dependa da data real da assinatura, não use essa variável.

## Assinatura da instituição

| Variável | O que imprime |
|---|---|
| `%institution_signature%` | A imagem da assinatura, se houver |
| `%institution_signer_name%` | Nome de quem assina pela escola |
| `%institution_signer_role%` | Cargo de quem assina |

Os três vêm de **Configurações › Contratos**, e o artigo sobre a assinatura da
instituição explica como preencher.

## Como saber que deu certo

> [certo]
> Abra o **Preview** depois de escrever. Toda variável reconhecida aparece
> destacada em amarelo, com um valor de exemplo. O que sobrar em vermelho é
> variável sem valor — normalmente um código digitado errado.

## Se algo der errado

> [erro]
> **A variável apareceu escrita no contrato, com os sinais de porcentagem.** O
> código está errado. Confira letra por letra, ou apague e insira de novo pelo
> painel.
>
> **Uma variável saiu vazia.** O dado não existe no cadastro. `%student_zip%`
> fica em branco se o aluno não tem CEP; `%institution_mec_number%`, se as
> Configurações não têm o código.
>
> **Você quer uma variável que não está na lista.** Não dá para criar novas. O
> que não está aqui precisa ser escrito à mão no texto do modelo.


---

https://edupay.estudiosite.com/pt/ajuda/comecar/variaveis-do-contrato
2026-08-05