CommerceDB Anleitung
Aus ITscope GmbH - Wissensbasis
Inhaltsverzeichnis |
1 Allgemein
Die Kurzanleitung beschreibt die nötigen Schritte, falls Sie Ihren Kunden bereits eine Preisliste zum Download bereitstellen.
Ausführliche Hinweise zum Generieren und zum Bereitstellen der Preisliste folgen unten.
- Teilen Sie uns den Link zu Ihrer Preisliste mit. Falls eine Authentifizierung zum Download bzw. ein Shop-Login nötig ist, benötigen wir zudem einen entsprechenden Account.
- Bestimmen Sie, welche Felder zum Einbinden vorgesehen sind.
Wichtig: Teilen Sie uns mit, ob Sie Standardpreise und/oder Verfügbarkeiten im MarketViewer veröffentlichen wollen. - Liegt Ihre Preisliste in einem maschinenlesbaren Tabellenformat (CSV, XLS, TXT, DBF, ...) oder XML vor, wird sie innerhalb von wenigen Tagen in den MarketViewer integriert.
- Sie zeigen individuelle Preise oder Echtzeit-Verfügbarkeitsanzeigen in Ihrem Online-Shop an bzw. verfügen über entsprechende Schnittstellen? Wenden Sie sich zur Integration in den MarketViewer an unseren Support
- Teilen Sie uns den Vertriebskontakt mit, der im MarketViewer angezeigt werden soll - Telefonnummer und Name (optional).
1.1 Erstellen der Preisliste
Die Qualität Ihrer Preisliste beeinflusst einerseits die Darstellung Ihres Produktangebots im MarketViewer, andererseits die Zuordnung Ihrer Produkte zum ITscope Produktkatalog. Prinzipiell gilt: Je mehr Informationen Ihre Preisliste enthält, desto besser wird das Ergebnis.
Eine Auflistung der derzeit unterstützten Feldtypen zusammen mit Beispielen finden Sie im Download-Bereich. Auch darüber hinaus gehende Informationen (z. B. Zubehörreferenzen) sind in den MarketViewer integrierbar.
Im folgenden finden Sie die wichtigsten Felder und ihren Einfluss auf die Darstellungs- und Zuordnungsqualität.
| Feldtyp | Besonderheiten | Darstellung | Zuordnung |
|---|---|---|---|
| Kategorie | Sollte ein- oder mehrspaltig ausgeführt sein. | Falls keine Kategoriespalte vorhanden ist, wird Ihre Preisliste nach Herstellern oder schlimmstenfalls unsortiert im MarketViewer präsentiert. Zwei bis drei Spalten sind für die Darstellung im MarketViewer optimal. | Eine sinnvolle Kategorisierung verbessert die Integration Ihres Produktstamms in den MarketViewer deutlich.
|
| Hersteller | Möglichst jeden Hersteller nur einmal, d.h. nicht z.B. Microsoft OEM, Microsoft Retail, Microsoft Lizenzen, sondern NUR Microsoft!
| Die Hersteller-Angabe wird zur sortierten Anzeige Ihrer Produkte sowie zur Prüfung Ihrer EAN-Angabe verwendet. | Wichtig: Falls Ihre Produkte noch nicht im ITscope Produktkatalog vorhanden sind, können sie nur hinzugefügt werden, wenn eine Herstellerspalte vorhanden ist. |
| Hersteller-Artikelnummer | Darf nicht zusammen mit EANs gemischt in eine Spalte exportiert werden und umgekehrt | Ohne Angabe einer Hersteller-Artikelnummer werden Ihre Produkte evtl. nur über die "erweiterte Suche" zurückgeliefert, da Ergebnisse mit Hersteller-ProduktID bevorzugt zurückgeliefert werden. | Die Zuordnung Ihrer Produkte zum ITscope Produktkatalog kann deutlich sicherer durch die Angabe einer Hersteller-Artikelnummer erreicht werden. Allerdings nur wenn diese auch eindeutig ist! Falls Sie die identische Hersteller-Artikelnummer für verschiedene Produkte verwenden wird diese dadurch automatisch ungültig für die Zuordnung! |
| EAN/UPC | Darf nur aus Ziffern bestehen und möglichst ohne Leerzeichen zwischen den Ziffern. Nur echte Hersteller-EANs oder UPC-Codes werden akzeptiert! | Intern wird Ihre EAN auf das gültige 13-stellige Format erweitert, d.h. Sie können die führenden Nullen weglassen. | EAN-Codes werden zur einwandfreien Zuordnung Ihres Produktangebots eingesetzt. Ein Neueintrag eines Produkts mit EAN-Code erfordert eine eindeutige Herstellerangabe. Falls Sie den identische EAN/UPC Code für verschiedene Produkte verwenden wird diese dadurch automatisch ungültig für die Zuordnung! |
| Produktbezeichnung | Verwenden Sie eine möglichst kurze Produktbezeichnung. Produktbeschreibungen und ergänzende Angaben sollten in getrennten Spalte exportiert werden. | ||
| Distributor-Artikelnummer | Muß eindeutig sein. Manchmal wird die gleiche Distributor-Artikelnummer für mehrere Produkte oder Produktvarianten verwendet; hiervon ist dringend abzuraten, da zu jeder Distributor-Artikelnummer nur eine Bezugsquelle in die Datenbank übernommen werden kann! Die weiteren Preislistenzeilen werden beim Einlesen ignoriert! | ||
| Deeplink | Direkter Link zu dem Produkt in Ihrem Online-Shop. Alternativ: ein Schema, in das ihre Artikelnummer einsetzbar ist, sodass der Deeplink für jedes Produkt generiert werden kann.
| ||
| Preisstaffeln | Nach Menge gestaffelte Preise können mit konstanten oder produktspezifischen Staffelmengen aus Ihrer Preisliste importiert werden. | ||
| Packungsgrößen | Angaben wie 4 Kartons à 100 Stück können derzeit nicht verarbeitet werden. Falls Sie ein Produkt in größeren Blockgrößen verkaufen, werden Angaben wie DVD-Laufwerk 25er oder 50-Pack automatisch erkannt. Sie müssen für verschiedene Packungsgrößen desselben Produkts unterschiedliche Artikelnummern verwenden, es sei denn Sie geben Preisstaffeln innnerhalb einer Preislistenzeile an (siehe Preisstaffeln). | ||
| Verfügbarkeit / Lagerbestand | Als Zahlencodes zur Beschreibung des Lagerbestandes, zur Kappung können bei größeren Stückzahlen, diese dann wie folgt dargestellt werden, z.B. mehr als 100 Stück, als 100+ aber NICHT als >100, da dies zu Problemen bei der Erkennung führen kann. Besser wäre wenn Sie uns den korrekten Lagerbestand liefern und wir dann nach Ihren Vorgaben die Umwandlung von z.B. 685 in 500+ vornehmen, da hier Falscherkennungen und Probleme ausgeschlossen werden können.
Angaben wie End-of-Life, Neues Produkt, Sonderaktion etc. können ebenfalls verarbeitet werden, jedoch müssen solche Informationen in extra Spalten abgebildet werden. | ||
| Statusinformationen / Artikelzustand | Es können beliebige Begriffe oder Zahlencodes zur Beschreibung des Zustands des Produkts (z.B. Gebraucht) verwendet werden, gesonderte Spalten für unterschiedliche Angaben sind von Vorteil. Abgesehen vom Artikelzustand (Gebrauchtware) sollten insbesondere Verkaufsbeschränkungen (z.B. nur in BTO-Systemen) strukturiert angegeben werden. Wird ein identischer Artikel mehrfach (z.B. wg. Gebrauchtstatus oder Sonderaktionsbestand) im Sortiment des Distributors aufgeführt, ist die Angabe eines Statuscodes zur Unterscheidung verpflichtend. | ||
| Sonderaktionen / Sonderpreise | Sonderaktionen des Distributors können mit Name der Aktion, Auslaufdatum, und gesondertem Aktionspreis (wenn dieser für alle Kunden gleich ist) im ITscope MarketViewer abgebildet werden. Alternativ ist eine simple Kennungzeichnung als Aktionspreis möglich.
| ||
1.2 Unterstützte Dateiformate
Bevorzugtes Dateiformat ist die durch Trennzeichen (z. B. ";" , "," , "\t") getrennte CSV- bzw. TXT-Datei. Idealerweise sollte Ihre Preisliste folgendermaßen aufgebaut sein:
- Feld-bzw. Spaltenüberschriften
- jede der folgenden Zeilen sollte einem Produkt entsprechen
Im folgenden sind sämtliche unterstützte Dateiformate mit ihren Besonderheiten aufgeführt:
| Format | Besonderheiten |
|---|---|
| CSV / TXT | Es werden die gängigen Trennzeichen unterstützt.
Wichtig:Falls Trennzeichen und Zeilenumbrüche innerhalb von Feldern auftreten, müssen die entsprechenden Felder korrekt quotiert werden (z.B. Begrenzung durch Anführungszeichen, Verwendung von Escape-Zeichen oder Verdoppelung von Anführungszeichen im Nutztext!). |
| XLS | Excel-Listen können in den meisten Fällen problemlos eingebunden werden.
|
| DBF | Import problemlos möglich |
| XML | Import möglich; DTD sollte vorhanden sein |
| ZIP | Sämtliche oben genannten Formate können gezippt vorliegen (für große Preislisten empfohlen!). |
1.3 Bereitstellen der Preisliste
Preislistenabrufe zur Aktualisieren Ihres Produktstamms (neue Produkte hinzufügen / Abgleich des ITscope Produktdatenbank und der Zuordnungen) erfolgen zwischen 19:00 Uhr abends und 1:00 Uhr morgens.
Abrufe zur Aktualisierung von Standardpreisen und Lagerdaten erfolgen tagsüber zwischen 6:00 und 18:00 Uhr. Ausgelistete Produkte werden ebenfalls tagsüber entfernt.
Die Aktualisierungshäufigkeit wird im Intervall von 20min. bis 3h danach bestimmt, je nachdem, ob und wie stark sich Ihre Preisliste im Tagesverlauf ändert. Falls das Dateidatum Ihrer Preisliste konstant bleibt oder Sie ausschließlich individuelle Realtime-Preise anbieten, erfolgt die Aktualisierung ausschließlich nachts.
Nachfolgend finden Sie sämtliche Bereitstellungsmethoden erklärt:
| Methode | Details | |
|---|---|---|
| FTP-Download | ++ | Die beste und sicherste Möglichkeit, Ihr Angebot einzubinden. Passwortschutz möglich (empfohlen).
Abruf erfolgt im Format ftp://user:passwort@ihrlinkzurpreisliste |
| HTTP-Download | + | Die zweite Möglichkeit, Ihr Angebot einzubinden. Passwortschutz möglich (empfohlen).
Abruf erfolgt im Format http://user:passwort@ihrlinkzurpreisliste |
| FTP-Upload | o | Falls FTP-/HTTP-Zugriff nicht möglich ist, kann in Ausnahmefällen ein FTP-Account auf unserem Server eingerichtet werden: wenden Sie sich an Axel Schmidt. |
Online-Shop (generierte Preisliste) | - | Preislisten welche nur per Login oder Crawling der Webseite zum Abruf bereitstehen werden nicht mehr akzeptiert! |
| - | Preislisten per eMail werden nicht mehr akzeptiert! |
1.4 Einschränken der zu veröffentlichenden Daten
Ihre Daten werden grundsätzlich nach Ihren eCommerce-Nutzungsrichtlinien eingebunden. Darüber hinaus können Sie bestimmte Kategorien von der übernahme in die CommerceDB ausnehmen. Folgende Varianten der Einbindung Ihres Produktangebots in die CommerceDB sind möglich:
- Stammdaten: Lediglich Informationen zur Zuordnung Ihres Artikels werden übernommen (Produktbezeichner und Artikelnummern)
- Individuell: Die Produktinformationen (Beschreibung etc.) Ihrer Preisliste werden übernommen, Preise und Statusangaben werden jedoch ausgeblendet.
- Standard: Produktinformationen, Verfügbarkeitsdaten und Standardpreise werden übernommen.
- Erweitert: Bilder oder Datenblätter werden als URL von der Preisliste übernommen und im MarketViewer zugänglich gemacht.
Weitere Informationen (Zubehörreferenzen, Technische Daten) können auf Anfrage integriert werden.
Zusätzlich zu produktspezifischen Daten werden zur Anzeige im MarketViewer Ihre Adresse incl. Vertriebskontakt sowie Links zu AGBs, Versandkosten, RMA- und Neukundenantrag übernommen.
1.5 Realtime-Schnittstellen / Individuelle Konditionen
Falls Sie Ihren Kunden individuelle Preise anbieten und z. B. im Online-Shop oder per Web-Schnittstelle jedem Kunden seinen persönlichen Preis zum Abruf bereitstellen, oder falls Sie Ihre Verfügbarkeitsanzeige im Online-Shop in Echtzeit aktualisieren, ist eine Direktanbindung Ihrer Online-Systeme an den MarketViewer sinnvoll.
Die Handhabung individueller Preise soll für die Nutzer des MarketViewers so unkompliziert wie möglich ablaufen. Der von uns angestrebte Idealfall sieht daher vor, daß für den Abruf von Realtime-Preisen und -Verfügbarkeiten lediglich die Angabe der bestehenden Login/Passwort-Kombination (bspw. für den Onlineshop) nötig ist. Falls Ihre Online-Systeme einen speziellen Web Service-Account oder ähnliches erfordern, sollten MarketViewer-Nutzer diesen erhalten.
Wichtig: ITscope erlangt weder Informationen über Accounts noch über erfolgte Preis- oder Verfügbarkeitsabrufe. Sämtliche Kommunikation erfolgt ausschließlich direkt zwischen Client(MarketViewer) und Ihrem (Web-)Server.
Folgende Varianten sind möglich:
| Art der Anbindung | Besonderheiten |
|---|---|
| XML-Schnittstelle | Wir benötigen einen entsprechenden Test-Zugang und die offizielle Schnittstellendokumentation |
| HTTP-Schnittstelle | Teilen Sie uns das Format der HTTP/GET-Anfrage mit |
| Der MarketViewer automatisiert den Anmelde-Vorgang in Ihren Online-Shop sowie den Abruf der entsprechenden Produktseite.
Diese Art der Anbindung wird nicht mehr unterstützt. |
1.6 Kundenindividuelle Preisliste
Um für Kunden individuelle Preise einzuspielen, wird eine gesonderte Liste mit individuellem Zugang für den Kunden benötigt. Diese Liste muss mindestens Ihre Distributor-Artikelnummer und den kundenindividuellen Preis beinhalten.
Bevorzugtes Dateiformat ist die durch Trennzeichen (z. B. ";" , "," , "\t") getrennte CSV- bzw. TXT-Datei mit einem Zeilenende-Trenner \r\n. Ihre Preisliste sollte folgende Kriterien zwingend erfüllen:
- als erste Zeile Feld-bzw. Spaltenüberschriften
- jede der folgenden Zeilen muss einem Produkt entsprechen
- Keine Zusatzangaben in der Artikelnummer Spalte, ausschliesslich die Artiklenummer muss darin vorkommen
- Keine Währungsangaben oder sonstiger Text in der Preisspalte
| Format | Besonderheiten |
|---|---|
| CSV / TXT | Es werden die gängigen Trennzeichen unterstützt.
Wichtig:Falls Trennzeichen und Zeilenumbrüche innerhalb von Feldern auftreten, müssen die entsprechenden Felder korrekt quotiert werden (z.B. Begrenzung durch Anführungszeichen, Verwendung von Escape-Zeichen oder Verdoppelung von Anführungszeichen im Nutztext!). |
| DBF | Import problemlos möglich |
Nachfolgend finden Sie sämtliche Bereitstellungsmethoden erklärt:
| Methode | Details | |
|---|---|---|
| FTP-Download | ++ | Die beste und sicherste Möglichkeit, Ihr Angebot einzubinden. Passwortschutz möglich (empfohlen).
Abruf erfolgt im Format ftp://user:passwort@ihrlinkzurpreisliste |
| HTTP-Download | + | Die zweite Möglichkeit, Ihr Angebot einzubinden. Passwortschutz möglich (empfohlen).
Abruf erfolgt im Format http://user:passwort@ihrlinkzurpreisliste |
1.7 In Planung
Unser Hauptanliegen ist die Vereinfachung der Abläufe zwischen Groß- und Einzelhandel. über die reine Kommunikationsschnittstelle (Produkt-, Preis- und Verfügbarkeitsabrufe) hinaus sind folgende Anbindungen in Entwicklung:
- Einheitliche Neukundenanmeldung per MarketViewer
- Bestellschnittstelle
Kontakt: Benjamin Mund