Integración con data warehouse

Documentos a PostgreSQL, en la base de datos que ya utiliza

Holofin lee PDF y escaneos y escribe cada campo en una tabla de Postgres, junto a los datos de su aplicación. Sin necesidad de data warehouse.

Banca Esempio S.p.A.
COORDINATE BANCARIE
Filiale di Torino Centro
IntestatarioStudio Ferri e Associati S.r.l.
IBANIT60 X054 2811 1010 0000 0123 456
BIC / SWIFTBESPITTMXXX
ValutaEUR

✓5 campos cargados

!1 marcados para revisión

Documento leído por Holofin y cargado en PostgreSQL: certificado de titularidad bancaria. Es un ejemplo: todos los nombres y cifras son inventados.

Cómo funciona

  1. 1

    Conecte PostgreSQL una sola vez

    Cree un rol con permisos de inserción en un único esquema y pegue sus credenciales en Holofin. Holofin crea la tabla en la primera carga; nada más en PostgreSQL le resulta visible.

  2. 2

    Envíe los documentos como ya lo hace

    Súbalos en la aplicación, reenvíelos por correo electrónico o envíelos a la API. Holofin clasifica cada archivo, separa los lotes en documentos y lee los campos de cada tipo.

  3. 3

    Consulte las filas

    Cada campo llega como una fila con su confianza, la página de la que procede y un indicador needs_review. Crúcelo con sus propias tablas en PostgreSQL como cualquier otra fuente.

Cómo escribe el conector de PostgreSQL

Holofin se conecta por TLS y escribe con COPY en lotes pequeños. Funciona con cualquier PostgreSQL 13 o posterior: servidores propios, Amazon RDS y Aurora, Google Cloud SQL, Azure Database, Supabase o Neon. Su rol solo puede insertar en una tabla y nada más.

El único permiso que necesita Holofin:

CREATE ROLE holofin_loader LOGIN PASSWORD '...';
GRANT USAGE ON SCHEMA extracted TO holofin_loader;
GRANT INSERT, SELECT ON extracted.document_fields TO holofin_loader;

La tabla que escribe Holofin

Una fila por campo, de modo que un nuevo tipo de documento nunca cambia la tabla. Las columnas son las mismas en todas las plataformas; los tipos siguen la nomenclatura de PostgreSQL.

extracted.document_fields
document_idSTRINGIdentificador del documento en Holofin, estable entre recargas.
document_typeSTRINGLa clase que Holofin asignó al documento: supplier_invoice, payslip, bank_statement, etc.
fieldSTRINGEl nombre del campo, en snake_case, tal como se define en su esquema de extracción.
valueSTRINGEl valor como texto normalizado: fechas ISO, punto decimal, IBAN sin espacios.
confidenceFLOATEntre 0 y 1. El grado de certeza de Holofin sobre el valor.
pageINTEGERLa página del archivo de origen en la que se leyó el valor.
bboxARRAY<FLOAT>La posición en esa página: x, y, ancho, alto, como fracciones de la página.
needs_reviewBOOLEANTrue cuando la confianza es baja o falla una regla, como un saldo que no cuadra.
reviewed_bySTRINGQuién confirmó o corrigió el valor en Holofin, una vez revisado.
loaded_atTIMESTAMPCuándo se escribió la fila. Las correcciones escriben una fila nueva; prevalece la más reciente.

Consultar en PostgreSQL

Datos bancarios pendientes de revisión, una línea por expediente de cliente, con FILTER y bool_or:

-- Bank details still waiting for a reviewer, per client file
SELECT
  document_id,
  max(value) FILTER (WHERE field = 'iban') AS iban,
  bool_or(needs_review AND reviewed_by IS NULL) AS pending_review
FROM extracted.document_fields
WHERE document_type = 'bank_details'
GROUP BY document_id
HAVING bool_or(needs_review AND reviewed_by IS NULL)
ORDER BY document_id;

Seguridad

  • Los documentos se procesan en Europa, en servidores de OVHcloud en Francia con certificación ISO 27001.
  • Holofin solo escribe en el esquema que usted autoriza. No puede leer el resto de sus tablas.
  • La conservación de los archivos de origen en Holofin se configura por organización, desde cero retención de datos hasta conservación indefinida. Las filas de su data warehouse siguen sus propias políticas.
  • RGPD: Holofin actúa como encargado del tratamiento. Ningún documento sale de la Unión Europea.

Preguntas frecuentes

¿Puede la aplicación reaccionar cuando se carga un documento?

Sí. Con un trigger en la tabla, o con LISTEN sobre un canal que notifique el trigger, la aplicación ve cada campo en el momento en que se escribe.

¿Se comprueba el IBAN antes de cargarlo?

Holofin comprueba los dígitos de control del IBAN. Un valor que no los supera se carga con needs_review a true, para que nadie pague a una cuenta mal leída.

¿Cuánto tardan los campos en aparecer en PostgreSQL?

Unos segundos desde que se lee el documento. La mayoría de los documentos se leen en menos de un minuto, así que un archivo enviado por correo suele poder consultarse en PostgreSQL un minuto después.

¿Qué ocurre cuando un revisor corrige un valor?

Holofin escribe una fila nueva para ese campo con el valor corregido, needs_review a false y reviewed_by informado. Conserve la última fila por documento y campo para obtener el estado actual, o todas las filas para disponer de una pista de auditoría completa.

¿Se puede elegir qué campos se cargan?

Sí. Cada tipo de documento tiene un esquema de extracción en Holofin. Añada, renombre o elimine campos ahí y los siguientes documentos se cargarán con los nuevos nombres. La estructura de la tabla no cambia.

¿Qué documentos lee Holofin?

Cualquier documento empresarial enviado en PDF, escaneado o como foto: facturas, nóminas, extractos bancarios, notificaciones tributarias, extractos registrales, documentos de identidad, certificados. Holofin también comprueba si cada archivo ha sido manipulado y puede señalar un documento sospechoso antes de dar por buenos sus campos.

Pruebe Holofin con sus propios documentos.

Cada valor vinculado a la página de la que procede, cada PDF revisado contra manipulaciones, reglas comprobadas en todo el expediente.

Holofin