FTP-Datenaustausch (Stand: Januar 2015)

soft-carrier GmbH Hardhofstraße 17 CH 8424 Embrach Telefon: 044 - 8 66 30 00 Fax: 044 - 8 66 30 04 E-Mail: [email protected] Web: www.softcarrier.ch

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")

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 ZIPDateien 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 12.04.2014 wurde übernommen. (Fullload vom12.4.14). Um an den folgenden Tagen das Datenvolumen zu reduzieren, genügt es die Änderungen einzuspielen. (z.B. UPD140513, UPD140514... UPDAKTUELL). Bei der Verarbeitung der Updates sind erst die Löschungen vorzunehmen. Der FULL-Load beinhaltet bereits die Änderungen des Ordners UPDAKTUELL.

2. Artikelhierarchie und Ordnung bei soft-carrier Über 50.000 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 DownloadDateien 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 • oder das Icon „Katalogseite“ anklicken als HTML • oder nach Klicken des Buttons „mehr Information“ in der unteren Hälfte der Darstellung als PHP.

(Referenz 22 in Anlage E) (Referenz 32 in Anlage E) (Referenz 34 in Anlage E)

3. Inhalt der Download-Ordner Innerhalb der Download-Ordner "FULL", "UPDAKTUELL" und "UPDJJMMTT" existieren folgende Dateien: • DATA.ZIP • PREIS.ZIP • REFER.ZIP

• PDF.ZIP

• PREVIEW • RTF.ZIP

• GRAPHIK.ZIP

(enthält: DATA.CSV) = Artikelbeschreibung (enthält: PREIS.CSV) = Preisliste (nur im FULL-Verzeichnis verfügbar) (enthält: REFER.CSV) = alle bei soft-carrier gepeicherten Artikelnummern von Fremdanbietern inklusive des EAN- und OEM-Codes ( nur im FULLVerzeichnis verfügbar) (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. (enthält Produktbilder) = Die Vorschaubilder der Suchergebnisliste stehen unter Datenblatt-Nummer.JPG in der Datei PREVIEW.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. 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

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 40.000 Dateien). • LAGERBESTAND.ZIP

Der Download-Ordner "LAGERBESTAND" enthält die Datei 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 (Full-load)

• UPDAKTUELL (letztes Update)

• UPDJJMMTT (Update JJMMTT)

• LAGERBESTAND (akt. Lagerbestand)

* JJMMTT.TXT * PREVIEW.ZIP * DATA.ZIP * REFER.ZIP * PDF.ZIP * RTF.ZIP * PREIS.ZIP * GRAPHIK1.ZIP * GRAPHIK2.ZIP * GRAPHIK3.ZIP * GRAPHIK4.ZIP

* PREVIEW.ZIP * DATA.ZIP * PDF.ZIP * RTF.ZIP * GRAPHIK1.ZIP * GRAPHIK2.ZIP * GRAPHIK3.ZIP * GRAPHIK4.ZIP

* PREVIEW.ZIP * DATA.ZIP * PDF.ZIP * RTF.ZIP * GRAPHIK1.ZIP * GRAPHIK2.ZIP * GRAPHIK3.ZIP * GRAPHIK4.ZIP

* LAGERBESTAND.CSV

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.

Anlage A Satzaufbau Artikeldatei Feldnummer 1 2 3 4 5 6 7 8

Feldname STATUS ARTNR MTC KURBEZ LT FREI GEWICHT VOLUMEN

Länge 1 18 12 20 60 0 9 13

Format A/N N A/N A/N A/N

9 10 11 12 13

FEINGEW VERPEH PRBEZ VPE MWST

10 9 5 6 2

999999,999 N N N N

14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36

DIM1MENGE DIM1BREITE DIM1HOEHE DIM1TIEFE DIM1GEW DIM1VOL DIM1VERS DIM2MENGE DIM2BREITE DIM2HOEHE DIM2TIEFE DIM2GEW DIM2VOL DIM2VERS DIM3MENGE DIM3BREITE DIM3HOEHE DIM3TIEFE DIM3GEW DIM3VOL DIM3VERS SEPMIN SEPMAX

18 18 19 19 19 18 2 18 18 19 19 19 18 2 18 18 19 19 19 18 2 17 17

99999999999999,999 99999999999999,999 99999999999999,999 99999999999999,999 99999999999999,999 99999999,999999999 N 99999999999999,999 99999999999999,999 99999999999999,999 99999999999999,999 99999999999999,999 99999999,999999999 N 99999999999999,999 99999999999999,999 99999999999999,999 99999999999999,999 99999999999999,999 99999999,999999999 N N N

9999,999 999999,999999

