TimeTrackr Integration

1. Quoi ? — Definition et contexte

TimeTrackr est une application desktop de suivi de temps. Quand vous demarrez un timer sur un projet et l’arretez, l’entree de temps doit atterrir dans Odoo comme timesheet. Deux webhooks N8N font le pont : l’un fournit la liste des projets et taches pour les menus deroulants du client, l’autre recoit les entrees de temps et les convertit en lignes analytiques Odoo.

Timesheet Odoo

Un timesheet dans Odoo (account.analytic.line) est une ligne de temps passee sur un projet. Il lie un employe, un projet, une tache, une duree et une description. C’est la base de la facturation et du reporting.

Deux workflows

Workflow	Nodes	Endpoint	Role
TimeTrackr Projects	5	GET /webhook/timetrackr-projects	Liste projets + taches pour dropdown
TimeTrackr Entries	12	POST /webhook/timetrackr-entries	Creation timesheets Odoo

Flux de donnees

---

2. Pourquoi ? — Enjeux et motivations

Problemes resolus

Probleme	Sans integration	Avec integration
Double saisie	Timer + saisie manuelle Odoo	Automatique
Projets desynchronises	Listes differentes dans chaque app	Dropdown alimente par Odoo
Erreurs d’attribution	Mauvais projet ou mauvaise tache	Mapping par ID

---

3. Comment ? — Mise en oeuvre technique

Authentification

Les deux endpoints utilisent un token dans le header HTTP :

Header	Usage
X-TimeTrackr-Token	Token partage entre le client desktop et N8N

Les webhooks sont exposes via Caddy (acces externe autorise, contrairement aux webhooks internes).

Endpoint Projects

Le workflow recupere les projets Odoo ou x_github_sync_enabled = true, puis les taches actives (hors Done/Cancelled) groupees par projet. La reponse est un JSON exploitable directement par les menus deroulants du client.

Endpoint Entries

Le payload arrive sous forme de batch :

{
  "version": 1,
  "entries": [
    {
      "project_id": 5,
      "task_id": 42,
      "description": "Fix login bug",
      "duration": 1.5,
      "date": "2026-03-28",
      "username": "guillaume"
    }
  ]
}

Pour chaque entree, le workflow :

1. Cherche l’employee ID dans la Data Table timetrackr_user_mapping (guillaume → employee 1)
2. Cree une ligne account.analytic.line dans Odoo
3. Continue meme en cas d’erreur sur une entree (continueOnFail)

Mapping utilisateur

Le mapping username → employee_id est stocke dans la Data Table timetrackr_user_mapping. Si un utilisateur n’est pas mappe, l’entree echoue silencieusement (logguee mais pas creee).

---

4. Et si ? — Perspectives et limites

Limites actuelles

Limite	Impact	Mitigation
Pas de sync inverse	Timesheets Odoo pas visibles dans TimeTrackr	TimeTrackr a sa propre vue
Mapping manuel	Ajouter chaque utilisateur a la Data Table	Un seul utilisateur actuellement

Scenarios d’evolution

Si multi-utilisateurs :

• Auto-decouverte des employes Odoo
• Mapping par email plutot que par username

---

Pages liees

Infrastructure

• Odoo 18 sur Docker — Timesheets et projets

Workflows

• Claude Code Telemetry — Autre source de timesheets automatiques