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.
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.pdfAsí 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.
Sigue leyendo
Primeros pasos
HTML y CSS para PDF: qué funciona y cómo comprobarlo
Un PDF está paginado, no se desplaza. Mira qué HTML y CSS admite un generador de PDF, qué dejar fuera y cómo validar un documento antes de enviarlo.
3 min de lectura
Primeros pasos
HTML a PDF: ¿biblioteca, navegador headless o API? Cómo elegir
Tres formas de convertir HTML en PDF, qué pide cada una que ejecutes y mantengas, qué HTML y CSS obtienes, y una lista corta de preguntas que deciden.
4 min de lectura
Primeros pasos
Cómo generar un PDF desde HTML con una sola petición
Envía HTML y datos en un POST y recibe el PDF. Ejemplo con curl y Node.js, y qué saber sobre imágenes, límites y créditos.
2 min de lectura
Código e integraciones
Generar un PDF en ASP.NET Core: MVC, Razor Pages y minimal APIs
Convierte una vista Razor en PDF en ASP.NET Core con una llamada a la API: renderizador de vistas, vista lista para imprimir, acción MVC y handler de Razor Pages.
3 min de lectura