Por qué un software de contabilidad necesita su propia API de lectura
Un software de contabilidad no se limita a mostrar un documento — debe extraer exactamente los campos que componen un asiento: el tercero, la fecha, la base imponible, el tipo y la cuota de IVA, el número de documento. Una extracción genérica que devuelve texto en bruto sin estructura obliga al usuario a volver a teclear manualmente esos campos, lo que anula la mayor parte del ahorro de tiempo que promete la automatización.
En qué se diferencia de una API de gestión genérica
El motor de extracción subyacente es el mismo que el descrito en la página API para proveedores de software de gestión — esta página se centra en lo que importa específicamente para un software contable: los campos fiscales, la conciliación bancaria y el vínculo con el SII, en lugar de una visión general que también cubre nóminas o gestión de alquileres.
Los campos que espera un software de contabilidad
| Campo | Uso contable |
|---|---|
| Tercero (proveedor / cliente) | Vinculación con la cuenta de tercero correspondiente |
| Fecha del documento | Vinculación con el periodo contable correcto |
| Base imponible y total | Reparto entre la cuenta de gasto o ingreso y la cuenta de IVA |
| Tipo y cuota de IVA | Verificación de coherencia con el régimen aplicable |
| Número de documento | Referencia del asiento para la pista de auditoría |
De la factura al asiento propuesto
Una vez extraídos los campos, tu software puede proponer un asiento precumplimentado que el usuario valida o corrige, en lugar de partir de un formulario vacío. La puntuación de confianza por campo permite distinguir un asiento listo para validar con un clic de otro que merece una verificación antes de validarse.
Conciliación bancaria automática
Un extracto bancario, incluso de varias páginas, vuelve en forma de una única tabla de movimientos — lista para conciliarse automáticamente con las facturas ya registradas. El detalle de los campos de conciliación sigue el mismo formato que para cualquier software de gestión, descrito en la página reconocimiento de documentos para desarrolladores.
El vínculo con el SII
Un registro remitido al SII depende directamente de la calidad de los asientos que lo alimentan aguas arriba — un importe o una fecha mal introducidos manualmente se trasladan directamente al envío final. Unos asientos precumplimentados a partir de campos extraídos automáticamente, con una puntuación de confianza que señala los casos inciertos antes de validarse, reducen ese riesgo en origen. El detalle de los plazos y controles que exige el SII está en la página SII: suministro inmediato de información.
El caso de los software usados por asesorías
Un software usado por una asesoría procesa los documentos de muchos clientes distintos, cada uno con sus propios proveedores y bancos — exactamente el escenario donde más importa la generalización a formatos nunca vistos. Un motor entrenado sobre un volumen agregado de muchos clientes distintos generaliza mejor que un modelo interno construido sobre el historial de una sola asesoría.
Reconocimiento de los tipos de IVA impresos
El tipo de IVA impreso en la factura se extrae tal cual —21 %, 10 % o 4 % según los casos españoles más habituales— junto con la cuota correspondiente. La validación de la coherencia entre ese tipo y el régimen de IVA aplicable al tercero en cuestión sigue siendo una verificación de negocio, pero parte de un dato ya leído correctamente en lugar de una reintroducción manual propensa a errores de tecleo.
Tarificación por página
| Tipo de documento | Facturación |
|---|---|
| Factura de proveedor (1 página) | 1 página facturada |
| Extracto bancario (varias páginas) | Facturado por página efectivamente procesada |
| Documento con fallo de extracción | No se factura |
El detalle completo de los tramos está en la página de precios.
RGPD y alojamiento en la Unión Europea
Los datos contables están entre los más sensibles que maneja un software. Cada documento viaja en TLS, se procesa en servidores situados en la Unión Europea, y se elimina inmediatamente tras la extracción — el detalle completo está en la página de seguridad.
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.
Construir o integrar, específicamente para contabilidad
Construir internamente
Un modelo entrenado sobre una muestra limitada de facturas y extractos, con riesgo de generalizar mal sobre los formatos bancarios menos habituales.
Integrar la API
Un motor ya expuesto a un volumen mucho más amplio de formatos de facturas y bancos, disponible en pocos días de integración.
Un ejemplo con cifras del lado de una asesoría
Una asesoría gestiona 60 expedientes de clientes, cada uno subiendo una media de 25 facturas y 2 extractos bancarios al mes. El volumen mensual —unas 1.500 facturas y 120 extractos— representa un coste por página previsible, frente a las horas de introducción manual equivalentes que un colaborador dedicaría de otro modo cada mes a esa misma tarea.
| Partida | Valor |
|---|---|
| Expedientes de clientes gestionados | 60 |
| Facturas por expediente y mes | 25 |
| Extractos bancarios por expediente y mes | 2 |
| Volumen mensual total de documentos | ≈ 1.620 |
Sustituir un módulo existente
Un software de contabilidad que ya usa un motor de extracción —interno o de otro proveedor— puede hacer funcionar el sistema antiguo y el nuevo en paralelo sobre una muestra de facturas reales antes de cambiar por completo, sin interrupción para las asesorías ya en producción.
Lo que esta API no hace por ti
No genera el envío final al SII
Proporciona datos de asientos fiables por adelantado; el propio envío sigue siendo una funcionalidad de tu software.
No valida el cumplimiento fiscal de una factura
La calificación contable y fiscal sigue siendo, como hoy, competencia del profesional que usa tu software.
No sustituye la revisión de un asesor fiscal
La puntuación de confianza guía la verificación humana, no la elimina para los casos realmente ambiguos.
Comparado con un simple conector bancario
Un conector bancario (agregación vía PSD2) sincroniza directamente los movimientos de una cuenta sin pasar por un documento — práctico cuando el cliente autoriza ese acceso, pero insuficiente para los casos en que solo hay disponible un PDF de extracto, cuando el cliente no quiere conectar su cuenta, o para documentos que no son movimientos bancarios, como una factura de proveedor o un ticket de gastos. Una API de reconocimiento de documentos y un conector bancario no son competidores sino complementarios: el segundo cubre el acceso directo a la cuenta, la primera cubre todo lo que llega en forma de documento.
Muchos software de contabilidad ofrecen además ambos en paralelo, dejando que el cliente elija según su situación — un profesional que se niega a conectar su cuenta bancaria, por desconfianza o por una limitación de su propio banco, sigue cubierto mediante la subida manual de extractos en PDF leídos automáticamente.
Caso de uso: importación masiva al inicio de un encargo
Una asesoría que retoma un nuevo expediente de cliente suele heredar un histórico de varios meses, a veces años, de facturas y extractos nunca introducidos informáticamente. En lugar de volver a teclear ese histórico manualmente para reconstruir una contabilidad utilizable, todo el conjunto de documentos puede subirse de una vez, con una notificación por webhook a medida que cada documento se procesa, para reconstruir rápidamente una base de asientos fiable.
Cómo evaluar la calidad antes de comprometerte
El método más fiable no consiste en leer una promesa de exactitud en una página comercial, sino en enviar un lote de tus propias facturas y extractos reales —incluidos los casos menos cuidados, escaneos torcidos o fotos imperfectas— y comparar los campos obtenidos con lo que ya sabes que es correcto. Una cuenta gratuita basta para esta evaluación, sin ningún compromiso previo.
Presta especial atención a los casos límite en lugar de a los documentos más limpios de tu muestra — es en esos casos donde se juega la diferencia real entre un motor de extracción y otro, no en una factura ya perfectamente legible que cualquier motor procesa correctamente.
El caso del software de caja y pequeño comercio
Un software de caja que genera sus propios tickets normalmente no necesita extracción sobre sus propios documentos — pero en cuanto debe leer las facturas de los proveedores de un comerciante para alimentar su contabilidad de compras, se aplica la misma necesidad de reconocimiento de documentos no estructurados. Los comercios que procesan un gran número de pequeñas facturas de proveedores —hostelería, comercio minorista— son un caso de uso especialmente representativo del ahorro de tiempo que aporta una extracción automatizada frente a una introducción línea a línea.
El volumen de documentos en este segmento suele ser alto pero cada documento individualmente sencillo — un contexto favorable para una tarifa por página que sigue siendo previsible incluso cuando el número de pequeñas facturas se dispara en temporada alta, sin que ningún escalón contractual rompa esa previsibilidad.
El caso particular del inmovilizado
Una factura de inmovilizado —equipo informático, mobiliario, vehículo profesional— requiere un tratamiento contable distinto de un gasto corriente: debe identificarse como tal, con su fecha de adquisición y su base imponible sirviendo de referencia para el cálculo de la amortización. La extracción proporciona esos mismos campos base (tercero, fecha, base imponible) que una factura de gasto corriente; es el software de contabilidad quien decide, según su propia lógica de negocio o una cuenta de proveedor habitual, si la factura corresponde a un inmovilizado en lugar de a un gasto.
Algunos proveedores optan por exponer un indicador configurable por cuenta de proveedor habitual — un proveedor de equipos informáticos que dispara sistemáticamente una propuesta de inmovilizado en lugar de un asiento de gasto— construido enteramente de su lado a partir de los campos extraídos, sin lógica adicional necesaria en la API.
El umbral de importe por debajo del cual un gasto sigue siendo corriente, incluso en un proveedor habitualmente asociado al inmovilizado, también depende de una regla propia de cada asesoría o empresa — la extracción proporciona el importe exacto, quedando la decisión del umbral enteramente de tu lado.
Software multiempresa y consolidación
Un software de contabilidad que gestiona varias empresas o varias sociedades de un mismo grupo procesa documentos cuyo tercero emisor o destinatario varía de una empresa a otra. Cada documento se extrae de forma independiente; la vinculación a la empresa correcta suele hacerse del lado de tu software, a partir del contexto de subida (qué usuario, en qué espacio de trabajo) en lugar de deducirse automáticamente del propio contenido del documento.
Para una asesoría que consolida varias entidades, este mismo mecanismo se aplica expediente a expediente — cada sociedad conservando sus propios documentos y asientos, con una consolidación que interviene después, una vez validados individualmente los asientos de cada entidad.
Facturas recurrentes y proveedores habituales
Un gasto recurrente —alquiler del local, cuota del software de gestión, suministros domiciliados— llega cada mes en un formato casi idéntico al del mes anterior, emitido por el mismo proveedor. La API no memoriza plantillas por proveedor: cada factura se lee de forma independiente, campo a campo, con lo que un cambio de maquetación del proveedor —un nuevo logotipo, una columna añadida— no rompe nada de tu lado, al contrario de lo que ocurre con un sistema basado en zonas fijas de página que exige volver a calibrar la plantilla cada vez que un proveedor cambia su diseño.
Esa independencia de formato tiene una consecuencia práctica para tu software: puedes construir tu propio catálogo de proveedores habituales —con su cuenta contable asociada, su condición de IVA, su calificación como inmovilizado o gasto corriente— enteramente de tu lado, usando el nombre del tercero devuelto por la API como clave de coincidencia, sin depender de ninguna configuración adicional en el motor de extracción. Cuando aparece un tercero nuevo, tu software puede sugerir al usuario que lo añada al catálogo la primera vez, y aplicar automáticamente esa misma regla en las facturas siguientes del mismo proveedor.
Disponibilidad y soporte técnico
Un módulo contable que depende de una API externa necesita saber qué esperar cuando algo falla del lado del proveedor, no solo cuando la petición tiene éxito. Cada respuesta de la API incluye un estado explícito por documento —procesado, en cola, fallido— en lugar de dejar tu software adivinando a partir de un simple código HTTP genérico; un fallo puntual de un documento concreto nunca bloquea el resto del lote en curso.
Para una integración en producción usada por una asesoría o un editor de software, ese comportamiento importa más que la exactitud media anunciada: una asesoría que sube el histórico de un cliente nuevo necesita saber, documento por documento, cuáles requieren revisión manual, no un porcentaje agregado que no ayuda a decidir qué mirar primero. El soporte técnico responde directamente a preguntas de integración durante la fase de prueba, antes de cualquier compromiso contractual.
