Integración con data warehouse

Documentos a tablas de Snowflake, con la evidencia incluida

Holofin lee sus PDF y escaneos y envía cada campo a una tabla de Snowflake, con su grado de certeza y el lugar de la página del que procede el valor.

Atelier Mécanique Durand SARL
FACTURE
N° F-2026-0412
Date de facture14/10/2026
Échéance13/11/2026
Total HT4 860,00 €
TVA 20 %972,00 €
Total TTC5 832,00 €
IBANFR76 3000 6000 0112 3456 7890 189

✓7 campos cargados

!1 marcados para revisión

Documento leído por Holofin y cargado en Snowflake: factura de proveedor. Es un ejemplo: todos los nombres y cifras son inventados.

Cómo funciona

  1. 1

    Conecte Snowflake 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 Snowflake 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 Snowflake como cualquier otra fuente.

Cómo escribe el conector de Snowflake

Holofin escribe con Snowpipe Streaming, así que las filas llegan en segundos sin stage, sin file format y sin un warehouse en marcha para cargarlas. Se identifica mediante autenticación por par de claves como usuario de servicio, cuyo rol solo puede insertar en un esquema y nada más.

El único permiso que necesita Holofin:

CREATE ROLE HOLOFIN_LOADER;
GRANT USAGE ON DATABASE HOLOFIN TO ROLE HOLOFIN_LOADER;
GRANT USAGE ON SCHEMA HOLOFIN.EXTRACTED TO ROLE HOLOFIN_LOADER;
GRANT INSERT, SELECT ON ALL TABLES IN SCHEMA HOLOFIN.EXTRACTED
  TO ROLE HOLOFIN_LOADER;
ALTER USER HOLOFIN_SVC SET RSA_PUBLIC_KEY = 'MIIBIjANBgkqh...';

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 Snowflake.

HOLOFIN.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 Snowflake

Las facturas que un revisor aún debe revisar, con el campo más débil de cada una, mediante QUALIFY de Snowflake:

-- Invoices with at least one field waiting for a reviewer,
-- with the weakest field of each one
SELECT document_id, field, value, confidence, loaded_at
FROM HOLOFIN.EXTRACTED.DOCUMENT_FIELDS
WHERE document_type = 'supplier_invoice'
  AND needs_review
  AND reviewed_by IS NULL
QUALIFY ROW_NUMBER() OVER (
  PARTITION BY document_id ORDER BY confidence
) = 1
ORDER BY loaded_at;

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

¿La carga consume mis créditos de Snowflake?

Snowpipe Streaming se factura como ingesta serverless, no mediante un virtual warehouse en marcha, y un documento son solo unas pocas filas. Para unos miles de documentos al mes, el coste es reducido. Las consultas posteriores usan sus warehouses como siempre.

¿Puedo usar mis propios nombres de base de datos y esquema?

Sí. La base de datos, el esquema y el nombre de la tabla se eligen al conectar. Los ejemplos de esta página usan HOLOFIN.EXTRACTED.DOCUMENT_FIELDS.

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

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 Snowflake 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