Acces pentru dezvoltatori · Activ
API de conversie a extraselor de cont
Extrage date de tranzacții în JSON structurat din orice PDF de extras de cont bancar printr-un API REST simplu. Construit pe același motor de analiză care alimentează PivotBank, peste 1000 de bănci, suport pentru mai multe pagini, integrare fără configurare.
Integrare simplă
Un singur endpoint. JSON structurat.
Trimite un PDF prin POST. Primești date de tranzacții curate și structurate. Fiecare răspuns include numele băncii, perioada extrasului și un array complet de tranzacții cu câmpuri normalizate pentru dată, descriere, debit, credit și sold.
- ✓Nume de câmpuri consecvente pentru toate băncile
- ✓Valori null pentru debit/credit lipsă (niciodată ambigue)
- ✓Ieșire în format de dată ISO
- ✓Numele băncii și perioada detectate automat
- ✓Numărul de pagini inclus pentru urmărirea utilizării
POST /api/v1/convert
Authorization: Bearer {API_KEY}
Content-Type: multipart/form-data
# Response: 200 OK
{
"bankName": "HSBC",
"accountNumber": "1234 5678",
"period": "Jan 2025, Mar 2025",
"pageCount": 3,
"transactionCount": 2,
"reconciliation": {
"verified": true,
"status": "ok",
"opening": 2384.21,
"closing": 6841.22,
"expectedClosing": 6841.22,
"difference": 0,
"totalIn": 4500.00,
"totalOut": 42.99
},
"transactions": [
{
"date": "2025-01-03",
"description": "AMAZON.CO.UK",
"debit": 42.99,
"credit": null,
"balance": 2341.22
},
{
"date": "2025-01-07",
"description": "SALARY - ACME LTD",
"debit": null,
"credit": 4500.00,
"balance": 6841.22
}
]
}Cum o apelezi
Abonează-te la Pro
Accesul la API cere un abonament Pro activ; endpointul refuză cheile oricărui alt cont.
Creează o cheie API
Genereaz-o din pagina contului tău. Este afișată o singură dată și se păstrează doar hash-ul ei.
Trimite PDF-ul prin POST
Trimite PDF-ul la /api/v1/convert cu un antet Authorization: Bearer, ca multipart form-data într-un câmp "file" sau ca body application/pdf, până la 15 MB.
Citește JSON-ul
Un răspuns 200 întoarce bankName, accountNumber, period, pageCount, transactionCount, un obiect reconciliation și un array transactions cu date, description, debit, credit și balance.
Cine folosește API-ul
Integrare cu software de contabilitate
Trimite PDF-urile clienților către propriul sistem și primește JSON structurat, gata de înregistrat direct în registrele Xero, QuickBooks sau Sage, fără re-tastare manuală.
Fintech și creditare
Automatizează analiza capacității de plată pentru cererile de împrumut. Analizează 3-12 luni de extrase ale solicitantului în câteva secunde și extrage veniturile, angajamentele recurente și tendințele soldului.
Automatizare la nivel de întreprindere
Integrează analiza extraselor bancare în fluxurile de lucru interne, verificări de conformitate, procesarea cheltuielilor, suport pentru audit sau tablouri de bord financiare personalizate.
Model de prețuri
Plată per extras
Acces
Inclus în Pro
Bănci acceptate
Peste 1000
The API is a Pro feature
Upgrade to Pro to create API keys and convert statements programmatically.
Upgrade to ProLucrul cu API-ul
Cum mă autentific?
Trimite cheia ca bearer token: Authorization: Bearer pvb_live_... Cheile se creează și se revocă din această pagină, iar endpointul cere un abonament Pro activ, deci o cheie validă pe un cont fără Pro este refuzată cu 403.
Cum trimit PDF-ul?
Ca multipart/form-data cu fișierul într-un câmp numit "file", sau ca body brut cu Content-Type: application/pdf. Același endpoint le acceptă pe amândouă. Limita este de 15 MB, verificată pe lungimea declarată înainte ca body-ul să fie citit, așa că o încărcare prea mare este refuzată cu 413 în loc să fie transferată.
Ce primesc înapoi?
Un obiect JSON: bankName, accountNumber, period și pageCount detectate din extras, transactionCount și un array transactions. Fiecare tranzacție are dată, descriere și câmpurile debit, credit și balance, cu null în loc de zero acolo unde o coloană chiar lipsește.
Citește extrase scanate?
Nu, și este singurul loc în care API-ul este mai limitat decât aplicația web. Browserul rulează OCR pe o scanare; API-ul analizează doar stratul de text, iar un extras fără text utilizabil revine ca 422, cerând un PDF digital. Dacă intrările tale includ scanări, convertește-le în browser sau scrie-ne.
Ce înseamnă codurile de eroare?
401 pentru o cheie lipsă, invalidă sau revocată. 403 pentru o cheie validă pe un cont fără Pro. 400 pentru un body care nu este un PDF lizibil. 413 peste 15 MB. 422 pentru un PDF analizat care nu a dat text utilizabil, ceea ce în practică înseamnă o scanare.
Cum se contorizează utilizarea?
O conversie per apel reușit, înregistrată în contul tău cu numărul de pagini, la fel ca o conversie în browser. Un apel cu eroare nu se contorizează.
Volum și enterprise
Convertești la volum mare?
API-ul este activ și este inclus în abonamentul Pro. Creează o cheie mai sus și începe să trimiți extrase; aici nu există nicio listă de așteptare.
Scrie-ne dacă convertești la volum mare, ai nevoie de un tarif personalizat sau vrei să discutăm o integrare înainte să o construiești.
