Export

Die Exportfunktion verwenden Sie, um die aktuell im apt-shop gespeicherten Artikeldaten zu exportieren, beispielsweise um sie bei Produktsuchmaschinen zu importieren. Um einen Export durchzuführen, befolgen Sie diese Schritte:

1. Schritt: Exporteinstellungen festlegen (Spalten auswählen)
2. Schritt: Datenfilter anlegen (Datensätze auswählen)
3. Schritt: Exportaufgabe anlegen (Einstellungen und Filter verknüpfen)
4. Schritt: Exportdatei herunterladen

Die Exporteinstellungen

Die Exportkonfiguration enthält die Information, welche Spalten in Ihrer Exportdatei enthalten sein sollen, also welche Daten aus den gewählten Artikeln exportiert werden sollen. Sie können im apt-shop entweder aus einer Vielzahl von vorgefertigten Exportkonfigurationen wählen (z. B. für Marktplätze und Preisvergleichsseiten) oder selbst ein neues Setup anlegen.

Möchten Sie ein eigenes Setup erstellen, klicken Sie auf die Schaltfläche „Neue Exportkonfiguration anlegen“. Hier sind zunächst folgende Einstellungen notwendig:

• Name: Bezeichnung der Exportkonfiguration
• Version: Angabe einer Versionsnummer für die Konfiguration
• Beschreibung: kurze Beschreibung der Verwendung der Exportkonfiguration
• Trennzeichen: Angabe des Trennzeichens, durch das in der Datei die Spalten voneinander getrennt werden (z. B. Semikolon, Komma, Tabulator, Pipe oder Dollar-Zeichen)
• Texterkennungszeichen: Erkennungszeichen für Text (z. B. für Zahlen, die nicht wie numerische Zahlen, sondern wie Text betrachtet werden sollen; notwendig, damit beispielsweise bei mit einer Null beginnenden Zahlenreihe die Null nicht entfernt wird)
• Erste Zeile Spaltenüberschrift: Nein = die Datei wird ohne Überschriften ausgegeben; Ja = es werden Spaltenüberschriften eingefügt

Im Folgenden definieren Sie die Spalten Ihrer Exportkonfiguration – es sind beliebig viele möglich. Sie haben die Wahl zwischen dynamischen Spalten, die die Werte aus dem Shop darstellen, konstanten Spalten sowie einer Spalte als Eingabefeld. Im Rahmen der späteren Konfiguration der Exportaufgabe können Sie diesen Wert im Eingabefeld manuell setzen. Indem Sie ganz unten auf das „Plus“ neben „Verfügbare Spalten“ klicken, wird Ihnen eine Auflistung aller aktuell verfügbaren Spalten angezeigt:

 

 

