Data warehouse integration

Documents to PostgreSQL, in the database you already run

Holofin reads PDFs and scans and writes every field into a Postgres table, next to your application data. No warehouse needed.

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 fields loaded

!1 flagged for review

A bank details letter read by Holofin and loaded into PostgreSQL. Sample document; every name and number on it is invented.

How it works

  1. 1

    Connect PostgreSQL once

    Create a role with insert rights on one schema and paste its credentials into Holofin. Holofin creates the table on the first load; nothing else in PostgreSQL is visible to it.

  2. 2

    Send documents the way you already do

    Upload in the app, forward by email, or post to the API. Holofin classifies each file, splits bundles into documents and reads the fields of each type.

  3. 3

    Query the rows

    Each field lands as one row with its confidence, the page it came from and a needs_review flag. Join it to your own tables in PostgreSQL like any other source.

How the PostgreSQL connector writes

Holofin connects over TLS and writes with COPY in small batches. It works with any PostgreSQL 13 or later: your own servers, Amazon RDS and Aurora, Google Cloud SQL, Azure Database, Supabase or Neon. Its role can insert into one table and nothing else.

The only grant Holofin needs:

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

The table Holofin writes

One row per field, so a new document type never changes the table. The same columns exist in every warehouse; types follow PostgreSQL's own names.

extracted.document_fields
document_idSTRINGHolofin's identifier for the document, stable across reloads.
document_typeSTRINGThe class Holofin gave the document: supplier_invoice, payslip, bank_statement, and so on.
fieldSTRINGThe field name, in snake_case, as defined in your extraction schema.
valueSTRINGThe value as normalized text: ISO dates, dot decimals, IBANs without spaces.
confidenceFLOATBetween 0 and 1. How sure Holofin is of the value.
pageINTEGERThe page of the source file the value was read on.
bboxARRAY<FLOAT>Where on that page: x, y, width, height, as fractions of the page.
needs_reviewBOOLEANTrue when the confidence is low or a rule failed, such as a balance that does not add up.
reviewed_bySTRINGWho confirmed or corrected the value in Holofin, once someone has.
loaded_atTIMESTAMPWhen the row was written. Corrections write a new row; the latest wins.

Query it in PostgreSQL

Bank details still waiting for a reviewer, one line per client file, with FILTER and 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;

Security

  • Documents are processed in Europe, on OVHcloud servers in France certified ISO 27001.
  • Holofin only ever writes to the schema you grant. It cannot read your other tables.
  • Retention of the source files in Holofin is set per organization, from zero data retention to indefinite. Rows in your warehouse follow your own policies.
  • GDPR: Holofin acts as your processor. No document leaves the European Union.

Frequently asked questions

Can my application react when a document is loaded?

Yes. Add a trigger on the table, or LISTEN to a channel the trigger notifies, and your application sees each field the moment it is written.

Is the IBAN checked before it is loaded?

Holofin checks the IBAN's check digits. A value that fails is loaded with needs_review set to true so nobody pays to a misread account.

How quickly do fields appear in PostgreSQL?

Within seconds of the document being read. Most documents are read in under a minute, so a file sent by email is usually queryable in PostgreSQL a minute later.

What happens when a reviewer corrects a value?

Holofin writes a new row for that field with the corrected value, needs_review set to false and reviewed_by filled in. Keep the latest row per document and field to get the current state, or keep every row for a full audit trail.

Can I choose which fields are loaded?

Yes. Each document type has an extraction schema in Holofin. Add, rename or remove fields there and the next documents load with the new names. Nothing in the table structure changes.

Which documents does Holofin read?

Any business document sent as a PDF, a scan or a photo: invoices, payslips, bank statements, tax notices, company extracts, IDs, certificates. Holofin also checks each file for tampering and can flag a suspicious document before its fields are trusted.

Put Holofin on your own documents.

Every value linked to the page it came from, every PDF checked for tampering, rules checked across the whole file.

Holofin