Aba PDF Templates
Guia de aba pdf templates no Perpetuus CRM.
A aba PDF Templates lista os templates de documentos (cotações, orçamentos, faturas, contratos) vinculados a este board. Cada template define o layout do PDF gerado a partir dos dados do card, do contato e dos produtos adicionados.
Onde configurar
Ver templates do board: Board → aba PDF Templates . Criar ou editar templates: Configurações → PDF Templates (ou acesse o PDF Builder diretamente). Gerar documento no card: Abra o card → aba Documentos (ou Orçamento).
Requisito: Módulo de produtos
Para usar cotações com tabela de produtos e totais , ative o Módulo de produtos em Board → aba Settings → Módulo de produtos. É necessário ter um catálogo de produtos na organização.
Fluxo de uso (passo a passo)
Adicionar produtos ao carrinho: No card, vá na aba Orçamento . Adicione itens ao carrinho (produtos do catálogo) e salve. Gerar documento: Vá na aba Documentos . Selecione um template no dropdown, clique em Gerar . O PDF é criado, arquivado no card e baixado. Templates sem produtos: Se o template não tiver blocos de Tabela de Produtos nem Totais, você pode gerar direto (ex: proposta simples com dados do contato e campos do card).
Blocos disponíveis no template
| Logo | Logo da organização (configurada em Settings) | Cabeçalho padrão |
|---|---|---|
| Informações da empresa | Nome, CNPJ, endereço, telefone, e-mail | Dados automáticos da org |
| Informações do contato | Cliente vinculado ao card: nome, CPF/CNPJ, endereço | "Cliente: João Silva" |
| Tabela de produtos | Itens do carrinho (nome, SKU, qtd, preço, total) | Exige itens no carrinho |
| Totais | Subtotal, desconto, impostos, frete, total | Exige itens no carrinho |
| Texto rico | Parágrafos com variáveis \{\{\}\} | "Prezado {{contact.name}}" |
| Assinatura | Linha de assinatura + nome do cliente/empresa | Rodapé do contrato |
| Número de página | "Página X de Y" no rodapé | Rodapé |
Variáveis dinâmicas (Handlebars)
Use \{\{caminho\}\} no texto do template para inserir dados. O editor do PDF Builder oferece sugestões de variáveis.
Contato e card
\{\{contact.name\}\} | João Silva |
|---|---|
\{\{contact.email\}\} | joao@empresa.com |
\{\{contact.phone\}\} | (11) 99999-9999 |
\{\{contact.document\}\} | CPF/CNPJ do contato |
\{\{card.title\}\} | Título do card |
\{\{card.fields.valor_proposta\}\} | Campo dinâmico (use o slug do campo) |
\{\{assignee.name\}\} | Nome do responsável |
\{\{organization.name\}\} | Nome da empresa |
\{\{today.date\}\} | 08/03/2025 |
Orçamento (quote)
\{\{quote.total\}\}, \{\{quote.subtotal\}\}, \{\{quote.discountTotal\}\}, \{\{quote.currency\}\}. Use o helper \{\{currency valor quote.currency\}\} para formatar moeda.
Vinculando templates ao board
Ao criar um template em Configurações, defina o Escopo : Organização (disponível em todos os boards) ou Board (apenas neste board). Ou vincule o template diretamente a um board. Na aba PDF Templates do board você vê apenas os templates deste board.
Exemplos práticos
Cotação de vendas: Logo + dados da empresa + dados do cliente + Tabela de produtos + Totais + Assinatura. Proposta simples (sem produtos): Logo + texto "Prezado {{contact.name}}, segue nossa proposta..." + campo \{\{card.fields.valor_proposta\}\} + Assinatura. Contrato: Blocos de texto com variáveis + Assinatura cliente e empresa. Relatório: Dados do card e contato + campos dinâmicos em colunas. ⚠️ Template com produtos: Se o template tiver blocos Tabela de Produtos ou Totais, você precisa adicionar itens no carrinho (aba Orçamento) antes de gerar. Caso contrário, aparecerá "Nenhum item adicionado".
Use slugs curtos nos campos dinâmicos (ex: valor_proposta, cnpj_cliente) — facilitam variáveis em PDFs e automações.