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)