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

> Format und Inhalt der Anfragen, die Kunden über ein INQUIRY4-Formular absenden, mit den Sektionen Header, ID, Adressen, Inquiry und InquiryUpload.

WS-Anfragedaten beschreibt, in welchem Format eine über ein Shop-Formular abgesendete Anfrage beim Warenwirtschaftssystem ankommt. Die Formulare selbst laufen über INQUIRY4, das die Eingaben prüft, per E-Mail an einen Empfänger schickt und sie zusätzlich im hier beschriebenen XML-Format für ERP-Systeme bereitstellt.

| Eigenschaft | Wert |
| - | - |
| Übertragungsrichtung | WEBSALE Shop → Warenwirtschaft (Data-from-Shop) |
| Übertragungsart | SOAP |
| Format | XML |

Abgeholt werden die Daten über [SOAP-from-Shop](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/soap-from-shop.md). Lässt sich in Ihrem System kein SOAP umsetzen, geht es alternativ über den [WSOM-from-Shop](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/wsom-from-shop.md), die nicht mehr empfohlene Vorgängerversion.

## Wie Eingabefelder abgebildet werden

Welche Felder ein Formular abfragt, welche davon Pflicht sind und welche optional, legt der Designer fest. Die Struktur der Daten bleibt dabei immer gleich: Jedes Eingabefeld erscheint als `Item`-Element mit drei Parametern.

| Parameter | Bedeutung |
| - | - |
| `Name` | Technische, sprachunabhängige ID des Eingabefeldes |
| `Descr` | Sprachabhängige Bezeichnung des Eingabefeldes |
| `Value` | Wert des Eingabefeldes, bis zu 4000 Zeichen |

```xml theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Item>
  <Name>LastName</Name>
  <Descr>Nachname</Descr>
  <Value>Müller</Value>
</Item>
```

Werte dürfen mehrzeilig sein:

```xml theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Item>
  <Name>Remark</Name>
  <Descr>Wünsche und Anmerkungen</Descr>
  <Value>
    ... Zeile 1
    ... Zeile 2
    ... Zeile 3
  </Value>
</Item>
```

Für Ihre Verarbeitung sind zwei Einstellungen des Designers wichtig: Er kann je Eingabefeld eine maximale Eingabelänge festlegen, damit die Werte zu Ihrem ERP-System passen, und er kann bestimmen, ob leere Eingabefelder in den XML-Daten erscheinen oder weggelassen werden. Verlassen Sie sich deshalb nicht darauf, dass ein bestimmtes `Item` immer vorhanden ist.

## Sektion Header

Diese Sektion ist immer vorhanden.

| Parameter | Muss-Feld | Max. Länge | Bemerkung |
| - | - | - | - |
| `FormatID` | ja | 32 | Kennung des Datenformats |
| `Generator` | ja | 32 | Kennung des erzeugenden Programms |
| `Copyright(c)` | ja | | Copyright von WEBSALE für dieses Datenformat |
| `Remark` | ja | | Unveränderlicher Wert |
| `Referer` | nein | 128 | Aufruf-Referenz, woher die Anfrage aufgerufen wurde |
| `Subreferer` | nein | 128 | Sub-Aufruf-Referenz |

```xml theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Header>
  <FormatID>INQUIRY-4</FormatID>
  <Generator>INQUIRY-4</Generator>
  <Copyrightc>WEBSALE AG, www.websale.de</Copyrightc>
  <Remark>This File-Format is protected by international copyright laws.</Remark>
  <Referer></Referer>
  <SubReferer></SubReferer>
</Header>
```

## Sektion ID

Diese Sektion ist ebenfalls immer vorhanden und enthält die Kopfdaten der Anfrage.

| Parameter | Muss-Feld | Max. Länge | Bemerkung |
| - | - | - | - |
| `MallID` | ja | | Mall des Shops. Produktivshops liegen in der Mall `websale`, Testshops in `test`, Partnershops in `partner`. |
| `ShopID` | ja | | Eindeutige ID Ihres Shops |
| `INI` | ja | | Name der Konfigurationsdatei |
| `InquiryNumber` | ja | 32 | Eindeutige Anfragenummer, analog einer Auftragsnummer. Eignet sich zur eindeutigen Referenzierung. |
| `Subject` | ja | | Benennung der Anfrage |
| `Date` | ja | 8 | Datum der Anfrage |
| `Time` | ja | 8 | Uhrzeit der Anfrage im Format `HH:MM` |
| `IPAdress` | ja | 15 | IP-Adresse des Users |
| `ExtIPAddress` | nein | 15 | IP-Adresse des Shops, falls INQUIRY4 per `ExternInclude` eingebunden ist |
| `ExtIPAddressTime` | nein | 21 | Timestamp der externen IP-Adresse im Format `YYYY-MM-DD / HH:MM:SS` |
| `ExtSessionID` | nein | 64 | SessionID des Shops, falls INQUIRY4 per `ExternInclude` eingebunden ist |

