Übersicht Bestelldaten
Diese Übersicht zeigt die Parameter und Werte, die bei einer Standard-Bestellung erzeugt werden und an das angeschlossene Warenwirtschaftssystem übergeben werden. Diese Bestelldaten sind auch im Online-Servicebereich im Dienst "Bestellungen" unter "Details > Download der Bestelldaten" einzusehen.
Zu einigen Parametern werden gleichnamige Parameter mit dem Suffix "_DName" (im Shop angezeigter Name des Eingabefeldes, sprachabhängig vom Subshop) und Parameter mit dem Suffix "_DValue" (im Shop angezeigter Wert) ausgegeben, die als zusätzliche Information dienen.
|
Hinweis |
|
Die tatsächlichen Bestelldaten hängen von der Komplexität und dem Funktionsumfang Ihres WEBSALE-Shops ab. Benötigen Sie die komplette technische Dokumentation der Bestelldaten, so finden Sie diese unter |
Sektion "ID"
Kopfdaten einer Bestellung. Diese Sektion ist immer vorhanden.
Parameter |
Muss-Feld |
Bemerkung |
ShopID |
X |
Eine eindeutige ID Ihres Shops. |
SubShopID |
X |
Eine eindeutige ID Ihres Subshops. Jeder Shop besitzt mindestens 1 Subshop. |
Referer |
|
Aufruf-Referenz, woher WEBSALE aufgerufen wurde |
Subreferer |
|
Sub-Aufruf-Referenz, woher WEBSALE aufgerufen wurde |
OrderNumber |
X |
Eindeutige Auftragsnummer. Kann zur eindeutigen Referenzierung verwendet werden. |
Date |
X |
Datum der Bestellung im Format TT.MM.YY z. B. 29.01.10 |
Time |
X |
Uhrzeit der Bestellung im Format HH:MM:SS z. B. 19:02:59 |
SessionID |
X |
Die im Shop verwendete, eindeutige SessionID. |
ExpressCheckout |
|
Bestellung wurde mittels Express Checkout durchgeführt |
ExpressCheckoutType |
|
Angabe, mit welchem Express-Checkout-Dienst die Bestellung durchgeführt wurde, z. B. PayPal, Klarna. |
Sektion "CustomerAddress"
Anzeige der Rechnungsadresse. Diese Sektion ist immer vorhanden. Alle Parameter der Rechnungsadresse sind jedoch optional.
Parameter |
Muss-Feld |
Bemerkung |
||||
Number |
|
Kundennummer |
||||
Salutation |
|
Sprachabhängige Anrede z. B. "Frau" |
||||
CompleteSalutation |
|
Komplette, länderabhängige Anrede z. B. "Sehr geehrter Herr Dr. Meier" |
||||
Company |
|
Firmenname |
||||
Department |
|
Abteilung |
||||
Title |
|
Sprachabhängiger Titel z. B. "Professor" |
||||
FirstName |
|
Vorname |
||||
LastName |
|
Nachname |
||||
Street1 |
|
Straße und Hausnummer |
||||
Street2 |
|
Separate Hausnummer, wenn diese nicht in Street1 aufgenommen wird |
||||
ZIP |
|
PLZ |
||||
City |
|
Ort |
||||
State |
|
Bundesland |
||||
Country |
|
3-Zeichen-Ländercode nach ISO 3166 z. B. DEU für Deutschland |
||||
Phone |
|
Telefon |
||||
BusinessPhone |
|
Telefon geschäftlich |
||||
MobilePhone |
|
Telefon mobil |
||||
Fax |
|
Fax |
||||
BusinessFax |
|
Fax geschäftlich |
||||
|
E-Mail-Adresse |
|||||
E-Mail2 |
|
Zweite E-Mail-Adresse, z. B. E-Mail-Adresse für Rechnungsversand |
||||
DateOfBirth |
|
Geburtsdatum im Format TT.MM.JJJJ z. B. "19.10.1968" |
||||
IP-Address |
|
IP-Adresse von der aus der Shop aufgerufen wurde |
||||
IP-AddressTimestamp |
|
Datum/Uhrzeit zu der die IP-Adresse bestimmt wurde im Format JJJJ-MM-TT / HH:MM:SS |
||||
PostOfficeBox |
|
Postfach |
||||
SuperUserID |
|
SuperUserID, falls die Bestellung von einem "SuperUser" für einen anderen Kunden ausgeführt wurde |
||||
TaxID |
|
Umsatzsteuer-ID |
||||
UserDef-1 UserDef-2 UserDef-3 |
|
Im Shop frei definierbare Felder, die nicht in der Kundendatenbank gespeichert werden. |
||||
UserDefList-1 UserDefList-2 UserDefList-3 |
|
Im Shop frei definierbare Listen-Felder, die nicht in der Kundendatenbank gespeichert werden.
|
||||
Suffix1…50 |
|
Im Shop frei definierbare Felder, die in der Kundendatenbank gespeichert werden. |
||||
BonusPointsAccountBalance |
|
Nur bei Bonuspunktesystem. Der Bonuspunktestand. |
||||
PaymentAccountCredit |
|
Nur falls die Zahlungsart "Kundenkonto" verwendet wurde. Der Kontostand. |
||||
ExpressCheckoutAddressUsed |
|
= yes, wenn die Bestellung mittels Express Checkout durchgeführt wurde. |
Sektion "DeliveryAddress"
Anzeige der Lieferadresse. Diese Sektion ist nur bei einer abweichenden Lieferadresse vorhanden.
Parameter |
Muss-Feld |
Bemerkung |
||||
Salutation |
|
Sprachabhängige Anrede z. B. "Frau" |
||||
CompleteSalutation |
|
Komplette länderabhängige Anrede z. B. "Sehr geehrter Herr Dr. Meier" |
||||
Company |
|
Firmenname |
||||
Department |
|
Abteilung |
||||
Title |
|
Sprachabhängiger Titel z. B. "Professor" |
||||
FirstName |
|
Vorname |
||||
LastName |
|
Nachname |
||||
Street1 |
|
Straße und Hausnummer |
||||
Street2 |
|
Separate Hausnummer, wenn diese nicht in Street1 aufgenommen wird |
||||
ZIP |
|
PLZ |
||||
City |
|
Ort |
||||
State |
|
Bundesland |
||||
Country |
|
3-Zeichen-Ländercode nach ISO 3166 z. B. DEU für Deutschland |
||||
Phone |
|
Telefon |
||||
BusinessPhone |
|
Telefon geschäftlich |
||||
MobilePhone |
|
Telefon mobil |
||||
Fax |
|
Fax |
||||
BusinessFax |
|
Fax geschäftlich |
||||
|
E-Mail-Adresse |
|||||
DateOfBirth |
|
Geburtsdatum im Format TT.MM.JJJJ z. B. "19.10.1968" |
||||
PostOfficeBox |
|
Postfach |
||||
UserDef-1 UserDef-2 UserDef-3 |
|
Im Shop frei definierbare Felder, die nicht in der Kundendatenbank gespeichert werden. |
||||
UserDefList-1 UserDefList-2 UserDefList-3 |
|
Im Shop frei definierbare Listen-Felder, die nicht in der Kundendatenbank gespeichert werden.
|
||||
Suffix1…50 |
|
Im Shop frei definierbare Felder, die in der Kundendatenbank gespeichert werden. |
||||
OneTime |
|
Nur bei multiplen Lieferadressen. Einmalverwendung der Lieferadresse. Steht dieser Parameter auf "yes", dann wurde diese Adresse nicht in der Kundendatenbank gespeichert und darf vom WWS nicht in den Shop zurückrepliziert werden. |
Sektion "CustomerComment"
Ein optionaler Kommentar des Bestellers.
<CustomerComment>
Text des Bestellers, wie
von ihm eingegeben.
Mit beliebigen Zeilenwechseln.
</CustomerComment>
Sektion "OrderSpecialInput"
Ein weiterer, mehrzeiliger Text, der optional vom Besteller angegeben werden kann.
<OrderSpecialInput>
Beliebige Eingaben des Bestellers.
Beliebige Eingaben des Bestellers.
Beliebige Eingaben des Bestellers.
</OrderSpecialInput>
Sektion "Order"
Globale Daten der Bestellung. Diese Sektion ist immer vorhanden.
Parameter |
Muss-Feld |
Bemerkung |
Deliverer |
|
Name des Lieferdienstes. Die Namen sind im Shop frei vergebbar, z. B. UPS, DHL, ... |
DeliveryDate |
|
Wunsch-Liefertermin. Format: TT.MM.JJJJ |
TotalWeight |
|
Gesamtgewicht der Bestellung |
WeightUnit |
|
Einheit für das Gewicht, z. B. "kg" |
TotalVolume |
|
Gesamtvolumen der Bestellung |
VolumeUnit |
|
Einheit für das Volumen |
PriceType |
X |
Werte: Gross, Net Produktpreise im Shop sind Brutto- (Gross) oder Nettopreise (Net) |
Currency |
X |
Internationaler 3-stelliger Währungscode, z. B. "EUR" |
TaxFree |
X |
Werte: yes, no |
PaymentType |
|
Technischer Name der Zahlungsart. Z. B. CreditCard, CashOnDelivery, DebitNote, Bill, Prepayment, etc. |
PaymentName |
|
Sprachabhängiger Name der Zahlungsart, z. B. "Nachnahme" |
PaymentCode |
|
Zahlungsartencode
|
VoucherNumber |
|
Die Nummer des eingelösten Gutscheins |
VoucherRest |
|
Der Restbetrag des eingelösten Gutscheins |
VoucherChargeID |
|
Die Chargen-ID des eingelösten Gutschein |
VoucherAmount |
|
Der eingelöste Betrag eines Gutscheins. Wurde z. B. eine Gutschein im Wert von 100 € eingelöst, obwohl der Rechnungsbetrag sich nur auf 25 € belief, so würde hier "25.00" stehen. |
OrderOption_Name-X (X=1…5) |
|
Name der Bestelloption |
OrderOption_Price-X (X=1…5) |
|
Kosten der Bestelloption |
OrderOption_VAT-X (X=1…5) |
|
MwSt.-Satz der Bestelloption |
TS_Name |
|
Trusted Shops Produkt-Name |
TS_VAT |
|
Der MwSt.-Satz des Trusted Shops-Produktes |
TS_COST |
|
Die Kosten des Trusted Shops-Produktes |
UploadID |
|
Die eindeutige UploadID einer Bestellung (bei Datei-Uploads) |
DownloadID |
|
Die eindeutige DownloadID einer Bestellung (bei Datei-Downloads) |
OfferID |
|
Die eindeutige ID bei Bestellung eines Angebotes |
RefText/RefText2 |
|
Referenztexte zu einer Bestellung |
CostCenterNumber |
|
Nummer der Kostenstelle bei der Zahlungsart Kostenstelle |
CostCenterEmailAddress |
|
E-Mail-Adresse des Freigebers bei der Zahlungsart Kostenstelle |
UserDiscountRate |
X |
Kundenrabatt in Prozent |
UserDiscount |
X |
Wert des Kundenrabatts |
PaymentDiscountRate |
X |
Zahlungsartenrabatt in % |
PaymentDiscount |
X |
Wert des Zahlungsartenrabatts |
OrderDiscountRate |
X |
Warenwertrabatt in % |
OrderDiscount |
X |
Wert des Warenwertrabattes |
GroupDiscount |
X |
Wert des Produktgruppenrabatts |
ProductDiscount |
X |
Wert des direkten Produktrabatts |
PaymentCostDiscountRate |
|
Zahlungskostenrabatt in % |
PaymentCostDiscount |
|
Wert des Zahlungskostenrabattes |
DeliveryCostDiscountRate |
|
Versandkostenrabatt in % |
DeliveryCostDiscount |
|
Wert des Versandkostenrabattes |
TotalDiscount |
X |
Wert aller kumulierten Rabatte |
OrderBonusPoints |
|
Anzahl der gutgeschriebenen Bonuspunkte |
CashedBonusPoints |
|
Anzahl der eingelösten Bonuspunkte |
CashedBonusPointsAmount |
|
Betrag der eingelösten Bonuspunkte |
DeliveryCost |
X |
Lieferkosten |
DeliveryVATRate |
X |
MwSt.-Satz der Lieferkosten |
CustomerSubvention |
|
Gewährter Kundenzuschuss |
CustomerSubventionRemainder |
|
Verbleibender Kundenzuschuss für die nächste Bestellung |
PaymentCost |
X |
Zahlungskosten |
Surcharge |
|
Mindermengenzuschlag |
ResellerSurcharge |
|
Reseller-Zuschlag |
GiftPackage |
|
Gesamtkosten aller Geschenkverpackungen |
GiftPackageVATRate |
|
MwSt.-Satz der Geschenkverpackung |
SubTotal |
X |
Warenwert |
VAT |
X |
Gesamter Betrag der MwSt. |
Total |
X |
Gesamtsumme inkl. aller Rabatte, Gutscheine, Zuschläge, Abschläge etc. |
Sektion "OrderList" und "Item"
Liste der bestellten Produkte. Diese Sektion ist immer vorhanden. Die Produktdaten werden in folgender Form übergeben:
<OrderList>
<Item>
Daten des 1. Produktes
</Item>
<Item>
Daten des 2. Produktes
</Item>
...
<Item>
Daten des N. Produktes
</Item>
</OrderList>
Parameter |
Muss-Feld |
Bemerkung |
ID |
|
Eindeutige Produktnummer. Abhängig von Varianten. |
PositionNumber |
|
Laufende Positionsnummer |
ProdIndex |
X |
Interner Index des Produktes. Unabhängig von Varianten. |
DepVarIndex |
|
Abhängiger Variantenindex |
Insert |
|
Werbemittelkennzeichen |
SetParentID |
|
ID eines Set-Oberprodukts (siehe Anmerkungen) |
SetChildID |
|
ID eines Set-Unterprodukts (siehe Anmerkungen) |
MerchantID |
|
Händler-ID |
MerchantName |
|
Händler-Name |
EmployeeID |
|
Angestellten-ID |
Name |
X |
Produktname |
Quantity |
X |
Bestellmenge |
ExternalProductID |
|
ID eines externen (unbekannten) Produktes |
UnitFactor |
|
Faktor der Verpackungseinheit |
Weight |
|
Gewicht pro Stück |
TotalWeight |
|
Gesamtgewicht (Quantity x Weight) |
Volume |
|
Volumen |
TotalVolume |
|
Gesamtvolumen (Quantity x Volume) |
UploadID |
|
UploadID der Position (PositionsID) |
Price |
X |
Basispreis des Produktes ohne Rabatte, Varianten, Staffelpreise, etc. Dieser Preis dient lediglich als Information |
StaticAddPrice |
|
Ein mengenunabhängiger Einmalpreis (z. B. der Preis einer Druckplatine) |
GiftPackage |
|
Preis der Geschenkverpackung |
TotalGiftPackage |
|
Gesamtpreis der Geschenkverpackung (Quantity x GiftPackage) |
AreaProductLength |
|
Länge/Höhe eines Flächenproduktes. Die Genauigkeit (Anzahl Nachkommastellen) lässt sich im Shop konfigurieren. |
AreaProductWidth |
|
Breite/Dicke eines Flächenproduktes. Die Genauigkeit (Anzahl Nachkommastellen) lässt sich im Shop konfigurieren. |
AreaProductCalculatedArea |
|
Berechnete Fläche in Bezug auf die im Shop konfigurierten Einheiten. Beispiel: |
<Variation> |
|
Beginn einer Variante. Diese Sektion kann mehrmals (je Variante einmal) vorkommen. |
ID |
|
Teil-Produktnummer bei normalen Varianten |
Name |
|
Name der Variante z. B. "Farbe" |
Option |
|
Option der Variante z. B. "rot" |
Price |
|
Aufpreis bei normalen Varianten |
Index |
|
Interner Index der Reihenfolge-Position |
</Variation> |
|
Ende einer Variante. |
<TextInputFields> |
|
Beginn der Texteingabefelder. Es werden maximal 10 Felder übergeben. |
Name-X (X=1…10) |
|
Name des Texteingabefeldes |
Field-X (X=1…10) |
|
Wert des Texteingabefeldes |
</TextInputFields> |
|
Ende der Texteingabefelder |
<OrderInfo> |
|
Interne Informationen zum Produkt. Wird 1:1 zurückgegeben. |
BonusProduct |
|
Bei "yes" handelt es sich um ein Prämienprodukt. |
BonusProductPrice |
|
Anzahl der eingelösten/benötigten Bonuspunkte |
BonusProductPriceTotal |
|
Gesamtzahl der eingelösten/benötigten Bonuspunkte (Quantity x BonusProductPrice) |
VAT |
X |
absolute MwSt. |
Sum |
X |
Zwischensumme. Dient nur zur Information. |
DiscountFactor |
|
Rabattfaktor |
TotalDiscount |
X |
Gesamtrabatt |
ProductDiscount |
X |
absoluter, direkter Produktrabatt |
UserDiscount |
|
berechneter Kundenrabatt für dieses Produkt |
ParticularOrderDiscount |
|
Betrag des Teil-Rabatts, mit der die Position an der global ausgewiesenen Rabattsumme beteiligt ist. (Bei einem Warenwertrabatt) |
ParticularUserDiscount |
|
Betrag des Teil-Rabatts, mit der die Position an der global ausgewiesenen Rabattsumme beteiligt ist. (Bei einem Kundenrabatt) |
ParticularPaymentDiscount |
|
Betrag des Teil-Rabatts, mit der die Position an der global ausgewiesenen Rabattsumme beteiligt ist. (Bei einem Zahlungsartenrabatt) |
Total |
X |
Dies ist der finale Gesamtpreis des Produktes inkl. aller Rabatte, Staffelpreise, Zusatzkosten, Aufschläge etc. und inkl. der Bestellmenge. |
InstantVoucherProduct |
|
Bei "yes" handelt es sich um einen Kaufgutschein. |
<InstantVoucherProduct> |
|
Informationen zum Kaufgutschein |
ChargeID |
|
ChargeID des Kaufgutscheins |
Number |
|
Gutscheinnummer des Kaufgutscheins |
Amount |
|
Betrag des Kaufgutscheins |
PDFLinkPart |
|
Link zum Download des Kaufgutscheins als PDF |