# 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…

- Seite: <https://www.datafirefly.com/de/documentation/dfproforma/>
- Sprache: de
- Aktualisiert am: 2026-07-02
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfproforma/index.md), [en](https://www.datafirefly.com/en/documentation/dfproforma/index.md), [es](https://www.datafirefly.com/es/documentation/dfproforma/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfproforma/index.md), [it](https://www.datafirefly.com/it/documentation/dfproforma/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfproforma/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfproforma/index.md)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

## Ü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.

**Hauptanwendungsfall:** B2B-Kontexte, in denen der Kunde eine Proforma-Rechnung benötigt, bevor er die Zahlung bestätigt oder eine interne Genehmigung einholt.

## 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_.

Kompatibilität: PrestaShop 8.0 bis 8.x, PHP 7.4 bis 8.3, Multishop.

## 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.

Empfehlung: Bei Standard-Flows auf _Zahlung akzeptiert_ auslösen; bei B2B-Kontexten, wo die Proforma der Zahlung vorausgeht, auf _Auf Zahlung wartend_.

### 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`.

Im Multishop-Modus ist die Nummerierung pro Shop isoliert: Der zusammengesetzte Schlüssel `proforma_number + id_shop` garantiert Eindeutigkeit ohne Duplikate zwischen Shops.

### 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.