```xml theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<ID>
  <MallID>websale</MallID>
  <ShopID>mein_shop</ShopID>
  <SubShopID>deutsch</SubShopID>
  <INI>katalog.config</INI>
  <InquiryNumber>121373439353665</InquiryNumber>
  <Subject>Kontaktanfrage</Subject>
  <Date>2013-07-10</Date>
  <Time>08:55:00</Time>
  <IPAddress>212.204.107.127</IPAddress>
  <ExtIPAddress>217.86.230.240</ExtIPAddress>
  <ExtIPAddressTime>2013-07-10 / 08:50:43</ExtIPAddressTime>
  <ExtSessionID>eef151edbc8d681e083a362e262ab3d6</ExtSessionID>
</ID>
```

## Sektionen CustomerAddress und DeliveryAddress

`CustomerAddress` erscheint, wenn das Formular Daten der Rechnungsadresse abfragt, `DeliveryAddress` entsprechend für die Lieferadresse. Beide enthalten `Item`-Elemente nach dem oben beschriebenen Muster.

```xml theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<CustomerAddress>
  <Item>
    <Name>salutation</Name>
    <Descr>Anrede</Descr>
    <Value>Herr</Value>
  </Item>
  <Item>
    <Name>last_name</Name>
    <Descr>Nachname</Descr>
    <Value>Muster</Value>
  </Item>
  <Item>
    <Name>zip</Name>
    <Descr>PLZ</Descr>
    <Value>12345</Value>
  </Item>
  <Item>
    <Name>country</Name>
    <Descr>Land</Descr>
    <Value>DEU</Value>
  </Item>
  <Item>
    <Name>email</Name>
    <Descr>E-Mail</Descr>
    <Value>max@websale.de</Value>
  </Item>
</CustomerAddress>
```

## Sektion Inquiry

Diese Sektion erscheint, sobald mindestens eine Anfrage eingegeben wurde. Auch sie besteht aus `Item`-Elementen.

```xml theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Inquiry>
  <Item>
    <Name>request</Name>
    <Descr>Wünsche und Anregungen</Descr>
    <Value>
      Zeile 1
      Zeile 2
    </Value>
  </Item>
</Inquiry>
```

## Sektion InquiryUpload

Zu einer Anfrage kann der Kunde eine oder mehrere Dateien auf den Shopserver hochladen. Die Dateien selbst stehen nicht in den XML-Daten, sondern liegen auf dem Server. Ihr ERP-System holt sie per SFTP ab.

Je Upload entsteht eine eindeutige `UploadID`, die einem Unterverzeichnis des SFTP-Accounts entspricht. Lädt ein Kunde drei Dateien hoch und lautet die UploadID `11AABBCC`, sieht die Struktur so aus:

```
SFTP-Root
└── 11AABBCC
    ├── Datei1.jpg
    ├── Datei2.jpg
    └── Datei3.jpg
```

| Parameter | Muss-Feld | Max. Länge | Bemerkung |
| - | - | - | - |
| `UploadID` | ja | 64 | Kennung des Uploads und zugleich Name des Unterverzeichnisses |
| `FileName` | ja | | Name der hochgeladenen Datei |

```xml theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<InquiryUpload>
  <UploadID>11AABBCC</UploadID>
  <Item>
    <Filename>Datei1.jpg</Filename>
  </Item>
  <Item>
    <Filename>Datei2.jpg</Filename>
  </Item>
</InquiryUpload>
```

## Verwandte Themen

* Wegweiser: [Service und App](https://dokumentation.websale.de/v8s/schnittstellen/service-und-app.md)
* Wegweiser: [SOAP-from-Shop](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/soap-from-shop.md)
* Wegweiser: [Upload-Modul für Formulare mit INQUIRY](https://dokumentation.websale.de/v8s/upload-modul/upload-modul-fuer-formulare-mit-inquiry.md)


## Related topics

- [Marketing, SEO und externe Portale](https://dokumentation.websale.de/v8s/schnittstellen/marketing-seo-und-portale.md)
- [Service und App](https://dokumentation.websale.de/v8s/schnittstellen/service-und-app.md)
- [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)
- [$wsForm - Formulare](https://dokumentation.websale.de/frontend/referenz/module/wsform.md)


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