Konto
Deutsch

E-Rechnung-API für Entwickler

Alles, was die kostenlosen Werkzeuge dieser Seite können, als REST-API. Ein Endpunkt-Satz für XRechnung, ZUGFeRD, Factur-X, Peppol BIS 3.0, UBL, CII und das polnische KSeF FA(3).

Kostenlosen Schlüssel holen

100 Anfragen pro Monat, ohne Karte, ohne Konto. Der Schlüssel wird nur einmal angezeigt; bitte sicher speichern.

Schnellstart

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

Die Rechnung als Multipart-Feld file, als roher application/xml- oder application/pdf-Body oder als JSON {"xml": "…"} senden. PDFs werden überall akzeptiert: das eingebettete Factur-X-/ZUGFeRD-XML wird automatisch extrahiert.

Endpunkte

EndpointErgebnis
POST /v1/detectFamilie, Syntax (ubl / cii / ksef-fa), Standard, Profil, Land
POST /v1/parsenormalisiertes JSON: Verkäufer, Käufer, Positionen, Steueraufschlüsselung, Summen, Zahlungsdaten, Referenzen. Gleiche Struktur für jedes Format.
POST /v1/validate?kosit=truezusammengeführter Bericht: valid, checks je Prüf-Engine, errors und warnings mit Regel-ID, Meldung und XPath
POST /v1/render?lang=en|de|fr|pl|nldruckfähige HTML-Rechnung
POST /v1/render?format=pdf&lang=deA4-PDF (application/pdf, Dateiname = Rechnungsnummer)
POST /v1/inspectErkennen + Auslesen + Prüfen + HTML in einem Aufruf
GET /v1/meIhr Tarif, Verbrauch im Monat, verbleibendes Kontingent, Upgrade-Links

Prüf-Engines

Beispielantwort

{
  "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": []
}

Fehler und Limits

StatusCodeBedeutung
401INVALID_API_KEYSchlüssel unbekannt; Authorization: Bearer-Header prüfen
422UNSUPPORTED_FORMATkein erkennbares E-Rechnungs-XML
422NO_EMBEDDED_XMLPDF ohne Factur-X-/ZUGFeRD-Anhang
429RATE_LIMITEDMinutenlimit des Tarifs erreicht
429QUOTA_EXCEEDEDMonatskontingent verbraucht

Jede gezählte Antwort trägt die Header X-Quota-Limit, X-Quota-Used und X-Quota-Remaining. Anfragen ohne Schlüssel sind nur für die interaktive Nutzung über diese Website vorgesehen, 20 pro Minute und IP.

Preise

PlanAnfragen / MonatPro MinuteMonatlichJährlich (2 Monate gratis)
Free10010€0€0Schlüssel oben
Starter1 00060€24€240Upgrade
Pro10 000120€49€490Upgrade
Business50 000300€149€1 490Upgrade

Eine Anfrage = ein Aufruf von detect, parse, validate, inspect oder HTML-render, unabhängig von der Dateigröße (bis 10 MB). Ein PDF-Render (format=pdf) zählt als 2 Anfragen. Preise zzgl. USt.; die USt. wird im Checkout nach Ihrem Land berechnet, Rechnungen werden automatisch erstellt. Jederzeit kündbar, der Tarif bleibt bis zum Ende des bezahlten Zeitraums aktiv.

Zum Upgrade GET /v1/me mit Ihrem Schlüssel aufrufen und den Checkout-Link für Tarif und Laufzeit öffnen, oder den Schlüssel unten einfügen.

Bereits abonniert? Schlüssel oben einfügen: der Button Abo verwalten öffnet das Paddle-Kundenportal (Rechnungen, Zahlungsmethode, Kündigung). Per API: GET /v1/billing/portal mit dem Schlüssel liefert dieselbe Einmal-URL.

Datenschutz

Rechnungen werden im Arbeitsspeicher verarbeitet und nach der Antwort verworfen. Gespeichert werden Schlüssel-Hash, E-Mail, Tarif und Anfragezahlen pro Tag. Nichts aus dem Rechnungsinhalt wird aufbewahrt. Die Verarbeitung findet in der EU statt. Ein Betrieb im eigenen Haus (Docker) ist im Business-Tarif möglich.