Produkt-Datenfelder

Dies ist eine allgemeine Datenfeld-Referenz für die Produktdaten. Diese eignet sich für Backend-User, Produkt-Datenpfleger und HTML-Template-Programmierer gleichermaßen.

Im Folgenden sind sämtliche Standard Produkt-Datenfelder aufgeführt und erläutert.

Nicht enthalten in diesem Artikel sind die Datenfelder zu:

  • Kategorie-Detail-Daten
  • Brand-Detail-Daten

Datenfelder

In der Spalte "Feldname" ist jeweils zuerst der Name der Spalte, wie sie im eCommerce Suite Backend in Eingabe-Formularen und Listen-Ansichten dargestellt ist.
Darunter ist der sprachenunabhängige " Technische Datenbank-Spaltenname" angegeben. Es empfiehlt sich bei Datei-Importen und -Exporten mit diesen Spaltennamen zu arbeiten!

Einige der Felder sind nur über Erweiterungsmodule verfügbar!
Feldname Typ Beschreibung Beispiel(e)
Product-Code
pcode
TEXT[32]

Produkt-Code (Abgekürzt "PCode"). Der eindeutige alphanumerische Code, der dieses eine Produkt innerhalb der eCommerce Suite kennzeichnet.

Erlaubte Zeichen
Es sind erlaubt Buchstaben A-Z, sowie Ziffern 0-9 und Bindestrich "-".

Import
Bei Datei-Importen ist dies immer eine Pflicht-Spalte.

"EM000100"
Master-PCode
master_pcode
TEXT[32]

Master-PCode. Ist dieses Produkt ein Teil einer Variantengruppe, so muss hier der PCode des zugehörigen Master-Produkts eingetragen werden.

Ist dies Produkt das Master-Produkt, so enthält dieses Feld den gleichen Wert, wie in PCode gespeichert. Es "zeigt" damit so zu sagen auf sich selbst.
Gleiches gilt, wenn dieses Produkt ein eigenständiges Produkt ist, d.h. es ist nicht Teil einer Variantengruppe ist.

"EM000100"
Name
name
TEXT Produktname. Dies ist der eigentliche Produktname, der im Online-Shop, Bestellungen, Rechnungen und im Backend dargestellt und verwendet wird. "T-Shirt - Hawaii Style"
Hersteller
manufacturer
TEXT[64] Hersteller-Name. Name des Herstellers. "Textil-Schmiede GmbH"
Brand
brand
TEXT[64] Marken-Name. Normalerweise wird der Marken-Name im Shop-Frontend an mehreren Stellen mitausgegeben. "Hawaiian Surfers"
Brand-Details TEXT

Verknüpfung zu einem zentralem Marken-Datensatz.

In dem zentralen Marken-Datensatz können Namen, Logo, Bilder, Texte, Links und eigene weitere Felder zu der entsprechenden Marke hinterlegt werden, die dann im Shop-Frontend bspw. auf der Produktdetail-Seite oder in den Markenshops ausgegeben werden können.

Plugin:
Nur verfügbar bei Nutzung des Plugins "Marken Shops".

 
Beschreibung
description
TEXT

Produktbeschreibung. Dies ist die Fließtext-Langbeschreibung, die typischerweise im Online-Shop auf der Produkt-Detail-Seite angezeigt wird.
Diese kann reiner Text sein, aber auch HTML.

Bilder:
Es können auch Bilder im Fließtext eingebunden werden, über die eCMS-Elementschreibweise: ${eMB-Img:<eMB-Label>}$.

Dynamische Include-Texte:
Immer wiederkehrende Texte oder Text-Passagen, wie bspw. "Batterie-Verordnungspflichtangaben", die bei mehreren Produkten gleichermaßen vorkommen, können auch als ein zentraler Text-Baustein abgelegt und gepflegt werden. Sie können dann mit ${eCMS-Content-Include:<XC-Label>(...)}$ bei der Ausgabe automatisch werden lassen.

Andere dynamische eCMS-Inhalte und -Funktionen:
Prinzipiell können über die eCMS-Elementschreibweise, also mit ${....}$, eigentlich beliebige andere Daten und Funktionen bei der Ausgabe eingebunden und mit ausgegeben werden.

