vcc:ItemInformation

Der Typ cac:ItemType besitzt als Kind-Element das Element vcc:ItemInformation, um weitergehende Informationen zu einem Artikel zu übermitteln. Dieses Element ist wie folgt aufgebaut:

Regel: ItemInformation

• Bei Verwendung der Elemente vcc:InformationURL ist die Art der angegebenen Links durch Verwendung des Elements vcc:Disposition vom Typ vcc:InformationDispositionType anzugeben. Eine Tabelle der hierfür zulässigen Werte findet sich im Anschluss. Mehrfachnennungen sind möglich, sofern das verlinkte Dokument verschiedene Arten von Informationen enthält. Bei Verwendung der Art "general" sollte im Element vcc:Description eine prägnante Beschreibung mitteilen, welche Art von Information über den Link erhalten werden kann.

• Falls Elemente vcc:ClassificationGroupMember oder vcc:ScalePriceGroup verwendet werden, muss die Operation GetClassificationScheme implementiert werden.

• Die Zugehörigkeit zu einer Gruppe eines Klassifikationsschemas wird im Element vcc:ClassificationGroupMember durch die ID des zugehörigen Schemas und die ID der Gruppe mitgeteilt. Sofern Mitgliedschaft in mehreren Gruppen eines Schemas besteht, darf höchstens für eine Gruppe das Attribut primaryGroup den Wert true haben. Bei einer hierarchischen Gruppenstruktur ist jeweils nur die Zugehörigkeit zur jeweils untersten Gruppe in dieser Hierarchie mitzuteilen.

• Wird das Element vcc:ScalePriceGroup verwendet, wird zur Ermittlung des Einzelpreises in einer Bestellung die für diesen Artikel definierte Preisfunktion (vgl. Regel: BasePriceType) nicht auf die Bestellmenge dieses Artikels angewendet, sondern auf die Summe der Bestellmengen aller Artikel, deren Element vcc:ScalePriceGroup den gleichen Inhalt hat.

Regel: ItemInformation ab Version 1.5

• Wird als vcc:InformationDispositionType der Wert product_data angegeben, muss die URI auf die Produktdaten für den Artikel verlinken. In welchem Standard die verlinkten Produktdaten bereitstehen wird mit dem Element Standard bestimmt. Das Format hinter der URI wird im Element Format angegeben. Die Version des Standards im Element Version. Mit diesen drei Werten kann ein client schon vor Abruf der URI ermitteln, welcher Standard in welchem Format und in welcher Version abgerufen werden kann.

• Das Element Standard muss nur angegeben werden, wenn als vcc:InformationDispositionType der Wert product_data angegeben ist. Im Element Standard wird der Name das Standards übermittelt in welchem die Produktdaten abgerufen werden können. Neben der Angabe eines beliebigen Werts für den Standard gibt es zum aktuellen Zeitpunkt bereits am Markt übliche Standards dessen Angabe aus der folgenden Tabelle entnommen werden kann. Hierbei ist es wichtig, dass für diese Standards exakt der Wert aus der Tabelle verwendet wird.

• Das Element Format muss nur angegeben werden, wenn als vcc:InformationDispositionType der Wert product_data angegeben ist. Im Element Format wird das Format angegeben, welches sich hinter der URI verbirgt. Beim Wert für das Format sollte darauf geachtet werden übliche Bezeichnungen für Datenformate zu verwenden und diese stets in Großbuchstaben anzugeben. Neben der Angabe eines eignen Werts für das Format gibt es zum aktuellen Zeitpunkt bereits am Markt übliche verwendete Formate dessen Angabe aus der folgenden Tabelle entnommen werden kann. Hierbei ist es wichtig, dass für diese Formate exakt der Wert aus der Tabelle verwendet wird.

• Das Element Version muss nur angegeben werden, wenn als vcc:InformationDispositionType der Wert product_data angegeben ist. Im Element Version wird die Version des Standards angegeben, in welcher die Daten hinter der URI bereitgestellt werden. Beispiele: 1.6 oder 3.0

• Alle Informationen hinter einer verlinkten URI können auch eine Authentifizierung benötigen. Ab Version 1.5 ist es nun auch möglich dem Client mitzuteilen, welche Werte für eine Authentifizierung nötig sind. Dafür können optional mit dem Element vcc:AuthorisationType z.B. ein ApiKey, ein ApiSecret, ein Passwort oder ein Username ausgegeben werden. Der Client kann diese Informationen nutzen um die URI aufzurufen und sich zu authentifizieren.

Standard

Format

InformationDispositionType