Zum Hauptinhalt springen

Lemon Squeezy

Verfügbar

Diese Integration ist in Frihet aktiv und einsatzbereit.

Verbinden Sie Ihren Lemon Squeezy Shop mit Frihet. Importieren Sie digitale Softwareprodukte und -bestellungen, erfassen Sie Einnahmen automatisch und halten Sie Ihre gesamte Rechnungsstellung zentralisiert. Lemon Squeezy fungiert als Merchant of Record (verwaltet Steuern für Sie) und Frihet erfasst die Transaktionen für Ihre Buchhaltung.

Wozu dient es?​

Mit integriertem Lemon Squeezy:

  • Produkte importieren — Übertragen Sie Ihren Katalog an Software und digitalen Produkten nach Frihet
  • Bestellungen importieren — Jeder Verkauf wird als Einnahme in Ihrem ERP erfasst
  • Automatische Deduplizierung — Bereits importierte Bestellungen werden nicht dupliziert (Präfix LS-)
  • Multi-Shop — Wenn Sie mehrere Shops haben, wählen Sie aus, welchen Sie importieren möchten, oder importieren Sie von allen
  • Vereinfachte Steuerverwaltung — Lemon Squeezy verwaltet die Steuern als MoR; Frihet erfasst die Nettobeträge
  • Abonnements — Verfolgung wiederkehrender SaaS-Zahlungen

Anforderungen​

  • Aktiver Lemon Squeezy Account — lemonsqueezy.com
  • API-Schlüssel — Wird über das Dashboard generiert
  • Frihet Pro oder höher

Lemon Squeezy mit Frihet verbinden​

Schritt 1: Ihren API-Schlüssel erhalten​

  1. Gehen Sie zu app.lemonsqueezy.com/settings/api
  2. Melden Sie sich in Ihrem Konto an
  3. Klicken Sie auf Create API key (oder den "+"-Button)
  4. Geben Sie einen Namen ein (z.B. "Frihet ERP")
  5. Kopieren Sie den generierten API-Schlüssel
Speichern Sie den Schlüssel

Der API-Schlüssel wird nur einmal bei der Erstellung angezeigt. Kopieren Sie ihn, bevor Sie das Fenster schließen.

Schritt 2: In Frihet konfigurieren​

  1. Gehen Sie zu Einstellungen → Integrationen
  2. Suchen Sie nach Lemon Squeezy
  3. Klicken Sie auf Verbinden
  4. Fügen Sie Ihren API-Schlüssel ein
  5. Klicken Sie auf Verbindung überprüfen
  6. Wenn die Verbindung erfolgreich ist, lädt Frihet Ihre verfügbaren Shops
  7. (Optional) Wählen Sie einen spezifischen Shop aus dem Dropdown-Menü — wenn Sie keinen auswählen, werden Produkte und Bestellungen aus all Ihren Shops importiert
  8. Klicken Sie auf Verbindung speichern

Schritt 3: Verbindung überprüfen​

  1. Frihet zeigt eine Zusammenfassung Ihres Shops an:
    • Shop-Name
    • Anzahl der Produkte
    • Aktuelle Bestellungen
  2. Führen Sie einen Testimport durch

Funktionsweise​

Frihet verwendet die Lemon Squeezy API im JSON:API-Format:

  1. Sie stellen Ihren API-Schlüssel bereit
  2. Frihet sendet den Schlüssel im Header Authorization: Bearer <api-key>
  3. Die Antworten folgen dem JSON:API-Format (mit data, attributes, relationships)
  4. Produkte und Bestellungen werden bei Bedarf importiert
  5. Die Deduplizierung basiert auf der Bestell-ID von Lemon Squeezy (Präfix LS-{id})
  6. Der API-Schlüssel wird verschlüsselt (AES-256-GCM) in Frihet gespeichert

Synchronisierte Daten​

DatenRichtungFrequenz
ProdukteLemon Squeezy → FrihetBei Bedarf
Bestellungen (orders)Lemon Squeezy → FrihetBei Bedarf
KäuferdatenLemon Squeezy → FrihetMit jeder Bestellung
Betrag und WährungLemon Squeezy → FrihetMit jeder Bestellung
BestellstatusLemon Squeezy → FrihetMit jedem Import

Merchant of Record​

