> ## 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. # Sektionen: Kopfdaten und Adressen > Die Sektionen Header, ID, PromotionAgreement, CustomerAddress, DeliveryAddress, DeliveryAddresses, DeliverySelections, CustomerComment und OrderSpecialInput der WS-Bestelldaten. Diese Seite beschreibt die Sektionen der [WS-Bestelldaten](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten.md), die den Kopf einer Bestellung und die Adressen des Bestellers enthalten. Die Positionen, die Summen und die Zahlungsarten finden Sie unter [Sektionen: Positionen und Zahlung](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten/sektionen-positionen-und-zahlung.md). ## Header (Allgemeine Informationen) Diese Sektion ist stets vorhanden. | Parameter | Pflichtfeld | Max. Länge | Bemerkung | | - | - | - | - | | `FormatID` | X | 32 | Kennung des Datenformats | | `VersionNumber` | X | 1 | Versionsnummer des Datenformats | | `Generator` | X | 32 | Kennung des erzeugenden Programms | | Copyright(c) | X | | Copyright von WEBSALE für dieses Datenformat | | `Remark` | X | | Unveränderlicher Wert | | `Remark` | X | | Unveränderlicher Wert | ## ID (Kopfdaten einer Bestellung) Diese Sektion ist stets vorhanden. | Parameter | Pflichtfeld | Max. Länge | Bemerkung | | - | - | - | - | | `MallID` | X | | Die MallID eines Shops. Alle Produktivshops befinden sich in der Mall „websale“. Testshops befinden sich in der Mall „test“ und Partnershops in der Mall „partner“ | | `ShopID` | X | | Eine eindeutige ID Ihres Shops. | | `SubShopID` | X | | Eine eindeutige ID Ihres Subshops. Jeder Shop besitzt mindestens 1 Subshop. | | `DataSubShopID` | | | Eine eindeutige ID Ihres Datensubshops falls die Produktdaten eines anderen Subshops verwendet wurden | | `ShopLanguage` | X | 3 | 3 Zeichen ISO Code 3166 des Landes, beispielsweise DEU für Deutschland | | `Referer` | | 128 | Aufruf-Referenz, woher WEBSALE aufgerufen wurde | | `Subreferer` | | 128 | Sub-Aufruf-Referenz, woher WEBSALE aufgerufen wurde | | `OrderNumber` | X | 16 | Eindeutige Auftragsnummer. Kann zur eindeutigen Referenzierung verwendet werden. | | `Date` | X | 8 | Datum der Bestellung im Format TT.MM.YY beispielsweise 29.01.10 | | `Time` | X | 8 | Uhrzeit der Bestellung im Format HH:MM:SS beispielsweise 19:02:59 | | `SessionID` | X | 32 | Die im Shop verwendete, eindeutige SessionID. | | `Test` | | 3 | Wenn der Shop sich zum Zeitpunkt der Bestellung im Testmodus befunden hat, wird der Parameter mit dem Wert „yes“ übergeben | | `Charset` | X | 64 | Konfigurierter Zeichensatz des Shops | | `gclid` | | 64 | Die beim Aufruf des Shops übergebene GoogleClickID | | `ExpressCheckout` | | yes | Wird gesetzt, wenn der Käufer über einen ExpressCheckout bestellt hat | | ExpressCheckout Type | | 16 | Wird nur übergeben, wenn der Käufer über einen ExpressCheckout bestellt hat. Anbieter des ExpressCheckouts. Mögliche Werte: „PayPal“ “PayPalCheckout” | | `ShopConfig` | | | Wenn der Shop zum Zeitpunkt der Bestellung mit einer alternativen Shopkonfiguration verwendet wurde, wird der Parameter mit dem Dateinamen der alternativen Shopkonfiguration als Wert übergeben. | | `IPv4` | | | Beim Absenden der Bestellung verwendete IPv4-Adresse (kann auch vom Payment-Clearer sein) | | `IPv6` | | | Beim Absenden der Bestellung verwendete IPv6-Adresse (kann auch vom Payment-Clearer sein) | | `FirstCall-IPv4` | | | IPv4-Adresse beim FirstCall | | `FirstCall-IPv6` | | | IPv6-Adresse beim FirstCall | | `FirstCall-IPAdressTimestamp` | | | Timestamp beim FirstCall | ## PromotionAgreement (Werbungszustimmung) Diese Sektion ist optional, falls der Käufer seine Zustimmung zur Werbung gegeben oder abgelehnt hat. | Parameter | Pflichtfeld | Max. Länge | Bemerkung | | - | - | - | - | | `AddressSharingState` | | Integer-Zahl | Status der Zustimmung zur Adressweitergabe: 0: Keine Informationen vorhanden 1: Telefonische Ablehnung 2: Telefonische Einwilligung 3: Ablehnung im Shopsystem 4: Einwilligung im Shopsystem | | `AddressSharingLastChangeIP` | | 15 | IP-Adresse des letzten Statuswechsels im Shop | | `AddressSharingLastChangeDate` | | 12 | Datum des letzten Statuswechsels im Format DD.MM.YYYY | | `AddressSharingLastChangeTime` | | 8 | Uhrzeit des letzten Statuswechsels im Format HH:MM:SS | | `TeleMarketingState` | | Integer-Zahl | Status der Zustimmung zur Telefonwerbung: 0: Keine Informationen vorhanden 1: Telefonische Ablehnung 2: Telefonische Einwilligung 3: Ablehnung im Shopsystem 4: Einwilligung im Shopsystem | | `TeleMarketingLastChangeIP` | | 15 | IP-Adresse des letzten Statuswechsels im Shop | | `TeleMarketingLastChangeDate` | | 12 | Datum des letzten Statuswechsels im Format DD.MM.YYYY | | `TeleMarketingLastChangeTime` | | 8 | Uhrzeit des letzten Statuswechsels im Format HH:MM:SS | ## CustomerAddress (Rechnungsadresse) Diese Sektion ist stets vorhanden. Alle Parameter der Rechnungsadresse sind jedoch optional. Zu den meisten Parametern werden gleichnamige Parameter mit dem Suffix „\_DName“ (Name des Eingabefeldes, sprachabhängig vom Subshop) ausgegeben, die als zusätzliche Information dienen. Ebenso werden zu einigen Parametern gleichnamige Parameter mit dem Suffix „\_DValue“ (im Shop angezeigter Wert des Eingabefeldes) ausgegeben, die ebenfalls als zusätzliche Information dienen. Beispiel: `Country = DEU (technischer, sprachunabhängiger Wert)` `Country_DName = Land (sprachabhängiger Name des Eingabefeldes)` `Country_DValue = Deutschland (sprachabhängige Anzeige für den Besteller)` Ein Adressdatenfeld, dessen Wert gelöscht wird, wird normalerweise ab der nächsten Bestellung nicht mehr in die Bestelldaten übergeben. Der Wert eines Feldes kann auf dem Shop-Template explizit als gelöscht markiert und übergeben werden. In den Bestelldaten der nächsten Bestellung wird der Wert dann mit dem Suffix „\_deleted“ und dem Wert „yes“ geschrieben. Beispiel: `Country_deleted = yes` | Parameter | Pflichtfeld | Max. Länge | Bemerkung | | - | - | - | - | | `Number` | | | Kundennummer | | `Company` | | | Firmenname | | `Salutation` | | | Sprachabhängige Anrede beispielsweise „Frau“ | | `SalutationCode` | | | Ein im Shop frei einstellbarer, sprachunabhängiger Anredecode. Siehe Datei "salutation.dat" | | `CompleteSalutation` | | | Komplette, länderabhängige Anrede beispielsweise „Sehr geehrter Herr Dr. Meier“ | | `FirstName` | | | Vorname | | `LastName` | | | Nachname | | `Title` | | | Sprachabhängiger Titel beispielsweise „Professor“ | | `TitleCode` | | | Ein im Shop frei einstellbarer, sprachunabhängiger Titelcode. Siehe Datei "title.dat" | | `Street1` | | | Straße und Hausnummer | | `Street2` | | | Separate Hausnummer, wenn diese nicht in Street1 aufgenommen wird | | `ZIP` | | | PLZ | | `City` | | | Ort | | `State` | | | Bundesland | | `CountryISO` | | 3 | 3-Zeichen Ländercode nach ISO 3166 beispielsweise DEU für Deutschland | | `Phone` | | | Telefon | | `Fax` | | | Fax | | `E-Mail` | | 127 | E-Mail-Adresse | | `E-Mail2` | | 127 | Mail-Adresse für Rechnung | | `BusinessPhone` | | | Telefon geschäftlich | | `MobilePhone` | | | Telefon mobil | | `BusinessFax` | | | Fax geschäftlich | | `DateOfBirth` | | 10 | Geburtsdatum im Format TT.MM.JJJJ beispielsweise „19.10.1968“ | | `PostOfficeBox` | | | Postfach | | `Suffix1..50` | | | Im Shop frei definierbare Felder, die in der Kundendatenbank gespeichert werden. | | `Department` | | | Abteilung | | `CostCenter` | | | Kostenstelle | | `UserType` | | | Kundenart | | `PostOfficeBoxZIP` | | | PLZ des Postfachs | | `TaxID` | | | Umsatzsteuer-ID | | UserDefList-1 UserDefList-2 UserDefList-3 | | | Im Shop frei definierbare Listen-Felder, die nicht in der Kundendatenbank gespeichert werden. | | `UserIndex` | | Integer-Zahl | Interner Kundenindex der Shop-Kundendatenbank | | `EmailVerification` | | verified unverified undef | Status der E-Mail-Verifizierung | | `SuperUserID` | | 64 | SuperUserID, falls die Bestellung von einem „SuperUser“ für einen anderen Kunden ausgeführt wurde | | `InfoScoreResult` | | Positive Negative | Nur bei Infoscore-Bonitätsanfrage. Die möglichen Werte sind „Positive“ bei positiver (=keine Ablehnung) Prüfung oder „Negative“ bei negativer (=explizite Ablehnung) Prüfung oder bei einem Verbindungsproblem. | | `eScoreClass` | | | Nur bei Infoscore-Bonitätsanfrage. Der eScoreClass-Wert. | | `InformaScore` | | | Nur bei Infoscore-Bonitätsanfrage. Der InformaScore-Wert. | | `InfoScoreFeatures` | | | Nur bei Infoscore-Bonitätsabfrage. Zusatzinformationen von InfoScore. | | `InfoScoreBIG` | | yes/no | Yes: Es wird die aktuelle Schnittstelle InfoScoreBIG (Stand Nov. 2016) benutzt. No: Es wird die eScore-Schnittstelle von Infoscore benutzt | | `BonusPointsAccountBalance` | | | Nur bei Bonuspunktesystem. Der Bonuspunktestand. | | `PaymentAccountCredit` | | | Nur falls die Zahlungsart „Kundenkonto“ verwendet wurde. Der Kontostand. | | `IP-Address` | | IP-Adresse | IP-Adresse von der aus der Shop aufgerufen wurde | | IP- AddressTimestamp | | Datum | Datum/Uhrzeit zu der die IP-Adresse bestimmt wurde im Format JJJJ-MM-TT / HH:MM:SS | | `AddressIndex` | | Integer-Zahl | Eindeutiger, interner Rechnungsadressindex | | `ExternalID` | | | Externe ID der Rechnungsadresse, welche vom WWS vergeben werden kann. | | `RegistrationCode` | | | Registrierungs-Code für Neukunden | | `ExpressCheckoutAddressUsed` | | yes | Hier wird „yes“ übergeben wenn der Käufer per Expresscheckout bestellt hat und die Adressdaten nicht in WEBSALE V8 eingegeben wurden. In diesem Fall müssen als Rechnungsadresse entweder die Adressdaten in den spezifischen Daten des Anbieters verwendet oder beim Anbieter direkt abgefragt werden (PayPal, Amazon, PayDirekt, etc...). In diesem Fall werden die meisten Felder der Rechnungsadresse nicht übergeben. | | `AccountType` | | CustomerAccount GuestAccount | Für angemeldete Kunden wird CustomerAccount übergeben, für nicht angemeldete Kunden (Gastbestellung) wird GuestAccount übergeben. | ## DeliveryAddress (optionale, abweichende Lieferadresse) Alle Parameter der von der Rechnungsadresse abweichenden Lieferadresse sind optional. Diese Sektion ist nur bei einer abweichenden Lieferadresse vorhanden. Zu den meisten Parametern werden gleichnamige Parameter mit dem Suffix „\_DName“ (Name des Eingabefeldes, sprachabhängig vom Subshop) ausgegeben, die als zusätzliche Information dienen. Zu einigen Parametern werden gleichnamige Parameter mit dem Suffix „\_DValue“ ausgegeben, die ebenfalls als zusätzliche Information dienen. Beispiel: `Country = DEU (technischer, sprachunabhängiger Wert)` `Country_DName = Land (sprachabhängiger Name des Eingabefeldes)` `Country_DValue = Deutschland (sprachabhängige Anzeige für den Besteller)` Ein Adressdatenfeld, dessen Wert gelöscht wird, wird normalerweise ab der nächsten Bestellung nicht mehr in die Bestelldaten übergeben. Der Wert eines Feldes kann auf dem Shop-Template explizit als gelöscht markiert und übergeben werden. In den Bestelldaten der nächsten Bestellung wird der Wert dann mit dem Suffix „\_deleted“ und dem Wert „yes“ geschrieben. Beispiel: `Country_deleted = yes` | Parameter | Pflichtfeld | Max. Länge | Bemerkung | | - | - | - | - | | `Company` | | | Firmenname | | `Salutation` | | | Sprachabhängige Anrede beispielsweise „Frau“ | | `SalutationCode` | | | Ein im Shop frei einstellbarer Anredecode. Siehe Datei "salutation.dat" | | `FirstName` | | | Vorname | | `LastName` | | | Nachname | | `Title` | | | Sprachabhängiger Titel beispielsweise „Professor“ | | `TitleCode` | | | Ein im Shop frei einstellbarer Titelcode. Siehe Datei "title.dat" | | `Street1` | | | Straße und Hausnummer | | `Street2` | | | Separate Hausnummer, wenn diese nicht in Street1 aufgenommen wird | | `ZIP` | | | PLZ | | `City` | | | Ort | | `State` | | | Bundesland | | `CountryISO` | | 3 | 3-Zeichen Ländercode nach ISO 3166 beispielsweise DEU für Deutschland | | `Phone` | | | Telefon | | `Fax` | | | Fax | | `E-Mail` | | | eMail-Adresse | | `BusinessPhone` | | | Telefon geschäftlich | | `MobilePhone` | | | Telefon mobil | | `BusinessFax` | | | Fax geschäftlich | | `DateOfBirth` | | | Geburtsdatum im Format TT.MM.JJJJ beispielsweise „19.10.1968“ | | `PostOfficeBox` | | | Postfach | | `Suffix1..50` | | | Im Shop frei definierbare Felder, die in der Kundendatenbank gespeichert werden. | | `Department` | | | Abteilung | | `CostCenter` | | | Kostenstelle | | `UserType` | | | Kundenart | | `PostOfficeBoxZIP` | | | PLZ des Postfachs | | `DeliveryAddressIndex` | | Integer-Wert | Eindeutiger interner Lieferadressenindex | | `ExternalID` | | | Externe ID der Lieferadresse, welche vom WWS vergeben werden kann. | | `OneTime` | | yes | 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. | | `WishListAddress` | | yes | Die Lieferadresse ist eine hinterlegte Wunschlistenadresse eines anderen Kunden | | `WishListOwnerFirstName` | | | Vorname des Wunschlistenbesitzers | | `WishListOwnerLastName` | | | Nachname des Wunschlistenbesitzers | ## DeliveryAddresses (mehrere Lieferadressen bei MultiDelivery) Diese Sektion wird dann angezeigt, wenn die Funktion “Mehrere Lieferadressen auswählen (MultiDelivery/Split-Order)” im Shop aktiv ist. Für jede Lieferadresse wird ein eigener Abschnitt `<+DeliveryAddress>` angelegt. Dieser enthält alle Standard-Parameter wie oben aufgelistet: [Sektion DeliveryAddress](https://websale.atlassian.net/wiki/spaces/Doku/pages/1786871932/Format+und+Inhalt+-+WS-Bestelldaten+DE#Sektion%3A-DeliveryAddress-\(optionale%2C-abweichende-Lieferadresse\)) Zusätzlich wird der Parameter DeliveryAddressOrderIndex eingefügt und ein Index vom System vergeben. Mit diesem Index erfolgt die Verknüpfung der Bestellpositionen zu den einzelnen Lieferadressen in der Sektion **OrderList > Item**. `` `<+DeliveryAddress>` `DeliveryAddressOrderIndex = 1` `...` `` `<+DeliveryAddress>` `DeliveryAddressOrderIndex = 2` `...` `` `` | Parameter | Pflichtfeld | Max. Länge | Bemerkung | | - | - | - | - | | `DeliveryAddressOrderIndex` | | Integer | Index vom System vergeben. Zuordnung von Bestellposition und Lieferadresse | ## DeliverySelections (flexible Zuordnung der Versandart bei MultiDelivererSelection) Diese optionale Sektion wird angezeigt, wenn die Funktion MultiDelivererSelection aktiv ist. Dabei kann der Besteller für jede Warenkorbposition (MultiDelivery) bzw. für jede Lieferadresse einer aufgeteilten Position (Split-Order) eine eigene Versandart zuordnen. Zu einigen Parametern werden gleichnamige Parameter mit dem Suffix „\_DName“ und/oder „\_DValue“ als zusätzliche Information ausgegeben. | Parameter | Pflichtfeld | Max. Länge | Bemerkung | | - | - | - | - | | `<+DeliverySelection>` | | -- | Für jede Warenkorbposition und gewählte Versandart wird eine eigene Untersektion angelegt. | | `Deliverer` | | 510 | Name des Lieferdienstes. Die Namen sind im Shop frei vergebbar, beispielsweise UPS, DHL, ... | | `DelivererType` | | 64 | Lieferantenart. Im Shop frei vergebbar | | `DelivererID` | | 64 | LieferantenID. Im Shop frei vergebbar | | `DeliverySelectionOrderIndex` | | | eindeutiger vom System vergebener Index, der die gewählte Versandart mit der (Split-)Position verknüpft (Sektion OrderList-Item) | | `<+DelivererAdditionalInfo>` | | -- | Untersektion für jede Zusatzinformation einer Versandart | | `ID` | | 128 | ID aus der Shopkonfiguration | | `Info` | | | Info-Text aus der Shopkonfiguration | | `` | | -- | Ende der Untersektion | | `<+DelivererAdditionalInput>` | | -- | Untersektion bei zusätzlichem Eingabefeld für eine Versandart | | `ID` | | 128 | ID aus der Shopkonfiguration | | `FieldDescr` | | 1024 | Beschreibung des Eingabefeldes aus der Shopkonfiguration | | `Input` | | 128 | eingegebener Text des Käufers | | `` | | -- | Ende der Untersektion | | `IDCardNumber` | | 20 | Zustellung Eigenhändig Plus: Ausweisnummer | | `IDCardType` | | Integer | Zustellung Eigenhändig Plus: Art des Ausweisdokuments (frei vergebbar) | | `IDCardAuthority` | | 30 | Zustellung Eigenhändig Plus: Name der ausstellenden Behörde | | `AmountDependentCost` | | float | warenwertabhängiger Versandkostenanteil | | `PieceDependentCost` | | float | stückkostenabhängiger Versandkostenanteil | | `WeigthDpendentCost` | | float | gewichtsabhängiger Versandkostenanteil | | `ProductDependentCost` | | float | produktspezifischer Versandkostenanteil | | `MinimumDeliveryCost` | | float | Mindestversandkosten | | `MinimumDeliveryCostApplied` | | yes no | Mindestversandkosten verwendet? | | `MerchantSpecificDeliveryCostApplied` | | yes no | händlerspezifische Versandkosten verwendet? | | `DeliveryCostReduction` | | float | Betrag der Versandkostenreduktion | | `DeliveryCostReductionApplied` | | yes no | Versandkostenreduktion verwendet? | | `DeliveryUserCostDiscount` | | float | Betrag der kundenabhängigen Versandkostenreduktion | | `DeliveryUserCostDiscountApplied` | | yes no | kundenabhängige Versandkostenreduktion verwendet? | | `DynamicFreeDeliveryApplied` | | yes no | versandkostenfrei wegen dynamischer Auswertung FreeDelivery aus dem Warenkorb | | `UserAccountFreeDeliveryApplied` | | yes no | versandkostenfrei wegen Definition im Kundenkonto | | `TotalDeliveryCost` | | float | Gesamtbetrag für diese Versandauswahl | ## CustomerComment (Kommentar des Bestellers) Dem Besteller wird ein mehrzeiliges Texteingabefeld mit maximal 1000 Zeichen angeboten. Diese Sektion ist optional. `` `Text des Bestellers, wie von ihm eingegeben.` `Mit beliebigen Zeilenwechseln.` `` ## OrderSpecialInput (Zusatzinformationen des Bestellers) Ein weiteres, mehrzeiliges Texteingabefeld mit maximal 32000 Zeichen. Diese Sektion ist optional. `` `Beliebige Eingaben des Bestellers.` `Beliebige Eingaben des Bestellers.` `Beliebige Eingaben des Bestellers.` `` ## Verwandte Themen * [WS-Bestelldaten](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten.md) * [Sektionen: Positionen und Zahlung](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten/sektionen-positionen-und-zahlung.md) ## Related topics - [Sektionen: Positionen und Zahlung](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten/sektionen-positionen-und-zahlung.md) - [WS-Bestelldaten](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten.md) - [WS-Anfragedaten](https://dokumentation.websale.de/v8s/schnittstellen/service-und-app/ws-anfragedaten.md) - [Übersicht Bestelldaten](https://dokumentation.websale.de/v8s/materialien/uebersicht-bestelldaten.md) - [Adressen und Eingabeprüfungen](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/adressen-und-eingabepruefung.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.