Stripe Revenue Sync

Verfügbar

Diese Integration ist in allen Pro-Plänen aktiv und sofort einsatzbereit.

Importieren Sie Ihre Stripe-Einnahmen automatisch als Rechnungen, die in Frihet registriert sind. Ideal für SaaS-Unternehmen, die mit Stripe abrechnen und ihre Rechnungsstellung in Ordnung halten müssen.

Wofür ist es gut?

Wenn Sie mit Stripe abrechnen und möchten, dass diese Einnahmen als Rechnungen in Frihet erscheinen, ohne sie manuell zu erstellen:

• Automatischer Import – Jede bezahlte Stripe-Rechnung wird zu einer Rechnung in Frihet
• Inkrementelle Synchronisierung – Importiert nur neue Einnahmen seit der letzten Synchronisierung
• Deduplizierung – Eine Rechnung wird niemals dupliziert, selbst wenn Sie den Import mehrmals ausführen
• VeriFactu-kompatibel – Importierte Rechnungen durchlaufen die Hash-Kette und die lückenlose Nummerierung

Unterschied zur Stripe-Integration

	Stripe (OAuth)	Stripe Revenue Sync
Verbindung	OAuth (Weiterleitung zu Stripe)	Eingeschränkter API-Schlüssel
Richtung	Bidirektional	Nur Stripe → Frihet
Typ	Zahlungen + Abonnements + Connect	Nur bezahlte Rechnungen
Rechnungen	Automatisch per Webhook	Import bei Bedarf + Auto-Sync
Anwendungsfall	Abrechnung über Frihet	Erfassung von Stripe-Einnahmen in Frihet

Nutzen Sie Revenue Sync, wenn: Sie direkt über Stripe (Dashboard, Billing usw.) abrechnen und möchten, dass diese Einnahmen für Ihre Buchhaltung und Erklärungen in Frihet erscheinen.

Anforderungen

• Aktives Stripe-Konto – Erstellen Sie eines auf stripe.com
• Eingeschränkter API-Schlüssel – Mit Nur-Lese-Berechtigungen für Invoices und Customers
• Frihet Pro oder höher – Nicht im Free-Plan verfügbar

Stripe Revenue Sync konfigurieren

Schritt 1: Erstellen Sie einen eingeschränkten API-Schlüssel in Stripe

1. Gehen Sie zu Stripe Dashboard → Developers → API Keys
2. Klicken Sie auf Create restricted key
3. Name: Frihet Revenue Sync
4. Erforderliche Berechtigungen:
   • Invoices → Read
   • Customers → Read
5. Kopieren Sie den Schlüssel (rk_live_...)

Schritt 2: In Frihet verbinden

1. Gehen Sie zu Einstellungen → Integrationen
2. Suchen Sie Stripe Revenue Sync
3. Klicken Sie auf Verbinden
4. Fügen Sie Ihren eingeschränkten API-Schlüssel ein
5. Wählen Sie das Datum aus, ab dem Sie importieren möchten
6. Klicken Sie auf Speichern und verbinden

Schritt 3: Rechnungen importieren

1. Klicken Sie auf Jetzt importieren
2. Frihet fragt die bezahlten Rechnungen in Stripe ab dem ausgewählten Datum ab
3. Jede Rechnung wird als Entwurf erstellt und als bezahlt markiert
4. Die lückenlose Nummerierung und der VeriFactu-Hash werden automatisch angewendet

Schritt 4: Auto-Sync aktivieren (optional)

1. Aktivieren Sie auf der Konfigurationsseite Auto-sync
2. Frihet importiert neue Einnahmen automatisch alle 6 Stunden
3. Es werden nur neue Rechnungen importiert (inkrementelle Synchronisierung)

Wie es funktioniert

Manueller Import

