RECEIPT-Integrationsleitfaden

RECEIPT-Integrationsleitfaden

Dieser Leitfaden führt Sie durch die Integration der fiskaly RECEIPT API, um Papierbelege durch rechtskonforme digitale Belege in allen EU-Ländern zu ersetzen.

📘Detaillierte API-Spezifikation

Die vollständige API-Referenz einschließlich aller Endpunkte, Schemas und Parameter finden Sie in der RECEIPT API-Dokumentation. Dieser Leitfaden behandelt den konzeptuellen Integrationsablauf.

Voraussetzungen

Stellen Sie vor dem Start sicher, dass Sie Folgendes haben:

• Eine fiskaly-Organisation mit aktiviertem RECEIPT (wenden Sie sich an sales@fiskaly.com oder Ihren Account-Manager)
• API-Anmeldedaten (API-Schlüssel und -Secret) für den RECEIPT-Dienst
• Ein Kassensystem oder eine Anwendung, die HTTPS-Anfragen stellen kann

Integrationsübersicht

Der RECEIPT-Ablauf funktioniert in drei Phasen:

1. Erstellen — Ihr Kassensystem sendet Transaktionsdaten an die RECEIPT API
2. Zustellen — Die API generiert einen digitalen Beleg und gibt einen Zustellmechanismus zurück (QR-Code, Link usw.)
3. Präsentieren — Der Kunde erhält den Beleg über seinen bevorzugten Kanal

Schritt-für-Schritt-Integration

1. Authentifizieren

   Holen Sie sich ein Zugriffstoken mit Ihren RECEIPT API-Anmeldedaten:

   curl -X POST https://receipt.fiskaly.com/api/v1/auth \
     -H "Content-Type: application/json" \
     -d '{
       "api_key": "YOUR_API_KEY",
       "api_secret": "YOUR_API_SECRET"
     }'

   Die Antwort enthält ein access_token, das 24 Stunden gültig ist. Fügen Sie es als Bearer-Token in alle nachfolgenden Anfragen ein.

2. Händlerprofil konfigurieren

   Richten Sie Ihre Händlerinformationen ein, die auf allen generierten Belegen erscheinen:

   • Unternehmensname und Rechtsform
   • Adresse und Kontaktinformationen
   • Steueridentifikationsnummern
   • Logo (optional)
   • Beleganpassungspräferenzen
3. Beleg erstellen

   Senden Sie nach jeder Transaktion die Belegdaten an die RECEIPT API:

   curl -X POST https://receipt.fiskaly.com/api/v1/receipts \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "items": [
         {
           "description": "Product A",
           "quantity": 2,
           "unit_price": 1299,
           "vat_rate": "19.00"
         }
       ],
       "payment": {
         "method": "card",
         "amount": 2598
       }
     }'

   Beträge sind in der kleinsten Währungseinheit (Cent) angegeben.

4. Beleg dem Kunden präsentieren

   Die API-Antwort enthält Zustelloptionen:

   • QR-Code — Am Kassensystem-Display anzeigen oder einen kleinen QR-Code drucken, den der Kunde scannen kann
   • Statischer Code — Ein dauerhafter Code, der mit dem Händler für Stammkunden verknüpft ist
   • Direktlink — Eine URL, die der Kunde in jedem Browser öffnen kann

   Der Kunde sieht seinen Beleg auf receipt.fiskaly.com — kein App-Download erforderlich.

5. Mit fiskaly SIGN verbinden (optional)

   Wenn Sie fiskaly SIGN für die fiskalische Compliance verwenden, kann RECEIPT Belege automatisch mit signierten Transaktionen verknüpfen. Dies bietet:

   • Automatische Aufnahme von Fiskal-Signaturdaten auf dem digitalen Beleg
   • QR-Code-Validierungsunterstützung
   • Lückenlose Prüfkette von der Transaktion bis zur Belegzustellung

Zustellkanäle

Kanal	Funktionsweise	Am besten für
QR-Code	Kunde scannt einen auf dem Bildschirm angezeigten oder gedruckten QR-Code	Kassensystem vor Ort, Schnellservice
Statischer Code	Dauerhafter QR-Code, der mit dem Händlerstandort verknüpft ist	Thekenaufsteller, Tischkarten
E-Mail	Beleg direkt an die E-Mail-Adresse des Kunden gesendet	E-Commerce, Reservierungen
Link	Teilbare URL zum gehosteten Beleg	Jeder Zustellkanal

💡Keine App erforderlich

RECEIPT funktioniert vollständig über das Web. Kunden sehen Belege in ihrem Browser unter receipt.fiskaly.com — kein App-Download, keine Kontoerstellung oder Registrierung erforderlich.

Compliance

Von RECEIPT generierte digitale Belege sind in allen EU-Ländern rechtskonform:

• Erfüllt die Anforderungen elektronischer Dokumente gemäß EU-Mehrwertsteuerrichtlinie
• Konform mit länderspezifischen Belegpflichten (Deutschland, Österreich, Frankreich usw.)
• Datensicherheit durch die ISO 27001-Zertifizierung von fiskaly gewährleistet
• Belege sind nach der Erstellung unveränderlich — vollständige Prüfkette wird aufrechterhalten

Jetzt ausprobieren

Erstellen Sie einen Demo-Beleg, um die Kundenerfahrung vor der Integration zu sehen.

Ressourcen

Für detailliertere technische Informationen laden Sie den vollständigen Integrationsleitfaden herunter:

• Integrationsleitfaden (PDF) — Vollständige API-Referenz mit Anfrage-/Antwortbeispielen
• RECEIPT API-Referenz — Vollständige OpenAPI-Spezifikation
• Quick Start — Minimale Einrichtung zur Erstellung Ihres ersten Belegs
• FAQ — Häufige Fragen zu RECEIPT