rustedf.cloud
Menú

Cómo generar una factura en PDF con una API

Publicado el 2 min de lectura

Una factura es un conjunto de datos (un número, un cliente, algunas líneas, un total) que tiene que salir de tu sistema como documento. Esta guía construye una como plantilla HTML y la genera en PDF con la API de rustedf.cloud, con el formato del país de quien la va a leer.

Trata de facturas y recibos comerciales. Los requisitos fiscales y legales de las facturas cambian según el país y quedan fuera de su alcance.

La plantilla

Una plantilla es HTML y CSS con {{ }} para valores y {% %} para lógica. Guárdala en el portal, donde tienes vista previa en vivo, o envíala directamente en la petición.

<style>
@page {
size: A4;
margin: 20mm;
@bottom-right { content: "Página " counter(page) " de " counter(pages); }
}
body { font-family: sans-serif; }
table { width: 100%; border-collapse: collapse; }
th, td { padding: 6px 4px; border-bottom: 1px solid #ccc; text-align: left; }
.n { text-align: right; }
</style>
<h1>Factura {{ number }}</h1>
<p>{{ customer.name }}<br>Emitida el {{ issued | date(style="long") }}</p>
<table>
<thead>
<tr><th>Descripción</th><th class="n">Cant.</th><th class="n">Importe</th></tr>
</thead>
<tbody>
{% for item in items %}
<tr>
<td>{{ item.name }}</td>
<td class="n">{{ item.qty | number }}</td>
<td class="n">{{ item.amount | currency(code="EUR") }}</td>
</tr>
{% endfor %}
</tbody>
</table>
<h2>Total {{ total | currency(code="EUR") }}</h2>

El bucle {% for %} repite una fila por cada línea, así que la tabla crece con tus datos y continúa en la página siguiente cuando hace falta. La regla @page define el papel y un contador de páginas en la esquina.

Los datos

Envía los importes como texto. Una cadena como "1234.50" evita las sorpresas de los números de coma flotante, y el filtro currency la redondea a los decimales de la moneda.

{
"number": "2025-0042",
"issued": "2025-03-14",
"customer": { "name": "Mercado Bella Vista S.L." },
"items": [
{ "name": "Identidad visual", "qty": 1, "amount": "4800.00" },
{ "name": "Diseño de envases", "qty": 6, "amount": "3900.00" }
],
"total": "8700.00"
}

Calcula las líneas y el total en tu propio sistema y envía los resultados. La plantilla los formatea; no tiene por qué ser el lugar donde se calcula tu dinero.

Una plantilla, todos los mercados

Añade un locale a la petición y los tres filtros de formato lo siguen.

Terminal window
curl -X POST https://api.rustedf.com/v1/render \
-H "Authorization: Bearer $RUSTEDF_KEY" \
-H "Content-Type: application/json" \
-d '{
"template_id": "0194f2c0-…",
"locale": "es-ES",
"data": { "number": "2025-0042", "issued": "2025-03-14", "total": "8700.00" }
}' \
-o factura.pdf

Así se leen el mismo importe y la misma fecha para cuatro lectores:

Idioma Moneda 1234.5 date(style="long") para 2024-03-15
en-US USD $1,234.50 March 15, 2024
pt-BR BRL R$ 1.234,50 15 de março de 2024
de-DE EUR 1.234,50 € 15. März 2024
es-ES EUR 1234,50 € 15 de marzo de 2024

El locale viene primero de la petición, después de la plantilla guardada y, por último, del idioma predeterminado de tu cuenta. Una etiqueta no válida es un 400.

Logotipo y código de pago

Sube un PNG o JPEG una vez, en el portal o con POST /v1/assets, y úsalo por referencia. Un código QR para un enlace de pago está a un filtro de distancia:

<img src="asset:0194f2c0-…" width="120" alt="Logotipo de la empresa">
{{ pay_url | qr(size=30) | safe }}

safe está ahí porque el código QR es marcado que dibuja el propio servicio. Tus datos siguen escapados.

Compruébalo antes de que lo vea el cliente

POST /v1/validate construye el documento y enumera todo lo que el servicio no admitió por completo, sin devolver el PDF y sin gastar un crédito. Ejecútalo una vez sobre tu plantilla y añade "strict": true a tus pruebas, para que un cambio que introduzca una propiedad no admitida falle allí y no en producción.

Continúa con Plantillas, Idiomas y formato e Imágenes.

← Todos los artículos