ItemId	Name	Beschreibung
id	Artikel_id	interne Artikelnummer
variation_id	ArtikelVariation_id	interne Variantennummer
artikel_id	ArtikelNr	Artikelnummer
order_id	BestellNr	Bestellnummer
name	Artikelname mit Varianten	Name des Artikels ggf. mit Varianten
name_only	Artikelname	Name des Artikels
name_with_category	Artikelname mit Kategorie	Name des Artikels mit vorangestelltem Produktgruppennamen
name2	Produktbezeichnung 2 mit Varianten	Name 2 des Artikels ggf. mit Varianten
description	Beschreibung	Die lange Beschreibung des Artikels
description_html	Beschreibung (HTML)	Die lange Beschreibung des Artikels versehen mit einem 'nl2br' (automatische Zeilenumbrüche)
description_nohtml	Beschreibung als Reintext	Die lange Beschreibung des Artikels ohne HTML-Tags
description_html2	Beschreibung 2 (HTML)	Die lange Beschreibung 2 des Artikels versehen mit einem 'nl2br' (automatische Zeilenumbrüche)
description_nohtml2	Beschreibung 2 als Reintext	Die lange Beschreibung 2 des Artikels ohne HTML-Tags
short_description	Kurz-Beschreibung	Die kurze Beschreibung des Artikels
short_description_html	Kurz-Beschreibung (HTML)	Die kurze Beschreibung des Artikels, HTML-formatiert
short_description_nohtml	Kurz-Beschreibung als Reintext	Die kurze Beschreibung des Artikels ohne HTML-Tags
variation_name	Variantenname (komplett)	Die Variantenbezeichnung mit Größe und Farbe
variation_size_name	Variantenname (Größe)	Die Variantenbezeichnung Größe
variation_color_name	Variantenname (Farbe)	Die Variantenbezeichnung Farbe
firm_name	Firmenname	Name des Herstellers, wenn Firma noch nicht vorhanden ist, so wird diese angelegt
firm_id	Firmen ID	ID der shopinternen Herstellerfirma
lieferant_name	Lieferantenname	Name des Lieferanten
tax_wert	Steuersatz	Steuersatz z. B. 19, wenn kein Steuersatz vorhanden ist, dann wird der Standardsteuersatz verwendet
weight	Gewicht	Gewicht des Artikels
weight_point	Gewicht mit Punkt	Gewicht des Artikels mit Punkt als Dezimaltrennzeichen
shippingweight	Versand-Gewicht	Versandgewicht des Artikels (Variante)
shippingweight_point	Versand-Gewicht mit Punkt	Versandgewicht des Artikels (Variante) mit Punkt als Dezimaltrennzeichen
min_orders	Mindestbestellmenge	Die Mindestbestellmenge des Artikels; wenn nicht gesetzt, wird 1 eingetragen
unit_name	Artikeleinheit	Die Einheit des Artikels; wenn nicht vorhanden, wird diese bei Artikeleinheiten angelegt
startseite	Startseitenposition	Soll der Artikel auf der Startseite gezeigt werden? Werte 1 - ja; 0 - nein; Standard ist 0
keywords	Schlüsselwörter	Schlüsselwörter für die Suche
angebot	Angebotsartikel	Ist der Artikel ein Angebot? Werte 1 - ja; 0 - nein; Standard ist 0
lieferbar_name	Lieferstatus	Status der Verfügbarkeit als Wort. Wenn nicht vorhanden, wird dies bei Artikelverfügbarkeiten angelegt
gtin	GTIN	GTIN (Global Trade Item Number) des Artikels. Es wird je nach verfügbarer Angabe EAN, ISBN, UPC oder ASIN verwendet
ean	EAN	EAN (European Article Number) des Artikels
isbn	ISBN	ISBN (International Standard Book Number) des Artikels
upc	UPC	UPC (Universal Product Code) des Artikels
asin	ASIN	ASIN (Amazon Standard Identification Number) des Artikels
status	Artikelstatus	Artikel ist aktiv? Werte 1 - ja; 0 - nein; Standard ist 1
preis	Preis	Der Verkaufspreis des Artikels
preis_point	Preis mit Punkt	Der Verkaufspreis des Artikels mit einem Punkt als Dezimaltrennzeichen
original_preis	Originale Preis	Der ursprüngliche Verkaufspreis des Artikels vor dem Sonderpreis
original_preis_point	Originale Preis mit Punkt	Der ursprüngliche Verkaufspreis des Artikels vor dem Sonderpreis mit einem Punkt als Dezimaltrennzeichen
hpreis	Händlerpreis	Der Händlerpreis des Artikels
original_hpreis	Originale Händlerpreis	Der ursprüngliche Händlerpreis des Artikels vor dem Sonderpreis
original_hpreis_point	Originale Händlerpreis mit Punkt	Der ursprüngliche Händlerpreis des Artikels vor dem Sonderpreis mit einem Punkt als Dezimaltrennzeichen
sopreis	Sonderpreis	Der Sonderpreis des Artikels
hsopreis	Händler-Sonderpreis	Der Händler-Sonderpreis des Artikels
epreis	Einkaufspreis	Der Einkaufspreis des Artikels
gpreis	Grundpreis	Der Grundpreis des Artikels
grundpreis_menge	Vergleichseinheit	Vergleichseinheit für den Grundpreis des Artikels
grundpreis_info	GrundpreisInfo	Information zum Grundpreis des Artikels z. B. 4,50 €/Liter
zustand	Artikelzustand	Der Artikelzustand, 'neu' oder 'gebraucht'
artikel_url	Artikel Url	Link zu dem Artikel in ihren Shop
artikel_url_formated	Artikel Url (formatiert)	Link zu dem Artikel in ihren Shop formatiert, d. h. Rewrite Link, ohne Sprach- und Variantenangabe
artikel_sells	Artikel Verkäufe	Gesamtanzahl der Verkäufe
cat_name	Produktgruppe (1)	Produktgruppe 1 (Stammgruppe)
cat_name2	Produktgruppe (2)	Produktgruppe 2
cat_name3	Produktgruppe (3)	Produktgruppe 3
cat_name4	Produktgruppe (4)	Produktgruppe 4
cat_name5	Produktgruppe (5)	Produktgruppe 5
cat_full_name	Produktgruppenpfad (1) mit >	Produktgruppen (1) als Pfad, wenn Artikel in Untergruppe: dann Format: 'Gruppe1 > Gruppe2 > Gruppe3'
cat_full_name2	Produktgruppenpfad (2) mit >	Produktgruppen (2) als Pfad, wenn Artikel in Untergruppe: dann Format: 'Gruppe1 > Gruppe2 > Gruppe3'
cat_full_name3	Produktgruppenpfad (3) mit >	Produktgruppen (3) als Pfad, wenn Artikel in Untergruppe: dann Format: 'Gruppe1 > Gruppe2 > Gruppe3'
cat_full_name4	Produktgruppenpfad (4) mit >	Produktgruppen (4) als Pfad, wenn Artikel in Untergruppe: dann Format: 'Gruppe1 > Gruppe2 > Gruppe3'
cat_full_name5	Produktgruppenpfad (5) mit >	Produktgruppen (5) als Pfad, wenn Artikel in Untergruppe: dann Format: 'Gruppe1 > Gruppe2 > Gruppe3'
cat_full_name_slash	Produktgruppenpfad (1) mit |	Produktgruppen (1) als Pfad, wenn Artikel in Untergruppe: dann Format: 'Gruppe1 | Gruppe2 | Gruppe3'
cat_full_name_slash2	Produktgruppenpfad (2) mit |	Produktgruppen (2) als Pfad, wenn Artikel in Untergruppe: dann Format: 'Gruppe1 | Gruppe2 | Gruppe3'
cat_full_name_slash3	Produktgruppenpfad (3) mit |	Produktgruppen (3) als Pfad, wenn Artikel in Untergruppe: dann Format: 'Gruppe1 | Gruppe2 | Gruppe3'
cat_full_name_slash4	Produktgruppenpfad (4) mit |	Produktgruppen (4) als Pfad, wenn Artikel in Untergruppe: dann Format: 'Gruppe1 | Gruppe2 | Gruppe3'
cat_full_name_slash5	Produktgruppenpfad (5) mit |	Produktgruppen (5) als Pfad, wenn Artikel in Untergruppe: dann Format: 'Gruppe1 | Gruppe2 | Gruppe3'
pic1_url	Bild 1 Originalgröße	Link zum 1. Artikelbild in Originalgröße
pic1_thumb1_url	Bild 1 Thumbnailgröße 1	Link zum 1. Artikelbild in Thumbnailgröße 1
pic1_thumb2_url	Bild 1 Thumbnailgröße 2	Link zum 1. Artikelbild in Thumbnailgröße 2
pic1_thumb3_url	Bild 1 Thumbnailgröße 3	Link zum 1. Artikelbild in Thumbnailgröße 3
pic1_thumb4_url	Bild 1 Thumbnailgröße 4	Link zum 1. Artikelbild in Thumbnailgröße 4
pic2_url	Bild 2 Originalgröße	Link zum 2. Artikelbild in Originalgröße
pic2_thumb1_url	Bild 2 Thumbnailgröße 1	Link zum 2. Artikelbild in Thumbnailgröße 1
pic2_thumb2_url	Bild 2 Thumbnailgröße 2	Link zum 2. Artikelbild in Thumbnailgröße 2
pic2_thumb3_url	Bild 2 Thumbnailgröße 3	Link zum 2. Artikelbild in Thumbnailgröße 3
pic2_thumb4_url	Bild 2 Thumbnailgröße 4	Link zum 2. Artikelbild in Thumbnailgröße 4
pic3_url	Bild 3 Originalgröße	Link zum 3. Artikelbild in Originalgröße
pic3_thumb1_url	Bild 3 Thumbnailgröße 1	Link zum 3. Artikelbild in Thumbnailgröße 1
pic3_thumb2_url	Bild 3 Thumbnailgröße 2	Link zum 3. Artikelbild in Thumbnailgröße 2
pic3_thumb3_url	Bild 3 Thumbnailgröße 3	Link zum 3. Artikelbild in Thumbnailgröße 3
pic3_thumb4_url	Bild 3 Thumbnailgröße 4	Link zum 3. Artikelbild in Thumbnailgröße 4
pic4_url	Bild 4 Originalgröße	Link zum 4. Artikelbild in Originalgröße
pic4_thumb1_url	Bild 4 Thumbnailgröße 1	Link zum 4. Artikelbild in Thumbnailgröße 1
pic4_thumb2_url	Bild 4 Thumbnailgröße 2	Link zum 4. Artikelbild in Thumbnailgröße 2
pic4_thumb3_url	Bild 4 Thumbnailgröße 3	Link zum 4. Artikelbild in Thumbnailgröße 3
pic4_thumb4_url	Bild 4 Thumbnailgröße 4	Link zum 4. Artikelbild in Thumbnailgröße 4
pic5_url	Bild 5 Originalgröße	Link zum 5. Artikelbild in Originalgröße
pic5_thumb1_url	Bild 5 Thumbnailgröße 1	Link zum 5. Artikelbild in Thumbnailgröße 1
pic5_thumb2_url	Bild 5 Thumbnailgröße 2	Link zum 5. Artikelbild in Thumbnailgröße 2
pic5_thumb3_url	Bild 5 Thumbnailgröße 3	Link zum 5. Artikelbild in Thumbnailgröße 3
pic5_thumb4_url	Bild 5 Thumbnailgröße 4	Link zum 5. Artikelbild in Thumbnailgröße 4
pic1_url_org	Bild 1 Originalgröße (variantenunabhängig)	Link zum 1. Artikelbild in Originalgröße, das keiner Variante zugeordnet ist
pic2_url_org	Bild 2 Originalgröße (variantenunabhängig)	Link zum 2. Artikelbild in Originalgröße, das keiner Variante zugeordnet ist
pic3_url_org	Bild 3 Originalgröße (variantenunabhängig)	Link zum 3. Artikelbild in Originalgröße, das keiner Variante zugeordnet ist
pic4_url_org	Bild 4 Originalgröße (variantenunabhängig)	Link zum 4. Artikelbild in Originalgröße, das keiner Variante zugeordnet ist
pic5_url_org	Bild 5 Originalgröße (variantenunabhängig)	Link zum 5. Artikelbild in Originalgröße, das keiner Variante zugeordnet ist
pic1_url_var	Varianten-Bild 1	Link zum 1. Varianten-Bild in Originalgröße
pic2_url_var	Varianten-Bild 2	Link zum 2. Varianten-Bild in Originalgröße
pic3_url_var	Varianten-Bild 3	Link zum 3. Varianten-Bild in Originalgröße
pic4_url_var	Varianten-Bild 4	Link zum 4. Varianten-Bild in Originalgröße
pic5_url_var	Varianten-Bild 5	Link zum 5. Varianten-Bild in Originalgröße
meta_name	Meta-Name	Titel für Meta-Tags
meta_description	Meta-Beschreibung	Beschreibung für Meta-Tags
meta_keywords	Meta-Keywords	Schlüsselwörter für Meta-Tags
datum	Einstelldatum	Das Einstelldatum des Artikels
cur_name	Währungs-Name	Währungsname für die Preise
cur_id	Währungs-ID	Interne Währungs-ID für die Preise
bestand	Bestand (kaufbare Menge)	Die aktuell kaufbare Menge des Artikels
bestand1	Bestand (realer Bestand)	Der aktuelle Bestand des Artikels
lagerbestand	Lagerbestand	Die verfügbare Artikelmenge; bei der Verwendung mehrerer Lager wird die Menge für jedes Lager einzeln angezeigt z. B. (Lager 1: 4,Lager 2: 5 )
kri_bestand	kritische Lagerbestandsmenge	Die kritische Lagerbestandsmenge der Variante
sizegroup	Die Größengruppe	Die Bezeichnung der Größengruppe
colorgroup	Die Farbgruppe	Die Bezeichnung der Farbgruppe
description_html_bf	Beschreibung (HTML) für Brickfox Export	Die lange Beschreibung des Artikels. " Werden mit "" maskiert.
merkmal_1	Artikelmerkmal Für	Artikelmerkmal
merkmal_5	Artikelmerkmal Material	Artikelmerkmal
merkmal_6	Artikelmerkmal Style	Artikelmerkmal

 

