Für SIGN DE-Kunden

SIGN ES-Integrationsleitfaden für SIGN DE-Kunden

Dieser Leitfaden hilft Ihnen, die fiskaly SIGN ES API erfolgreich zu integrieren, und beschreibt alle notwendigen Schritte, die Sie und Ihre Händler unternehmen müssen.

Einrichtung – Organisationen erstellen

Die Erstellung und Einrichtung von Organisationen funktioniert genauso wie bei SIGN DE.

Hinweis: Bei SIGN ES repräsentiert jede verwaltete Organisation einen Steuerpflichtigen (identifiziert durch seine NIF/Steuer-ID). Sie müssen eine verwaltete Organisation pro Steuerpflichtigen erstellen – nicht pro Standort oder Filiale.

Die Erstellung von (verwalteten) Organisationen erfolgt über die fiskaly Management API. Das Hinzufügen von Nutzern und das Erstellen von API-Schlüsseln erfolgt ebenfalls über die Management API. Unser Leitfaden zum Integrationsprozess beschreibt diese ersten Schritte näher.

SIGN ES

Da Sie bereits mit unserer SIGN DE API vertraut sind, sollte die Implementierung von SIGN ES recht einfach sein. Der Prozessablauf wurde so gestaltet, dass er für beide APIs identisch ist. Um den Prozess noch weiter zu vereinfachen, werden Unterschiede und Gemeinsamkeiten zu SIGN DE in den einzelnen Endpunkten hervorgehoben.

SIGN ES vs. SIGN DE

Sobald die Organisationsstruktur erstellt wurde, können Sie Schritt für Schritt mit den folgenden SIGN ES API-Endpunkten fortfahren:

PUT: Steuerpflichtigeninformationen erstellen

Verwenden Sie diesen Endpunkt, um den Steuerpflichtigen zu erstellen. Dieser Schritt muss nur einmal durchgeführt werden.

Steuerpflichtiger: Bei SIGN ES repräsentiert eine verwaltete Organisation einen Steuerpflichtigen und sein steuerliches Gebiet (die gesetzliche Adresse des Unternehmens). Innerhalb jeder verwalteten Organisation muss ein Steuerpflichtiger erstellt werden. Wichtig: Im Falle einer Änderung der Steuerpflichtigendaten muss eine neue verwaltete Organisation erstellt werden, da die Daten des Steuerpflichtigen nachträglich nicht geändert werden können.

📘Unterschiede zu SIGN DE

Derzeit gibt es keinen entsprechenden Endpunkt in SIGN DE.

PUT: Unterzeichner erstellen

Verwenden Sie diesen Endpunkt, um mindestens einen Unterzeichner zu erstellen. Bezüglich der Felder private_key und public_key: Diese Zertifikatsinformationen werden von fiskaly bereitgestellt.

Unterzeichner: Bei SIGN ES repräsentiert ein Unterzeichner das Signiergerät. Es muss mindestens ein Unterzeichner erstellt werden, aber in Szenarien mit einem besonders hohen Rechnungsvolumen können mehrere Unterzeichner erstellt werden. Der Unterzeichner enthält ein Zertifikat, das dem Steuerpflichtigen auf den Servern der Steuerbehörde zugeordnet werden muss.

Hinweis: Dieses Gerätezertifikat wird von fiskaly bereitgestellt oder, falls verfügbar, können Sie auch ein vorhandenes verwenden.

💡Gemeinsamkeiten mit SIGN DE

Der Unterzeichner entspricht der TSS in SIGN DE. Im Gegensatz zu SIGN DE kann ein Unterzeichner sofort verwendet werden, da er keine unterschiedlichen Zustände hat. Daher ist der Implementierungsprozess noch einfacher.

PUT: Client erstellen

Verwenden Sie diesen Endpunkt, um einen Client zu erstellen. Der Client identifiziert eindeutig ein Terminal, ein Kassensystem, eine Anwendung oder andere Geräte, die zur Rechnungsausstellung verwendet werden.

Clients: Bei SIGN ES repräsentiert ein Client das Kassensystem. Um Rechnungen auszustellen, benötigen Sie einen Client pro Kassensystem und mindestens ein Signiergerät.

💡Gemeinsamkeiten mit SIGN DE

Der Client entspricht der Client-Entität in SIGN DE. Jeder Client ist mit einem Unterzeichner verbunden – genauso wie jeder Client in SIGN DE mit einer TSS verbunden ist, mit dem einzigen Unterschied, dass die Verbindung zwischen Client und Unterzeichner in SIGN ES im Request Body und nicht in den Path-Parametern hergestellt wird.

• In SIGN ES können Clients zwei Zustände haben: ENABLED und DISABLED.
• In SIGN DE sind die entsprechenden Zustände REGISTERED und DEREGISTERED.

Hinweis: Im Gegensatz zu SIGN DE ist das Setzen des Client-Zustands auf DISABLED in SIGN ES nicht umkehrbar.

PUT: Rechnung erstellen

