FTP-Datenaustausch (Stand: Januar 2015) soft-carrier

Transkript

1 FTP-Datenaustausch (Stand: Januar 2015) soft-carrier GmbH Hardhofstraße 17 CH 8424 Embrach Telefon: Fax: Web: Inhaltsübersicht: Allgemein: 1. Die Download-Ordner 2. Artikelhierarchie 3. Inhalt der Download-Ordner 4. Satzaufbau Artikeldaten allgemein 5. Satzaufbau Preis / Referenzdaten / Lagerbestand allgemein 6. Übersicht Verzeichnisstruktur 7. Technische Einzelheiten zu Datenübertragung Anlagen: Anlage A: Satzaufbau Artikeldatei DATA.CSV Anlage B: Satzaufbau Preisdatei PREIS.CSV Anlage C: Satzaufbau Referenzdatei REFER.CSV Anlage D: Satzaufbau Lagerbestandsdatei LAGERBESTAND.CSV Anlage E: Artikeldarstellung im WEB Anlage F: Artikelhierarchie im WEB (Die Anlagen finden Sie in der "FTP-Anlagen_ch.pdf")

2 Allgemein Mit den Artikeldaten haben Sie die Möglichkeit, einfach und rationell ihre eigene Datenbasis um den soft-carrier Artikelstamm zu erweitern. In Kombination mit unserem EDI-Datenaustauschformat für Aufträge, Auftragsbestätigungen, Lieferavis und Rechnung können sie einen hocheffizienten Bestellablauf in ihrem Unternehmen installieren. Die soft-carrier Artikeldaten setzen sich zusammen aus: Produkt-Kurztexte (ASCII-Format) Produkt-Beschreibungen, ausführlich (RTF-Format) Produkt-Vorschaubilder (JPEG-Format) Produkt-Detailbilder (JPEG-Format) Produkt-Videos (WMV-Format) Produkt-Datenblätter (PDF-Format) Zusätzlich wird eine Lagerbestandsdatei zur Verfügung gestellt, die permanent aktualisiert wird. Die Artikeldaten liegen in den Sprachen DEUTSCH und FRANZÖSISCH vor und sind als ZIP- Dateien per FTP abrufbar. 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 Zuweisung zu GRAPHIK?.ZIP. Beim Extrahieren der Daten wird die

4 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.

6 Anlage A Satzaufbau Artikeldatei Feldnummer Feldname Länge Format Inhalt Referenz zur Anlage E/F 1 STATUS 1 A/N N=Neuartikel,A=Änderung,L=Löschung, F=Fullload 2 ARTNR 18 N Bestellnummer in unseren Shops 1 3 MTC 12 A/N Matchcode Suchbegriff zur Artikelfindung 4 KURBEZ 20 A/N Artikelkurzbezeichnung 5 LT 60 A/N Artikellangtext 2 6 FREI 0 Frei 7 GEWICHT ,999 Gewicht in Kilogrammpro Einzelstück 27 8 VOLUMEN , Volumen in cbmpro Einzelstück 9 FEINGEW ,999 Feingewicht in Gramm. Bei einigen Artikeln ist hier das Gewicht ohne Verpackung eingetragen 10 VERPEH 9 N Anzahl Einzelartikel in der Verpackung 3 11 PRBEZ 5 N Preisbezugsgröße, Vk-Preis für x Stück VPE 6 N VPE 13 MWST 2 N Mehrwertsteuercode 9=keine MWST, 1=volle MWST, 2= halbe MWST 14 DIM1MENGE ,999 Es gibt max. 3 Beschreibungen der Artikeldimensionnen bezogen auf die Menge (z.b. Umverpackung Palette etc.) 15 DIM1BREITE ,999 Breite in mmbei obiger Menge 16 DIM1HOEHE ,999 Höhe in mmbei obiger Menge 17 DIM1TIEFE ,999 Tiefe in mmbei obiger Menge 18 DIM1GEW ,999 Gewicht in Grammbei obiger Menge 19 DIM1VOL , Volumen in cbmbei obiger Menge 20 DIM1VERS 2 N 1= Versand mit Spedition bei obiger Menge, 0= Normalversand 21 DIM2MENGE , Menge für die folgenden Artikeldimensionen 22 DIM2BREITE ,999 Breite in mmbei obiger Menge 23 DIM2HOEHE ,999 Höhe in mmbei obiger Menge 24 DIM2TIEFE ,999 Tiefe in mmbei obiger Menge 25 DIM2GEW ,999 Gewicht in Grammbei obiger Menge 26 DIM2VOL , Volumen in cbmbei obiger Menge 27 DIM2VERS 2 N 1= Versand mit Spedition bei obiger Menge, 0= Normalversand 28 DIM3MENGE , Menge für die folgenden Artikeldimensionen 29 DIM3BREITE ,999 Breite in mmbei obiger Menge 30 DIM3HOEHE ,999 Höhe in mmbei obiger Menge 31 DIM3TIEFE ,999 Tiefe in mmbei obiger Menge 32 DIM3GEW ,999 Gewicht in Grammbei obiger Menge 33 DIM3VOL , Volumen in cbmbei obiger Menge 34 DIM3VERS 2 N 1= Versand mit Spedition bei obiger Menge, 0= Normalversand 35 SEPMIN 17 N separater Paketversand bei minimummenge impaket 36 SEPMAX 17 N separater Paketversand maximale Menge impaket

