Escanear un recibo
Un recibo de papel arrugado es el último reducto analógico en la mayoría de los flujos de gastos, y es el documento que nadie quiere digitar a mano. Este endpoint lee la foto de un recibo y devuelve comercio, fecha, líneas de compra, impuesto y total como JSON estructurado, para que el papel nunca tenga que tocar una hoja de cálculo.
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 de un bolsillo lleno de recibos
Los recibos son pequeños, impresos en papel térmico, se desvanecen en semanas y llegan en cada forma que una caja registradora pueda producir: cintas de supermercado de dos pulgadas de ancho, comprobantes de restaurante con la propina escrita a mano, boletos de gasolinera impresos de lado. Cualquiera que haya intentado conciliar una pila de ellos a fin de mes sabe que el verdadero costo no es leer un recibo, sino leer cincuenta, de manera consistente, sin pasar por alto aquel cuyo total quedó borroso.
Quién realmente necesita esto
Herramientas de reportes de gastos que permiten a un empleado tomar una foto en vez de llenar un formulario, software contable que concilia caja chica, aplicaciones de finanzas personales que construyen un historial de gasto a partir de comprobantes de papel, y flujos de reembolso en empresas que todavía manejan bastantes recibos físicos aunque todo lo demás ya sea digital.
Qué recibe de vuelta
Envía la imagen, recibe de inmediato un task_id, y la tarea terminada devuelve el nombre del comercio, la fecha de compra, las líneas individuales con cantidades y precios cuando son legibles, subtotal, impuesto y total general como campos JSON limpios — los números que necesita un sistema contable, no un bloque de texto crudo por volver a interpretar.
Cómo encaja en un flujo mayor
Como la llamada es asíncrona y se cobra por documento sin mezclarse con ningún otro cargo, se integra sin fricción en un flujo de gastos: una aplicación móvil sube la foto justo cuando se toma, el webhook se dispara cuando termina el análisis, y el JSON resultante llega directamente al registro de gasto sin que ninguna persona transcriba un número.
Por qué los recibos resisten el OCR genérico
El papel térmico se degrada, las impresoras de recibos usan tipografías diminutas y condensadas, y el diseño varía enormemente según el sistema de punto de venta — un extractor de texto genérico devuelve un revoltijo de números sin saber cuál es el total. Este endpoint está construido específicamente para entender la estructura de un recibo, no solo para leer caracteres en una página.
Qué puede hacer con ella
Automatización de reportes de gastos
Un empleado fotografía un recibo de almuerzo en una aplicación móvil, y el total, la fecha y el comercio extraídos llenan la línea de gasto automáticamente.
Conciliación de caja chica
El área de finanzas procesa en lote los recibos de útiles de oficina de la semana para conciliar la caja chica sin captura manual.
Seguimiento de finanzas personales
Una aplicación de presupuesto permite fotografiar recibos de supermercado y construye un historial de gasto por categoría a partir de las líneas extraídas.
Flujos de reembolso
Una empresa de servicios de campo procesa recibos de combustible y hospedaje enviados por técnicos, alimentando los totales directamente a nómina.
Preguntas frecuentes
¿Cómo uso la API OCR Recibos?
Envíe una foto a POST /ocr/receipt, reciba de inmediato un task_id, y obtenga el JSON procesado por webhook o enlace firmado cuando la tarea termina.
¿Tiene plan gratuito?
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.
¿Cómo se cobra?
$0.010 por solicitud más $0.0575 por documento, precio publicado y plano — sin cargos ocultos por línea o por campo.
¿Qué formatos de imagen acepta?
Funcionan bien los formatos de foto estándar de una cámara de celular o un escáner; una toma clara, bien iluminada y enfocada del recibo completo da el resultado más completo.
¿Puede leer un recibo borroso o desvanecido?
Hace su mejor esfuerzo con papel térmico parcial o desvanecido, pero recibos muy deteriorados pueden devolver menos campos; conviene reintentar con una foto más clara cuando sea posible.
¿Funciona con recibos en otros idiomas o monedas?
Sí, lee recibos en idiomas y formatos de moneda comunes y devuelve los montos tal como aparecen en el documento.
¿Puedo procesar un lote de recibos a la vez?
Cada solicitud procesa un recibo y devuelve su propio task_id, así que procesar un lote es simplemente lanzar solicitudes en paralelo y recoger los resultados por webhook.
¿Se cobra si falla el procesamiento?
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/receipt \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/ocr/receipt", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ocr/receipt",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ocr/receipt", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ocr/receipt", 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
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ocr.receipt",
"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. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |