Variáveis e formatos do contrato
Variável é um marcador entre chaves duplas que o sistema troca pelo dado do registro na hora de gerar o contrato. {{pessoa.nome}} vira o nome do cliente; {{empresa.razao_social}}, a razão social da sua empresa.
O jeito mais fácil de usar é pela aba Dados automáticos do modelo: clique na variável e ela entra no texto. Esta página serve de consulta.
Quais grupos o modelo pode usar
Seção intitulada “Quais grupos o modelo pode usar”Depende do que foi escolhido em Gerado a partir de no modelo:
| Gerado a partir de | Grupos disponíveis |
|---|---|
| Pessoa | pessoa, empresa, documento, original |
| Pedido | pedido, pessoa (o cliente do pedido), empresa, documento, original |
| Orçamento | orcamento, pessoa (o cliente do orçamento), empresa, documento, original |
| Ordem de serviço | os, pessoa (o cliente da OS), empresa, documento, original |
| Contrato recorrente | contrato, pessoa (o cliente do contrato), empresa, documento, original |
Usar uma variável de outro grupo, como {{pedido.valor_total}} num modelo gerado a partir de Pessoa, vira a pendência Variável que não existe.
Pessoa (pessoa)
Seção intitulada “Pessoa (pessoa)”Os dados do cadastro da pessoa. Quando o contrato sai de um pedido, orçamento, OS ou contrato recorrente, é o cliente desse registro.
| Variável | Dado |
|---|---|
{{pessoa.nome}} | Nome ou razão social |
{{pessoa.nome_fantasia}} | Nome fantasia ou apelido |
{{pessoa.documento}} | CPF ou CNPJ |
{{pessoa.tipo_documento}} | A palavra CPF ou CNPJ, conforme o documento |
{{pessoa.rg_ie}} | RG ou inscrição estadual |
{{pessoa.nascimento}} | Data de nascimento |
{{pessoa.pai}} | Nome do pai |
{{pessoa.mae}} | Nome da mãe |
{{pessoa.codigo}} | Código do cadastro |
{{pessoa.email}} | E-mail (o primeiro contato com e-mail) |
{{pessoa.telefone}} | Telefone (o primeiro contato com telefone) |
{{pessoa.endereco}} | Endereço completo numa linha: “Rua A, 10, Centro, Natal/RN, CEP 59000-000” |
{{pessoa.logradouro}} | Rua |
{{pessoa.numero}} | Número |
{{pessoa.bairro}} | Bairro |
{{pessoa.cidade}} | Cidade |
{{pessoa.uf}} | UF |
{{pessoa.cep}} | CEP |
{{pessoa.observacao}} | Observação do cadastro |
Os dados de endereço vêm do primeiro endereço do cadastro.
Quando o cliente do pedido, orçamento, OS ou contrato recorrente não está no cadastro de pessoas (cliente só daquele documento), as variáveis usam os dados do cliente gravados no próprio documento: nome, nome fantasia, CPF ou CNPJ, inscrição estadual, e-mail, telefone e endereço. As que só existem no cadastro (nascimento, pai, mãe, código, observação e campos personalizados) ficam sem valor. No contrato gerado, esse cliente entra como parte contratante do mesmo jeito.
Empresa (empresa)
Seção intitulada “Empresa (empresa)”Os dados da sua empresa, de Sistema > Configuração.
| Variável | Dado |
|---|---|
{{empresa.razao_social}} | Razão social |
{{empresa.nome_fantasia}} | Nome fantasia |
{{empresa.cnpj}} | CNPJ ou CPF |
{{empresa.ie}} | Inscrição estadual |
{{empresa.endereco}} | Endereço completo numa linha |
{{empresa.logradouro}} | Rua |
{{empresa.numero}} | Número |
{{empresa.bairro}} | Bairro |
{{empresa.cidade}} | Cidade |
{{empresa.uf}} | UF |
{{empresa.cep}} | CEP |
{{empresa.telefone}} | Telefone |
{{empresa.email}} |
Pedido, orçamento, ordem de serviço e contrato recorrente
Seção intitulada “Pedido, orçamento, ordem de serviço e contrato recorrente”As quatro fontes têm as mesmas variáveis, cada uma com o próprio prefixo: pedido, orcamento, os e contrato. Abaixo, com o prefixo do pedido:
| Variável | Dado |
|---|---|
{{pedido.numero}} | Número |
{{pedido.data}} | Data |
{{pedido.cliente}} | Nome do cliente como está no pedido |
{{pedido.cliente_documento}} | CPF ou CNPJ do cliente |
{{pedido.vendedor}} | Vendedor |
{{pedido.itens}} | Produtos e serviços numa linha: “2 x Licença (R$ 200,00); 1 x Implantação (R$ 300,00)“ |
{{pedido.produtos}} | Só os produtos, no mesmo formato |
{{pedido.servicos}} | Só os serviços, no mesmo formato |
{{pedido.valor_subtotal}} | Subtotal |
{{pedido.desconto}} | Desconto |
{{pedido.acrescimo}} | Acréscimo |
{{pedido.valor_total}} | Valor total |
{{pedido.previsao_entrega}} | Previsão de entrega |
{{pedido.garantia_dias}} | Dias de garantia |
{{pedido.formas_pagamento}} | Formas de pagamento do documento, sem repetir: “Pix, Boleto” |
{{pedido.observacao}} | Observação |
Para o orçamento, troque pedido por orcamento (por exemplo, {{orcamento.valor_total}}); para a ordem de serviço, por os; para o contrato recorrente, por contrato.
Só no orçamento:
| Variável | Dado |
|---|---|
{{orcamento.validade}} | Validade da proposta |
Só no contrato recorrente:
| Variável | Dado |
|---|---|
{{contrato.recorrencia}} | Recorrência: Mensal, Anual, “A cada 3 meses” |
{{contrato.recorrencia_intervalo}} | A cada quantos períodos a cobrança se repete: 1, 3, 12 |
{{contrato.inicio}} | Início do contrato |
{{contrato.vencimento}} | Próximo vencimento |
{{contrato.dia_vencimento}} | Dia do vencimento |
{{contrato.tipo}} | Pré-pago ou Pós-pago |
{{contrato.valor_ciclo}} | Valor por ciclo |
{{contrato.juros_mes}} | Juros ao mês (%) |
{{contrato.multa}} | Multa (%) |
{{contrato.dias_carencia}} | Dias de carência |
{{contrato.reajuste}} | Plano de reajuste |
Este contrato (documento)
Seção intitulada “Este contrato (documento)”Os dados do próprio contrato gerado, preenchidos no contrato e não no cadastro.
| Variável | Dado |
|---|---|
{{documento.numero}} | Número do contrato |
{{documento.titulo}} | Título do contrato |
{{documento.valor}} | Valor informado no contrato |
{{documento.inicio}} | Início da vigência |
{{documento.fim}} | Fim da vigência |
{{documento.emissao}} | Data de emissão (o dia em que o contrato foi gerado) |
Contrato original (original)
Seção intitulada “Contrato original (original)”Só no aditivo e no distrato: os dados do contrato que eles alteram ou encerram.
| Variável | Dado |
|---|---|
{{original.numero}} | Número do contrato original |
{{original.titulo}} | Título do contrato original |
{{original.inicio}} | Início da vigência do original |
{{original.fim}} | Fim da vigência do original |
{{original.assinatura}} | Data da assinatura do original |
Campos personalizados
Seção intitulada “Campos personalizados”Os campos personalizados ativos da pessoa, do pedido, do orçamento, da ordem de serviço e do contrato recorrente também viram variáveis, com campos. antes do nome do campo:
{{pessoa.campos.data_posse}}{{os.campos.placa}}
Campo de número aceita os formatos de número; campo de data, os de data. Campo sim ou não sai como “Sim” ou “Não”, e o de várias opções sai com as opções separadas por vírgula.
Formatos
Seção intitulada “Formatos”O formato vem depois da barra, dentro das chaves: {{documento.valor|extenso}}.
| Formato | Serve para | Exemplo |
|---|---|---|
moeda | Número | R$ 1.234,50 |
extenso | Número | mil duzentos e trinta e quatro reais e cinquenta centavos |
data | Data | 10/10/2026 |
data_extenso | Data | 10 de outubro de 2026 |
cpf_cnpj | CPF ou CNPJ | 123.456.789-09 |
Sem formato, cada dado sai no padrão dele: valor em reais (R$ 1.234,50), data como 10/10/2026 e CPF ou CNPJ com pontos e traço.
Para escrever o valor com o extenso entre parênteses, use as duas formas juntas:
{{documento.valor|moeda}} ({{documento.valor|extenso}})
sai como “R$ 1.234,50 (mil duzentos e trinta e quatro reais e cinquenta centavos)”.
Formato que não existe ou que não combina com o dado (como extenso num nome) vira a pendência Formato errado.
Remissões
Seção intitulada “Remissões”As remissões citam outro bloco do próprio texto e não são dados do cadastro:
| Marcador | Sai como |
|---|---|
{{ref:id}} | ”Cláusula 3”, “item 3.2”, “alínea b do item 1.2”, “Anexo I” |
{{num:id}} | Só o número: “3” ou “3.2” |
Veja Citar outra cláusula.