Generar con una plantilla guardada

Usa una plantilla guardada cuando el mismo documento se genera una y otra vez, como facturas, presupuestos o informes. El diseño vive en tu cuenta; cada petición lleva solo los datos que cambian.

1. Guarda la plantilla

Créala en el portal, en Templates, con vista previa en vivo, o mediante la API:

curl -X POST https://api.example.com/v1/templates \
  -H "Authorization: Bearer $RUSTEDF_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Factura", "source": "<h1>Factura {{ number }}</h1><p>{{ total | currency(code=\"EUR\") }}</p>",
        "locale": "es-ES", "sample_data": { "number": "2025-0042", "total": "2040.50" } }'

La respuesta incluye el id de la plantilla. Consulta la sintaxis en Plantillas.

2. Genera el documento

Envía el id y los datos:

curl -X POST https://api.example.com/v1/render \
  -H "Authorization: Bearer $RUSTEDF_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "template_id": "0194f2c0-…", "data": { "number": "2025-0042", "total": "2040.50" } }' \
  -o factura.pdf

Se usa el locale de la plantilla, salvo que la petición envíe el suyo. Así una plantilla sirve a todos los mercados: envía "locale": "de-DE" y la misma factura sale con el formato de Alemania.

Por qué usarla

• El HTML no viaja en cada petición, así que son pequeñas.
• Diseñadores y desarrolladores editan la plantilla en el portal y la prueban con datos de ejemplo, sin un despliegue de tu parte.
• Cada cambio aumenta la version de la plantilla, y la siguiente generación ya usa la nueva.
• Las plantillas son privadas de tu cuenta; el id de otra cuenta responde 404.

Tu plan limita cuántas plantillas puedes guardar; consulta Planes y créditos. Para la lista completa de campos y la respuesta, consulta Generar un PDF. Si prefieres enviar el HTML tú mismo, consulta Con HTML directo.