API de Reportia — Documentación para Desarrolladores

¿Qué es Reportia?

Reportia es una API REST para generar documentos profesionales desde datos JSON. Envía tus datos con una plantilla y recibe un PDF, Excel, CSV o HTML listo para descargar.

Plantillas listas para: facturas CFDI 4.0, reportes de ventas, balances, certificados, cotizaciones y más. O sube tu propia plantilla HTML/Jinja2.

Gratis: 50 documentos/mes sin registro. Pro ($9/mes): 1,000/mes sin marca de agua. Lifetime ($49): Acceso ilimitado de por vida.

Autenticación

El tier gratuito no requiere autenticación. Los límites se aplican por IP.

Para planes Pro/Scale, envía tu API key como header:

Authorization: Bearer tu-api-key

O usa una cookie de sesión reportia_session obtenida desde el portal.

Endpoints

Método	Ruta	Descripción
`POST`	/v1/render	Genera documento desde JSON + plantilla
`GET`	/templates	Galería de plantillas disponibles
`GET`	/templates/{slug}/sample.pdf	PDF de ejemplo descargable
`GET`	/templates/{slug}/source	Código fuente de la plantilla
`GET`	/pricing	Planes y precios (JSON)
`GET`	/stats	Estadísticas públicas del servicio
`GET`	/portal	Panel de cliente

Ejemplos de uso

Generar una factura PDF

Envía datos JSON con la plantilla 'factura' y recibe un PDF listo.

curl -X POST https://reportia.4l3.org/v1/render \
  -H "Content-Type: application/json" \
  -d '{
    "template": "factura",
    "format": "pdf",
    "data": {
      "empresa": "Mi Empresa S.A.",
      "rfc": "XAXX010101000",
      "cliente": "Cliente Demo",
      "items": [
        {"concepto": "Servicio de consultoría", "cantidad": 1, "precio": 5000}
      ],
      "moneda": "MXN"
    }
  }' \
  --output factura.pdf

import requests

response = requests.post(
    "https://reportia.4l3.org/v1/render",
    json={
        "template": "factura",
        "format": "pdf",
        "data": {
            "empresa": "Mi Empresa S.A.",
            "rfc": "XAXX010101000",
            "cliente": "Cliente Demo",
            "items": [
                {"concepto": "Servicio de consultoría",
                 "cantidad": 1, "precio": 5000}
            ],
            "moneda": "MXN",
        },
    },
)

with open("factura.pdf", "wb") as f:
    f.write(response.content)
print("Factura generada ✓")

const response = await fetch("https://reportia.4l3.org/v1/render", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    template: "factura",
    format: "pdf",
    data: {
      empresa: "Mi Empresa S.A.",
      rfc: "XAXX010101000",
      cliente: "Cliente Demo",
      items: [
        { concepto: "Servicio de consultoría", cantidad: 1, precio: 5000 }
      ],
      moneda: "MXN",
    },
  }),
});
const blob = await response.blob();
// Descargar o procesar el PDF

Respuesta:

→ Respuesta binaria: application/pdf (factura.pdf)

Generar reporte Excel

Mismo endpoint, cambia el formato a 'xlsx' para recibir un Excel.

curl -X POST https://reportia.4l3.org/v1/render \
  -H "Content-Type: application/json" \
  -d '{"template": "ventas", "format": "xlsx", "data": {"mes": "Junio 2026", "ventas": [{"producto": "Plan Pro", "total": 350}]}}' \
  --output reporte.xlsx

import requests

response = requests.post(
    "https://reportia.4l3.org/v1/render",
    json={
        "template": "ventas",
        "format": "xlsx",
        "data": {
            "mes": "Junio 2026",
            "ventas": [{"producto": "Plan Pro", "total": 350}],
        },
    },
)

with open("reporte.xlsx", "wb") as f:
    f.write(response.content)

const response = await fetch("https://reportia.4l3.org/v1/render", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    template: "ventas",
    format: "xlsx",
    data: { mes: "Junio 2026", ventas: [{ producto: "Plan Pro", total: 350 }] },
  }),
});
const blob = await response.blob();

Respuesta:

→ Respuesta binaria: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Listar plantillas disponibles

Obtén la galería completa de plantillas con sus campos requeridos.

curl https://reportia.4l3.org/templates

import requests

templates = requests.get("https://reportia.4l3.org/templates").json()
for t in templates:
    print(f"{t['slug']}: {t['name']} — {t['description']}")

const templates = await fetch("https://reportia.4l3.org/templates")
  .then(r => r.json());
templates.forEach(t => console.log(`${t.slug}: ${t.name}`));

Respuesta:

[
  {"slug": "factura", "name": "Factura CFDI 4.0", "formats": ["pdf", "html"]},
  {"slug": "ventas", "name": "Reporte de Ventas", "formats": ["pdf", "xlsx", "csv"]},
  {"slug": "balance", "name": "Balance General", "formats": ["pdf", "xlsx"]}
]

Probar la API

Haz llamadas reales a la API directamente desde aqui. Sin API key necesaria para el plan gratuito.

POST /v1/render Generar reporte PDF

GET /templates Listar plantillas

Límites de uso

Free (sin registro): 50 documentos/mes por IP. PDFs con marca de agua sutil.

Pro ($9/mes): 1,000 documentos/mes. Sin marca de agua. Plantillas custom.

Scale ($29/mes): 10,000/mes. Webhooks. Prioridad en cola.

Lifetime ($49): Nivel Pro de por vida, pago único.

Formatos soportados: PDF, XLSX, CSV, HTML, JSON, Markdown, TXT, PNG, DOCX, ZIP.

SDK Python

Instala el SDK oficial y úsalo en 3 líneas:

pip install reportia

Ejemplo:

from reportia import Reportia

client = Reportia()  # Free tier, no API key needed

# Generate a PDF invoice
client.render_to_file(
    "factura",
    "factura.pdf",
    data={
        "empresa": "Mi Empresa S.A.",
        "rfc": "XAXX010101000",
        "cliente": "Cliente Demo",
        "items": [{"concepto": "Consultoría", "cantidad": 1, "precio": 5000}],
    },
)

Paquete: reportia · Compatible con Python 3.8+

Recursos API

Descarga la especificación para tu herramienta favorita:

OpenAPI 3.1 (JSON) Swagger UI

Compatible con Postman, Insomnia, Swagger, y cualquier cliente OpenAPI.

Empieza gratis

No necesitas API key para empezar. Simplemente haz tu primera llamada:

curl https://reportia.4l3.org/api?format=json

Ir a Reportia Ver planes

¿Prefieres JSON? Llama este URL con Accept: application/json o agrega ?format=json.