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

Para quem:
Quem administra a escola
Tempo:
6 min

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 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

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

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.

Revisado em · ver em texto puro