> ## 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. # Daten mit externen Systemen austauschen > Daten asynchron an fremde Systeme senden (ASSE), Produktdaten synchron von dort holen (RPDE) und Preise im technischen Format übergeben. Neben den Inhalten, die von außen in den Shop kommen, gibt es den umgekehrten Weg und einen Sonderfall dazwischen. Diese Seite behandelt beide Richtungen und das Format, in dem Zahlen die Systemgrenze überqueren sollten. | Aufgabe | Werkzeug | Wartet der Shop? | | - | - | - | | Daten an ein fremdes System senden | ASSE | nein | | Produktdaten von einem fremden System holen | RPDE | ja | | Preise und Mengen maschinenlesbar ausgeben | technische Tags | entfällt | ## Daten senden: ASSE Asynchronous-Server-Side-Events, kurz ASSE, übermittelt beliebige Daten aus dem Shop per HTTPS an fremde Systeme. Das Format ist frei, üblich sind JSON und XML. Typische Einsätze sind Bestelldaten, Newsletter-Anmeldungen und Tracking-Ereignisse. Entscheidend ist das Wort asynchron: Die Daten gehen vom Shop-Server zum Empfänger, nicht über den Browser des Besuchers. Der Seitenaufbau wartet nicht auf die Antwort. Antwortet die Gegenstelle gar nicht, merkt der Besucher davon nichts. | Eigenschaft | Möglichkeiten | | - | - | | Ziel | eine oder mehrere Adressen, ausschließlich über HTTPS | | Übertragungsart | POST, GET oder PUT | | Datenformat | frei, üblich sind JSON und XML | | Zusätzliche Angaben | eigener Parametername und zusätzliche Angaben im HTTP-Header | | Fehlerbehandlung | mehrere Zustellversuche, dazu eine Zeitspanne für die Antwort | > [!WARNING] > > Fehler bei der Übermittlung sind weder im Shop noch im Online-Servicebereich sichtbar, gerade weil die Übertragung asynchron läuft. Scheitern alle Zustellversuche, landen die Daten in einem Fehlerverzeichnis, und die WEBSALE-Systemüberwachung meldet sich bei Ihrem Shop-Administrator. ### Schritt 1: Freischaltung ASSE muss freigeschaltet werden, global oder je Subshop. Wenden Sie sich an Ihren WEBSALE Ansprechpartner. ### Schritt 2: Die Übertragung konfigurieren Jede Übertragung bekommt einen eigenen `<+Entry>` im Abschnitt `` der `shop.config`. ```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} <+Entry> ID = shopconfirm Endpoint = https://api.shop.de/shop-certification/v2/order/log Type = POST ContentType = application/json ServiceCategory = OrderNotification ``` | Parameter | Bedeutung | | - | - | | `ID` | eindeutige Bezeichnung, mit der die Übertragung im Template ausgelöst wird | | `Endpoint` | Adresse des Empfängers, WEBSALE-Tags sind hier erlaubt | | `Type` | `POST`, `GET` oder `PUT` | | `ContentType` | Format der gesendeten Daten, beispielsweise `application/json` | | `ServiceCategory` | `Tracking` oder `OrderNotification`, dahinter stehen die von WEBSALE vorgegebenen Werte für Zeitspanne und Zustellversuche | Den Wert für `ContentType` bestimmt der Empfänger. Tragen Sie genau das ein, was dessen Dokumentation verlangt. ### Wann eine Zustellung als erfolgreich gilt Ohne weitere Angabe gilt jede Antwort als Erfolg. Über `` legen Sie fest, was wirklich zählt. Mehrere Bedingungen werden mit UND verknüpft, es müssen also alle erfüllt sein. ```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} <+Entry> ... <+ConditionGroup> <+Condition> Proof = HTTP-StatusCode DataSelector = Type = value Value = 200 ``` | Wert für `Proof` | Geprüft wird | | - | - | | `HTTP-StatusCode` | der Statuscode der Antwort, beispielsweise `200` | | `ContentType` | das Format der Antwort | | `ResponsePlain` | der Antworttext selbst, beispielsweise `OK` | | `ResponseJSON` | ob die Antwort überhaupt als JSON lesbar ist | | `ResponseJSONData` | ein bestimmtes Datenfeld der Antwort, ausgewählt über `DataSelector` | Ist die Bedingung erfüllt, gilt die Zustellung als erledigt und es folgen keine weiteren Versuche. ### Zusätzliche Angaben im HTTP-Header ```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} <+Entry> ... <+HttpHeader> Name = Value = ``` Referenz: [Abschnitt ASSE](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/externe-dienste-und-schnittstellen.md#asse) ### Schritt 3: Zugangsdaten sicher ablegen Gehört ein Schlüssel oder Passwort in die Daten, schreiben Sie es nicht ins Template. Im Abschnitt `` abgelegt, steht es nicht im Klartext in den Bearbeitungs-Templates auf dem Server. ```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} MyApiKey = abcdef12345 ``` Im Template holen Sie den Wert über das zugehörige Tag, hier `~FMSG-MyApiKey~`. Referenz: [Abschnitt FreeMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#freemessages-txt) Wegweiser: [Freie Standardtexte definieren](https://dokumentation.websale.de/v8s/einstellungen/standardtexte.md#freie-standardtexte-definieren) ### Schritt 4: Die Daten zusammenstellen und senden Ausgelöst wird die Übertragung mit `ASSE-Fire()`. Das Tag nimmt zwei Angaben: die Kennung aus der Konfiguration und die zu sendenden Daten. Das folgende Beispiel stellt auf der Bestelleingangsbestätigung die Bestelldaten zusammen und sendet sie. ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} ~DC-FPFireJSON_set({"apiKey": "$FMSG-MyApiKey$", "email": "$A-E-Mail$", )~ ~DC-FPFireJSON_append("orderId": "$WS-OrderID$", "productItemIds": )~ {BASKET-PR-Data} ~DC-Int1_set(0)~ ~DC-FPFireJSON_append([ {@BASKET-PR-Data} $DC-Int1_add(1)${!DC-Int1(1)},{/!DC-Int1(1)}"$BASKET-PR-Number$" {/@BASKET-PR-Data} ]})~ {/BASKET-PR-Data} ~ASSE-Fire(shopconfirm,$WS-DisableXSSProtectionOnce$$DC-FPFireJSON$)~ ``` > [!WARNING] > > Innerhalb eines Tag-Arguments werden andere Tags mit Dollar-Zeichen geschrieben, nicht mit Tilde. `$FMSG-MyApiKey$` gehört also in den Aufbau der Daten, `~FMSG-MyApiKey~` würde dort nicht ersetzt. Der Zähler in der Schleife setzt das Komma zwischen den Einträgen, aber nicht vor dem ersten. Heraus kommt: ```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} { "apiKey": "abcdef12345", "email": "kunde@example.de", "orderId": "20250042", "productItemIds": ["4711", "4712"] } ``` Statt die Daten mit `DC-FPX_append` zusammenzusetzen, lassen sie sich auch über die JSON-Schnittstelle erzeugen. Bei verschachtelten Daten ist das der übersichtlichere Weg. ### Fehler beim Auslösen erkennen Konfigurationsfehler beim Erzeugen des Ereignisses meldet ein eigenes Tag. Es gehört während der Einrichtung unter den Code, der die Übertragung auslöst. ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} {ASSE-LastErrorCode} Errorcode des aufgetretenen Fehlers: ~ASSE-LastErrorCode~ {/ASSE-LastErrorCode} ``` Zum Prüfen der gesendeten Daten eignen sich Dienste, die eine Adresse zum Empfangen bereitstellen und das Empfangene anzeigen, beispielsweise webhook.site. Die Antwort der echten Gegenstelle prüfen Sie mit einem Werkzeug wie reqbin.com. Referenz: [ASSE-Fire()](https://dokumentation.websale.de/v8s/referenz/tags/asse.md#asse-fire) · [ASSE-LastErrorCode](https://dokumentation.websale.de/v8s/referenz/tags/asse.md#asse-lasterrorcode) · Frei verwendbare DesignControl-Tags [DC-FPX](https://dokumentation.websale.de/v8s/referenz/tags/dc/parameter.md#die-tags-im-uberblick) · [DC-FPX\_set()](https://dokumentation.websale.de/v8s/referenz/tags/dc/parameter.md#die-tags-im-uberblick) · [DC-FPX\_append](https://dokumentation.websale.de/v8s/referenz/tags/dc/parameter.md#die-tags-im-uberblick) Anwendungsbeispiele: ASSE ## Produktdaten holen: RPDE RPDE steht für RemoteProductDataEnrichment. Damit fragt der Shop technische Produktdatenfelder während des Seitenaufbaus bei einem fremden System ab und verwendet sie sofort. Vorhandene Felder lassen sich dabei anreichern oder überschreiben. Die Daten liegen nicht bei WEBSALE, sondern kommen über eine gesicherte Verbindung von Server zu Server. Typische Fälle sind tagesaktuelle Preise oder Werte, die sich erst aus der Eingabe des Kunden ergeben. > [!WARNING] > > Für RPDE gelten enge Grenzen: > > * Je angezeigter Seite ist genau eine Abfrage möglich, auch auf Suchergebnislisten. > * Das Produkt muss vollständig aufgelöst sein, alle abhängigen Varianten müssen also gewählt sein. > * Bei Set-Produkten steht die Funktion nur für das Oberprodukt zur Verfügung, und dieses muss in den Produktdaten entsprechend gekennzeichnet sein. > * Zusammen mit dem Cookiewarenkorb oder dem Bestellgenerator ist RPDE nicht nutzbar. > * Neben anderen externen Dienstleistern wie W2P kann die Funktion nicht gewährleistet werden. Die Übergabe an das fremde System stellen Sie im Template frei zusammen. Die Antwort wird im JSON-Format erwartet und über die JSON-Schnittstelle gelesen. ### Beispiel: Labelprint24 Labelprint24 druckt Verpackungen nach Maß. Der Kunde gibt Länge, Breite und Höhe ein, der Shop schickt diese Werte zusammen mit den Basisdaten des Produkts hin, und Labelprint24 prüft, ob sich das so fertigen lässt, und liefert Preis und Gewicht zurück. Beides landet in den Produktdaten. Ein Vertrag mit Labelprint24 ist Voraussetzung, und die Anbindung muss von WEBSALE eingerichtet werden. #### Schritt 1: Produktdaten kennzeichnen Die betroffenen Produkte werden in den Produktdaten gekennzeichnet. #### Schritt 2: Fehlermeldung ergänzen ```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} ... RPDE_Labelprint-BasketError = Das Produkt konnte nicht in den Warenkorb gelegt werden. Bitte versuchen Sie es erneut oder kontaktieren Sie uns. ... ``` #### Schritt 3: Template zuweisen ```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} ... RPDE_Labelprint = extern_labelprint.json ... ``` #### Schritt 4: Das Übergabe-Template anlegen Legen Sie das Template unter dem zugewiesenen Namen in Ihrem Template-Verzeichnis an. ```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} { "action": "get_product_price", "token": "~WS-RPDE_Labelprint_token~", "language": "de-AT", "currency": "~WS-Currency~", "product": { "id": "~PR-Index~", "deeplink": "~PR-SetLink~", "height": ~PR-RPDE_Labelprint_height(1)~, "width": ~PR-RPDE_Labelprint_width(1)~, "length": ~PR-RPDE_Labelprint_length(1)~, "quantity": ~PR-Quantity~ } } ``` > [!WARNING] > > Welche Angaben das Template enthalten muss, bestimmt Labelprint24. Stimmen Sie den Inhalt dort ab, bevor Sie testen. #### Schritt 5: Eingabefelder auf der Produktdetailansicht ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} RPDE: ~PR-RPDE~
{PR-RPDE_Labelprint_width_input} Breite: Länge: Höhe: {PR-RPDE_OK}Abfrage erfolgreich{/PR-RPDE_OK} {!PR-RPDE_OK}Abfrage nicht erfolgreich{/!PR-RPDE_OK} {/PR-RPDE_Labelprint_width_input} ``` Empfehlenswert ist ein Nachladen per AJAX beim Verlassen des Feldes, wie im Beispiel über `onBlur`. Sonst erfährt der Kunde erst nach dem Absenden, ob seine Maße herstellbar sind. Länge, Breite und Höhe lassen sich nicht vorbelegen, und der Shop prüft sie serverseitig nicht. Die Prüfung übernimmt allein das fremde System. #### Schritt 6: Anzeige im Warenkorb ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} RPDE: ~BASKET-PR-RPDE~
{BASKET-PR-RPDE_Labelprint_width_input} Breite: ~BASKET-PR-RPDE_Labelprint_width~ Länge: ~BASKET-PR-RPDE_Labelprint_length~ Höhe: ~BASKET-PR-RPDE_Labelprint_height~ {/BASKET-PR-RPDE_Labelprint_width_input} ``` #### Fehler suchen Meldungen der Schnittstelle geben Sie zu Prüfzwecken über `MSG-InternalErrorMessage` aus. Für den Blick auf die tatsächlich gesendeten und empfangenen Daten gibt es zwei weitere Tags. Referenz: [MSG-InternalErrorMessage](https://dokumentation.websale.de/v8s/referenz/tags/msg-meldungen.md#weitere-meldungen) · [PR-RPDE](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md) · [PR-RPDE\_OK](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md) · [PR-RPDE\_Data](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md) · [BASKET-PR-RPDE\_Data](https://dokumentation.websale.de/v8s/referenz/tags/basket/besondere-produktarten-im-warenkorb.md#etiketten-und-versanddaten) · [WS-RPDE\_DebugInfo\_RequestData](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md#die-tags-im-uberblick) · [WS-RPDE\_DebugInfo\_ResponseData](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md#labelprint24) Referenz: WS-RPDE\_Labelprint\_token · PR-RPDE\_Labelprint\_width · PR-RPDE\_Labelprint\_length · PR-RPDE\_Labelprint\_height ## Preise maschinenlesbar übergeben Preise, die im Shop stehen, sind für Menschen formatiert: mit Tausenderpunkt, Komma und Währungszeichen. Ein fremdes System kann damit nichts anfangen. Für die Übergabe gibt es deshalb zu allen Beträgen und Mengen ein technisches Gegenstück. Ohne zusätzliche Angabe werden diese Tags ohne Tausendertrennzeichen, mit Punkt als Dezimaltrenner und mit zwei Nachkommastellen ausgegeben. | Tag | Inhalt | | - | - | | `BASKET-PR-TechnicalPrice` | Preis je Produkt einer Warenkorbposition | | `BASKET-PR-TechnicalSum` | Gesamtsumme einer Warenkorbposition | | `BASKET-PR-TechnicalSetPrice` | Einzelpreis eines Sets im Warenkorb | | `BASKET-PR-TechnicalSetSum` | Gesamtpreis eines Sets im Warenkorb | | `BASKET-PR-TechnicalQuantity` | Menge einer Warenkorbposition | | `BASKET-TechnicalValueOfGoods` | reiner Warenwert ohne Rabatte | | `BASKET-TechnicalSubTotalSum` | Warenwert mit Rabatten, brutto oder netto wie im Shop definiert | | `BASKET-TechnicalSubTotalGross` | Bruttowarenwert mit Rabatten, bei Nettopreisen | | `BASKET-TechnicalSubTotalNet` | Nettowarenwert mit Rabatten, bei Bruttopreisen | | `BASKET-TechnicalSubTotalVAT` | Mehrwertsteuer des Warenwerts | | `BASKET-TechnicalDeliveryCost` | Versandkosten | | `BASKET-TechnicalPaymentCost` | Gebühr der gewählten Zahlungsart | | `BASKET-TechnicalOrderTotal` | Gesamtsumme | ### Das Format anpassen Alle Tags nehmen bis zu drei durch Komma getrennte Angaben: | Stelle | Bedeutung | Vorgabe | | - | - | - | | 1 | Dezimaltrennzeichen | `.` | | 2 | Anzahl der Nachkommastellen | `2` | | 3 | Multiplikator | `1` | Bei einem Wert von 12,99 ergibt sich: | Schreibweise | Ergebnis | | - | - | | `~BASKET-TechnicalOrderTotal~` | `12.99` | | `~BASKET-TechnicalOrderTotal(\,)~` | `12,99` | | `~BASKET-TechnicalOrderTotal(#)~` | `12#99` | | `~BASKET-TechnicalOrderTotal(,4)~` | `12.9900` | | `~BASKET-TechnicalOrderTotal(,,2)~` | `25.98` | | `~BASKET-TechnicalOrderTotal(,0,100)~` | `1299` | | `~BASKET-TechnicalOrderTotal(\,,2,100)~` | `1299,00` | > [!WARNING] > > Ein Komma als Dezimaltrennzeichen muss als `\,` geschrieben werden. Unmaskiert trennt es die Angaben voneinander, und der Shop liest es als leere erste Angabe. Eine leere Stelle bedeutet "Vorgabe beibehalten". `(,0,100)` lässt also den Dezimaltrenner unverändert, setzt null Nachkommastellen und multipliziert mit 100. Das ist die übliche Form für Systeme, die Beträge in Cent erwarten. Wegweiser: [Warenkorb anzeigen](https://dokumentation.websale.de/v8s/warenkorb/warenkorb-anzeigen-loeschen.md) ## Verwandte Themen * Wegweiser: [Externe Inhalte einbinden](https://dokumentation.websale.de/v8s/externe-dienste/externe-inhalte-einbinden.md) * Wegweiser: [JSON-Schnittstelle](https://dokumentation.websale.de/v8s/externe-dienste/json-schnittstelle.md) * Wegweiser: [Tracking einbinden](https://dokumentation.websale.de/v8s/funktionen-zur-shop-optimierung/tracking-einbinden.md) * Anwendungsbeispiele: ASSE ## Related topics - [ASSE- (Asynchrone Datenübermittlung)](https://dokumentation.websale.de/v8s/referenz/tags/asse.md) - [Externe Dienste: Übersicht](https://dokumentation.websale.de/v8s/externe-dienste/externe-dienste.md) - [Integration von Inxmail](https://dokumentation.websale.de/v8s/externe-dienste/inxmail.md) - [Externe Inhalte einbinden](https://dokumentation.websale.de/v8s/externe-dienste/externe-inhalte-einbinden.md) - [JSON-Schnittstelle](https://dokumentation.websale.de/v8s/externe-dienste/json-schnittstelle.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.