IDS- (Integrierte Daten-Schnittstelle)

Ü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

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.

{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

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.

{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~.

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

<NotifyMessages-Txt>

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

</NotifyMessages-Txt>

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

{MSG-IDS_Notify}
   <p class="hinweis">~MSG-IDS_Notify~</p>
{/MSG-IDS_Notify}

Referenz: MSG- (Meldungen) · Abschnitt 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.

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.

​Die übergebene Lieferadresse anzeigen

​Die Felder

​Den Warenkorb zurückgeben

​Nicht in den Warenkorb übernommene Produktnummern

​Die Tags im Überblick

​Verwandte Themen

Die übergebene Lieferadresse anzeigen

Die Felder

Den Warenkorb zurückgeben

Nicht in den Warenkorb übernommene Produktnummern

Die Tags im Überblick

Verwandte Themen