Entwickler · API v1

Änderungen an der API

Was sich geändert hat, seit wann, und was Ihre Anbindung davon merkt. Neuer Eintrag oben.

Abwärtskompatibel Neue Felder optional

Kompatibilität

Alle Endpunkte liegen unter /api/v1. Diese Adressen bleiben bestehen.
Neue Felder in Anfragen sind immer optional. Ihre Kasse muss nichts ändern, wenn sie die neuen Möglichkeiten nicht braucht.
Unbekannte Felder in Anfragen werden ignoriert, nicht abgelehnt.
Antworten können neue Felder bekommen. Werten Sie nur die Felder aus, die Sie kennen, und behandeln Sie unbekannte Statuswerte wie PENDING.
Änderungen, die bestehende Anbindungen betreffen, kündigen wir angebundenen Partnern vorab per E-Mail an.

19.09.2026

Neu

Änderung	Bedeutung für Ihre Anbindung
`GET /receipts/by-number`	Vor einer Nacherfassung prüfen, ob eine Belegnummer bei TrustNode schon existiert. Antwortet mit `FOUND`, `PENDING`, `FAILED` oder `NOT_FOUND`. Siehe Nacherfassung.
Feld `original_receipt_number`	Optionaler Verweis auf den Offline- oder Notfallbeleg bei einer Nacherfassung.
Feld `original_receipt_datetime`	Optionaler Zeitpunkt des ursprünglichen Belegs. Wird gespeichert, verändert den signierten Beleg nicht.
`GET /receipts/special`	Maschinenlesbare Codes von Sonderbelegen abrufen, etwa um den Jahresbeleg zum Scannen anzuzeigen.
Feld `error_code`	In `409`-Antworten und bei `FAILED`. Werten Sie dieses Feld aus statt des Textes in `detail`.

Geändert

Wiederholungen sind idempotent. Derselbe Beleg mit derselben Belegnummer und denselben Daten liefert 202 mit der ursprünglichen job_id, es entsteht kein zweiter Beleg. Abweichende Daten unter derselben Nummer ergeben 409.
Abgelehnte Belege sind nachvollziehbar. Der Job-Status kennt FAILED mit error_code; solche Ergebnisse bleiben acht Tage abrufbar, signierte Belege dauerhaft.
Kassen werden deaktiviert statt gelöscht. Eine inaktive oder per Schlussbeleg stillgelegte Kasse lehnt neue Belege mit CASH_REGISTER_INACTIVE ab. Belege bleiben erhalten.
Verkettung und DEP-Format folgen der BMF-Detailspezifikation. Der Verkettungswert wird aus der JWS-Kompaktdarstellung des Vorbelegs gebildet, der DEP-Export enthält diese Darstellung, und Trainings- beziehungsweise Stornobelege tragen TRA und STO im Umsatzzählerfeld. Geprüft mit dem offiziellen Prüfwerkzeug des Finanzministeriums.
Sonderbelege in Wiener Zeit. Monats- und Jahresbeleg entstehen um 23:50 Uhr Wiener Zeit am letzten Tag des Monats.
Keine Nachsignierung von Ausfallbelegen. Belege, die während eines Signaturausfalls entstanden sind, bleiben unverändert. Nach dem Ausfall schließt ein signierter Sammelbeleg an die Kette an.

Bestehende Anbindungen liefen ohne Änderung weiter. Neue Felder und Endpunkte sind Ergänzungen.

Start der API v1

Beleg signieren, Status und QR-Code abrufen, Sonderbelege erstellen, DEP-Export und Partner-API zum Anlegen von Unternehmen und Kassen. Diese Endpunkte sind seither unverändert erreichbar.