FAQ

Hier finden Sie Antworten auf 12 häufig gestellte Fragen rund um SUBMIT DE, organisiert nach Themenbereichen.

Allgemein (12)

Welche BSI-Zertifikatsnummer hat meine TSE?

Sie können die gültige BSI-Zertifikatsnummer Ihrer TSE auf zwei Wegen nachsehen:

Im fiskaly Dashboard

Navigieren Sie zu: Germany > SIGN DE V2 > Technische Sicherheitseinrichtung.

• In der Tabellenübersicht finden Sie die BSI-Zertifikatsnummer jeder TSE.

• Auf der Detailseite der jeweiligen TSE wird die Zertifikatsnummer ebenfalls angezeigt.  

Über fiskaly SIGN DE (ListTss / RetrieveTss Endpunkt)

Rufen Sie den Endpunkt listTss bzw. RetrieveTss auf.

• Die BSI-Zertifikatsnummer finden Sie im Response-Feld data[].bsi_certification_id.

Wie bekomme ich die fiskaly Daten für die Kassenmeldung in Deutschland?

Sie sind SteuerpflichtigeR und melden Ihre Kasse beim Finanzamt selbst an? Hier erfahren Sie, wie Sie über das fiskaly System auf die BSI-Zertifikats-ID und die Seriennummer der Technischen Sicherheitseinrichtung (TSE) zugreifen können.

Weitere Angaben wie Software-Version, Modell oder Seriennummer Ihres Kassensystems erhalten Sie direkt von Ihrem Kassenanbieter bzw. dem Anbieter Ihrer Kassensoftware.

BSI-Zertifikats-ID

Die aktuelle BSI-Zertifikats-ID für die fiskaly TSE finden Sie in unserem Artikel Welche BSI-Zertifikats-ID sollte für eine fiskaly TSE verwendet werden?

TSE-Seriennummer

Die Seriennummer der TSE finden Sie auf einem Beleg aus Ihrem Kassensystem:

• entweder im QR-Code auf dem Bon, den Sie mit unserer kostenlosen App fiskalcheck auslesen können - Google Play Store (Android) / Apple App Store (iOS)

• oder direkt im Klartext auf dem Bon falls vorhanden (Teil der TSE-Signatur)

Welche Felder in der TSE-Signatur enthalten sind, finden Sie in unserem Artikel Welche Daten müssen auf dem Kassenbon vermerkt werden?

Wie kann ich Submission-Status in der Submission API testen?

Einige Submission-Status können in der Live-Umgebung auftreten, lassen sich jedoch in unserer Infrastruktur nicht gezielt auslösen. Die folgenden Status sind davon betroffen:

XML_GENERATION_FAILED: Tritt unter normalen Umständen nicht auf, da nur Daten zur XML-Generierung gelangen, die alle Validierungen und Geschäftsregeln bestehen.

TRANSMISSION_FAILED: Kann nicht manuell ausgelöst werden, da dieser Status auf Kommunikationsfehler mit ELSTER zurückzuführen ist.

ERROR: Bezieht sich auf seltene interne Systemfehler, die nicht gezielt getestet werden können.

INTERNAL_VALIDATION_FAILED: Tritt auf, wenn BenutzerInnen fehlerhafte Daten übermitteln.

Fehler-Status testen

Um diese oder andere Fehler zu simulieren, empfehlen wir, einen Mock-Proxy auf Ihrer Seite zu implementieren, der vordefinierte Responses zurückgibt. Dadurch haben Sie die volle Kontrolle über Ihre Test-Szenarien.

Test-Szenario für EXTERNAL_VALIDATION_FAILED

Dieser Status tritt auf, wenn eine Submission von ELSTER abgelehnt wird. Sie können ihn gezielt auslösen, indem Sie im Endpunkt UpsertClientAdditionalData den clientType auf 4 (taximeter) oder 5 (odometer) setzen und das Feld remarks leer lassen. In diesem Fall lehnt ELSTER die Submission ab.

