Passa al contenuto principale

Toggl Track

Disponibile

Questa integrazione è attiva e pronta all'uso in tutti i piani Pro.

Collega Toggl Track a Frihet. Importa le tue ore registrate e converti il tempo in fatture.

A cosa serve?​

Con Toggl integrato:

  • Importare ore — Porti i tuoi registri orari in Frihet
  • Creare fatture dalle ore — Converti le ore in fatture per cliente
  • Tariffa configurabile — Definisci prezzo/ora per cliente
  • Progetti e attività — Raggruppa per progetto per fatture dettagliate

Requisiti​

  • Account Toggl Track attivo — Devi aver registrato del tempo
  • Chiave API di Toggl — Per connettersi
  • Frihet Pro o superiore

Ottenere la tua Chiave API di Toggl​

Passaggio 1: Apri Toggl​

  1. Vai su track.toggl.com
  2. Accedi
  3. Nell'angolo in basso a sinistra, fai clic sul tuo nome
  4. Seleziona Impostazioni (ingranaggio)

Passaggio 2: Trova la tua Chiave API​

  1. In Impostazioni, vai su Token API
  2. Vedrai un token lungo (es: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6)
  3. Copialo (importante: conservalo al sicuro, non condividerlo)

Connettere Toggl a Frihet​

Passaggio 1: Apri Frihet​

  1. Vai su Impostazioni → Integrazioni
  2. Cerca Toggl Track
  3. Fai clic su Connetti

Passaggio 2: Inserisci la tua Chiave API​

  1. Incolla il token di Toggl
  2. Fai clic su Verifica connessione
  3. Se corretto, vedrai "✅ Connesso"

Passaggio 3: Configura la sincronizzazione​

  1. Scegli quali progetti sincronizzare:

    • Tutti i progetti ✅
    • Solo progetti specifici ⚪

  2. Definisci tariffa predefinita:

    • Esempio: €60/ora
    • Puoi cambiarla per cliente in seguito

  3. Salva

Importare ore registrate​

Opzione 1: Importazione manuale​

  1. In Frihet, vai su Fatturazione → Importa da Toggl
  2. Scegli l'intervallo di date:
    • "Questo mese"
    • "Ultimi 7 giorni"
    • "Date personalizzate"
  3. Seleziona quali progetti importare
  4. Fai clic su "Importa"
  5. Vengono create bozze di fattura (puoi rivedere prima di salvare)

Opzione 2: Sincronizzazione automatica​

Se la attivi in Impostazioni:

  1. Ogni giorno, Frihet importa automaticamente le tue ore da Toggl
  2. Le raggruppa per cliente
  3. Crea bozze di fattura
  4. Tu le rivedi e le confermi

Esempio: Convertire le ore in fattura​

In Toggl​

Proyecto: Diseño Web - Cliente XYZ
- Lunes 3 feb: 5 horas (Diseño UI)
- Miércoles 5 feb: 3 horas (Desarrollo)
- Total: 8 horas

Proyecto: Consultoría - Juan García
- Jueves 6 feb: 2 horas (Reunión)
- Total: 2 horas

