Für externe Kunden
Dieser Leitfaden bietet einen Überblick über die Schritte, die erforderlich sind, um die geforderten Daten gemäß den gesetzlichen Anforderungen (§ 146a Abs. 4 AO – Abgabenordnung) an die Steuerbehörden zu übermitteln. Er richtet sich an Kunden, die die fiskaly SIGN DE API nicht implementiert haben.
Diese API wurde in Zusammenarbeit mit der Steuerverwaltung des Landes Hessen entwickelt.
Der Leitfaden besteht aus zwei Teilen: Grundeinrichtung und Hauptteil — SIGN DE x Submission-Endpunkte.
Teil 1: Grundeinrichtung
Abschnitt betitelt „Teil 1: Grundeinrichtung“Konto erstellen
Abschnitt betitelt „Konto erstellen“Um die fiskaly-Dienste nutzen zu können, müssen Sie ein Konto über den fiskaly HUB erstellen. Nach der Erstellung eines Kontos werden Sie aufgefordert, Ihre erste Hauptorganisation anzulegen.
Erste Organisation erstellen
Abschnitt betitelt „Erste Organisation erstellen“Die erste (Haupt-)Organisation, die den Kassenhersteller repräsentiert, muss über den fiskaly HUB erstellt werden. Sobald sie erstellt wurde, können Sie damit fortfahren, verwaltete Organisationen hinzuzufügen, die die einzelnen Standorte des Steuerpflichtigen repräsentieren. Es ist möglich, der Struktur eine weitere Ebene hinzuzufügen — eine Anleitung dazu finden Sie hier.
Sehen Sie sich unser Video für eine schrittweise Erklärung zur Einrichtung Ihres Kontos und Ihrer ersten Organisation an.
Eine Hauptorganisation (organization) repräsentiert einen Kassenhersteller oder einen Händler
mit eigenem Kassensystem, während eine verwaltete Organisation (managed_ organization) einen Standort des Händlers oder einen Filialstandort des Händlers repräsentiert.
Beispiele:
- Wenn die Hauptorganisation ein Kassenhersteller ist, repräsentieren die verwalteten Organisationen den Standort jedes Kunden (Steuerpflichtigen).
- Wenn die Hauptorganisation ein Händler mit eigenem Kassensystem ist, repräsentieren die verwalteten Organisationen jede Filiale.
Ersten API-Schlüssel erstellen
Abschnitt betitelt „Ersten API-Schlüssel erstellen“Nach der Erstellung eines Kontos und Ihrer ersten Organisation über den HUB müssen Sie im HUB einen API-Schlüssel generieren (Einstellungen -> API-Schlüssel -> API-SCHLÜSSEL ERSTELLEN).
API-Schlüssel und Secret sind erforderlich, um über den authenticate-Endpunkt einen Zugriffstoken zu generieren. Dieser Token wird für alle API-Aufrufe verwendet.
POST: Organisation erstellen
Abschnitt betitelt „POST: Organisation erstellen“Verwenden Sie diesen Endpunkt, um eine verwaltete Organisation zu erstellen. Verwenden Sie die ID der
Hauptorganisation für das Feld managed_by_organization_id in Ihrem
Anfragekörper. Wir empfehlen dringend, für jeden Standort eine separate verwaltete
Organisation einzurichten. Auf diese Weise kann eine Struktur erstellt werden,
bei der eine verwaltete Organisation einer Betriebsstätte entspricht.
Teil 2: SIGN DE x Submission-Endpunkte
Abschnitt betitelt „Teil 2: SIGN DE x Submission-Endpunkte“POST: API authentifizieren
Abschnitt betitelt „POST: API authentifizieren“Um auf die SIGN DE x Submission API zugreifen zu können, benötigen Sie ein gültiges JWT-Token.
Dieser Endpunkt erstellt das Token mit Ihrem api_key und api_secret. Falls Sie keinen api_key haben, können Sie diesen über den Management API-Endpunkt createApiKey oder über den fiskaly HUB erstellen. Das api_secret wird Ihnen nach der Erstellung des api_key generiert. Das Token muss bei jeder folgenden Anfrage im Authorization-Header-Feld nach dem Bearer-Authentifizierungsschema mitgesendet werden.
PUT: Steuerpflichtigen anlegen oder aktualisieren
Abschnitt betitelt „PUT: Steuerpflichtigen anlegen oder aktualisieren“Der Steuerpflichtige repräsentiert entweder eine natürliche Person oder eine juristische Person wie ein Unternehmen. Allgemeine Informationen über den Steuerpflichtigen müssen hier angegeben werden. Er wird nur einmal angelegt und kann aktualisiert werden, ohne eine neue Einreichung auszulösen.
Innerhalb jeder (managed_)organization darf nur ein Steuerpflichtiger angelegt werden und sollte auch nur einer angelegt werden.
PUT: Betriebsstätte anlegen oder aktualisieren
Abschnitt betitelt „PUT: Betriebsstätte anlegen oder aktualisieren“Die Betriebsstätte repräsentiert jeden physischen Geschäftsstandort und muss auch dann angelegt werden, wenn die Betriebsstättendaten identisch mit denen des Steuerpflichtigen sind.
Für Kunden, die eine separate managed_organization für jeden Standort angelegt haben, entspricht die managed_organization immer einer spezifischen Betriebsstätte. Dies ist der empfohlene Ansatz.
Falls eine managed_organization mehr als einen Standort desselben Steuerpflichtigen repräsentiert, muss für jeden dieser Standorte eine separate Betriebsstätte angelegt werden.
Jeder Steuerpflichtige kann mehrere Betriebsstätten besitzen, aber jede Betriebsstätte kann nur einem Steuerpflichtigen gehören und nur eine einzige Adresse haben.
Die Erstellung und Aktualisierung von TSS und Clients, die einer Betriebsstätte zugewiesen sind, erfordern immer eine neue Einreichung der betreffenden Betriebsstätte als Ganzes. Andere Betriebsstätten erfordern in diesem Fall keine neue Einreichung.
PUT: Externe TSS anlegen oder aktualisieren (d. h. eine TSS eines anderen Herstellers als fiskaly)
Abschnitt betitelt „PUT: Externe TSS anlegen oder aktualisieren (d. h. eine TSS eines anderen Herstellers als fiskaly)“Eine TSS steht für ein Technisches Sicherheitssystem. Es ist eine Gruppe von Komponenten, die zur Sicherung, Speicherung und Verwaltung von Steuerdaten verwendet werden.
Externe TSSs müssen über diesen Endpunkt hinzugefügt werden.
Dieser Endpunkt ist für Kunden, die die fiskaly SIGN DE API implementiert haben und keine externen TSSs verwenden, nicht verpflichtend.
PUT: Externen Client anlegen oder aktualisieren (d. h. bei Verwendung einer TSS eines anderen Herstellers als fiskaly)
Abschnitt betitelt „PUT: Externen Client anlegen oder aktualisieren (d. h. bei Verwendung einer TSS eines anderen Herstellers als fiskaly)“Ein Client repräsentiert ein im Einsatz befindliches Kassensystem. Clients, die mit externen TSS-Instanzen verbunden sind, werden über diesen Endpunkt hinzugefügt.
Die Außerbetriebnahme eines Clients muss nur einmal gemeldet werden, indem die entsprechenden Parameter gesetzt und eine neue Einreichung für die betreffende Betriebsstätte ausgelöst wird. Danach kann der Client von der Betriebsstätte abgemeldet und/oder einer anderen Betriebsstätte als in Betrieb genommener Client zugewiesen werden, gefolgt von einer neuen Einreichung für die betreffende Betriebsstätte.
Dieser Endpunkt ist für Kunden, die die fiskaly SIGN DE API implementiert haben und keine externen TSSs verwenden, nicht verpflichtend.
PUT: Einreichung erstellen
Abschnitt betitelt „PUT: Einreichung erstellen“Eine Einreichung ist die Gesamtheit der Informationen über eine bestimmte Betriebsstätte mit allen ihren Clients. Sie wird nicht automatisch an die Steuerbehörden übermittelt — es muss eine zusätzliche Anfrage über den Endpunkt TriggerTransmission gestellt werden.
Um eine Einreichung zu übermitteln, ist es erforderlich, zuvor die Vorschau-PDF über den Endpunkt GetValidationSuccessfulFile herunterzuladen und einzusehen.
API-Integratoren müssen sicherstellen, dass die tatsächlichen Steuerpflichtigen die generierten Einreichungsdaten auf Korrektheit geprüft haben, bevor diese an die Steuerbehörden gesendet werden.
PUT: Übermittlung auslösen
Abschnitt betitelt „PUT: Übermittlung auslösen“Die Übermittlung ist der Prozess, bei dem die Daten aus der Einreichung an den ELSTER-Server (ELektronische STeuer ERklärung) übertragen werden. Pro Einreichung kann nur eine Übermittlung ausgelöst werden.
Einmal ausgelöst, kann eine Übermittlung storniert werden, solange sie noch in der SIGN DE x Submission API bearbeitet wird und noch nicht an ELSTER übertragen wurde. Da die Übermittlung in der Regel innerhalb weniger Sekunden erfolgt, ist das Zeitfenster für eine erfolgreiche Stornierung kurz. Nach einer erfolgreichen Stornierung kann eine Übermittlung für die betreffende Einreichung erneut ausgelöst werden.
Verwenden Sie diesen Endpunkt, um eine Übermittlung einer bestimmten Einreichung an die Steuerbehörden auszulösen. Bitte beachten Sie, dass dies nur möglich ist, wenn sich die Einreichung im Status READY_FOR_TRANSMISSION befindet, was anzeigt, dass die in der Einreichung enthaltenen Daten auf syntaktische Gültigkeit und Vollständigkeit geprüft wurden. Dies ist jedoch keine Bestätigung der sachlichen Richtigkeit.
Der Steuerpflichtige ist gesetzlich verpflichtet, die Einreichungsdaten auf Korrektheit zu prüfen, bevor die Übermittlung ausgelöst wird. Das Auslösen der Einreichung zeigt die Zustimmung des Steuerpflichtigen und die Übernahme der Verantwortung für die Richtigkeit der übermittelten Daten an. Falls fehlerhafte Daten in eine übermittelte Einreichung aufgenommen wurden, kann dies behoben werden, indem einfach eine neue Einreichung mit den korrekten Daten erstellt und übermittelt wird.
Was this page helpful?