</> API para developers

La API de extracción de facturas hecha para la fiscalidad española

Integra en tu software la extracción de IVA, IRPF y NIF de facturas PDF e imagen. Respuesta JSON estable, validación fiscal española y datos procesados en la Unión Europea. La alternativa española a las APIs internacionales de OCR de facturas.

curl https://invoicedata.es/api/v1/invoices/scan \
  -H "X-Api-Key: ik_tu_clave_secreta" \
  -F "file=@factura.pdf"
01 Respuesta

Campos fiscales españoles, ya estructurados

No recibes texto plano que toque parsear: cada factura vuelve como un JSON con los campos que de verdad necesitas para contabilizar y declarar en España.

  • vendor_name / vendor_tax_idEmisor y su NIF/CIF. Incluye vendor_tax_id_valid con el resultado de comprobar el dígito de control (NIF, NIE y CIF).
  • subtotal / tax_amountBase imponible y cuota total de IVA de la factura.
  • tax_breakdownDesglose del IVA por tipo (4 %, 10 %, 21 %) con la base y la cuota de cada uno, para cuadrar el modelo 303.
  • withholding_amountRetención de IRPF, siempre en positivo. Se detecta aunque la factura solo la refleje en el total.
  • withholding_rate / withholding_baseTipo de la retención y base sobre la que se practica, los dos datos que el modelo 111 pide además del importe. Solo si la factura los escribe: ni el tipo se calcula dividiendo ni la base se copia del subtotal.
  • surcharge_amountRecargo de equivalencia cuando la factura va a un comercio minorista.
  • total / totals_consistentTotal de la factura y un booleano que dice si cuadra con base + IVA + recargo − retención.
  • discount_amountDescuento aplicado en la factura, siempre en positivo aunque figure restando. Con discount_percent cuando el documento escribe el porcentaje.
  • other_charges_amountPortes, gastos de gestión o recargo por demora, con su concepto en other_charges_concept. No se mezclan con el recargo de equivalencia.
  • payment_method / payment_ibanForma de pago tal y como la nombra la factura y el IBAN de cobro, que es lo que hace falta para conciliar el banco.
  • line_itemsLíneas de detalle: descripción, cantidad, precio unitario e importe.
  • purchase_orderPedido, albarán o contrato del cliente al que responde la factura, para casarla con lo que se encargó.
  • rectifies_invoice_numberEn una rectificativa o un abono, el número de la factura que corrige.
  • payment_termsCondiciones de pago literales («30 días fecha factura»), que explican el vencimiento cuando la factura no escribe la fecha.
  • confidence / field_confidenceConfianza del documento de 0 a 1, y la de cada campo por separado: dice qué repasar, no solo cuánto fiarse.
Respuesta · JSON
{
  "id": 4213,
  "status": "completed",
  "vendor_name": "Suministros García S.L.",
  "vendor_tax_id": "B12345674",
  "vendor_tax_id_valid": true,
  "customer_name": "Asesoría Pérez S.L.",
  "customer_tax_id": "B15075062",
  "customer_address": "Gran Via 2, 08007 Barcelona",
  "invoice_number": "2026-0042",
  "invoice_date": "2026-03-14",
  "due_date": "2026-04-13",
  "purchase_order": "PED-4412",
  "subtotal": 1000.00,
  "tax_amount": 210.00,
  "tax_breakdown": [
    { "rate": 21.0, "base": 1000.00, "amount": 210.00 }
  ],
  "withholding_amount": 150.00,
  "withholding_rate": 15.0,
  "withholding_base": 1000.00,
  "surcharge_amount": null,
  "total": 1060.00,
  "currency": "EUR",
  "discount_amount": 40.00,
  "other_charges_amount": null,
  "payment_method": "Transferencia",
  "payment_iban": "ES9121000418450200051332",
  "payment_terms": "30 días fecha factura",
  "totals_consistent": true,
  "confidence": 0.98,
  "field_confidence": { "vendor_name": 0.99, "total": 0.99, "payment_iban": 0.82 },
  "line_items": [
    { "description": "Material de oficina", "product_code": "REF-4410",
      "quantity": 10, "unit": "caja", "unit_price": 100.00,
      "discount": null, "base": 1000.00,
      "tax_rate": 21.0, "tax_amount": 210.00, "amount": 1210.00 }
  ]
}
02 Endpoints

Una superficie pequeña, fácil de integrar

POST/api/v1/invoices/scanSube un PDF, JPG o PNG (máx. 10 MB) y recibe el JSON completo con todos los campos fiscales extraídos.
API Keys con prefijo ik_, hasheadas con SHA-256. Hasta 10 por cuenta.
Webhooks: recibe un aviso HTTP cuando cada factura termina de procesarse.
Facturas procesadas en la Unión Europea, conforme al RGPD.
03 Por qué española

Lo que una API genérica te deja a medias

IVA desglosado

Separamos automáticamente los tipos del 4 %, 10 % y 21 %, incluso mezclados en la misma factura.

IRPF y recargo

Extraemos la retención de IRPF y el recargo de equivalencia, campos que las APIs internacionales no contemplan.

NIF/CIF validado

Comprobamos el dígito de control con el algoritmo oficial. Sabes si un NIF es inválido antes de declararlo.

Datos en la UE

Tus facturas se procesan y se guardan en la UE. RGPD desde el primer día y DPA bajo demanda.

04 Preguntas frecuentes

Dudas habituales de integración

¿En qué se diferencia de una API de OCR de facturas internacional?

InvoiceData está construido para la fiscalidad española: desglosa el IVA al 4 %, 10 % y 21 %, extrae la retención de IRPF y el recargo de equivalencia, y valida el NIF/CIF con el algoritmo oficial de la Agencia Tributaria. Las APIs internacionales devuelven campos genéricos que luego tienes que mapear y completar tú.

¿Cómo me autentico?

Con una API Key que generas desde tu panel (prefijo ik_). Se envía en la cabecera X-Api-Key de cada petición. El secreto se almacena hasheado con SHA-256 y puedes revocar o crear claves cuando quieras, hasta 10 por cuenta.

¿La respuesta JSON es estable entre versiones?

Sí. Los nombres de campo son fijos y su tipo no cambia entre versiones menores, para que tu integración no se rompa. Cada factura incluye además una puntuación de confianza de la extracción.

¿Puedo procesar facturas en lote?

Sí. Envía los documentos de forma concurrente a /invoices/scan: cada petición es independiente y el límite es de 20 por minuto y cuenta. También puedes registrar un webhook para recibir un aviso cuando cada factura termina de procesarse, sin hacer polling.

¿Cómo se cuentan las facturas de varias páginas?

Cada petición a /invoices/scan consume una factura de tu cuota, tenga el documento una página o quince. Si un PDF contiene varias facturas distintas, envíalas en peticiones separadas: de cada documento se extrae una sola factura.

¿Dónde se procesan los datos?

La infraestructura y el OCR están en centros de datos de la Unión Europea. Cumplimos el RGPD y firmamos un DPA si tu empresa lo necesita. Puedes consultar el detalle de los proveedores que intervienen, y de las transferencias internacionales cuando las hay, en nuestra Política de Privacidad.