WS-Bestelldaten - WEBSALE Dokumentation

Nachdem ein Kunde im Shop eingekauft hat, lassen sich alle Informationen zu seiner Bestellung abholen. Der Export wird durch den SOAP-Request GetOrders angestoßen. Diese Seite beschreibt, wie die Daten aufgebaut sind und welche Sektionen es gibt.

Eigenschaft	Wert
Info	Format und Inhalt der Bestelldaten, die vom Shop abgeholt werden
Übertragungsrichtung	WEBSALE Shop → ERP/Warenwirtschaft (Data-from-Shop)
Übertragungsart	SOAP
Dateiformate	CSV, XML, PRD
Benötigte Schnittstelle	SOAP-from-Shop für das Auslösen der Übertragung

Inhalt der Bestelldaten

Die Bestelldaten fassen unter anderem zusammen:

die bestellten Produkte,
Bestellmenge und Maße,
Einzelpreise, Rabatte und Gesamtbetrag,
Rechnungs- und Lieferadressen,
Zahlungs- und Versandarten samt Zusatzkosten,
alle zusätzlichen kunden-, länder- oder produktspezifischen Informationen.

Übertragung

Die Bestelldaten 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.

Das Format kann jederzeit um neue Parameter und Sektionen erweitert werden. Schreiben Sie Ihren Parser deshalb so, dass er unbekannte Sektionen und Parameter ignoriert und sich nicht auf eine bestimmte Reihenfolge verlässt.

Die Sektionen im Überblick

Eine Bestellung besteht aus mehreren Sektionen. Einige sind immer vorhanden, andere nur dann, wenn die zugehörige Funktion im Shop genutzt wurde oder der Besteller eine bestimmte Zahlungsart gewählt hat. Die vollständige Beschreibung aller Parameter ist auf zwei Seiten verteilt.

Kopfdaten und Adressen

Sektion	Inhalt
`Header`	Kennung des Datenformats, immer vorhanden
`ID`	Kopfdaten der Bestellung wie Shop, Auftragsnummer, Datum und Zeit, immer vorhanden
`PromotionAgreement`	Zustimmung zur Werbung und zur Adressweitergabe
`CustomerAddress`	Rechnungsadresse, immer vorhanden
`DeliveryAddress`	Abweichende Lieferadresse
`DeliveryAddresses`	Mehrere Lieferadressen bei MultiDelivery
`DeliverySelections`	Zuordnung der Versandart bei MultiDelivererSelection
`CustomerComment`	Kommentar des Bestellers, bis zu 1000 Zeichen
`OrderSpecialInput`	Weiteres Textfeld des Bestellers, bis zu 32000 Zeichen

Positionen und Zahlung

Sektion	Inhalt
`Order`	Globale Daten der Bestellung wie Summen, Versand- und Zahlungsart, immer vorhanden
`OrderList/Item`	Die bestellten Produkte, maximal 500 Positionen, immer vorhanden
`Vouchers`	Gutscheine bei der Funktion MultiVoucher
`CreditPass`	Ergebnis der Bonitätsprüfung
`TaxIDOnlineCheck`	Ergebnis der Onlineprüfung ausländischer Umsatzsteuer-IDs
`ClimateNeutral`	Klimaneutrale Produktion für den gesamten Warenkorb
`PaymentRuleInput`	Zusätzliche Angaben des Bestellers zur Zahlungsart
`ABTests`	Aktive AB-Tests, bis zu 10 Untersektionen
`PrimeShopping`	Prime-Pakete im Kundenkonto des Bestellers
Zahlungsarten	Je eine Sektion pro Zahlungsart, beispielsweise `CreditCard`, `DebitNote`, `PayPalCheckout`, `KlarnaCheckout` oder `Billie`

Verwandte Themen

⌘I