> ## 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. # Felder und Beispiele > Alle Sektionen und Felder der XML-Daten des WS-Bestellgenerators, von Produkt und Zahlungsart über Zustellung und Auftragsoptionen bis zu Rechnungs- und Lieferadresse. Diese Seite beschreibt alle Sektionen und Felder der XML-Daten des [WS-Bestellgenerators](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestellgenerator.md). Optionale Parameter können leer übergeben oder ganz weggelassen werden. ## Übergabe eines Produktes (erforderlich) ``` Produktnummer Verdichtungsnummer Produktindex des Set-Oberartikels Variantenindex des Set-Oberartikels

Variantenindex des X-ten Set-Unterartikels

Produktindex eines Set-Unterartikels Variantenindex des Set-Unterartikels UserIndex Menge Produktpreis Produkthöhe Produktbreite Produktionsland bzw. -standort yes Variationsname Variationswert Variationsname Variationswert … Texteingabefeldname Texteingabefeldwert Texteingabefeldname Texteingabefeldwert ... <+Entry> ID der Lieferadresse Menge yes (Daten des 2. Produktes) … (Daten des 100. Produktes) ``` | Parameter | Optional/Erforderlich | Beschreibung | | - | - | - | | `Products` | Erf. | Übergabe aller Produkte | | `Product` | Erf. | Übergabe eines einzelnen Produktes. Diese Sektion kann bis zu 100 mal wiederholt werden. Es können somit bis zu 100 Produkte übergeben werden. | | `Number` | Erf. wenn SetID fehlt Typ: C128 | Eindeutige Produktnummer. Dies kann auch die Produktnummer einer abhängigen Variante sein. | | `SetID` | Erf. Wenn Number fehlt Typ: C64 | Nur bei Sets möglich. Bei einem Set kann vorab im Shop eine SetID zu jeder Set-Kombination definiert und abgespeichert werden. Hier wird einer der gespeicherten SetIDs übergeben. | | `` `...` `...` `...` `` | Erf. Wenn Number oder SetID fehlt | Alternative/Direkte Übergabe eines kompletten Sets ohne SetID. In diesem Fall muss das komplette Set mit allen Set-Unterartikeln angegeben werden. Es ist nicht möglich CvarIndex-X Sektionen und Child-Sektionen innerhalb eines Sets zu verwenden. In diesem Fall werden folgende Daten übergeben: `...`: ProduktIndex des Set-Oberartikels `...`: Variantenindex des Set-Oberartikels `...`: VariantenIndex des X-ten Set-Unterartikels | | `` `...` `...` `` `...` `...` `` `...` `` `...` `...` `` `` | Erf. Wenn Number oder SetID fehlt | Alternative/Direkte Übergabe eines unvollständigen Sets ohne SetID. In diesem Fall kann für jeden Set-Unteratikel ein Variantenindex angegeben werden (in einer eigenen Child-Sektion). Für nicht übergebene Variantenindizes von Set-Unterartikeln wird die erste, vollständig definierte Variantenkombination verwendet. Die Adressierung der Set-Unterartikel erfolgt anhand von Produktindex und Variantenindex, dabei ist es nicht notwendig den genauen Aufbau des Sets zu kennen. Die Reihenfolge der übergebenen Variantenindizes für Set-Unterartikel ist nicht relevant. Ein übergebener Variantenindex wird nur einmal verwendet. Bei Mehrfachzuweisungen (wenn das Set ein Produkt mehrfach enthält) müssen/können diese explizit mehrfach angegeben werden und werden in der Reihenfolge der Angabe berücksichtigt. Alle übergebenen Child-Sektionen müssen auch für die Bestellung verwendet werden: Wird mindestens eine übergebene Child-Sektion nicht berücksichtigt (beispielsweise da der Setartikel keinen Set-Unterartikel mit dem übergebenen Variantenindex besitzt) wird ein Fehler zurückgegeben. Es ist nicht möglich CvarIndex-X Sektionen und Child-Sektionen innerhalb eines Sets zu verwenden. In diesem Fall werden folgende Daten übergeben: `...`: ProduktIndex des Set-Oberartikels `...`: Variantenindex des Set-Oberartikels `` `...` `...` ``: Produktindex und VariantenIndex eines Set-Unterartikels | | `SetIDUserIndex` | Opt. | Die SetID soll von einem anderen User geladen werden. | | `Quantity` | Opt. Typ: I oder F | Optionale Menge. Fehlt dieser Parameter oder ist er leer, dann ist die Menge „1“ | | `Length` | Erf. Wenn Flächenprodukt | Angabe der gewünschten Produkthöhe. | | `Width` | Erf. Wenn Flächenprodukt | Angabe der gewünschten Produktbreite. | | `Price` | Opt. Typ: F | Optionaler Stückpreis der Position. Wenn vorhanden wird dieser verwendet anstelle des Stückpreises in den Produktdaten | | `countryofproduction` | Opt. | 3-stelliger ISO-Code des Landes, in dem das Produkt produziert werden soll ODER Produktionsstandort in der Form 3ISO-ALPHANUM (ISO-Code, Trennzeichen Bindestrich, Alphanumerische Kennung des Produktionsstandorts). Bei Angabe eines Produktionsstandorts wird diese abgetrennt und im Feld ProductionLocationIdentifier in den Bestelldaten beim Produkt übergeben. | | `ForceW2PFlag` | Opt. | Flag zur Identifizierung von W2P-Bestellungen. Wenn gesetzt, werden in den Bestelldaten die beiden Flags gesetzt (`` Ebene): ForceW2PFlag = yes W2P = yes | | `Variations` | Opt. | Übergabe von normalen Varianten | | `Variation` | Opt. | Übergabe einer normalen Variante | | `Name` | Erf. für normale Varianten Typ: C128 | Variantenname, beispielsweise „Farbe“, „Größe“, „Höhe“, „Breite“, usw. **Bitte beachten Sie!** Der Variantenname muss exakt mit dem im Shop und zum Produkt definierten Variantennamen übereinstimmen | | `Value` | Erf. für normale Varianten Typ: C128 | Variantenwert, beispielsweise „rot“, „44“ usw. **Bitte beachten Sie!** Der Variantenwert muss exakt mit dem im Shop und zum Produkt definierten Variantenwerten übereinstimmen. | | `TextInputs` | Opt. | Übergabe von Texteingabefeldern | | `TextInput` | Opt. | Übergabe eines Texteingabefelds | | `Name` | Erf. für Texteingabefeld Typ: C128 | Name des Texteingabefelds, beispielsweise „Besatz“, "Beschriftung", usw. **Bitte beachten Sie!** Der Name des Texteingabefelds muss exakt mit dem im Shop und zum Produkt definierten Texteingabefeld übereinstimmen | | `Value` | Erf. für Texteingabefeld Typ: C255 | Wert des Texteingabefelds, beispielsweise „Müller“, „Meine kleine Farm“ usw. | | `` `<+Entry>` `` `...` `` `` `...` `` `` `yes` `` `` `` | Opt. | Nur bei MULTI-ALA Splits (Split-Order) DeliveryAddressID ist auch bei `` definiert. DeliveryQuantity-Menge des Splits SampleCopy-Belegexemplar | ## Übergabe der Zahlungsart (optional) ``` Zahlungsartencode externe ID Kontoinhaber Kontonummer BLZ Name des Kreditinstitutes IBAN BIC Karteninhaber Kartentyp Kartennummer ohne Leerzeichen Verfallsdatum im Format: YYYY-MM Kartenprüfnummer ``` Die Sektion **``...``** wird nur bei der Zahlungsart „Lastschrift“ übergeben. Ansonsten fehlt diese Sektion komplett. Die Sektion **``...``** wird nur bei der Zahlungsart „Kreditkarte“ übergeben. Ansonsten fehlt diese Sektion komplett. **Sicherheitshinweis**: Der Bestellgenerator speichert keine Bank- oder Kreditkartendaten ab. Sie werden nur für die jeweilige Bestellung verwendet. | Parameter | Optional/Erforderlich | Beschreibung | | - | - | - | | `Payment` | Opt. | Übergabe einer optionalen Zahlungsart | | `Code` | Erf. Bei Übergabe einer Zahlungsart Typ: I | Code der Zahlungsart. Beispiele für Zahlungsarten-Codes: 1=Kreditkarte 3=Nachnahme 4=Bankeinzug/Lastschrift 5=Vorauskasse 6=Rechnung … ***Eine Liste aller Zahlungsarten-Codes finden Sie in der Designer-Dokumentation:*** [Zahlungsarten-Codes](https://doku.websale.net/index.html?mats_verwendete_zahlungsartencodes.html) | | `CreditCard` | Erforderlich für Zahlungsart Kreditkarte | Sektion der Kartendaten | | `Holder` | Erf. Typ: C128 | Name des Karteninhabers | | `BrandID` | Erf. Typ: I | Kartentyp als Integer-Wert. Folgende Kartentypen werden unterstützt: 1=VISA 2=Mastercard 3=American Express 4=Diners (weitere sind möglich) | | `Number` | Erf. Typ: N19 | Kartennummer ohne Leerzeichen. Beispiel: 4018499066751123 | | `ExpiryDate` | Erf. | Gültigkeit der Karte im Format „YYYY-MM“ beispielsweise 2010-09 | | `VerificationCode` | Erf. Typ: N4 | Kartenprüfnummer. Beispiel: 621 | | `Debit` | Erforderlich für Zahlungsart Lastschrift | Sektion der Bankdaten | | `ExternalID` | C64 | Optional. Eine Bankverbindung kann mit einer externen ID angegeben werden. Wird dieser Parameter übergeben, dann werden alle Folgeparameter der Lastschrift ignoriert. | | `AccountHolder` | Erf. Typ: C128 | Name des Kontoinhabers | | `BankName` | Erf. Typ: C128 | Name der Bank | | `AccountNumber` | Erf. (ohne SEPA) Typ: N64 | Kontonummer ohne Leerzeichen. Beispiel: 486335560 | | `BankCode` | Erf. (ohne SEPA) Typ: N64 | BLZ ohne Leerzeichen Beispiel: 76040061 | | `IBAN` | Erf. mit SEPA | IBAN | | `BIC` | Erf. mit SEPA | BIC | **Bitte beachten Sie:** Die Zahlungsart ist optional. Es können nur Offline-Bezahlmethoden verwendet werden oder Online-Bezahlmethoden ohne Client-Authentifizierung (Creditkartenclearing Server-zu-Server und ELV). Bezahlmethoden wie PayPal oder Sofortüberweisung sind nicht möglich, da hier eine Client-Authentifizierung über den Browser erfolgen muss. **Beispiel: Bezahlung per Kreditkarte** ``` 1 Hans Meier 1 42000230112244558798 2013-01 655 ``` **Beispiel: Bezahlung per Lastschrift** ``` 4 Hans Meier 4654233421 76040061 Commerzbank ``` **Beispiel: Bezahlung per Rechnung** ``` 6 ``` **Beispiel: Bezahlung per Nachnahme** ``` 3 ``` ## Übergabe der Zustellung (optional) Die Zustellung kann auf 2 Arten übergeben werden: Entweder mit dem Namen des Versanddienstleisters sowie dem Betrag der Lieferkosten (FixedDelivery) oder mit der Zustell-ID und dem Zustellcode (Delivery). **Achtung** **Wenn beide Sektionen übergeben werden, wird die Sektion `` verwendet!** **Übergabe mit Betrag und Lieferantenname:** ``` Name des Versanddienstleisters Lieferkosten ``` | Parameter | Optional/Erforderlich | Beschreibung | | - | - | - | | `FixedDelivery` | Opt. | Übergabe einer optionalen Zustellung mit Betrag und Versanddienstleister | | `Name` | Erf. Typ: C255 | Name des Versanddienstleisters | | `Total` | Erf. Typ: F | Betrag der Lieferkosten | **Übergabe mit ID und Zustellcode:** ``` Zustell-ID Zustellcode Referenztext ``` | Parameter | Optional/Erforderlich | Beschreibung | | - | - | - | | `Delivery` | Opt. | Übergabe einer optionalen Zustellung | | `ID` | Opt. Typ: C64 | Eine eindeutige ID, die im Shop zu jeder Zustellung definiert werden kann. Fehlt die ID, dann ermittelt der Shop automatisch eine der passenden Zustellungen aufgrund der gesetzten Zustell-Filter. | | `Code` | Opt. Typ: C64 | Code der Zustellung, (beispielsweise Expresslieferung) der im Shop zu jeder Zustellung definiert werden kann. | | `Reference` | Opt. Typ: C1024 | Durch Reference wird immer die erste Versandart gewählt, die den entsprechenden Referenztext im Parameter AutoOrderReference der Shopkonfiguration hat. Wenn ID und Reference übergeben werden, wird die ID priorisiert. | ## Übergabe von Auftragsoptionen (optional) ``` 120.90 Referenztext 1 Referenztext 2