Verzögerungen simulieren

Wir unterstützen das Simulieren von Verzögerungen (z.B. VALIDATION_TRIGGERED, TRANSMISSION_IN_PROGRESS) innerhalb unserer Umgebung nicht. Das Verhalten auf Ihrer Seite zu simulieren ist die effektivste Lösung.

Wie registriert man ein Kassensystem, das zuvor mit einer nicht mehr verwendbaren TSE verbunden war?

Wenn die einem Kassensystem ursprünglich zugewiesene TSE defekt ist und nicht mehr verwendet werden kann, muss eine neue TSE registriert werden. Um die Einhaltung der gesetzlichen Vorgaben sicherzustellen und doppelte Einträge zu vermeiden, sind beim Einsatz der Submission API folgende Schritte zu beachten:

Szenario

Sie möchten ein Kassensystem weiterhin verwenden, aber die bisher zugewiesene TSE ist nicht mehr funktionsfähig. In diesem Fall gilt:

• Es muss ein neuer Client (mit einer neuen client_id) erstellt werden.

• Es sollte dieselbe serial_number verwendet werden, da die Hardware (das Kassensystem) unverändert bleibt.

• Der alte Client, der mit der defekten TSE verbunden war, muss aus der Submission/Transmission entfernt werden, um doppelte Einträge zu vermeiden.

So funktioniert’s

1. Neue TSE erstellen

Nutzen Sie die SIGN DE API, um eine neue TSE zu erstellen, die die defekte TSE ersetzt.

2. Neuen Client erstellen

Erstellen Sie einen neuen Client mit neuer client_id. Verwenden Sie dieselbe serial_number wie zuvor – sie repräsentiert die unveränderte Kassensystem-Seriennummer.

3. Alten Client über die Submission API entfernen

Verwenden Sie den DELETE-Endpunkt der Submission API, um den alten Client aus der Submission zu löschen (DeleteClientAdditionalData). Dieser Schritt ist entscheidend, um sicherzustellen, dass keine zwei Clients mit derselben serial_number in der Submission vorhanden sind.

Siehe auch: Wie läuft die ordnungsgemäße Außerbetriebnahme eines Clients bei Verwendung einer fiskaly TSE ab?

4. Neue Submission/Transmission erstellen

Sobald die neue TSE samt neuem Client angelegt ist und der alte Client entfernt wurde erstellen Sie eine neue Submission/Transmission, um den Prozess abzuschließen.

Hinweis

Es ist nicht notwendig, das Kassensystem selbst abzumelden. Die Kasse wird weiterhin verwendet – lediglich die TSE wurde ersetzt. Durch die erneute Verwendung derselben serial_number beim neuen Client wird eine konsistente und gültige Submission-Struktur sichergestellt.

Wie läuft die ordnungsgemäße Außerbetriebnahme eines Clients bei Verwendung einer fiskaly TSE ab?

Um einen Client (z. B. ein Kassensystem) ordnungsgemäß außer Betrieb zu nehmen, sollte folgendermaßen vorgegangen werden:

1. Client-Informationen aktualisieren

Wird ein Client nicht mehr verwendet, muss dessen Status über die Submission API aktualisiert werden:

• Verwende den Endpunkt Upsert Client Additional Data.

• Aktualisiere dabei folgende Felder:

date_decommissioning: Das Datum der Außerbetriebnahme

decommissioning_reason: Eine kurze Beschreibung oder ein Stichwort zur Angabe des Grundes

Gängige Gründe für die Außerbetriebnahme sind:

• Verkauf

• Entsorgung (z. B. Recycling oder Vernichtung)

• Diebstahl

• Defekt oder technischer Fehler

• Standortwechsel in eine andere Betriebsstätte

Wichtig: Der Client darf nicht sofort gelöscht werden. Zuerst müssen die Felder zur Außerbetriebnahme aktualisiert und die Änderungen ordnungsgemäß gemeldet werden.

