fiskaltrust APIs
Die Schicht zwischen Ihrem Kassensystem und der Finanzbehörde.
Drei APIs decken die Arbeit an der Kasse, den Rollout dahinter und den Beleg in der Hand des Kunden ab. Alle drei laufen auf derselben Middleware und mit denselben Zugangsdaten.
API-Schicht
- Ihr Kassensystem – Kasse · App · ERP
- API-Schicht – POS System · PosDealer · Receipt
- STEUER – signiert & gemeldet
- ARCHIV – revisionssicher
- KUNDE – digitaler Beleg
Eine Schicht vor der Middleware. Drei Ziele hinter jedem Verkauf.
- Kern-APIs, ein Set an Zugangsdaten
- 3
- Endpunkte in der POS System API
- 5
- Protokolle, REST und gRPC
- 2
- Märkte hinter derselben Schnittstelle
- 7
ORIENTIERUNG
Die richtige API für Ihre Aufgabe.
Jede API erfüllt eine Rolle im Ökosystem. Wählen Sie Ihre Zeile und folgen Sie dem Link.
| Ihre Aufgabe | Ihre API | Das erhalten Sie | |
|---|---|---|---|
| Sie entwickeln ein Kassensystem | POS System API | Fiskalisieren, bezahlen, Belege ausgeben und exportieren, direkt an der Kasse, in sieben Märkten | Mehr erfahren |
| Sie rollen an vielen Standorten aus | PosDealer API | Betreiber einbinden, Produkte produzieren und Installationen gebündelt konfigurieren | Mehr erfahren |
| Sie liefern digitale Belege | Receipt API | Belege erstellen, speichern und über alle Kundenkanäle übergeben | Mehr erfahren |
POS SYSTEM API
Die API für die Kasse.
Die zentrale Schnittstelle zwischen Ihrem Kassensystem und der Middleware. Senden Sie die Transaktion einmal. Die API signiert nach dem jeweiligen nationalen Recht, löst die Zahlung aus, gibt den Beleg aus und exportiert die Journale.
Fünf Endpunkte decken den gesamten Fiskalisierungsablauf ab:
Beleg-Fiskalisierung
Signieren, Verketten und Nummerieren im gesetzlichen Format des jeweiligen Landes, in einer einzigen Antwort.
Zahlungsabwicklung
Ein erneuter Aufruf während der Verarbeitung wartet, bis der ursprüngliche Vorgang abgeschlossen ist, und liefert dann dessen Ergebnis.
Belegausgabe und Export
Auf Papier oder digital zustellen und Prüfdaten bei Bedarf im nationalen Format exportieren.
POS DEALER API
Die API für den Rollout.
Für POS Dealer und Plattformen mit vielen Standorten. Automatisieren Sie die Schritte vom unterschriebenen Rahmenvertrag bis zur produktiven Kasse, ohne Techniker in jedem Geschäft.
Betreiber-Onboarding
Betreiberkonten anlegen und verwalten, einschließlich automatischer Einladungen.
Produktproduktion
Kontingente auflisten und Queue- oder Outlet-Produkte passend zu Ihren Rollout-Plänen produzieren.
Zugriff auf Konfigurationen
Middleware-Konfigurationen je Betreiber direkt aus Ihren eigenen Systemen abrufen und auflisten.
Gebündelter Rollout
Standorte gebündelt mit vorkonfigurierten Vorlagen bereitstellen. Die Vor-Ort-Zeit pro Standort sinkt von Stunden auf Minuten.
RECEIPT API
Die API für Kunden.
Standardisierte ReceiptRequest- und ReceiptResponse-Strukturen tragen jeden Beleg vom Verkauf bis zum Kunden.
Belege liegen in der fiskaltrust.Cloud hinter manipulationssicheren HTTPS-Links, bereit für Wallet, E-Mail, SMS oder QR-Code.
Anfrage
Das Kassensystem sendet einen ReceiptRequest mit den Transaktionsdaten.Signieren und speichern
Die Middleware fiskalisiert den Beleg und speichert die digitale Version in der fiskaltrust.Cloud.Link
Die Antwort enthält einen eindeutigen, manipulationssicheren HTTPS-Link zum Beleg.Zustellen
Der Kunde erhält den Beleg per QR-Code, E-Mail, SMS oder Wallet. Feedback und Treueprogramme hängen am selben Link.
Eine API für jede Aufgabe. Darunter dieselbe Middleware.
VERSIONEN UND REFERENZEN
Jede Schnittstelle dokumentiert und versioniert.
Jede Referenz unten verweist auf die Dokumentationsplattform. Bestehende Integrationen auf der klassischen Middleware-Schnittstelle bleiben dokumentiert und werden weiter unterstützt. Neue Integrationen starten mit der POS System API.
- POS System API 2.1Die aktuelle Version der Kassenschnittstelle. Neue Integrationen starten hier.
- POS System API 2.0Die vorherige Version, für laufende Integrationen vollständig dokumentiert.
- PosDealer APIDie Referenz zur Rollout-Automatisierung für POS Dealer und Plattformen.
- Receipt APIDie Referenz zum digitalen Beleg, von ReceiptRequest bis zur Zustellung.
- Middleware API v1Die klassische IPOS-Schnittstelle, die bestehende Produktivinstallationen weiterhin trägt.
- API-BeispieleFunktionierende Request-Beispiele für die Middleware-Schnittstelle, pro Markt.
GRUNDLAGE
Gebaut für große Mengen.
Die API-Schicht verarbeitet täglich über 5 Mio. Belege in sieben Märkten. Die folgenden Designentscheidungen halten Integrationen stabil, wenn sich Regulierung, Hardware oder Volumen ändern.
Asynchrone Verarbeitung
Lang laufende Vorgänge kehren zurück, ohne die Kasse zu blockieren. Der Checkout bleibt auch unter Last schnell.
Abstraktion der Signaturgeräte
Hardware-TSE, Cloud-TSE, Smartcard oder Online-Dienst. Ihr Code ruft eine Schnittstelle auf, die SCU kümmert sich um das Gerät.
SDKs und CLI-Tools
Clientbibliotheken und Kommandozeilen-Tools verkürzen den Weg von der Spezifikation zum laufenden Code, offen auf GitHub.
Sandbox pro Markt
Testen Sie gegen eine nahezu vollständige Kopie des Live-Systems, bevor Sie Ihren ersten Beleg im Echtbetrieb erzeugen.
SELF-SERVICE
Alles, was Sie vor einem Gespräch brauchen.
Beurteilen Sie Machbarkeit und Eignung nach Ihren eigenen Kriterien. Der Stack ist dokumentiert, öffentlich und schon heute testbar.
Dokumentation
Dokumentation lesenVollständige API-Referenz, Integrationsleitfäden und Fehlersemantik auf Englisch unter docs.fiskaltrust.eu.
GitHub
Repos ansehenMiddleware-Quellcode, Launcher, Devkit und Demo-Implementierungen, offen einsehbar.
Sandbox
Zugang erhaltenEine nahezu vollständige Kopie des Live-Systems. Signieren Sie Testbelege ohne rechtliche Verpflichtung.
Academy
Programm ansehenStrukturiertes Onboarding für Ihr Team, von der ersten Anfrage bis zum zertifizierten Rollout.
FAQ
Bevor Sie eine API wählen.
Klare Antworten auf die Fragen, die Integrationsteams zuerst stellen.
Teilen sich die drei APIs die Zugangsdaten?
Ja. Ein Konto im fiskaltrust.Portal enthält die Zugangsdaten für jede API, die Sie nutzen. Keine getrennten Verträge pro Schnittstelle.
Mit welcher API beginnt eine typische Integration?
Mit der POS System API. Signieren Sie zuerst einen Sandbox-Beleg und ergänzen Sie dann die PosDealer API für die Rollout-Automatisierung und die Receipt API für die Zustellung an Kunden.
Deckt eine Integration alle sieben Märkte ab?
Ja. Die Schnittstelle bleibt identisch. Die länderspezifische Logik liegt in der Middleware und wird zentral aktualisiert, wenn sich eine Vorschrift ändert.
REST oder gRPC?
Beide bieten den vollen Funktionsumfang der API. Wählen Sie REST für den kürzesten Einstieg und gRPC für hohe Transaktionsvolumen. SOAP bleibt für Altsysteme verfügbar.
Wo teste ich ohne rechtliche Verpflichtung?
In der Sandbox. Das Sandbox-Portal stellt Testzugangsdaten aus, und mit der POS-System-ID aus lauter Nullen signieren Sie Testbelege schon vor der Registrierung.
Wählen Sie Ihre API. Signieren Sie Ihren ersten Beleg.
Der Quickstart auf der Entwicklerseite führt Sie von null zu einem signierten Sandbox-Beleg. Die Dokumentation enthält die vollständige Referenz für alle drei APIs.