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

# Trusted Shops

> Gütesiegel, Käuferschutz und Kundenbewertungen von Trusted Shops in den Shop einbinden, mit den WEBSALE-Tags für die Datenübergabe.

Trusted Shops zertifiziert Online-Shops und vergibt ein Gütesiegel. Für Ihren Shop bedeutet das drei Bausteine, die Sie einzeln oder gemeinsam nutzen können: das Gütesiegel selbst, den Käuferschutz als Geld-zurück-Garantie und die Kundenbewertungen.

Alle drei laufen über das **Trustbadge**, einen JavaScript-Baustein von Trusted Shops. Der sichtbare Teil ist das Siegel mit der Bewertungsanzeige, üblicherweise unten rechts im Shop. Der unsichtbare Teil liest nach einer Bestellung die Bestelldaten aus der Seite und bietet dem Käufer den Käuferschutz an.

WEBSALE steuert dazu genau eines bei: die Bestelldaten in einer Form, die das Trustbadge lesen kann. Alles andere ist Trusted Shops.

> [!WARNING]
>
> Trusted Shops hat seine Plattform auf eTrusted umgestellt und dabei Integrationswege und Dokumentationsseiten geändert. Die Skripte auf dieser Seite sind **Beispiele**, die zeigen, an welchen Stellen WEBSALE-Tags einzusetzen sind. Holen Sie den tatsächlich einzubindenden Code immer aktuell bei Trusted Shops und übertragen Sie dann die Tags.

## Die drei Bausteine im Überblick

| Baustein | Was er leistet | Freischaltung durch WEBSALE |
| - | - | - |
| Gütesiegel als Trustbadge | zeigt Siegel und Bewertungen im Shop | nicht nötig |
| Käuferschutz, Standard-Modell | für den Käufer kostenlos, nach der Bestellung abschließbar | erforderlich |
| Käuferschutz Excellence | kostenpflichtig, wird auf der Zahlungsartenseite gewählt | erforderlich |
| Kundenbewertungen | Shop- und Produktbewertungen anzeigen und an Google übergeben | nicht nötig |

Der Käuferschutz setzt das Gütesiegel voraus, die Bewertungen bauen auf dem Trustbadge auf. Arbeiten Sie die Abschnitte deshalb in dieser Reihenfolge ab.