Options-Nummer

``` | Parameter | Optional/Erforderlich | Beschreibung | | - | - | - | | `OrderOptions` | Opt. | Übergabe von Auftragsoptionen | | `ResellerSurcharge` | Opt. Typ: F | Optionaler Resellerzuschlag. Preisformat: Beispiel: 20.95 **Bitte beachten Sie:** Bei einem Reseller-Zuschlag muss als Zahlungsart „Nachnahme“ übergeben werden. Fehlt dieser Parameter oder ist er leer, dann wird kein Reseller-Zuschlag übergeben. | | Reference Reference2 | Opt. Typ: C50 | Referenztext zur Bestellung. Der Referenztext wird auf Rechnungen, E-Mail-Bestätigungen und in der Auftragshistorie angezeigt. Die maximale Länge dieses Textes beträgt 50 Zeichen. Fehlt dieser Parameter oder ist er leer, dann wird kein Referenztext übergeben. | | OrderOptions1-Entry OrderOptions2-Entry OrderOptions3-Entry OrderOptions4-Entry OrderOptions5-Entry | Opt. Typ: I | Hier können bis zu 5 OrderOptions übergeben werden, so wie diese in der Shopkonfiguration shop.config hinterlegt wurden. Beispiel: Eintrag in der shop.config: `` `` Allow = yes VATRate-Value = 1 `<+Entry>` # 1. Option Name-Txt = keine Belegexemplare Cost-Value = 0 CostType-Value = 0 Display-Txt = `` `<+Entry>` # 2. Option Name-Txt = Belegexemplare Cost-Value = 25.00 CostType-Value = 1 Display-Txt = ... `` `` `` Eintrag im Bestellgenerator, wenn die 2. Option (Belegexemplare) verwendet werden soll: `2` Analog dazu, können die anderen OrderOptions referenziert werden | ## Übergabe von Zusatzinformationen zur Bestellung (optional) Die Übergabe von Zusatzinformationen ist optional. ``` ``` | Parameter | Optional/Erforderlich | Beschreibung | | - | - | - | | `OrderSpecialInput` | Opt. Typ: C32000 | Übergabe von Zusatzinformationen zur Bestellung | ## Übergabe einer Gutscheinnummer (optional) ``` 1234-5678-1234-5678 ``` | Parameter | Optional/Erforderlich | Beschreibung | | - | - | - | | `Voucher` | Opt. | Übergabe einer Gutscheinnummer | | `Number` | Opt. Typ: C19 | Gutscheinnummer **Bitte beachten Sie:** Bei einer unbekannten/falschen Gutscheinnummer wird die komplette Bestellung abgelehnt. | ## Übergabe der Rechnungsadresse Für Gastbestellungen ist die Übergabe der Rechnungsadresse obligatorisch. Bei einer Anmeldung ist diese optional. Wird bei einer Anmeldung keine Rechnungsadresse übergeben (fehlt die Sektion BillingAddress) dann wird die hinterlegte Rechnungsadresse des Benutzerkontos/Logins herangezogen. Im Shop wird zu jedem Feld der Rechnungsadresse definiert, ob das Feld * unterstützt wird * optional oder erforderlich ist Die Felder der übergebenen Rechnungsadresse müssen synchron zur Shopkonfiguration sein. Bitte kontaktieren Sie daher den Shopbetreiber, welche Felder unterstützt werden und welche Felder optional oder erforderlich sind. **Bitte beachten Sie:** Die übergebenen Daten der Rechnungsadresse werden nicht in der Shopdatenbank gespeichert, sondern nur im Auftrag übergeben. ``` Kundennummer Firmenname Anrede-Code Titel-Code Vorname Nachname Straße + optionale Hausnummer Hausnummer, wenn Street1 nur Straße hat PLZ Ort Bundeststaat/Bundesland DEU Telefon (privat) Telefon (geschäftlich) Telefon (mobil) Fax (privat) Fax (geschäftlich)

E-Mail Adresse

2. E-Mail Adresse für separate Rechnungs-E-Mails

E-Mail Adresse