Facturen en bonnen uitlezen, als JSON en UBL.

Stuur een factuur of bon als pdf, jpeg of png. Je krijgt terug wat erop staat, als JSON en als UBL. Automatisch binnen een paar minuten, of gecontroleerd door een van onze verwerkers binnen 24 werkuren.

Maak een testsleutel Lees de gids

Status: PreviewBouw er nu mee met een testsleutel. In preview kan er nog iets veranderen voordat het algemeen beschikbaar is.
Prijs: vanaf €0,0350 per document
Operaties: ocr.extractubl.verifiedocr.readubl.generateubl.validateocr.feedback
Docs: De gids API-referentie TestwaardenDe docs zijn in het Engels.

Wat het doet

Twee manieren van verwerken

Automatisch (processing: automatic). OCR leest het document. Je krijgt de leverancier, het factuurnummer, de datums, de regels, de btw per tarief en de totalen terug. Bij elk veld staat hoe zeker de OCR was, en een waarschuwing vertelt je wanneer iets niet klopt, zoals totalen die niet sluiten. Het resultaat verwacht je binnen twee minuten.

Gecontroleerd (processing: verified). Na de OCR controleert een verwerker van ons team het document naast het origineel, en verbetert het waar nodig. Hij keurt het pas goed als de btw optelt tot het totaal en de UBL door de validatie komt. Klaar binnen 24 werkuren. De regels van de factuur controleert hij niet: de UBL krijgt één regel per btw-tarief.

Wat je ermee kunt

Een document insturen als base64 in JSON, of als multipart-upload. Tot 10 MB en 50 pagina’s.
Het resultaat ophalen, of een webhook krijgen zodra het klaar is (document.completed).
De UBL downloaden: UBL 2.1 volgens Peppol BIS Billing 3.0, altijd gevalideerd.
Je eigen UBL-bestanden controleren tegen het UBL-schema, EN 16931 en Peppol BIS Billing 3.0.
Een fout in een resultaat melden. Alleen als je dat per document toestaat, gebruiken we het document om de herkenning te verbeteren.

Goed om te weten

OCR maakt fouten. Gebruik de waarschuwingen en de zekerheid per veld om te kiezen welke documenten iemand nakijkt, of kies voor gecontroleerd.
Je betaalt bij de uitkomst. Een document dat niet te lezen was kost niets, en hetzelfde bestand nog eens insturen geeft het eerdere document terug, ook zonder kosten.
We bewaren het document en het resultaat standaard 7 dagen na de uitkomst. Per account stel je dat in op 0 tot 30 dagen. Testdocumenten verdwijnen na 24 uur.

Voorbeeld

Echte calls met een testsleutel. Vervang ac_test_… door je eigen sleutel.

Stuur een factuur als base64 in JSON. Het antwoord komt direct; het lezen gebeurt daarna.

POST/v1/documents

Request

curl https://api.accountcloud.io/v1/documents \
  -H "Authorization: Bearer ac_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: inbox-48213" \
  -d '{
    "file": { "name": "factuur-2026-118.pdf", "content_base64": "JVBERi0xLjQK…" },
    "processing": "automatic",
    "output": ["json", "ubl"],
    "reference": "inbox-48213"
  }'

Response202 Acceptedingekort

Location: /v1/documents/doc_01m6j1e9q4a4sncyn7de2ymbe7
AccountCloud-Charged: 0.0000

{
  "id": "doc_01m6j1e9q4a4sncyn7de2ymbe7",
  "object": "document",
  "status": "extracting",
  "processing": "automatic",
  "environment": "test",
  "reference": "inbox-48213",
  "file": {
    "name": "factuur-2026-118.pdf",
    "mime_type": "application/pdf",
    "pages": 1
  },
  "expected_ready_at": "2026-11-04T01:07:43Z",
  "result": null,
  "charge": {
    "operation": "ocr.extract",
    "status": "none",
    "amount": "0.0000",
    "currency": "EUR",
    "live_amount": "0.0350"
  }
}

Een paar seconden later, of na de webhook document.completed: het resultaat, met de zekerheid per veld en een gevalideerde UBL.

GET/v1/documents/{id}

Request

curl https://api.accountcloud.io/v1/documents/doc_01m6j1e9q4a4sncyn7de2ymbe7 \
  -H "Authorization: Bearer ac_test_…"

Response200 OKingekort

AccountCloud-Charged: 0.0000

{
  "id": "doc_01m6j1e9q4a4sncyn7de2ymbe7",
  "status": "completed",
  "result": {
    "document_type": "invoice",
    "invoice_number": "TEST-2026-0001",
    "issue_date": "2026-11-02",
    "due_date": "2026-12-02",
    "currency": "EUR",
    "supplier": {
      "name": "Testleverancier B.V.",
      "vat_number": "NL000000000B02",
      "iban": "NL91ABNA0417164300"
    },
    "lines": [
      {
        "description": "Advieswerk oktober",
        "quantity": "1",
        "unit_price": "100.00",
        "vat_rate": "21.00",
        "amount_excl_vat": "100.00"
      },
      {
        "description": "Vakboeken",
        "quantity": "2",
        "unit_price": "25.00",
        "vat_rate": "9.00",
        "amount_excl_vat": "50.00"
      }
    ],
    "vat_breakdown": [
      { "rate": "21.00", "taxable_amount": "100.00", "vat_amount": "21.00" },
      { "rate": "9.00", "taxable_amount": "50.00", "vat_amount": "4.50" }
    ],
    "totals": {
      "amount_excl_vat": "150.00",
      "vat_amount": "25.50",
      "amount_incl_vat": "175.50"
    }
  },
  "confidence": {
    "document": 0.95,
    "fields": {
      "invoice_number": 0.99,
      "supplier.name": 0.98,
      "totals.amount_incl_vat": 0.99
    }
  },
  "warnings": [],
  "ubl": {
    "available": true,
    "href": "/v1/documents/doc_01m6j1e9q4a4sncyn7de2ymbe7/ubl",
    "valid": true,
    "profile": "peppol-bis-billing-3.0"
  },
  "charge": {
    "operation": "ocr.extract",
    "status": "none",
    "amount": "0.0000",
    "currency": "EUR",
    "live_amount": "0.0350"
  }
}

Wat het kost

OCR€0,0350een factuur of bon als JSONper document
UBL-verwerking€0,3500gecontroleerd door een verwerkerper document
OCR-resultatengratisdocumenten ophalen, opsommen en verwijderen
UBL makengratiseen UBL-bestand uit een uitgelezen document
UBL controlerengratiseen UBL-bestand valideren
OCR-feedbackgratiseen fout in een resultaat melden

Exclusief btw, van je tegoed. Testsleutels zijn gratis, en een fout of ongeldige invoer kost niets.

Verder lezen

Begin met een testsleutel. Die is gratis.

Aanmelden kost een minuut. De quickstart in de docs vijf.

Maak een testsleutel Lees de gids