Ausführliche Informationen finden Sie bei Trusted Shops unter [business.trustedshops.com/knowledge/integration](https://business.trustedshops.com/knowledge/integration) und im Hilfebereich unter [help.etrusted.com](https://help.etrusted.com/hc/de/articles/23970823488530-Trustbadge-Dokumentation-f%C3%BCr-Online-H%C3%A4ndler).

## Das Trustbadge einbinden

### Schritt 1: Den Trustbadge-Code beschaffen

Nach der Zertifizierung erhalten Sie von Trusted Shops Ihre Trusted Shops ID. Daraus erzeugt Trusted Shops den Skriptblock mit Ihrem individuellen Trustbadge-Code.

> [!WARNING]
>
> Der folgende Code ist ein Beispiel. Kopieren Sie ihn nicht, sondern lassen Sie sich Ihren eigenen Code von Trusted Shops erzeugen. Die Beispiel-ID funktioniert in keinem Shop.

### Schritt 2: Den Trustbadge-Code einbinden

Fügen Sie den Skriptblock auf den gewünschten Shop-Templates unmittelbar vor dem schließenden `body`-Tag ein.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<script type="text/javascript">
  (function () {
    var _tsid = 'INDIVIDUELLER TRUSTBADGE-CODE';
    _tsConfig = {
      'yOffset': '0',                 /* Abstand vom unteren Seitenrand */
      'variant': 'reviews',           /* text, default, small, reviews, custom, custom_reviews */
      'customElementId': '',          /* nur für die Varianten custom und custom_reviews */
      'trustcardDirection': '',       /* für custom: topRight, topLeft, bottomRight, bottomLeft */
      'customBadgeWidth': '',         /* für custom: 40 bis 90 Pixel */
      'customBadgeHeight': '',        /* für custom: 40 bis 90 Pixel */
      'disableResponsive': 'false',
      'disableTrustbadge': 'false',
      'trustCardTrigger': 'mouseenter' /* 'click', wenn die Trustcard erst beim Klick aufgehen soll */
    };
    var _ts = document.createElement('script');
    _ts.type = 'text/javascript';
    _ts.charset = 'utf-8';
    _ts.async = true;
    _ts.src = '//widgets.trustedshops.com/js/' + _tsid + '.js';
    var __ts = document.getElementsByTagName('script')[0];
    __ts.parentNode.insertBefore(_ts, __ts);
  })();
</script>
```

Binden Sie den Block auch auf der Bestelleingangsbestätigung `ws_confirm.htm` ein. Ohne ihn dort gibt es keinen Käuferschutz, weil genau dort die Trustcard aufgeht.

## Den Käuferschutz einbinden

Nach Abschluss der Bestellung öffnet das Trustbadge ein kleines Fenster, die Trustcard. Darin wird dem Käufer der Käuferschutz angeboten. Damit das funktioniert, muss das Trustbadge die Bestelldaten aus der Seite lesen können.

![Ts Trustcard](https://mintcdn.com/websaleag-44ee7ea6/UyjGmXApgB40YKCW/images/ts_trustcard.png?fit=max\&auto=format\&n=UyjGmXApgB40YKCW\&q=85\&s=5becda0eb03e167ada3f0a53f9ce6019)

### Voraussetzung

Der Käuferschutz muss von der WEBSALE AG für Ihren Shop freigeschaltet werden. Wenden Sie sich an Ihren WEBSALE Ansprechpartner.

### Die Bestelldaten übergeben

Setzen Sie auf der Bestelleingangsbestätigung `ws_confirm.htm` das Tag `WS-TrustBadge`.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
~WS-TrustBadge~
```

Das Tag erzeugt einen versteckten Container mit den Bestelldaten. Daran erkennt das Trustbadge, dass der Kunde die Bestellung abgeschlossen hat, und öffnet die Trustcard. Der Kunde muss nichts erneut eingeben.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<div id="trustedShopsCheckout" style="display: none;">
   <span id="tsCheckoutOrderNr">Auftragsnummer</span>
   <span id="tsCheckoutBuyerEmail">E-Mail-Adresse des Kunden</span>
   <span id="tsCheckoutOrderAmount">Gesamtsumme</span>
   <span id="tsCheckoutOrderCurrency">Währung</span>
   <span id="tsCheckoutOrderPaymentType">Name der Zahlungsart</span>

   <!-- je Warenkorbposition -->
   <span class="tsCheckoutProductItem">
      <span class="tsCheckoutProductUrl">Link zum Produkt</span>
      <span class="tsCheckoutProductName">Produktname</span>
      <span class="tsCheckoutProductSKU">Produktnummer</span>
   </span>
</div>
```

> [!WARNING]
>
> `WS-TrustBadge` arbeitet **ausschließlich** auf der Bestelleingangsbestätigung. Auf jedem anderen Template bleibt es wirkungslos, auch ohne Fehlermeldung. Ebenso bleibt es stumm, wenn für den Shop keine Trusted Shops ID hinterlegt ist.

Der Container listet jede Warenkorbposition, auch Set-Unterprodukte. Für ein Set-Unterprodukt setzt der Shop den Link des Set-Oberprodukts ein, damit der Kunde in der Bewertungsanfrage nicht auf einer Seite landet, die es einzeln nicht gibt.

Trusted Shops kennt weitere optionale Felder, beispielsweise für Lieferdatum, Produktbild, GTIN, MPN und Marke. Diese übergibt der Shop nicht. Wenn Sie sie brauchen, etwa für Google-Produktbewertungen, müssen Sie den Container im Template selbst ergänzen.

Referenz: [WS-TrustBadge](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md#die-tags-im-uberblick)

## Käuferschutz Excellence einbinden

Neben dem für den Käufer kostenlosen Standard-Modell gibt es den kostenpflichtigen Käuferschutz Excellence. Der Kunde wählt ihn auf der Zahlungs- und Versandartenseite aus einer Liste von Produkten, die nach Versicherungssumme gestaffelt sind. Die Kosten erscheinen wie Versandkosten im Warenkorb und gehen in die Bestelldaten ein.

![Trustedshops Excellence](https://mintcdn.com/websaleag-44ee7ea6/UyjGmXApgB40YKCW/images/trustedshops_excellence.jpg?fit=max\&auto=format\&n=UyjGmXApgB40YKCW\&q=85\&s=310c63a908387a87998d1822f43b1630)

### Voraussetzung

Käuferschutz Excellence muss von der WEBSALE AG freigeschaltet werden. Dabei werden auch die Zugangsdaten zu Trusted Shops hinterlegt, die der Shop für die Statusabfrage braucht.

### Schritt 1: Die Käuferschutzprodukte konfigurieren

Legen Sie in der `shop.config` den Abschnitt `TrustedShopsAdvList` an. Die Produkt-IDs für `TSID-Txt` erhalten Sie von Trusted Shops.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<TrustedShopsAdvList>
   VATRate-Value        = 1
   <+Entry>
      TSID-Txt      = TS123456_500_30_EUR
      ERPID-Txt     = 82TS500
      ListName-Txt  = Käuferschutz bis 500 € (0,97 € inkl. 19% deutscher MwSt. / 0,82 € netto)
      OrderName-Txt = Käuferschutz bis 500 €
      Cost-Value    = 0.82
   </+Entry>
   <+Entry>
      TSID-Txt      = TS123456_1500_30_EUR
      ERPID-Txt     = 82TS1500
      ListName-Txt  = Käuferschutz bis 1.500 € (2,94 € inkl. 19% deutscher MwSt. / 2,47 € netto)
      OrderName-Txt = Käuferschutz bis 1.500 €
      Cost-Value    = 2.47
   </+Entry>
</TrustedShopsAdvList>
```

| Parameter | Bedeutung |
| - | - |
| `VATRate-Value` | **Nummer** des Mehrwertsteuersatzes aus der Steuersatztabelle des Shops, nicht der Prozentwert |
| `VATType` | optional, mit `dynamic` wird die Mehrwertsteuer dynamisch statt statisch berechnet |
| `TSID-Txt` | Produkt-ID von Trusted Shops |
| `ERPID-Txt` | Ihre eigene Artikelnummer für die Übergabe an das Warenwirtschaftssystem |
| `ListName-Txt` | Text in der Auswahlliste, die der Kunde sieht |
| `OrderName-Txt` | Text in den Bestelldaten |
| `Cost-Value` | Nettopreis |

> [!WARNING]
>
> `VATRate-Value` ist ein Index, kein Steuersatz. Der Wert `1` bedeutet "der erste in der Shopkonfiguration hinterlegte Steuersatz", nicht "1 Prozent". Fehlt der Parameter oder liegt er außerhalb der gültigen Indizes, verwendet der Shop stillschweigend Index 1.
>
> Die Trusted Shops Produkt-ID trägt die Versicherungssumme im Namen, nach dem Muster `<Ihre ID>_<Versicherungssumme>_<Laufzeit>_<Währung>`. Der Shop liest diese Summe aus, um den passenden Eintrag vorauszuwählen: Er nimmt den **ersten** Eintrag der Liste, dessen Versicherungssumme mindestens dem Bestellwert entspricht. Sortieren Sie die Einträge deshalb aufsteigend nach Versicherungssumme. Bei falscher Reihenfolge schlägt der Shop dem Kunden ein unnötig teures Produkt vor.

Referenz: [Abschnitt TrustedShopsAdvList](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/externe-dienste-und-schnittstellen.md#trustedshopsadvlist)

### Schritt 2: Die Auswahl auf der Zahlungs- und Versandartenseite anbieten

Ergänzen Sie `ws_pay_deliv.htm` um Checkbox, Auswahlliste und Erläuterung.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{ST-TrustedShopsAdv}

   ~WS-TrustedShopsAdvCheck~ Trusted Shops Käuferschutz

   ~WS-TrustedShopsAdvList~

   Der Trusted Shops Käuferschutz sichert Ihren Online-Kauf ab.
   Mit der Übermittlung und Speicherung meiner E-Mail-Adresse zur Abwicklung
   des Käuferschutzes durch Trusted Shops bin ich einverstanden.

{/ST-TrustedShopsAdv}
```

| Tag | Was es erzeugt |
| - | - |
| `ST-TrustedShopsAdv` | Klammerung, greift nur bei freigeschaltetem Käuferschutz Excellence |
| `WS-TrustedShopsAdvCheck` | die Checkbox, dazu ein verstecktes Feld, das die Auswertung des Formulars steuert |
| `WS-TrustedShopsAdvList` | die Auswahlliste als fertiges `select`-Element |
| `WS-TrustedShopsAdvID` | die konfigurierte Trusted Shops ID, falls Sie sie im Template brauchen |

Die Checkbox ist nur dann vorausgewählt, wenn der Kunde den Käuferschutz in dieser Bestellung bereits gewählt hatte. Beim ersten Aufruf der Seite ist sie leer. Ein Wort wie "empfohlen" neben der Checkbox ändert daran nichts, es ist nur Text.

Die Auswahlliste bleibt vollständig leer, wenn der Käuferschutz nicht freigeschaltet ist oder kein einziger Eintrag konfiguriert wurde. Es erscheint dann kein leeres Auswahlfeld, sondern gar nichts.

Referenz: [ST-TrustedShopsAdv](https://dokumentation.websale.de/v8s/referenz/tags/st/seitenzustand-und-navigation.md) · [WS-TrustedShopsAdvCheck](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md#die-tags-im-uberblick) · [WS-TrustedShopsAdvList](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md#trusted-shops) · WS-TrustedShopsAdvID

### Schritt 3: Die Fehlermeldung hinterlegen

Ist Trusted Shops nicht erreichbar, deaktiviert der Shop den Käuferschutz und zeigt diese Meldung.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<NotifyMessages>
   ...
   TrustedShopsAdv = Der Trusted Shops Käuferschutz steht momentan leider nicht
                     zur Verfügung und wurde deaktiviert.
   ...
</NotifyMessages>
```

Referenz: Abschnitt NotifyMessages

## Bewertungen anzeigen

Für die Bewertungen ist keine Freischaltung durch die WEBSALE AG nötig. Sie brauchen dafür aber den Käuferschutz mit Trustbadge, weil die Bewertungsanfrage an den Kauf gekoppelt ist.

![Ts Kundenbewertung Erinnerung](https://mintcdn.com/websaleag-44ee7ea6/UyjGmXApgB40YKCW/images/ts_kundenbewertung_erinnerung.png?fit=max\&auto=format\&n=UyjGmXApgB40YKCW\&q=85\&s=55301368a7670d52b90a82cf9c760c91)

### Shopbewertungen

Die Shopbewertungen zeigt das Trustbadge von sich aus an, sobald Sie in der Konfiguration die Variante `reviews` oder `custom_reviews` gewählt haben. Dafür ist im Shop nichts weiter zu tun.

> [!WARNING]
>
> Trusted Shops stellt die Funktion "Rate Later Link" nicht mehr bereit. Damit konnte ein Käufer sich an die Abgabe einer Bewertung erinnern lassen. Die Bewertungs-E-Mail nach einer Bestellung kommt von Trusted Shops und nicht von WEBSALE. Prüfen Sie Ihre dort hinterlegten E-Mail-Vorlagen und entfernen Sie einen etwaigen Button oder Link zu dieser Funktion, weil er technisch ins Leere führt.

### Produktbewertungen

Damit Produkte einzeln bewertet werden können, müssen die Produktnummern aller bestellten Produkte an Trusted Shops gehen. Das erledigt `WS-TrustBadge` auf der Bestelleingangsbestätigung. Trusted Shops schickt dem Kunden danach eine E-Mail mit der Bitte um Bewertung, die Bewertung selbst findet auf der Website von Trusted Shops statt.

Zum Anzeigen der Bewertungen im Shop binden Sie ein Widget von Trusted Shops ein. Der folgende Block zeigt, an welchen Stellen die WEBSALE-Tags einzusetzen sind.

![20180514 Ts Bewertungssterne Unterhalb Produkt 02](https://mintcdn.com/websaleag-44ee7ea6/-4O6W3x8MU7HVGrG/images/20180514_ts-bewertungssterne-unterhalb-produkt_02.png?fit=max\&auto=format\&n=-4O6W3x8MU7HVGrG\&q=85\&s=9860090a2658deec5a17479b0ef8c90a)

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<script type="text/javascript">
   _tsProductReviewsConfig = {
      tsid: 'IHRE TRUSTED SHOPS ID',

      {PR-DepVariations}
         {CAT-AdvData($DepVariations,99)}sku: ['~PR-ProdIndex~'{@PR-Data},{PR-DepVariationName1}'~PR-Number~'{/PR-DepVariationName1}{/@PR-Data}],{/CAT-AdvData($DepVariations,99)}
      {/PR-DepVariations}

      {!PR-DepVariations}
         sku: '~PR-ProdIndex~',
      {/!PR-DepVariations}

      variant: 'productreviews',
      borderColor: '#8bab55',
      introtext: 'Was unsere Kunden über uns sagen:'
   };

   var scripts = document.getElementsByTagName('SCRIPT'),
       me = scripts[scripts.length - 1];
   var _ts = document.createElement('SCRIPT');
   _ts.type = 'text/javascript';
   _ts.async = true;
   _ts.charset = 'utf-8';
   _ts.src = '//widgets.trustedshops.com/reviews/tsSticker/tsProductSticker.js';
   me.parentNode.insertBefore(_ts, me);
   _tsProductReviewsConfig.script = _ts;
</script>
```

Ein Produkt ohne Varianten übergibt seinen Produktindex als einzelnen Wert. Ein Variantenprodukt übergibt ein Array aus dem Index des Basisprodukts und den Nummern aller Varianten, damit Trusted Shops die Bewertungen der Varianten dem Basisprodukt zuordnet.

> [!WARNING]
>
> Der obige Variantenzweig setzt voraus, dass das Basisprodukt eine eigene Produktnummer hat. Fehlt sie, entsteht am Anfang des Arrays ein leerer Eintrag und ein überzähliges Komma. Setzen Sie in diesem Fall die Kommata selbst, beispielsweise mit einem Zähler:
>
> ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
> {CAT-AdvData($DepVariations,99)}~DC-Int1_set(0)~ sku: [{@PR-Data}~DC-Int1_inc~{!DC-Int1(1)},{/!DC-Int1(1)}{PR-DepVariationName1}'~PR-Number~'{/PR-DepVariationName1}{/@PR-Data}],{/CAT-AdvData($DepVariations,99)}
> ```
>
> Der Zähler sorgt dafür, dass vor dem ersten Eintrag kein Komma steht.

### Bewertungssterne separat anzeigen

Wollen Sie nur die Sterne an einer bestimmten Stelle zeigen, beispielsweise neben dem Produktnamen, verwenden Sie das Summary-Widget.

![20180511 Ts Produktbewertung](https://mintcdn.com/websaleag-44ee7ea6/-4O6W3x8MU7HVGrG/images/20180511_ts-produktbewertung.png?fit=max\&auto=format\&n=-4O6W3x8MU7HVGrG\&q=85\&s=3170b02babbbbcf4dece4b0a76e63bc8)

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<div id="star-rating" style="cursor:pointer"></div>

<script type="text/javascript" src="//widgets.trustedshops.com/reviews/tsSticker/tsProductStickerSummary.js"></script>

<script type="text/javascript">
   var summaryBadge = new productStickerSummary();
   summaryBadge.showSummary({
      'tsId': 'IHRE TRUSTED SHOPS ID',

      {PR-DepVariations}
         {CAT-AdvData($DepVariations,99)}sku: ['~PR-ProdIndex~'{@PR-Data},{PR-DepVariationName1}'~PR-Number~'{/PR-DepVariationName1}{/@PR-Data}],{/CAT-AdvData($DepVariations,99)}
      {/PR-DepVariations}

      {!PR-DepVariations}
         'sku': '~PR-ProdIndex~',
      {/!PR-DepVariations}

      'element': '#star-rating',
      'starColor': '#FFDC0F',
      'starSize': '14px',
      'fontSize': '12px',
      'showRating': true,
      'scrollToReviews': false
   });
</script>
```

> [!WARNING]
>
> Ein `script`-Tag mit `src` muss geschlossen werden, bevor das nächste beginnt. Zwei Skriptblöcke ineinander zu schachteln führt dazu, dass der innere Block nie ausgeführt wird und die Sterne kommentarlos fehlen.

### Produktbewertungen bei Google

Trusted Shops überträgt die Produktbewertungen automatisch per JavaScript an Google. Von Ihrer Seite ist dafür nichts weiter zu tun, sobald die Produktbewertungen eingebunden sind.

### Shopbewertungen als Mikrodaten

Die Bewertungen Ihres Shops lassen sich zusätzlich als Mikrodaten an Suchmaschinen übergeben und erscheinen dort als Rich Snippets.

Wegweiser: Mikrodaten für Suchmaschinen und Rich Snippets

## Verwandte Themen

* Wegweiser: Mikrodaten für Suchmaschinen und Rich Snippets
* Wegweiser: [Bestelleingangsbestätigung](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/bestelleingangs-e-mail-an-den-shopbetreiber.md)


## Related topics

- [Merkzettel, Vergleich, Upload und externe Dienste](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md)
- [Styles für Module und Schnittstellen](https://dokumentation.websale.de/v8s/referenz/styles/module-und-schnittstellen.md)
- [Externe Dienste und Schnittstellen](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/externe-dienste-und-schnittstellen.md)
- [Texte und Meldungen](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md)
- [Strukturierte Daten und Rich Snippets](https://dokumentation.websale.de/v8s/seo/strukturierte-daten-rich-snippets.md)


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