Pular para o conteúdo
Acessar sistema

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.

Depende do que foi escolhido em Gerado a partir de no modelo:

Gerado a partir deGrupos disponíveis
Pessoapessoa, empresa, documento, original
Pedidopedido, pessoa (o cliente do pedido), empresa, documento, original
Orçamentoorcamento, pessoa (o cliente do orçamento), empresa, documento, original
Ordem de serviçoos, pessoa (o cliente da OS), empresa, documento, original
Contrato recorrentecontrato, 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.

Os dados do cadastro da pessoa. Quando o contrato sai de um pedido, orçamento, OS ou contrato recorrente, é o cliente desse registro.

VariávelDado
{{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.

Os dados da sua empresa, de Sistema > Configuração.

VariávelDado
{{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}}E-mail

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ávelDado
{{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ávelDado
{{orcamento.validade}}Validade da proposta

Só no contrato recorrente:

VariávelDado
{{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

Os dados do próprio contrato gerado, preenchidos no contrato e não no cadastro.

VariávelDado
{{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)

Só no aditivo e no distrato: os dados do contrato que eles alteram ou encerram.

VariávelDado
{{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

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.

O formato vem depois da barra, dentro das chaves: {{documento.valor|extenso}}.

FormatoServe paraExemplo
moedaNúmeroR$ 1.234,50
extensoNúmeromil duzentos e trinta e quatro reais e cinquenta centavos
dataData10/10/2026
data_extensoData10 de outubro de 2026
cpf_cnpjCPF ou CNPJ123.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.

As remissões citam outro bloco do próprio texto e não são dados do cadastro:

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