Preislisten Download

Um das Business so einfach wie möglich mit uns zu gestalten, stellen wir Ihnen für den Import unserer Artikeldaten in Ihr eigenes ERP-System oder direkt in den eigenen Onlineshop, eine täglich aktualisierte, elektronische Preisliste1 zur Verfügung. Dies ist eine perfekte Lösung für Sie, um schnell an alle nötigen Stammdaten zum kompletten COS-Portfolio, auch aktuelle Verfügbarkeiten und Ihre individuellen Einkaufspreise, zu gelangen. Entscheiden Sie selbst, wann Sie die Preisliste von unserem FTP-Server downloaden möchten. Die tägliche Bereitstellung wird von uns sichergestellt. Das Format ist ein Pipe "|" getrenntes Text-Format, um eine hohe Kompatibilität für Ihre Systeme sicherzustellen. Nachfolgend finden Sie unterschiedliche Möglichkeiten und eine ausführliche Beschreibung mit Musterdateien. Die Weitergabe an Dritte ist strengstens untersagt.

Maßgeschneiderte Lösungen (Preisliste, StockInfo, Online-Check)

Basispreisliste

Beziehen Sie kostenfrei mit Ihren Zugangsdaten, die identisch mit denen zum Onlineshop sind, über Ihren FTP-Account auf unserem Server eine individuelle Preisliste. Diese Basispreisliste wird täglich aktualisiert und beinhaltet alle nötigen Artikel-Stammdaten, die aktuellen Verfügbarkeiten und Ihre Einkaufskonditionen bei COS.

Aufruf:	ftp://ftp.cosag.de auf Port 21 Stellen Sie bitte sicher, dass in Ihrem FTP-Client der Dateiübertragungsmodus auf binär (binary) eingestellt ist, um evtl. Importprobleme zu vermeiden.
Login:	Benutzerkennung	Die COS-Benutzerkennung setzt sich aus der 5-stelligen Kundennummer und der 3-stelligen Benutzernummer zusammen
	Passwort	Das Onlinepasswort
Aufbau:	Artikel-Nummer \| Artikel \| Hersteller \| Hersteller-Artikelnummer \| EAN-Code \| Kategorie1 \| Kategorie2 \| Kategorie3 \| Kategorie 4 \| Netto-Preis in EUR \| Status \| Beschreibung \| Tageswerbung \| Bestand \| Gewicht \| Liefertermin
Alternative zu FTP:	Laden Sie sich hier Ihre Basispreisliste runter

Falls Sie noch keinen FTP-Client installiert haben, sollten Sie sich diese kostenlose Software installieren, z.B. über www.filezilla.de.

Die Artikelliste mit einem erweiterten Spaltenaufbau ist eine TXT-Datei mit Spaltennamen in der ersten Zeile. Die Daten sind durch ein Pipe ("|") getrennt. Die Aktualisierung erfolgt einmal werktäglich um 06:00 Uhr.

Verfügbarkeitsdatei

Über einen Link kann jederzeit die Datei "StockInfo" mit aktuellen Preisen, Beständen und – falls vorhanden – Lieferterminen von Ihnen herruntergeladen werden. Der Aktualisierungsintervall beträgt hierbei eine Stunde und Sie können so Ihr System über den Tag hin konstant aktualisieren.

Aufruf für die Stockinfo:	http://www.cosag.de/CMSPages/Onlineservices.asmx/Stockinfo?usernr=[Benutzerkennung]&pwd=[Passwort]
Login:	Benutzerkennung	Die COS-Benutzerkennung setzt sich aus der 5-stelligen Kundennummer und der 3-stelligen Benutzernummer zusammen
	Passwort	Das MD5-kodierte Onlinepasswort (32 Zeichen)²
Aufbau:	Artikel-Nummer\|Bestand\| Netto-Preis in EUR
Ihren persönlichen Link	finden Sie im Abschnitt Hashwert¹

Beachten Sie:

» Jede Änderung des Passworts überträgt sich auch auf den Downloadlink

» Um den Missbrauch und eine Dauerbelastung des Servers zu reduzieren, ist der Download der Verfügbarkeitsliste nur einmal innerhalb einer Stunde je Benutzerkennung möglich

Realtime-Abfrage für COS-Kunden

Mit der Realtime-Abfrage können Sie sich den Bestand und den aktuellen Preis für einen abgefragten Artikel holen, so dass er minutenaktuell ist. Die Realtime Funktion ist besonders praktisch, wenn Fachhändler Artikel aus ihrer Favoritenliste bestellen – dank der präzisen Anzeige sehen Sie sofort den exakten Preis und die verfügbare Stückzahl der gewünschten Produkte. Einschränkung: Um die Last unseres Servers zu minimieren, lassen wir maximal 100 Anfragen pro Kalendertag je Benutzerkennung zu.

Aufruf für den Realtime-Link:	http://www.cosag.de/CMSPages/Onlineservices.asmx/Realtime?usernr=[Benutzerkennung]&pwd=[Passwort]&artnr=[Artikelnummer]
Login:	Benutzerkennung	Die COS-Benutzerkennung setzt sich aus der 5-stelligen Kundennummer und der 3-stelligen Benutzernummer zusammen
	Passwort	Das MD5-kodierte Onlinepasswort (32 Zeichen)²
	Artikelnummer	Die COS-Artikelnummer
