Formatbeschreibung: BarcodeList

Allgemeines

Barcodes gibt es nur für einfache Kontaktlinsen, die der Optiker oft verkauft und deshalb auch auf Lager hat. Die Barcodes werden deshalb auch für diese Produkte benötigt bzw. sind nur für diese vorhanden. Barcodes bringen eine wesentliche Erleichterung im Bereich Lagerverwaltung. Die Erfassung kann dann einfach über den Barcode erfolgen anstatt wie heute jede Linse einzeln erfassen zu müssen. Auch beim Verkauf scannt der Augenoptiker einfach das Produkt und die Ware wird im Lagerbestand abgebucht und berechnet. Darauf aufbauend kann dann z.B. die automatische Nachbestellung realisiert werden. Ein Barcode beschreibt immer genau eine Konfiguration.

Für Private Labels gibt es derzeit bei den meisten Herstellern nur einen Barcode für alle Private-Labels. Das heißt es gibt keine Unterscheidung zwischen PrivatelabelX und PrivatelabelY. Die Zuordnung welches Produkt der Kunde geliefert bekommt erfolgt bei den Lieferanten intern.

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

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

Barcodelisten-Webservice

Der Barcodelisten-Webservice ermöglicht es dem Kunden individuelle Barcodelisten passend zu seinem individuellen Katalog herunterzuladen, d.h. für jede dem Kunden zugeordnete Kundengruppe wird eine Barcodeliste erstellt. Die Barcodelisten werden als Set in einer Zip-Datei zurückgegeben.

Die Verfügbarkeit von Barcodes für einen Artikel wird im Katalog über das Feature BarcodesAvailable definiert. Defaultwert ist „false“, das heißt nur wenn für einen Artikel dieses Feature mit „true“ definiert ist, werden von den Barcodelisten-Webservices Barcodes für diesen Artikel ausgeliefert, auch wenn eine entsprechende Liste im System vorhanden ist.

Der Service liefert eine Barcodeliste mit den kundenspezifischen Labelnamen. Dieser Name muss in der entsprechenden Datei in der Artikelstammdatenverwaltung hinterlegt sein.

Dokumenten-Struktur

Eine Barcodeliste (BarcodeList) besteht aus dem Element Articles mit beliebig vielen Elementen Article (einzelnen Artikeln) mit beliebig vielen Elementen Configuration (Kombinationen an Produkteigenschaften). Einer Konfiguration ist jeweils ein EAN-Barcode zugeordnet. Für jeden BarcodeTyp (UPC, EAN,…) gibt es ein eigenes Feature.

Element BarcodeList

Attribute Type / Use Description / Example
barcodeListID xs:string required Eindeutige ID der Barcodeliste (z.B. 2013-06-20)
barcodeListDescription xs:string optional Kurze Beschreibung der Barcodeliste (z.B. Wöhlk - Barcodeliste 2013 des gesamten Sortiments)
supplierID xs:string required UstID des Herstellers, Land und Nummer ohne Trennzeichen (z.B. DE813058544)
supplierName xs:string optional Name des Herstellers (z.B. Woehlk)
generationDate xs:dateTime optional Datum und Zeit der Barcodelistenerstellung (z.B. 2013-06-20T11:48:34)

Beispiel-XML-Code für eine komplette Barcodeliste

<?xml version="1.0" encoding="UTF-8"?>
<BarcodeList xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
barcodeListID="2017-02-20" barcodeListDescription="Produktsortiment Alcon 2017"
supplierID="DE142102094" supplierName="Alcon Pharma"
generationDate="2017-02-20T10:18:41+02:00"
xsi:noNamespaceSchemaLocation="https://templates.look4optics.com/v_1_13/barcodelist.xsd">
<Articles>
<Article articleID="FND" articleName="Testlinse 1">
    <Configuration>
        <Feature templateID="UpcCode" selectedValue="749590144823"/>
        <Feature templateID="Sphere" selectedValue="4.00"/>
        <Feature templateID="Cylinder" selectedValue="0.00"/>
        <Feature templateID="AxisCylinder" selectedValue="0"/>
        <Feature templateID="Diameter" selectedValue="13.8"/>
    </Configuration>
    <Configuration>
        <Feature templateID="UpcCode" selectedValue="749590144830"/>
        <Feature templateID="Sphere" selectedValue="3.75"/>
        <Feature templateID="Cylinder" selectedValue="0.00"/>
        <Feature templateID="AxisCylinder" selectedValue="0"/>
        <Feature templateID="Diameter" selectedValue="13.8"/>
    </Configuration>
</Article>
<Article articleID="FNA" articleName="Testlinse 2">
    <Configuration>
        <Feature templateID="UpcCode" selectedValue="749590144847"/>
        <Feature templateID="Sphere" selectedValue="3.50"/>
        <Feature templateID="Cylinder" selectedValue="0.00"/>
        <Feature templateID="AxisCylinder" selectedValue="0"/>
        <Feature templateID="Diameter" selectedValue="13.8"/>
    </Configuration>
    <Configuration>
        <Feature templateID="UpcCode" selectedValue="749590144824"/>
        <Feature templateID="Sphere" selectedValue="3.50"/>
        <Feature templateID="Cylinder" selectedValue="0.50"/>
        <Feature templateID="AxisCylinder" selectedValue="0"/>
        <Feature templateID="Diameter" selectedValue="13.8"/>
    </Configuration>
    <Configuration>
        <Feature templateID="UpcCode" selectedValue="749590144859"/>
        <Feature templateID="Sphere" selectedValue="3.50"/>
        <Feature templateID="Cylinder" selectedValue="1.00"/>
        <Feature templateID="AxisCylinder" selectedValue="0"/>
        <Feature templateID="Diameter" selectedValue="13.8"/>
    </Configuration>
</Article>
</Articles>
</BarcodeList>

Attribute des Elements Article

Attribute Type / Use Description / Example
articleID xs:string required Artikelnummer beim Lieferant (z.B. A2780)
articleName xs:string optional Artikelname (z.B. Contact Life Spheric Box)