"<p>Dieses lässige T-Shirt besticht durch seine atemberaubende Optik und vermittelt jedem direkt Gefühl von Urlaub auf Hawaii.</p>"
Varianten-Farbe
prdv_color
TEXT Varianten Farbe: (Varianten-Feld) Farbe, in der sich dieses Produkt von anderen Variantenprodukten mit gleichem Master-PCode unterscheidet. Aber selbst, wenn das Produkt nicht Teil einer Variantengruppe ist, ist es empfehlenswert hier Werte einzutragen, sofern diese natürlich vorhanden sind. "grün"
Varianten-Größe
prdv_size
TEXT Varianten Größe: (Varianten-Feld) Größe, in der sich dieses Produkt von anderen Variantenprodukten mit gleichem Master-PCode unterscheidet. Aber selbst, wenn das Produkt nicht Teil einer Variantengruppe ist, ist es empfehlenswert hier Werte einzutragen, sofern diese natürlich vorhanden sind. "XL"
Varianten-Ausführung
prdv_other
TEXT Varianten-Ausführung: (Varianten-Feld) Art der Ausführung, in der sich dieses Produkt von anderen Variantenprodukten mit gleichem Master-PCode unterscheidet. Aber selbst, wenn das Produkt nicht Teil einer Variantengruppe ist, ist es empfehlenswert hier Werte einzutragen, sofern diese natürlich vorhanden sind. "Kurz-Arm"
Kurzbeschreibung
desc_short
TEXT

Kurzbeschreibung. Je nach verwendeten Templates, werden die Kurzbeschreibungstexte im Shop-Frontend in Produktlisten auf Kategorie-Seiten, Suchergebnis-Seiten, usw. und teilweise auch im Kopfbereich der Produktdetail-Seiten angezeigt.

Dies kann reiner Text oder auch mit HTML

"Das Sommer-T-Shirt dieser Saison. Sommer. Sonne. Sonnenschein!"

"Das <strong>Sommer-T-Shirt</strong> dieser Saison. Sommer. Sonne. Sonnenschein!"

Technische Beschreibung
desc_tech
TEXT

Technische Produktmerkmale. In diesem Feld können, in der vorgegebenen Schreibweise, einzelne Produktmerkmale (=Attribute) gespeichert werden. Diese werden bspw. in den HTML-Templates zur Darstellung entsprechend (tabellarisch) aufbereitet.

Beim Shop-internen "Produkte vergleichen", werden diese einzelnen Merkmale jeweils zum Vergleich nebeneinander dargestellt. Voraussetzung ist allerdings, dass diese Attribut-Namen exakt gleich geschrieben worden sind.

Nach Werten bzw. Attributen, die in diesem Feld angegeben worden sind, kann im Shop-Frontend oder Backend nicht explizit sortiert oder gefiltert werden! Wenn dies für ein Attribut gewünscht ist, so sollte dies dann als eigentständiges (Varianten-)Feld bei den Produkt-Daten vorher angelegt werden!

Mit "_HEADER=..." kann ein optionaler, einleitender Text (kann HTML enthalten) angegeben werden, der direkt über den Attributen später ausgegeben werden sollte.

Mit "_FOOTER=..." kann ein optionaler, abschließender Text (kann HTML enthalten) angegeben werden, der direkt unter den Attributen später ausgegeben werden sollte.

Es können auch Gruppen gebildet werden. Eine Gruppe wird definiert mit "_GROUP=". Alle nachfolgenden Attribute werden dann dieser Gruppe zugeordnet.

Leerzeilen bzw. Absätze können vorgegeben werden, indem einfach zwei aufeinanderfolgende Pipezeichen eingegeben werden, bspw.: "||".

Ob und wie Header, Footer, Gruppennamen bzw. Leerzeilen letztendlich dargestellt werden, hängt immer von den ausgebenden (HTML)-Templates ab!

"Taschen Anzahl=5|Knopf=JA|Reißverschluß=JA |_GROUP=Gebrauchsanweisung|Waschen=90 Grad|Trockner=Nein"

"_HEADER=Dieser Text steht wird über den Einzeldaten ausgegeben. |_FOOTER=Und dies wird darunter ausgegeben!|Taschen Anzahl=5|....usw."

