Templates de documentos
Para que serve
Um template é o modelo de um documento (uma proposta, um pedido de compra, um recibo). Você monta o layout uma vez, com textos fixos e variáveis (nome do cliente, itens, valores), e o Tesselys gera o PDF preenchido com os dados do registro sempre que alguém pedir.
Onde fica
Ferramentas › Template de Documento. A seção Ferramentas mostra só 5 itens: se não aparecer, procure em Ferramentas › Ver todos.
A lista tem abas por tipo e mostra nome, status (Padrão ou Customizado), descrição e data de atualização.
Antes de começar
- O plano da empresa precisa incluir Templates de Documento, e o seu perfil precisa de permissão na tela Template de Documento.
- Só aparecem os tipos dos módulos que a sua empresa tem: sem Compras não há Pedido de Compra; sem RH não há Rescisão nem Extrato de Pagamento; sem Contrato Recorrente não há Contrato nem Assinatura. O tipo Personalizado aparece sempre.
- Se quiser usar campos próprios da empresa no documento, crie-os antes em Campos customizados.
Tipos de template
| Tipo | Para que serve |
|---|---|
| Proposta | Propostas comerciais com itens e valores |
| Ordem de Serviço | Ordens de serviço e manutenção |
| Pedido de Compra | Pedidos de compra com fornecedores |
| Financeiro | Lançamentos financeiros e cobranças (gera o recibo) |
| Medição | Medições de obras e serviços |
| Cotação | Cotações e orçamentos |
| Contrato | Contratos com datas e valores |
| Assinatura | Documentos para assinatura digital |
| Rescisão | Rescisões e verbas rescisórias (TRCT, aviso prévio) |
| Extrato de Pagamento | Holerite do colaborador em uma folha de pagamento |
| Personalizado | Documento livre, só com os dados da empresa |
| Formulário | Modelos de formulário para coletar respostas (pesquisas, briefings, cadastros) |
Passo a passo
Criar um template
- Clique em Novo.
- Tipo de Entidade: escolha o tipo de documento.
- Método: escolha como começar:
- A partir de modelo do sistema: parte de um template pronto do Tesselys.
- A partir de modelo da empresa: duplica um template que a empresa já tem.
- Importar do Word: envie um arquivo
.docxe o conteúdo é convertido automaticamente. - Começar do zero: editor vazio.
- Modelo: quando aplicável, escolha o modelo de partida. O editor abre em seguida.
- Ajuste o conteúdo, troque os trechos fixos por variáveis, confira no Preview e salve.
Gerar um documento a partir de um registro
Nas telas que geram documento, a ação fica no menu do registro: por exemplo Gerar Proposta no Negócio e na Cotação, e também no Pedido de Compra, no Lançamento Financeiro (recibo), na Ordem de Serviço, na Rescisão, no extrato de pagamento da folha e nos documentos de contrato.
- Clique na ação de gerar documento do registro.
- Escolha o Template (o padrão vem marcado com o selo Padrão). Use Preview para conferir.
- Clique em Gerar. O PDF é montado com os dados atuais do registro.
- Depois de gerado, você pode Baixar, Enviar por e-mail ao cliente ou Gerar outro.
Se não houver template para aquele tipo, a tela avisa e oferece Criar template.
Editor
O editor mostra o documento em páginas, como vai sair no PDF. A barra de ferramentas tem negrito, itálico, sublinhado, tachado, títulos (1 a 3), alinhamento, listas, separador horizontal, tabela, imagem, desfazer e refazer.
| Recurso | Como usar |
|---|---|
| Variáveis | Abre o painel de variáveis, agrupadas (Empresa, Cliente, Negócio, Financeiro, Fornecedor, Itens, Sistema, Campos Customizados). Clique para inserir no texto. As variáveis disponíveis dependem do tipo do template, e os campos customizados da empresa também aparecem. |
| Blocos de repetição | Listas como os itens de uma proposta entram como bloco. Em Configurar, você escolhe as colunas e o formato (Tabela ou Lista). |
| Cabeçalho e Rodapé | Botão para adicionar ou remover cabeçalho e rodapé, repetidos em todas as páginas. |
| Configurações do PDF | Tamanho da página (A4 ou Letter), orientação (Retrato ou Paisagem) e margens (ex.: 20mm, 1.5cm, 30pt). |
| Preview | Gera o PDF com os dados de um registro real (busque pelo registro) ou com Usar Dados de Exemplo. |
| Restaurar Modelo | Volta ao conteúdo original do modelo de partida, descartando as alterações. |
Antes de usar um template com clientes, gere o Preview com um registro real para conferir se todas as variáveis foram preenchidas como esperado.
Template padrão
Cada tipo pode ter um template Padrão, que aparece destacado na hora de gerar o documento. Para trocar, use Tornar Padrão no menu ⋮ de outro template do mesmo tipo.
Histórico de documentos gerados
Ao Visualizar um template, a aba Histórico mostra os documentos gerados com aquele template, quem gerou e quando. Regenerar cria o documento de novo com a versão atual do template.
Gerenciando templates
| Ação | O que faz |
|---|---|
| Visualizar | Mostra os detalhes: tipo, tamanho da página, orientação, margens, se é padrão e se está ativo |
| Editar | Abre o editor |
| Preview | Gera um PDF de teste |
| Duplicar | Cria uma cópia com "(cópia)" no nome, que não é padrão |
| Tornar Padrão | Define o template como padrão do tipo |
| Excluir | Tira o template de uso. A ação não pode ser desfeita |
Regras importantes
| Regra | Detalhe |
|---|---|
| Nome único por tipo | Não pode haver dois templates com o mesmo nome no mesmo tipo: "Já existe um template de documento com o mesmo nome para este tipo de entidade nesta empresa." |
| Um tipo por template | Cada template pertence a um tipo, porque as variáveis mudam de um tipo para outro |
| Padrão | Um padrão por tipo. Marcar de novo o que já é padrão é recusado: "Este template já está definido como padrão para o tipo de entidade informado." |
| Sem template padrão | Quando nenhum template é escolhido e o tipo não tem padrão, a geração é recusada: "Nenhum template padrão configurado para o tipo … Configure um template antes de gerar documentos." |
| Envio por e-mail | Se o registro não tem e-mail de destinatário, o documento é gerado mesmo assim e aparece: "Documento gerado com sucesso, mas nenhum email de destinatário foi encontrado." |
| Falha ao salvar o PDF | A geração é interrompida para não deixar um documento sem anexo: "Não foi possível salvar o documento gerado. … Tente gerar novamente." |
| Documentos já gerados | Não mudam quando o template é alterado; use Regenerar no histórico |
| Excluir | Tira o template de uso e não pode ser desfeito |
Permissões
| Ação | Permissão no perfil de acesso (tela Template de Documento) |
|---|---|
| Ver templates | Ver |
| Criar, duplicar e gerar preview | Criar |
| Editar e tornar padrão | Editar |
| Excluir | Excluir |
Gerar um documento a partir de um registro depende também das permissões daquele registro (no Negócio, por exemplo, é preciso poder editá-lo para gerar a proposta).
Perguntas frequentes
Posso usar o mesmo template para tipos diferentes?
Não. Cada template pertence a um tipo, porque as variáveis mudam de um tipo para outro. Para reaproveitar o layout, use Duplicar ou A partir de modelo da empresa e ajuste.
Já tenho meu modelo no Word. Preciso refazer?
Não. Use Importar do Word ao criar o template. Depois confira o resultado no editor e troque os trechos fixos por variáveis.
Alterei o template. Os documentos antigos mudam?
Não. Documentos já gerados ficam como estavam. Se quiser uma nova versão, use Regenerar no histórico do template.
Não vejo a aba de um tipo (por exemplo, Rescisão).
O tipo só aparece quando a empresa tem o módulo onde ele é usado. Rescisão e Extrato de Pagamento dependem do RH; Contrato e Assinatura dependem do Contrato Recorrente.
Uma variável saiu em branco no PDF.
O registro usado não tem aquele dado preenchido. Gere o Preview com um registro real antes de enviar e complete o cadastro, se for o caso.
A nossa equipe ajuda você a configurar e usar esse recurso.