Extraer datos de una factura
Los equipos de cuentas por pagar todavía dedican horas cada semana a digitar facturas de proveedores que llegan como PDF o escaneos con un diseño distinto cada vez. Este endpoint lee una factura y devuelve datos del proveedor, líneas de detalle, subtotal, impuesto y total general como JSON estructurado, listo para registrarse directamente en la contabilidad.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El problema del diseño en las facturas
No hay dos proveedores que formateen una factura igual — uno pone el desglose de impuestos en una tabla al pie, otro lo esconde en un párrafo, un tercero separa el envío y el manejo en líneas propias mientras un cuarto los incluye en el subtotal. Un equipo de finanzas que recibe facturas de decenas de proveedores en realidad recibe decenas de documentos distintos que comparten el nombre, y alguien tiene que normalizarlos antes de que se puedan pagar o contabilizar.
A quién le reemplaza la captura manual
Auxiliares de cuentas por pagar que digitan facturas de proveedores en un ERP, equipos de compras que concilian facturas contra órdenes de compra, servicios contables que procesan facturas de clientes en volumen, y productos SaaS que permiten a una empresa subir una factura de proveedor y esperan datos utilizables en vez de un escaneo plano.
La forma del resultado
Envía la factura, recibe de inmediato un task_id, y la tarea completada devuelve nombre y dirección del proveedor, número y fecha de factura, fecha de vencimiento, las líneas individuales con descripción, cantidad y precio unitario, además de subtotal, impuesto y total general — los campos que un sistema contable realmente registra, no una transcripción de la página.
Dónde encaja en el flujo de pagos
Como el endpoint es asíncrono y se cobra por página en lugar de por factura sin importar su extensión, una factura de varias páginas con decenas de líneas se cobra proporcionalmente: un servicio de monitoreo de bandeja de entrada recoge los PDF de facturas entrantes, envía cada uno al llegar, y el webhook entrega datos estructurados directamente al cruce a tres vías contra la orden de compra y el registro de recepción.
Un formato moldeado por décadas de papel
La factura comercial moderna hereda su estructura de los libros contables en papel — un encabezado de quién le cobra a quién, un cuerpo de cargos detallados, un pie de totales — un diseño que sobrevivió casi intacto al paso al PDF, y es precisamente por eso que leerla de forma automática todavía exige entender la estructura de una factura en particular, no tratarla como texto genérico.
Qué puede hacer con ella
Automatización de cuentas por pagar
Un equipo de AP reenvía los PDF de proveedores entrantes a la API y registra las líneas y totales extraídos directamente en el ERP.
Cruce a tres vías
Compras compara las líneas extraídas de la factura contra la orden de compra original y la nota de recepción antes de aprobar el pago.
Servicios contables a escala
Una firma contable procesa facturas de clientes provenientes de decenas de proveedores sin capacitar a su equipo en el diseño de cada uno.
Ingesta en una plataforma de gasto
Un producto de gestión de gasto permite a sus clientes subir facturas de proveedores y devuelve datos de gasto categorizados y estructurados de forma automática.
Preguntas frecuentes
¿Cómo funciona la API OCR Facturas?
Envíe el archivo de la factura a POST /ocr/invoice, reciba de inmediato un task_id, y obtenga el JSON estructurado por webhook o enlace firmado cuando termine el procesamiento.
¿Es gratis probarla?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cuánto cuesta?
$0.009 por solicitud más $0.0571 por página, precio publicado y plano, así que una factura más larga cuesta proporcionalmente más, no por línea de detalle.
¿Qué formatos de archivo admite?
Funcionan tanto facturas en PDF como escaneos de imagen claros; una página fuente legible da la extracción más completa.
¿Procesa facturas de varias páginas?
Sí, y el precio escala por página, así que una factura de dos páginas con una lista larga de detalle se cobra en consecuencia.
¿Puede reconocer distintos formatos de proveedor automáticamente?
Sí, está construida para leer la estructura de una factura en general y no una plantilla fija, así que se adapta entre proveedores sin configuración particular.
¿Es lo bastante precisa para saltarse la revisión manual?
Es precisa en formatos estándar de factura, pero como con cualquier extracción automática, vale la pena una revisión humana rápida en facturas de alto valor o poco comunes antes de contabilizarlas.
¿Se cobra si la extracción falla?
No. Una tarea fallida se reintenta automáticamente hasta tres veces y nunca se cobra; en su lugar recibe un error claro.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/ocr/invoice \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"image":"https://ejemplo.com/factura.jpg"}'const res = await fetch("https://api.kit.forhosting.com/ocr/invoice", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"image": "https://ejemplo.com/factura.jpg"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ocr/invoice",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"image": "https://ejemplo.com/factura.jpg"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ocr/invoice", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"image":"https://ejemplo.com/factura.jpg"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"image":"https://ejemplo.com/factura.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ocr/invoice", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"image": "https://ejemplo.com/factura.jpg"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ocr.invoice",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 25 |
max_pages | 10 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
413 | input_too_large | El archivo supera el límite de tamaño. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |