B2B-Sammelrechnung — Dokumentation
B2B-Sammelrechnung auf PrestaShop 8 und 9 installieren, konfigurieren und automatisieren.
Überblick
Sammelrechnung fasst alle Bestellungen eines Geschäftskunden über einen Zeitraum (standardmäßig der Vormonat) zu einer einzigen konsolidierten Rechnung zusammen. Statt einer Rechnung pro Bestellung erhalten Ihre B2B-Kunden eine einzige monatliche Rechnung, fortlaufend nummeriert, mit der MwSt.-Aufschlüsselung je Satz und dem Detail Bestellung für Bestellung. Das Modul erzeugt das PDF über die native PrestaShop-Engine, versendet es per E-Mail und entfernt dabei die Einzelrechnungen aus den an Geschäftskunden gesendeten Bestell-E-Mails.
Die einzelnen PrestaShop-Rechnungen werden nie gelöscht: Sie werden weiterhin erzeugt und bleiben in Ihrem Backoffice und im Bestellverlauf verfügbar. Nur die an den B2B-Kunden gesendete E-Mail wird um ihr Einzel-PDF entlastet.
Installation
Installieren Sie das Modul wie jedes PrestaShop-Modul über Module > Modul-Manager > Modul hochladen, indem Sie die ZIP-Datei senden. Bei der Installation erstellt das Modul seine Tabellen, seinen Admin-Tab und einen zufälligen Token-Wert für den Cron. Es ist keine Composer-Abhängigkeit erforderlich.
Konfiguration
Gehen Sie zu Module > Modul-Manager und klicken Sie neben Sammelrechnung auf Konfigurieren. Die Konfigurationsseite fasst alle Einstellungen zusammen.
B2B-Kundengruppen
Kreuzen Sie die Kundengruppe(n) an, die als geschäftlich gelten. Nur Kunden dieser Gruppen erhalten ihre Bestellungen konsolidiert, bekommen die Sammelrechnung und Zugriff auf den Bereich „Meine Sammelrechnungen“. Diese Einstellung definiert Ihren B2B-Umfang.
Einbezogene Bestellstatus
Wählen Sie die Bestellstatus, die eine Bestellung für die Konsolidierung infrage kommen lassen (standardmäßig: Zahlung akzeptiert, in Vorbereitung, versandt, geliefert). Eine Bestellung, deren aktueller Status nicht in dieser Liste steht, wird bei der Erzeugung übersprungen.
Erzeugungstag
Wählen Sie den Tag des Monats (1 bis 28), an dem der Cron die Erzeugung des Vormonats auslöst. Ein Tag zwischen 1 und 28 stellt sicher, dass das Datum in jedem Monat existiert.
Präfix und Nummerierung
Legen Sie das Nummerierungspräfix fest (Standard REC). Sammelrechnungen werden fortlaufend im Format PRÄFIX-JJJJ-00042 über einen eigenen Zähler nummeriert. Nummern werden nie wiederverwendet, selbst nach dem Löschen einer Rechnung.
Automatischer Versand und E-Mail-Bereinigung
Zwei Schalter steuern das Versandverhalten:
- Automatischer E-Mail-Versand: bei der Erzeugung (Cron oder manuell) wird die Sammelrechnung mit angehängtem PDF an den Kunden gesendet.
- Einzelrechnung aus Bestell-E-Mails entfernen: für B2B-Kunden wird das Einzelrechnungs-PDF aus den Bestell-E-Mails entfernt, sodass nur ein sauberer Versand bleibt — die monatliche Sammelrechnung.
Rechtshinweise und Zahlungsbedingungen
Zwei mehrsprachige Textfelder erlauben es, die Rechtshinweise (standardmäßig ein Hinweis auf Artikel 289 I-3 des französischen Steuergesetzbuchs zur periodischen Sammelrechnung) und die im Rechnungsfuß angezeigten Zahlungsbedingungen anzupassen. Diese Texte können in jeder Shop-Sprache eingegeben werden.
Cron-Automatisierung
Die automatische Erzeugung stützt sich auf eine token-geschützte Cron-URL. Rufen Sie die vollständige URL (inklusive Token) im Info-Panel der Konfigurationsseite ab und planen Sie sie im Aufgabenplaner Ihres Servers ein. Beispiel für einen Crontab-Eintrag für eine tägliche Auslösung:
0 6 * * * wget -q -O /dev/null "https://ihrshop.tld/module/dfdeferredinvoicing/cron?token=IHR_TOKEN"Der Cron ist idempotent: Er erzeugt die Rechnung eines Kunden nur, wenn für den Zeitraum noch keine existiert. Sie können ihn daher gefahrlos täglich ausführen — nur der konfigurierte Erzeugungstag löst tatsächlich die Verarbeitung des Vormonats aus.
Optionale Parameter
&force=1: erzwingt die Erzeugung unabhängig vom Tag des Monats.&month=6&year=2026: zielt auf einen bestimmten Zeitraum (nützlich, um einen vergangenen Monat erneut zu verarbeiten).
Die Antwort wird im JSON-Format zurückgegeben, mit der Anzahl der verarbeiteten Kunden, der erstellten Rechnungen und der konsolidierten Bestellungen.
Zum sofortigen Testen öffnen Sie die Cron-URL mit &force=1 in Ihrem Browser: Sie erhalten die JSON-Zusammenfassung der Erzeugung, ohne auf den geplanten Tag zu warten.
Tägliche Nutzung
Tab „Sammelrechnungen“
Ein Tab Sammelrechnungen wird unter Bestellungen hinzugefügt. Er listet alle erzeugten Sammelrechnungen auf, mit Nummer, Kunde, Zeitraum, Anzahl Bestellungen, Bruttosumme und E-Mail-Versandstatus. Jede Zeile ermöglicht das Herunterladen des PDF, das erneute Senden der E-Mail oder das Löschen der Rechnung.
Manuelle Erzeugung
Oben in diesem Tab erlaubt ein Panel die manuelle Erzeugung eines Zeitraums (Monat und Jahr, mit dem Vormonat vorbelegt) für alle B2B-Kunden oder für einen bestimmten Kunden. Das ist nützlich für eine einmalige Nacherfassung oder um die Rechnung eines Kunden auf Anfrage auszustellen.
Kundenbereich
Geschäftskunden verfügen über einen Link „Meine Sammelrechnungen“ in ihrem Konto, wo sie alle ihre konsolidierten Rechnungen finden und herunterladen. Dieser Link erscheint nur für Kunden der konfigurierten B2B-Gruppen.
Was die Sammelrechnung enthält
Jede Rechnung zeigt: die Shop-Daten und die Rechnungsadresse des Kunden (Firmenname, USt-IdNr.), das Detail Bestellung für Bestellung (Datum, Referenz, ursprüngliche PrestaShop-Rechnungsnummer, Betrag), die MwSt.-Aufschlüsselung je Satz (Produkte und Versand), mit einer Rundungsausgleichszeile, falls eine kleine Abweichung auftritt, dann die Summen netto / MwSt. / brutto und schließlich Ihre Zahlungsbedingungen und Rechtshinweise.
Bestellungen werden nach Währung gruppiert: ein Kunde, der im selben Zeitraum in zwei verschiedenen Währungen bestellt hat, erhält eine Sammelrechnung je Währung.
Garantien und Grenzen
- Dublettensicher: jede Bestellung wird in einer Verknüpfungstabelle gespeichert, in der sie eindeutig ist. Eine bereits konsolidierte Bestellung kann nie in einer anderen Sammelrechnung wiederverwendet werden.
- Löschen: das Löschen einer Sammelrechnung gibt ihre Bestellungen frei, die wieder für eine neue Konsolidierung infrage kommen. Die gelöschte Nummer wird jedoch nicht neu vergeben.
- Einzelrechnungen: sie bleiben im kundenseitigen Bestellverlauf sichtbar; nur die E-Mail wird entlastet. Sie auszublenden würde die PrestaShop-Buchhaltung stören.
- MwSt.-Aufschlüsselung: die Aufteilung je Satz wird aus den Bestellpositionen und dem Versand rekonstruiert; sie kann im seltenen Fall, dass ein einzelnes Produkt mehrere gestapelte Steuern kumuliert, näherungsweise sein.
Kompatibilität
Sammelrechnung ist kompatibel mit PrestaShop 8.0 bis 9.x, im Einzelshop wie im Multishop, in den fünf Katalogsprachen (Französisch, Englisch, Spanisch, Deutsch, Italienisch), ohne jede Composer-Abhängigkeit.