Plugin XRechnung installieren (Inhouse)

Kurz erklärt

Das Plugin XRechnung erzeugt elektronische Rechnungen (XRechnung/ZUGFeRD) in Wice CRM 2020 ab release-9-6. Auf dem Server werden Java (SE) und Ghostscript ≥ 9 benötigt. Das Mustang-jar wird mit dem Plugin automatisch installiert.

Anwender-Einstieg und Faktura-Prozess: E-Rechnungen mit Wice CRM und Dokumententypen- und Faktura-Starter-Kit.

Voraussetzungen

Voraussetzung	Hinweis
Wice CRM 2020, release-9-6 oder höher	Inhouse-Installation
Java (SE) auf dem Server	`java -version`
Ghostscript ≥ 9	`gs -v`
Shell- und DB-Zugriff (mysql)	Nur bei manuellem Ghostscript-Build

Schritt 1: Java und Ghostscript prüfen

java -version
gs -v

Ghostscript muss Version 9 oder höher melden. Ist die Distribution älter, siehe Schritt 2 — sonst direkt zu Schritt 3.

Schritt 2: Ghostscript 9 manuell installieren (nur bei Bedarf)

Nur wenn die System-Ghostscript-Version kleiner als 9 ist. Parallel-Installation unter /usr/local/gs9 ist üblich — die Distribution-Version nicht deinstallieren.

wget http://downloads.ghostscript.com/public/ghostscript-9.18.tar.gz
tar xzf ghostscript-9.18.tar.gz
cd ghostscript-9.18
./configure --prefix=/usr/local/gs9
make
sudo make install
cp -r Resource iccprofiles /usr/local/gs9/share/ghostscript/9.18/

Pfad in der Wice-Datenbank eintragen:

echo "UPDATE mandant SET gs_path='/usr/local/gs9/bin/gs'" | mysql -u root -p wice

Hinweis: Aktuelle Download-URL und Version auf ghostscript.com prüfen.

Schritt 3: Plugin XRechnung installieren und aktivieren

Installieren Sie das Plugin XRechnung über die Wice-Administration.
Der Installer prüft Java und Ghostscript erneut.
Aktivieren Sie das Plugin für Ihren Mandanten.
Aufruf in Wice: Mehr → XRechnung (Administratoren; separate Usergruppen-Freigabe ist nicht nötig).

Schritt 4: iccprofiles-Pfad (falls nötig)

Beim ersten Aufruf ermittelt Wice den Pfad zu Ghostscript-iccprofiles automatisch. Schlägt das fehl:

find /usr -name iccprofiles

Gefundenen Pfad im Plugin eintragen. Angezeigte Ghostscript-Version und gs-Binary werden bei der Installation gesetzt — bei falscher Erkennung (< 9) Ghostscript-Installation prüfen und Plugin-Installation wiederholen.

Ergebnis prüfen

Mehr → XRechnung öffnet ohne Fehlermeldung.
Ghostscript-Version im Plugin zeigt ≥ 9.
Test-Rechnung als XRechnung/ZUGFeRD erzeugen (siehe E-Rechnungen mit Wice CRM).

Wenn etwas nicht funktioniert

Symptom	Häufige Ursache	Lösung
Plugin-Installation bricht ab	Java oder gs fehlt / zu alt	Schritt 1–2, dann Installation wiederholen
Kein iccprofiles-Pfad	Automatische Erkennung fehlgeschlagen	`find /usr -name iccprofiles`, Pfad manuell setzen
Falsche gs-Version im Plugin	Falscher `gs_path` in DB	`gs_path` in Mandantentabelle korrigieren
XRechnung in Wice nicht sichtbar	Plugin nicht mandantenaktiv	Administration → Plugin für Mandant aktivieren

Server-Logs: Wice-Log-Datei.