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:

http://templates.look4optics.com/v_2_0/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=
  "http://templates.look4optics.com/v_2_0/InventoryReport.xsd"
  schemaMajorVersionID="1" schemaMinorVersionID="13"
  messageNumber="4314314321432" inventoryReportID="IR-2017-02-21-115"
  generationDate="2017-02-21T09:52:23.9305444+02:00"
  currency="EURO" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  corporateOfficeType="store" inventoryDate="2017-02-21T09:52:23.9305444+02:00"
      supplierID="233212312" >
    <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" email="infotest@optik-friedrich.de"
              clientType="Retailer"/>
        </Addresses>
    </Client>
    <InventoryItems>
        <InventoryItem inventoryQuantity="2" articleID="L0505"
          articleName="Biomedics 55" recommendedRetailPrice="10"
                      articleGroupCode="AGBC" articleGroupDescription="contact lenses"
          articleGroupCodeRetailer="123456" brand="Biomedics"
          purchasePrice="100" >
            <Configuration quantity="1">
              <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="Consan Pflege 360 ml" brand="CooperVision"
          recommendedRetailPrice="20" articleGroupCode="AGBC"
                      articleGroupDescription="care" articleGroupCodeRetailer="123457"
                      purchasePrice="200" >
            <Configuration quantity="3">
                <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="Aigner 02030-00001" brand="Aigner"
          recommendedRetailPrice="40" articleGroupCode="SGBC"
                      articleGroupDescription="sunglasses"
          articleGroupCodeRetailer="123458" purchasePrice="300" >
            <Configuration quantity="1">
                <Feature templateID="FrameColour" selectedValue="silver"/>
                <Feature templateID="LensColour" selectedValue="polar gray"/>
                <Feature templateID="FrameTempleLength" selectedValue="125"/>
            </Configuration>
        </InventoryItem>
        <InventoryItem inventoryQuantity="3" articleID="L7928"
          articleName="Trient 1256" brand="Koberg+Tente"
          recommendedRetailPrice="50" articleGroupCode="FGBC"
                      articleGroupDescription="frames"
          articleGroupCodeRetailer="123459" purchasePrice="400" >
            <Configuration quantity="1">
                <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)

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 quantity="1">
        <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)
eanCode xs:string optional EAN-Code, 13 Ziffern (z.B. 7234567891234)
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)
transactionType xs:NMTOKEN optional (z.B. sale)
upcCode xs:string optional UPC-Code, 12 Ziffern (z.B. 723456789123)

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:NMTOKEN required (z.B. 012345)
clientName xs:NMTOKEN optional (z.B. Smith Optics Ltd.)
responseMail xs:string optional (z.B. response@optician-test-smith.co.uk)
Impressum