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

# IDS- (Integrierte Daten-Schnittstelle)

> Die vom Handwerkersystem übergebene Lieferadresse im Template anzeigen und den Warenkorb an das Handwerkersystem zurückgeben.

Über die Integrierte Daten-Schnittstelle greift ein Handwerkersystem auf den Shop zu. Es schickt Produktnummern und optional eine Lieferadresse mit, und es holt den fertigen Warenkorb wieder ab. Die `IDS-`Tags machen diese beiden Richtungen im Template sichtbar: die übergebene Lieferadresse zum Anzeigen, und die Daten für die Rückgabe des Warenkorbs.

Alle Tags dieser Seite setzen voraus, dass die Schnittstelle für den Shop freigeschaltet ist. Ohne Freischaltung greifen die Klammerungen nicht und die Einzel-Tags bleiben leer.

Wegweiser: [Integrierte Daten-Schnittstelle](https://dokumentation.websale.de/v8s/externe-dienste/integrierte-daten-schnittstelle-ids.md)

## Die übergebene Lieferadresse anzeigen

Schickt das Handwerkersystem eine Lieferadresse mit, zeigt der Shop sie an und übergibt sie in den Bestellzusatzinformationen. Sie wird nur angezeigt und nicht als Lieferadresse des Shops verwendet. Kommt keine Adresse mit, gilt die im Shop hinterlegte Adresse.

`IDS-Delivery` ist die Klammerung um den ganzen Block. Sie greift, wenn überhaupt eine Adresse übergeben wurde.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{IDS-Delivery}
   <h2>Lieferadresse aus Ihrem System</h2>
   <address>
      {IDS-Delivery_Name1}~IDS-Delivery_Name1~<br>{/IDS-Delivery_Name1}
      {IDS-Delivery_Name2}~IDS-Delivery_Name2~<br>{/IDS-Delivery_Name2}
      {IDS-Delivery_Street}~IDS-Delivery_Street~<br>{/IDS-Delivery_Street}
      {IDS-Delivery_PCode}~IDS-Delivery_PCode~ {/IDS-Delivery_PCode}
      {IDS-Delivery_City}~IDS-Delivery_City~<br>{/IDS-Delivery_City}
      {IDS-Delivery_Country}~IDS-Delivery_Country~{/IDS-Delivery_Country}
   </address>
{/IDS-Delivery}
```

Jedes Feld hat seine eigene Klammerung, weil kaum eine Adresse alle Felder füllt. Ohne die Klammerung stehen sonst leere Zeilen und einzelne Trennzeichen in der Ausgabe.

### Die Felder

Die Schnittstelle definiert diese Suffixe:

| Suffix | Inhalt |
| - | - |
| `Name1` bis `Name4` | die vier Namenszeilen |
| `Street` | Straße und Hausnummer |
| `PCode` | Postleitzahl |
| `City` | Ort |
| `Country` | Land |
| `ILN` | die Internationale Lokationsnummer |
| `Contact` | Ansprechpartner |
| `Phone` | Telefonnummer |
| `Fax` | Faxnummer |
| `Email` | E-Mail-Adresse |

> [!WARNING]
>
> Schreiben Sie das Suffix genau so, wie es die IDS-Schnittstellenbeschreibung vorgibt. Das Shopsystem baut aus dem Suffix den Namen des gesuchten Elements in den übergebenen Daten. Ein abweichend geschriebenes Suffix findet nichts, und die Klammerung greift dann einfach nicht, ohne dass ein Fehler erkennbar wäre.

Das Shopsystem prüft nicht gegen die obige Liste. Es sucht nach jedem Suffix, das Sie angeben. Erweitert die Schnittstelle ihren Adressblock um ein weiteres Feld, können Sie es sofort mit `IDS-Delivery_<Feldname>` ausgeben, ohne auf eine neue Shopversion zu warten.

## Den Warenkorb zurückgeben

Für den Rückweg zum Handwerkersystem gibt es zwei Tags. Sie liefern die beiden Angaben, die das abholende System braucht.

| Tag | Liefert |
| - | - |
| `IDS-SendBasketHookURL` | die Adresse, an die der Warenkorb zurückgegeben wird |
| `IDS-SendBasketPayloadJSEncoded` | die Warenkorbdaten, aufbereitet für die Einbettung in JavaScript |

Beide sind zugleich Klammerungen und greifen, wenn die Schnittstelle aktiv ist und der jeweilige Wert vorliegt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{IDS-SendBasketHookURL}
   <form action="~IDS-SendBasketHookURL~" method="post" id="ids_rueckgabe">
      ...
   </form>
{/IDS-SendBasketHookURL}
```

Die Benennung der Rückgabe und ihr Ablauf gehören in den Wegweiser, hier steht nur, was die Tags liefern.

Den Link auf die Shopseite, die die Rückgabe auslöst, liefert `WS-IDSSentBasketLink` aus der `WS-`Gruppe. Es gehört zum selben Ablauf, steht aber nicht unter diesem Präfix.

## Nicht in den Warenkorb übernommene Produktnummern

Schickt das Handwerkersystem Produktnummern, die der Shop nicht kennt, nennt er sie in einer Meldung. Der Platzhalter dafür ist `~IDS-PRNumbers~`.

> [!WARNING]
>
> `~IDS-PRNumbers~` ist kein Template-Tag. Der Platzhalter steht im Text der Meldung, die Sie in der Shopkonfiguration `shop.config` im Abschnitt `<NotifyMessages-Txt>` unter `IDSNoBasketInput` hinterlegen. Beim Ausgeben der Meldung ersetzt das Shopsystem ihn durch die betroffenen Produktnummern. In ein Template geschrieben bewirkt er nichts.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<NotifyMessages-Txt>

   IDSNoBasketInput = Folgende Produktnummern sind unbekannt: ~IDS-PRNumbers~

</NotifyMessages-Txt>
```

Im Template geben Sie die fertige Meldung mit `MSG-IDS_Notify` aus.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{MSG-IDS_Notify}
   <p class="hinweis">~MSG-IDS_Notify~</p>
{/MSG-IDS_Notify}
```

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

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `IDS-Delivery` | – | ja | ja | – |
| `IDS-Delivery_<Suffix>` | ja | ja | ja | – |
| `IDS-SendBasketHookURL` | ja | ja | ja | – |
| `IDS-SendBasketPayloadJSEncoded` | ja | ja | ja | – |

Die Tags sind auf allen Templates zulässig. Die Lieferadresse steht naturgemäß erst ab dem Bestellablauf zur Verfügung, üblicherweise auf der Bestellübersichtsseite `ws_place_order.htm`.

> [!WARNING]
>
> `IDS-Delivery` ohne Suffix arbeitet ausschließlich als Klammerung. Als Einzel-Tag geschrieben gibt es nichts aus, auch wenn eine Adresse vorliegt. Die einzelnen Werte holen Sie immer über die Suffix-Schreibweise.

## Verwandte Themen

* Wegweiser: [Integrierte Daten-Schnittstelle](https://dokumentation.websale.de/v8s/externe-dienste/integrierte-daten-schnittstelle-ids.md)
* Referenz: [MSG- (Meldungen)](https://dokumentation.websale.de/v8s/referenz/tags/msg-meldungen.md)
* Referenz: [WS- (Allgemeine Tags)](https://dokumentation.websale.de/v8s/referenz/tags/ws/shop-seite-und-technik.md)


## Related topics

- [Integrierte Daten-Schnittstelle (IDS)](https://dokumentation.websale.de/v8s/externe-dienste/integrierte-daten-schnittstelle-ids.md)
- [WWS-Infodatenschnittstelle verwenden](https://dokumentation.websale.de/v8s/externe-dienste/wws-infodatenschnittstelle.md)
- [Merkzettel, Vergleich, Upload und externe Dienste](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md)
- [Externe Dienste und Schnittstellen](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/externe-dienste-und-schnittstellen.md)
- [Externe Dienste: Übersicht](https://dokumentation.websale.de/v8s/externe-dienste/externe-dienste.md)


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