Pular para o conteúdo

Criar modelos de documento com variáveis

Prepare procurações, contratos e declarações no Word com variáveis, envie o arquivo ao Orvya e mantenha os modelos do escritório organizados.

Intermediário5 min de leituraAtualizado em 13 de novembro de 2026

Um modelo de documento é um arquivo do Word (.docx) com variáveis no lugar dos dados que mudam a cada caso, como ${Nome_pessoa} ou ${Numero_processo}. Ao gerar um documento, o Orvya troca cada variável pelos dados do cadastro e entrega o arquivo pronto, com a formatação, as tabelas e os cabeçalhos do original. Com bons modelos, procurações, contratos e declarações saem em segundos e sem erros de digitação. Escritórios novos começam sem modelos.

Onde fica

  • No menu lateral, Configurações › aba Modelos de documento.
  • No menu lateral, Documentos › botão Modelos de documentos.

Os dois caminhos levam à mesma página, com o título Modelos de documento.

Página Modelos de documento com a lista de modelos do escritório
Página Modelos de documento com a lista de modelos do escritório

Preparar o arquivo no Word

  1. Abra no Word o documento que servirá de base, por exemplo a procuração que o escritório já usa.
  2. Troque cada dado que muda pela variável correspondente, escrita no formato ${Nome_da_variavel}. As variáveis estão em Lista de variáveis dos modelos e na própria janela do modelo.
  3. Para um dado que não está na lista, como o valor combinado com o cliente, crie uma variável própria com o nome que quiser, por exemplo ${Valor_acordado}. O Orvya vai pedir o texto dela a cada documento gerado.
  4. Salve o arquivo no formato .docx, com até 10 MB.

Regras para o arquivo:

  • Escreva cada variável inteira, com o cifrão, as chaves, os acentos e as maiúsculas exatamente como na lista: ${Nome_escritório} tem acento, ${Nome_pessoa} não tem.
  • As variáveis podem ficar no corpo do texto, em tabelas, no cabeçalho e no rodapé. Mesmo que o Word divida a variável em partes com formatação diferente, como um trecho em negrito, ela continua sendo reconhecida.
  • O arquivo não pode ter macros, objetos incorporados (como uma planilha do Excel inserida no texto) nem vínculos externos.
  • Cada modelo pode ter até 30 variáveis próprias. O nome de uma variável própria tem até 60 caracteres e não pode ter chaves.

Adicionar o modelo

  1. Clique em Adicionar modelo. Abre a janela Adicionar modelo de documento.
  2. Em Arquivo Word (.docx), arraste o arquivo ou clique em Enviar documento. O Orvya confere o arquivo e as variáveis ("Conferindo o arquivo e suas variáveis…").
  3. Confira o Título do modelo, que vem do nome do arquivo. É o nome do modelo na lista e na escolha do modelo ao gerar documentos. Até 200 caracteres.
  4. Ajuste o Nome do arquivo gerado. Ele pode ter variáveis, como em "Procuração - ${Nome_pessoa}", e vira o título sugerido de cada documento gerado.
  5. Se o arquivo tiver variáveis próprias, a seção Variáveis próprias lista cada uma. Dê um título a cada variável, como "Valor combinado": é o rótulo do campo que será preenchido ao gerar o documento.
  6. Clique em Salvar. O aviso "Modelo salvo." aparece e o modelo entra na lista.
Janela Adicionar modelo de documento com o arquivo Word, o nome do arquivo gerado e as variáveis próprias
Janela Adicionar modelo de documento com o arquivo Word, o nome do arquivo gerado e as variáveis próprias

O cartão Variáveis disponíveis, à direita da janela, lista as variáveis por grupo. Clique numa delas para copiar ("Variável copiada.") e cole no Word ou no campo Nome do arquivo gerado.

Nome do arquivo gerado

  • Aceita as variáveis da lista, menos o logotipo e as variáveis próprias.
  • Uma variável sem valor some do nome, junto com o separador que sobrar: "Procuração - ${Nome_pessoa}", gerado sem pessoa, vira "Procuração".
  • Até 500 caracteres.

Gerenciar os modelos

A lista mostra o Título, o Autor (quem cadastrou o modelo) e a Data da última alteração. No menu Mais ações (três pontos) de cada linha:

  • Editar: abre o modelo para mudar o título, o nome do arquivo gerado, os títulos das variáveis próprias ou o arquivo Word. Para trocar o arquivo, escolha o novo .docx; o atual pode ser baixado pelo link Baixar, seguido do nome do arquivo.
  • Baixar modelo: baixa o arquivo .docx do modelo.
  • Duplicar: cria uma cópia com "(cópia)" no fim do título ("Modelo duplicado.").
  • Mover para cima e Mover para baixo: mudam a ordem da lista, que é também a ordem do campo Modelo ao gerar documentos.
  • Excluir: na confirmação, que avisa "Documentos já gerados não serão afetados.", clique em Excluir.

Para vários modelos, marque as linhas e use Ações › Baixar modelos, Duplicar modelos ou Excluir modelos.

Modelos antigos, feitos no editor de texto

Escritórios que já usavam o Orvya podem ter modelos criados no editor de texto do próprio Orvya, sem arquivo Word. Ao editar um deles, abre o editor com Título, Conteúdo e o cartão Variáveis, em que um clique insere a variável no ponto do cursor. Esses modelos usam variáveis entre chaves duplas, como {{cliente.nome}}. Modelos novos são sempre adicionados a partir de um arquivo Word.

Se algo der errado

"Selecione um arquivo .docx de até 10 MB."

O arquivo não está no formato .docx (por exemplo, é um .doc antigo ou um PDF) ou passa de 10 MB. No Word, salve o arquivo no formato .docx.

"Não foi possível ler este arquivo .docx."

embaixo do arquivo, logo depois de escolhê-lo. O arquivo está corrompido ou protegido, ou tem macros, objetos incorporados ou vínculos externos. Salve uma cópia limpa no Word e escolha o arquivo de novo.

"Variáveis não reconhecidas: ${Nome_pessoa"

(as variáveis variam). Há uma variável incompleta ou mal escrita, como ${Nome_pessoa sem a chave final. Corrija no Word e escolha o arquivo de novo.

"O modelo tem mais de 30 variáveis próprias"

. Junte ou retire variáveis próprias do arquivo até ficarem no máximo 30.

"Dê um título à variável"

ou "Dê um título a cada variável própria do arquivo". Uma variável própria está sem título. Preencha o campo dela em Variáveis próprias.

"A variável ${Nome_cliente} não existe."

(o nome varia) no Nome do arquivo gerado. Esse campo só aceita as variáveis da lista. Corrija a grafia ou tire a variável. Para o logotipo, a mensagem é "O logotipo não pode ir no nome do arquivo."

"O modelo foi alterado por outra pessoa. Recarregue e tente novamente."

Outro administrador salvou o mesmo modelo enquanto você editava. Feche a janela, recarregue a página e refaça a alteração.

O botão Adicionar modelo não aparece.

Seu usuário não é administrador do escritório. Peça a um administrador para cadastrar o modelo.

Continue em Documentos

Ainda com dúvida?

Conte o que aconteceu e, se puder, o endereço da tela. A equipe responde por suporte@orvya.net.