Integra facturación VeriFactu en tu SaaS o ecommerce: la API, en 3 llamadas

La idea en 30 segundos

FacturaOk expone una API REST donde cada recurso vive bajo tu empresa: clientes, facturas, gastos, webhooks. Tu aplicación crea un borrador de factura con sus líneas, lo emite (aquí nace el número definitivo, la huella y el QR — y, si quieres, la remisión a la AEAT), y descarga el PDF o deja que el cliente lo reciba por email con su enlace de pago. La parte fiscal ocurre entera por debajo: tu código nunca calcula un hash ni firma un XML.

Autenticación: una cabecera

Generas la clave en el panel (sección API) y la mandas en cada petición con X-Api-Key. El prefijo te dice dónde estás: fok_test_… opera contra tu sandbox aislado y fok_live_… contra producción. Mismo código, distinta clave.

Llamada 1: crear el borrador

curl -X POST https://facturaok.es/v1/companies/{companyId}/invoices/drafts \
  -H "X-Api-Key: fok_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "9b2f…",
    "lines": [
      { "description": "Suscripción plan Pro — agosto 2026",
        "quantity": 1, "unitPrice": 49.00,
        "taxRate": 21.0, "irpfRate": 0 }
    ]
  }'

Cada línea lleva su IVA (taxRate), su retención si aplica (irpfRate), recargo de equivalencia o descuento. El borrador es editable y aún no tiene número: puedes crearlo al confirmar el pedido y emitirlo al cobrar.

Llamada 2: emitir

curl -X POST https://facturaok.es/v1/companies/{companyId}/invoices/{id}/issue \
  -H "X-Api-Key: fok_test_..."

En este momento la factura recibe su número correlativo de serie, se genera el registro VeriFactu con su huella encadenada y su QR, y queda lista para remitirse a la AEAT. Es el único paso irreversible — como manda el reglamento: a partir de aquí, los cambios van por rectificativa (que también tiene su endpoint, con invoiceType rectificativa y referencia a la original).

Llamada 3: el PDF (o el cobro)

curl https://facturaok.es/v1/companies/{companyId}/invoices/{id}/pdf \
  -H "X-Api-Key: fok_test_..." -o factura.pdf

El PDF sale con tu logo y el QR de verificación. Si prefieres cobrar primero, la factura puede llevar un enlace de pago por tarjeta — y el webhook te avisa cuando se paga.

Webhooks: sin polling

Desde el plan Pro puedes registrar endpoints por empresa y recibir los eventos de facturación y cobro en tu backend. El flujo típico de un SaaS queda así: tu sistema de suscripciones dispara el borrador + emisión a fin de mes, y el webhook de cobro cierra el círculo en tu contabilidad. Nada de consultar estados en bucle.

Lo que no tienes que construir

• El algoritmo de la huella encadenada y su especificación (v0.1.2) — hecho y testeado contra la AEAT real.
• El QR conforme (v0.5.0) y la URL de cotejo.
• La numeración correlativa por series y las rectificativas enlazadas.
• Facturae 3.2.2 firmada para el sector público (FACe) y el SII si te crece un cliente grande.
• La declaración responsable del fabricante — esa la firmamos nosotros.

Empieza en el sandbox, hoy

La API viene con el plan Pro (9,90 €/mes), e incluye las dos claves: la fok_test_ opera contra tu sandbox aislado — facturas de mentira, registros de verdad — y la fok_live_ contra producción. Antes de pagar un euro puedes leer la documentación completa y el Swagger, que son públicos: sabrás exactamente qué integras antes de contratar.

Los ejemplos reflejan la API v1 a 9 de agosto de 2026. FacturaOk es una plataforma privada no afiliada a la AEAT.