Produkt Keywords. prd_keywords TEXT Produkt Keywords. Freitext-Feld zum Hinterlegen einzelner Begriffe zu diesem Produkt, welche dann in Volltext-Suchen mit durchsucht werden können.
Angezeigt im Shop-Frontend wird dieses Feld im Normalfall nicht.
Mehrere Begriffe sollten durch Komma von einander getrennt werden.
"TShirt,Shirt,Sommer"
Kommentar
prd_comment
TEXT Interne Kommentare zu diesem Produkt.
Im Backend kann nach dieser Spalte einfach sortiert und gefiltert werden.
Im Shop-Frontend sollte diese Spalte niemals angezeigt werden.
"Klassiker Shirt! Immer mal wird auf die Startseite setzen!"
Produktbilder
files_img
TEXT

Produktbilder.

Definition: file=<eMB Filename>|title=<Bildtitel>. Mehrere Bilder mit 3 Doppelkreuzen „###“ trennen.

Die Reihenfolge der hier hinterlegten Bilder wird berücksichtigt!
Das erst-genannte Bild, ist auch das Produktbild, welches typsicherweise in Produktlisten aus Kategorieseiten, Suchergebnisseiten usw. dargestellt wird.

Die hier angegebenen Bilder müssen zuvor in der eCMS-Mediabase hinterlegt worden sein.

"file=em000100.jpg|title=Großansicht ###file=em000100_button.jpg|title=Detail-Ansicht: Knopf"

"file=em000100.jpg###file=em000100_button.jpg"

Produkt-Dateien
files_doc
TEXT

Produkt-Dokumente.

Definition: file=<eMB Filename>|title=<Abweichender Titel>. Mehrere Dateien mit 3 Doppelkreuzen „###“ trennen.

Die hier angegebenen Files müssen zuvor in der eCMS-Mediabase hinterlegt worden sein.

"em0001-gebrauchsanweisung.pdf"
Verpackungsmenge
pack_amount
FLOAT Verpackungsmenge (Default "1"). "1"
"1.00"  
Verpackungseinheit
pack_unit
TEXT Verpackungseinheit. "Stk."
Abmessungen
pack_size
TEXT Verpackungsabmessungen: Angaben in cm – Höhe x Breite x Tiefe. "2x5x30"
Verpackungsinhalt (Menge)
prd_ingr_amount
FLOAT Verpackungsinhalt Menge: Mengenangabe des Verpackungsinhaltes ohne Verpackung. Die Angabe wird bei Berechnung des Grundpreis benötigt. "260"
Verpackungsinhalt (Einheit)
prd_ingr_unit
TEXT Verpackungsinhalt Einheit: Einheit (z.B. Liter oder kg) zur Mengenangabe des Verpackungsinhaltes. Verwenden Sie bitte folgende Abkürzungen: g=Gramm; kg=Kilogramm; ml=Milliliter; l=Liter; cm=Zentimeter; m=Meter; cm_2=Quadratzentimeter; m_2=Quadratmeter; stk=Stück "g"
Gewicht
prd_weight
FLOAT Gesamtgewicht, inklusive Verpackung, in Gramm. "280"
Virtuelles Produkt
prd_virtual
INT

Virtuelles-Produkt Kennzeichung.

"1" = Virtuell
"0" = physikalisches Produkt (default).

"0"
Nachfolgeprodukt
prd_replace
TEXT[32] Produktcode eines eventuellen Nachfolgeprodukts. "ABC123456"
Hersteller-PCode
pcode_manufacturer
TEXT Artikelnummer des Herstellers. "STM-001-123"
EAN
ean
TEXT EAN-Nummer (European Article Number) "1234567890123"
Zugehörige Produkte
products_related
TEXT

Cross-Selling-Produkte. Mehrere PCodes durch Semikolon trennen.

Die hier angegebenen Produkte werden typischerweise im Shop-Frontend als Zubehörsprodukte dargestellt.

"EM000110;EM000123"
Upselling Produkte
products_upselling
TEXT

Up-Selling-Produkte. Mehrere PCodes durch Semikolon trennen.

Die hier angegebenen Produkte werden typischerweise im Shop-Frontend als möglicherweise ebenfalls interessante Produkte dargestellt.

"EM000200;EM000300;EM000301"
Gebundelte Produkte
products_contain
TEXT

