Hoppa till huvudinnehåll

Gumroad

Tillgänglig

Denna integration är aktiv och redo att användas i Frihet.

Anslut ditt Gumroad-konto till Frihet. Importera produkter och försäljningar från din digitala butik, generera automatiska fakturor och konsolidera dina intäkter som skapare med resten av din fakturering.

Vad används det till?

Med integrerad Gumroad:

  • Importera produkter — Hämta din Gumroad-katalog till Frihet
  • Importera försäljningar — Varje försäljning blir en intäktsregistrering
  • Automatiska fakturor — Generera fakturor för varje försäljning med köparens data
  • Deduplicering — Redan importerade försäljningar dupliceras inte
  • Prefix GR- — Importerade försäljningar identifieras med prefixet GR- för enkel spårning
  • Återbetalningsstatus — Återbetalningar i Gumroad återspeglas automatiskt

Krav

  • Aktivt Gumroad-kontogumroad.com
  • API Access Token — Genereras från Gumroad-inställningarna
  • Frihet Pro eller högre

Anslut Gumroad till Frihet

Steg 1: Hämta din Access Token

  1. Gå till app.gumroad.com/settings/advanced
  2. Logga in på ditt Gumroad-konto
  3. Under avsnittet Applications, leta efter Access Token
  4. Om du inte har en, klicka på Create application:
    • Namn: "Frihet ERP"
    • Redirect URI: https://app.frihet.io (används inte, men är obligatoriskt)
  5. Kopiera den genererade Access Token

Steg 2: Konfigurera i Frihet

  1. Gå till InställningarIntegrationer
  2. Leta efter Gumroad
  3. Klicka på Anslut
  4. Klistra in din Access Token
  5. Klicka på Verifiera anslutning
  6. Om det är korrekt, ser du namnet på din Gumroad-profil

Steg 3: Verifiera anslutning

  1. Frihet kommer att visa en sammanfattning av ditt konto:
    • Antal aktiva produkter
    • Senaste försäljningar
  2. Gör en testimport för att verifiera att allt fungerar

Hur det fungerar

Frihet använder Gumroad API med Bearer-autentisering:

  1. Du anger din Access Token
  2. Frihet skickar token i headern Authorization: Bearer <token>
  3. Produkter och försäljningar importeras vid behov
  4. Varje importerad försäljning får en identifierare med prefixet GR- (t.ex. GR-abc123)
  5. Deduplicering baseras på Gumroads försäljnings-ID: om en försäljning redan har importerats dupliceras den inte
  6. Token lagras krypterad (AES-256-GCM) i Frihet

Synkroniserad data

DataRiktningFrekvens
ProdukterGumroad → FrihetVid behov
FörsäljningarGumroad → FrihetVid behov
Köparens dataGumroad → FrihetMed varje försäljning
ÅterbetalningsstatusGumroad → FrihetMed varje import
Pris och valutaGumroad → FrihetMed varje försäljning

Statusmappning

Gumroad-statusFrihet-status
Slutförd försäljningIntäkt registrerad
Delvis återbetalningIntäkt justerad
Fullständig återbetalningIntäkt annullerad / kreditnota

Användningsfall

Digital skapare med e-böcker och kurser

Du säljer e-böcker, mallar och kurser på Gumroad. Varje försäljning importeras automatiskt till Frihet med köparens data, genererar en intäktsregistrering som du kan fakturera och deklarera.

Frilansare som säljer mallar

Utöver dina konsulttjänster säljer du mallar på Gumroad. Frihet konsoliderar dina tjänsteintäkter (manuella fakturor) med intäkterna från digitala produkter (importerade från Gumroad) i en enda översikt.

Kontroll av återbetalningar

En köpare begär en återbetalning i Gumroad. Vid återimport av försäljningarna upptäcker Frihet statusändringen och justerar intäktsregistreringen för att återspegla återbetalningen.

Importera produkter

  1. Gå till InställningarIntegrationerGumroad
  2. Klicka på Importera produkter
  3. Frihet kommer att hämta alla dina aktiva produkter från Gumroad
  4. Produkterna kommer att visas i din Frihet-katalog

Importerad data per produkt:

  • Produktnamn
  • Pris
  • Beskrivning
  • Status (aktiv/inaktiv)

Importera försäljningar

  1. Gå till InställningarIntegrationerGumroad
  2. Klicka på Importera försäljningar
  3. Välj datumintervall
  4. Frihet kommer att importera försäljningarna och skapa intäktsregistreringar

Varje importerad försäljning inkluderar:

  • Försäljnings-ID med prefixet GR- (t.ex. GR-xYz123)
  • Köparens namn och e-postadress
  • Såld produkt
  • Belopp och valuta
  • Försäljningsdatum
  • Status (slutförd / återbetald)

Automatiska återförsök

Om en import misslyckas på grund av ett tillfälligt fel (timeout, serverfel), försöker Frihet automatiskt igen upp till 3 gånger med exponentiell väntetid (1s, 2s, 4s). Du behöver inte göra något – återförsöken är transparenta.

Felsökning

"Autentiseringsfel"

  • Verifiera att Access Token är korrekt
  • Kontrollera att ditt Gumroad-konto är aktivt
  • Om du har genererat om token, uppdatera den i Frihet

"Mina försäljningar importeras inte"

  • Kontrollera att du har försäljningar inom det valda datumintervallet
  • Mycket gamla försäljningar kan ta längre tid att importera
  • Verifiera att Access Token har läsbehörighet

"Jag ser duplicerade försäljningar"

  • Bör inte hända: Frihet deduplicerar baserat på Gumroads försäljnings-ID
  • Om det händer, koppla bort och återanslut integrationen
  • Försäljningar som redan är registrerade i Frihet påverkas inte

"En återbetalning återspeglas inte"

  • Importera försäljningarna igen så att Frihet upptäcker statusändringen
  • Återbetalningen måste vara behandlad i Gumroad (inte bara begärd)

Nästa steg