dfproforma — Automatische Proforma-Rechnungserstellung

Übersicht

dfproforma automatisiert die Erstellung von Proforma-Rechnungen in PrestaShop 8. Sobald eine Bestellung einen konfigurierten Status erreicht, erstellt das Modul ein individuelles PDF (Logo, Nummerierung, mehrsprachiger Fußtext) und stellt es dem Kunden in seinem Konto zur Verfügung. Die manuelle Erstellung über die Bestellseite ist jederzeit unabhängig vom Bestellstatus verfügbar.

Installation

1. Im PrestaShop Back Office zu Module > Modul-Manager navigieren.
2. Auf Modul hochladen klicken und die Datei dfproforma.zip auswählen.
3. Auf Installieren klicken. Die SQL-Tabellen werden automatisch erstellt.
4. Das Modul erscheint in der Liste als Proforma Invoice Generator.

Allgemeine Konfiguration

Die Konfiguration ist erreichbar über Module > Modul-Manager > dfproforma > Konfigurieren.

Auslösende Bestellstatus

Wählen Sie die Bestellstatus aus, die die automatische Proforma-Erstellung auslösen sollen. Sobald eine Bestellung einen dieser Status erreicht, wird das PDF erstellt und auf dem Server gespeichert.

PDF-Logo

Laden Sie ein dediziertes Logo für Proforma-Rechnungen hoch (akzeptierte Formate: PNG, JPG). Wird dieses Feld leer gelassen, wird standardmäßig das Shop-Logo verwendet.

E-Mail-Anhang

Aktivieren Sie die Option Proforma an Bestätigungs-E-Mails anhängen, damit das PDF automatisch an Bestellungs-E-Mails angehängt wird (order_conf, bankwire, cheque, payment).

Proforma-Nummerierung

Die Nummerierung ist pro installierter Sprache konfigurierbar. Für jede Sprache:

• Präfix: Text, der vor der Nummer hinzugefügt wird (z. B. PROFORMA, PRO).
• Startnummer: Ganzzahl, ab der der Zähler beginnt (z. B. 1 oder 1000).
• Anzahl der Stellen: Länge des Zählers mit führenden Nullen (z. B. 6 → 000001).

Beispiel: Präfix PROFORMA, Start 1, 6 Stellen → erste Proforma nummeriert als PROFORMA-000001.

PDF-Fußtext

Geben Sie den Fußtext für jede aktive Sprache ein. Dieser Text erscheint am Ende jeder in der entsprechenden Sprache erstellten Proforma.

Manuelle Erstellung im Back Office

Auf jeder Bestellseite erscheint eine Karte Proforma-Rechnung im Seitenpanel:

• Wenn eine Proforma existiert: direkter PDF-Download-Link.
• Wenn keine Proforma existiert: Schaltfläche Proforma erstellen, um sie sofort zu generieren, unabhängig vom Bestellstatus.

Kunden-Download

Kunden greifen auf ihre Proformas aus ihrem Konto zu:

• Bestelldetailseite: Eine Schaltfläche Proforma herunterladen erscheint direkt unter den Bestellinformationen.
• Bestellverlauf: Proforma-Links werden per JavaScript ohne zusätzliche AJAX-Anfrage integriert (hinzugefügt in v1.0.2).

Der Zugriff ist durch den sicheren Schlüssel der Bestellung (secure_key) geschützt — ein Kunde kann nur seine eigenen Proformas herunterladen.

PDF-Struktur

Jede erstellte Proforma enthält:

• Proforma-Nummer (gemäß der konfigurierten Nummerierung)
• Erstellungsdatum
• Shop-Logo (oder benutzerdefiniertes Logo)
• Kontaktdaten des Shops und des Käufers
• Produkttabelle mit Mengen und Stückpreisen (netto und brutto)
• Gesamtbeträge (netto, MwSt., brutto, Versandkosten)
• Benutzerdefinierter Fußtext in der Sprache der Bestellung

Multishop

dfproforma ist nativ kompatibel mit dem Multishop-Modus von PrestaShop 8:

• Die Konfiguration (Status, Logo, Nummerierung, Fußtext) ist pro Shop unabhängig.
• PDF-Dateien werden in einem separaten Ordner pro Shop gespeichert.
• Die Nummerierung ist eindeutig pro Nummer-Shop-Kombination.

Deinstallation

Die Deinstallation entfernt die SQL-Tabelle df_proforma und alle Konfigurationsschlüssel mit dem Präfix DFPROFORMA_. Bereits erstellte PDF-Dateien bleiben auf dem Server erhalten.

Changelog

• v1.0.2 — Integration im Bestellverlauf über den Hook actionFrontControllerSetMedia; Links werden ohne zusätzliche AJAX-Anfrage angezeigt.
• v1.0.1 — Kleinere Stabilitätskorrekturen.
• v1.0.0 — Erstveröffentlichung: statusbasierte Generierung, anpassbares PDF, E-Mail-Anhang, Kunden-Download.