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

    01

    Abonează-te la Pro

    Accesul la API cere un abonament Pro activ; endpointul refuză cheile oricărui alt cont.

    02

    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.

    03

    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.

    04

    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 Pro
Întrebări frecvente

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