AutonomoPerezoso

/ developers · api v1

Tu factura Verifactu, en un POST.

La misma máquina que emite las facturas en la app, expuesta como API REST. Tokens Bearer, JSON limpio y numeración correlativa garantizada por transacción.

Crear API keyVer endpoints
Verifactu-readyNumeración correlativaJSON · sin SDK obligatorioBearer tokens

Quickstart

Emite tu primera factura con un comando.

Una API key, tres campos obligatorios (cliente, concepto, precio) y tienes la factura emitida con número correlativo y total calculado.

cURL
curl -X POST https://autonomoperezoso.es/api/v1/facturas \
  -H "Authorization: Bearer ap_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "cliente_id": "cm123...",
    "lineas": [
      { "concepto": "Diseno web", "cantidad": 1, "precio": 1500 }
    ]
  }'
Node.js (fetch)
const res = await fetch(
  "https://autonomoperezoso.es/api/v1/facturas",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.AP_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      cliente_id: cliente.id,
      lineas: [
        { concepto: "Diseno web", cantidad: 1, precio: 1500 },
      ],
    }),
  }
);
const factura = await res.json();
console.log(factura.referencia); // "A/2026/0007"
Python (requests)
import os, requests

res = requests.post(
    "https://autonomoperezoso.es/api/v1/facturas",
    headers={
        "Authorization": f"Bearer {os.environ['AP_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "cliente_id": cliente_id,
        "lineas": [
            {"concepto": "Diseno web", "cantidad": 1, "precio": 1500}
        ],
    },
)
factura = res.json()
print(factura["referencia"])
Respuesta JSON
{
  "id": "cm5fact...",
  "referencia": "A/2026/0007",
  "estado": "EMITIDA",
  "fecha_emision": "2026-06-05T10:21:00.000Z",
  "cliente_id": "cm123...",
  "importes": {
    "base_imponible_centimos": 150000,
    "iva_porcentaje": 21,
    "iva_centimos": 31500,
    "total_centimos": 181500
  }
}

Endpoints v1

Pequeña. Suficiente. Crece contigo.

v1 cubre los dos verbos clave de un autónomo: clientes y facturas. Más superficie llegará a medida que los integradores la pidan.

  • GET/api/v1/me

    Información de la cuenta dueña del token.

  • GET/api/v1/clientes

    Lista paginada de clientes.

  • POST/api/v1/clientes

    Crea un cliente nuevo.

  • GET/api/v1/facturas

    Lista de facturas, filtros por estado.

  • POST/api/v1/facturas

    Emite una factura correlativa con líneas.

  • GET/api/v1/facturas/:id

    Detalle de una factura con sus líneas.

Casos de uso

Para quién hemos pensado esto.

SaaS con suscripciones

Crea facturas Verifactu automáticas cada vez que un cliente paga. Olvida la pestaña 'Facturación' a medias.

Marketplaces multi-vendor

Cada vendedor conecta su token y emite a sus clientes con su numeración. Sin duplicar gestoría.

ERPs y CRMs

Tu vista de clientes en tu sistema ya es la fuente de verdad. Pasamos la factura sin cambiar tu UX.

Scripts internos

¿Facturas mensuales fijas a 30 clientes? Un cron de 20 líneas reemplaza a 30 clicks.

Asesorías digitales

Emite por cuenta de tus clientes con sus tokens individuales. Tú orquestas, ellos cumplen.

Apps verticales

Fisios, peluqueros, profes — la factura sale de tu app sin que el usuario sepa que existe Verifactu.

¿Listo para integrar?

Crea tu cuenta gratis, genera un token y ten tu primera llamada en un par de minutos. No cobramos por la API — el límite es el del plan.

Empezar gratisIr a mis tokens