Passa al contenuto principale

Google Drive

Disponibile

Questa integrazione è attiva e pronta all'uso in Frihet.

Collega il tuo Google Drive a Frihet. Elenca, cerca, carica e scarica file direttamente dal tuo ERP. Salva fatture e documenti in cartelle organizzate senza uscire da Frihet.

A cosa serve?​

Con Google Drive integrato:

  • Elencare file — Visualizza i tuoi file e cartelle di Drive da Frihet
  • Cercare documenti — Trova file per nome o contenuto
  • Caricare file — Salva fatture, preventivi e documenti in Drive
  • Scaricare file — Accedi ai documenti salvati in Drive da Frihet
  • Organizzazione automatica — Salva documenti in cartelle per cliente o anno

Requisiti​

  • Account Google — Gmail, Google Workspace o Google One
  • Frihet Pro o superiore
Nessuna credenziale da inserire

Questa integrazione utilizza OAuth con Google. Non è necessario copiare alcuna chiave API o token. Autorizzi semplicemente Frihet ad accedere al tuo Google Drive tramite una finestra di accesso di Google.

Configurazione tecnica

Questa integrazione richiede che la variabile d'ambiente VITE_GOOGLE_CLIENT_ID sia configurata sul server di Frihet. Se sei un utente di Frihet Cloud, è già configurato. Se utilizzi Frihet self-hosted, consulta la documentazione dell'API REST.

Collegare Google Drive con Frihet​

Passo 1: Avviare la connessione​

  1. Vai a Impostazioni → Integrazioni
  2. Cerca Google Drive
  3. Clicca su Collega con Google

Passo 2: Autorizzare su Google​

  1. Si aprirà la finestra di accesso di Google
  2. Seleziona il tuo account Google
  3. Rivedi i permessi richiesti:
    • Visualizzare, creare ed eliminare file in Google Drive
    • Visualizzare le informazioni del tuo account
  4. Clicca su Consenti

Passo 3: Verificare la connessione​

  1. Tornato in Frihet, vedrai "Connesso" con il tuo account Google
  2. Frihet mostrerà i tuoi file recenti di Drive
  3. L'integrazione è pronta all'uso

Come funziona​

Frihet usa l'API di Google Drive con flusso di autorizzazione OAuth 2.0 (redirect):

  1. Clicchi su "Collega con Google" e autorizzi nella finestra di Google
  2. Google genera token di accesso e di refresh
  3. Frihet memorizza entrambi i token cifrati (AES-256-GCM)
  4. Con il token di accesso, Frihet può elencare, cercare, caricare e scaricare file
  5. Il token si aggiorna automaticamente quando scade
  6. In nessun momento inserisci le credenziali di Google in Frihet

Dati sincronizzati​

DatoDirezioneFrequenza
Elenco di fileGoogle Drive → FrihetSu richiesta
Ricerca di fileGoogle Drive → FrihetSu richiesta
Caricamento di fileFrihet → Google DriveSu richiesta
Scaricamento di fileGoogle Drive → FrihetSu richiesta

Funzionalità​

Elencare file​

  1. Da Frihet, accedi alla sezione di Google Drive
  2. Vedrai i tuoi file e cartelle recenti
  3. Naviga tra le cartelle per trovare documenti

Ogni file mostra:

  • Nome
  • Tipo (documento, foglio di calcolo, PDF, immagine, ecc.)
  • Data di modifica
  • Dimensione

Cercare file​

  1. Usa la barra di ricerca di Google Drive in Frihet
  2. Cerca per nome file o contenuto
  3. I risultati includono file da tutto il tuo Drive

Caricare file​

Carica documenti da Frihet direttamente su Google Drive:

  1. Seleziona il file da caricare (fattura PDF, preventivo, documento)
  2. Scegli la cartella di destinazione in Drive
  3. Il file viene caricato e diventa disponibile nel tuo Drive

Scaricare file​

  1. Naviga o cerca il file in Drive da Frihet
  2. Clicca su Scarica
  3. Il file viene scaricato sul tuo dispositivo

Esportare documenti in Drive​

Puoi esportare fatture e altri documenti direttamente su Google Drive:

  1. Collega il tuo account Google Drive
  2. Seleziona la cartella di destinazione (o usa la cartella radice)
  3. Usa la funzione di esportazione per salvare i documenti in Drive

Frihet può elencare le tue cartelle in modo che tu possa scegliere dove salvare i file.

Casi d'uso​

Backup automatico delle fatture​

Ogni volta che generi una fattura in PDF, la carichi in una cartella di Google Drive organizzata per anno e mese. Il tuo commercialista ha accesso alla cartella condivisa e può consultare le fatture senza richiedertele.

Documentazione di progetti centralizzata​

Salvi contratti, proposte e documenti di progetto in Google Drive. Da Frihet, accedi a questi documenti mentre lavori alla fatturazione del progetto senza cambiare applicazione.

Condividere con il commercialista​

Crei una cartella "Frihet - Fatture 2026" in Drive e la condividi con il tuo commercialista. Carichi fatture e documenti da Frihet direttamente in quella cartella.

Importare documenti per le spese​

Hai fatture di fornitori salvate in Drive. Da Frihet, le scarichi per allegarle come giustificativi quando registri le spese.

Risoluzione dei problemi​

"Errore durante la connessione con Google"​

  • Verifica che il tuo account Google sia attivo
  • Se utilizzi Google Workspace aziendale, il tuo amministratore potrebbe aver limitato le applicazioni di terze parti
  • Controlla di non avere blocchi popup che impediscono la finestra di Google

"Non vedo i miei file"​

  • Verifica di aver autorizzato l'accesso a Google Drive (non solo a Gmail)
  • I file condivisi con te appaiono nella sezione "Condivisi con me"
  • Ricarica la vista in Frihet

"Non posso caricare file"​

  • Controlla di avere spazio disponibile nel tuo Google Drive
  • Il file non deve superare il limite di dimensione di Google Drive
  • Verifica che la sessione non sia scaduta

"La sessione è scaduta"​

  • Google potrebbe richiedere periodicamente una nuova autorizzazione
  • Vai a Impostazioni → Integrazioni → Google Drive e clicca su Riconnetti
  • Tornerai alla finestra di Google per autorizzare di nuovo

"Voglio disconnettere"​

  1. Vai a Impostazioni → Integrazioni → Google Drive
  2. Clicca su Disconnetti
  3. I token vengono eliminati da Frihet
  4. Opzionalmente, revoca l'accesso su myaccount.google.com/permissions

Prossimi passi​