Formatbeschreibung: InventoryReport¶

Allgemeines¶

Das Dokument InventoryReport dient zur Übertragung einer Inventurliste vom Kunden (POS) an die Zentrale eines Filialverbundes oder an den Hersteller. Der beständige Datenaustausch zwischen Verkaufsstellen (Geschäften/Filialen) und dem Hersteller garantiert, dass beim Hersteller stets die exakte Menge verfügbar ist und für Statistikzwecke genutzt werden kann.

Aufbau des Formates für Austausch von Inventurdaten¶

Das Format für den Austausch von Inventurdaten basiert auf dem Katalog-Format Catalog.xml.

Für eine einfache Realisierung des Inventurberichtes ist nur eine kleine Anzahl von Informationen erforderlich. Für die verschiedenen Anwendungsfällen können zusätzlich weitere Informationen übergeben werden.

Ein Inventursbericht bezieht sich immer auf einen bestimmten Zeitpunkt, der im Dokument unter inventorydate angegeben werden muss.

Die Validierung erfolgt auf Basis der jeweils aktuellsten Schema-Version. Diese ist unter folgender Url erreichbar:

https://templates.look4optics.com/v_1_13/InventoryReport.xsd

Dokumenten-Aufbau¶

Das Dokument InventoryReport besteht aus den drei Haupt-Elementen InventoryReport, InventoryItem und Client.

Detaillierte Formatbeschreibung¶

Element `InventoryReport`¶

Das Element InventoryReport besteht mindestens aus den Attributen generationDate, inventoryDate, inventoryReportID, schemaMajorVersionID, schemaMajorVersionID und supplierID sowie den Elementen Client und InventoryItems. Das Element InventoryItems kann aus einem oder mehreren Elementen InventoryItem bestehen.

Generell können Artikel auf zwei Arten beschrieben werden. Entweder über eine eindeutige ID, die genau eine Variante (SKU) definiert (z.B. EAN oder UPC-Code) oder über die Artikel-ID (Modellnummer bei Fassungen) und die zur Identifizierung der Variante erforderlichen Features (im Katalog als bestellrelevant definierten Produkteigenschaften).

Beispiel XML-Code:

<InventoryReport xsi:noNamespaceSchemaLocation=
  "https://templates.look4optics.com/v_1_13/InventoryReport.xsd"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  schemaMajorVersionID="1" schemaMinorVersionID="13"
  inventoryReportID="IR-2017-02-21-115"
  generationDate="2017-02-21T09:52:23.9305444+02:00"
  inventoryDate="2017-02-21T09:52:23.9305444+02:00"
  supplierID="233212312">
    <Client clientID="31024" />
    <InventoryItems>
        <InventoryItem inventoryQuantity="2" articleID="L0505" articleName="">
            <Configuration>
              <Feature templateID="Diameter" selectedValue="14.20"/>
              <Feature templateID="RadiusBasecurve" selectedValue="8.70"/>
              <Feature templateID="Sphere" selectedValue="-9.00"/>
            </Configuration>
        </InventoryItem>
        <InventoryItem inventoryQuantity="3" articleID="L0506" articleName="">
            <Configuration>
                <Feature templateID="Diameter" selectedValue="14.40"/>
                <Feature templateID="RadiusBasecurve" selectedValue="8.80"/>
                <Feature templateID="Sphere" selectedValue="-7.00"/>
                <Feature templateID="Cylinder" selectedValue="-1.25"/>
                <Feature templateID="AxisCylinder" selectedValue="70"/>
            </Configuration>
        </InventoryItem>
        <InventoryItem inventoryQuantity="4" articleID="02030" articleName="">
            <Configuration>
                <Feature templateID="FrameColour" selectedValue="silver"/>
                <Feature templateID="LensColour" selectedValue="polar gray"/>
                <Feature templateID="FrameTempleLength" selectedValue="125"/>
            </Configuration>
        </InventoryItem>
        <InventoryItem inventoryQuantity="3" articleID="L7928" articleName="">
            <Configuration>
                <Feature templateID="EanCode" selectedValue="4026587082069"/>
            </Configuration>
        </InventoryItem>
    </InventoryItems>
</InventoryReport>

