Lemon Squeezy
Questa integrazione è attiva e pronta all'uso in Frihet.
Connetti il tuo negozio Lemon Squeezy a Frihet. Importa prodotti e ordini di software digitale, registra automaticamente le entrate e mantieni tutta la tua fatturazione centralizzata. Lemon Squeezy agisce come Merchant of Record (gestisce le imposte per te) e Frihet registra le transazioni per la tua contabilità.
A cosa serve?
Con Lemon Squeezy integrato:
- Importare prodotti — Porta il tuo catalogo di software e prodotti digitali in Frihet
- Importare ordini — Ogni vendita viene registrata come entrata nel tuo ERP
- Deduplicazione automatica — Gli ordini già importati non vengono duplicati (prefisso
LS-) - Multi-negozio — Se hai più negozi, seleziona quale importare o importa da tutti
- Gestione delle imposte semplificata — Lemon Squeezy gestisce le imposte come MoR; Frihet registra gli importi netti
- Abbonamenti — Monitoraggio dei pagamenti ricorrenti SaaS
Requisiti
- Account Lemon Squeezy attivo — lemonsqueezy.com
- Chiave API — Si genera dalla dashboard
- Frihet Pro o superiore
Connettere Lemon Squeezy con Frihet
Passaggio 1: Ottenere la tua Chiave API
- Vai su app.lemonsqueezy.com/settings/api
- Accedi al tuo account
- Fai clic su Create API key (o sul pulsante "+")
- Assegna un nome (es: "Frihet ERP")
- Copia la Chiave API generata
La Chiave API viene mostrata solo una volta al momento della creazione. Copiala prima di chiudere la finestra.
Passaggio 2: Configurare in Frihet
- Vai su Impostazioni → Integrazioni
- Cerca Lemon Squeezy
- Fai clic su Connetti
- Incolla la tua Chiave API
- Fai clic su Verifica connessione
- Se corretto, Frihet caricherà i tuoi negozi disponibili
- (Opzionale) Seleziona un negozio specifico dal menu a tendina — se non ne selezioni nessuno, verranno importati prodotti e ordini da tutti i tuoi negozi
- Fai clic su Salva connessione
Passaggio 3: Verificare la connessione
- Frihet mostrerà un riepilogo del tuo negozio:
- Nome del negozio
- Numero di prodotti
- Ordini recenti
- Esegui un'importazione di prova
Come funziona
Frihet usa l'API di Lemon Squeezy con formato JSON:API:
- Fornisci la tua Chiave API
- Frihet invia la chiave nell'intestazione
Authorization: Bearer <api-key> - Le risposte seguono il formato JSON:API (con
data,attributes,relationships) - I prodotti e gli ordini vengono importati su richiesta
- La deduplicazione si basa sull'ID dell'ordine di Lemon Squeezy (prefisso
LS-{id}) - La Chiave API viene memorizzata cifrata (AES-256-GCM) in Frihet
Dati sincronizzati
| Dato | Direzione | Frequenza |
|---|---|---|
| Prodotti | Lemon Squeezy → Frihet | Su richiesta |
| Ordini (orders) | Lemon Squeezy → Frihet | Su richiesta |
| Dati dell'acquirente | Lemon Squeezy → Frihet | Con ogni ordine |
| Importo e valuta | Lemon Squeezy → Frihet | Con ogni ordine |
| Stato dell'ordine | Lemon Squeezy → Frihet | Con ogni importazione |
Merchant of Record
Lemon Squeezy agisce come Merchant of Record, il che significa che:
- Lemon Squeezy addebita il cliente, gestisce l'IVA/Sales Tax ed emette la fattura all'acquirente
- Tu ricevi l'importo netto (al netto di imposte e commissioni)
- Frihet registra l'entrata netta che ricevi per la tua contabilità interna
Questo semplifica la tua contabilità: non è necessario calcolare le imposte internazionali per ogni vendita digitale.
Casi d'uso
Sviluppatore indie con SaaS
Vendi licenze del tuo software tramite Lemon Squeezy. Ogni pagamento viene importato in Frihet come entrata, sia i pagamenti unici che i rinnovi degli abbonamenti.
Creatore di plugin o temi
Vendi plugin di WordPress, temi di Shopify o estensioni. Frihet consolida queste entrate con il resto della tua fatturazione (servizi di consulenza, altri clienti).
Monitoraggio degli abbonamenti
Hai un prodotto SaaS con piano mensile e annuale. Da Frihet puoi vedere il dettaglio delle entrate ricorrenti importate da Lemon Squeezy insieme al resto della tua attività.
Importare prodotti
- Vai su Impostazioni → Integrazioni → Lemon Squeezy
- Fai clic su Importa prodotti
- Frihet importerà i prodotti dal tuo negozio
Dati importati per prodotto:
- Nome
- Prezzo
- Tipo (pagamento unico, abbonamento)
- Stato (pubblicato, bozza)
Importare ordini
- Vai su Impostazioni → Integrazioni → Lemon Squeezy
- Fai clic su Importa ordini
- Seleziona l'intervallo di date
- Frihet creerà registrazioni di entrate per ogni ordine
Ogni ordine importato include:
- ID dell'ordine
- Nome ed email dell'acquirente
- Prodotto acquistato
- Importo totale e netto
- Valuta
- Data dell'ordine
- Stato (completato, rimborsato, in sospeso)
Tentativi automatici
Se un'importazione fallisce a causa di un errore temporaneo (timeout, errore del server), Frihet riproverà automaticamente fino a 3 volte con attese esponenziali (1s, 2s, 4s). Non è necessario fare nulla — i tentativi sono trasparenti.
Risoluzione dei problemi
"Errore di autenticazione"
- Verifica che la Chiave API sia corretta e non sia stata revocata
- Controlla che il tuo account Lemon Squeezy sia attivo
- Se hai creato una nuova Chiave API, aggiornala in Frihet
"Gli ordini non vengono importati"
- Controlla di avere ordini nell'intervallo di date selezionato
- Verifica che la Chiave API non sia limitata a determinati ambiti
- Se il tuo negozio è nuovo, assicurati che ci sia almeno un ordine completato
"Gli importi non corrispondono a quanto vedo in Lemon Squeezy"
- Frihet importa l'importo che tu ricevi (al netto di imposte e commissioni di Lemon Squeezy)
- L'importo lordo che vede l'acquirente include le imposte gestite dal MoR
- Consulta il dettaglio nella tua dashboard di Lemon Squeezy per confermare
"Voglio disconnettermi"
- Vai su Impostazioni → Integrazioni → Lemon Squeezy
- Fai clic su Disconnetti
- Opzionalmente, revoca la Chiave API dalla tua dashboard di Lemon Squeezy