Ihren persönlichen Link	finden Sie im Abschnitt Hashwert
XML-Rückgabe zum Beispiel:	<?xml version="1.0" encoding="iso-8859-1"?> <RealData> <MSG ID="0">ok</MSG> <ITEM> <ID>AA00001</ID> <PRICE CURRENCY="EUR">0.00</PRICE> <QTY>99</QTY> <DELDATE></DELDATE> </ITEM> </RealData>

Beachten Sie:

» Jede Änderung des Passworts überträgt sich auch auf den Downloadlink

» Um die Last unseres Servers zu minimieren, lassen wir maximal 100 Anfragen pro Kalendertag je Benutzerkennung zu.

Hashwert:

Ihr persönlicher Hashwert lautet:

Der Aufruf für die Verfügbarkeitsdatei lautet (aus Sicherheitsgründen ist der Link nicht anklickbar):

http://www.cosag.de/CMSPages/Onlineservices.asmx/Stockinfo?usernr=public&pwd=

Der Link für die Realtime-Abfrage lautet (aus Sicherheitsgründen ist der Link nicht anklickbar):

http://www.cosag.de/CMSPages/Onlineservices.asmx/Realtime?usernr=public&pwd=&artnr=

(Vergessen Sie nicht eine gültige Artikelnummer am Ende des Links anzugeben!)

Haftungsausschluss

Wir machen darauf aufmerksam, dass COS keine Haftung für Irrtümer (z.B. fehlerhafte Preise) innerhalb dieser Preiselisten übernimmt.

1: Ein kostenfreier COS e-Service

2: Was ist das MD5-kodierte Onlinepasswort?

Ihre Sicherheit wird bei COS nicht vernachlässigt. Aus diesem Grund ist es bei Realtime-Abfragen notwendig, dass zur Nutzerverifizierung das Passwort herangezogen werden muss, das aber keinesfalls im Klartext übermittelt wird. Bei der Verwendung des MD5-Verfahrens handelt es sich um ein weit verbreitetes kryptographisches Verfahren, das einen 128-Bit-Hashwert erzeugt.

Dieser Hash wird als 32-stellige Hexadezimalzahl notiert. Aus Ihrem Passwort wird dann ein solcher Hashwert erstellt, den Sie im COS Onlineshop im Menü unter "e-Services" > "Preislisten" abrufen können. Dieser Wert bildet dann den Parameter für Ihren individuellen Realtime-Link.

Sollten Sie einmal das Passwort für den OnlineShop ändern oder neu anfordern, zieht dies ebenfalls eine Änderung des Hashwertes nach sich. Diesen müssen Sie dann, damit der Realtime-Link wieder reibungslos funktioniert, ebenfalls ändern.

Mit dieser beschriebenen Maßnahme stellen wir sicher, dass Ihr Passwort niemals ohne Verschlüsselung, also im Klartext, (im Browserlink) sichtbar ist!

COS hat zu keiner Zeit Kenntnis über Ihre Zugangsdaten! Daher können wir - weder telefonisch, noch schriftlich, noch auf anderem Wege - einen Hinweis auf Ihr Passwort oder den Hashwert geben. Nutzen Sie daher bitte die beschriebenen Möglichkeiten im COS Onlineshop.

FAQ zur FTP Preisliste

Was muss ich beachten, um den Download über FTP nutzen zu können?

Für den Download der COS-Preisliste via FTP kann es notwendig sein, gezielt den Port 21 freizugeben, damit ein Router oder eine Firewall alle ein- und ausgehenden Datenpakete passieren lassen kann.

Ports können mit einer Firewall (egal ob als Hardware- oder Softwarelösung) gesperrt werden, um den Datenverkehr zu unterbinden und damit eine Netzwerkverbindung vor Angreifern zu sichern. Bitte berücksichtigen Sie dies bei Ihrer eingesetzten Lösung.

Welchen FTP-Übertragungsmodus muss ich verwenden?

Bei der Nutzung von Standard-FTP-Programmen ist keine Änderung der Voreinstellung notwendig. Hingegen ist es bei der Anwendung von Kommandozeilen-Programmen gegebenenfalls notwendig, in den Passiven FTP Übertragungsmodus umzuschalten.

Wenn sich ein PC hinter einem Router und/oder einer Firewall befindet, kann bei einem Aktiven FTP der COS-Server keine Verbindung zum Client aufbauen. Umgekehrt wiederum kann im "passiven Modus" der Client mit dem Server kommunizieren, der entsprechend IP-Adresse und Port mitteilt und somit von den lokalen Sicherheitseinstellungen akzeptiert wird.

Komfortable FTP-Clients sind als eigenständige Programme erhältlich und bieten meist mehr Einstellungsmöglichkeiten als einfache FTP-Clients, die mittlerweile auch in einigen Browsern enthalten sind.

Wie öffne ich die "artikelliste.txt"?

Die Datei sollte zunächst lokal auf einem PC gespeichert werden, bevor sie weiterverarbeitet wird. In der Regel werden Listen dieser Art durch Importmodule oder durch Importassistenten eingelesen. In beiden Fällen ist zu beachten, dass in der Liste das Pipe als Trennzeichen verwendet wird. Eine einwandfreie Darstellung ist meist in Texteditoren gewährleistet, in der auch der korrekte (west-)europäische Zeichensatz ausgewählt ist.

Treten beim Import oder in der Darstellung Leerzeilen auf, so ist beim Download via FTP darauf zu achten, dass die Einstellung des Transfertyps beim FTP-Client auf binär ("binary") statt ASCII eingestellt wird.