🕑 TIMR Connector für Odoo 17

📄 Übersicht

Dieses Addon ermöglicht den Import aus TIMR (Zeiterfassungssystem) in Odoo. Zeitbuchungen aus TIMR werden automatisch in Odoo-Timesheets übertragen, Mitarbeiter, Projekte und Aufgaben werden intelligent zugeordnet.

✨ Hauptfunktionen

• Zeitbuchungen-Sync: Automatische Übertragung von TIMR ProjectTimes → Odoo Timesheets (account.analytic.line)
• Mitarbeiter-Zuordnung: TIMR Users → Odoo hr.employee mit Auto-Matching via E-Mail
• Projekt-Zuordnung: TIMR Top-Level Tasks → Odoo Projects mit Auto-Matching via SQ-Nummern (z.B. "P25-461")
• Aufgaben-Zuordnung: TIMR Subtasks → Odoo Project Tasks mit hierarchischem Bezug
• Geschätzte Stunden: TIMR hoursPlanned → Odoo allocated_hours ("Allocated Time") auf Tasks
• Intelligente Filterung: Nur zugeordnete Subtasks werden synchronisiert (Performance-Optimierung)
• Verschiebungs-Sync: In TIMR verschobene Zeitbuchungen werden in Odoo automatisch aktualisiert
• Lösch-Sync: In TIMR gelöschte Zeitbuchungen werden aus Odoo automatisch entfernt
• Common Task Support: Automatische Verarbeitung von Top-Level TIMR-Buchungen
• Detailliertes Logging: Alle Operationen werden protokolliert (TIMR Connector Logs)
• Automatische Synchronisation: Konfigurierbare Cron-Jobs für regelmäßigen Sync
• Schreibschutz: TIMR-synchronisierte Daten können nur in TIMR geändert werden

📦 Installation

1. Addon in den Odoo addons-Ordner kopieren
2. Python-Abhängigkeiten installieren: pip install zeep requests
3. Odoo neu starten oder Addon-Liste aktualisieren
4. In Odoo: Apps → Suche "TIMR Connector" → Installieren

⚙ Konfiguration

1. TIMR API Verbindung einrichten

Menü: Einstellungen → Allgemeine Einstellungen → TIMR Connector

2. Verbindung testen

1. Speichern Sie die Einstellungen
2. Klicken Sie auf den Button "Test Connection"
3. Bei Erfolg: ✔ Grüne Meldung "Connection Successful - Found X users"

👥 Workflow: Mitarbeiter-Zuordnung

1. TIMR Mitarbeiter laden: Menü "Personal → Konfiguration → TIMR Employee Mappings" → Button "Load from TIMR"
2. Automatische Zuordnung: System gleicht E-Mail-Adressen ab und erstellt automatische Zuordnungen
3. Manuelle Zuordnung: Für nicht automatisch zugeordnete Mitarbeiter manuell Odoo-Employee auswählen
4. Optional: Neue Odoo-Mitarbeiter erstellen via Aktion "Create Odoo Employees"

📁 Workflow: Projekt-Zuordnung

1. TIMR-Projekte laden: Menü "Projekt → Konfiguration → TIMR Project Mappings" → Button "Load from TIMR"
2. Automatische Zuordnung via SQ-Nummern: System extrahiert Nummern wie "P25-461" und sucht Verkaufsaufträge
3. Manuelle Zuordnung: Für nicht automatisch zugeordnete Projekte manuell Odoo-Projekt auswählen
4. Subtasks importieren: Automatisch oder manuell via "Load from TIMR" in TIMR Task Mappings

⏰ Workflow: Zeitbuchungs-Synchronisation

1. Voraussetzungen prüfen: Mitarbeiter und Projekte/Tasks müssen zugeordnet sein
2. Sync-Flag setzen: In TIMR Task Mappings relevante Subtasks mit "In Zeitbuchungs-Sync einbeziehen" markieren
3. Manueller Test: TIMR Connector Logs → Button "Zeitbuchungen synchronisieren"
4. Automatischen Sync aktivieren: In Einstellungen "Automatische Synchronisation" aktivieren und Intervall wählen

📊 Status-Übersicht

Status	Bedeutung	Aktionen
🔴 Nicht zugeordnet	Keine Odoo-Zuordnung vorhanden	Manuell zuordnen oder automatisch erstellen
🟢 Zugeordnet	Erfolgreich zugeordnet	Bereit für Synchronisation
⚫ Ignoriert	Bewusst ausgeklammert	Wird nicht synchronisiert
❌ Fehler	Sync-Fehler aufgetreten	Fehlerdetails im Feld prüfen

💡 Best Practices

🔧 Technische Details

• TIMR SOAP API: https://timrsync.timr.com/timr/timrsync.wsdl
• Authentifizierung: HTTP Basic Auth mit Company ID + API Token
• API-Methoden: GetUsers(), GetTasks(), GetTaskWithSubTasksByUUID(), GetProjectTimes()
• Performance: Client-seitige Filterung mit Hash-Tabellen (O(1) Lookup)
• Datenmodelle: timr.employee.mapping, timr.project.mapping, timr.task.mapping
• Duplikatserkennung: UUID-basiert mit SQL-Constraints
• Sync-Arten: Erstellen, Aktualisieren, Löschen, Verschieben
• Schreibschutz: write(), create(), unlink() overrides für TIMR-Daten
• Common Tasks: Automatische Verwaltung mit timr_is_common_task Flag

📚 Logging & Monitoring

Menü: Personal → TIMR Connector Logs

• Alle Sync-Operationen werden protokolliert
• Filter nach Log Level (Info, Warnung, Fehler)
• Detaillierte Fehler-Traces bei Problemen
• Performance-Metriken für Optimierung

🕑 Versions-Historie