Construir o integrar: la pregunta que todo proveedor acaba haciéndose
En algún momento de la vida de un software de gestión, un cliente pide poder subir una factura en PDF en lugar de teclearla de nuevo. Después otro pide lo mismo para un extracto bancario. Luego para un ticket fotografiado con el móvil. Cada petición, tomada por separado, parece una pequeña funcionalidad más — hasta que el equipo técnico se da cuenta de que leer correctamente un documento financiero real, con sus tipografías variables, sus tablas mal alineadas y sus fotos torcidas, es un problema de ingeniería en toda regla, no una casilla que marcar en un sprint.
Esta página describe cómo una API de reconocimiento de documentos se integra en un software de gestión existente — qué lee, qué devuelve, cuánto cuesta por página, y por qué el alojamiento de los datos en la Unión Europea no es un detalle secundario cuando tus propios clientes son empresas españolas o europeas sujetas al RGPD.
A quién se dirige esta API
Proveedores de software de contabilidad
Lectura de facturas de proveedores y extractos bancarios para precumplimentar asientos antes de la validación del usuario.
Proveedores de ERP y software de gestión empresarial
Un módulo de digitalización de documentos integrado, sin construir un equipo de OCR interno dedicado.
Proveedores de software de gastos
Tickets fotografiados con el móvil transformados en líneas de gasto estructuradas: importe, fecha, categoría.
Proveedores de gestión de alquileres e inmobiliaria
Recibos, extractos de cuentas de fianza y justificantes de gastos leídos automáticamente.
Proveedores de software de nóminas
Nóminas y justificantes de la seguridad social extraídos para la conciliación con la contabilidad general.
Despachos y grandes empresas con herramienta interna
Un software de gestión interno, no revendido, con exactamente la misma necesidad de lectura de documentos que un producto SaaS comercializado.
Por qué construir tu propio OCR cuesta más de lo que parece
Un primer prototipo de lectura de facturas, sobre un conjunto de documentos limpios y bien escaneados, se puede construir en pocas semanas con librerías de OCR de código abierto. El problema casi nunca es ese primer prototipo — es lo que viene después: un extracto bancario de un banco nunca visto, una factura parcialmente manuscrita, un ticket de caja arrugado y fotografiado a contraluz. Cada formato real nuevo que llega a producción revela un caso que el prototipo no cubría, y el equipo que iba a dedicar tres semanas a ese módulo se encuentra dieciocho meses después todavía dentro de él.
La variedad de documentos reales no tiene fin
Cada banco tiene su propio formato de extracto, cada proveedor su propia maquetación de factura — un modelo entrenado sobre una muestra finita se topa constantemente con casos que nunca ha visto.
El mantenimiento nunca termina
Un formato que cambia por parte de un proveedor, o un banco nuevo añadido por un cliente, rompe silenciosamente la extracción hasta que alguien lo detecta y corrige el modelo.
Contratar un equipo dedicado es una inversión considerable
Una competencia en visión por computador y procesamiento de lenguaje es difícil de contratar y se paga en consecuencia, para un producto que no es el núcleo del negocio del proveedor.
La infraestructura de procesamiento tiene un coste fijo
Servidores de cálculo, colas de trabajo, supervisión — una infraestructura que mantener y vigilar continuamente, incluso en los meses en que el volumen de documentos es bajo.
Qué reconoce la API
| Tipo de documento | Caso de uso típico |
|---|---|
| Factura de proveedor | Precumplimentado de asientos contables y conciliación con el pedido |
| Extracto bancario | Conciliación bancaria automática y seguimiento de tesorería |
| Ticket / nota de gastos | Línea de gasto estructurada, importe, fecha, categoría, IVA impreso |
| Nómina | Conciliación con los asientos de nómina y la seguridad social |
| Albarán | Control de conformidad entre pedido, entrega y factura |
Qué devuelve la API
Cada documento enviado vuelve en forma de objeto JSON estructurado: los campos de cabecera (emisor, fecha, número de documento, importe total, IVA), las líneas de detalle cuando el documento las contiene (referencia, cantidad, precio unitario), y una puntuación de confianza por campo, no solo para el documento en su conjunto. Es esa puntuación la que permite a tu software decidir automáticamente qué campos aceptar tal cual y cuáles señalar a un usuario para confirmación, en lugar de tratar cada extracción como cierta al 100 %.
Tarificación por página
La tarifa se fija por página procesada con éxito — un documento que falla en la extracción nunca se factura. Sin escalón contractual obligatorio de entrada, sin mínimo mensual impuesto: el coste sigue directamente el volumen real que procesa tu software, lo que hace que el cálculo de margen sea sencillo de integrar en tu propia tabla de precios.
| Volumen mensual | Qué representa |
|---|---|
| Unos pocos cientos de páginas | Un primer piloto con uno o dos clientes para validar la integración |
| Unos pocos miles de páginas | Un módulo activado para parte de tu base de clientes |
| Decenas de miles de páginas o más | Una funcionalidad desplegada a toda tu base, con tarifa decreciente por volumen |
El detalle completo de los tramos está en la página de precios.
Cómo funciona la integración
Crea una clave API
Una cuenta gratuita basta para obtener una clave y empezar a probar con documentos reales.
Envía un documento
PDF, foto o escaneo — una llamada a la API basta para iniciar la extracción.
Recibe el JSON estructurado
Campos, líneas de detalle y puntuaciones de confianza vuelven en segundos.
Decide el umbral de confianza
Acepta automáticamente por encima de un umbral, señala para revisión humana por debajo.
El detalle paso a paso de una integración completa, con la gestión de casos inciertos y la supervisión en producción, está en la guía de integración.
Marca blanca: tu software, no el nuestro
La integración se hace enteramente del lado del servidor. Tu usuario final sube un documento en tu propia interfaz, y ve el resultado aparecer en tu propio software — sin encontrarse jamás con una pantalla, un logotipo o una mención a FlowParse. Es tu marca la que sostiene la funcionalidad, no la nuestra — el mismo principio de marca blanca que se detalla en la página API para proveedores de software de gestión españoles.
RGPD y alojamiento en la Unión Europea
Para un proveedor que vende a empresas españolas o europeas, la ubicación de los servidores no es un detalle técnico secundario — a menudo es una pregunta explícita en un concurso público o en una revisión de seguridad de un gran cliente. Los documentos viajan cifrados en TLS, se procesan en servidores situados en la Unión Europea, y se eliminan inmediatamente tras la extracción — sin conservación prolongada del documento original, sin entrenar ningún modelo con tus datos de clientes.
Transmisión cifrada de extremo a extremo en TLS.
Procesamiento exclusivamente en servidores situados en la Unión Europea.
Eliminación del documento original inmediatamente tras la lectura.
Ningún dato de cliente se usa para entrenar modelos de IA.
El detalle completo está en la página de seguridad.
El contexto del SII y Verifactu
El Suministro Inmediato de Información obliga a un colectivo creciente de empresas a remitir el detalle de sus facturas a la Agencia Tributaria en un plazo de cuatro días hábiles, y Verifactu añade requisitos propios sobre cómo debe comportarse el software de facturación. Ninguno de los dos elimina la necesidad de lectura automática de documentos: las facturas que llegan en PDF de un proveedor, los extractos bancarios y los tickets de gastos siguen siendo documentos no estructurados que un software de gestión debe leer antes de que esos datos puedan alimentar el registro del SII o el sistema de facturación verificable. El detalle de ambas obligaciones está cubierto en nuestra página sobre el SII y en la página sobre Verifactu.
Para un proveedor de software de gestión, esto significa que una capacidad de lectura de documentos no estructurados sigue siendo necesaria incluso una vez generalizadas estas obligaciones — no todos los documentos que un cliente sube son, ni serán nunca, facturas ya estructuradas en un formato electrónico.
Según el tipo de software de gestión
| Tipo de software | Qué aporta la API |
|---|---|
| Software de contabilidad | Precumplimentado de asientos a partir de facturas y extractos bancarios |
| ERP / gestión comercial | Conciliación automática entre albaranes, pedidos y facturas |
| Gastos | Tickets fotografiados convertidos en líneas de gasto en segundos |
| Gestión de alquileres | Recibos y extractos de cuenta de fianza leídos sin volver a teclear nada |
| Nóminas | Nóminas y justificantes conciliados con la contabilidad general |
El detalle específico para proveedores de software de contabilidad, con el enfoque de plan contable e IVA, se trata en la página API para software de contabilidad.
Construir contra integrar: el cálculo completo
Construir internamente
Contratación de una competencia en visión por computador, infraestructura de cálculo que mantener, actualización continua frente a nuevos formatos de documentos, varios meses hasta tener un primer módulo utilizable en producción.
Integrar una API
Una tarifa por página que sigue el uso real, una integración de una a tres semanas, y un equipo de visión por computador que nunca necesita existir en tu organigrama.
Fiabilidad, exactitud y casos ambiguos
Ninguna extracción automática es certera al 100 % sobre el conjunto de documentos reales que un cliente puede subir — un ticket descolorido, una foto tomada con mala luz siguen siendo casos límite para cualquier motor. La diferencia no está en prometer una exactitud perfecta, sino en lo que ocurre cuando la extracción es incierta: una puntuación de confianza por campo, no solo global, permite a tu software enrutar automáticamente los casos ambiguos hacia una verificación humana en lugar de integrarlos silenciosamente en tus datos.
Un ejemplo con cifras
Un proveedor de software de notas de gastos tiene 200 clientes activos, cada uno subiendo una media de 40 tickets al mes — unos 8.000 documentos mensuales. Con la tarifa por página, ese volumen supone un coste de integración previsible, directamente repercutible en tu propia tabla de precios por usuario, sin los costes fijos de un equipo interno que se mantendrían idénticos aunque el volumen se duplique o se reduzca a la mitad.
| Partida | Valor |
|---|---|
| Clientes activos | 200 |
| Tickets por cliente y mes | 40 |
| Volumen mensual total | 8.000 documentos |
| Equipo interno equivalente a mantener | 1 a 2 ingenieros a tiempo completo |
Seguridad y disponibilidad
Una API integrada en un software de gestión de producción debe ser tan disponible y predecible como cualquier otro servicio del que dependa tu propio producto. Cifrado en tránsito, eliminación sistemática de los documentos tras el procesamiento, y un comportamiento definido ante una indisponibilidad breve —el documento queda en cola en lugar de bloquear al usuario— forman parte de la integración desde el principio, no de un parche añadido tras un primer incidente.
Sustituir un OCR existente sin reescribirlo todo
Un proveedor que ya usa un motor de extracción —interno o de otro proveedor— no necesita reescribir todo el módulo para migrar. La práctica más habitual consiste en hacer funcionar el sistema antiguo y el nuevo en paralelo sobre una muestra de documentos reales, comparar los campos extraídos, y después trasladar progresivamente el tráfico una vez confirmada favorablemente la diferencia de calidad — sin interrupción de servicio para los clientes ya en producción.
Lo que esta API no hace por ti
No sustituye tu lógica de negocio
La conciliación contable, el cálculo del IVA aplicable y la generación de asientos siguen siendo lógica de tu propio software.
No diseña tu interfaz de usuario
La pantalla de subida de documentos y la pantalla de validación de campos extraídos siguen por construir en tu propio producto.
No decide tus umbrales de confianza
Es tu software quien define, según tu tolerancia al riesgo, qué puntuaciones activan una verificación humana.
No sustituye a un asesor fiscal para tus clientes finales
Transforma un documento en datos estructurados; la calificación contable o fiscal de esos datos sigue siendo, como hoy, una cuestión de negocio.
Para quién está pensada
Esta API se dirige a equipos técnicos de proveedores de software de gestión que prefieren dedicar su tiempo de ingeniería a su propio producto en lugar de a un motor de lectura de documentos que, para la mayoría de ellos, no es su negocio principal. El detalle de escenarios concretos, con ejemplos cifrados por situación, se desarrolla en el caso de uso API para proveedores de software de gestión españoles.
Soporte y acompañamiento en la integración
Una clave API entregada sin acompañamiento deja al equipo técnico solo frente a las primeras preguntas concretas: cómo mapear tal campo, qué hacer con un caso límite encontrado en un documento real. El equipo de soporte responde en español, directamente sobre las preguntas de integración, sin pasar por un centro de asistencia genérico que no conoce el detalle del motor de extracción.
Para una integración de alto impacto —un gran cliente, una migración desde un proveedor existente— se puede organizar un acompañamiento más profundo directamente con el equipo técnico, en lugar de dejar que un equipo cliente adivine por su cuenta el comportamiento esperado en sus casos particulares.
Precisión, límites y mejora continua
Ningún motor de extracción alcanza una exactitud perfecta sobre el conjunto de documentos reales que un cliente puede subir — la pregunta pertinente no es prometer el 100 %, sino saber con precisión dónde están los límites y cómo se gestionan. Una puntuación de confianza por campo, en lugar de una promesa global, permite que tu integración distinga un resultado fiable de uno que merece una mirada humana, algo que en la práctica importa más que un porcentaje de exactitud mostrado en una página comercial.
El motor sigue además mejorando con el volumen procesado — un nuevo formato de documento encontrado en un cliente, una vez tratado correctamente, beneficia al conjunto de integraciones que usan la misma API, sin que ningún cliente individual tenga que señalar explícitamente el problema para que la calidad mejore globalmente.
Lo que evoluciona con el tiempo
Un esquema de respuesta versionado garantiza que una evolución del motor de extracción nunca altera silenciosamente una integración ya en producción — se puede añadir un nuevo campo a la respuesta sin romper el código existente que aún no lo espera. Es una garantía estructural, no una simple promesa, que importa especialmente para un proveedor cuyo software permanece años en producción sin una reescritura completa.
Los nuevos tipos de documentos soportados —un formato de nómina menos habitual, un extracto de un neobanco reciente— se añaden progresivamente al motor sin ninguna gestión particular de tu lado: la misma llamada a la API se beneficia automáticamente de esa cobertura ampliada.