> ## 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 Bestelleingangsbestätigung

> Wie Sie dem Käufer auf der Bestätigungsseite einen Link anbieten, mit dem er die Bestelleingangsbestätigung als PDF herunterlädt.

Auf der Bestelleingangsbestätigung im Shop können Sie dem Käufer einen Link anbieten, über den er die Bestellung als PDF herunterlädt. Das PDF entsteht dabei erst im Moment des Klicks, aus einem eigenen Template.

Das ist nicht der PDF-Anhang der Bestätigungsmail. Hier geht es um einen Download auf der Seite im Shop, den der Käufer selbst auslöst. Der Anhang der Mail wird an anderer Stelle eingerichtet, mit eigenen Parametern.

Wegweiser: [PDF-Anhang der Bestelldetails](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/pdf-anhang-der-bestelldetails.md), für den Anhang der Bestätigungsmail

## Schritt 1: Das PDF-Template hinterlegen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Templates>
   ConfirmPDF = ws_confirm_pdf.htm
</Templates>
```

Legen Sie eine Datei unter diesem Namen in Ihrem Templateverzeichnis an. Sie enthält die Bestellung in der Form, in der sie im PDF erscheinen soll.

Nehmen Sie nicht dasselbe Template wie für die Bestätigungsseite im Shop. Ein PDF hat keine Navigation, keine Schaltflächen und keinen Fußbereich mit Links. Was auf der Seite sinnvoll ist, stört im Beleg.

Referenz: [Abschnitt Templates](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md#templates)

## Schritt 2: Den Dateinamen festlegen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PDFGenerator>
   ConfirmPDFFilename = bestellung.pdf
</PDFGenerator>
```

Der Abschnitt `<PDFGenerator>` sammelt die Dateinamen für alle PDF-Ausgaben des Shops. Neben `ConfirmPDFFilename` stehen dort `ProductPDFFilename` für das Produktdatenblatt, `BasketPDFFilename` für den Warenkorb und `InstantVoucherPDFFilename` für den Sofortgutschein. Die technischen Einstellungen des PDF-Erzeugers selbst liegen außerhalb der Shopkonfiguration.

Referenz: [Abschnitt PDFGenerator](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md#pdfgenerator)

## Schritt 3: Den Link einbauen

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<a href="~WS-PDFConfirmDownloadLink~">Bestellung als PDF herunterladen</a>
```

Der Link gehört auf die Bestelleingangsbestätigung. Er erzeugt das PDF beim Aufruf und liefert es als Download aus.

Referenz: [WS-PDFConfirmDownloadLink](https://dokumentation.websale.de/v8s/referenz/tags/ws/bestellprozess-adressen-und-pruefungen.md#die-tags-im-uberblick)

## Schritt 4: Den Fehlerfall abfangen

Die Erzeugung eines PDF kann scheitern, und sie kann zu lange dauern. Beides führt dazu, dass der Käufer statt seines Downloads auf der Hinweisseite landet.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<NotifyMessages-Txt>
   PDFGeneratorError = Die PDF-Datei konnte nicht erzeugt werden. Bitte versuchen Sie es erneut.
</NotifyMessages-Txt>
```

Formulieren Sie den Text so, dass der Käufer weiß, dass seine Bestellung davon unberührt ist. Ein gescheitertes PDF ist ein Anzeigeproblem, keine gescheiterte Bestellung, und genau das befürchtet der Käufer in diesem Moment.

Zusätzlich lässt sich die interne Fehlermeldung auf der Hinweisseite ausgeben. Sie hilft bei der Fehlersuche, gehört aber nicht vor die Augen des Käufers.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<!--
{MSG-InternalErrorMessage}
   Fehler: ~MSG-InternalErrorMessage~
{/MSG-InternalErrorMessage}
-->
```

> [!WARNING]
>
> Setzen Sie dieses Tag ausschließlich innerhalb eines HTML-Kommentars ein. Die Meldung stammt aus dem Inneren des Shops und ist für den Käufer weder verständlich noch bestimmt. Über die Quelltextanzeige des Browsers kommen Sie trotzdem jederzeit an sie heran.

Referenz: [Abschnitt NotifyMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#notifymessages-txt) · [MSG-InternalErrorMessage](https://dokumentation.websale.de/v8s/referenz/tags/msg-meldungen.md#weitere-meldungen)

## Verwandte Themen

* Wegweiser: PDF-Anhang der Bestelldetails, für den Anhang der Bestätigungsmail
* Wegweiser: [Bestelleingangsbestätigung](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/bestelleingangs-e-mail-an-den-shopbetreiber.md), für die Seite selbst
* Wegweiser: [Kaufgutscheine zum Ausdrucken](https://dokumentation.websale.de/v8s/gutscheine-anbieten/kaufgutscheine-zum-ausdrucken.md)


## Related topics

- [Template-Typen](https://dokumentation.websale.de/v8s/grundlagen-templates/template-typen.md)
- [PDF-Anhang der Bestelldetails](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/pdf-anhang-der-bestelldetails.md)
- [Kaufgutscheine zum Ausdrucken](https://dokumentation.websale.de/v8s/gutscheine-anbieten/kaufgutscheine-zum-ausdrucken.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)


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