Znuny WarrantySync Add-on - Automatische Garantieabfrage für CMDB-Assets

Das Problem: Garantiedaten manuell pflegen

Kennen Sie das? 200 Laptops, Server und Workstations in der CMDB - und bei keinem wissen Sie, ob die Garantie noch läuft. Die Seriennummer steht im Asset, aber den Garantiestatus müssen Sie manuell auf der Hersteller-Website nachschlagen. Stück für Stück.

In vielen Unternehmen führt das zu:

• Veralteten Garantiedaten - Niemand pflegt die Felder manuell
• Verpassten Verlängerungen - Garantie läuft aus, ohne dass es jemand merkt
• Zeitaufwändiger Recherche - Jede Seriennummer einzeln auf der Hersteller-Website prüfen
• Fehlender Übersicht - Welche Geräte sind noch abgesichert, welche nicht?
• Unvollständigen Informationen - Nur Enddatum bekannt, aber nicht Typ oder Service-Level

Die Lösung: Automatische Garantiesynchronisation

Das WarrantySync Add-on für Znuny 7.2.x ruft die Garantieinformationen automatisch von den Hersteller-APIs ab und speichert sie direkt in der CMDB. Einmal konfiguriert, läuft es als täglicher Cron-Job - ohne manuellen Aufwand.

Unterstützte Hersteller

Was wird gespeichert?

Das Add-on ruft folgende Daten ab und schreibt sie in konfigurierbare Klassenattribute:

Konfigurierbares Feld-Mapping

Jede Znuny-Installation hat eine eigene CMDB-Struktur. Das Add-on zwingt Ihnen keine Feldnamen auf - stattdessen konfigurieren Sie in der SysConfig, welches API-Ergebnis in welches Klassenattribut geschrieben wird.

Standard-ITSM-Klasse "Computer" hat bereits das Feld WarrantyExpirationDate - das funktioniert direkt ohne Anpassung. Für zusätzliche Felder erweitern Sie einfach Ihre Klassendefinition.

Intelligentes Recheck-Verhalten

• Neue Assets werden sofort beim nächsten Sync geprüft
• Aktive Garantien werden alle 30 Tage erneut geprüft (konfigurierbar)
• Abgelaufene Garantien haben ein eigenes Intervall (konfigurierbar)
• Keine unnötigen CMDB-Versionen - Eine neue Version wird nur erzeugt wenn sich tatsächlich Daten ändern

Automatische Ablauf-Benachrichtigung

Optional erstellt das Add-on automatisch ein Ticket wenn eine Garantie bald abläuft:

• Konfigurierbarer Vorlauf - z.B. 90 Tage vor Ablauf (Standard, anpassbar)
• Ticket-Einstellungen - Queue, Typ, Priorität und Status frei wählbar (Dropdown aus Systemwerten)
• Anpassbare Vorlagen - Betreff und Text mit Platzhaltern wie <ASSET_NAME>, <SERIAL>, <WARRANTY_END>
• Filter (optional) - Nur für bestimmte Assets (z.B. nur Server, nicht Desktops)
• Duplikat-Schutz - Nur ein Ticket pro Asset pro Garantie-Enddatum. Wird die Garantie verlängert, gibt es ein neues Ticket
• ConfigItem-Verknüpfung - Ticket wird automatisch mit dem Asset verlinkt

Das Feature ist standardmäßig deaktiviert und lässt sich komplett über die SysConfig konfigurieren.

Robuste API-Anbindung

• Dell: Batch-Abfragen mit bis zu 100 Seriennummern pro Request
• Lenovo: Einzelabfragen, automatisch für alle Assets
• Retry-Logik: Bei Rate Limiting oder Serverfehlern wird mit exponentiellem Backoff wiederholt
• Konfigurierbar: Maximale Wiederholungsversuche in SysConfig einstellbar

Anwendungsbeispiel

Sie haben 150 Dell-Laptops und 50 Lenovo-ThinkPads in der CMDB. Nach der Installation:

1. Dell API-Zugangsdaten in SysConfig eintragen (kostenlos über techdirect.dell.com)
2. Lenovo Provider aktivieren (kein API-Key nötig)
3. Vendor-Mapping prüfen (muss zu Ihren CMDB-Herstellernamen passen)
4. Ersten Sync ausführen: bin/znuny.Console.pl Maint::WarrantySync::Run --force

Ergebnis: Alle 200 Assets haben innerhalb weniger Minuten vollständige Garantiedaten.

Ab jetzt prüft der tägliche Cron-Job automatisch, ob sich etwas geändert hat.

Installation

Die Installation erfolgt wie bei jedem Znuny-Paket:

Option A: Paket-Repository (empfohlen)

1. Admin → Systemkonfiguration → Package::RepositoryList
2. Repository hinzufügen: Name wolkig.it, URL https://wolkig.it/packages
3. Admin → Paketverwaltung → "WarrantySync" installieren

Option B: Manuell

1. OPM-Paket herunterladen
2. Admin → Paketverwaltung → Paket installieren

Nach der Installation:

1. Feature aktivieren: Admin → SysConfig → WarrantySync::Enabled
2. API-Zugangsdaten konfigurieren (Dell: ClientID + Secret, Lenovo: einfach aktivieren)
3. Vendor-Mapping an Ihre CMDB-Herstellernamen anpassen
4. Manuellen Sync ausführen: bin/znuny.Console.pl Maint::WarrantySync::Run --force

Voraussetzungen

• Znuny 7.2.x
• ITSM ConfigurationManagement (für CMDB-Integration)
• Internetzugang zu den Hersteller-APIs

Open Source

Das WarrantySync Add-on ist Open Source unter der GPL v3 Lizenz:

• Kostenlos nutzbar
• Quellcode einsehbar
• Anpassungen erlaubt
• Community-Beiträge willkommen
• Neue Provider (Hersteller) können einfach ergänzt werden

Repository: codeberg.org/wolkig-it/znuny_warranty_sync

Fazit

Mit dem WarrantySync Add-on gehören manuell gepflegte Garantiedaten der Vergangenheit an. Dell und Lenovo Garantieinformationen werden automatisch abgerufen und in Ihrer CMDB gespeichert - und wenn eine Garantie abläuft, werden Sie rechtzeitig per Ticket informiert.

Vorteile auf einen Blick:

• Automatischer täglicher Sync (kein manueller Aufwand)
• Dell + Lenovo Support (weitere Hersteller erweiterbar)
• Konfigurierbares Feld-Mapping (passt sich Ihrer CMDB an)
• Ablauf-Benachrichtigung per Ticket (konfigurierbar, mit Filter)
• Intelligentes Recheck-Verhalten (spart API-Calls)
• Retry-Logik bei API-Fehlern
• Saubere Versionshistorie (nur echte Änderungen)
• Kostenlos und Open Source

Probieren Sie es aus!

Download und Dokumentation: codeberg.org/wolkig-it/znuny_warranty_sync