Lemon Squeezy
Cette intégration est active et prête à l'emploi dans Frihet.
Connectez votre boutique Lemon Squeezy à Frihet. Importez des produits et des commandes de logiciels numériques, enregistrez automatiquement les revenus et centralisez toute votre facturation. Lemon Squeezy agit en tant que Merchant of Record (gère les impôts pour vous) et Frihet enregistre les transactions pour votre comptabilité.
À quoi cela sert-il ?
Avec Lemon Squeezy intégré :
- Importer des produits — Apportez votre catalogue de logiciels et de produits numériques à Frihet
- Importer des commandes — Chaque vente est enregistrée comme revenu dans votre ERP
- Déduplication automatique — Les commandes déjà importées ne sont pas dupliquées (préfixe
LS-) - Multi-boutique — Si vous avez plusieurs boutiques, sélectionnez celle(s) à importer ou importez de toutes
- Gestion simplifiée des impôts — Lemon Squeezy gère les impôts en tant que MoR ; Frihet enregistre les montants nets
- Abonnements — Suivi des paiements récurrents de SaaS
Prérequis
- Compte Lemon Squeezy actif — lemonsqueezy.com
- Clé API — Elle est générée depuis le tableau de bord
- Frihet Pro ou supérieur
Connecter Lemon Squeezy avec Frihet
Étape 1 : Obtenir votre clé API
- Allez sur app.lemonsqueezy.com/settings/api
- Connectez-vous à votre compte
- Cliquez sur Create API key (ou le bouton "+")
- Donnez-lui un nom (ex: "Frihet ERP")
- Copiez la clé API générée
La clé API n'est affichée qu'une seule fois lors de sa création. Copiez-la avant de fermer la fenêtre.
Étape 2 : Configurer dans Frihet
- Allez dans Paramètres → Intégrations
- Recherchez Lemon Squeezy
- Cliquez sur Connecter
- Collez votre clé API
- Cliquez sur Vérifier la connexion
- Si la connexion est correcte, Frihet chargera vos boutiques disponibles
- (Facultatif) Sélectionnez une boutique spécifique du menu déroulant — si vous n'en sélectionnez aucune, les produits et commandes de toutes vos boutiques seront importés
- Cliquez sur Enregistrer la connexion
Étape 3 : Vérifier la connexion
- Frihet affichera un résumé de votre boutique :
- Nom de la boutique
- Nombre de produits
- Commandes récentes
- Effectuez une importation de test
Comment ça marche
Frihet utilise l'API de Lemon Squeezy au format JSON:API :
- Vous fournissez votre clé API
- Frihet envoie la clé dans l'en-tête
Authorization: Bearer <api-key> - Les réponses suivent le format JSON:API (avec
data,attributes,relationships) - Les produits et commandes sont importés à la demande
- La déduplication est basée sur l'ID de commande de Lemon Squeezy (préfixe
LS-{id}) - La clé API est stockée chiffrée (AES-256-GCM) dans Frihet
Données synchronisées
| Donnée | Direction | Fréquence |
|---|---|---|
| Produits | Lemon Squeezy → Frihet | À la demande |
| Commandes (orders) | Lemon Squeezy → Frihet | À la demande |
| Données de l'acheteur | Lemon Squeezy → Frihet | À chaque commande |
| Montant et devise | Lemon Squeezy → Frihet | À chaque commande |
| Statut de la commande | Lemon Squeezy → Frihet | À chaque importation |
Merchant of Record
Lemon Squeezy agit en tant que Merchant of Record, ce qui signifie que :
- Lemon Squeezy facture le client, gère la TVA/Taxe de vente et émet la facture à l'acheteur
- Vous recevez le montant net (après impôts et commissions)
- Frihet enregistre le revenu net que vous recevez pour votre comptabilité interne
Cela simplifie votre comptabilité : vous n'avez pas besoin de calculer les impôts internationaux pour chaque vente numérique.
Cas d'utilisation
Développeur indépendant avec SaaS
Vous vendez des licences de votre logiciel via Lemon Squeezy. Chaque paiement est importé dans Frihet comme revenu, qu'il s'agisse de paiements uniques ou de renouvellements d'abonnement.
Créateur de plugins ou de thèmes
Vous vendez des plugins WordPress, des thèmes Shopify ou des extensions. Frihet consolide ces revenus avec le reste de votre facturation (services de conseil, autres clients).
Suivi des abonnements
Vous avez un produit SaaS avec un plan mensuel et annuel. Depuis Frihet, vous pouvez visualiser la ventilation des revenus récurrents importés de Lemon Squeezy ainsi que le reste de votre activité.
Importer les produits
- Allez dans Paramètres → Intégrations → Lemon Squeezy
- Cliquez sur Importer les produits
- Frihet importera les produits de votre boutique
Données importées par produit :
- Nom
- Prix
- Type (paiement unique, abonnement)
- Statut (publié, brouillon)
Importer les commandes
- Allez dans Paramètres → Intégrations → Lemon Squeezy
- Cliquez sur Importer les commandes
- Sélectionnez la plage de dates
- Frihet créera des enregistrements de revenus pour chaque commande
Chaque commande importée comprend :
- ID de la commande
- Nom et e-mail de l'acheteur
- Produit acheté
- Montant total et net
- Devise
- Date de la commande
- Statut (terminé, remboursé, en attente)
Nouvelles tentatives automatiques
Si une importation échoue en raison d'une erreur temporaire (délai d'attente, erreur de serveur), Frihet réessaie automatiquement jusqu'à 3 fois avec des attentes exponentielles (1s, 2s, 4s). Vous n'avez rien à faire — les nouvelles tentatives sont transparentes.
Dépannage
"Erreur d'authentification"
- Vérifiez que la clé API est correcte et n'a pas été révoquée
- Vérifiez que votre compte Lemon Squeezy est actif
- Si vous avez créé une nouvelle clé API, mettez-la à jour dans Frihet
"Les commandes ne sont pas importées"
- Vérifiez que vous avez des commandes dans la plage de dates sélectionnée
- Vérifiez que la clé API n'est pas limitée à certaines portées
- Si votre boutique est nouvelle, assurez-vous qu'il y a au moins une commande terminée
"Les montants ne correspondent pas à ce que je vois dans Lemon Squeezy"
- Frihet importe le montant que vous recevez (net d'impôts et de commissions de Lemon Squeezy)
- Le montant brut que l'acheteur voit inclut les impôts gérés par le MoR
- Consultez la ventilation sur votre tableau de bord Lemon Squeezy pour confirmer
"Je veux me déconnecter"
- Allez dans Paramètres → Intégrations → Lemon Squeezy
- Cliquez sur Déconnecter
- En option, révoquez la clé API depuis votre tableau de bord Lemon Squeezy