Aktuelles & Updates von
Joomla, Wordpress und Co.
News, HowTos und Tutorials rund um Webdesign, Webentwicklung, Webhosting und Digitalisierung.
modified eCommerce automaitsche PDF Rechnung
modified eCommerce automaitsche PDF Rechnung für einen festgelegten Zeitraum
Wer einen Shop mit modified eCommerce betreibt, kennt den Ablauf: In der Bestellverwaltung auf „Rechnungsnummer erzeugen" klicken, danach auf „Rechnung", und der Browser zeigt die Rechnung zum Drucken. Für eine Bestellung geht das schnell. Will die Buchhaltung oder der Steuerberater am Monatsende alle Rechnungen als PDF haben, wird daraus Handarbeit: Bestellung öffnen, drucken, speichern, nächste Bestellung.
Für einen Kunden mit einem solchen Shop haben wir dafür eine Admin-Seite gebaut. Dieser Beitrag beschreibt, was sie kann, und vor allem, an welchen Stellen man bei automatisch erzeugten Rechnungen aufpassen muss.
Was modified von Haus aus mitbringt
modified 3.x hat ein Modul für Rechnungsnummern. Es führt einen Zähler und ein einstellbares Format, zum Beispiel nur die laufende Nummer oder die Nummer mit Datum. Die Rechnung selbst entsteht in der Datei print_order.php aus einem Smarty-Template als HTML-Seite. Einen PDF-Export für viele Bestellungen auf einmal gibt es nicht.
So sieht die Lösung aus
Im Admin erscheint unter „Hilfsprogramme" der Punkt „Rechnungen (PDF)". Dort läuft es so ab:
- Man wählt einen Zeitraum von/bis. Berücksichtigt werden Bestellungen im Status „Versendet", deren Kaufdatum im Zeitraum liegt.
- Die Vorschau listet jede betroffene Bestellung auf und nennt die Rechnungsnummer, die vergeben würde. Sie schreibt nichts.
- „Rechnungen erzeugen" legt die PDFs unter
invoices/Jahr/Monat/im Shop-Verzeichnis ab. Vorhandene PDFs werden nicht überschrieben. - Der Ordner ist für den Webzugriff gesperrt. Heruntergeladen werden die PDFs über die Admin-Seite, die eine Anmeldung verlangt.
Oben auf der Seite steht der aktuelle Stand: die nächste Rechnungsnummer, die zuletzt vergebene Nummer und wie viele versendete Bestellungen noch keine Nummer haben, aufgeschlüsselt nach Monaten. Die Seite warnt auch, wenn der Zähler nicht über der zuletzt vergebenen Nummer liegt, denn dann drohen doppelte Nummern.
Das PDF nutzt dasselbe Template wie die bisherige Rechnung. Logo, Adressblock und Positionen sehen aus wie das, was der Kunde bisher ausgedruckt hat.
Der heikle Teil: Rechnungsnummer und Datum
Technisch ist das PDF der einfache Teil. Schwierig sind die Rechnungsnummern. Eine Rechnung braucht nach § 14 Abs. 4 UStG unter anderem eine fortlaufende, einmalig vergebene Rechnungsnummer und den Zeitpunkt der Lieferung oder Leistung. Das ist keine Steuerberatung, erklärt aber, warum wir an dieser Stelle vorsichtig sind.
Das Standard-Template von modified füllt Rechnungsdatum und Leistungsdatum aus demselben Feld, nämlich dem Tag, an dem die Rechnungsnummer erzeugt wurde. Wer Nummern bisher nur bei Bedarf erzeugt hat, hat deshalb viele versendete Bestellungen ohne Nummer. In der Kopie der Daten unseres Kunden waren es über 4.000, verteilt über 40 Monate. Würde man dafür heute Nummern erzeugen, stünde auf jeder Rechnung das heutige Datum als Leistungsdatum, auch bei einer Bestellung von vor zwei Jahren.
Deshalb lässt sich bei der Vergabe das Datum wählen:
- Versanddatum: das Datum des ersten Eintrags „Versendet" in der Status-Historie der Bestellung. Das ist die Voreinstellung. Fehlt der Eintrag, nimmt die Seite das Kaufdatum und meldet das in der Vorschau.
- Kaufdatum der Bestellung.
- Heute, wie beim Button im Shop.
Die Nummern werden in der Reihenfolge des gewählten Datums vergeben, die zuerst versendete Bestellung bekommt also die niedrigste Nummer. Die Auswahl gilt nur für neu vergebene Nummern. Bestehende Nummern und Daten bleiben, wie sie sind.
Ein Rest bleibt: Wer rückwirkend nummeriert, vergibt Nummern mit einem früheren Datum als bereits vergebene Nummern. In unserem Testdatensatz trug die letzte vorhandene Nummer ein Datum im November, während die nächsten Nummern an Rechnungen aus dem Oktober gingen. Ob das für den eigenen Betrieb in Ordnung ist, sollte der Steuerberater entscheiden, bevor man in die Vergangenheit nummeriert.
Wie es technisch funktioniert
Die Erzeugung läuft als PHP-Skript auf der Kommandozeile, die Admin-Seite startet es. Die PDFs erstellt die Bibliothek Dompdf aus dem HTML der bisherigen Rechnung. Die Seite ist an ein eigenes Admin-Recht gebunden, das beim ersten Aufruf angelegt wird. Aktionen schützt sie zusätzlich mit einem eigenen Token, weil das Token-System des Shops abgeschaltet sein kann. Das Skript lässt sich auch ohne Oberfläche per Cron starten, dann mit festem Startdatum.
In einem Testlauf mit fünf Bestellungen dauerte die Erzeugung drei Sekunden. Pro Klick entstehen höchstens 200 PDFs, damit der Webserver nicht in ein Zeitlimit läuft. Ein weiterer Klick setzt dort fort, wo der letzte aufgehört hat.
Voraussetzungen und Stolpersteine
- modified 3.x mit aktivem Modul „Rechnungsnummer" und einem Bestellstatus „Versendet".
- PHP auf der Kommandozeile ab Version 7.4, und die PHP-Funktion
exec()darf nicht gesperrt sein. Liegt die PHP-Kommandozeile beim Hoster in einem versionsabhängigen Ordner, tragen wir den Pfad einmal in eine Konfigurationsdatei ein. - Schreibrecht im Shop-Verzeichnis für den Ordner
invoices. - Ein festes Startdatum für den Echtbetrieb, damit keine Altbestellungen ungewollt Nummern bekommen.
Stand
Die Lösung ist an einer Kopie der Shopdaten und in einer lokalen Installation von modified 3.3.0 getestet. Für unseren Kunden folgt jetzt die Installation im Live-Shop, zunächst mit einer Vorschau über einen kurzen Zeitraum.
Häufige Fragen
Entstehen die PDFs automatisch?
Auf Wunsch per Cron, mit einem festen Startdatum. Ohne Cron genügt ein Klick auf der Admin-Seite.
Werden bestehende Rechnungen verändert?
Nein. Bestehende Nummern, Daten und PDFs bleiben unverändert. Die Seite vergibt nur Nummern, die noch fehlen.
Gibt es das als fertiges Modul?
Bisher ist es eine Individuallösung für einen Kunden. Wenn Sie einen modified-Shop betreiben und etwas Ähnliches brauchen, passen wir es an Ihr Template und Ihren Hoster an.
Sie wollen Rechnungen aus Ihrem modified-Shop als PDF ablegen oder Ihre Rechnungsnummern aufräumen? Schreiben Sie uns, wir schauen uns Ihren Shop an.
Zurück zur Übersicht