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

# WS-Adressdatenänderungen

> Export von geänderten Kundenadressen aus dem Shop, auch ohne Bestellung, mit den Sektionen und Parametern des Datensatzes.

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.

| Eigenschaft | Wert |
| - | - |
| Info | Format und Inhalt der Exportdaten für geänderte Kundenadressen, auch ohne Bestellung |
| Übertragungsrichtung | WEBSALE Shop → ERP/Warenwirtschaft (Data-from-Shop) |
| Übertragungsart | SOAP |
| Dateiformate | XML |
| Benötigte Schnittstelle | [SOAP-from-Shop](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/soap-from-shop.md) für das Auslösen der Übertragung |

## 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](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/soap-from-shop.md), das ist der empfohlene Weg.

Lässt sich in Ihrem System kein SOAP umsetzen, können Sie stattdessen den [WS-OrderManager](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/wsom-from-shop.md) 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](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten.md) 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

### Header

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

| Parameter | Pflichtfeld | Max. Länge | Bemerkung |
| - | - | - | - |
| `Content-Type` | x | 32 | Der Wert ist immer `Customer Data`. Daran erkennt das empfangende System, dass es sich um eine Adressdatenänderung handelt. |

### ID

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

| Parameter | Pflichtfeld | Max. Länge | Bemerkung |
| - | - | - | - |
| `MallID` | x | | Die MallID des Shops. Produktivshops liegen in der Mall `websale`, Testshops in der Mall `test` und Partnershops in der Mall `partner`. |
| `ShopID` | x | | Eindeutige ID Ihres Shops |
| `OrderNumber` | x | 32 | Eindeutige Auftragsnummer, verwendbar zur eindeutigen Referenzierung |
| `Date` | x | 8 | Datum im Format TT.MM.JJ, beispielsweise 29.01.10 |
| `Time` | x | 8 | Uhrzeit im Format HH:MM:SS, beispielsweise 19:02:59 |

### AccountData

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

| Parameter | Pflichtfeld | Zulässige Werte | Bemerkung |
| - | - | - | - |
| `changed` | x | `yes`, `no` | Zeigt an, ob die Kundenkontendaten geändert wurden |
| `deleted` | x | `yes`, `no` | Zeigt an, ob das Kundenkonto durch den Kunden gelöscht wurde |
| `UserIndex` | x | Ganzzahl | Interner Kundenindex der Shop-Kundendatenbank |
| `CustomerID` | x | | Kundennummer |
| `Email` | x | | E-Mail-Adresse |
| `EmailVerification` | x | `verified`, `unverified`, `undef` | Zeigt an, ob die E-Mail-Adresse bestätigt ist |
| `SubShop` | | max. 12 Zeichen | Hauptsubshop |
| `RegistrationCode` | | max. 128 Zeichen | Registrierungscode oder Freischaltcode. Ein Shop kann so eingerichtet werden, dass sich nur Kunden registrieren können, die einen solchen Code kennen. |

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

| Sektion | Vorhanden |
| - | - |
| `CustomerAddress` (Rechnungsadresse) | stets |
| `DeliveryAddress` (abweichende Lieferadresse) | nur bei einer abweichenden Lieferadresse, alle Parameter sind optional |
| `CreditCard` (Kreditkartendaten) | nur bei Kreditkartenzahlung |
| `DebitNote` (Bankdaten) | nur bei Lastschriftzahlung |

## Verwandte Themen

* [SOAP-from-Shop](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/soap-from-shop.md)
* [WSOM-from-Shop](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/wsom-from-shop.md)
* [WS-Bestelldaten](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten.md)


## Related topics

- [WS-Bestelldaten](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten.md)
- [Kundendaten](https://dokumentation.websale.de/v8s/schnittstellen/kundendaten.md)
- [WS-SFTP-Kunden PRO](https://dokumentation.websale.de/v8s/schnittstellen/kundendaten/ws-sftp-kunden-pro.md)
- [Account-API](https://dokumentation.websale.de/v8s/schnittstellen/kundendaten/account-api.md)
- [SOAP-from-Shop](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/soap-from-shop.md)


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