Die Installation des Billing Addon für die WHMCS Smart-NIC Suite erfolgt über den WHMCS Solutions Manager der ISP-Serverfarm. Der Solutions Manager kann im Kundenbereich heruntergeladen werden (https://kundencenter.isp-serverfarm.de/solutionsmanager.php).
Ganz nach dem Vorbild der WHMCS Update Funktion erfolgt die Installation, mit dem aktuellsten Release der Suite, einfach und unkompliziert mit einem Klick. Hierfür wird die Paketverwaltung Composer verwendet, welcher auch die aktivierten PHP Erweiterung bei der Installation direkt prüft.
Sollte nach der Installtion noch immer ein ausstehendes Update angezeigt werden, wurden hier scheinbar die erforderlichen PHP Erweiterungen nicht aktiviert.
Nach der Installation des Billing Addon wird in der WHMCS Addon Verwaltung unter "Setup -> Addon Modules" die WHMCS SmartNICSuite angezeigt. Kurz noch das Addon aktivieren und die Berechtigung vergeben.
Lizenz Aktivierung
Als nächstes muss der Lizenzkey der SmartNIC Suite in dem Addon hinterlegt werden. Erst damit wird das Produkt dann aktiviert.
Klicken Sie dazu auf den Menüpunkt "License" und fügen Sie den Licensekey aus der Bestellbestätigungsmail oder der Produktübersicht des Solutions Manager...
Wenn alles funktioniert hat, sollte es wie folgt aussehen. Der Menüpunkt hat nun auch eine Option für das Billing Addon mit aufgeführt.
Allgemeine Einstellungen
Als nächstes sind die Grundeinstellungen für das Billing Addon zu definieren. Dies ist über den Menüpunkt Settings möglich. Erst nach der erfolgreichen Aktivierung ist hier z.B. auch ein Tab für das Billing Addon zu sehen.
Als erstes wird in dem Tab "Allgemein" allgemeine Optionen definiert.
Wie z.B. der WHMCS Admin User mittels dem unser Addon mit der WHMCS Internal API kommuniziert.
Dann natürlich das Email Template, welches für den Versand der Reseller Domainabrechnung verwendet wird.
API Benutzername und Passwort nicht vergessen, dabei sollte man immer dran denken, bei einer Änderung des Passwort für das Domain Bestellsystem, dies auch hier nachzutragen.
Sollten Sie Ihre Reseller in einem Subaccount eingerichtet haben, können Sie hier den Loginname des Sub Reseller Account hinterlegen.
Zum Schluss müssen Sie hier noch einen Cronjob AuthCode definieren, dieser soll vor einem unbefugten Zugriff auf die Cronjobs schützen, da hier auch sensible Daten nach der Ausführung angezeigt werden.
Billing Addon Settings
Nun können wir die Billing Addon spezifischen Einstellungen über den Tab "Billing" vornehmen.
Im oberen Bereich werden die beiden Cronjob URLs angezeigt. Diese sollten wie beschrieben entsprechend häufig ausgeführt werden.
Die nächste Option "Block Description" definiert die Artikelposition in der Reseller Rechnung, wenn man Sich für die Block Option entscheidet.
Wenn Sie die Reseller Rechnung vor dem Versand prüfen wollen, können Sie mit der letzten Option im Billing Tab den automatischen Versand deaktivieren.
Domain Reseller Produkt erstellen
Damit Sie Domain Reseller abrechnen können, müssen Sie hier vorher ein neues Produkt anlegen. Ein Server muss im WHMCS hierfür nicht angelegt werden, da die Zugangsdaten bereits in den Addon Einstellungen hinterlegt sind.
In dem Tab "Module Settings" sind keine weiteren Einstellungen außer dem Module Name erforderlich.
Allerdings sind einige Custom Fields erforderlich:
Zum Schluss für die Produkterstellung können Sie nun noch eine Grundgebühr für den Domain Reseller definieren.
Customer Service erstellen
Nun können Sie die ersten Kunden mit dem neuen Domain Reseller Produkt verknüpfen. Wenn ein Sub Reseller im WHMCS nicht mit einem WHMCS Kunden über so ein Produkt verknüpft wurde, wird der Billing Cronjob auch keine Billing Items für diese Reseller einlesen. Dies wird in der Auswertung nach dem Cronjob auch entsprechend ausgegeben.
Um einen Sub Reseller aus dem Domain Bestellsystem mit einem WHMCS Kunden zu verknüpfen müssen Sie nur einen Service dafür anlegen. Wichtig dabei ist, dass der Benutzername des Sub Reseller aus dem Domain Bestellsystem identisch mit dem Benutzernamen des WHMCS Kunden ist. Das Passwort ist dabei nur zur Information an den Kunden.
Manuelle Ausführung der Cronjobs
Die Cronjobs können auch manuell über das SmartNIC Addon ausgeführt werden. Hier wird auch eine kleiner Zwischenstand angezeigt, welcher Reseller, wie viel Umsatz für diesen und letzten Monat gemacht hat.
Wichtig: Der Cronjob zum Einlesen der Billing Items importiert immer nur die Daten des aktuellen Monats. Daher sollte der Cronjob am Ende eines Monats immer nochmal 2-3 Minuten vor Mitternacht ausgeführt werden.
Sollte mal rückwirkend die Ausführung des Billing Item Import Cronjob für einen anderen Monat erforderlich sein, können Sie die Cronjob URL mit dem zusätzlichen Paramter "&month=2018-06" für Juni 2018 ausgeführt werden. Siehe folgendes Beispiel:
https://demo.isp-serverfarm.de/modules/servers/smartnicsuite_billing/cronjob.php?cronjob&autorized_cronjob=9rfu9tr4ddsu&month=2018-06
Mit genau dem gleichen Zusatzparameter können Sie dann mit der Cronjob URL zur Erstellung von Abrechnungen auch diese für einen vergangenen Monat im nachhinein erstellen.
Siehe Beispiel:
https://demo.isp-serverfarm.de/modules/servers/smartnicsuite_billing/cronjob.php?createinvoices&autorized_cronjob=9rfu9tr4ddsu&month=2018-05
Beachten Sie die MAX EXECUTION TIME für PHP ausreichend hoch definiert zu haben, wenn es sich hier um recht viele Billing Items bzw. Reseller handelt.
Der Cronjob für die Erstellung der Domain Abrechnung würde immer nur Billing Items vom letzten Monat zu Erstellung einer Abrechnung heranziehen. Eine Ausführung des Cronjob hat also überhaupt keine Auswirkung auf den aktuellen Monat. Die Erstellung von doppelten Abrechnung ist genau so wenig möglich.
Sollten Sie noch Fragen zur Einrichtung des Billing Addon haben, zögern Sie nicht und erstellen Sie direkt ein Ticket oder nutzen Sie den Livechat.
Björn Strausmann
Kommentare