Wenn hier "Kind"-Produkte hinterlegt werden, ist dieses Produkt das sogenannte "Vater-Bundle-Produkt".

Mehrere PCodes durch Semikolon trennen.

Bundle-Produkte können wiederum mehrfach verschachtelt Teil eines übergeordneten Bundle-Produkts sein.

Dieses Feld und damit verbundene Funktionen stehen mit Produkt-Bundle-Plugin zur Verfügung.

"EM0001;EM0002"
Kategorie
category_code_list
TEXT

Kategorie(n) denen dieses Produkt zugeordnet sein soll.

Mehrfach-Zuweisungen
Ein Produkt kann in mehreren Kategorien gleichzeitig enthalten sein. Die erst-genannte Kategorie ist die sogenannte Master-Kategorie.

Kategorie-Bäume (Kataloge)
Es können auch gleichzeitig mehrere Kategorie-Bäume verwaltet werden. Der Standard-Kategoriebaum, der im Online-Shop im Normalfall als Navigation verwendet wird hat das Label " product_groups".

Import
Vor dem Importieren sollten die Kategorien mit ihren entsprechenden Kategorie-Codes angelegt worden sein.

Absolute Adressierung:
"product_groups::HerrOberBekleidung; product_groups::SommerSpezial"

Code-Only Adressierung:
"HerrOberBekleidung; SommerSpezial"

MwSt. Satz
vat
FLOAT MwSt.-Satz in Prozent für das Shop-Betreiberland. "19.00"
Brutto Preis
price
FLOAT

Produkt-Preis (Brutto)

Beim Importieren, kann angegeben werden, ob dieses Feld abweichend als Netto-Wert, d.h. ohne MwSt. interpretiert werden soll.

"499.00"
Discount Brutto Preis
discount
FLOAT Brutto-Sonderangebotspreis. Dieser wird nur berücksichtigt, wenn er größer 0,00 ist und kleiner als der Normal-Produktpreis (price). "449.99"
Discount Text
discount_text
TEXT Freitext zum Sonderangebotspreis. "Jetzt zugreifen! Solange der Vorrat reicht!"
Discount Startdatum
discount_start
DATETIME Startzeitpunkt des Sonderangebotpreises (Eingabe: TT.MM.JJJJ hh:mm). Um keinen Startzeitpunkt zu setzen lassen Sie das Feld einfach frei. "2014-02-28 00:00"
Discount Enddatum
discount_end
DATETIME Endzeitpunkt des Sonderangebotpreises (Eingabe: TT.MM.JJJJ hh:mm). Um keinen Endzeitpunkt zu setzen lassen Sie das Feld einfach frei. "2014-03-31 23:59"
Staffelpreise
price_dsc_scale
TEXT Liste von Preis-Staffelungen basierend auf der gekauften Menge. Erwartet wird jeweils die Mindestmenge und der zugehörige Brutto-Preis für diese Menge (getrennt durch "="). Die einzelnen Staffeln werden durch "|" getrennt und sollten aufsteigend sortiert gelistet werden. "2=30.00|5=25.50|10=22.99"
Shop-Status
state
INT

Online-Status. Entscheidet unter anderem darüber, ob ein Produkt im Online-Shop sichtbar ist, oder nicht. Beim Import bitte darauf achten, daß das Importieren dieser Spalte freigeschaltet ist (Daten-Sicherheitsmechanismus).

  • "1" = offline
  • "2" = online
Wird das Feld leer gelassen, wird der Status im Shop nicht überschrieben.

 

"2"
Offer-Level
offer_level
INT

Produkt-Anzeigepriorität (0 - 15).

0 ist sehr niedrig bzw. gilt als nicht priorisiert. Werte von 10 und höher werden als "Top Offer" angezeigt.

"10"
Lieferhinweis
prd_delivery
TEXT Lieferzeit in Text-Form. Dies wird im Shop als Lieferzeit angezeigt. "1-3 Werktage"
Shop Suchbar
searchable
INT

Kennzeichnung, ob das Produkt über die Volltext-Shopsuche findbar ist oder nicht.

"1" = suchbar (default)
"0" = nicht suchbar.

"1"
Kaufbar
single_buy
INT

Kaufbar-Einstellung. Über dieses Feld können Sie steuern, ob ein Produkt einzeln gekauft werden kann.

