Skip to main content

Lemon Squeezy

Saatavilla

Tämä integraatio on aktiivinen ja valmis käytettäväksi Frihetissä.

Yhdistä Lemon Squeezy -kauppasi Frihetiin. Tuo digitaalisia ohjelmistotuotteita ja tilauksia, kirjaa tulot automaattisesti ja pidä kaikki laskutuksesi keskitettynä. Lemon Squeezy toimii Merchant of Recordina (hoitaa verot puolestasi) ja Frihet kirjaa tapahtumat kirjanpitoasi varten.

Mihin tämä on tarkoitettu?​

Kun Lemon Squeezy on integroitu:

  • Tuotteiden tuominen — Tuo ohjelmisto- ja digitaalisten tuotteiden luettelosi Frihetiin
  • Tilausten tuominen — Jokainen myynti kirjataan tuloksi ERP:iisi
  • Automaattinen duplikaattien poisto — Jo tuodut tilaukset eivät duplikoidu (etuliite LS-)
  • Monikauppa — Jos sinulla on useita kauppoja, valitse mitä tuot tai tuo kaikista
  • Yksinkertaistettu verohallinta — Lemon Squeezy hoitaa verot MoR:na; Frihet kirjaa nettosaannit
  • Tilaukset — SaaS-palvelujen toistuvien maksujen seuranta

Vaatimukset​

  • Aktiivinen Lemon Squeezy -tili — lemonsqueezy.com
  • API Key — Luodaan hallintapaneelista
  • Frihet Pro tai uudempi

Lemon Squeezyn yhdistäminen Frihetiin​

Vaihe 1: API-avaimen hankkiminen​

  1. Siirry osoitteeseen app.lemonsqueezy.com/settings/api
  2. Kirjaudu tilillesi
  3. Napsauta Create API key (tai "+" -painiketta)
  4. Anna sille nimi (esim: "Frihet ERP")
  5. Kopioi luotu API-avain
Tallenna avain

API-avain näytetään vain kerran luotaessa. Kopioi se ennen ikkunan sulkemista.

Vaihe 2: Määritä Frihetissä​

  1. Siirry kohtaan Asetukset → Integraatiot
  2. Etsi Lemon Squeezy
  3. Napsauta Yhdistä
  4. Liitä API-avaimesi
  5. Napsauta Tarkista yhteys
  6. Jos yhteys on oikein, Frihet lataa käytettävissä olevat kauppasi
  7. (Valinnainen) Valitse tietty kauppa avattavasta valikosta — jos et valitse mitään, tuotteet ja tilaukset tuodaan kaikista kaupoistasi
  8. Napsauta Tallenna yhteys

Vaihe 3: Tarkista yhteys​

  1. Frihet näyttää kauppasi yhteenvedon:
    • Kaupan nimi
    • Tuotteiden määrä
    • Viimeisimmät tilaukset
  2. Suorita testituonti

Kuinka se toimii​

Frihet käyttää Lemon Squeezyn API:a JSON:API-muodossa:

  1. Annat API-avaimesi
  2. Frihet lähettää avaimen Authorization: Bearer <api-key> -otsakkeessa
  3. Vastaukset noudattavat JSON:API-muotoa (data, attributes, relationships sisältäen)
  4. Tuotteet ja tilaukset tuodaan pyynnöstä
  5. Duplikaattien poisto perustuu Lemon Squeezyn tilaustunnukseen (etuliite LS-{id})
  6. API-avain tallennetaan salattuna (AES-256-GCM) Frihetissä

Synkronoidut tiedot​

DatoDirecciónFrecuencia
TuotteetLemon Squeezy → FrihetPyynnöstä
Tilaukset (orders)Lemon Squeezy → FrihetPyynnöstä
Ostajan tiedotLemon Squeezy → FrihetJokaisen tilauksen yhteydessä
Summa ja valuuttaLemon Squeezy → FrihetJokaisen tilauksen yhteydessä
Tilauksen tilaLemon Squeezy → FrihetJokaisen tuonnin yhteydessä

Merchant of Record​

