Asapeca E-Invoice

API und MCP-Server

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

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:

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

  1. Die Probleme mit level error in 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.
  2. recalc — nach fix:
    • expected: den Wert expected in field schreiben (bei einer Position: in die Position mit lineId);
    • lines oder vat: diese Summe stimmt — so lassen. Falsch sind Positionsbeträge (BT-131) oder Steuerbeträge der Aufschlüsselung (BT-117); sie kommen als eigene Probleme (code line oder vat-tax, level error, fix: expected). expected der Summe nicht übernehmen.
  3. kosit und zugferd: die Regel sagt, was fehlt oder falsch ist; field.xpath sagt, wohin es gehört, help erklärt die Regel. Am häufigsten ist BR-DE-15 (BT-10 Käuferreferenz): bei öffentlichen Auftraggebern die Leitweg-ID, sonst eine vereinbarte Referenz, z. B. die Bestellnummer.
  4. Erneut prüfen, bis verdict ok oder warnings ist.

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"}]
  }}'

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

Nutzungsbedingungen

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.

Stand: 2026-10-20

Rechnung prüfen →