FTP-Datauitwisseling. soft-carrier

Transkript

1 FTP-Datauitwisseling (versie Januari 2015) soft-carrier SAS 27A rue Denis Papin COLMAR Telephone: Fax: Web: Inhoud: Algemeen: 1. De download folder 2. Artikelhiearchie 3. Inhoud van de download folder 4. Opbouw van artikel-informatie over het algemeen 5. Opbouw van Prijs / Referentiedata / Voorrraadinformatie over het algemeen 6. Overzicht van de Folder Structuur 7. Technische wetenswaardigheden ten behoeve van het gebruik van de data Bijlagen: Bijlage A: Uitleg bij het bestand DATA.CSV Bijlage B: Uitleg bij het bestand PREIS.CSV Bijlage C: Uitleg bij het bestand REFER.CSV Bijlage D: Uitleg bij het bestand met voorraadinformatie LAGERBESTAND.CSV Bijlage E: Productpresentatie op het internet Bijlage F: Artikelhierarchie op het internet (De bijlagen kunt u vinden in het document "FTP-Anlagen_de.pdf")

2 Algemeen Met de artikelbestanden heeft u de mogelijkheid om op eenvoudige wijze uw eigen artikelbestand te verrijken met de soft-carrier producten. In Combinatie met ons EDI datauitwisselingssysteem voor het plaatsen van opdrachten en het ontvangen van opdrachtbevestigingen, levergegevens en facturen bent u in staat om zelf een zeer efficiënte orderverwerkingsmethode in uw organisatie te presenteren. De soft-carrier artikelbestanden bevatten: Korte productomschrijvingen (ASCII formaat) Uitgebreide productomschrijvingen (RTF Formaat) Afbeeldingen van producten thumbnail (JPEG formaat) Afbeeldingen van producten in hogere resolutie (JPEG formaat) Product Videos (WMV formaat) Datasheets van producten (PDF formaat) Daarnaast ontvangt u ook een databestand met voorraadinformatie. Dit bestand wordt permanent bijgewerkt. De Artikelbestanden zijn beschikbaar in de Duitse alsmede de Franse taal. Ze zijn beschikbaar als.zip-bestand en worden u ter beschikking gesteld via FTP toegang. Die deutschen Daten stehen im Verzeichnis "ARTIKELDATEN DEUTSCH" Die französischen Daten stehen im Verzeichnis "ARTIKELDATEN FRANZÖSISCH" Die Lagerbestandsdatei steht im Verzeichnis "LAGERBESTAND" Die Daten orientieren sich an unserem Internetauftritt und sind zusätzlich angereichert um Daten aus unserem Warenwirtschaftssystem. (Siehe Satzaufbau mit Referenznummern). Als Anlage ist die Artikeldarstellung im WEB mit den Referenznummern zu den Satzdefinitionen vorhanden. 1. Die Download-Ordner Die Download-Ordner auf dem FTP-Server haben folgende Namen: FULL enthält die aktuellen Daten des gesamten Artikelbestandes. Innerhalb des Ordners existiert eine Datei mit dem Namen JJMMTT.TXT = Erstellungsdatum Jahr/Monat/Tag UPDAKTUELL enthält nur die Änderungen des letzten Tages UPDJJMMTT enthalten die Änderungen des jeweiligen Tages LAGERBESTAND enthält nur die Datei mit dem aktuellen Bestand Anwendungsbeispiel: Ordner FULL vom wurde übernommen. (Fullload vom ). Um an den folgenden Tagen das Datenvolumen zu reduzieren, genügt es die Änderungen einzuspielen. (z.b. UPD140513, UPD UPDAKTUELL). Bei der Verarbeitung der Updates sind erst die Löschungen vorzunehmen. Der FULL-Load beinhaltet bereits die Änderungen des Ordners UPDAKTUELL.

3 2. Artikelhierarchie und Ordnung bei soft-carrier Über Produkte sind in folgender Hierarchie im soft-carrier WebShop eingeordnet: Kapitel Kategorien Hauptgruppen Untergruppe Produkt-Datenblatt Dabei sind zusammengehörige Produkte einem Datenblatt zugeordnet. Diese Struktur lässt sich sehr gut in unserem WebShop erkennen, indem man den "Suchbaum" auf der rechten Bildschirmseite aktiviert. Ein Produkt kann in dieser Struktur mehrmals vorkommen (z.b. Klebstoff in dem Kapitel Bürobedarf und im Kapitel Schule) und ist daher auch mehrfach in den Download- Dateien vorhanden. Das Produkt-Datenblatt mit seiner 5-stelligen Nummer (im weiteren Datenblattnummer genannt) wird im folgenden für die Systematisierung der Speicherung häufiger angewendet. Sie finden die Datenblattnummer in unserem WebShop wenn Sie auf das Icon Datenblatt in der Artikeldetailansicht (Referenz 22 in Anlage E) klicken. In der sich öffnenden Anzeige steht die Datenblattnummer rechts oben in der roten Zeile. Den Inhalt des Datenblattes ersehen Sie: indem Sie das Icon Datenblatt anklicken als PDF (Referenz 22 in Anlage E) oder das Icon Katalogseite anklicken als HTML (Referenz 32 in Anlage E) oder nach Klicken des Buttons mehr Information (Referenz 34 in Anlage E) in der unteren Hälfte der Darstellung als PHP. 3. Inhalt der Download-Ordner Innerhalb der Download-Ordner "FULL", "UPDAKTUELL" und "UPDJJMMTT" existieren folgende Dateien: DATA.ZIP (enthält: DATA.CSV) = Artikelbeschreibung PREIS.ZIP (enthält: PREIS.CSV) = Preisliste (nur im FULL-Verzeichnis verfügbar) REFER.ZIP (enthält: REFER.CSV) = alle bei soft-carrier gepeicherten Artikelnummern von Fremdanbietern inklusive des EAN- und OEM-Codes ( nur im FULL- Verzeichnis verfügbar) PDF.ZIP (enthält PDF-Datenblätter) = die Produkt-Datenblätter stehen als PDF-Dateien in PDF.ZIP zur Verfügung. Die einzelne PDF-Datei ist unter der 5-stelligen Datenblattnummer.PDF gespeichert. PREVIEW (enthält Produktbilder) = Die Vorschaubilder der Suchergebnisliste stehen unter Datenblatt-Nummer.JPG in der Datei PREVIEW.ZIP. RTF.ZIP (enthält Produkttexte) = Die Texte der Produktdatenblätter (Referenz 26 in Anlage E) sind als RTF-Datei in RTF.ZIP unter dem Namen Datenblattnummer.RTF gespeichert. GRAPHIK?.ZIP Bilder, ergänzende Informationen als PDF, Produktvideos (Format WMV) und andere graphische Elemente (Referenz 21 in Anlage E) sind datenblattbezogen in den ZIP-Dateien GRAPHIK1.ZIP, GRAPHIK2.ZIP, GRAPHIK3.ZIP, GRAPHIK4.ZIP abgelegt. Innerhalb der ZIP-Dateien sind die Dateien mit der Datenblattnummer als Pfad gespeichert. Um eine handhabbare Dateigröße zu erreichen, ist die erste Stelle der Datenblattnummer ausschlaggebend für die

