> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# PDF-Anhang der Bestelldetails

> Dateien an die Bestelleingangsbestätigung anhängen, beispielsweise AGB und Widerrufsbelehrung als PDF, und die Anhänge im Abschnitt CustomerMail einrichten.

Nach einer Bestellung bekommt der Käufer eine Bestelleingangsbestätigung als HTML-E-Mail. Sie wird im Abschnitt `<CustomerMail>` der Shopkonfiguration eingerichtet, der Inhalt kommt aus einem eigenen Template.

An diese Mail lassen sich Dateien anhängen, bis zu fünf Stück. Der häufigste Fall sind die AGB und die Widerrufsbelehrung als PDF, die dem Käufer damit dauerhaft vorliegen.

## Grundeinstellungen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<CustomerMail>
   Allow          = yes
   Subject-Txt    = Ihre Bestellung bei uns
   SenderAddress  = shop@ihr-shop.de
   SenderName     = Ihr Shop
   Template       = mail_customer_order.htm
   BCCAddressList =
</CustomerMail>
```

| Parameter | Bedeutung |
| - | - |
| `Allow` | `yes` verschickt die Bestätigungsmail. Jeder andere Wert schaltet sie ab |
| `Subject-Txt` | der Betreff der Mail |
| `SenderAddress` | die Absenderadresse |
| `SenderName` | der angezeigte Absendername |
| `Template` | das Template, aus dem der Inhalt der Mail entsteht |
| `BCCAddressList` | Adressen, die eine Blindkopie der Mail bekommen |

> [!WARNING]
>
> Eine Blindkopie über `BCCAddressList` enthält die vollständige Bestellung des Käufers, einschließlich Adresse und Warenkorb, und geht unverschlüsselt hinaus. Setzen Sie den Parameter nur, wenn es dafür einen belastbaren Grund gibt, und klären Sie ihn datenschutzrechtlich ab. Für eine reine Benachrichtigung über eingegangene Bestellungen gibt es einen eigenen, dafür gedachten Weg.

Wegweiser: [Bestelleingangs-E-Mail an den Shopbetreiber](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/bestelleingangs-e-mail-an-den-shopbetreiber.md)

Der Abschnitt enthält darüber hinaus die Parameter für den PDF-Anhang der Bestelldetails, für das SEPA-Mandat und für die Anbindung an ein externes Mailsystem.

Wegweiser: [PDF-Anhang der Bestelldetails](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/pdf-anhang-der-bestelldetails.md)

Referenz: [Abschnitt CustomerMail](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/e-mails.md#customermail)

## Dateien anhängen

Für jeden Anhang legen Sie im Abschnitt `<CustomerMail>` einen Unterabschnitt `<+Attachment>` an.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<CustomerMail>
   Allow       = yes
   Subject-Txt = Ihre Bestellung bei uns

   <+Attachment>
      File = dokumente/agb.pdf
      Name = AGB.pdf
   </+Attachment>

   <+Attachment>
      File = dokumente/widerrufsbelehrung.pdf
      Name = Widerrufsbelehrung.pdf
   </+Attachment>
</CustomerMail>
```

| Parameter | Bedeutung |
| - | - |
| `File` | Pfad zur Datei, relativ zum Template-Verzeichnis Ihres Shops |
| `Name` | Dateiname, unter dem der Anhang beim Käufer ankommt. Optional |

Ohne `Name` bekommt der Käufer die Datei unter ihrem Namen aus dem Dateisystem. Das ist selten das, was Sie wollen: aus `agb_v3_final.pdf` wird sonst genau das im Postfach des Käufers. Setzen Sie `Name` deshalb immer.

### Wo die Dateien liegen

Der Pfad in `File` ist **relativ zum Template-Verzeichnis** Ihres Shops, nicht zum Shopverzeichnis und nicht absolut. Legen Sie die Anhänge deshalb dort ab, wo auch Ihre Templates liegen, oder in einem Unterordner davon.

> [!WARNING]
>
> Der Pfad darf höchstens eine Ebene nach unten führen und keine Rücksprünge mit `..` enthalten. Der Shop prüft das beim Einlesen. Verstößt ein Pfad dagegen, wird der Anhang stillschweigend verworfen, ohne Fehlermeldung.
>
> Prüfen Sie nach jeder Änderung an der Konfiguration, ob der Anhang tatsächlich ankommt. Findet der Shop die Datei nicht, hängt er sie trotzdem an, dann aber leer. Der Käufer bekommt in diesem Fall eine PDF-Datei mit null Bytes, und das fällt weder im Shop noch im Protokoll auf.

### Wie viele Anhänge sinnvoll sind

Möglich sind fünf. Sinnvoll sind meist weniger.

Jeder Anhang vergrößert die Mail, und große Mails landen eher im Spamordner oder werden vom Postfach des Empfängers abgewiesen. Halten Sie die PDF-Dateien klein und prüfen Sie die Gesamtgröße der Mail. Für umfangreiche Dokumente ist ein Link in die Mail die bessere Wahl als ein Anhang.

Die Anhänge sind fest konfiguriert und gehen an jede Bestätigungsmail, unabhängig von der Bestellung. Eine Steuerung nach Zahlungsart, Warenkorbinhalt oder Land gibt es an dieser Stelle nicht.

## Das SEPA-Mandat

Für die Lastschrift kann der Shop zusätzlich ein SEPA-Mandat als PDF erzeugen und der Bestätigungsmail beilegen. Das ist kein `<+Attachment>`, sondern wird über eigene Parameter im selben Abschnitt gesteuert, mit getrennten Vorlagen für Privat- und Geschäftskunden.

Wegweiser: [Lastschrift, für das SEPA-Mandat](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/lastschrift.md)

## Verwandte Themen

* Wegweiser: [Bestelleingangsbestätigung](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/bestelleingangs-e-mail-an-den-shopbetreiber.md), für die Seite im Shop
* Wegweiser: [AGB akzeptieren](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/agb-akzeptieren.md)
* Wegweiser: [E-Mail-Benachrichtigungen](https://dokumentation.websale.de/v8s/e-mails/e-mail-benachrichtigungen-ueberblick.md)


## Related topics

- [PDF-Anhang der Bestelleingangsbestätigung](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/pdf-anhang-der-bestelleingangsbestaetigung.md)
- [E-Mails](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/e-mails.md)
- [Materialien INQUIRY](https://dokumentation.websale.de/v8s/materialien/materialien-inquiry.md)
- [Kaufgutscheine zum Ausdrucken](https://dokumentation.websale.de/v8s/gutscheine-anbieten/kaufgutscheine-zum-ausdrucken.md)
- [Template-Typen](https://dokumentation.websale.de/v8s/grundlagen-templates/template-typen.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.