In Frihet (dopo l'importazione)​

Fattura #1 - Cliente XYZ

Concepto: Diseño Web
- 5 horas @ €60 = €300
- 3 horas @ €60 = €180
Total: €480

Desglose:
- 3 feb: 5h Diseño UI
- 5 feb: 3h Desarrollo

Fattura #2 - Juan García

Concepto: Consultoría
- 2 horas @ €60 = €120

Desglose:
- 6 feb: 2h Reunión

Tariffe personalizzate per cliente​

Per impostazione predefinita, tutti usano la tariffa di €60/h. Puoi cambiarla:

Opzione 1: Modifica nella fattura​

  1. Viene creata la fattura
  2. Prima di confermare, cambi la tariffa manualmente
  3. Le ore vengono ricalcolate automaticamente

Opzione 2: Tariffa fissa per cliente​

  1. Vai su Clienti → apri un cliente
  2. In "Tarifa Toggl", inserisci €80/ora
  3. La prossima importazione userà quella tariffa per quel cliente

Suddivisione dettagliata delle attività​

Se in Toggl usi la descrizione delle attività, Frihet le include:

En Toggl:
- 10:00-12:00 "Reunión con cliente" (2h)
- 14:00-16:30 "Correcciones de diseño" (2.5h)

In Frihet appare come:

Factura:
- Reunión con cliente: 2h @ €60 = €120
- Correcciones de diseño: 2.5h @ €60 = €150
Total: €270

Puoi modificare ogni riga prima di confermare.

Progetti e clienti​

Mappatura automatica​

Frihet cerca di mappare:

Proyecto Toggl "Cliente A"
→ Cliente Frihet "Cliente A"

Si el cliente no existe:
→ Frihet lo crea automáticamente

Mappatura manuale​

Se vuoi che un progetto Toggl venga assegnato a un altro cliente:

  1. Vai su Impostazioni → Toggl → Mappatura progetti
  2. Per ogni progetto, scegli il cliente Frihet
  3. Salva

Esempio:

Proyecto Toggl "Diseño Q1"
→ Asignar a cliente Frihet "Empresa SL"

Prova l'integrazione​

Test di importazione​

  1. In Toggl, registra un'ora: "Attività di prova" (1 ora)
  2. In Frihet, vai su Fatturazione → Importa da Toggl
  3. Scegli "Ultime 24 ore"
  4. Fai clic su "Importa"
  5. Dovresti vedere una bozza di fattura

Se non appare:

  • Verifica che Toggl sia connesso ✅
  • Le ore devono essere registrate (non bozze)
  • Attendi 24 ore dopo aver registrato in Toggl

Importare registri orari​

Frihet può convertire i tuoi registri orari in voci di fattura automaticamente:

  1. Collega il tuo account Toggl
  2. Vai alla scheda Dati dell'integrazione
  3. Fai clic su Importa registri orari
  4. Introduci la tua tariffa oraria
  5. Frihet raggruppa le voci per progetto e crea una bozza di fattura

Le voci vengono raggruppate per progetto, sommando le ore totali e applicando la tariffa indicata.

Cose che puoi fare​

Raggruppare per progetto​

Importi un progetto completo del mese:

Proyecto "App iOS":
- Semana 1: 20 horas
- Semana 2: 25 horas
Total: 45 horas @ €70/h = €3.150

Crea una fattura unica: "Sviluppo App iOS - Febbraio 2025"

Fatturare per sprint​

Se lavori in sprint:

  1. In Toggl, ogni sprint in un progetto separato
  2. Ogni mese, importi e crei una fattura per sprint
  3. Suddivisione chiara per il cliente

Tariffe per tipo di lavoro​

Toggl: Tag "Diseño" → €80/h
Toggl: Tag "Desarrollo" → €100/h
Toggl: Tag "Consultoría" → €60/h

Puoi mappare queste tariffe diverse in Frihet.

Sincronizzazione in tempo reale​

Il lavoro che registri in Toggl oggi:

  • Apparirà disponibile per l'importazione in Frihet domani
  • Se attivi la sincronizzazione automatica, verrà importato automaticamente

Toggl invia i dati una volta al giorno (normalmente alle 3am UTC).

Modificare dopo l'importazione​

Dopo aver importato le ore:

  1. La fattura è in stato "Bozza"
  2. Puoi modificare:
    • Voce/Concetto
    • Tariffa oraria
    • Aggiungere/rimuovere righe
    • Cambiare cliente
  3. Quando è a posto, conferma la fattura

Le ore originali in Toggl non vengono alterate — puoi modificare la fattura liberamente.

Eliminare un'importazione​

Se hai importato per errore:

  1. Cerca la fattura in Fatturazione → Fatture
  2. Se è ancora "Bozza", puoi Eliminare
  3. Le ore in Toggl rimangono lì, senza modifiche

Se l'hai già confermata come fattura, puoi:

  • Contrassegnarla come "Annullata"
  • O creare una nota di credito

Limiti e restrizioni​

  • Massimo 90 giorni di cronologia in un'importazione
  • 10 importazioni simultanee (non dovrebbe influire su di te)
  • Nessuna sincronizzazione delle eliminazioni — Se elimini un'ora in Toggl, la fattura in Frihet rimane

Risoluzione dei problemi​

"Non vedo le mie ore in Toggl"​

  • Verifica che sia connesso ✅
  • Le ore devono essere registrate (non bozze)
  • Attendi 24 ore dopo aver registrato in Toggl

"Posso cambiare la tariffa dopo aver fatturato?"​

Sì. Modifica la fattura:

  1. Fatturazione → apri la fattura
  2. Cambia la tariffa oraria
  3. Viene ricalcolata automaticamente
  4. Salva le modifiche

Cosa succede se cambio la Chiave API?​

Disconnetti e riconnetti:

  1. Impostazioni → Integrazioni → Toggl
  2. Disconnetti
  3. Inserisci la nuova Chiave API
  4. Connetti

Le fatture già create rimangono invariate.

Prossimi passi​

Precedente: Shopify