> ## 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-Anzeige des Warenkorbs

> Wie Sie Käufern in WEBSALE V8s anbieten, ihren Warenkorb als PDF-Datei herunterzuladen, und wie Sie Fehler bei der Erzeugung nachvollziehen.

Ein Warenkorb als PDF ist etwas, das der Käufer weitergeben kann: an einen Kollegen, in die Buchhaltung, an den Vorgesetzten. Genau dort liegt der Nutzen, denn ein Warenkorb im Browser existiert nur für ihn selbst.

Erzeugt wird die Datei aus einem eigenen Template. Der Warenkorb im Shop und der Warenkorb im PDF können deshalb unterschiedlich aussehen, was sinnvoll ist: Im PDF gibt es keine Schaltflächen zum Ändern, dafür aber Platz für Ihre Anschrift und einen Hinweis auf die Gültigkeit der Preise.

In B2B-Shops lässt sich die Funktion zweckentfremden, damit Ihre Käufer aus dem Warenkorb heraus Angebote für ihre eigenen Kunden erstellen.

## Schritt 1: Template zuweisen

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

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

## Schritt 2: Dateinamen festlegen

Unter diesem Namen bekommt der Käufer die Datei zum Herunterladen angeboten.

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

Derselbe Abschnitt nimmt auch die Dateinamen der übrigen PDF-Funktionen auf, beispielsweise für die Produktdetailansicht und die Bestellbestätigung. Die technischen Einstellungen des Generators, also Programmpfad und Zeitgrenze, liegen dagegen in der globalen Konfiguration und nicht in Ihrer `shop.config`.

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

## Schritt 3: Fehlermeldung hinterlegen

Schlägt die Erzeugung fehl, landet der Käufer auf der Hinweisseite. Was dort steht, legen Sie fest.

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

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

## Schritt 4: Schaltfläche einbauen

Die Schaltfläche gehört in das Warenkorbformular, denn der Shop muss beim Auslösen wissen, was im Warenkorb liegt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<form action="~FORM-Basket~" method="post">
   <input type="submit" name="~BT-GeneratePDF~" value="Warenkorb als PDF">
</form>
```

## Fehlerursachen nachvollziehen

Die Meldung aus Schritt 3 sagt dem Käufer, dass etwas schiefging. Sie sagt Ihnen nicht, was. Dafür gibt es ein zweites Tag, das die interne Meldung ausgibt.

> [!WARNING]
>
> Setzen Sie dieses Tag ausschließlich in einen HTML-Kommentar. Interne Fehlermeldungen gehören nicht vor die Augen des Käufers. Im Kommentar erreichen Sie sie über die Quelltextanzeige Ihres Browsers, der Käufer sieht auf der Seite nichts.

Ergänzen Sie das Notify-Template:

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

Die Klammerung sorgt dafür, dass der Kommentar leer bleibt, wenn keine interne Meldung vorliegt.

Referenz: [MSG-InternalErrorMessage](https://dokumentation.websale.de/v8s/referenz/tags/msg-meldungen.md#weitere-meldungen)

## Verwandte Themen

* Wegweiser: [PDF-Anzeige der Produkt-Detailansicht, dieselbe Mechanik für ein einzelnes Produkt](https://dokumentation.websale.de/v8s/produkte/pdf-anzeige-der-produkt-detailansicht.md)
* Wegweiser: [Warenkorb anzeigen und löschen, für den Aufbau des PDF-Templates](https://dokumentation.websale.de/v8s/warenkorb/warenkorb-anzeigen-loeschen.md)
* Anwendungsbeispiel: [Angebote an Kunden erstellen (B2B)](https://dokumentation.websale.de/v8s/anwendungsbeispiele/appex-angebote-an-kunden-b2b.md)


## Related topics

- [Angebote an Kunden erstellen (B2B)](https://dokumentation.websale.de/v8s/anwendungsbeispiele/appex-angebote-an-kunden-b2b.md)
- [Grundlagen und Technik](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md)
- [PDF-Anzeige der Produkt-Detailansicht](https://dokumentation.websale.de/v8s/produkte/pdf-anzeige-der-produkt-detailansicht.md)
- [Schaltflächen auf Produkt- und Warenkorbseite](https://dokumentation.websale.de/v8s/referenz/tags/bt/produkt-und-warenkorb.md)
- [Produkte auf alternativem Template anzeigen](https://dokumentation.websale.de/v8s/produkte/produkte-auf-alternativem-template-anzeigen.md)


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