Für SIGN DE-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 implementiert haben.
Diese API wurde in Zusammenarbeit mit der Steuerverwaltung des Landes Hessen entwickelt.
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: Zusatzdaten eines SIGN DE-Clients anlegen oder aktualisieren
Abschnitt betitelt „PUT: Zusatzdaten eines SIGN DE-Clients anlegen oder aktualisieren“Ein Client repräsentiert ein im Einsatz befindliches Kassensystem. Um Einreichungen zu erstellen, müssen zusätzliche Informationen über Clients hinzugefügt werden, die bereits in fiskaly SIGN DE existieren.
Ein Client kann nur einer Betriebsstätte zugewiesen werden. Für jede Betriebsstätte muss der Steuerpflichtige eine separate Einreichung mit allen dieser Betriebsstätte zugeordneten Clients erstellen.
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.
Zusatzdaten sind nur für fiskaly SIGN DE-Clients erforderlich. Zusatzdaten für fiskaly SIGN DE TSS-Instanzen werden nicht benötigt.
Optional PUT: Externe TSS anlegen oder aktualisieren (d. h. eine TSS eines anderen Herstellers als fiskaly)
Abschnitt betitelt „Optional PUT: Externe TSS anlegen oder aktualisieren (d. h. eine TSS eines anderen Herstellers als fiskaly)“Wenn eine Betriebsstätte neben fiskaly SIGN DE-TSSs auch externe TSSs verwendet, müssen die externen TSSs ü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.
Optional PUT: Externen Client anlegen oder aktualisieren (d. h. bei Verwendung einer TSS eines anderen Herstellers als fiskaly)
Abschnitt betitelt „Optional PUT: Externen Client anlegen oder aktualisieren (d. h. bei Verwendung einer TSS eines anderen Herstellers als fiskaly)“Wenn Nicht-fiskaly-TSSs verwendet werden, werden die mit ihnen verbundenen Clients über diesen Endpunkt hinzugefügt.
Externe Clients erfordern das Vorhandensein entsprechender externer TSSs und müssen diesen zugewiesen werden.
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 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?