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.
| field | value | confidence | page | needs_review | |
|---|---|---|---|---|---|
| 1 | bank_name | Banca Esempio S.p.A. | 0.99 | 1 | false |
| 2 | account_holder | Studio Ferri e Associati S.r.l. | 0.74 | 1 | true |
| 3 | iban | IT60X0542811101000000123456 | 0.99 | 1 | false |
| 4 | bic | BESPITTMXXX | 0.97 | 1 | false |
| 5 | currency | EUR | 0.99 | 1 | false |
✓5 fields loaded
!1 flagged for review
How it works
- 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
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
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.
| document_id | STRING | Holofin's identifier for the document, stable across reloads. |
|---|---|---|
| document_type | STRING | The class Holofin gave the document: supplier_invoice, payslip, bank_statement, and so on. |
| field | STRING | The field name, in snake_case, as defined in your extraction schema. |
| value | STRING | The value as normalized text: ISO dates, dot decimals, IBANs without spaces. |
| confidence | FLOAT | Between 0 and 1. How sure Holofin is of the value. |
| page | INTEGER | The page of the source file the value was read on. |
| bbox | ARRAY<FLOAT> | Where on that page: x, y, width, height, as fractions of the page. |
| needs_review | BOOLEAN | True when the confidence is low or a rule failed, such as a balance that does not add up. |
| reviewed_by | STRING | Who confirmed or corrected the value in Holofin, once someone has. |
| loaded_at | TIMESTAMP | When 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.