Zum Hauptinhalt springen
Die Adressdaten eines Kunden werden normalerweise zusammen mit den Bestelldaten an das ERP- oder Warenwirtschaftssystem übertragen. Für viele Anbindungen reicht das aus. Diese Schnittstelle brauchen Sie dann, wenn Sie zusätzlich auch die Änderungen abholen wollen, die ein Kunde im Shop vornimmt, ohne eine Bestellung aufzugeben.

​
Wann eine Adressdatenänderung entsteht

Eine Adressdatenänderung wird übermittelt, wenn
  • sich ein Kunde neu im Shop anmeldet. In diesem Fall kann der Datensatz unvollständig oder sogar leer sein, wenn die Änderung abgefragt wird, bevor der Kunde seine Daten vollständig ausgefüllt hat.
  • ein Kunde seine Adress- oder Bankdaten im Kundenkonto ändert und nicht im Bestellprozess.
  • ein Kundendatensatz über den Import angelegt wird. Hier dient die Adressdatenänderung dazu, dem importierenden System den UserIndex des neu angelegten Datensatzes zu übermitteln.
Eine Adressdatenänderung wird nicht übermittelt, wenn
  • ein Kundendatensatz über den Newsletter angelegt wird.
  • ein bereits vorhandener Kundendatensatz über den Import verändert wird.
  • ein Kundendatensatz im Online-Servicebereich angelegt oder verändert wird.
Adressdatenänderungen ohne Kundennummer lassen sich vom Export ausschließen. Diese Einstellung nimmt die WEBSALE Systemadministration vor, sprechen Sie dazu Ihren WEBSALE-Ansprechpartner an.

​
Übertragung

Die Adressdaten werden per SOAP übertragen. Angestoßen wird die Übertragung über SOAP-from-Shop, das ist der empfohlene Weg. Lässt sich in Ihrem System kein SOAP umsetzen, können Sie stattdessen den WS-OrderManager verwenden. Dabei handelt es sich um die Vorgängerversion, die für neue Anbindungen nicht mehr empfohlen wird.

​
Aufbau des Datensatzes

Der grundsätzliche Aufbau entspricht dem der Bestelldaten, wie er unter WS-Bestelldaten beschrieben ist. Statt den gesamten Aufbau zu wiederholen, beschreibt diese Seite nur die Unterschiede.
  • Die Sektionen Order und OrderList fehlen, da sie Daten enthalten, die nur bei einer Bestellung vorliegen.
  • Es gibt die zusätzliche Sektion AccountData mit den Kundenkontendaten.
  • Die Sektionen mit Adressdaten (CustomerAddress, DeliveryAddress, CreditCard, DebitNote, AccountData) enthalten die zusätzlichen Parameter changed und deleted.
  • Bei den Bestelldaten wird nur die jeweils benutzte Lieferadresse oder Bankverbindung geliefert, bei Adressdatenänderungen dagegen alle Lieferadressen und alle Bankverbindungen.
  • Lesbare, sprachabhängige Parameter mit den Präfixen _Dname und _Dvalue werden nicht übergeben.
Die Parameter changed und deleted haben den Wert yes, wenn sich in der jeweiligen Sektion Daten geändert haben beziehungsweise wenn der komplette Datensatz gelöscht wurde. Fehlen die Parameter oder haben sie den Wert no, sind die Daten unverändert und nicht gelöscht.

​
Die Sektionen im Einzelnen

Diese Sektion ist stets vorhanden und wie bei den Bestelldaten aufgebaut. Ein Parameter kommt hinzu.

​
ID

Diese Sektion ist stets vorhanden. Es werden nur die folgenden Parameter unterstützt.

​
AccountData

Diese Sektion ist stets vorhanden und kommt nur bei Adressdatenänderungen vor.

​
PromotionAgreement

Diese Sektion ist optional und nur dann vorhanden, wenn der Käufer der Werbung zugestimmt oder sie abgelehnt hat. Sie ist wie bei den Bestelldaten aufgebaut und dort beschrieben.

​
CustomerAddress, DeliveryAddress, CreditCard und DebitNote

Diese Sektionen sind wie bei den Bestelldaten aufgebaut. In jeder von ihnen kommen die beiden Parameter changed und deleted hinzu.

​
Verwandte Themen