2. Änderungen an die Finanzbehörden übermitteln

Innerhalb von 30 Tagen muss die aktualisierte Information durch eine neue Submission/Transmission über die Submission API übermittelt werden.

3. Client entfernen oder trennen

Nach erfolgreicher Übermittlung der Submission kann der Client entweder:

• aus dem eigenen System gelöscht oder

• von der zugehörigen Betriebsstätte entkoppelt werden, falls eine Wiederverwendung an einem anderen Standort geplant ist.

Zusammenfassung

• Aktualisierung der Client-Daten mit date_decommissioning und decommissioning_reason

• Erstellung einer Submission/Transmission zur Änderungsmeldung innerhalb von 30 Tagen

• Client nach erfolgreicher Übermittlung löschen oder entkoppeln

Weitere Details zur API finden Sie in unserer Submission API-Dokumentation.

Was ist, wenn ich nur eine kürzere Steuernummer habe?

Die Steuernummer kann je nach Format und Quelle kürzer als 13 Zeichen erscheinen. Für bestimmte digitale Prozesse – etwa die Kassenanmeldung beim Finanzamt – ist jedoch eine einheitliche 13-stellige Darstellung erforderlich. Mit dem offiziellen Steuernummer-Umrechner des BMF lässt sich aus einer älteren Steuernummer das aktuelle 13-stellige Format erzeugen. Dafür genügt die Auswahl des Bundeslands und die Eingabe der vorhandenen Nummer.

Steuernummer ≠ Steuer-ID

Wichtig: Die 13-stellige Steuernummer ist nicht mit der Steuer-Identifikationsnummer (Steuer-ID) zu verwechseln. Die Steuer-ID ist personenbezogen, besteht aus 11 Ziffern und bleibt ein Leben lang gleich. Die Steuernummer dagegen kann sich im Lauf der Zeit ändern – z. B. durch Umzug, Heirat oder Änderung des Finanzamts.

Wo finde ich die 13-stellige Steuernummer?

Die Steuernummer ist in verschiedenen offiziellen Dokumenten zu finden, z. B.:

• Einkommensteuerbescheid

• Lohnsteuerbescheinigung oder Gehaltsabrechnung

• Freistellungsauftrag bei der Bank

Sollte die Nummer nicht auffindbar sein, hilft das zuständige Finanzamt telefonisch oder schriftlich weiter.

 

💡 In der fiskaly SIGN DE x Submission API entspricht die Steuernummer dem Feld tax_number.

 

Mit dem Steuernummer-Umrechner des BMF lässt sich eine landesspezifische Steuernummer ganz einfach in die bundeseinheitliche 13-stellige ELSTER-Steuernummer umwandeln.

Was ist die 13-stellige Steuernummer?

Die 13-stellige Steuernummer spielt eine zentrale Rolle für die steuerliche Identifikation von Unternehmen und Selbstständigen in Deutschland. Sie wird vom zuständigen Finanzamt vergeben und dient der eindeutigen Zuordnung aller steuerlichen Vorgänge – von der Einkommensteuer bis zur Umsatzsteuer.

Aufbau der Steuernummer

Seit der Einführung des ELSTER-Verfahrens besteht die Steuernummer aus 13 Zeichen. Sie setzt sich aus mehreren Komponenten zusammen:

Finanzamtsnummer (2–3 Ziffern): Die letzten Stellen der Kennziffer des zuständigen Finanzamts

Bezirksnummer (3–4 Ziffern): Je nach Bundesland unterschiedlich lang

Unterscheidungsnummer (3–4 Ziffern): Individuelle Ziffernfolge zur Unterscheidung von Steuerpflichtigen

Prüfziffer (1 Stelle): Dient der Fehlererkennung

❗ Achtung: Die genaue Zusammensetzung kann je nach Bundesland variieren. In Nordrhein-Westfalen ist zum Beispiel die Bezirksnummer 4-stellig und die Unterscheidungsnummer 3-stellig – in anderen Ländern ist es umgekehrt.

