Lemon Squeezy
Denne integrasjonen er aktiv og klar til bruk i Frihet.
Koble din Lemon Squeezy-butikk til Frihet. Importer produkter og bestillinger av digital programvare, registrer inntekter automatisk og hold all din fakturering sentralisert. Lemon Squeezy fungerer som Merchant of Record (håndterer skatt for deg) og Frihet registrerer transaksjonene for din regnskapsføring.
Hva er formålet?
Med Lemon Squeezy integrert:
- Importer produkter — Ta med din katalog over programvare og digitale produkter til Frihet
- Importer bestillinger — Hvert salg registreres som inntekt i ditt ERP
- Automatisk deduplisering — Bestillinger som allerede er importert, dupliseres ikke (prefiks
LS-) - Multi-butikk — Hvis du har flere butikker, velg hvilken du vil importere fra eller importer fra alle
- Forenklet skattehåndtering — Lemon Squeezy håndterer skattene som MoR; Frihet registrerer nettobeløpene
- Abonnementer — Sporing av tilbakevendende SaaS-betalinger
Krav
- Aktiv Lemon Squeezy-konto — lemonsqueezy.com
- API-nøkkel — Genereres fra dashbordet
- Frihet Pro eller høyere
Koble Lemon Squeezy til Frihet
Trinn 1: Hent din API-nøkkel
- Gå til app.lemonsqueezy.com/settings/api
- Logg inn på din konto
- Klikk på Create API key (eller "+"-knappen)
- Gi den et navn (f.eks.: "Frihet ERP")
- Kopier den genererte API-nøkkelen
API-nøkkelen vises kun én gang ved opprettelse. Kopier den før du lukker vinduet.
Trinn 2: Konfigurer i Frihet
- Gå til Innstillinger → Integrasjoner
- Søk etter Lemon Squeezy
- Klikk på Koble til
- Lim inn din API-nøkkel
- Klikk på Verifiser tilkobling
- Hvis det er riktig, vil Frihet laste dine tilgjengelige butikker
- (Valgfritt) Velg en spesifikk butikk fra nedtrekksmenyen — hvis du ikke velger noen, vil produkter og bestillinger importeres fra alle dine butikker
- Klikk på Lagre tilkobling
Trinn 3: Verifiser tilkobling
- Frihet vil vise en oversikt over din butikk:
- Butikknavn
- Antall produkter
- Nylige bestillinger
- Utfør en testimport
Slik fungerer det
Frihet bruker Lemon Squeezy API-en med JSON:API-format:
- Du oppgir din API-nøkkel
- Frihet sender nøkkelen i
Authorization: Bearer <api-key>-headeren - Svarene følger JSON:API-formatet (med
data,attributes,relationships) - Produktene og bestillingene importeres ved behov
- Deduplisering er basert på Lemon Squeezy bestillings-ID (prefiks
LS-{id}) - API-nøkkelen lagres kryptert (AES-256-GCM) i Frihet
Synkroniserte data
| Data | Retning | Frekvens |
|---|---|---|
| Produkter | Lemon Squeezy → Frihet | Ved behov |
| Bestillinger (orders) | Lemon Squeezy → Frihet | Ved behov |
| Kjøperdata | Lemon Squeezy → Frihet | Med hver bestilling |
| Beløp og valuta | Lemon Squeezy → Frihet | Med hver bestilling |
| Bestillingsstatus | Lemon Squeezy → Frihet | Med hver import |
Merchant of Record
Lemon Squeezy fungerer som Merchant of Record, noe som betyr at:
- Lemon Squeezy fakturerer kunden, håndterer mva/Sales Tax og utsteder fakturaen til kjøperen
- Du mottar nettobeløpet (etter skatt og provisjoner)
- Frihet registrerer nettoinntekten du mottar for din interne regnskapsføring
Dette forenkler din regnskapsføring: du trenger ikke å beregne internasjonale skatter for hvert digitale salg.
Brukstilfeller
Indie-utvikler med SaaS
Du selger lisenser for programvaren din via Lemon Squeezy. Hver betaling importeres til Frihet som inntekt, både engangsbetalinger og abonnementsfornyelser.
Skaper av plugins eller temaer
Du selger WordPress-plugins, Shopify-temaer eller utvidelser. Frihet konsoliderer disse inntektene med resten av din fakturering (konsulenttjenester, andre kunder).
Sporing av abonnementer
Du har et SaaS-produkt med måneds- og årsplan. Fra Frihet kan du se oversikten over tilbakevendende inntekter importert fra Lemon Squeezy sammen med resten av virksomheten din.
Importer produkter
- Gå til Innstillinger → Integrasjoner → Lemon Squeezy
- Klikk på Importer produkter
- Frihet vil hente produktene fra butikken din
Importerte data per produkt:
- Navn
- Pris
- Type (engangsbetaling, abonnement)
- Status (publisert, utkast)
Importer bestillinger
- Gå til Innstillinger → Integrasjoner → Lemon Squeezy
- Klikk på Importer bestillinger
- Velg datoområdet
- Frihet vil opprette inntektsregistreringer for hver bestilling
Hver importerte bestilling inkluderer:
- Bestillings-ID
- Kjøperens navn og e-post
- Kjøpt produkt
- Totalt og nettobeløp
- Valuta
- Bestillingsdato
- Status (fullført, refundert, ventende)
Automatiske forsøk på nytt
Hvis en import mislykkes på grunn av en midlertidig feil (timeout, serverfeil), prøver Frihet automatisk på nytt opptil 3 ganger med eksponentielle ventetider (1s, 2s, 4s). Du trenger ikke å gjøre noe — forsøkene på nytt er transparente.
Feilsøking
"Autentiseringsfeil"
- Verifiser at API-nøkkelen er korrekt og ikke er tilbakekalt
- Sjekk at din Lemon Squeezy-konto er aktiv
- Hvis du opprettet en ny API-nøkkel, oppdater den i Frihet
"Bestillinger importeres ikke"
- Sjekk at du har bestillinger i det valgte datoområdet
- Verifiser at API-nøkkelen ikke er begrenset til visse omfang
- Hvis butikken din er ny, sørg for at det er minst én fullført bestilling
"Beløpene stemmer ikke overens med det jeg ser i Lemon Squeezy"
- Frihet importerer beløpet du mottar (netto etter skatt og Lemon Squeezy-provisjoner)
- Bruttobeløpet kjøperen ser inkluderer skatter administrert av MoR
- Se detaljene i ditt Lemon Squeezy-dashbord for å bekrefte
"Jeg vil koble fra"
- Gå til Innstillinger → Integrasjoner → Lemon Squeezy
- Klikk på Koble fra
- Eventuelt, tilbakekall API-nøkkelen fra ditt Lemon Squeezy-dashbord