IVA desglosado
Separamos automáticamente los tipos del 4 %, 10 % y 21 %, incluso mezclados en la misma factura.
</> 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.
Petición · cURL
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, validado con dígito de control.tax_base / tax_amountBase imponible y cuota de IVA, desglosadas por tipo (4 %, 10 %, 21 %).irpf_amountImporte de retención de IRPF cuando la factura lo incluye.totalTotal de la factura, comprobado contra base y cuotas.line_itemsLíneas de detalle: descripción, cantidad, precio unitario y total.confidencePuntuación de confianza (0–1) por documento y por campo.
Respuesta · JSON
{
"vendor_name": "Suministros García S.L.",
"vendor_tax_id": "B12345678",
"invoice_number": "2026-0042",
"invoice_date": "2026-03-14",
"tax_base": 1000.00,
"tax_amount": 210.00,
"irpf_amount": 150.00,
"total": 1060.00,
"confidence": 0.98,
"line_items": [
{ "description": "Material de oficina", "quantity": 10, "unit_price": 100.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.POST
/api/v1/invoices/scan-testPrueba la extracción sin consumir cuota. Ideal para depurar tu integración antes de pasar a producción.API Keys con prefijo
ik_, hasheadas con SHA-256. Hasta 10 por cuenta.Webhooks: recibe un aviso HTTP cuando cada factura termina de procesarse.
Procesamiento 100 % en la Unión Europea, conforme al RGPD.
03 Por qué española
Lo que una API genérica te deja a medias
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
Sin transferencias fuera del espacio europeo. 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 campo incluye además su propia puntuación de confianza.
¿Puedo procesar facturas en lote?
Sí. Puedes enviar documentos de forma concurrente a /invoices/scan, y los planes con procesamiento batch permiten subir hasta 100 documentos a la vez. También puedes recibir un webhook cuando cada factura termina de procesarse, sin hacer polling.
¿Dónde se procesan los datos?
En centros de datos de la Unión Europea. Cumplimos el RGPD y firmamos un DPA si tu empresa lo necesita. Ningún documento sale del espacio europeo.