Hop til hovedindhold

Gumroad

Tilgængelig

Denne integration er aktiv og klar til brug i Frihet.

Forbind din Gumroad-konto til Frihet. Importer produkter og salg fra din digitale butik, generer automatiske fakturaer og konsolider dine indtægter som skaber med resten af din fakturering.

Hvad bruges det til?​

Med Gumroad integreret:

  • Importer produkter — Hent dit Gumroad-katalog til Frihet
  • Importer salg — Hvert salg bliver til en indtægtsregistrering
  • Automatiske fakturaer — Generer fakturaer for hvert salg med købers data
  • Deduplikering — Allerede importerede salg duplikeres ikke
  • GR- præfiks — Importerede salg identificeres med GR- præfikset for nem sporing
  • Refusionsstatus — Refusioner i Gumroad afspejles automatisk

Krav​

  • Aktiv Gumroad-konto — gumroad.com
  • API Access Token — Genereres fra Gumroad-indstillingerne
  • Frihet Pro eller højere

Forbind Gumroad med Frihet​

Trin 1: Få din Access Token​

  1. Gå til app.gumroad.com/settings/advanced
  2. Log ind på din Gumroad-konto
  3. I sektionen Applications, find Access Token
  4. Hvis du ikke har en, klik på Create application:
    • Navn: "Frihet ERP"
    • Redirect URI: https://app.frihet.io (bruges ikke, men er obligatorisk)
  5. Kopier den genererede Access Token

Trin 2: Opsætning i Frihet​

  1. Gå til Indstillinger → Integrationer
  2. Find Gumroad
  3. Klik på Forbind
  4. Indsæt din Access Token
  5. Klik på Verificer forbindelse
  6. Hvis det er korrekt, vil du se navnet på din Gumroad-profil

Trin 3: Verificer forbindelse​

  1. Frihet vil vise en oversigt over din konto:
    • Antal aktive produkter
    • Seneste salg
  2. Foretag en testimport for at verificere, at alt fungerer

Hvordan det fungerer​

Frihet bruger Gumroad API'en med Bearer-autentificering:

  1. Du angiver din Access Token
  2. Frihet sender token'et i headeren Authorization: Bearer <token>
  3. Produkter og salg importeres efter behov
  4. Hvert importeret salg modtager en identifikator med præfikset GR- (f.eks.: GR-abc123)
  5. Deduplikering er baseret på Gumroad salgs-ID: hvis et salg allerede er importeret, duplikeres det ikke
  6. Token'et gemmes krypteret (AES-256-GCM) i Frihet

Synkroniserede data​

DataRetningFrekvens
ProdukterGumroad → FrihetEfter behov
SalgGumroad → FrihetEfter behov
Købers dataGumroad → FrihetVed hvert salg
RefusionsstatusGumroad → FrihetVed hver import
Pris og valutaGumroad → FrihetVed hvert salg

Statusmapping​

Gumroad statusFrihet status
Fuldført salgRegistreret indtægt
Delvis refusionJusteret indtægt
Fuld refusionAnnulleret indtægt / kreditnota

Anvendelsesscenarier​

Digital skaber med e-bøger og kurser​

Du sælger e-bøger, skabeloner og kurser på Gumroad. Hvert salg importeres automatisk til Frihet med køberens data, hvilket genererer en indtægtsregistrering, som du kan fakturere og deklarere.

Freelancer, der sælger skabeloner​

Ud over dine konsulentydelser sælger du skabeloner på Gumroad. Frihet konsoliderer dine serviceindtægter (manuelle fakturaer) med digitale produktindtægter (importeret fra Gumroad) i et enkelt dashboard.

Refusionskontrol​

En køber anmoder om refusion i Gumroad. Når salget importeres igen, registrerer Frihet statusændringen og justerer indtægtsregistreringen for at afspejle refusionen.

Importer produkter​

  1. Gå til Indstillinger → Integrationer → Gumroad
  2. Klik på Importer produkter
  3. Frihet henter alle dine aktive Gumroad-produkter
  4. Produkterne vises i dit Frihet-katalog

Importerede data pr. produkt:

  • Produktnavn
  • Pris
  • Beskrivelse
  • Status (aktiv/inaktiv)

Importer salg​

  1. Gå til Indstillinger → Integrationer → Gumroad
  2. Klik på Importer salg
  3. Vælg datointerval
  4. Frihet importerer salg og opretter indtægtsregistreringer

Hvert importeret salg inkluderer:

  • Salgs-ID med GR- præfiks (f.eks.: GR-xYz123)
  • Købers navn og e-mail
  • Solgt produkt
  • Beløb og valuta
  • Salgsdato
  • Status (fuldført / refunderet)

Automatiske genforsøg​

Hvis en import fejler på grund af en midlertidig fejl (timeout, serverfejl), genforsøger Frihet automatisk op til 3 gange med eksponentielle ventetider (1s, 2s, 4s). Du behøver ikke gøre noget — genforsøgene er transparente.

Fejlfinding​

"Autentificeringsfejl"​

  • Verificer, at Access Token er korrekt
  • Kontroller, at din Gumroad-konto er aktiv
  • Hvis du regenererede token'et, skal du opdatere det i Frihet

"Mine salg importeres ikke"​

  • Kontroller, at du har salg i det valgte datointerval
  • Meget gamle salg kan tage længere tid at importere
  • Verificer, at Access Token har læserettigheder

"Jeg ser duplikerede salg"​

  • Skulle ikke ske: Frihet deduplikserer efter Gumroad salgs-ID
  • Hvis det sker, skal du afbryde og genoprette integrationen
  • Salg, der allerede er registreret i Frihet, vil ikke blive påvirket

"En refusion afspejles ikke"​

  • Importer salgene igen, så Frihet registrerer statusændringen
  • Refusionen skal være behandlet i Gumroad (ikke kun anmodet om)

Næste skridt​