Hoppa till huvudinnehåll

Lemon Squeezy

Tillgänglig

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

Anslut din Lemon Squeezy-butik till Frihet. Importera digitala mjukvaruprodukter och beställningar, registrera intäkter automatiskt och håll all din fakturering centraliserad. Lemon Squeezy fungerar som Merchant of Record (hanterar skatter åt dig) och Frihet registrerar transaktionerna för din bokföring.

Vad det används till​

Med Lemon Squeezy integrerat:

  • Importera produkter — Hämta din katalog över mjukvara och digitala produkter till Frihet
  • Importera beställningar — Varje försäljning registreras som intäkt i ditt ERP
  • Automatisk deduplicering — Redan importerade beställningar dupliceras inte (prefix LS-)
  • Flera butiker — Om du har flera butiker, välj vilken som ska importeras eller importera från alla
  • Förenklad skattehantering — Lemon Squeezy hanterar skatterna som MoR; Frihet registrerar nettobeloppen
  • Prenumerationer — Spårning av återkommande SaaS-betalningar

Requisitos​

  • Aktivt Lemon Squeezy-konto — lemonsqueezy.com
  • API Key — Genereras från kontrollpanelen
  • Frihet Pro eller högre

Anslut Lemon Squeezy med Frihet​

Steg 1: Hämta din API-nyckel​

  1. Gå till app.lemonsqueezy.com/settings/api
  2. Logga in på ditt konto
  3. Klicka på Create API key (eller "+"-knappen)
  4. Ge den ett namn (t.ex. "Frihet ERP")
  5. Kopiera den genererade API-nyckeln
Spara nyckeln

API-nyckeln visas endast en gång när den skapas. Kopiera den innan du stänger fönstret.

Steg 2: Konfigurera i Frihet​

  1. Gå till Inställningar → Integrationer
  2. Sök efter Lemon Squeezy
  3. Klicka på Anslut
  4. Klistra in din API Key
  5. Klicka på Verifiera anslutning
  6. Om det är korrekt kommer Frihet att ladda dina tillgängliga butiker
  7. (Valfritt) Välj en specifik butik från rullgardinsmenyn — om du inte väljer någon, importeras produkter och beställningar från alla dina butiker
  8. Klicka på Spara anslutning

Steg 3: Verifiera anslutning​

  1. Frihet kommer att visa en sammanfattning av din butik:
    • Butiksnamn
    • Antal produkter
    • Senaste beställningar
  2. Utför en testimport

Hur det fungerar​

Frihet använder Lemon Squeezy API med JSON:API-format:

  1. Du anger din API-nyckel
  2. Frihet skickar nyckeln i headern Authorization: Bearer <api-key>
  3. Svaren följer JSON:API-formatet (med data, attributes, relationships)
  4. Produkter och beställningar importeras vid behov
  5. Dedupliceringen baseras på Lemon Squeezy:s beställnings-ID (prefix LS-{id})
  6. API-nyckeln lagras krypterad (AES-256-GCM) i Frihet

Synkroniserade data​

DataRiktningFrekvens
ProdukterLemon Squeezy → FrihetVid behov
Beställningar (orders)Lemon Squeezy → FrihetVid behov
Köparens dataLemon Squeezy → FrihetVid varje beställning
Belopp och valutaLemon Squeezy → FrihetVid varje beställning
BeställningsstatusLemon Squeezy → FrihetVid varje import

Merchant of Record​

Lemon Squeezy fungerar som Merchant of Record, vilket innebär att:

  • Lemon Squeezy debiterar kunden, hanterar moms/Sales Tax och utfärdar fakturan till köparen
  • Du mottar nettobeloppet (efter skatter och avgifter från Lemon Squeezy)
  • Frihet registrerar nettointäkten du mottar för din interna bokföring

Detta förenklar din bokföring: du behöver inte beräkna internationella skatter för varje digital försäljning.

Användningsfall​

Indie-utvecklare med SaaS​

Du säljer licenser för din mjukvara via Lemon Squeezy. Varje betalning importeras till Frihet som intäkt, både engångsbetalningar och förnyelser av prenumerationer.

Skapare av plugins eller teman​

Du säljer WordPress-plugins, Shopify-teman eller tillägg. Frihet konsoliderar dessa intäkter med resten av din fakturering (konsulttjänster, andra kunder).

Spårning av prenumerationer​

Du har en SaaS-produkt med månads- och årsplan. Från Frihet kan du se en uppdelning av återkommande intäkter importerade från Lemon Squeezy tillsammans med resten av din verksamhet.

Importera produkter​

  1. Gå till Inställningar → Integrationer → Lemon Squeezy
  2. Klicka på Importera produkter
  3. Frihet hämtar produkterna från din butik

Importerad data per produkt:

  • Namn
  • Pris
  • Typ (engångsbetalning, prenumeration)
  • Status (publicerad, utkast)

Importera beställningar​

  1. Gå till Inställningar → Integrationer → Lemon Squeezy
  2. Klicka på Importera beställningar
  3. Välj datumintervall
  4. Frihet kommer att skapa intäktsregistreringar för varje beställning

Varje importerad beställning inkluderar:

  • Beställnings-ID
  • Köparens namn och e-post
  • Köpt produkt
  • Totalbelopp och nettobelopp
  • Valuta
  • Beställningsdatum
  • Status (slutförd, återbetald, väntande)

Automatiska återförsök​

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

Felsökning​

"Autentiseringsfel"​

  • Kontrollera att API-nyckeln är korrekt och inte har återkallats
  • Kontrollera att ditt Lemon Squeezy-konto är aktivt
  • Om du skapade en ny API-nyckel, uppdatera den i Frihet

"Beställningar importeras inte"​

  • Kontrollera att du har beställningar inom det valda datumintervallet
  • Verifiera att API-nyckeln inte är begränsad till vissa scopes
  • Om din butik är ny, se till att det finns minst en slutförd beställning

"Beloppen stämmer inte överens med vad jag ser i Lemon Squeezy"​

  • Frihet importerar beloppet du mottar (netto efter skatter och avgifter från Lemon Squeezy)
  • Bruttobeloppet som köparen ser inkluderar skatter hanterade av MoR
  • Se uppdelningen i din Lemon Squeezy-kontrollpanel för att bekräfta

"Jag vill koppla ifrån"​

  1. Gå till Inställningar → Integrationer → Lemon Squeezy
  2. Klicka på Koppla ifrån
  3. Återkalla eventuellt API-nyckeln från din Lemon Squeezy-kontrollpanel

Nästa steg​