Operation: GetItemDetails

Die Operation GetItemDetails dient zum Abfragen der Details zu einem Artikel, identifiziert durch seine Artikelnummer (SellersItemIdentification)

Die Anfrage ist ein Element vco:GetItemDetailsRequest, dieses erweitert den Typ vct:RequestType um das verbindliche Element cac:SellersItemIdentification und das optionale Element cbc:Quantity.

Regel: Serialisierung von GetItemDetailsRequest

Zusätzlich zu den Parametern von RequestType werden folgende Parameter verwendet:

  • 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 cac:ItemType), vco:Availability und vco:RequestReplacement erweitert.

Regel: GetItemDetails

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

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

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

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

  4. Die ermittelten Angaben sind mit ResponseCode 200 zurückzugeben.