n8n-tanss-api-fullv1

Vollständige n8n Community Node Integration für die TANSS API mit deutscher Benutzeroberfläche.

🚀 Features

Unterstützte Module

• 🎫 Tickets - Vollständige Ticket-Verwaltung (CRUD, Kommentare, Verlauf)
• 🏢 Unternehmen - Unternehmensverwaltung und Mitarbeiter-Zuordnung
• 👥 Mitarbeiter - Mitarbeiterverwaltung, Techniker-Listen, Verfügbarkeit
• 💻 Geräte - PC/Server, Peripherie, Komponenten, Services
• 📄 Verträge - Angebote und Verträge verwalten
• 🌐 Domains - Domain-Management und DNS-Verwaltung
• 🛠️ Support - Support-Einträge, Termine, Zeiterfassung, Signaturen
• 🔐 Authentifizierung - Bearer Token und Benutzername/Passwort

Benutzerfreundlichkeit

• Deutsche Benutzeroberfläche - Alle Texte und Beschreibungen auf Deutsch
• Modulare Architektur - Separate Nodes für verschiedene Funktionsbereiche
• Intelligente Formulare - Dynamische Felder basierend auf gewählter Operation
• Umfassende Validierung - Eingabevalidierung und aussagekräftige Fehlermeldungen

📦 Installation

npm install n8n-tanss-api-fullv1

🔧 Konfiguration

Anmeldedaten einrichten

1. Gehen Sie zu Credentials → Create New
2. Wählen Sie TANSS API
3. Konfigurieren Sie:
   • Basis-URL: Ihre TANSS-Instanz (z.B. https://demo.tanss.de)
   • Authentifizierung: Wählen Sie zwischen:
     • Benutzername & Passwort
     • Bearer Token (empfohlen für API-Zugriff)

Bearer Token erhalten

curl -X POST "https://ihre-tanss-url.com/backend/api/v1/authentication" \
  -H "Content-Type: application/json" \
  -d '{"username": "ihr-username", "password": "ihr-passwort"}'

🎯 Verwendung

Tickets verwalten

• Ticket erstellen: Neue Support-Tickets anlegen
• Ticket abrufen: Ticket-Details nach ID laden
• Kommentare hinzufügen: Kommunikation dokumentieren
• Status aktualisieren: Ticket-Workflow verwalten

Unternehmen verwalten

• Unternehmen anlegen: Neue Kunden erfassen
• Mitarbeiter zuordnen: Ansprechpartner verwalten
• Kontaktdaten pflegen: Vollständige Adressverwaltung

Geräte-Inventar

• Hardware erfassen: PCs, Server, Peripherie
• Komponenten verwalten: Detaillierte Hardware-Informationen
• Services dokumentieren: Software und Dienste zuordnen

🔗 API-Endpunkte

Basierend auf der TANSS API v10.7.0 mit vollständiger Endpoint-Abdeckung:

Tickets

• GET/POST/PUT/DELETE /api/v1/tickets
• POST /api/v1/tickets/{id}/comments
• GET /api/v1/tickets/{id}/history

Unternehmen

• GET/POST/PUT/DELETE /api/v1/companies
• GET /api/v1/companies/{id}/employees

Mitarbeiter

• GET/POST/PUT /api/v1/employees
• GET /api/v1/employees/technicians
• GET /api/v1/availability/{id}

Geräte

• GET/POST/PUT/DELETE /api/v1/pcs
• GET/POST/PUT/DELETE /api/v1/periphery
• GET/POST/PUT/DELETE /api/v1/components

Verträge & Domains

• GET/POST/PUT /api/v1/offer
• GET/POST/PUT/DELETE /api/v1/contracts
• GET/POST/PUT/DELETE /api/v1/domains

Support & Termine

• PUT /api/v1/supports/list
• GET/POST/PUT /api/v1/supports
• POST /api/v1/supports/signature/{id}

🛠️ Entwicklung

# Dependencies installieren
pnpm install

# Build erstellen
pnpm run build

# Linting
pnpm run lint

# Tests ausführen
pnpm test

📋 Anforderungen

• n8n Version: ≥ 1.0.0
• Node.js: ≥ 18.0.0
• TANSS API: ≥ 10.0.0

🤝 Beitragen

1. Fork des Repositories
2. Feature-Branch erstellen (git checkout -b feature/neue-funktion)
3. Änderungen committen (git commit -am 'Neue Funktion hinzugefügt')
4. Branch pushen (git push origin feature/neue-funktion)
5. Pull Request erstellen

📄 Lizenz

MIT License - siehe LICENSE.md

🔗 Links

• TANSS API Dokumentation
• n8n Community Nodes
• GitHub Repository

Entwickelt mit ❤️ für die n8n Community