Hop til hovedindhold

Lemon Squeezy

Tilgængelig

Denne integration er aktiv og klar til brug i Frihet.

Forbind din Lemon Squeezy-butik med Frihet. Importer digitale softwareprodukter og ordrer, registrer indtægter automatisk, og hold al din fakturering centraliseret. Lemon Squeezy fungerer som Merchant of Record (håndterer skatter for dig), og Frihet registrerer transaktionerne til dit regnskab.

Hvad kan det bruges til?​

Med Lemon Squeezy integreret:

  • Importer produkter — Hent dit katalog over software og digitale produkter ind i Frihet
  • Importer ordrer — Hvert salg registreres som indtægt i dit ERP
  • Automatisk deduplikering — Allerede importerede ordrer duplikeres ikke (præfiks LS-)
  • Multi-butik — Hvis du har flere butikker, vælg hvilken der skal importeres fra, eller importer fra alle
  • Forenklet skattehåndtering — Lemon Squeezy håndterer skatter som MoR; Frihet registrerer nettobeløbene
  • Abonnementer — Sporing af tilbagevendende SaaS-betalinger

Krav​

  • Aktiv Lemon Squeezy-konto — lemonsqueezy.com
  • API Key — Genereres fra dashboardet
  • Frihet Pro eller højere

Forbind Lemon Squeezy med Frihet​

Trin 1: Få din API-nøgle​

  1. Gå til app.lemonsqueezy.com/settings/api
  2. Log ind på din konto
  3. Klik på Create API key (eller "+"-knappen)
  4. Giv den et navn (f.eks.: "Frihet ERP")
  5. Kopier den genererede API Key
Gem nøglen

API Key'en vises kun én gang ved oprettelse. Kopier den, før du lukker vinduet.

Trin 2: Konfigurer i Frihet​

  1. Gå til Indstillinger → Integrationer
  2. Find Lemon Squeezy
  3. Klik på Forbind
  4. Indsæt din API Key
  5. Klik på Bekræft forbindelse
  6. Hvis det er korrekt, vil Frihet indlæse dine tilgængelige butikker
  7. (Valgfrit) Vælg en specifik butik fra rullemenuen — hvis du ikke vælger nogen, vil produkter og ordrer fra alle dine butikker blive importeret
  8. Klik på Gem forbindelse

Trin 3: Bekræft forbindelse​

  1. Frihet vil vise en oversigt over din butik:
    • Butiksnavn
    • Antal produkter
    • Nylige ordrer
  2. Udfør en testimport

Sådan fungerer det​

Frihet bruger Lemon Squeezy API'en med JSON:API format:

  1. Du angiver din API Key
  2. Frihet sender nøglen i headeren Authorization: Bearer <api-key>
  3. Svarene følger JSON:API-formatet (med data, attributes, relationships)
  4. Produkter og ordrer importeres efter behov
  5. Deduplikering er baseret på Lemon Squeezy ordre-ID (præfiks LS-{id})
  6. API Key'en lagres krypteret (AES-256-GCM) i Frihet

Synkroniserede data​

DataRetningFrekvens
ProdukterLemon Squeezy → FrihetEfter behov
Ordrer (orders)Lemon Squeezy → FrihetEfter behov
KøberdataLemon Squeezy → FrihetVed hver ordre
Beløb og valutaLemon Squeezy → FrihetVed hver ordre
OrdrestatusLemon Squeezy → FrihetVed hver import

Merchant of Record​

Lemon Squeezy fungerer som Merchant of Record, hvilket betyder at:

  • Lemon Squeezy opkræver kunden, håndterer moms/Sales Tax og udsteder fakturaen til køberen
  • Du modtager nettobeløbet (efter skatter og gebyrer)
  • Frihet registrerer den nettoindtægt, du modtager, til dit interne regnskab

Dette forenkler dit regnskab: du behøver ikke at beregne internationale skatter for hvert digitalt salg.

Brugsscenarier​

Indieudvikler med SaaS​

Du sælger licenser til din software via Lemon Squeezy. Hver betaling importeres til Frihet som indtægt, både enkeltbetalinger og abonnementsfornyelser.

Skaber af plugins eller temaer​

Du sælger WordPress-plugins, Shopify-temaer eller udvidelser. Frihet samler disse indtægter med resten af din fakturering (konsulenttjenester, andre kunder).

Sporing af abonnementer​

Du har et SaaS-produkt med månedlig og årlig plan. Fra Frihet kan du se fordelingen af tilbagevendende indtægter importeret fra Lemon Squeezy sammen med resten af din forretning.

Importer produkter​

  1. Gå til Indstillinger → Integrationer → Lemon Squeezy
  2. Klik på Importer produkter
  3. Frihet vil hente produkterne fra din butik

Importerede data pr. produkt:

  • Navn
  • Pris
  • Type (enkeltbetaling, abonnement)
  • Status (udgivet, kladde)

Importer ordrer​

  1. Gå til Indstillinger → Integrationer → Lemon Squeezy
  2. Klik på Importer ordrer
  3. Vælg datointervallet
  4. Frihet vil oprette indtægtsregistreringer for hver ordre

Hver importeret ordre inkluderer:

  • Ordre-ID
  • Købers navn og e-mail
  • Købt produkt
  • Total- og nettobeløb
  • Valuta
  • Ordredato
  • Status (gennemført, refunderet, afventende)

Automatiske genforsøg​

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

Fejlfinding​

"Autentificeringsfejl"​

  • Kontroller, at API Key'en er korrekt og ikke er blevet tilbagekaldt
  • Kontroller, at din Lemon Squeezy-konto er aktiv
  • Hvis du oprettede en ny API Key, opdater den i Frihet

"Ordrer importeres ikke"​

  • Kontroller, at du har ordrer i det valgte datointerval
  • Kontroller, at API Key'en ikke er begrænset til bestemte scopes
  • Hvis din butik er ny, skal du sørge for, at der er mindst én gennemført ordre

"Beløbene stemmer ikke overens med det, jeg ser i Lemon Squeezy"​

  • Frihet importerer det beløb, du modtager (netto efter skatter og gebyrer fra Lemon Squeezy)
  • Bruttobeløbet, som køberen ser, inkluderer skatter håndteret af MoR
  • Se opdelingen i dit Lemon Squeezy-dashboard for at bekræfte

"Jeg vil afbryde forbindelsen"​

  1. Gå til Indstillinger → Integrationer → Lemon Squeezy
  2. Klik på Afbryd forbindelse
  3. Eventuelt, tilbagekald API Key'en fra dit Lemon Squeezy-dashboard

Næste skridt​