Als Windows-Dienst einrichten

Schritt-für-Schritt-Anleitung zum Betrieb von Automatic ZUGFeRD Generator als Windows-Dienst im Hintergrund

Diese Anleitung zeigt, wie Sie Automatic ZUGFeRD Generator als Windows-Dienst einrichten, der dauerhaft im Hintergrund läuft - ohne dass ein Benutzer angemeldet sein oder das Programmfenster geöffnet sein muss. Das ist die richtige Betriebsart für Server und für Rechner, die rund um die Uhr Rechnungen umwandeln sollen.

Der Dienst nutzt das Programm AZGProcessor.exe, das bei der Installation neben dem normalen Programm liegt. Das Hauptfenster starten Sie danach nur noch gelegentlich, um Profile zu pflegen, Rechnungen der Einlernphase zu bestätigen oder das Protokoll zu prüfen.

Auf einen Blick

  • Schwierigkeit: Fortgeschritten (Administrator-Rechte erforderlich)
  • Zeitbedarf: ca. 10 Minuten
  • Voraussetzungen: Installiertes und eingerichtetes Programm (siehe Anleitung: Erste Schritte), ein Windows-Benutzerkonto für den Dienst, Administrator-Rechte zum Bestätigen der Dienst-Einrichtung
  • Ergebnis: Automatic ZUGFeRD Generator erzeugt E-Rechnungen dauerhaft im Hintergrund, auch ohne angemeldeten Benutzer

Schritt 1: Ein Benutzerkonto für den Dienst wählen

Legen Sie für den Dienst ein eigenes Windows-Benutzerkonto an (oder verwenden Sie ein vorhandenes Benutzer- bzw. Domänenkonto), z. B. AZG-Service, mit einem Kennwort, das nicht abläuft.

Profile, Optionen und Lizenz liegen im Anwendungsdatenordner des Benutzers, der den Dienst einrichtet (C:\Users\<Benutzername>\AppData\Roaming\Automatic ZUGFeRD Generator 1); die Einrichtung trägt diesen Ordner fest in den Dienst ein und gibt dem Dienstkonto Änderungsrecht darauf - der Dienst sieht die Daten also unabhängig von seinem Konto. Das Konto braucht aber Zugriff auf die Eingangs- und Ausgabeordner aller Profile. Liegen diese auf Netzwerkfreigaben, verwenden Sie in den Profilen den Netzwerkpfad (\\Server\Freigabe\...) und geben Sie dem Dienstkonto Schreibrechte darauf; ein Dienst kennt keine Laufwerksbuchstaben, die ein Benutzer verbunden hat. "Lokales System" funktioniert für lokale Ordner, kommt aber nicht an Netzwerkfreigaben.

Versand über Exchange Online (Microsoft 365): Die Anmeldung bei Microsoft gilt nur für das Windows-Konto, unter dem sie erfolgt ist. Verwenden Sie in diesem Fall als Dienstkonto Ihr eigenes Windows-Konto - oder melden Sie sich einmal mit dem Dienstkonto an Windows an, starten Sie das Programm und wiederholen Sie dort unter Optionen → E-Mail-Versand die Anmeldung mit derselben E-Mail-Adresse. Die Seite E-Mail-Versand weist darauf hin, wenn der Dienst unter einem anderen Konto läuft (siehe Programmhilfe, Kapitel 40.4.3). Für den Versand über SMTP gilt das nicht.


Schritt 2: Dienst einrichten

Starten Sie das Programm und öffnen Sie Optionen → Windows-Dienst. Hier liegen die Betriebsart, der Live-Status des Dienstes und alle Verwaltungs-Aktionen beieinander.

Programmoptionen, Seite Windows-Dienst

Klicken Sie auf Dienst einrichten... und tragen Sie ein:

  • Dienstname: frei wählbar, vorgeschlagen ist AZGService.
  • Windows-Benutzerkonto: das Konto aus Schritt 1, z. B. .\AZG-Service. Bei einem Domänenkonto schreiben Sie Domäne\Kontoname.
  • Kennwort dieses Kontos.

Nach einer einzigen Administrator-Bestätigung erledigt das Programm alles Weitere: Es legt den Dienst mit dem richtigen Programmpfad an, setzt den automatischen Start (verzögert, damit das Netzwerk beim Hochfahren bereit ist) und die Wiederherstellung nach einem Absturz (drei Neustartversuche im Minutenabstand), vergibt dem Dienstkonto das Windows-Recht "Als Dienst anmelden" und startet den Dienst.

Das Kennwort wandert dabei nicht über die Befehlszeile, sondern über eine kurzlebige, verschlüsselte Datei, die sofort wieder gelöscht wird. Sind Sie selbst kein Administrator, bestätigt ein Administrator die Windows-Abfrage mit seinem eigenen Konto.

Alternative: Einrichtung per Eingabeaufforderung

Wenn Sie den Dienst lieber selbst anlegen (z. B. per Skript auf mehreren Rechnern), öffnen Sie eine Eingabeaufforderung als Administrator. Passen Sie den Installationsordner an (Standard C:\Program Files\Automatic ZUGFeRD Generator):