7 37 MENGSTRECK 18 N ab dieser Menge wird per Strecke versendet 38 MENGSPED 18 N ab dieser Menge wird per Spedition versendet 39 ZOLLTARIF 20 A/N Zolltarifnummer 40 URLAND 2 A/N Ursprungsland ISO3166 ISO-ALPHA-2-CODE 41 OEMNR 15 A/N OEM-Nummer EANNR 18 A/N EAN-Nummer MARKE 30 A/N Produktmarke ANTEIL , Der Wert durch den der VK-Preis geteilt wird umden Grundpreis pro Mengeneinheit zu erhalten ME 40 A/N Bezeichnung der Mengeneinheit KAPNR 3 N Kapitelnummer 47 KAPBEZ 40 A/N Kapitelbezeichnung KATNR 3 N Kategorienummer 49 KATBEZ 40 A/N Kategoriebezeichnung HGRNR 3 N Hauptgruppennummer 51 HGRBEZ 40 A/N Hauptgruppenbezeichnung UGRNR 3 N Untergruppennummer 53 UGRBEZ 40 A/N Untergruppenbezeichnung DBLNR 5 N Datenblattnummer über die mehrere Artikel zusammengefasst werden. Ist auch der Verzeichnisname in demdie Artikelbilder, Filme etc. abgelegt sind DBLBEZ 40 A/N Datenblattbezeichnung 56 BILD 5 N Gibt die Kopfnummer der zugehörigen Vorschaubildes imjpeg-verzeichnis an PDF-RTF 5 N Ist der Name der zugehörigen PDF-Datei impdf-verzeichnis (RTF im RTF-Verzeichnis) 22/27 58 ZUS1 60 A/N Artikelzusatztext ZUS2 60 A/N Artikelzusatztext ZUS3 60 A/N Artikelzusatztext ZUS4 60 A/N Artikelzusatztext ZUS5 60 A/N Artikelzusatztext ZUS6 60 A/N Artikelzusatztext ZUS7 60 A/N Artikelzusatztext ZUS8 60 A/N Artikelzusatztext ZUS9 60 A/N Artikelzusatztext ZUS10 60 A/N Artikelzusatztext ZUS11 60 A/N Artikelzusatztext ZUS12 60 A/N Artikelzusatztext ZUS13 60 A/N Artikelzusatztext ZUS14 60 A/N Artikelzusatztext ZUS15 60 A/N Artikelzusatztext ZUS16 60 A/N Artikelzusatztext ZUS17 60 A/N Artikelzusatztext ZUS18 60 A/N Artikelzusatztext ZUS19 60 A/N Artikelzusatztext ZUS20 60 A/N Artikelzusatztext20 23

8 78 ZUS21 60 A/N Artikelzusatztext ZUS22 60 A/N Artikelzusatztext ZUS23 60 A/N Artikelzusatztext ZUS24 60 A/N Artikelzusatztext ZUS25 60 A/N Artikelzusatztext ZUS26 60 A/N Artikelzusatztext ZUS27 60 A/N Artikelzusatztext ZUS28 60 A/N Artikelzusatztext ZUS29 60 A/N Artikelzusatztext ZUS30 60 A/N Artikelzusatztext ZUS31 60 A/N Artikelzusatztext ZUS32 60 A/N Artikelzusatztext ZUS33 60 A/N Artikelzusatztext ZUS34 60 A/N Artikelzusatztext ZUS35 60 A/N Artikelzusatztext ZUS36 60 A/N Artikelzusatztext ZUS37 60 A/N Artikelzusatztext ZUS38 60 A/N Artikelzusatztext ZUS39 60 A/N Artikelzusatztext ZUS40 60 A/N Artikelzusatztext ZUS41 60 A/N Artikelzusatztext ZUS42 60 A/N Artikelzusatztext ZUS43 60 A/N Artikelzusatztext ZUS44 60 A/N Artikelzusatztext ZUS45 60 A/N Artikelzusatztext ZUS46 60 A/N Artikelzusatztext ZUS47 60 A/N Artikelzusatztext ZUS48 60 A/N Artikelzusatztext ZUS49 60 A/N Artikelzusatztext ZUS50 60 A/N Artikelzusatztext ZUS51 60 A/N Artikelzusatztext ZUS52 60 A/N Artikelzusatztext ZUS53 60 A/N Artikelzusatztext ZUS54 60 A/N Artikelzusatztext ZUS55 60 A/N Artikelzusatztext ZUS56 60 A/N Artikelzusatztext ZUS57 60 A/N Artikelzusatztext ZUS58 60 A/N Artikelzusatztext ZUS59 60 A/N Artikelzusatztext ZUS60 60 A/N Artikelzusatztext TAB1BEZ 60 A/N Überschrift1 der Produktbeschreibungstabelle TAB1INH 60 A/N Produktbeschreibung zu obiger Überschrift TAB2BEZ 60 A/N Überschrift2 der Produktbeschreibungstabelle TAB2INH 60 A/N Produktbeschreibung zu obiger Überschrift 25

