DSFinV-K-Endpunkte

DSFinV-K-Endpunkte

Auf dieser Seite erhalten Sie einen Überblick über die relevantesten DSFinV-K-Endpunkte sowie optionale Endpunkte.

Optionale Endpunkte

Mehrwertsteuerdefinitionen und Einkaufsagenturen werden als „optional” beschrieben, da sie für die meisten Steuerpflichtigen nicht relevant sind. Die meisten Kunden können direkt mit dem Endpunkt Kasse anlegen oder aktualisieren beginnen.

Mehrwertsteuerdefinition erstellen oder aktualisieren (optional)

Die gesetzlich festgelegten Mehrwertsteuersätze werden über die API in genau derselben Reihenfolge bereitgestellt wie in den DSFinV-K-Dokumenten des Bundeszentralamts für Steuern (BZSt), siehe Anlage 2 zur DSFinV-K.

Einige Steuerpflichtige müssen möglicherweise zusätzliche Mehrwertsteuerdefinitionen mit einem vat_definition_export_id über 1000 erstellen.

Die zusätzlichen individuellen Mehrwertsteuerdefinitionen sind für jede verwaltete Organisation und für die jeweilige Umgebung (LIVE oder TEST) zu definieren. Das bedeutet, dass eine in einer verwalteten Organisation erstellte Mehrwertsteuerdefinition nur innerhalb dieser spezifischen Organisation und in der Umgebung existiert, für die sie definiert wurde.

Einkaufsagentur erstellen oder aktualisieren (optional)

Einkaufsagenturen sind nicht für jeden Steuerpflichtigen erforderlich. Eine Einkaufsagentur ist erforderlich, wenn Beträge im Namen eines Dritten erfasst werden (z. B. „Shop-in-Shop”).

Weitere Informationen finden Sie im Kapitel Anlage A Begriffsbestimmungen im DSFinV-K-Dokument des Bundeszentralamts für Steuern (BZSt).

Kasse anlegen oder aktualisieren

Für jedes im Einsatz befindliche Kassensystem muss eine Kasse erstellt werden. Kassenschnitte werden auf Ebene jeder einzelnen Kasse vorgenommen. Das Anlegen einer Kasse ist kein Bestandteil des Tagesgeschäfts; bestehende Kassen müssen jedoch bei Änderungen aktualisiert werden, zum Beispiel bei Software-Updates des Kassensystems.

Master-Terminal-Beziehung in Kassen

In den meisten Fällen ist der cash_register_type „MASTER”. Dieser Kassentyp gilt als eigenständiges Aufzeichnungssystem, das unabhängig betrieben wird. Er muss direkt mit einem TSS verbunden sein (siehe Client in SIGN DE).

In bestimmten Szenarien werden sogenannte Terminal-Kassen zusätzlich zur oben beschriebenen „MASTER”-Kasse eingesetzt. Einzelheiten zu dieser Master-Terminal-Konstellation finden Sie im DSFinV-K-Dokument des Bundeszentralamts für Steuern (BZSt) auf Seite 39. Die vom Bundesministerium der Finanzen veröffentlichten FAQs können ebenfalls hilfreich sein (insbesondere Nr. 7 zu Handheld-Geräten im Abschnitt Anwendungsbereich).

	Funktioniert unabhängig im Offline-Modus	Muss direkt mit einem TSS verbunden sein
Master-Kasse	Ja	Ja
Terminal-Kasse	Nein	Nein

Kassenschnitt einfügen

Dieser Endpunkt ist Bestandteil des Tagesgeschäfts. Ein Kassenschnitt ist eine Zusammenfassung aller relevanten Vorgänge — siehe Vorgangs- (Beleg-)typen & Geschäftsvorfalltypen — innerhalb einer Kasse (vom Typ „MASTER”) für einen bestimmten Zeitraum. Er sollte mindestens einmal täglich erstellt werden, zum Beispiel nach Ladenschluss.

Aus technischer Sicht sind einige Felder als „erforderlich” gekennzeichnet, während andere es nicht sind. Dies bedeutet jedoch nicht, dass sie aus rechtlicher Sicht leer gelassen werden können. Wann immer an einem bestimmten Tag Transaktionen durchgeführt wurden, müssen die entsprechenden Daten in den Abschnitten „transactions” und „cash_statement” des Kassenschnitts enthalten sein.

Aufbau eines Kassenschnitts

Ein Kassenschnitt besteht aus 3 Hauptteilen:

• Head: Dieser Abschnitt legt den Umfang des Kassenschnitts fest, indem er den spezifischen Tag und den Bereich der erfassten Transaktionen angibt.

• Cash Statement: Dieser Teil ist die Aggregation aller Transaktionen, dargestellt in zwei Blöcken:

  • business_cases enthält den gesamten Zahlungsfluss an der Kasse, aufgeschlüsselt nach Geschäftsvorfall.

  • payment_type enthält den gesamten Zahlungsfluss an der Kasse, aufgeschlüsselt nach Zahlungsart.

• Transactions: Dieser Teil enthält detaillierte Informationen zu jeder einzelnen Transaktion innerhalb des Kassenschnitts:

  • head enthält wesentliche Informationen zur Transaktion.

  • data liefert Details zur Transaktion.

  • security erstellt die Verknüpfung mit der TSS-Signatur. Falls keine entsprechende TSS-Signatur vorhanden ist, sollte eine Fehlermeldung angegeben werden.

Export auslösen

Verwenden Sie diesen Endpunkt, um eine DSFinV-K-Exportdatei einschließlich Kassenschnitten auszulösen. Obwohl Exporte auch über den fiskaly HUB ausgelöst werden können, empfehlen wir, diesen Endpunkt so zu implementieren, dass der Steuerpflichtige die Exportdateien direkt über Ihr System abrufen kann.

Sie haben zwei Möglichkeiten, die in der Exportdatei enthaltenen Kassenschnitte auszuwählen: ByCreationDate und ByBusinessDate. Das Erstellungsdatum bezieht sich auf den Tag, an dem die Kassenschnitte an die DSFinV-K-API übermittelt wurden. Das Geschäftsdatum bezieht sich auf den Tag, für den die Kassenschnitte bestimmt sind.

Sie können TAR oder ZIP als Exportformate wählen. Wir empfehlen das ZIP-Format, da es von gängigen Validierungstools unterstützt wird.

Je nach Datenmenge kann die Generierung der Exportdateien einige Sekunden bis zu einer Stunde dauern.

Exportdatei direkt herunterladen

Sobald die Exportdateien fertig sind, können sie über den Endpunkt Exportdatei direkt herunterladen in dem Format heruntergeladen werden, das im vorherigen Schritt angegeben wurde.