WS-Anfragedaten

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. Lässt sich in Ihrem System kein SOAP umsetzen, geht es alternativ über den WSOM-from-Shop, 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

<Item>
  <Name>LastName</Name>
  <Descr>Nachname</Descr>
  <Value>Müller</Value>
</Item>

Werte dürfen mehrzeilig sein:

<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

<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

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

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

<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

<InquiryUpload>
  <UploadID>11AABBCC</UploadID>
  <Item>
    <Filename>Datei1.jpg</Filename>
  </Item>
  <Item>
    <Filename>Datei2.jpg</Filename>
  </Item>
</InquiryUpload>

Schnittstellen

Wie Eingabefelder abgebildet werden

Sektion Header

Sektion ID

Sektionen CustomerAddress und DeliveryAddress

Sektion Inquiry

Sektion InquiryUpload

Verwandte Themen

​Wie Eingabefelder abgebildet werden

​Sektion Header

​Sektion ID

​Sektionen CustomerAddress und DeliveryAddress

​Sektion Inquiry

​Sektion InquiryUpload

​Verwandte Themen

Wie Eingabefelder abgebildet werden

Sektion Header

Sektion ID

Sektionen CustomerAddress und DeliveryAddress

Sektion Inquiry

Sektion InquiryUpload

Verwandte Themen