Änderungen an der API
Alle Versionen der eRechio API (https://api.erechio.de), neueste zuerst. Die aktuelle Version steht im Feld version von GET /v1/status.
Versionierung und Abkündigung
- Die Versionsnummer hat die Form
MAJOR.MINOR.PATCH. Die aktuelle steht im FeldversionvonGET /v1/status. - Innerhalb von
/v1gibt es nur rückwärtskompatible Änderungen: neue optionale Felder, Header und Endpunkte (MINOR) sowie Fehlerbehebungen (PATCH). Programme müssen unbekannte Felder ignorieren. - Inkompatible Änderungen gibt es nur unter einem neuen Pfad (
/v2). - Eine Abkündigung von
/v1oder eines Feldes kündigen wir mindestens 3 Monate vorher auf dieser Seite und auf der Statusseite an; Kunden mit Starter-Zugang zusätzlich per E-Mail. - Veraltete Felder bleiben in
/v1erhalten. Derzeit veraltet:valid(gleichvollstaendig_validiert). - Änderungen an den Prüfregeln (KoSIT-Konfiguration, Regelstand) stehen getrennt auf Regelstand und Änderungen.
Versionen
- Version 1.5.0 (22.11.2026): MCP: Werkzeugnamen englisch und einheitlich:
validate_invoice(bisherrechnung_pruefen) undget_status(bisherstatus); die alten Namen werden bis mindestens 22.02.2027 weiter angenommen, aber nicht mehr intools/listgezeigt. Neues Werkzeugexplain_rule: erklärt einen Regelcode (z. B.BR-DE-15) auf Deutsch, ohne Schlüssel und ohne Kontingent. Werkzeug- und Parameterbeschreibungen vollständig (Ergebnis, Fehler, Grenzen), Name und Beschreibungen in den Verzeichnissen englisch. Ergebnisse und Meldungen bleiben deutsch;/v1unverändert. - Version 1.4.1 (22.11.2026): Fehlerbehebung: Die Warnung
BR-DE-19bzw.BR-DE-20(„soll eine korrekte IBAN enthalten“) erschien auch bei korrekten IBANs, weil die Regel-Engine die Prüfziffer (mod 97) bei langen Zahlen ungenau rechnete. Die IBAN wird jetzt mit derselben Formel wie in den KoSIT-Regeln exakt nachgerechnet; nur bei falscher IBAN bleibt die Warnung. Gleicher Regelstand, keine Änderung an Feldern oder Antwortcodes. Betrifft ebenso den Prüfer im Browser. - Version 1.4.0 (22.11.2026): MCP-Endpunkt
https://api.erechio.de/mcp(Model Context Protocol, Streamable HTTP) mit den Werkzeugenrechnung_pruefenundstatus; gleicher API-Schlüssel, gleiches Kontingent, Dokumentation: MCP-Anbindung. Optionaler HeaderIdempotency-KeyfürPOST /v1/validate: Eine Wiederholung mit gleichem Schlüssel und gleichem Inhalt innerhalb von 24 Stunden liefert das gespeicherte Ergebnis mit dem HeaderIdempotent-Replayed: trueund zählt nicht erneut im Kontingent; anderer Inhalt mit gleichem Schlüssel: 422idempotenz_konflikt; gleichzeitig laufende Anfrage mit gleichem Schlüssel: 409idempotenz_laeuft. Neu:/.well-known/api-catalog(RFC 9727). Rückwärtskompatibel, nichts entfällt. - Version 1.3.0 (23.10.2026):
/v1/statusmeldet den echten Zustand:oknur mit bereitem Prüfprozess, lesbaren Schlüsseln und speicherbaren Nutzungsdaten, sonstgestörtmit HTTP 503 undgruende; in diesem Zustand werden Prüfungen mit 503gestoertabgelehnt (vorher meldete der Status immerok). Gezählt wird erst nach vollständig gesendeter Antwort; Fehler beim Speichern des Zählers verändern die Antwort nicht. Trennt der Client die Verbindung, wird die Prüfung beendet – auch wenn sie noch wartet. Wartende Prüfungen hinter abgelaufenen starten sofort (vorher konnte ein freier Prüfprozess leer bleiben). - Version 1.2.0 (22.10.2026): Neues Feld
regelstandin Prüfergebnis und/v1/status: Kennung der verwendeten Regel- und Schemadateien (Anfang ihrer SHA-256). Herkunft, Prüfsummen, Aktualisierungstest und Änderungen am Prüfverhalten: Regelstand und Änderungen. - Version 1.1.0 (21.10.2026): XSD-Schemaprüfung ergänzt. Neue Felder
vollstaendig_validiert,regelpruefung_bestandenundschemapruefung.validist veraltet und jetzt gleichvollstaendig_validiert: In 1.0.0 warvalidschontrue, wenn nur die Regelprüfung bestanden war, ohne Schemaprüfung.ohnenennt jetzt die inhaltliche Prüfung. Neue MeldungscodesXSDundABBRUCH; eine Rechnung mit Betrag „336,90“ führte vorher zu Status 500. Kontingent wird vor der Prüfung reserviert und nur bei 200 gezählt (vorher konnten gleichzeitige Anfragen es überschreiten); neuer Status 503 mitzeitlimitoderausgelastet. - Version 1.0.0 (09.10.2026): Erste Fassung, Schematron-Regeln der KoSIT-Prüfkonfiguration XRechnung 3.0.2.