Verwenden Sie diesen Endpunkt, um eine Rechnung zu erstellen. client_id und invoice_id in den Path-Parametern müssen von Ihnen definiert werden.

Rechnungen: In SIGN ES gibt es sechs Arten von Rechnungen: vereinfachte Rechnung, vollständige Rechnung, Berichtigungsrechnung, Anreicherungsrechnung, externe Rechnung und Abhilferechnung:

1. Die vereinfachte Rechnung enthält nur Informationen über den Aussteller, aber keine Informationen über den Rechnungsempfänger. Diese Rechnung kann nur bis zu einem Betrag von 400 € und in einigen spezifischen Fällen bis zu einem Betrag von 3.000 € ausgestellt werden (Einzelhandel, Restaurants, Parkdienstleistungen…).
2. Die vollständige Rechnung enthält Informationen sowohl über den Aussteller als auch über den Empfänger der Rechnung. Dies ist die am häufigsten verwendete Art für Dienstleistungen von Freiberuflern oder Unternehmen.
3. Die Berichtigungsrechnung muss ausgestellt werden, wenn ein Fehler aufgetreten ist, z. B. bei einem falschen Betrag. Bei dieser Rechnung müssen Händler angeben, ob es sich um eine Berichtigung durch Ersetzung oder eine Berichtigung durch Differenzen handelt.
4. Die Anreicherungsrechnung kann ausgestellt werden, wenn die ursprüngliche Rechnung ohne Empfänger erstellt wurde und die einzige erforderliche Änderung das Hinzufügen von Empfänger(n) ist.
5. Die externe Rechnung dient dazu, Details von Rechnungen einzugeben, die vor der Integration der SIGN ES API ausgestellt wurden. Dies dient dazu, sicherzustellen, dass Korrekturen gemäß den Vorschriften vorgenommen werden können. Die Erstellung einer externen Rechnung löst keine Übertragung an die Steuerbehörden aus und erzeugt auch keine XML-Datei für die Rechnung. Sobald eine externe Rechnung erstellt und eine UUID zugewiesen wurde, kann diese UUID beim Ausstellen einer Berichtigungs- oder Anreicherungsrechnung referenziert werden.
6. Die Abhilferechnung kann ausgestellt werden, um falsche Rechnungsinformationen zu berichtigen, die gesetzlich keine Korrektur erfordern.

💡Gemeinsamkeiten mit SIGN DE

Rechnungen in SIGN ES entsprechen Transaktionen in SIGN DE. Im Gegensatz zu SIGN DE werden Rechnungen direkt an die zuständige Steuerbehörde übermittelt. Die Antwort gibt die signierte Rechnung zurück und enthält auch den Status der Synchronisierung und Übertragung an die zuständige Steuerbehörde.

📘Unterschiede zu SIGN DE

Da es in Spanien keine Vorschrift gibt, die verlangt, dass Transaktionen gestartet, aktualisiert und abgeschlossen werden müssen, ist dieser Teil von SIGN ES viel einfacher als SIGN DE. Im Gegensatz zu SIGN DE müssen Rechnungen, die an den Verbraucher übergeben werden, einen Identifikationscode und einen QR-Code enthalten, die gemäß spezifischen Richtlinien platziert werden müssen.

Details finden Sie hier: Rechnungskonformität.

PATCH: Rechnung aktualisieren

Verwenden Sie diesen Endpunkt, um eine Rechnung zu aktualisieren. Dieser Endpunkt sollte nur verwendet werden, um eine bereits erstellte Rechnung zu stornieren.

📘Unterschiede zu SIGN DE

In SIGN DE gibt es keinen speziellen Endpunkt zum Stornieren von Belegen. Die Handhabung von Stornierungen in Spanien ist daher viel einfacher.

Wie erstellt man einen digitalen Beleg?

Nach dem Erstellen einer Rechnung können Sie mithilfe unseres digitalen Belegendpunkts einen digitalen Beleg für Ihre Rechnung erstellen. Die zurückgegebene URL kann dem Verbraucher beim Checkout-Prozess einfach als QR-Code angezeigt werden, und der Beleg muss nicht mehr ausgedruckt werden. Dies spart Kosten, schützt die Umwelt, erhöht die Kundenzufriedenheit und schafft einen neuen Kundenkontaktpunkt für den Händler.

Um mehr über den digitalen Beleg über seine grundlegende Funktionalität hinaus zu erfahren, wie Sie die Kundentreue verbessern und das fiskaly-Partner-Ökosystem nutzen können, kontaktieren Sie uns unter sales@fiskaly.com. Für die Visualisierung eines solchen digitalen Belegs werfen Sie einen Blick auf unseren Leitfaden für digitale Belege und nutzen Sie gerne unsere öffentlich verfügbare Beleg-API.

Bereit für einen tieferen Einblick?

Werfen Sie einen Blick auf unseren SIGN ES Quick Start – wir haben eine Postman-Sammlung erstellt, mit der Sie die wichtigsten Funktionen dieser API durchgehen können.