n8n Integration für Arbeitszeit-Tracker

Diese Dokumentation beschreibt, wie Sie den Arbeitszeit-Tracker in n8n integrieren können.

---

Custom Node Installation

Option 1: Lokale Installation (Entwicklung)

1. In das n8n-node Verzeichnis wechseln:

cd n8n-node

2. Dependencies installieren:

npm install

3. Node bauen:

npm run build

4. Node global linken:

npm link

5. In n8n die Node linken:

cd ~/.n8n
npm link n8n-nodes-arbeitszeit-tracker

6. n8n neu starten

Option 2: npm Installation (Produktion)

Wenn das Paket auf npm veröffentlicht wurde:

cd ~/.n8n
npm install n8n-nodes-arbeitszeit-tracker

Credentials einrichten

Nach der Installation:

1. In n8n auf "Credentials" klicken
2. "New Credential" -> "Arbeitszeit-Tracker API" wählen
3. API URL eingeben: https://aze.zurdai.com
4. API Key eingeben: aze-export-2024-secret

Node verwenden

Die Node bietet folgende Operationen:

• PDF Export: Erstellt den PDF-Rapport für ein bestimmtes Datum (oder heute)
• Statistiken: Ruft die aktuellen Arbeitszeit-Statistiken ab
• Zeiterfassung Starten: Startet eine neue Zeiterfassung
• Zeiterfassung Stoppen: Stoppt die aktuelle Zeiterfassung

---

API-Endpunkte

Base URL: https://aze.zurdai.com/

Authentifizierung

Alle Anfragen benötigen einen API-Key:

• Als Query-Parameter: ?api_key=aze-export-2024-secret
• Oder als Header: X-API-Key: aze-export-2024-secret

---

Verfügbare Aktionen

1. PDF Export (Tagesrapport)

URL: https://aze.zurdai.com/?action=export_pdf&api_key=aze-export-2024-secret

Parameter:

• action: export_pdf (required)
• api_key: API-Schlüssel (required)
• date: Datum im Format YYYY-MM-DD (optional, Standard: heute)

Beispiel für heute:

https://aze.zurdai.com/?action=export_pdf&api_key=aze-export-2024-secret

Beispiel für bestimmtes Datum:

https://aze.zurdai.com/?action=export_pdf&api_key=aze-export-2024-secret&date=2025-11-25

---

2. Statistiken (JSON)

URL: https://aze.zurdai.com/?action=stats&api_key=aze-export-2024-secret

Antwort:

{
  "datum": "2025-11-25",
  "heute_stunden": "04:34:48",
  "heute_stunden_dezimal": 4.58,
  "gesamt_stunden": "54:22:11",
  "gesamt_stunden_dezimal": 54.37,
  "ueberstunden": "01:43:48",
  "ueberstunden_dezimal": 1.73,
  "ueberzeit": "00:00:00",
  "ueberzeit_dezimal": 0.0
}

---

n8n Workflow Beispiele

Workflow 1: Täglicher PDF-Export per E-Mail

Importieren Sie die Datei workflow-daily-pdf-export.json in n8n.

Ablauf:

1. Schedule Trigger: Täglich um 18:00 Uhr
2. HTTP Request: PDF generieren
3. Send Email: PDF als Anhang versenden

Workflow 2: Statistiken abrufen

Importieren Sie die Datei workflow-stats.json in n8n.

---

API-Key ändern

Setzen Sie die Umgebungsvariable auf Ihrem Server:

export PDF_API_KEY=ihr-sicherer-schluessel

Oder in Docker:

environment:
  - PDF_API_KEY=ihr-sicherer-schluessel