Aller au contenu principal

Gumroad

Disponible

Cette intégration est active et prête à l'emploi dans Frihet.

Connectez votre compte Gumroad à Frihet. Importez les produits et les ventes de votre boutique numérique, générez des factures automatiques et consolidez vos revenus de créateur avec le reste de votre facturation.

À quoi ça sert ?​

Avec Gumroad intégré :

  • Importer des produits — Transférez votre catalogue Gumroad vers Frihet
  • Importer des ventes — Chaque vente devient un enregistrement de revenu
  • Factures automatiques — Générez des factures pour chaque vente avec les données de l'acheteur
  • Déduplication — Les ventes déjà importées ne sont pas dupliquées
  • Préfixe GR- — Les ventes importées sont identifiées par le préfixe GR- pour un suivi facile
  • Statut des remboursements — Les remboursements sur Gumroad sont reflétés automatiquement

Prérequis​

  • Compte Gumroad actif — gumroad.com
  • Access Token de l'API — Il est généré depuis les paramètres de Gumroad
  • Frihet Pro ou supérieur

Connecter Gumroad à Frihet​

Étape 1 : Obtenir votre Access Token​

  1. Rendez-vous sur app.gumroad.com/settings/advanced
  2. Connectez-vous à votre compte Gumroad
  3. Dans la section Applications, recherchez Access Token
  4. Si vous n'en avez pas, cliquez sur Create application :
    • Nom : "Frihet ERP"
    • URI de redirection : https://app.frihet.io (non utilisé, mais obligatoire)
  5. Copiez l'Access Token généré

Étape 2 : Configurer dans Frihet​

  1. Allez dans Paramètres → Intégrations
  2. Recherchez Gumroad
  3. Cliquez sur Connecter
  4. Collez votre Access Token
  5. Cliquez sur Vérifier la connexion
  6. Si c'est correct, vous verrez le nom de votre profil Gumroad

Étape 3 : Vérifier la connexion​

  1. Frihet affichera un résumé de votre compte :
    • Nombre de produits actifs
    • Ventes récentes
  2. Effectuez une importation de test pour vérifier que tout fonctionne

Comment ça marche​

Frihet utilise l'API Gumroad avec l'authentification Bearer :

  1. Vous fournissez votre Access Token
  2. Frihet envoie le token dans l'en-tête Authorization: Bearer <token>
  3. Les produits et les ventes sont importés à la demande
  4. Chaque vente importée reçoit un identifiant avec le préfixe GR- (ex: GR-abc123)
  5. La déduplication est basée sur l'ID de vente Gumroad : si une vente a déjà été importée, elle n'est pas dupliquée
  6. Le token est stocké chiffré (AES-256-GCM) dans Frihet

Données synchronisées​

DonnéeDirectionFréquence
ProduitsGumroad → FrihetÀ la demande
VentesGumroad → FrihetÀ la demande
Données de l'acheteurGumroad → FrihetÀ chaque vente
Statut de remboursementGumroad → FrihetÀ chaque importation
Prix et deviseGumroad → FrihetÀ chaque vente

Mappage des statuts​

Statut GumroadStatut Frihet
Vente terminéeRevenu enregistré
Remboursement partielRevenu ajusté
Remboursement completRevenu annulé / avoir

Cas d'utilisation​

Créateur numérique avec des ebooks et des cours​

Vous vendez des ebooks, des modèles et des cours sur Gumroad. Chaque vente est importée automatiquement dans Frihet avec les données de l'acheteur, générant un enregistrement de revenu que vous pouvez facturer et déclarer.

Freelance qui vend des modèles​

En plus de vos services de conseil, vous vendez des modèles sur Gumroad. Frihet consolide vos revenus de services (factures manuelles) avec ceux des produits numériques (importés de Gumroad) dans un seul tableau de bord.

Suivi des remboursements​

Un acheteur demande un remboursement sur Gumroad. Lors d'une nouvelle importation des ventes, Frihet détecte le changement de statut et ajuste l'enregistrement de revenu pour refléter le remboursement.

Importer des produits​

  1. Allez dans Paramètres → Intégrations → Gumroad
  2. Cliquez sur Importer les produits
  3. Frihet importera tous vos produits actifs de Gumroad
  4. Les produits apparaîtront dans votre catalogue Frihet

Données importées par produit :

  • Nom du produit
  • Prix
  • Description
  • Statut (actif/inactif)

Importer des ventes​

  1. Allez dans Paramètres → Intégrations → Gumroad
  2. Cliquez sur Importer les ventes
  3. Sélectionnez la plage de dates
  4. Frihet importera les ventes et créera des enregistrements de revenu

Chaque vente importée comprend :

  • ID de vente avec préfixe GR- (ex: GR-xYz123)
  • Nom et e-mail de l'acheteur
  • Produit vendu
  • Montant et devise
  • Date de la vente
  • Statut (terminée / remboursée)

Retentatives automatiques​

Si une importation échoue en raison d'une erreur temporaire (timeout, erreur de serveur), Frihet réessaie automatiquement jusqu'à 3 fois avec des attentes exponentielles (1s, 2s, 4s). Vous n'avez rien à faire — les réessais sont transparents.

Dépannage​

"Erreur d'authentification"​

  • Vérifiez que l'Access Token est correct
  • Vérifiez que votre compte Gumroad est actif
  • Si vous avez régénéré le token, mettez-le à jour dans Frihet

"Mes ventes ne sont pas importées"​

  • Vérifiez que vous avez des ventes dans la plage de dates sélectionnée
  • Les ventes très anciennes peuvent prendre plus de temps à être importées
  • Vérifiez que l'Access Token a des permissions de lecture

"Je vois des ventes en double"​

  • Cela ne devrait pas arriver : Frihet déduplique par ID de vente Gumroad
  • Si cela se produit, déconnectez et reconnectez l'intégration
  • Les ventes déjà enregistrées dans Frihet ne seront pas affectées

"Un remboursement n'est pas reflété"​

  • Importez à nouveau les ventes pour que Frihet détecte le changement de statut
  • Le remboursement doit être traité sur Gumroad (pas seulement demandé)

Prochaines étapes​