E-Rechnungen prüfen — XRechnung, ZUGFeRD, Factur-X, EN 16931 in CII oder UBL, als XML oder PDF — mit dem offiziellen KoSIT-Validator, veraPDF und den ZUGFeRD-Regeln, dazu jede Summe nachrechnen. Eine gültige XRechnung aus JSON erzeugen. Offen: ohne Schlüssel, ohne Anmeldung. Dateien werden im Arbeitsspeicher geprüft und nicht gespeichert.
Basis-URL: https://einvoice.asapeca.com. Beschreibung: OpenAPI 3.1. Dieser Text für KI-Agenten (englisch): llms.txt.
Wann aufrufen
- Sie haben eine Rechnungsdatei und wollen wissen, ob ein Empfänger in Deutschland (auch die öffentliche Hand oder Peppol) sie annimmt und was zu korrigieren ist: check.
- Sie haben Rechnungsdaten (eine Bestellung, einen Shop-Export) und brauchen eine XRechnung: create. Es rechnet die Beträge, schreibt die XML und prüft sie.
- Sie haben eine Rechnung geändert: erneut prüfen. Dieselbe Datei ergibt dieselbe Antwort.
Rechnung prüfen
POST /api/v1/check — die Datei als Body der Anfrage (XML oder PDF, höchstens 10 MB) oder als Feld file von multipart/form-data.
curl -s --data-binary @rechnung.xml -H 'Content-Type: application/xml' \
https://einvoice.asapeca.com/api/v1/check
curl -s -F file=@rechnung.pdf https://einvoice.asapeca.com/api/v1/check
import requests
r = requests.post("https://einvoice.asapeca.com/api/v1/check",
data=open("rechnung.xml", "rb"), headers={"Content-Type": "application/xml"})
bericht = r.json()
print(bericht["verdict"])
for p in bericht["problems"]:
if p["level"] == "error":
print(p["source"], p["code"], p.get("field", {}).get("id"), p["text"]["de"], p.get("fix", ""), p.get("expected", ""))
import { readFile } from "node:fs/promises";
const r = await fetch("https://einvoice.asapeca.com/api/v1/check", {
method: "POST", headers: { "Content-Type": "application/xml" }, body: await readFile("rechnung.xml"),
});
const bericht = await r.json();
console.log(bericht.verdict, bericht.problems.filter(p => p.level === "error"));
Die Antwort lesen
verdict — danach entscheiden:
| verdict | Bedeutung |
|---|---|
ok |
gültig, nichts zu tun |
warnings |
gültig; Warnungen der Validatoren oder eine Abweichung unserer Nachrechnung — problems lesen |
rejected |
ungültig: mindestens ein Problem mit level error; ein Empfänger wird sie zurückweisen |
unchecked |
für dieses Profil gibt es keine offiziellen Regeln (z. B. XRechnung älter als 3.0) |
error |
keine Rechnung, die wir prüfen können (HTTP 422); error.code sagt, warum |
problems — alle Befunde: Fehler zuerst, und unter ihnen zuerst die zu schreibenden Werte (source: recalc, fix: expected). Jeder hat:
source:kosit(der offizielle Validator: Regeln der XRechnung und der EN 16931),zugferd(Regeln von ZUGFeRD / Factur-X),pdfa(die PDF/A-Prüfung; steuerlich zählt die XML, daher höchstens Warnungen),recalc(unsere Nachrechnung der Beträge);code: die Regel, z. B.BR-DE-15,BR-CO-10; beirecalcdie Prüfung:line,total,vat-basis,vat-tax…;level:errormacht die Rechnung ungültig,warningundinfonicht;field: der Geschäftsbegriff der EN 16931 (BT-10Käuferreferenz,BT-116Steuerbasis …) mit Namen auf Deutsch und Englisch undxpath, wo das Feld in der Syntax dieser Datei (CII oder UBL) steht — auch bei einem fehlenden Feld;line(Position der Rechnungszeile, ab 1) oderlineId(recalc: BT-126 der Position),path(XPath);text: was falsch ist — der Text des Validators (eine Sprache; Deutsch bei den Regeln BR-DE) indeunden, unsere Texte zweisprachig;help: eine Seite zur Regel mit Ursachen und Korrektur, wenn es eine gibt;- nur
recalc:declared(in der Rechnung),expected(nach EN 16931 aus den Beträgen der Rechnung),diff,fix(was zu tun ist, siehe unten),cause(price-with-vat,rounding,from-lines,from-vat…),rule(die offizielle Regel zur selben Summe).
Außerdem: file (container xml oder pdf, syntax, profile wie BT-24, profileKey z. B. xrechnung-3, number, currency, size, sha256), official (engine, config — die Regeln mit Datum, scenario, verdict accept / reject / no-scenario), zugferd (PDF/A und ZUGFeRD), recalc (totals und vat: angegeben gegen nachgerechnet), pdfText (bei einer PDF: Werte der XML, die der sichtbare Text nicht zeigt — ein Hinweis, maßgeblich ist die XML), ms (Dauer). Das ganze Schema: Check in der OpenAPI-Beschreibung.
Eine Rechnung korrigieren
- Die Probleme mit
levelerrorin der gegebenen Reihenfolge nehmen: zuerst kommen die falschen Werte (source: recalc,fix: expected). Ein falscher Betrag verletzt oft mehrere Regeln zugleich (BR-CO-10,BR-S-08…); ist der Wert korrigiert, sind alle erledigt. recalc— nachfix:expected: den Wertexpectedinfieldschreiben (bei einer Position: in die Position mitlineId);linesodervat: diese Summe stimmt — so lassen. Falsch sind Positionsbeträge (BT-131) oder Steuerbeträge der Aufschlüsselung (BT-117); sie kommen als eigene Probleme (codelineodervat-tax,levelerror,fix: expected).expectedder Summe nicht übernehmen.
kositundzugferd: die Regel sagt, was fehlt oder falsch ist;field.xpathsagt, wohin es gehört,helperklärt die Regel. Am häufigsten istBR-DE-15(BT-10 Käuferreferenz): bei öffentlichen Auftraggebern die Leitweg-ID, sonst eine vereinbarte Referenz, z. B. die Bestellnummer.- Erneut prüfen, bis
verdictokoderwarningsist.
XRechnung erzeugen
POST /api/v1/create — die Rechnung als JSON. Senden Sie Verkäufer, Käufer, Positionen (Menge, Einheit, Nettopreis, Steuerkategorie und -satz), Lieferdatum und Zahlung; Nettobeträge der Positionen, Umsatzsteuer-Aufschlüsselung und Summen nicht senden: sie werden nach EN 16931 gerechnet. Unbekannte Felder sind ein Fehler. Beträge als Zahl oder Zeichenkette ("19.99").
curl -s https://einvoice.asapeca.com/api/v1/create -H 'Content-Type: application/json' -d '{
"format": "cii", "profile": "xrechnung",
"invoice": {
"number": "RE-1001", "issueDate": "2026-10-20", "type": "380", "currency": "EUR", "buyerRef": "#1001",
"seller": {"name": "Shop GmbH", "vatId": "DE123456789", "eaddr": {"scheme": "EM", "value": "invoice@shop.example"},
"address": {"street": "Hauptstr. 1", "city": "Berlin", "zip": "10115", "country": "DE"},
"contact": {"name": "Buchhaltung", "phone": "+49 30 1234567", "email": "invoice@shop.example"}},
"buyer": {"name": "Kunde KG", "eaddr": {"scheme": "EM", "value": "ap@kunde.example"},
"address": {"street": "Weg 2", "city": "Hamburg", "zip": "20095", "country": "DE"}, "contact": {}},
"delivery": {"date": "2026-10-19"},
"payment": {"means": "58", "accounts": [{"iban": "DE02120300000000202051"}], "terms": "14 Tage netto"},
"lines": [{"id": "1", "qty": 2, "unit": "H87", "price": "19.99", "category": "S", "rate": 19, "name": "Werkzeugkoffer"}]
}}'
format:cii(Standard),ubloderzugferd— ZUGFeRD 2: eine PDF/A-3 mit der sichtbaren Rechnung und der CII darin (ProfilEN16931oderXRECHNUNGnachprofile),langde(Standard) oderenist die Sprache der sichtbaren Rechnung;profile:xrechnungoderen16931; ohne Angabexrechnungfürciiundubl,en16931fürzugferd— die XML heißt dannfactur-x.xml, und diesen Namen findet jedes Programm, das ZUGFeRD liest (xrechnungergibt ZUGFeRD im Profil XRECHNUNG mitxrechnung.xml, z. B. für Behörden).issued: true(HTTP 200):file.contentist die XML in Base64 (beizugferddie PDF,file.typeapplication/pdf) (file.name,file.type,file.size),checkihre Prüfung (wie oben),totals(lineNet,allowances,charges,netTotal,tax,gross,prepaid,rounding,due— BG-22) undvat(category,rate,basis,tax) das Geschriebene.issued: false(HTTP 422):problemsnennen Feld und Regel (offiziellBR-*oder unsereCORE-*), die die Ausstellung verhindern; keine Datei.- Pflicht bei jeder Partei:
name,eaddr,address(mitcountry) undcontact(darf leer sein:{}; die XRechnung verlangt beim Verkäufer Name, Telefon und E-Mail des Kontakts). - Alle Felder: Schema
CreateRequestder OpenAPI-Beschreibung. Steuerkategorien:SNormalsatz,ZNullsatz,Esteuerfrei (auch Kleinunternehmer nach § 19 UStG — der Grund inexemptions),AEReverse Charge,Kinnergemeinschaftliche Lieferung,GAusfuhr,Onicht steuerbar.
MCP-Server
https://einvoice.asapeca.com/api/v1/mcp — Streamable HTTP, ohne Schlüssel. Werkzeuge: check_invoice (xml als Text oder file_base64 für eine PDF — eines von beiden) und create_invoice (die Anfrage von /api/v1/create). Antworten wie die REST-API: der Textinhalt ist dasselbe JSON wie structuredContent (check_invoice gibt es als outputSchema an). Eine Ablehnung — Grenze überschritten, ausgelastet, keine Datei, Anfrage nicht nach dem Vertrag — kommt mit isError: true und dem Grund als Text (das JSON der Fehlerantwort). filename ist optional und wird nicht verwendet. Argumente, die das Werkzeug nicht annimmt (keine Datei, xml und file_base64 zugleich, kein Base64): Code bad-arguments.
Claude Code:
claude mcp add --transport http einvoice https://einvoice.asapeca.com/api/v1/mcp
Claude (claude.ai, Desktop): Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen, die URL oben.
Cursor, ~/.cursor/mcp.json:
{"mcpServers": {"einvoice": {"url": "https://einvoice.asapeca.com/api/v1/mcp"}}}
VS Code, .vscode/mcp.json:
{"servers": {"einvoice": {"type": "http", "url": "https://einvoice.asapeca.com/api/v1/mcp"}}}
Grenzen und Fehler
- Je IP-Adresse: 10 Prüfungen pro Minute mit Spitzen bis 20, ebenso viele Erzeugungen; MCP und REST teilen sich diese Grenzen. Darüber: HTTP 429 mit
Retry-After(Sekunden). - Die Datei höchstens 10 MB (HTTP 413); über MCP in Base64 etwa 7 MB.
- Jede Fehlerantwort hat
error.codeunderror.text(de,en):no-file,too-large,rate-limit,busy(HTTP 503, nachRetry-Aftererneut),zugferd-unavailable(HTTP 503, die ZUGFeRD-PDF ließ sich gerade nicht erzeugen — nachRetry-Aftererneut; XML geht weiterhin),kosit-unavailable(HTTP 503, der offizielle Validator hat nicht geantwortet — nachRetry-Aftererneut: 5 Sekunden bei einer Zeitüberschreitung, sonst 60); bei einer Datei, die wir nicht prüfen können (HTTP 422):not-xml-or-pdf,plain-pdf(PDF ohne Rechnungs-XML: keine E-Rechnung),no-invoice-xml,xml-too-large,pdf-unreadable,not-an-invoice,zugferd-1. - Version: jede Antwort hat
version: 1. Innerhalb von v1 kommen Felder nur hinzu; unbekannte Felder ignorieren.
Nutzungsbedingungen
- Die Schnittstelle ist kostenlos und ohne Anmeldung nutzbar. Ein Anspruch auf Verfügbarkeit besteht nicht; wir können sie ändern, begrenzen oder einstellen. Innerhalb der Version v1 ändern wir das Format der Antworten nur durch neue Felder.
- Grenzen je IP-Adresse: 10 Prüfungen und 10 Erzeugungen pro Minute (Spitzen bis 20). Wer die Grenzen umgeht (z. B. über viele Adressen) oder den Dienst automatisiert überlastet, kann gesperrt werden.
- Die Prüfung folgt den offiziellen Regeln (KoSIT-Validator mit der Konfiguration XRechnung, Regeln von ZUGFeRD/Factur-X) und unserer Nachrechnung. Sie ist keine Steuer- oder Rechtsberatung; für Inhalt und Ausstellung einer Rechnung bleibt der Rechnungsaussteller verantwortlich.
- Haftung: Wir haften unbeschränkt bei Vorsatz und grober Fahrlässigkeit sowie nach dem Produkthaftungsgesetz; bei leichter Fahrlässigkeit nur für die Verletzung wesentlicher Pflichten und begrenzt auf den vorhersehbaren Schaden.
- Daten: siehe Datenschutzerklärung, Abschnitt „Schnittstelle (API) und MCP-Server“. Wer Rechnungen Dritter über eigene Programme prüft, sorgt selbst für eine Rechtsgrundlage der Weitergabe.
- Die Antworten (Berichte, Texte) dürfen in eigenen Programmen angezeigt und weiterverarbeitet werden; bei Darstellung für Dritte bitten wir um den Hinweis „geprüft mit einvoice.asapeca.com“.
Daten
Die Datei wird im Arbeitsspeicher geprüft und mit der Anfrage verworfen: keine Speicherung, kein Protokoll des Inhalts. Wir zählen anonym, was geprüft wurde (Format, Ergebnis, Regeln) und mit welcher Art von Programm (curl, Python …), ohne IP-Adressen. Einzelheiten: Datenschutz. Der Dienst prüft gegen die offiziellen Regeln; er ist keine Steuerberatung.