Gumroad
Questa integrazione è attiva e pronta all'uso in Frihet.
Connetti il tuo account Gumroad a Frihet. Importa prodotti e vendite dal tuo negozio digitale, genera fatture automatiche e consolida i tuoi ricavi da creatore con il resto della tua fatturazione.
A cosa serve?
Con Gumroad integrato:
- Importare prodotti — Porta il tuo catalogo Gumroad in Frihet
- Importare vendite — Ogni vendita diventa una registrazione di entrata
- Fatture automatiche — Genera fatture per ogni vendita con i dati dell'acquirente
- Deduplicazione — Le vendite già importate non vengono duplicate
- Prefisso GR- — Le vendite importate vengono identificate con il prefisso GR- per un facile tracciamento
- Stato dei rimborsi — I rimborsi in Gumroad si riflettono automaticamente
Requisiti
- Account Gumroad attivo — gumroad.com
- Access Token dell'API — Si genera dalle impostazioni di Gumroad
- Frihet Pro o superiore
Connettere Gumroad con Frihet
Passaggio 1: Ottenere il tuo Access Token
- Vai su app.gumroad.com/settings/advanced
- Accedi al tuo account Gumroad
- Nella sezione Applications, cerca Access Token
- Se non ne hai uno, clicca su Create application:
- Nome: "Frihet ERP"
- Redirect URI:
https://app.frihet.io(non utilizzato, ma obbligatorio)
- Copia l'Access Token generato
Passaggio 2: Configurare in Frihet
- Vai su Impostazioni → Integrazioni
- Cerca Gumroad
- Clicca su Connetti
- Incolla il tuo Access Token
- Clicca su Verifica connessione
- Se corretto, vedrai il nome del tuo profilo Gumroad
Passaggio 3: Verificare la connessione
- Frihet mostrerà un riepilogo del tuo account:
- Numero di prodotti attivi
- Vendite recenti
- Effettua un'importazione di prova per verificare che tutto funzioni
Come funziona
Frihet utilizza l'API di Gumroad con autenticazione Bearer:
- Fornisci il tuo Access Token
- Frihet invia il token nell'header
Authorization: Bearer <token> - I prodotti e le vendite vengono importati su richiesta
- Ogni vendita importata riceve un identificatore con prefisso GR- (es:
GR-abc123) - La deduplicazione si basa sull'ID di vendita di Gumroad: se una vendita è già stata importata, non viene duplicata
- Il token viene memorizzato cifrato (AES-256-GCM) in Frihet
Dati sincronizzati
| Dato | Direzione | Frequenza |
|---|---|---|
| Prodotti | Gumroad → Frihet | Su richiesta |
| Vendite | Gumroad → Frihet | Su richiesta |
| Dati dell'acquirente | Gumroad → Frihet | Ad ogni vendita |
| Stato di rimborso | Gumroad → Frihet | Ad ogni importazione |
| Prezzo e valuta | Gumroad → Frihet | Ad ogni vendita |
Mappatura degli stati
| Stato Gumroad | Stato Frihet |
|---|---|
| Vendita completata | Entrata registrata |
| Rimborso parziale | Entrata aggiustata |
| Rimborso completo | Entrata annullata / nota di credito |
Casi d'uso
Creatore digitale con ebook e corsi
Vendi ebook, modelli e corsi su Gumroad. Ogni vendita viene importata in Frihet automaticamente con i dati dell'acquirente, generando una registrazione di entrata che puoi fatturare e dichiarare.
Freelance che vende template
Oltre ai tuoi servizi di consulenza, vendi template su Gumroad. Frihet consolida le tue entrate da servizi (fatture manuali) con quelle da prodotti digitali (importati da Gumroad) in un unico pannello.
Controllo dei rimborsi
Un acquirente richiede un rimborso su Gumroad. Importando nuovamente le vendite, Frihet rileva il cambiamento di stato e aggiusta la registrazione di entrata per riflettere il rimborso.
Importare prodotti
- Vai su Impostazioni → Integrazioni → Gumroad
- Clicca su Importa prodotti
- Frihet importerà tutti i tuoi prodotti attivi da Gumroad
- I prodotti appariranno nel tuo catalogo di Frihet
Dati importati per prodotto:
- Nome del prodotto
- Prezzo
- Descrizione
- Stato (attivo/inattivo)
Importare vendite
- Vai su Impostazioni → Integrazioni → Gumroad
- Clicca su Importa vendite
- Seleziona l'intervallo di date
- Frihet importerà le vendite e creerà registrazioni di entrata
Ogni vendita importata include:
- ID di vendita con prefisso GR- (es:
GR-xYz123) - Nome ed email dell'acquirente
- Prodotto venduto
- Importo e valuta
- Data della vendita
- Stato (completata / rimborsata)
Tentativi automatici
Se un'importazione fallisce a causa di un errore temporaneo (timeout, errore del server), Frihet riprova 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 l'Access Token sia corretto
- Controlla che il tuo account Gumroad sia attivo
- Se hai rigenerato il token, aggiornalo in Frihet
"Le mie vendite non vengono importate"
- Controlla di avere vendite nell'intervallo di date selezionato
- Le vendite molto vecchie potrebbero impiegare più tempo per essere importate
- Verifica che l'Access Token abbia i permessi di lettura
"Vedo vendite duplicate"
- Non dovrebbe accadere: Frihet deduplica per ID di vendita di Gumroad
- Se accade, disconnetti e riconnetti l'integrazione
- Le vendite già registrate in Frihet non saranno influenzate
"Un rimborso non si riflette"
- Importa nuovamente le vendite affinché Frihet rilevi il cambiamento di stato
- Il rimborso deve essere processato in Gumroad (non solo richiesto)