Mit dem Steuernummer-Umrechner des BMF lässt sich eine landesspezifische Steuernummer ganz einfach in die bundeseinheitliche 13-stellige ELSTER-Steuernummer umwandeln.

Welche BSI-Zertifikats-ID sollte für eine fiskaly TSE verwendet werden?

Die aktuelle fiskaly SIGN DE v2 TSE BSI Zertifikatsnummer lautet:

• ID 0717-2025

Wie Sie die BSI-Zertifikatsnummer für Ihre TSE finden erfahren Sie außerdem hier:

Welche BSI-Zertifikatsnummer hat meine TSE?

Wo finde ich die TSE Seriennummer?

Die TSE Seriennummer ist im fiskaly Dashboard in der Detailansicht der TSE zu finden (“Serien Nr. des Zertifikats”), und wird auch in der Response des SIGN DE V2 Endpunkts retrieveTss zurückgegeben (serial_number).

Darüber hinaus kann die TSE Seriennummer auch ausgelesen werden, wenn Sie unsere fiskalcheck App zum Scannen des QR-Codes am Beleg verwenden.

Alle weiteren Daten, die zur Erfüllung der Mitteilungspflicht benötigt werden, bekommen Sie von Ihrem Kassenhersteller.

Wann tritt die Mitteilungspflicht für elektronische Aufzeichnungssysteme in Kraft?

Ab dem 1. Januar 2025 treten neue Regelungen zur Mitteilungspflicht für elektronische Aufzeichnungssysteme in Kraft. Basierend darauf müssen alle elektronischen Aufzeichnungssysteme dem Finanzamt gemeldet werden. Die Mitteilungspflicht betrifft sowohl Kassen(-systeme) als auch EU-Taxameter und Wegstreckenzähler.

Um die Einhaltung dieser gesetzlichen Anforderungen zu gewährleisten, ermöglicht die fiskaly SIGN DE x Submission API eine schnelle und effiziente Meldung der Kassen beim Finanzamt.

Wichtige Fristen:

• Systeme, die vor dem 1. Juli 2025 angeschafft wurden, müssen bis zum 31. Juli 2025 gemeldet werden.

• Systeme, die ab dem 1. Juli 2025 angeschafft werden, müssen innerhalb eines Monats nach der Anschaffung gemeldet werden.

• Ebenso gilt, dass außer Betrieb genommene Systeme ab dem 1. Juli 2025 innerhalb eines Monats nach der Außerbetriebnahme gemeldet werden müssen.

Vor der Meldung der Außerbetriebnahme eines Systems muss die Anschaffung bereits gemeldet worden sein. Systeme, die vor dem 1. Juli 2025 endgültig außer Betrieb genommen wurden und nicht mehr in Betrieb sind, müssen nur gemeldet werden, wenn ihre Anschaffung bereits gemeldet wurde.

Für EU-Taxameter und Wegstreckenzähler gelten besondere Vorschriften. Details dazu finden Sie in unserem Blog.

Welchen Wert soll ich für die BSI-ID übergeben?

Wenn Sie über den Endpunkt Create or update an external TSS eine externe TSE zu Ihrer Betriebsstätte (Establishment) hinzufügen, muss das erforderliche Feld bsi_id übergeben werden.

Die BSI-ID entspricht der ID des vom Bundesamt für Sicherheit in der Informationstechnik (BSI) ausgestellten Zertifikats.

Die Zertifizierungs-ID der fiskaly TSE, sowie jene von anderen zertifizierten technischen Sicherheitseinrichtungen, ist auf der offiziellen Webpage des BSI angeführt.

 

Beispiel:

Name: fiskaly sign Cloud-TSE

Zertifizierungs-ID: BSI-K-TR-0717-2025

Die BSI-ID, die im Feld bsi_id übergeben werden soll, lautet 0717-2025.