Attribute	Type / Use	Description / Example
`corporateOfficeType`	`xs:NMTOKEN` `optional`	(z.B. `headquarter`)
`currency`	`xs:string`	(z.B. `EURO`)
`generationDate`	`xs:dateTime` `required`	(z.B. `2011-02-11T11:48:34`)
`generatorInfo`	`xs:string` `optional`	(z.B. `Look4 Webservices Test`)
`inventoryDate`	`xs:dateTime` `required`	(z.B. `2011-02-11T11:48:34`)
`inventoryReportID`	`xs:string` `required`	(z.B. `IR-Branch-312-2011-01-03`)
`inventoryReportName`	`xs:string` `optional`	(z.B. `Report-Branch-312-contact lense stock`)
`messageNumber`	`xs:string` `optional`	(z.B. `IR-20110211105912-123`)
`schemaMajorVersionID`	`xs:integer` `required`	(z.B. `1`)
`schemaMinorVersionID`	`xs:integer` `required`	(z.B. `0`)
`supplierID`	`xs:string` `required`	(z.B. `012345`)

Hinweis: In zukünftigen Versionen werden für das Attribut inventoryReportID nur noch Buchstaben, Ziffern, Bindestrich und Unterstrich zugelassen sein. Das Attribut muss einmalig je Lieferant und Kundennummer sein.

Element `InventoryItem`¶

Das Element InventoryItem beinhaltet die Statusmeldung für einen bestimmten Artikel bzw. eine bestimmte Artikelkonfiguration.

Das Element InventoryItem besitzt folgende Attribute:

Example XML-Code:

<InventoryItem inventoryQuantity="2" articleID="L0505"
  articleName="Biomedics 55" recommendedRetailPrice="10"
  articleGroupCode="AGBC" articleGroupDescription="contact lenses"
  articleGroupCodeRetailer="123456" brand="Biomedics" purchasePrice="100">
    <Configuration>
        <Feature templateID="Diameter" selectedValue="14.20"/>
        <Feature templateID="RadiusBasecurve" selectedValue="8.70"/>
        <Feature templateID="Sphere" selectedValue="-9.00"/>
    </Configuration>
</InventoryItem>

Attribute	Type / Use	Description / Example
`articleGroupCode`	`xs:string` `optional`	(z.B. `B-451`)
`articleGroupCodeRetailer`	`xs:string` `optional`	(z.B. `CL-soft`)
`articleGroupDescription`	`xs:string` `optional`	(z.B. `C-2716`)
`articleID`	`xs:string` `required`	(z.B. `A2780`)
`articleName`	`xs:string` `required`	(z.B. `Smith Optics Ltd.`)
`brand`	`xs:string` `optional`	(z.B. `Zeiss`)
`grossUnitPrice`	`xs:decimal` `optional`	(z.B. `12`)
`inventoryQuantity`	`xs:decimal` `required`	(z.B. `` 12``)
`purchasePrice`	`xs:decimal` `optional`	(z.B. `10`)
`recommendedRetailPrice`	`xs:decimal` `optional`	(z.B. `20,50`)
`retailPrice`	`xs:decimal` `optional`	(z.B. `19,50`)

Hinweis: Das Attribut articleName wird in zukünftigen Versionen optional sein und kann leer gelassen werden.

Element `Client`¶

Das Element Client beinhaltet alle Informationen zum Kunden an den die Ware versendet wird. Es beinhaltet ein Unter-Element Addresses mit mindestens einem Unter-Element Address in dem die Adresse definiert wird.

Example XML-Code:

<Client clientID="31024" clientName="Karl Friedrich GmbH">
    <Addresses>
        <Address addressID="1" addressType="MainAddress"
          name="Karl Friedrich GmbH" street="Strasse 123" zip="54332"
          city="Koeln" isoCountryCode="DE" phone="+49-12345-65498"
          fax="+49-12345-65498" clientType="Retailer"/>
    </Addresses>
</Client>

Attribute des Elements `Client`¶

Attribute	Type / Use	Description / Example
`clientID`	`xs:string` `required`	(z.B. `012345`)
`clientName`	`xs:string` `optional`	(z.B. `Smith Optics Ltd.`)
`responseMail`	`xs:string` `optional`	(z.B. `response@optician-test-smith.co.uk`)

Formatbeschreibung: InventoryReport¶

Allgemeines¶

Aufbau des Formates für Austausch von Inventurdaten¶

Dokumenten-Aufbau¶

Detaillierte Formatbeschreibung¶

Element InventoryReport¶

Element InventoryItem¶

Element Client¶

Attribute des Elements Client¶

Element `InventoryReport`¶

Element `InventoryItem`¶

Element `Client`¶

Attribute des Elements `Client`¶