Inhalt N=Neuartikel,A=Änderung,L=Löschung, F=Fullload Bestellnummer in unseren Shops Matchcode Suchbegriff zur Artikelfindung Artikelkurzbezeichnung Artikellangtext Frei Gewicht in Kilogrammpro Einzelstück Volumen in cbmpro Einzelstück Feingewicht in Gramm. Bei einigen Artikeln ist hier das Gewicht ohne Verpackung eingetragen Anzahl Einzelartikel in der Verpackung Preisbezugsgröße, Vk-Preis für x Stück VPE Mehrwertsteuercode 9=keine MWST, 1=volle MWST, 2= halbe MWST Es gibt max. 3 Beschreibungen der Artikeldimensionnen bezogen auf die Menge (z.B. Umverpackung Palette etc.) Breite in mmbei obiger Menge Höhe in mmbei obiger Menge Tiefe in mmbei obiger Menge Gewicht in Grammbei obiger Menge Volumen in cbmbei obiger Menge 1= Versand mit Spedition bei obiger Menge, 0= Normalversand 2. Menge für die folgenden Artikeldimensionen Breite in mmbei obiger Menge Höhe in mmbei obiger Menge Tiefe in mmbei obiger Menge Gewicht in Grammbei obiger Menge Volumen in cbmbei obiger Menge 1= Versand mit Spedition bei obiger Menge, 0= Normalversand 3. Menge für die folgenden Artikeldimensionen Breite in mmbei obiger Menge Höhe in mmbei obiger Menge Tiefe in mmbei obiger Menge Gewicht in Grammbei obiger Menge Volumen in cbmbei obiger Menge 1= Versand mit Spedition bei obiger Menge, 0= Normalversand separater Paketversand bei minimumMenge imPaket separater Paketversand maximale Menge imPaket

Referenz zur Anlage E/F 1

2 27

3 28

37 38 39 40 41 42 43

MENGSTRECK MENGSPED ZOLLTARIF URLAND OEMNR EANNR MARKE

18 18 20 2 15 18 30

N N A/N A/N A/N A/N A/N

44 45 46 47 48 49 50 51 52 53

ANTEIL ME KAPNR KAPBEZ KATNR KATBEZ HGRNR HGRBEZ UGRNR UGRBEZ

14 40 3 40 3 40 3 40 3 40

9999999,999999 A/N N A/N N A/N N A/N N A/N

54 55 56

DBLNR DBLBEZ BILD

5 40 5

N A/N N

57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77

PDF-RTF ZUS1 ZUS2 ZUS3 ZUS4 ZUS5 ZUS6 ZUS7 ZUS8 ZUS9 ZUS10 ZUS11 ZUS12 ZUS13 ZUS14 ZUS15 ZUS16 ZUS17 ZUS18 ZUS19 ZUS20

5 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60

N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N

ab dieser Menge wird per Strecke versendet ab dieser Menge wird per Spedition versendet Zolltarifnummer Ursprungsland ISO 3166 ISO-ALPHA-2-CODE OEM-Nummer EAN-Nummer Produktmarke Der Wert durch den der VK-Preis geteilt wird umden Grundpreis pro Mengeneinheit zu erhalten Bezeichnung der Mengeneinheit Kapitelnummer Kapitelbezeichnung Kategorienummer Kategoriebezeichnung Hauptgruppennummer Hauptgruppenbezeichnung Untergruppennummer Untergruppenbezeichnung Datenblattnummer über die mehrere Artikel zusammengefasst werden. Ist auch der Verzeichnisname in demdie Artikelbilder, Filme etc. abgelegt sind. Datenblattbezeichnung Gibt die Kopfnummer der zugehörigen Vorschaubildes imJPEG-Verzeichnis an Ist der Name der zugehörigen PDF-Datei imPDF-Verzeichnis (RTF im RTF-Verzeichnis) Artikelzusatztext1 Artikelzusatztext2 Artikelzusatztext3 Artikelzusatztext4 Artikelzusatztext5 Artikelzusatztext6 Artikelzusatztext7 Artikelzusatztext8 Artikelzusatztext9 Artikelzusatztext10 Artikelzusatztext11 Artikelzusatztext12 Artikelzusatztext13 Artikelzusatztext14 Artikelzusatztext15 Artikelzusatztext16 Artikelzusatztext17 Artikelzusatztext18 Artikelzusatztext19 Artikelzusatztext20

16 17 18 19 20 29 30 31 32 21 33 22/27 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23

78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121

ZUS21 ZUS22 ZUS23 ZUS24 ZUS25 ZUS26 ZUS27 ZUS28 ZUS29 ZUS30 ZUS31 ZUS32 ZUS33 ZUS34 ZUS35 ZUS36 ZUS37 ZUS38 ZUS39 ZUS40 ZUS41 ZUS42 ZUS43 ZUS44 ZUS45 ZUS46 ZUS47 ZUS48 ZUS49 ZUS50 ZUS51 ZUS52 ZUS53 ZUS54 ZUS55 ZUS56 ZUS57 ZUS58 ZUS59 ZUS60 TAB1BEZ TAB1INH TAB2BEZ TAB2INH

60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60

A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N

