Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
typeflat

Die Operation GetItemDetails dient zum Abfragen der Details zu einem Artikel, identifiziert durch seine Artikelnummer The operation GetItemDetails is used to query the details of an article, identified by its article number (SellersItemIdentification)Die Anfrage ist ein Element .

The request is an element comprising vco:GetItemDetailsRequest, dieses erweitert den Typ an extension of the type vct:RequestType um das verbindliche Element by the mandatory element cac:SellersItemIdentification und das optionale Element and the optional element cbc:Quantity.

...

Rule:

...

Serialization of GetItemDetailsRequest

In addition to the parameters of RequestType, the following parameters are used:

  • SellersItemIdentification

  • Quantity

  • quantityUnitCode

Als Wert des ersten Parameters ist der Inhalt des ID-Elements des gleichnamigen Elements zu verwenden, als Wert des zweiten Parameters der Inhalt des Elements Quanity und als Wert des dritten Parameters der Wert des Attributs quantityUnitCode des Elements Quantity.

Die Antwort ist ein Element vco:GetItemDetailsResponse, welches den Typ vct:ResponseType um die optionalen Elemente vco:Item (vom Typ Serving as the value of the first parameter is the content of the ID element of the element of the same name, serving as the value of the second parameter is the content of the quantity element, and serving as the value of the third parameter is the value of the QuantityUnitCode attribute of the quantity element.

The response is an element vco:GetItemDetailsResponse which extends the type vct:ResponseType with the optional elements vco:Item (of type cac:ItemType), vco:Availability und and vco:RequestReplacement erweitert.

...

Rule: GetItemDetails

Ein veloconnect-konformer Server muss die Operation GetItemDetails implementieren und reagiert auf eine Anfrage GetItemDetailsRequest wie folgt:

...

Es wird überprüft, ob SellersItemIdentification eine gültige Artikelkennzeichnung ist. Falls nicht, wird - sofern dies möglich ist - aus den Angaben ein Element RequestReplacement gemäß Regel: RequestReplacement erzeugt, und es wird mit Punkt 4. fortgefahren. Ansonsten wird ein Element ItemUnknown aus der übergebenen SellersItemIdentification erzeugt und mit Punkt 4. fortgefahren.

...

Aus dem Warenwirtschaftssystem werden die Stammdaten des identifizierten Artikels ermittelt und im Element Item abgelegt.

...

Die Verfügbarkeit des Artikels sollte aus aktuell verfügbaren Daten des Warenwirtschaftssystems ermittelt werden und gemäß Regel: Availability im Element Availability abgelegt werden. Falls der Server diese Information nicht zur Verfügung stellt, muss dies im VeloconnectProfil angegeben werden.

...

A Veloconnect-compliant server must implement the GetItemDetails operation, and responds to a GetItemDetailsRequest as follows:

  1. A check is performed as to whether SellersItemIdentification is a valid item identifier. If not, the information is used to generate, if possible, a RequestReplacement element as per Rule: RequestReplacement, and Point 4 is proceeded with. Otherwise, an ItemUnknown element is created from the submitted SellersItemIdentification, and Point 4 is proceeded with.

  2. The identified item's master data are determined from the merchandise management system and stored in an Item element.

  3. The item's availability should be determined from the data present in the merchandise management system, and stored in the Availability element as per Rule: Availability. If the server does not provide this information, it must be specified in the Veloconnect profile.

  4. The determined information is to be returned with ResponseCode 200.