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.
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:
Das Dokument InventoryReport besteht aus den drei Haupt-Elementen InventoryReport
,
InventoryItem
und Client
.
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 ) |
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 ) |
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>
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 ) |