Ir al contenido

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>

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 como x > 1.
  • {% for item in items %} con loop.index, loop.first y loop.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 %}

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.

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.

Crea y edita plantillas en el portal, que previsualiza y valida mientras escribes, o mediante la API. Una plantilla debe compilar para poder guardarse.

Ventana de terminal
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.

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.