Artikelzusatztext21 Artikelzusatztext22 Artikelzusatztext23 Artikelzusatztext24 Artikelzusatztext25 Artikelzusatztext26 Artikelzusatztext27 Artikelzusatztext28 Artikelzusatztext29 Artikelzusatztext30 Artikelzusatztext31 Artikelzusatztext32 Artikelzusatztext33 Artikelzusatztext34 Artikelzusatztext35 Artikelzusatztext36 Artikelzusatztext37 Artikelzusatztext38 Artikelzusatztext39 Artikelzusatztext40 Artikelzusatztext41 Artikelzusatztext42 Artikelzusatztext43 Artikelzusatztext44 Artikelzusatztext45 Artikelzusatztext46 Artikelzusatztext47 Artikelzusatztext48 Artikelzusatztext49 Artikelzusatztext50 Artikelzusatztext51 Artikelzusatztext52 Artikelzusatztext53 Artikelzusatztext54 Artikelzusatztext55 Artikelzusatztext56 Artikelzusatztext57 Artikelzusatztext58 Artikelzusatztext59 Artikelzusatztext60 Überschrift1 der Produktbeschreibungstabelle Produktbeschreibung zu obiger Überschrift Überschrift2 der Produktbeschreibungstabelle Produktbeschreibung zu obiger Überschrift

23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 24 25 24 25

122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138

TAB3BEZ TAB3INH TAB4BEZ TAB4INH TAB5BEZ TAB5INH TAB6BEZ TAB6INH TAB7BEZ TAB7INH TAB8BEZ TAB8INH TAB9BEZ TAB9INH TAB10BEZ TAB10INH LETTERF

60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 1

A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N A/N N

Überschrift3 der Produktbeschreibungstabelle Produktbeschreibung zu obiger Überschrift Überschrift4 der Produktbeschreibungstabelle Produktbeschreibung zu obiger Überschrift Überschrift5 der Produktbeschreibungstabelle Produktbeschreibung zu obiger Überschrift Überschrift6 der Produktbeschreibungstabelle Produktbeschreibung zu obiger Überschrift Überschrift7 der Produktbeschreibungstabelle Produktbeschreibung zu obiger Überschrift Überschrift8 der Produktbeschreibungstabelle Produktbeschreibung zu obiger Überschrift Überschrift9 der Produktbeschreibungstabelle Produktbeschreibung zu obiger Überschrift Überschrift10 der Produktbeschreibungstabelle Produktbeschreibung zu obiger Überschrift beimVersand von den Dimensionen "Letter-fähig" in der kleinsten VPE (1=ja)

24 25 24 25 24 25 24 25 24 25 24 25 24 25 24

Anlage B Satzaufbau Preisdatei Feldname Status Artikelnummer PREIS1 MENGE1 PREIS2 MENGE2 PREIS3 MENGE3 PREIS4 MENGE4 PREIS5 MENGE5 PREIS6 MENGE6

Länge 1 18 10 11 10 11 10 11 10 11 10 11 10 11

Format A/N N 9999999,99 9999999,999 9999999,99 9999999,999 9999999,99 9999999,999 9999999,99 9999999,999 9999999,99 9999999,999 9999999,99 9999999,999

Inhalt N=Neuartikel,A=Änderung,L=Löschung, F=Fullload Artikelnummer Verkaufspreis1 Netto aus der Preisstaffel Menge 1 ab der der obiger Verkaufspreis genommen wird Verkaufspreis 2 Netto aus der Preisstaffel Menge 2 ab der der obiger Verkaufspreis genommen wird Verkaufspreis 3 Netto aus der Preisstaffel Menge 3 ab der der obiger Verkaufspreis genommen wird Verkaufspreis 4 Netto aus der Preisstaffel Menge 4 ab der der obiger Verkaufspreis genommen wird Verkaufspreis 5 Netto aus der Preisstaffel Menge 5 ab der der obiger Verkaufspreis genommen wird Verkaufspreis 6 Netto aus der Preisstaffel Menge 6 ab der der obiger Verkaufspreis genommen wird

Referenz zur Anlage E 1 4 5 6 7 8 9 10 11 12 13 14 15

Anlage C Satzaufbau Referenzdatei Feldname Artikelnummer REFERENZNR1 NRFREMD1 NAMEFREMD1

Länge 18 18 3 30

Format N A/N N A/N

Obige 3-er Gruppe kann sich bis zu 30 mal wiederholen

Inhalt Artikelnummer 1. Referenznummer Softcarrier-Interne Nummer des Fremdanbieters Name des Fremdanbieters

Anlage D Satzaufbau Lagerbestandsdatei Feldname Artikelnummer LGBST WBZ

Länge 18 10 5

Format N N A/N

Inhalt Artikelnummer aktueller verfügbarer Lagerbestand nächster Liefertermin wenn Bestand nicht ausreichen. Beisp.: KW 34

Anlage E Artikeldarstellung im Web

Anlage F Artikelhierarchie im Web