"1" = einzeln kaufbar (Default)
"0" = nur als Set-Bestandteil kaufbar (Produkt-Bundle)

"1"
Neues Produkt
new_product
INT

Markiert im Shop-Frontend ein Produkt als "NEU".

"1" = als "NEU" markieren
"0" = nicht markieren (Default)

"0"
Special-Offer Produkt
special_offer_product
INT

Markiert im Shop-Frontend ein Produkt als "Special Offer".

"1" = als "Special Offer" markieren
"0" = nicht markieren (Default)

"0"
Verfügbar ab
available_date
DATETIME Zeitpunkt, ab dem Produkt (wieder) verfügbar ist.  
Vorbestellung möglich
bookable
INT

Kennzeichnung, um die Vorbestellungen für dieses Produkt zu erlauben:

"1" = vorbestellbar
"0" = nicht vorbestellbar (Default).

"0"
Max. Bestellmenge
order_quanti_max
FLOAT

Maximale Bestellmenge dieses Produkts pro Bestellung. Standardmässig sind keine Mengenbegrenzungen gesetzt.

"0" = keine Begrenzung

"5"

"7,50"

Min. Bestellmenge
order_quanti_min
FLOAT Mindest-Bestellmenge des Produktes pro Bestellung. Standardmässig wird die Mindest-Menge auf "1" gesetzt.

"2"

"0,75"

Schritt Bestellmenge
order_quanti_inc
FLOAT Schrittweite in der die Bestellmenge des Produktes erhöht werden kann. Sie können die Schrittweite auch mit Nachkommastellen angeben. Standardmässig wird die Schrittweite auf "1" gesetzt.

"3"

"1,2"

Lagerbestand
prd_storage_counter
FLOAT

Lagerstand für die Anzeige im Shop-Frontend.

Für unendlichen Lagerbestand Feld mit "NULL" belegen.

Dieser Lagerbestandszähler wird bei eingehenden Bestellungen automatisch heruntergezählt.

eWareHouse
Wird das eWareHouse-Modul zusätzlich verwendet, wird dieser Wert automatisch durch die dahinterliegende ggfs. dezentralisierte Lagerverwaltung gepflegt, d.h. beschrieben.

In diesem Fall sollten dann hier keine Lagerbestandswerte importiert werden! Sondern dann direkt sinnvollerweise direkt im eWareHouse.

"NULL"

"75"

"37,25"

Lagerbestand Benachrichtigungsschwelle
prd_storage_limit_notify
FLOAT Erreicht der Lagerbestand (prd_storage_counter) diesen Schwellwert, wird eine Email an den Shop-Betreiber ausgelöst. "5"
dynx__prdxcost_<ISO-Code> FLOAT

Länderspezifische Zusatzversandkosten.

Für jedes gewünschte Land muss eine eigene Spalte angelegt werden mit deren ISO-Ländercode (Beispiel für Österreich:  dynx__prdxcost_AT).

"3.80"
Marketing-Name
marketing_name
TEXT

Optionaler, abweichender Produkt-Name zur Verwendung auf speziellen Shop-Teaser-Flächen, wie bspw. Slider.

Ist hier nichts angegeben, greifen im Normalfall die (Slider-)Formate stattdessen auf den Produktnamen zu.

"Hawaii Shirt"
Marketing-Teaser
marketing_teaser
TEXT

Optionaler, abweichender Teaser-Text zur Verwendung auf speziellen Shop-Teaser-Flächen, wie bspw. Slider.

Ist hier nichts angegeben, greifen im Normalfall die (Slider-)Formate stattdessen auf die Kurzbeschreibung zu.

Dies kann plain-Text oder auch HTML sein.

"<strong>Sommer</strong>, Sonne, ...im Urlaub sein!"
Marketing-Bild
marketing_image
TEXT

Optionales, abweichendes Produkt-Bild zur Verwendung auf speziellen Shop-Teaser-Flächen, wie bspw. Slider.

Ist hier nichts angegeben, greifen im Normalfall die (Slider-)Formate stattdessen auf das Produktbilder-Feld zu.

"em000100_marketing-img.jpg"
HTML Head-Titel
meta_title
TEXT

(SEO) Überschreibender HTML-HEAD-Titel für die Produktdetail-Seite.

