Templates PDF
Un template PDF es un documento HTML + CSS con variables que Nxar renderiza en el servidor (con Chromium) cada vez que una automation, un Stepper o un componente lo pide: la cotización con tu marca, un recibo de donación, un contrato. Esta página es para administradores; necesitás manage_pdf_templates. Viven en Configuración → Automatización → PDF Templates (aparece si tu plan incluye el servicio).
Crear un template
- Nuevo template: nombre técnico (
snake_case, inmutable: es lo que usan las automations y los componentes para invocarlo), etiqueta visible y descripción. - Después de crearlo editás:
- HTML y CSS del documento.
- Variables: los placeholders que el HTML usa (
{{cliente.nombre}},{{total}}), con tipo, si son requeridas, valor por defecto y descripción. Quien pide el render envía un valor por cada una. - Opciones de render: formato de página (A4, Letter…), orientación, márgenes en unidades CSS.
- Activo: inactivo, no se puede renderizar.
- Vista previa renderiza el PDF con datos de muestra y lo abre en una pestaña nueva.
Variables
{{variable}} y rutas anidadas {{cliente.email}}. El valor se escapa siempre (un < en el nombre de un cliente no rompe el documento). Si necesitás insertar HTML ya armado (una tabla de líneas generada por un componente), {{{variable}}} con tres llaves lo inserta crudo: usalo solo con contenido que vos generás.
<h1>Cotización {{quote.number}}</h1>
<p>{{account.name}} · {{quote.date}}</p>
{{{lines_table}}}
<p class="total">Total: {{quote.total}}</p>Quién lo usa
| Desde | Cómo |
|---|---|
| Automations | Nodo Generar PDF: elegís el template y los datos (por defecto el registro); el PDF se adjunta al registro y se puede mandar como adjunto de Enviar email. Ver Triggers y nodos |
| Logic Components | Renderizan y guardan el PDF en los archivos del registro (así CPQ guarda la cotización enviada y Fundraising el recibo). Ver Logic Components |
| Botones del header | Un botón Generar PDF en la Record Page que llama a un componente. Ver Record Pages |
Los paquetes traen sus templates (CPQ el de la cotización; Fundraising el del recibo): son administrados por el paquete, pero podés clonarlos y apuntar el paquete al tuyo desde su Settings cuando lo ofrece.
Permisos y auditoría
| Acción | Permiso |
|---|---|
| Crear, editar y previsualizar templates | manage_pdf_templates |
| Generar un PDF (disparar un render) | render_pdf; las automations heredan el contexto con que corren |
Cada render queda registrado (template, quién lo pidió, tamaño, duración, resultado).
Límites actuales
- El editor es HTML/CSS a mano, sin diseñador visual.
- Un template, un idioma: para varios idiomas, varios templates.
- Un render a la vez por servidor; documentos muy largos pueden tardar algunos segundos.