sc.exe create "AZGService" binPath= "\"C:\Program Files\Automatic ZUGFeRD Generator\AZGProcessor.exe\" --service"
sc.exe config "AZGService" obj= ".\AZG-Service" password= "IhrKennwort"

Wichtig: Nach binPath=, obj= und password= steht jeweils ein Leerzeichen - das verlangt sc.exe so. binPath= muss auf die AZGProcessor.exe zeigen, nicht auf AutomaticZugferdGenerator.exe - mit der Programmoberfläche als Dienst bliebe der Start hängen. Die Seite Windows-Dienst erkennt diesen Fehler und stellt ihn über Korrigieren richtig. Den automatischen Start und die Wiederherstellung setzt Dienst starten auf der Seite mit.


Schritt 3: Option "Externer Prozessor" aktivieren

Damit sich das Hauptfenster und der Dienst nicht gegenseitig stören, aktivieren Sie auf derselben Seite unter Betriebsart das Häkchen bei "Hintergrundprozessor wird extern verwaltet (z. B. als Windows-Dienst)" und schließen Sie den Dialog mit OK.

Was diese Option bewirkt: Das Hauptfenster startet und beendet keinen eigenen Verarbeitungsprozess mehr; es dient nur noch zur Konfiguration, zum Bestätigen der Einlernphase und zur Anzeige des Protokolls. Ohne die Option hielte sich das Fenster zwar zurück, solange der Dienst Lebenszeichen sendet - es würde aber selbst verarbeiten, sobald der Dienst angehalten ist.


Schritt 4: Dienst prüfen

Die Ampel auf der Seite Optionen → Windows-Dienst steht auf grün, wenn der Dienst läuft und verarbeitet; darunter stehen Dienstname, Status samt Starttyp, Konto, Programmpfad und das letzte Lebenszeichen. Steht sie auf Orange oder Rot, benennt die Seite den Grund und bietet die passende Aktion an.

Zusätzlich können Sie gegenprüfen:

  1. In der Windows-Diensteverwaltung (services.msc) hat "AZGService" den Status "Wird ausgeführt" und den Starttyp "Automatisch (Verzögerter Start)".
  2. Bei Problemen hilft die Datei ServiceDiagnostics.log - auf der Seite Windows-Dienst über Öffnen erreichbar; sie liegt im Ordner Status des Datenordners und enthält die Startmeldungen (IsWindowsService=True) und die Verarbeitungsmeldungen des Dienstes.

Die regulären Verarbeitungsprotokolle erscheinen wie gewohnt im Hauptfenster.


Schritt 5: Laufender Betrieb

Ab jetzt verarbeitet der Dienst dauerhaft im Hintergrund. Rechnungen der Einlernphase warten weiterhin im Prüfordner, bis Sie sie im Hauptfenster bestätigen. Nach einem Programm-Update bleibt der Dienst bestehen - das Setup hält ihn kurz an und startet ihn danach wieder; bei der Deinstallation wird er automatisch entfernt. Möchten Sie ihn selbst anhalten oder entfernen, nutzen Sie Dienst anhalten bzw. Dienst entfernen... auf der Seite Windows-Dienst.


Häufige Probleme

Problem Lösung
Häkchen "Externer Prozessor" ist gesetzt, aber es wird nichts verarbeitet Die Seite Optionen → Windows-Dienst zeigt den Zustand rot und benennt die Ursache: kein Dienst, Dienst gestoppt oder falsch eingerichtet. Die passende Schaltfläche behebt es mit einer Administrator-Bestätigung.
Dienststart hängt oder bricht mit Fehler 1053 ab Meist zeigt binPath= auf die falsche Programmdatei. Korrigieren stellt den Pfad um und startet den Dienst.
Dienststart scheitert mit Anmeldefehler 1069 Windows konnte das Dienstkonto nicht anmelden (Kennwort geändert, Konto gesperrt, Recht "Als Dienst anmelden" fehlt). Klicken Sie auf Dienst starten: Das Programm bietet an, das Kennwort neu einzugeben, vergibt das Recht neu und startet den Dienst.
Dienst läuft, aber Rechnungen auf einem Netzlaufwerk werden nicht gefunden Der Dienst kennt keine Laufwerksbuchstaben. Tragen Sie in den Profilen den Netzwerkpfad (\\Server\Freigabe\...) ein und geben Sie dem Dienstkonto Rechte darauf (Schritt 1).
Statusleiste zeigt "Verarbeitung angehalten - Registrierung erforderlich" Der Testzeitraum ist abgelaufen oder die Lizenz ungültig. Registrieren Sie das Programm im Hauptfenster (Hauptmenü → Lizenzschlüssel eingeben...); der Dienst verarbeitet innerhalb einer Minute weiter.
Statusleiste zeigt "Verarbeitung durch den Windows-Dienst", obwohl die Option aus ist Der Dienst läuft, die Option "Externer Prozessor" ist nicht gesetzt (Schritt 3). Doppelt verarbeitet wird nichts; setzen Sie das Häkchen trotzdem.

Weiterführende Themen

Automatic ZUGFeRD Generator jetzt unverbindlich 30 Tage testen ...     Zum Download