Je nach Shop-Frontend-Konfiguration erzeugt die eCommerce Suite bei der Ausgabe dynamisch nach vorgebenem Schema selbständig eigene Head-Titles.

Der HTML-Head-Titel wird im Browser-Fenster oder -Tab als Titel dargestellt.

Dies kann hiermit für das Produkt dauerhaft überschrieben werden.

"Hawaii T-Shirt günstig online kaufen!"
HTML META-Description
meta_description
TEXT

(SEO) Überschreibende HTML-META-Description für die Produktdetail-Seite.

Je nach Shop-Frontend-Konfiguration erzeugt die eCommerce Suite bei der Ausgabe dynamisch nach vorgebenem Schema selbständig eigene META-Descriptions.

Die META-Description wird auf Suchmaschinen-Ergebnisseiten, wie bspw. google, beim eigentlichen Suchergebnis mit angezeigt.

Dies kann hiermit für das Produkt dauerhaft überschrieben werden.

"Schönes, luftiges Hawaii T-Shirt für den Sommer! Große Auswahl auch an anderen Sommer-Shirts. Jetzt Shoppen!"
HTML META-Keywords
meta_keywords
TEXT Optionale HTML-META-Keywords. "TShirt,T-Shirt,Shirt,Hawaii,Summer,Sommer"
HTML META-Robots NoIndex
meta_robots_noindex
INT

(SEO) Soll eine Produktdetail-Seite mit NoIndex ausgeliefert werden, so kann dies hier aktiviert werden.

"0" = nicht aktiviert, d.h. keine Ausgabe (default).
"1" = aktiviert, d.h. "noIndex" wird ausgegeben.

"0"
HTML META-Robots NoFollow
meta_robots_nofollow
INT

(SEO) Soll eine Produktdetail-Seite mit NoFollow ausgeliefert werden, so kann dies hier aktiviert werden.

"0" = nicht aktiviert, d.h. keine Ausgabe (default).
"1" = aktiviert, d.h. "noFollow" wird ausgegeben.

"0"
Auftragsposten-Name
orderitem_name
TEXT

Abweichender Produktname, der in den Bestelldaten und damit auch in der Rechnung usw. verwendet werden soll.

Wird dies Feld leer gelassen, wird der eigentliche Produktname verwendet.

"T-Shirt, Hawaii, grün"
Auftragsposten-Text
orderitem_text
TEXT Hierüber besteht die Möglichkeit einen zusätzlichen Text bei Bestelleingang zu dem Auftragsposten automatisch hinzuzufügen. "Ein Zusatztext, der unter den eigentlichen Auftragsposten geschrieben wird."
Buchhaltung Kostenstelle
prd_accounting_cost_center
TEXT

Wenn hier angegeben, wird bei der Erzeugung von FiBu-Buchungstapel-Dateien, dieser Wert in Kostenstellen-Spalte übernommen.

Plugin:
Nur verfügbar bei Nutzung des Plugins "FiBu Buchungsstapel Export".

"4000"
Buchhaltung Erlöskonto
prd_accounting_revenue_account
TEXT

Wenn hier angegeben, wird immer bei der Erzeugung von FiBu-Buchungstapel-Dateien, dieser Wert als Erlöskonto genommen und nicht die entsprechend konfigurierten Standard-Erlöskkonten.

Plugin:
Nur verfügbar bei Nutzung des Plugins "FiBu Buchungsstapel Export".

"1000"

 

Eigene Datenfelder

Eigene (mehrsprachige) Datenfelder können leicht über das eCMS-Redaktionssystem im Betrieb hinzugefügt werden.

Auf diese kann dann ganz genauso im eCMS-Templating für die Ausgabe zugegriffen werden.

Im eCommerce Suite Backend stehen diese Felder dann ebenfalls automatisch in Produktlisten und Produkt-Eingabeformularen zur Verfügung.

Für Shop-Template Programmierer...

Frontend-HTML-Programmierer bekommen über das eCMS Zugriff auf sämtliche Produktdaten-Spalten. Die Werte stehen dann in einem assoziativen PHP-Array mit oben genannten " Technischen Datenbank-Spaltennamen" zur Verfügung und können dann beliebig im Template bzw. im eCMS-Format weiterverarbeitet werden.