Lemon Squeezy toimii Merchant of Recordina, mikä tarkoittaa, että:

  • Lemon Squeezy veloittaa asiakasta, hallinnoi ALV/myyntiveroa ja antaa laskun ostajalle
  • Sinä saat nettosaannin (verojen ja palkkioiden jälkeen)
  • Frihet kirjaa saamasi nettosaannin sisäiseen kirjanpitoosi

Tämä yksinkertaistaa kirjanpitoasi: sinun ei tarvitse laskea kansainvälisiä veroja jokaisesta digitaalisesta myynnistä.

Käyttötapaukset​

Indie-kehittäjä SaaS-tuotteella​

Myyt ohjelmistolisenssejäsi Lemon Squeezyn kautta. Jokainen maksu tuodaan Frihetiin tuloksi, niin kertamaksut kuin tilausten uusimisetkin.

Lisäosien tai teemojen luoja​

Myyt WordPress-lisäosia, Shopify-teemoja tai laajennuksia. Frihet yhdistää nämä tulot muun laskutuksesi kanssa (konsultointipalvelut, muut asiakkaat).

Tilausten seuranta​

Sinulla on SaaS-tuote kuukausi- ja vuosiohjelmalla. Frihetistä voit tarkastella Lemon Squeezysta tuotujen toistuvien tulojen erittelyä yhdessä muun liiketoimintasi kanssa.

Tuotteiden tuominen​

  1. Siirry kohtaan Asetukset → Integraatiot → Lemon Squeezy
  2. Napsauta Tuo tuotteita
  3. Frihet tuo tuotteet kaupastasi

Tuotteittain tuodut tiedot:

  • Nimi
  • Hinta
  • Tyyppi (kertamaksu, tilaus)
  • Tila (julkaistu, luonnos)

Tilausten tuominen​

  1. Siirry kohtaan Asetukset → Integraatiot → Lemon Squeezy
  2. Napsauta Tuo tilauksia
  3. Valitse päivämääräväli
  4. Frihet luo tulokirjauksia jokaisesta tilauksesta

Jokainen tuotu tilaus sisältää:

  • Tilauksen tunnus
  • Ostajan nimi ja sähköpostiosoite
  • Ostettu tuote
  • Kokonais- ja nettosaanti
  • Valuutta
  • Tilauksen päivämäärä
  • Tila (valmis, palautettu, odottaa)

Automaattiset uudelleenyritykset​

Jos tuonti epäonnistuu tilapäisen virheen vuoksi (aikakatkaisu, palvelinvirhe), Frihet yrittää automaattisesti uudelleen enintään 3 kertaa eksponentiaalisin odotusajoin (1s, 2s, 4s). Sinun ei tarvitse tehdä mitään — uudelleenyritykset ovat läpinäkyviä.

Ongelmien ratkaisu​

"Todennusvirhe"​

  • Tarkista, että API-avain on oikea eikä sitä ole peruutettu
  • Varmista, että Lemon Squeezy -tilisi on aktiivinen
  • Jos loit uuden API-avaimen, päivitä se Frihetissä

"Tilauksia ei tuoda"​

  • Tarkista, että valitsemallasi päivämäärävälillä on tilauksia
  • Varmista, ettei API-avain ole rajoitettu tiettyihin scopeihin
  • Jos kauppasi on uusi, varmista, että siellä on vähintään yksi valmis tilaus

"Summat eivät täsmää Lemon Squeezyssä näkemäni kanssa"​

  • Frihet tuo sen summan, jonka saat (netto verojen ja Lemon Squeezyn palkkioiden jälkeen)
  • Ostajan näkemä bruttosumma sisältää MoR:n hallinnoimat verot
  • Tarkista erittely Lemon Squeezy -hallintapaneelista vahvistaaksesi

"Haluan katkaista yhteyden"​

  1. Siirry kohtaan Asetukset → Integraatiot → Lemon Squeezy
  2. Napsauta Katkaise yhteys
  3. Valinnaisesti, peruuta API-avain Lemon Squeezy -hallintapaneelista

Seuraavat vaiheet​