# PDF Templates

### **PDF-Templates für verbesserte Steueranzeige**

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2025-10/scaled-1680-/e1ugrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2025-10/e1ugrafik.png)

#### **Zweck der Funktion**

Diese Funktion stellt sicher, dass die erweiterten Steuerinformationen des Moduls auch in den Rechnungen Ihres aktiven PrestaShop-Themes korrekt angezeigt werden.  
Dazu werden speziell angepasste **PDF-Templates** in das Verzeichnis des aktuell aktiven Themes kopiert.

---

#### **Funktionsweise**

Beim Klick auf **„Kopiere jetzt die Templates!“** kopiert das Modul automatisch die folgenden Dateien:

- `invoice.product-tab.tpl`
- `invoice.tax-tab.tpl`

in das PDF-Verzeichnis Ihres aktiven Themes:  
`/themes/<IhrThemeName>/pdf/`

💡 *Der Platzhalter `<IhrThemeName>` wird dabei dynamisch durch das aktuell aktive Theme ersetzt.*

Diese Templates ersetzen die Standardversionen von PrestaShop und enthalten Erweiterungen, damit die Steuerinformationen des Moduls (z. B. Versandsteuer, Differenzbesteuerung, Kleinunternehmerregelung) auch in der Rechnung angezeigt werden.

---

#### **Enthaltene Erweiterungen**

Die neuen Templates ermöglichen:

- die **Anzeige der Steuer auf Versandkosten** in der Steuertabelle unterhalb der Rechnung,
- die **Integration zusätzlicher Steuerdaten** über den Hook `displayPDFInvoiceData` (z. B. Differenzbesteuerung),
- eine **einheitliche Darstellung** aller steuerrelevanten Beträge zwischen Warenkorb, Bestellung und PDF-Rechnung.

---

#### **Wichtiger Hinweis**

- Bereits vorhandene eigene Anpassungen an den Dateien  
    `invoice.product-tab.tpl` oder `invoice.tax-tab.tpl`  
    werden durch diesen Vorgang **überschrieben**.
- Erstellen Sie daher **vor dem Kopieren** eine Sicherungskopie Ihrer bisherigen Dateien, wenn Sie individuelle PDF-Anpassungen vorgenommen haben.

---

#### **Empfohlene Vorgehensweise**

1. Prüfen Sie, ob Sie eigene PDF-Anpassungen im aktiven Theme verwenden.
2. Sichern Sie bei Bedarf die bestehenden Template-Dateien unter `/themes/<IhrThemeName>/pdf/`.
3. Klicken Sie anschließend auf **„Kopiere jetzt die Templates!“**.
4. Erzeugen Sie eine Testrechnung, um die neue Steueranzeige zu prüfen.

---

#### **Ergebnis**

Nach dem Kopieren enthalten Ihre Rechnungs-PDFs:

- eine korrekte Steueraufschlüsselung für Produkte, Versand und Differenzbesteuerung,
- konsistente Netto-/Bruttowerte in allen Bereichen,
- zusätzliche Steuerzeilen, falls Ihr Shop *Kleinunternehmerregelung* oder *Differenzbesteuerung* nutzt.

### **Einstellungen für zusätzliche Informationen in der PDF-Rechnung (nur B2B)**

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2025-10/scaled-1680-/TRbgrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2025-10/TRbgrafik.png)

#### **Zweck der Funktion**

Mit dieser Funktion können Sie in Ihren PDF-Rechnungen **automatisch einen zusätzlichen Hinweistext** einblenden, wenn der Kunde eine **gültige Umsatzsteuer-Identifikationsnummer (USt-IdNr.)** angegeben hat.  
Diese Einstellung richtet sich ausschließlich an **B2B-Kunden (Business-to-Business)**, also gewerbliche Käufer mit steuerlicher Registrierung.

---

#### **Funktionsweise**

Wenn die Option **„Aktiv“** eingeschaltet ist, prüft das Modul beim Erstellen einer Rechnung, ob:

1. der Kunde eine **gültige Umsatzsteuer-ID** im Kundenkonto oder in der Bestellung hinterlegt hat, und
2. das Land oder die Zone des Kunden **in den ausgewählten Zonen** enthalten ist.

Wenn beide Bedingungen erfüllt sind, wird der hinterlegte Hinweistext automatisch **am Ende der PDF-Rechnung** angezeigt.

---

#### **Einstellmöglichkeiten**

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2025-10/scaled-1680-/ewlgrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2025-10/ewlgrafik.png)

Schaltet die Funktion ein oder aus.  
Wenn deaktiviert, wird kein B2B-Hinweistext ausgegeben – unabhängig von den weiteren Einstellungen.

---

#### **B2B-Rechnungstext**

Hier tragen Sie den Hinweistext ein, der auf der PDF-Rechnung erscheinen soll.

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2025-10/scaled-1680-/dAEgrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2025-10/dAEgrafik.png)

  
Beispiel:

> Innergemeinschaftliche Lieferung gemäß §4 Nr. 1b UStG i.V.m. §6a UStG.  
> Steuerfreie Lieferung – Reverse-Charge-Verfahren.

💡 Der Text kann mehrsprachig hinterlegt werden. Wählen Sie dazu im Dropdown das jeweilige Sprachkennzeichen (z. B. **DE**, **EN**, **FR**) und geben Sie den entsprechenden Text ein.

---

#### **B2B-Rechnungstext Zone**

Wählen Sie hier, für welche **Länderzonen** der Text angezeigt werden soll.  
Der Hinweis erscheint **nur**, wenn:

- der Kunde in einer der ausgewählten Zonen ansässig ist, **und**
- eine gültige Umsatzsteuer-ID angegeben wurde.

Beispiel:  
Wenn Sie „Europa (ohne Deutschland)“ auswählen, erscheint der Hinweistext nur für Kunden mit USt-IdNr. aus dem EU-Ausland – nicht für deutsche Kunden.

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2025-10/scaled-1680-/Cnugrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2025-10/Cnugrafik.png)

---

### **Anwendungsbeispiel**

Ein Kunde aus Frankreich gibt beim Bestellvorgang eine gültige USt-IdNr. an.  
In den Modul-Einstellungen ist die Zone „Europa“ ausgewählt und der Text lautet:

> Reverse Charge – VAT to be declared by the recipient (Art. 196 EU VAT Directive).

In diesem Fall erscheint dieser Hinweis automatisch auf der PDF-Rechnung unterhalb der Steuerübersicht.

---

### **Hinweise**

- Diese Funktion betrifft ausschließlich die **PDF-Rechnung** (nicht den E-Mail-Text oder den Bestellvorgang im Frontoffice).
- Die Erkennung der Umsatzsteuer-ID erfolgt über die PrestaShop-Kundendatenbank (`vat_number` Feld).
- Sie können unterschiedliche Texte pro Sprache und Zone hinterlegen.

---

### **Vorteile**

✅ Automatische rechtssichere Kennzeichnung für B2B-Rechnungen  
✅ Mehrsprachige Texte für internationale Kunden  
✅ Selektive Anzeige nach Regionen oder Steuerzonen  
✅ Integration direkt im Standard-Rechnungsdokument