Sofern Sie im Shop eigene Artikelmerkmale angelegt haben, können Sie diese an dieser Stelle nutzen, unabhängig davon, ob sie privat oder öffentlich gekennzeichnet sind.

Sobald Sie eine Spalte zur Liste hinzugefügt haben, können Sie durch einen Klick auf den Namen der Spalte eine abweichende Spaltenüberschrift eingeben. Wenn Sie alle erforderlichen Spalten hinzugefügt haben, sichern Sie Ihre Exportkonfiguration über die Schaltfläche „Speichern“.

 

Der Datenfilter

Mithilfe des Datenfilters wählen Sie aus, welche Daten aus dem Shop exportiert werden sollen. Beispiele hierfür wären beispielsweise:

• Artikel, die sofort lieferbar sind
• Artikel mit einem Preis von über 5 Euro
• Artikel eines bestimmten Herstellers
• Artikel mit Artikelbild
• Artikel aus einer bestimmten Produktgruppe

Wie Sie einen Datenfilter korrekt anlegen, lesen Sie detailliert im Handbuch-Artikel „Artikelfilter“. Sie können an dieser Stelle auch auf Datenfilter zurückgreifen, die Sie in der Artikelverwaltung angelegt haben.

 

Eine neue Exportaufgabe anlegen

