In cosa si differenzia dall'integrazione normale di Stripe?

L'integrazione normale usa OAuth ed è bidirezionale: incassi da Frihet. Revenue Sync è unidirezionale: importa fatture già pagate da Stripe usando una API Key ristretta di sola lettura. Non ha accesso al tuo denaro.

Le fatture si duplicano se importo più volte?

No. Ogni fattura importata salva l'ID di Stripe come metadato. Se esiste già in Frihet, viene automaticamente ignorata.

Le fatture importate sono conformi a VeriFactu?

Sì. Passano attraverso la catena di hash SHA-256 e la numerazione gap-free di Frihet, esattamente come le fatture create manualmente. Pronte per il tuo Modello 303 e il libro contabile.

Posso scegliere quali fatture importare?

Puoi impostare una data di inizio. Tutte le fatture pagate da quella data vengono importate. La deduplicazione garantisce che una fattura non venga mai ripetuta.

Importa i tuoi incassi Stripe come fatture in 3 clic

Incassi con Stripe. I tuoi clienti pagano. Ma quelle transazioni non sono fatture finché qualcuno non le converte in una. Quel “qualcuno” non devi più essere tu.

Oggi lanciamo Stripe Revenue Sync: un’integrazione che importa automaticamente i tuoi incassi Stripe come fatture registrate in Frihet. Con deduplicazione, catena di hash VeriFactu e auto-sincronizzazione ogni 6 ore.

Il problema: incassare da un lato, fatturare dall’altro

Se sei founder di un SaaS, freelancer che incassa tramite Stripe o vendi prodotti digitali, probabilmente ti trovi in questa situazione:

Stripe incassa. I tuoi clienti pagano con carta, gli abbonamenti si rinnovano, arrivano pagamenti puntuali.
La tua contabilità non ne è a conoscenza. Quegli incassi esistono in Stripe ma non nel tuo software di fatturazione.
Tu fai da ponte. Ogni mese, crei fatture manualmente copiando i dati da Stripe. O peggio: non lo fai e il tuo commercialista impazzisce il trimestre successivo.

Stripe emette ricevute, ma non fatture fiscalmente valide in Spagna. Non include il tuo NIF, non applica la numerazione richiesta dall’Agenzia delle Entrate, non genera la catena di hash richiesta da VeriFactu. Per conformarsi alla normativa fiscale spagnola, è necessario creare fatture reali in un software di fatturazione.

Finora, ciò significava doppio lavoro. Non più.

Cos’è Stripe Revenue Sync

Revenue Sync connette il tuo account Stripe con Frihet usando una API Key ristretta di sola lettura. Senza OAuth, senza reindirizzamenti, senza concedere permessi di scrittura sul tuo denaro.

Cosa fa:

Consulta le tue fatture pagate in Stripe — solo quelle con stato paid
Crea una fattura in Frihet per ogni incasso — con cliente, voci di dettaglio e importi
Segna la fattura come pagata — la pipeline di VeriFactu si attiva automaticamente
Deduplica per ID di Stripe — se la fattura esiste già, la ignora

Il risultato: i tuoi incassi Stripe appaiono in Frihet come fatture registrate, con numerazione sequenziale, hash SHA-256 e pronti per il tuo Modello 303.

Come funziona in pratica

Tre passi. Senza codice, senza configurazioni complesse.

Passo 1: Crea una API Key ristretta in Stripe

Vai sulla tua Stripe Dashboard > Developers > API Keys. Crea una chiave ristretta con due permessi:

Invoices → Read
Customers → Read

Nient’altro. Non hai bisogno di permessi di scrittura né di accesso a pagamenti, trasferimenti o saldi. La chiave inizia con rk_live_ ed è di sola lettura.

Passo 2: Connettiti a Frihet

Vai su Impostazioni > Integrazioni > Stripe Revenue Sync. Incolla la tua API Key e seleziona da quale data vuoi importare. Puoi importare gli ultimi 90 giorni o scegliere una data specifica.