1. Sie klicken auf Jetzt importieren
2. Frihet fragt GET /v1/invoices?status=paid in Stripe ab
3. Für jede Rechnung, die noch nicht in Frihet existiert (über stripeInvoiceId):
   • Es wird eine Rechnungsentwurf mit den Kundendaten erstellt
   • Sie wird als bezahlt markiert
   • Die Firestore-Trigger werden ausgeführt: Nummerierung und VeriFactu-Hash
4. Ergebnis: Rechnungen, die für Ihr Buchungsjournal und Ihre Erklärungen bereit sind

Auto-Sync (alle 6 Stunden)

1. Alle 6 Stunden wird eine geplante Funktion ausgeführt
2. Es werden nur Rechnungen ab lastSync abgefragt (inkrementell)
3. Die neuen werden automatisch importiert
4. lastSync wird mit dem aktuellen Datum aktualisiert
5. Wenn erkannt wird, dass Ihr API-Schlüssel abgelaufen ist, wird die Integration als requiresReconnect markiert

Deduplizierung

Jede importierte Rechnung speichert die Stripe-Rechnungs-ID (stripeInvoiceId) in ihren Metadaten. Wenn Sie versuchen, dieselbe Rechnung zweimal zu importieren, ignoriert Frihet sie automatisch.

Datenzuordnung

Stripe	Frihet
invoice.customer_name oder customer_email	Name des Kunden
invoice.number	Referenz (im Konzept)
line_items[].description	Rechnungszeilen
line_items[].amount	Betrag pro Zeile
invoice.tax	Steuern (falls zutreffend)
invoice.created	Rechnungsdatum
invoice.id	stripeInvoiceId (Metadaten)

Sicherheit

• Eingeschränkter API-Schlüssel – Nur Lesezugriff auf Invoices und Customers. Kein Zugriff auf Geld.
• AES-256-GCM-Verschlüsselung – Ihr API-Schlüssel wird verschlüsselt auf dem Server gespeichert
• Sofortige Trennung – Widerrufen Sie den Zugriff jederzeit in den Einstellungen
• Keine Daten im Transit – Die Kommunikation mit Stripe erfolgt über HTTPS, der Schlüssel wird niemals dem Frontend ausgesetzt

Trennen

1. Gehen Sie zu Einstellungen → Integrationen
2. Suchen Sie Stripe Revenue Sync
3. Klicken Sie auf Trennen
4. Bestätigen Sie die Aktion

Die bereits importierten Rechnungen bleiben in Frihet. Sie werden beim Trennen nicht gelöscht.

Fehlerbehebung

"Keine Rechnungen importiert"

• Überprüfen Sie, ob Ihr API-Schlüssel Leseberechtigungen für Invoices und Customers hat
• Stellen Sie sicher, dass das Importdatum vor Ihren Einnahmen liegt
• Es werden nur Rechnungen mit dem Status paid in Stripe importiert
• Überprüfen Sie, ob Sie sich nicht im Stripe-Testmodus befinden (verwenden Sie Live-Schlüssel)

"Konto erneut verbinden"

• Ihr API-Schlüssel ist abgelaufen oder wurde widerrufen
• Gehen Sie zu Stripe Dashboard → API Keys und erstellen Sie einen neuen
• Trennen und verbinden Sie in Frihet mit dem neuen Schlüssel erneut

"Rechnung dupliziert"

• Sollte nicht passieren. Die Deduplizierung über stripeInvoiceId verhindert dies
• Wenn Sie Duplikate sehen, kontaktieren Sie den Support

"Beträge stimmen nicht überein"

• Frihet importiert den Betrag so, wie er von Stripe gemeldet wird
• Stripe-Gebühren werden nicht von der Rechnung abgezogen (sie sind eine separate Ausgabe)
• Überprüfen Sie die Währung: Stripe meldet in Cent, Frihet konvertiert automatisch

Nächste Schritte

• Stripe zum direkten Inkasso nutzen
• Zahlungslinks mit Stripe Connect konfigurieren
• Verbinde auch WooCommerce, wenn du einen Shop hast

---

Weiter: Stripe Connect – Zahlungslinks in Ihren Rechnungen