Für jeden Export wird eine sogenannte Exportaufgabe erstellt, der eine Exportkonfiguration (das Datenformat) und ein Exportdatenfilter (die gefilterten Datensätze) zugeordnet werden. Klicken Sie hierzu auf die Schaltfläche „Neue Exportaufgabe anlegen“ (Grünes Plus). Nun tätigen Sie folgende Eingaben:

• Name: Bezeichnung der Exportaufgabe
• Beschreibung: kurze Beschreibung, wofür die Exportaufgabe dient
• Exportdateiname: Dateiname für die Exportdatei, Dateiendung entweder CSV oder TXT
• Ausführung des Exports: manuelle Ausführung oder automatischer Ablauf nach einem Zeitplan (für die Einrichtung des notwendigen Cronjobs bitte an den Support wenden)
• Variationen als separate Zeile exportieren: Ja = jede Artikelvariante wird als eigenständiger Artikel exportiert; Nein = pro Artikel wird nur eine Zeile ausgegeben, mit dem Gesamtbestand aller Varianten und dem niedrigsten Preis
• Exporteinstellung: Auswahl einer vordefinierten oder einer eigenen Exporteinstellung
• Exportdaten: Auswahl eines Datenfilters, der für den Export verwendet werden soll

Wenn Sie eine vorgefertigte Exportkonfiguration oder ein eigenes Setup mit Eingabefeldern wählen, sind nun ggf. zusätzliche Angaben notwendig. Bei vorgefertigten Setups ist dies immer dann der Fall, wenn der Drittanbieter, für den der Export bestimmt ist, eine Spalte voraussetzt, die durch Ihre angelegten Artikelmerkmale nicht abgedeckt werden. Diese können Sie dann als neues Artikelmerkmal einfügen und ggf. als privat kennzeichnen, falls die Informationen im Frontend nicht sichtbar sein sollen. Diese Artikelmerkmale weisen Sie dann bei der Einrichtung des Setups den Eingabefeldern des jeweiligen Anbieters zu.

