Quittung APIKonforme Quittungen miteine Integration
Mit der PosDealer API können Benutzer Berechtigungen verwalten, Installationen verfolgen und konforme Konfigurationen für Tausende von Installationen bereitstellen.
Die fiskaltrust Quittungs-API
Die fiskaltrust Receipt-API ist die zentrale Schnittstelle für die Verwaltung des Lebenszyklus von Quittungen. Sie deckt die Erstellung, das Signieren, die Ausgabe, den Transport, den Abruf und den Prüfungszugriff auf konsistente und regulierte Weise ab. Quittungen werden als zentrale Systemkomponente behandelt, unabhängig von Kanal, Gerät oder Liefermethode, und funktionieren in allen unterstützten Märkten gleich.
Mit der API können Sie sich auf Ihr System konzentrieren, während fiskaltrust sich um die Empfangsinfrastruktur kümmert. Anstatt länderspezifische Formate, Transportlogik und Edge Cases zu entwickeln und zu pflegen, verlassen Sie sich auf eine einheitliche, quelloffene API, die stabil bleibt, während sich Vorschriften und betriebliche Anforderungen ändern.
Kern-API-Funktionen
Kern-API-Funktionen
- erstellen – Quittung mit Artikeln, Zahlungen und Summen.
- sign – Wenden Sie nationale Steuerregeln, Signaturen und Hash-Verkettungen an.
- Ausgabe – Liefern Sie die Quittung in HTML, PDF, QR-Code oder per E-Mail/SMS.
- abrufen – Holen Sie Quittungen nach ID, Bestellungsreferenz oder Zeitspanne.
- verify – Überprüfen Sie Signaturen und Integrität.
- widerrufen – Markieren Sie einen Beleg als storniert oder korrigiert.
- Journal – Exportieren Sie Audit-Protokolle, Abschlüsse und Berichte.
Wesentliche Merkmale
- Formatflexibilität: Sie können Quittungen als Visualisierungen oder Rohdaten erhalten. Wählen Sie aus Formaten wie HTML, PDF, PNG oder JSON.
- Einhaltung von Vorschriften: Die API stellt sicher, dass Ihre Belege den gesetzlichen Anforderungen entsprechen.
- Geschwindigkeit: Verwenden Sie den POS-API Helper, um Quittungen sofort hochzuladen. Ohne dieses Hilfsmittel kann das Hochladen bis zu fünf Minuten dauern.
- Abruf von Daten: Die API bietet einen sicheren Weg, um auf Quittungsdaten zuzugreifen. So können Sie Quittungen in Ihre eigenen Anwendungen integrieren.
Jeder Vorgang ist den Schritten des Quittungslebenszyklus zugeordnet. Eine Quittung wird aus Bestell- und Zahlungsdaten erstellt, nach nationalem Recht signiert und an den Verbraucher ausgegeben. Er kann für Retouren abgerufen, für Audits überprüft, bei Korrekturen widerrufen und als Teil eines Journals exportiert werden. Der gesamte Prozess ist deterministisch, fälschungssicher und an die Vorschriften des jeweiligen Landes angepasst.
Die Receipt-API bietet eine robuste Grundlage für die Verarbeitung von Quittungen, erleichtert die Integration, reduziert die Komplexität und gewährleistet die Kontinuität des Geschäftsbetriebs, selbst wenn Drucker ausfallen, da sie ein digitales Fallback bietet.
Warum Entwickler die Receipt-API verwenden
Mit der API können Sie sich auf Ihr System konzentrieren, während fiskaltrust sich um die Quittungsinfrastruktur kümmert. Anstatt Quittungen als Nebenfunktion oder als Zusatz für den Verbraucher zu behandeln, behandelt die Receipt-API Quittungen als erstklassige, regulierte Systemkomponente. Sie integrieren einmal und verlassen sich auf eine einheitliche, quelloffene API, die gepflegt wird, wenn sich die Vorschriften und betrieblichen Anforderungen weiterentwickeln.
- Open-Source: Transparente Implementierung ohne Herstellerbindung und volle Auditierbarkeit.
- Vereinheitlichtes Belegmodell: Eine Datenstruktur für Artikel, Zahlungen, Steuern, Metadaten, Signaturen und Lebenszyklusstatus.
- Hybride Handhabung von Quittungen: Digitale und Papierquittungen werden über dieselbe API verarbeitet, einschließlich HTML, ESC/POS, PDF und gerätenative Formate.
- Unterstützung für mehrere Märkte: Gleiche Nutzdaten und Lebenszykluslogik in AT, DE, FR, IT, ES, PT und mehr.
- Entkoppelte Konformitätslogik: Fiskalische Regeln, Formate und Signiermechanismen entwickeln sich unabhängig von Ihrem Anwendungscode.
- Geschäftskontinuität: Das Erstellen, Signieren und Ausstellen von Belegen bleibt deterministisch und zuverlässig über Online-, Offline- und gestörte Netzwerkszenarien hinweg.
- Geringere Integrationszeit: Kein länderspezifisches Rendering von Quittungen, keine Drucklogik oder Transportflüsse, die Sie in Ihrer eigenen Codebasis pflegen müssen.
- Inklusive Quittungsvisualisierung: Standardisierte, konforme HTML-Quittungsdokumente, die geräte- und betriebssystemübergreifend funktionieren.
- Integrierte Transportkanäle: Quittungszustellung über QR-Code, URL, E-Mail, SMS oder Geräteübergabe, ohne eigene Transportlogik.
Die Receipt API ermöglicht es Entwicklern und Wiederverkäufern, eine konsistente Omnichannel-Quittungsschicht zu erstellen und Quittungsdaten als wiederverwendbaren Service bereitzustellen.
Quittungen werden zu einer sicheren, strukturierten Datenquelle, die in den Bereichen Kundenbindung, Buchhaltung und Integration von Drittanbietern wiederverwendet werden kann, so dass Transaktionen nicht mehr als isolierte Ereignisse, sondern als erweiterbare Systemberührungspunkte gelten.
Hosting-Optionen
Hosting-Optionen
- Lokale Dienste: Windows, Linux, macOS, Android, iOS.
- Rechenzentrum des Händlers: Kubernetes-Cluster oder IIS-Bereitstellung.
- Cloud: Europäische Azure-Regionen mit marktspezifischer Compliance.
- Offline-Fallback: Ein lokaler IoT-Broker sorgt dafür, dass der Empfangsbetrieb bei Ausfällen weiterläuft.
Die Receipt-API unterstützt eine flexible Bereitstellung. Sie kann in Ihren POS eingebettet, als lokaler Dienst ausgeführt, in einem Rechenzentrum in großem Umfang eingesetzt oder über von Fiskaltrust gehostete Cloud-Dienste verwendet werden. Alle Modelle folgen demselben API-Vertrag. Offline-Broker sorgen dafür, dass die Bonerstellung und -signierung auch dann funktioniert, wenn die Internetverbindung ausfällt.
Sandbox-Umgebung
Sie können das System in unserer Sandbox-Umgebung testen. Registrieren Sie sich als Partner in einem fiskaltrust Marktportal. Erweitern Sie Ihren Endpunkt, um die API aufzurufen. Dieser Prozess ermöglicht es Ihnen, Quittungsdaten in Ihrem bevorzugten Format abzurufen und sie zu visualisieren.
So funktioniert es in 3 Schritten
1.
Melden Sie sich auf dem fiskaltrust.Portal an.
2.
Erstellen Sie eine Cashbox und verbinden Sie sie mit Ihrem POS oder ERP.
3.
Beginnen Sie mit dem Erstellen und Ausstellen von Quittungen mit der Receipt-API.
Erfahren Sie mehr - Dokumentation, SDKs und Testumgebungen finden Sie hier