Lemon Squeezy fungiert als Merchant of Record, was bedeutet, dass:

  • Lemon Squeezy belastet den Kunden, verwaltet die Mehrwertsteuer/Umsatzsteuer und stellt dem Käufer die Rechnung aus
  • Sie erhalten den Nettobetrag (nach Steuern und Provisionen)
  • Frihet erfasst die Nettoeinnahmen, die Sie für Ihre interne Buchhaltung erhalten

Dies vereinfacht Ihre Buchhaltung: Sie müssen keine internationalen Steuern für jeden digitalen Verkauf berechnen.

Anwendungsfälle​

Indie-Entwickler mit SaaS​

Sie verkaufen Softwarelizenzen über Lemon Squeezy. Jede Zahlung wird als Einnahme in Frihet importiert, sowohl Einmalzahlungen als auch Abonnementverlängerungen.

Ersteller von Plugins oder Themes​

Sie verkaufen WordPress-Plugins, Shopify-Themes oder Erweiterungen. Frihet konsolidiert diese Einnahmen mit dem Rest Ihrer Rechnungsstellung (Beratungsdienste, andere Kunden).

Abonnement-Verfolgung​

Sie haben ein SaaS-Produkt mit monatlichem und jährlichem Plan. Von Frihet aus können Sie die Aufschlüsselung der wiederkehrenden Einnahmen, die von Lemon Squeezy importiert wurden, zusammen mit dem Rest Ihres Geschäfts sehen.

Produkte importieren​

  1. Gehen Sie zu Einstellungen → Integrationen → Lemon Squeezy
  2. Klicken Sie auf Produkte importieren
  3. Frihet ruft die Produkte aus Ihrem Shop ab

Importierte Daten pro Produkt:

  • Name
  • Preis
  • Typ (Einmalzahlung, Abonnement)
  • Status (veröffentlicht, Entwurf)

Bestellungen importieren​

  1. Gehen Sie zu Einstellungen → Integrationen → Lemon Squeezy
  2. Klicken Sie auf Bestellungen importieren
  3. Wählen Sie den Datumsbereich aus
  4. Frihet erstellt Einnahmeeinträge für jede Bestellung

Jede importierte Bestellung enthält:

  • Bestell-ID
  • Name und E-Mail des Käufers
  • Erworbenes Produkt
  • Gesamt- und Nettobetrag
  • Währung
  • Bestelldatum
  • Status (abgeschlossen, erstattet, ausstehend)

Automatische Wiederholungsversuche​

Wenn ein Import aufgrund eines temporären Fehlers (Timeout, Serverfehler) fehlschlägt, versucht Frihet automatisch bis zu 3 Mal mit exponentiellen Wartezeiten (1s, 2s, 4s) erneut. Sie müssen nichts tun — die Wiederholungsversuche sind transparent.

Fehlerbehebung​

"Authentifizierungsfehler"​

  • Überprüfen Sie, ob der API-Schlüssel korrekt ist und nicht widerrufen wurde
  • Stellen Sie sicher, dass Ihr Lemon Squeezy-Konto aktiv ist
  • Wenn Sie einen neuen API-Schlüssel erstellt haben, aktualisieren Sie ihn in Frihet

"Bestellungen werden nicht importiert"​

  • Überprüfen Sie, ob in dem ausgewählten Datumsbereich Bestellungen vorliegen
  • Überprüfen Sie, ob der API-Schlüssel nicht auf bestimmte Scopes beschränkt ist
  • Wenn Ihr Shop neu ist, stellen Sie sicher, dass mindestens eine abgeschlossene Bestellung vorhanden ist

"Die Beträge stimmen nicht mit dem überein, was ich in Lemon Squeezy sehe"​

  • Frihet importiert den Betrag, den Sie erhalten (netto nach Steuern und Lemon Squeezy-Provisionen)
  • Der Bruttobetrag, den der Käufer sieht, beinhaltet vom MoR verwaltete Steuern
  • Konsultieren Sie die Aufschlüsselung in Ihrem Lemon Squeezy-Dashboard, um dies zu bestätigen

"Ich möchte die Verbindung trennen"​

  1. Gehen Sie zu Einstellungen → Integrationen → Lemon Squeezy
  2. Klicken Sie auf Trennen
  3. Optional können Sie den API-Schlüssel von Ihrem Lemon Squeezy-Dashboard aus widerrufen

Nächste Schritte​