Aller au contenu principal

Toggl Track

Disponible

Cette intégration est active et prête à l'emploi sur tous les plans Pro.

Connectez Toggl Track à Frihet. Importez vos heures enregistrées et convertissez le temps en factures.

À quoi ça sert ?​

Avec Toggl intégré :

  • Importer des heures — Vous importez vos relevés de temps dans Frihet
  • Créer des factures à partir des heures — Convertit les heures en factures par client
  • Tarif configurable — Définit un prix/heure par client
  • Projets et tâches — Regroupe par projet pour des factures détaillées

Prérequis​

  • Compte Toggl Track actif — Vous devez avoir enregistré du temps
  • Clé API Toggl — Pour la connexion
  • Frihet Pro ou supérieur

Obtenir votre clé API Toggl​

Étape 1 : Ouvrez Toggl​

  1. Allez sur track.toggl.com
  2. Connectez-vous
  3. Dans le coin inférieur gauche, cliquez sur votre nom
  4. Sélectionnez Paramètres (icône d'engrenage)

Étape 2 : Trouvez votre clé API​

  1. Dans Paramètres, allez à API Token
  2. Vous verrez un long jeton (ex: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6)
  3. Copiez-le (important : gardez-le en sécurité, ne le partagez pas)

Connecter Toggl à Frihet​

Étape 1 : Ouvrez Frihet​

  1. Allez dans Paramètres → Intégrations
  2. Recherchez Toggl Track
  3. Cliquez sur Connecter

Étape 2 : Entrez votre clé API​

  1. Collez le jeton Toggl
  2. Cliquez sur Vérifier la connexion
  3. Si c'est correct, vous verrez "✅ Connecté"

Étape 3 : Configurez la synchronisation​

  1. Choisissez quels projets synchroniser :

    • Tous les projets ✅
    • Seulement des projets spécifiques ⚪

  2. Définissez le tarif par défaut :

    • Exemple : 60 €/heure
    • Vous pourrez le modifier par client ultérieurement

  3. Enregistrez

Importer les heures enregistrées​

Option 1 : Importation manuelle​

  1. Dans Frihet, allez dans Facturation → Importer depuis Toggl
  2. Choisissez la plage de dates :
    • "Ce mois-ci"
    • "Les 7 derniers jours"
    • "Dates personnalisées"
  3. Sélectionnez les projets à importer
  4. Cliquez sur "Importer"
  5. Des brouillons de facture sont créés (vous pouvez les consulter avant d'enregistrer)

Option 2 : Synchronisation automatique​

Si vous l'activez dans Paramètres :

  1. Chaque jour, Frihet importe automatiquement vos heures de Toggl
  2. Les regroupe par client
  3. Crée des brouillons de facture
  4. Vous les examinez et les confirmez

Exemple : Convertir les heures en facture​

Dans 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

Dans Frihet (après importation)​

Facture #1 - Client 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

Facture #2 - Juan García

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

Desglose:
- 6 feb: 2h Reunión

Tarifs personnalisés par client​

Par défaut, tous utilisent le tarif de 60 €/h. Vous pouvez modifier :

Option 1 : Modifier dans la facture​

  1. La facture est créée
  2. Avant de confirmer, vous modifiez le tarif manuellement
  3. Les heures sont recalculées automatiquement

Option 2 : Tarif fixe par client​

  1. Allez dans Clients → ouvrez un client
  2. Dans "Tarifa Toggl", entrez 80 €/heure
  3. La prochaine importation utilisera ce tarif pour ce client

Ventilation détaillée des tâches​

Si vous utilisez des descriptions de tâches dans Toggl, Frihet les inclut :

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

Dans Frihet, cela apparaît comme :

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

Vous pouvez modifier chaque ligne avant de confirmer.

Projets et clients​

Mappage automatique​

Frihet tente de mapper :

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

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

Mappage manuel​

Si vous souhaitez qu'un projet Toggl soit associé à un autre client :

  1. Allez dans Paramètres → Toggl → Mappage des projets
  2. Pour chaque projet, choisissez le client Frihet
  3. Enregistrez

Exemple :

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

Testez l'intégration​

Test d'importation​

  1. Dans Toggl, enregistrez une heure : "Tarea de prueba" (1 heure)
  2. Dans Frihet, allez dans Facturation → Importer depuis Toggl
  3. Choisissez "Les dernières 24 heures"
  4. Cliquez sur "Importer"
  5. Vous devriez voir un brouillon de facture

Si cela n'apparaît pas :

  • Vérifiez que Toggl est connecté ✅
  • Les heures doivent être enregistrées (pas des brouillons)
  • Attendez 24h après l'enregistrement dans Toggl

Importer les relevés de temps​

Frihet peut convertir automatiquement vos relevés de temps en lignes de facture :

  1. Connectez votre compte Toggl
  2. Allez à l'onglet Données de l'intégration
  3. Cliquez sur Importer les relevés de temps
  4. Entrez votre tarif horaire
  5. Frihet regroupe les entrées par projet et crée un brouillon de facture

Les entrées sont regroupées par projet, en additionnant les heures totales et en appliquant le tarif indiqué.

Ce que vous pouvez faire​

Regrouper par projet​

Vous importez un projet complet du mois :

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

Vous créez une facture unique : "Développement App iOS - Février 2025"

Facturer par sprint​

Si vous travaillez en sprints :

  1. Dans Toggl, chaque sprint dans un projet séparé
  2. Chaque mois, vous importez et créez une facture par sprint
  3. Ventilation claire pour le client

Tarifs par type de travail​

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

Vous pouvez mapper ces différents tarifs dans Frihet.

Synchronisation en temps réel​

Le travail que vous enregistrez dans Toggl aujourd'hui :

  • Sera disponible pour importation dans Frihet demain
  • Si vous activez la synchronisation automatique, il est importé automatiquement

Toggl envoie les données une fois par jour (normalement à 3h du matin UTC).

Modifier après l'importation​

Après avoir importé les heures :

  1. La facture est en état "Brouillon"
  2. Vous pouvez modifier :
    • Concept
    • Tarif horaire
    • Ajouter/supprimer des lignes
    • Changer de client
  3. Quand c'est bon, confirmez la facture

Les heures originales dans Toggl ne sont pas affectées — vous pouvez modifier la facture librement.

Supprimer une importation​

Si vous avez importé par erreur :

  1. Cherchez la facture dans Facturation → Factures
  2. Si elle est encore en "Brouillon", vous pouvez Supprimer
  3. Les heures dans Toggl restent là, sans changements

Si vous l'avez déjà confirmée comme facture, vous pouvez :

  • La marquer comme "Annulée"
  • Ou créer une note de crédit

Limites et restrictions​

  • Maximum 90 jours d'historique pour une importation
  • 10 importations simultanées (cela ne devrait pas vous affecter)
  • Pas de synchronisation des suppressions — Si vous supprimez une heure dans Toggl, la facture dans Frihet demeure

Dépannage​

"Je ne vois pas mes heures dans Toggl"​

  • Vérifiez qu'il est connecté ✅
  • Les heures doivent être enregistrées (pas des brouillons)
  • Attendez 24h après l'enregistrement dans Toggl

"Puis-je changer le tarif après la facturation ?"​

Oui. Modifiez la facture :

  1. Facturation → ouvrez la facture
  2. Changez le tarif horaire
  3. Il est recalculé automatiquement
  4. Enregistrez les modifications

"Que se passe-t-il si je change la clé API ?"​

Déconnectez et reconnectez :

  1. Paramètres → Intégrations → Toggl
  2. Déconnecter
  3. Entrez la nouvelle clé API
  4. Connecter

Les factures déjà créées restent identiques.

Prochaines étapes​

Précédent : Shopify