Plantillas
Una plantilla es HTML y CSS con algunos extras. Los valores de data se insertan con
{{ }}, y {% %} añade lógica. La sintaxis es la de Tera,
cercana a las plantillas Jinja y Django.
<h1>Factura {{ number }}</h1><p>{{ customer.name }}, emitida el {{ issued | date(style="long") }}</p>
<table> {% for item in items %} <tr> <td>{{ item.name }}</td> <td>{{ item.amount | currency(code="EUR") }}</td> </tr> {% endfor %}</table>
{% if discount %}<p>Descuento aplicado</p>{% endif %}
<p>Total {{ total | currency(code="EUR") }}</p>Valores
Sección titulada «Valores»data es un objeto JSON. Accede a los objetos con un punto (customer.name) y recorre las
listas con {% for %}. Una variable llamada locale está siempre disponible y contiene el
idioma de la generación.
Los valores tienen el HTML escapado: un nombre como <b>Ana</b> aparece como texto, no como
marcado. Tu plantilla es marcado de confianza; tus datos no lo son.
{% if x %}…{% elif y %}…{% else %}…{% endif %}y comparaciones comox > 1.{% for item in items %}conloop.index,loop.firstyloop.last.- Aritmética:
{{ price * qty }}. {% set name = value %}para dar nombre a un valor intermedio.
Los filtros propios de Tera (upper, lower, round, length y otros) también funcionan.
El servicio añade tres para dar formato, que están en Idiomas y formato,
uno para comparar números y dos que dibujan códigos.
num convierte en número un número, un texto que contiene uno (los importes de tus datos
suelen ser texto) o un valor ausente o en blanco, para poder compararlo. Un texto que no es un número es un
error, y no una suposición. Un campo que falta en los datos es un error cuando se le aplica un
filtro, así que dale antes un valor por defecto.
{% if total | default(value=0) | num > 1000 %}Gracias por el pedido grande.{% endif %}Códigos
Sección titulada «Códigos»qr dibuja un código QR y barcode dibuja un código de barras Code 128, a partir de cualquier
texto o número de tus datos. Se escriben con safe, porque el código HTML es del propio
servicio.
{{ pay_url | qr(size=30) | safe }}{{ number | barcode(width=60, height=15) | safe }}| Filtro | Argumentos | Guarda |
|---|---|---|
qr |
size en milímetros (de 5 a 200, 30 por defecto), level de corrección de errores L, M, Q o H (M), margin en cuadrados de zona libre (de 0 a 10, 4) |
Hasta 1000 bytes de texto. |
barcode |
width y height en milímetros (de 20 a 200 y de 5 a 100; 60 y 15), margin en módulos de zona libre (de 0 a 20, 10) |
Hasta 80 letras, dígitos y puntuación, sin acentos. |
Un código es un conjunto de rectángulos vectoriales, así que se ve nítido a cualquier tamaño. Un valor ausente o vacío no dibuja nada; un valor que no cabe es un error. Todos los códigos de un documento juntos están limitados a 4 MiB de marcado, mucho más de lo que necesita una página.
Lo que una plantilla no puede hacer
Sección titulada «Lo que una plantilla no puede hacer»Las plantillas no pueden incluir otros archivos ni leer nada fuera de la generación. La salida de una generación tiene un límite fijado por el plan, y una plantilla que produce demasiado se rechaza.
Guardar plantillas
Sección titulada «Guardar plantillas»Crea y edita plantillas en el portal, que previsualiza y valida mientras escribes, o mediante la API. Una plantilla debe compilar para poder guardarse.
curl -X POST https://api.rustedf.com/v1/templates \ -H "Authorization: Bearer $RUSTEDF_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Factura", "source": "<h1>{{ number }}</h1>", "locale": "es-ES", "sample_data": { "number": "2025-0042" } }'sample_data solo sirve para la vista previa del portal. Cada cambio aumenta la version de
la plantilla. Las plantillas pertenecen a una cuenta: el id de una plantilla de otra cuenta
da 404.
Límites de los datos
Sección titulada «Límites de los datos»data debe ser un objeto JSON, de como máximo 32 niveles de profundidad y 200.000 valores,
y no mayor que el límite de entrada de tu plan.