Speichern Sie Ihre Eingaben über die entsprechende Schaltfläche rechts oben.

 

Achtung: Die verschiedenen Drittanbieter verändern ihre Importroutinen immer wieder. So kann es passieren, dass diese von unseren vorgefertigten Setup-Exporten abweichen. Sollten Sie mit einem Setup Schwierigkeiten haben, wenden Sie sich bitte zunächst an den Drittanbieter, um etwaige Abweichungen festzustellen.

 

 

Eine Exportaufgabe starten

Um eine Exportaufgabe manuell zu starten, markieren Sie im Reiter „Exportaufgaben“ die betreffende Exportaufgabe und klicken unterhalb der Tabelle auf „Exportaufgabe starten“. Es öffnet sich nun oberhalb des Administrationsbereichs ein separates Browserframe, in dem Sie den Status des Exports verfolgen können. So können Sie währenddessen weiterarbeiten. Sobald die Aufgabe abgeschlossen ist, können Sie die erzeugte Exportdatei über die grüne Schaltfläche in diesem Browserframe herunterladen. Alternativ wechseln Sie im Exportbereich in den Reiter „Exportdateien“, wo Sie die zuletzt erzeugten Dateien herunterladen können.

Haben Sie beim Anlegen der Exportaufgabe die automatische Ausführung gewählt, so führen Sie diese einmalig manuell durch, wie eben beschrieben. Danach wird sie automatisch im gewählten Rhythmus wiederholt. So können Sie beispielsweise einen täglichen, automatischen Export aller Artikel zu einem Preisvergleichsportal durchführen, um die dort gelisteten Preise zu aktualisieren.

 

Exportdatei abrufen

Klicken Sie entweder unter Exportdateien in der Zeile der Datei auf das Download-Symbol (grün) oder Sie können auch wie folgt auf die Exportdatei verlinken:

https://www.DOMAIN.ENDUNG/export/Artikel/DATEINAME.ENDUNG

Die Felder DOMAIN, ENDUNG, DATEINAME, ENDUNG sind mit Ihren jeweiligen Daten zu esetzen.