Passo 3: Importa

Clicca su “Importa ora”. Frihet interroga Stripe, recupera le fatture pagate e le crea nel tuo account. Ogni fattura passa attraverso i trigger di Firestore: numerazione gap-free e catena di hash VeriFactu.

VeriFactu compatibile dal primo import

Le fatture importate da Stripe non sono “di serie B”. Passano esattamente attraverso la stessa pipeline delle fatture che crei manualmente in Frihet:

Numerazione gap-free — Contatore atomico sul server. Senza buchi, senza salti.
Hash SHA-256 — Catena di hash con 8 campi richiesta dall’AEAT. Ogni fattura fa riferimento all’hash della precedente.
Immutabilità — Una volta registrati, i campi critici vengono bloccati. Le modifiche generano rettificative.
Libro contabile — Le fatture importate appaiono nella tua esportazione CSV con le 19 colonne richieste dall’Agenzia delle Entrate.

Ciò significa che i tuoi incassi Stripe sono pronti per il Modello 303, il Modello 130 e qualsiasi ispezione. Senza passaggi aggiuntivi.

Per chi è Revenue Sync

Founder di SaaS che incassa con Stripe Billing

Incassi abbonamenti direttamente in Stripe. Ogni mese si rinnovano decine o centinaia di clienti. Con Revenue Sync, ogni rinnovo appare automaticamente come fattura in Frihet. Il tuo MRR, la tua IVA trimestrale e il tuo libro contabile sempre aggiornati.

Freelancer che incassa progetti tramite Stripe

I tuoi clienti ti pagano tramite Stripe e vuoi avere tutte le fatture in un unico posto per le tue dichiarazioni trimestrali. Senza creare ogni fattura a mano, senza incrociare i dati tra Stripe e il tuo foglio di calcolo.

eCommerce con Stripe diretto

Vendi prodotti digitali o fisici e incassi con Stripe (non tramite Shopify o WooCommerce). Ogni vendita si trasforma in fattura registrata. Particolarmente utile se vendi a clienti dell’UE e hai bisogno di controllo dell’IVA.

Agenzia con fatturazione mista

Alcuni clienti ti pagano tramite Stripe e altri tramite bonifico. Revenue Sync importa quelli di Stripe mentre fatturi il resto manualmente o con la fatturazione diretta di Frihet. Tutto convive nello stesso libro contabile.

Cosa NON è Revenue Sync

È opportuno chiarirlo per evitare confusioni:

Non è l’integrazione OAuth di Stripe. Quella esiste già in Frihet e permette di incassare direttamente dall’app con link di pagamento. Revenue Sync è unidirezionale: importa solo.
Non emette incassi. Non elabora pagamenti né crea addebiti in Stripe. Legge solo fatture già pagate.
Non sostituisce Stripe Billing. Lo complementa. Stripe incassa, Frihet registra.
Non filtra per cliente. Importa tutte le fatture pagate dalla data che scegli. La deduplicazione si occupa di evitare duplicati.

Sicurezza

La API Key ristretta ha permessi di sola lettura su due risorse: invoices e customers. Non può spostare denaro, creare incassi né modificare il tuo account Stripe.

La chiave viene archiviata cifrata con AES-256-GCM sul server di Frihet. Non viene mai esposta al frontend. Se Stripe rileva che la chiave è scaduta o è stata revocata, Frihet contrassegna l’integrazione come “richiede riconnessione” e ti avvisa.

Puoi disconnetterti in qualsiasi momento da Impostazioni > Integrazioni. Le fatture già importate rimangono in Frihet.

Inizia ora

Se incassi con Stripe, le tue fatture sono già lì. Hanno solo bisogno di arrivare alla tua contabilità. Stripe Revenue Sync lo fa in 3 clic, senza OAuth, senza permessi pericolosi e con VeriFactu dal primo giorno.

Connetti il tuo account Stripe e lascia che i tuoi incassi si trasformino in fatture registrate automaticamente.