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

Inhaltsverzeichnis

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.