Customizar o PDF da intimação

O sistema vem com modelos padrão de PDF pra cada tipo de intimação. Mas você pode customizar visualmente o documento do seu jeito, usando um editor parecido com Word.

Para quem é

Titular ou Administrador.

Quando usar

• Você quer adicionar a logo, brasão ou marca d'água do seu cartório
• Quer mudar o texto de instrução (ex: protesto pode ter texto sobre "pagamento até as 16h")
• Quer reformatar o layout pra ficar mais com a identidade visual do cartório
• Quer adicionar campos que só você usa (ex: número de protocolo interno do seu cartório)

Pré-requisitos

• Módulo Intimações ativo
• Perfil Titular ou Administrador
• Dados básicos do cartório preenchidos em Empresa > Configurações (nome, CNPJ, endereço, vão aparecer no PDF via variáveis)

Passo a passo

1. Acesse os modelos

Menu: Intimações → Modelos de PDF.

Você vê uma galeria com os 6 tipos. Cada card mostra se está usando o "Padrão do sistema" ou "Customizado".

2. Escolha um tipo pra customizar

Clique em "Customizar" (ou "Editar" se já customizou antes).

O editor abre com o modelo padrão pré-carregado (você pode partir dele).

3. Edite o conteúdo

O editor tem barra com formatação:

• Tamanho de fonte (H1, H2, H3, normal)
• Negrito, itálico, sublinhado
• Cor de texto e fundo
• Alinhamento (esquerda, centro, direita)
• Listas (numeradas, marcadores)
• Quote (citação destacada)

4. Use as variáveis

Na barra lateral esquerda estão todas as variáveis disponíveis. Cada uma é substituída pelo valor real quando o PDF é gerado.

Categorias:

Cartório (dados do seu cartório):

• {{ cartorio.nome }}: nome do cartório
• {{ cartorio.cnpj }}: CNPJ formatado
• {{ cartorio.endereco }}: endereço completo
• {{ cartorio.telefone }}: telefone
• {{ cartorio.email }}: email
• {{ cartorio.tabeliao }}: nome do tabelião
• {{ cartorio.cargo }}: cargo

Intimação:

• {{ intimacao.codigo }}: código da intimação
• {{ intimacao.tipo }}: tipo (ex: "Protesto")
• {{ intimacao.base_legal }}: base legal do tipo
• {{ intimacao.data_criacao }}: data que foi criada
• {{ intimacao.data_entrega }}: data e hora da entrega
• {{ intimacao.prazo_dias }}: prazo aplicado

Destinatário:

• {{ destinatario.nome }}
• {{ destinatario.documento }} (CPF ou CNPJ formatado)
• {{ destinatario.endereco }}
• {{ destinatario.telefone }}
• {{ destinatario.email }}

Título / dados do tipo (varia por tipo):

• {{ titulo.devedor_nome }}: só faz sentido em Protesto
• {{ titulo.valor_a_protestar }}: formatado em BRL
• {{ titulo.matricula }}: Imóveis
• {{ titulo.QUALQUER_CAMPO }}: funciona pra qualquer campo customizado do tipo

Datas / sistema:

• {{ data.hoje }}: 22/06/2026
• {{ data.hoje_extenso }}: 22 de junho de 2026
• {{ data.cidade_data }}: "São Luís, 22 de junho de 2026"

5. Inserir variável no editor

• Posicione o cursor onde quer a variável
• Clique na variável na barra lateral → insere {{ nome.campo }} no cursor

6. Veja como ficou (preview)

Clique em "Visualizar PDF" no topo. Abre em nova aba mostrando como o PDF vai ficar com dados reais da última intimação do tipo.

7. Salve

Clique em "Salvar modelo" no topo.

A partir daí, TODA geração de PDF daquele tipo (admin, app entregador, API) usa esse template.

Validação

1. ✅ Mensagem "Modelo de [Tipo] salvo"
2. ✅ Na listagem, o card do tipo mostra "Customizado" (em vez de "Padrão do sistema")
3. ✅ Ao criar nova intimação desse tipo, o PDF gerado segue seu modelo
4. ✅ Variáveis foram substituídas pelos valores reais (não aparece {{ ... }} no PDF final)

Restaurar o padrão

Mudou de ideia? Na listagem Modelos de PDF, clique no ícone de lixeira ao lado do card. Confirma e seu modelo é apagado, o sistema volta a usar o template Blade padrão.

Erros comuns

Problema	Causa	Solução
Variável aparece como {{ var }} no PDF	Variável não existe (digitou errado)	Use a sidebar pra inserir: evita erro de digitação
PDF gerou mas algumas variáveis vazias	Dados não preenchidos na intimação ou no cartório	Confira a intimação. {{ cartorio.* }}: vá em Empresa > Configurações
Layout cortado / saindo da página	HTML muito largo (ex: tabela com muitas colunas)	Use tabelas com menos colunas. Reduza tamanho de fonte se necessário
Editor não carrega	Bloqueio de CDN externa pela rede da empresa	Editor usa Quill via jsdelivr. Libere cdn.jsdelivr.net no firewall

Próximos passos

• Cadastrar tabelião e assinatura. pra usar {{ cartorio.tabeliao }} no rodapé do PDF
• Tipos de intimação. pra entender quais variáveis fazem sentido por tipo