Account
Nederlands

E-factuur API voor ontwikkelaars

Alles wat de gratis tools op deze site doen, als REST API. Eén set endpoints voor Peppol BIS 3.0, UBL, CII, XRechnung, ZUGFeRD, Factur-X en het Poolse KSeF FA(3).

Gratis sleutel aanvragen

100 verzoeken per maand, geen kaart, geen account. De sleutel wordt één keer getoond; bewaar hem veilig.

Snel starten

curl -H "Authorization: Bearer ek_…" -F file=@invoice.pdf https://einvoicechecker.com/v1/validate

Stuur de factuur als multipart-veld file, als ruwe application/xml- of application/pdf-body, of als JSON {"xml": "…"}. PDF’s worden overal geaccepteerd: de ingesloten Factur-X / ZUGFeRD-XML wordt automatisch uitgepakt.

Endpoints

EndpointResultaat
POST /v1/detectfamilie, syntaxis (ubl / cii / ksef-fa), standaard, profiel, land
POST /v1/parsegenormaliseerde JSON: verkoper, koper, regels, btw-overzicht, totalen, betaalgegevens, referenties. Dezelfde structuur voor elk formaat.
POST /v1/validate?kosit=truesamengevoegd rapport: valid, checks per engine, errors en warnings met regel-ID, melding en XPath
POST /v1/render?lang=en|de|fr|pl|nlafdrukbare HTML-factuur
POST /v1/render?format=pdf&lang=deA4-PDF (application/pdf, bestandsnaam = factuurnummer)
POST /v1/inspectherkennen + parsen + valideren + HTML in één aanroep
GET /v1/meuw plan, verbruik deze maand, resterend quotum, upgrade-links

Validatie-engines

Voorbeeldantwoord

{
  "format": { "family": "en16931", "syntax": "cii", "standard": "Factur-X", "profile": "urn:factur-x.eu:1p0:en16931", "country": "FR" },
  "valid": false,
  "checks": [
    { "name": "en16931-core", "engine": "@invoicenavigator/einvoice-validator", "valid": true, "errors": 0 },
    { "name": "kosit-xrechnung", "engine": "KoSIT Validator 1.6.3", "valid": false, "errors": 1, "scenario": "EN16931 (CII)" }
  ],
  "errors": [
    { "source": "kosit", "rule": "BR-CO-15", "level": "error",
      "message": "Invoice total amount with VAT (BT-112) = Invoice total amount without VAT (BT-109) + Invoice total VAT amount (BT-110).",
      "path": "/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeSettlementHeaderMonetarySummation" }
  ],
  "warnings": []
}

Fouten en limieten

StatusCodeBetekenis
401INVALID_API_KEYsleutel onbekend; controleer de Authorization: Bearer-header
422UNSUPPORTED_FORMATgeen herkenbare e-factuur-XML
422NO_EMBEDDED_XMLPDF zonder Factur-X / ZUGFeRD-bijlage
429RATE_LIMITEDlimiet per minuut van uw plan
429QUOTA_EXCEEDEDmaandquotum opgebruikt

Elk geteld antwoord draagt de headers X-Quota-Limit, X-Quota-Used en X-Quota-Remaining. Verzoeken zonder sleutel zijn alleen bedoeld voor interactief gebruik vanaf deze site, 20 per minuut per IP.

Prijzen

PlanVerzoeken / maandPer minuutMaandelijksJaarlijks (2 maanden gratis)
Free10010€0€0sleutel hierboven
Starter1 00060€24€240Upgrade
Pro10 000120€49€490Upgrade
Business50 000300€149€1 490Upgrade

Eén verzoek = één aanroep van detect, parse, validate, inspect of HTML-render, ongeacht de bestandsgrootte (tot 10 MB). Een PDF-render (format=pdf) telt als 2 verzoeken. Prijzen exclusief btw; btw wordt bij het afrekenen toegevoegd volgens uw land en facturen worden automatisch uitgereikt. Op elk moment opzegbaar, het plan blijft actief tot het einde van de betaalde periode.

Om te upgraden roept u GET /v1/me aan met uw sleutel en opent u de betaallink voor het gewenste plan en de periode, of plak uw sleutel hieronder.

Al geabonneerd? Plak uw sleutel hierboven: de knop Abonnement beheren opent het Paddle-klantportaal (facturen, betaalmethode, opzeggen). Via de API: GET /v1/billing/portal met de sleutel geeft dezelfde eenmalige URL.

Privacy en gegevens

Facturen worden in het geheugen verwerkt en na het antwoord gewist. We bewaren de hash van uw sleutel, uw e-mail, uw plan en het aantal verzoeken per dag. Niets uit de factuurinhoud wordt bewaard. De verwerking vindt plaats in de EU. On-premise (Docker) is beschikbaar in het Business-plan.