Gumroad
Diese Integration ist aktiv und bereit zur Nutzung in Frihet.
Verbinde dein Gumroad-Konto mit Frihet. Importiere Produkte und Verkäufe aus deinem digitalen Shop, erstelle automatische Rechnungen und konsolidiere deine Einnahmen als Creator mit dem Rest deiner Rechnungsstellung.
Wozu dient es?
Mit integriertem Gumroad:
- Produkte importieren — Bringe deinen Gumroad-Katalog zu Frihet
- Verkäufe importieren — Jeder Verkauf wird zu einem Einnahmeeintrag
- Automatische Rechnungen — Erstelle Rechnungen für jeden Verkauf mit Käuferdaten
- Deduplizierung — Bereits importierte Verkäufe werden nicht dupliziert
- Präfix GR- — Importierte Verkäufe werden mit dem Präfix GR- zur einfachen Nachverfolgung gekennzeichnet
- Rückerstattungsstatus — Rückerstattungen in Gumroad werden automatisch übernommen
Voraussetzungen
- Aktives Gumroad-Konto — gumroad.com
- API Access Token — Wird in den Gumroad-Einstellungen generiert
- Frihet Pro oder höher
Gumroad mit Frihet verbinden
Schritt 1: Dein Access Token erhalten
- Gehe zu app.gumroad.com/settings/advanced
- Melde dich bei deinem Gumroad-Konto an
- Suche im Bereich Applications nach Access Token
- Falls du keines hast, klicke auf Create application:
- Name: "Frihet ERP"
- Redirect URI:
https://app.frihet.io(wird nicht verwendet, ist aber obligatorisch)
- Kopiere den generierten Access Token
Schritt 2: In Frihet konfigurieren
- Gehe zu Einstellungen → Integrationen
- Suche nach Gumroad
- Klicke auf Verbinden
- Füge deinen Access Token ein
- Klicke auf Verbindung überprüfen
- Wenn korrekt, siehst du den Namen deines Gumroad-Profils
Schritt 3: Verbindung überprüfen
- Frihet zeigt eine Zusammenfassung deines Kontos an:
- Anzahl aktiver Produkte
- Aktuelle Verkäufe
- Führe einen Testimport durch, um zu überprüfen, ob alles funktioniert
Funktionsweise
Frihet verwendet die Gumroad API mit Bearer-Authentifizierung:
- Du gibst dein Access Token an
- Frihet sendet das Token im Header
Authorization: Bearer <token> - Produkte und Verkäufe werden bei Bedarf importiert
- Jeder importierte Verkauf erhält eine Kennung mit dem Präfix GR- (z.B.:
GR-abc123) - Die Deduplizierung basiert auf der Gumroad-Verkaufs-ID: Wenn ein Verkauf bereits importiert wurde, wird er nicht dupliziert
- Das Token wird verschlüsselt (AES-256-GCM) in Frihet gespeichert
Synchronisierte Daten
| Daten | Richtung | Frequenz |
|---|---|---|
| Produkte | Gumroad → Frihet | Bei Bedarf |
| Verkäufe | Gumroad → Frihet | Bei Bedarf |
| Käuferdaten | Gumroad → Frihet | Mit jedem Verkauf |
| Rückerstattungsstatus | Gumroad → Frihet | Mit jedem Import |
| Preis und Währung | Gumroad → Frihet | Mit jedem Verkauf |
Status-Mapping
| Gumroad Status | Frihet Status |
|---|---|
| Verkauf abgeschlossen | Einnahme erfasst |
| Teilweise Rückerstattung | Einnahme angepasst |
| Volle Rückerstattung | Einnahme storniert / Gutschrift |
Anwendungsfälle
Digitaler Creator mit E-Books und Kursen
Du verkaufst E-Books, Vorlagen und Kurse auf Gumroad. Jeder Verkauf wird automatisch mit den Käuferdaten in Frihet importiert, wobei ein Einnahmeeintrag erstellt wird, den du abrechnen und deklarieren kannst.
Freelancer, der Vorlagen verkauft
Neben deinen Beratungsdienstleistungen verkaufst du Vorlagen auf Gumroad. Frihet konsolidiert deine Einnahmen aus Dienstleistungen (manuelle Rechnungen) mit denen aus digitalen Produkten (von Gumroad importiert) in einem einzigen Dashboard.
Rückerstattungskontrolle
Ein Käufer beantragt eine Rückerstattung in Gumroad. Beim erneuten Importieren der Verkäufe erkennt Frihet die Statusänderung und passt den Einnahmeeintrag an, um die Rückerstattung widerzuspiegeln.
Produkte importieren
- Gehe zu Einstellungen → Integrationen → Gumroad
- Klicke auf Produkte importieren
- Frihet ruft alle deine aktiven Gumroad-Produkte ab
- Die Produkte erscheinen in deinem Frihet-Katalog
Importierte Daten pro Produkt:
- Produktname
- Preis
- Beschreibung
- Status (aktiv/inaktiv)
Verkäufe importieren
- Gehe zu Einstellungen → Integrationen → Gumroad
- Klicke auf Verkäufe importieren
- Wähle den Datumsbereich aus
- Frihet importiert die Verkäufe und erstellt Einnahmeeinträge
Jeder importierte Verkauf umfasst:
- Verkaufs-ID mit Präfix GR- (z.B.:
GR-xYz123) - Name und E-Mail des Käufers
- Verkauftes Produkt
- Betrag und Währung
- Verkaufsdatum
- Status (abgeschlossen / zurückerstattet)
Automatische Wiederholungsversuche
Wenn ein Import aufgrund eines temporären Fehlers (Timeout, Serverfehler) fehlschlägt, wiederholt Frihet automatisch bis zu 3 Mal mit exponentiellen Wartezeiten (1s, 2s, 4s). Du musst nichts tun – die Wiederholungsversuche sind transparent.
Fehlerbehebung
"Authentifizierungsfehler"
- Überprüfe, ob der Access Token korrekt ist
- Stelle sicher, dass dein Gumroad-Konto aktiv ist
- Falls du das Token neu generiert hast, aktualisiere es in Frihet
"Meine Verkäufe werden nicht importiert"
- Überprüfe, ob du Verkäufe im ausgewählten Datumsbereich hast
- Sehr alte Verkäufe können länger zum Importieren benötigen
- Stelle sicher, dass der Access Token Leserechte hat
"Ich sehe doppelte Verkäufe"
- Sollte nicht passieren: Frihet dedupliziert nach Gumroad-Verkaufs-ID
- Falls es doch passiert, trenne und verbinde die Integration erneut
- Bereits in Frihet registrierte Verkäufe sind davon nicht betroffen
"Eine Rückerstattung wird nicht übernommen"
- Importiere die Verkäufe erneut, damit Frihet die Statusänderung erkennt
- Die Rückerstattung muss in Gumroad verarbeitet sein (nicht nur beantragt)