9 122 TAB3BEZ 60 A/N Überschrift3 der Produktbeschreibungstabelle TAB3INH 60 A/N Produktbeschreibung zu obiger Überschrift TAB4BEZ 60 A/N Überschrift4 der Produktbeschreibungstabelle TAB4INH 60 A/N Produktbeschreibung zu obiger Überschrift TAB5BEZ 60 A/N Überschrift5 der Produktbeschreibungstabelle TAB5INH 60 A/N Produktbeschreibung zu obiger Überschrift TAB6BEZ 60 A/N Überschrift6 der Produktbeschreibungstabelle TAB6INH 60 A/N Produktbeschreibung zu obiger Überschrift TAB7BEZ 60 A/N Überschrift7 der Produktbeschreibungstabelle TAB7INH 60 A/N Produktbeschreibung zu obiger Überschrift TAB8BEZ 60 A/N Überschrift8 der Produktbeschreibungstabelle TAB8INH 60 A/N Produktbeschreibung zu obiger Überschrift TAB9BEZ 60 A/N Überschrift9 der Produktbeschreibungstabelle TAB9INH 60 A/N Produktbeschreibung zu obiger Überschrift TAB10BEZ 60 A/N Überschrift10 der Produktbeschreibungstabelle TAB10INH 60 A/N Produktbeschreibung zu obiger Überschrift 138 LETTERF 1 N beimversand von den Dimensionen "Letter-fähig" in der kleinsten VPE(1=ja)

10 Anlage B Satzaufbau Preisdatei Feldname Länge Format Inhalt Referenz zur Anlage E Status 1 A/N N=Neuartikel,A=Änderung,L=Löschung, F=Fullload Artikelnummer 18 N Artikelnummer 1 PREIS ,99 Verkaufspreis1 Netto aus der Preisstaffel 4 MENGE ,999 Menge 1 ab der der obiger Verkaufspreis genommen wird 5 PREIS ,99 Verkaufspreis 2 Netto aus der Preisstaffel 6 MENGE ,999 Menge 2 ab der der obiger Verkaufspreis genommen wird 7 PREIS ,99 Verkaufspreis 3 Netto aus der Preisstaffel 8 MENGE ,999 Menge 3 ab der der obiger Verkaufspreis genommen wird 9 PREIS ,99 Verkaufspreis 4 Netto aus der Preisstaffel 10 MENGE ,999 Menge 4 ab der der obiger Verkaufspreis genommen wird 11 PREIS ,99 Verkaufspreis 5 Netto aus der Preisstaffel 12 MENGE ,999 Menge 5 ab der der obiger Verkaufspreis genommen wird 13 PREIS ,99 Verkaufspreis 6 Netto aus der Preisstaffel 14 MENGE ,999 Menge 6 ab der der obiger Verkaufspreis genommen wird 15

11 Anlage C Satzaufbau Referenzdatei Feldname Länge Format Inhalt Artikelnummer 18 N Artikelnummer REFERENZNR1 18 A/N 1. Referenznummer NRFREMD1 3 N Softcarrier-Interne Nummer des Fremdanbieters NAMEFREMD1 30 A/N Name des Fremdanbieters Obige 3-er Gruppe kann sich bis zu 30 mal wiederholen

12 Anlage D Satzaufbau Lagerbestandsdatei Feldname Länge Format Inhalt Artikelnummer 18 N Artikelnummer LGBST 10 N aktueller verfügbarer Lagerbestand WBZ 5 A/N nächster Liefertermin wenn Bestand nicht ausreichen. Beisp.: KW 34

13 Anlage E Artikeldarstellung im Web

14 Anlage F Artikelhierarchie im Web