API italiana per estratti conto PDF

In arrivo per studi e aziende che vogliono integrare conversioni, export JSON e flussi batch nei propri gestionali. Stesse 23 banche del web, stesso pricing a crediti, server in Unione Europea.

Scrivi per accesso anticipato Vedi i prezzi

Come è progettata l'API

Chiavi API cifrate

Le chiavi vengono cifrate al momento della creazione (AES-256). Possono essere rinominate, revocate e limitate a singoli endpoint. La chiave viene mostrata in chiaro una sola volta, alla creazione: nessun recupero successivo.

Limiti per chiave

Ogni chiave ha un proprio rate limit (default 60 richieste/minuto, 1000/giorno). Trasparente, documentato, modificabile su richiesta per piani business. Header standard X-RateLimit-Remaining.

Audit log e crediti

Ogni chiamata viene tracciata senza dati personali nei log (no IBAN, no importi, no descrizioni). I crediti vengono scalati solo al termine della conversione: se l'API risponde 5xx, nessun addebito.

Endpoint principali

Documentazione OpenAPI 3.1 fornita con la chiave di accesso anticipato.

POST/v1/conversions: Carica un PDF estratto conto e ricevi un job_id. Il response include una stima del costo crediti basata sul numero di pagine rilevate.
GET/v1/conversions/{job_id}: Recupera lo stato della conversione: queued, processing, completed, failed. Quando completed, include i link firmati al file Excel/CSV (validi 60 minuti).
GET/v1/conversions/{job_id}/rows: Esporta i movimenti come JSON strutturato: data operazione, data valuta, descrizione, entrate, uscite, saldo, confidenza per riga. Utile per integrazioni gestionali.
GET/v1/credits: Restituisce il saldo crediti residuo, il pacchetto attivo e la data di scadenza. Per i piani a consumo i crediti non scadono entro 12 mesi dall'acquisto.

Domande frequenti sull'API

L'API è già disponibile?

L'accesso anticipato è in corso per studi e aziende su richiesta tramite il modulo contatti. La documentazione OpenAPI 3.1 viene rilasciata insieme alla chiave. La GA pubblica è prevista nel 2026.

Quanto costa una chiamata API?

Stesso pricing del web: 1 pagina di PDF testuale = 1 credito, 1 pagina con scansione (OCR) = 2 crediti. Nessun costo per chiamata: paghi solo le pagine effettivamente convertite. Le chiamate GET (status, credits) sono gratuite.

Quali formati restituisce l'API?

Excel (.xlsx), CSV (UTF-8, separatore punto e virgola, virgola decimale) e JSON strutturato per integrazione diretta nei gestionali. Lo schema JSON segue il pattern standard: array di righe con campi tipizzati e score di confidenza per ogni riga.

Dove vengono elaborati i dati?

Server e storage in Unione Europea (region eu-central-1). Nessun trasferimento extra-UE per i contenuti dei movimenti. I PDF caricati via API vengono cancellati entro 60 minuti, come dal web. DPA disponibile per studi e aziende clienti API.

L'API supporta tutte le 23 banche del web?

Sì. L'API condivide gli stessi parser dedicati (Intesa Sanpaolo, UniCredit, BancoPosta, Fineco, BPER, BNL, MPS, Banco BPM, Mediolanum, Credit Agricole, Credem, ING, Sella, Revolut, N26, Wise, Hype, Satispay, Trade Republic, Vivid Money, buddybank e altre) e la stessa strategia generica per banche non ancora coperte.

Posso integrare l'API in TeamSystem, Zucchetti o altri gestionali?

Sì. L'export JSON è pensato proprio per integrazioni gestionali: ogni riga porta data contabile, data valuta, descrizione, entrate, uscite, saldo e una colonna confidence (0-1) per filtrare le righe da revisionare manualmente prima dell'import.

Risorse correlate

Esplora il servizio.

Banche supportate

23 parser dedicati per PDF bancari italiani e fintech.

Per commercialisti

Multi-cliente, batch, audit log e template contabili.

Sicurezza e privacy

File cancellati entro 60 minuti. Server EU, GDPR-first.

Guide pratiche

Come scaricare il PDF da Intesa, Fineco, Revolut e altre.

Prezzi e crediti

Gratis per iniziare. Piani a consumo senza abbonamento.

Caricamento…

Come è progettata l'API

Chiavi API cifrate

Limiti per chiave

Ogni chiave ha un proprio rate limit (default 60 richieste/minuto, 1000/giorno). Trasparente, documentato, modificabile su richiesta per piani business. Header standard X-RateLimit-Remaining.

Audit log e crediti

Ogni chiamata viene tracciata senza dati personali nei log (no IBAN, no importi, no descrizioni). I crediti vengono scalati solo al termine della conversione: se l'API risponde 5xx, nessun addebito.

Endpoint principali

Documentazione OpenAPI 3.1 fornita con la chiave di accesso anticipato.

POST/v1/conversions

Carica un PDF estratto conto e ricevi un job_id. Il response include una stima del costo crediti basata sul numero di pagine rilevate.

GET/v1/conversions/{job_id}

Recupera lo stato della conversione: queued, processing, completed, failed. Quando completed, include i link firmati al file Excel/CSV (validi 60 minuti).

GET/v1/conversions/{job_id}/rows

Esporta i movimenti come JSON strutturato: data operazione, data valuta, descrizione, entrate, uscite, saldo, confidenza per riga. Utile per integrazioni gestionali.

GET/v1/credits

Restituisce il saldo crediti residuo, il pacchetto attivo e la data di scadenza. Per i piani a consumo i crediti non scadono entro 12 mesi dall'acquisto.