4 Zuweisung zu GRAPHIK?.ZIP. Beim Extrahieren der Daten wird die Datenblattnummer als Ordner erstellt und die zugehörigen Dateien in diesen eingestellt. ACHTUNG: Kein Copy / Paste aus der ZIP-Datei benutzen. Im Update-Verzeichnis werden nur die Kopfverzeichnisse erstellt, bei denen sich die Detaibilder etc. geändert haben. ACHTUNG!! Dieser Bereich ist ist im Full-Load sehr groß (ca.10 GB mit über Dateien). LAGER- Der Download-Ordner "LAGERBESTAND" enthält die Datei BESTAND.ZIP LAGERBESTAND.CSV mit dem aktuellen Lagerbestand. Er wird permanent aktualisiert. Für Print-Zwecke stehen auf Anfrage auch druckfähige Bilder sowie Marken-Logos zur Verfügung. 4. Satzaufbau Artikelbeschreibung allgemein (DATA.CSV) hat variable Feldlängen, getrennt mit senkrechtem Strich (Hex = 7C). Der Zeichensatz ist Windows-Zeichensatz Zum besseren Verständnis von Datenfeld zur Artikelansicht ist im Satzaufbau der Artikeldaten, ist bei einigen Feldern eine Referenznummer zur Darstellung im WebShop eingefügt. Numerische Felder werden immer mit führenden Nullen ausgegeben und haben eine feste Feldlänge. 5. Preisdatei / Referdatei / Bestandsdatei Die Preisdatei, Referenzdatei und Bestandsdatei werden analog zur Artikeldatei ausgegeben und haben die gleichen Regeln. Die Preisdatei wird immer komplett ausgegeben und liegt in Verzeichnis "FULL". Die Lagerbestandsdatei wird auch immer komplett ausgegeben in das Download-Ordner "LAGERBESTAND". 6. Verzeichnisstruktur ( = Verzeichnis * = Datei JJMMTT = JahrMonatTag) FULL UPDAKTUELL UPDJJMMTT LAGERBESTAND (Full-load) (letztes Update) (Update JJMMTT) (akt. Lagerbestand) * JJMMTT.TXT * PREVIEW.ZIP * PREVIEW.ZIP * LAGERBESTAND.CSV * PREVIEW.ZIP * DATA.ZIP * DATA.ZIP * DATA.ZIP * PDF.ZIP * PDF.ZIP * REFER.ZIP * RTF.ZIP * RTF.ZIP * PDF.ZIP * GRAPHIK1.ZIP * GRAPHIK1.ZIP * RTF.ZIP * GRAPHIK2.ZIP * GRAPHIK2.ZIP * PREIS.ZIP * GRAPHIK3.ZIP * GRAPHIK3.ZIP * GRAPHIK1.ZIP * GRAPHIK4.ZIP * GRAPHIK4.ZIP * GRAPHIK2.ZIP * GRAPHIK3.ZIP * GRAPHIK4.ZIP

5 7. Technische Einzelheiten zur Datenübertragung Wir betreiben einen FTP-Server unter ftp.softcarrier.com. Dieser Server steht Ihnen bis auf eine Pause zwischen 4:30-5:00 Uhr rund um die Uhr zur Verfügung. Bitte platzieren Sie ihre Downloads abends bis früh morgens; tagsüber begrenzen wir die Datenrate. Bitte verwenden Sie einen FTP-Client der mit Dateien > 2 GB umgehen kann. Über einen Testzugang zu unserem FTP-Server können sie sich Beispieldateien herunterladen: Benutzername: Passwort: testuser sctestsc Sie sollten folgendes Bild sehen: Bitte machen Sie sich mit Ordnerstruktur vertraut und nehmen Sie Downloads vor. Über das Kundenverzeichnis können individuelle Dateien (z. B. EDI) ausgetauscht werden.