Format und Inhalt - WS-SFTP-Produkte PRO (DE)
Inhaltsverzeichnis
- 1 Allgemeines
- 2 Übertragung der Importdateien
- 3 Übersicht Importdateien
- 4 Zeichensatz der Importdateien
- 5 Formate der Importdateien
- 5.1 Allgemeines
- 5.2 Datentypen
- 5.3 Maximale Länge der Felder
- 6 Produktdaten (wpupdate.csv/wpcomplete.csv)
- 6.1 Liste der Felder (unstrukturiert)
- 6.2 Meta-Felder (strukturiert)
- 6.2.1 BulkDiscount/Staffelpreise
- 6.2.2 BulkDiscountPrices/Aktionspreise
- 6.2.3 AltPrices
- 6.2.4 OrgPrices
- 6.2.5 AreaProductPriceScale/Staffelpreise für Flächenprodukte
- 6.2.6 TextInputFields/Texteingabefelder
- 6.2.7 Variations „normale Varianten“
- 6.2.8 DepVariations/DepVarFile, „abhängige Varianten“
- 6.2.8.1 Namen der Varianten
- 6.2.8.2 Bestellmengen als abhängige Varianten
- 6.2.8.3 Name der PRD-Datei
- 6.2.9 CrossLinks
- 6.2.10 Inventory (Lagerbestandsverwaltung aktivieren)
- 6.2.11 Download-Artikel
- 6.2.12 Set
- 6.2.13 SetConfiguration
- 6.2.14 ChildProducts
- 6.2.15 ProductComparisonFields/Vergleichsfelder
- 6.2.16 AreaProductRange/Optionen für Flächenprodukte
- 6.2.17 VariationsOverview/VariationsOverviewMatrix/Bekleidungsmodul
- 6.2.17.1 VariationsOverview
- 6.2.17.2 VariationsOverviewMatrix
- 6.2.17.3 Bekleidungsmodul und PRD-Dateien
- 6.2.18 InstantVoucherProduct/Gutscheinprodukte
- 6.3 Typen der freien Felder
- 6.3.1 Text Aufzählung
- 6.3.2 Meta-Feld
- 7 Produktdaten und Variationswerte für abhängige Varianten (PRD-Dateien)
- 8 Löschen von Produktdaten (wpdelete.csv)
- 9 Produkt-Kategorie-Zuordnungen
- 10 Kategoriedaten (catcomplete.xml)
- 11 Lagerbestände (amountupdate.csv)
- 12 Kundenabhängige Preise
- 13 Online-Preise
- 14 Kombinationen für die abhängige Suche (depsearchcomplete.csv)
- 15 Produktabhängige Versandkosten (deliveryupdate.csv/deliverydelete.csv)
- 16 Rabattgruppen (discount.csv)
- 17 Kundenabhängige Produktnummern
- 18 Diverse Shop-Parameter (parameter.ini)
- 19 Diverse Subshop-Parameter (parameter.ini)
- 20 Spezielle Themen
- 21 Schutz vor leeren Importen
- 22 Beispiel-Dateien
Allgemeines
Diese Dokumentation beschreibt das Format und den Inhalt der verschiedenen Import-Dateien für Produktdaten, Kategoriedaten, Lagerbestände, kundenabhängigen Preisen, Versandkosten etc., welche an den Shop gesendet werden können.
Übertragung der Importdateien
Die Inhalte der nachfolgend beschriebenen Dateien werden mit der REST- oder SOAP-Schnittstelle in den Shop importiert:
Übertragung - Trigger: REST, SOAP & Co
Übersicht Importdateien
Derzeit werden folgende Importdateien unterstützt:
Dateiname | Gültigkeit | Inhalt und Funktion |
---|---|---|
wpupdate.csv | Subshop | Diese Datei enthält die Daten von zu ändernden oder neu hinzuzufügenden Produkten. |
wpcomplete.csv | Subshop | Das Format dieser Datei ist identisch zu dem von wpupdate.csv, allerdings muss sie alle Produkte des Subshops enthalten. Produkte, die nicht in dieser Datei enthalten sind, werden gelöscht. Der Import der wpcomplete.csv erfordert den Import der catcomplete.csv. |
wpdelete.csv | Subshop | Diese Datei enthält die zu löschenden Produktdaten. |
*.prd | Subshop | Die Daten von abhängigen Varianten werden je Produkt in einer eigenen Datei gespeichert. Der Name dieser Dateien wird aus dem Produktindex gebildet, die Extension ist „prd“. |
catupdate.csv | Subshop | Diese Datei enthält zu ändernde Kategorieinhalte. Für die in dieser Datei aufgeführten Produkte müssen in der wpupdate.csv die zugehörigen Produktdaten geliefert werden oder bereits im Shop vorhanden sein. |
catcomplete.csv | Subshop | Das Format dieser Datei ist identisch zu dem von catupdate.csv, allerdings muss sie alle Produkt-Kategorie-Zuordnungen enthalten. Aus Kategorien, die nicht in dieser Datei vorhanden sind, werden alle zugeordneten Produkte entfernt. |
catdelete.csv | Subshop | Diese Datei enthält die Kategorien, aus denen alle Produkte entfernt werden sollen. |
catcomplete.xml | Subshop | Diese XML-Datei enthält die Daten der Kategorien selbst. |
amountupdate.csv | Shop | Diese Datei enthält die zu ändernde Lagerbestände der Produkte (global). |
c-priceupdate.csv | Subshop | Diese Datei enthält die zu aktualisierenden (kundenabhängigen) Preise. |
c-pricecomplete.csv | Subshop | Das Format dieser Datei ist identisch zu dem von „c-priceupdate.csv“, allerdings muss die Datei alle kundenabhängigen Preise des Subshops enthalten. Nicht in der Datei enthaltene Preise werden aus dem Shop gelöscht. |
c-pricedelete.csv | Subshop | Diese Datei enthält die zu löschenden (kundenabhängigen) Preise. |
onlinepriceupdate.csv | Subshop | Enthält die zu ändernden oder hinzuzufügenden Online-Preise. |
onlinepricecomplete.csv | Subshop | Enthält alle Online-Preise (des Subshops). |
onlinepricedelete.csv | Subshop | Enthält die zu löschenden Online-Preise. |
depsearchcomplete.csv | Subshop | Enthält die möglichen Kombinationen für die abhängige Suche. |
deliveryupdate.csv | Shop | Diese Datei enthält die zu aktualisierenden/neu einzufügenden Einträge der produktabhängigen Versandkosten. |
deliverydelete.csv | Shop | Diese Datei enthält die zu löschenden Einträge der produktabhängigen Versandkosten. |
discount.csv | Shop/Subshop | Rabattgruppen |
custpnumbersupdate.csv | Shop | Enthält die zu ändernden oder hinzuzufügenden kundenabhängigen Produktnummern. |
custpnumberscomplete.csv | Shop | Enthält alle kundenabhängigen Produktnummern. |
custpnumbersdelete.csv | Shop | Enthält die zu löschenden kundenabhängigen Produktnummern. |
parameter.ini | Shop | Diverse Parameter (global), die in keine andere Importdatei passen. |
parameter.ini | Subshop | Diverse Parameter (für Subshop), die in keine andere Importdatei passen. |
Zeichensatz der Importdateien
Es wird empfohlen, alle Importdateien im Zeichensatz des jeweiligen Subshops zu liefern.
Dadurch ist sichergestellt, dass alle importierten Sonderzeichen im Shop richtig dargestellt werden. Sobald Zeichensätze konvertiert werden müssen, besteht die Gefahr, dass es für bestimmte Zeichen keine Entsprechung im Zeichensatz des Shops gibt.
Der Zeichensatz des Subshops ist in der Datei „shop.config“, in der Sektion „Basic“ bei dem Parameter „Charset“ eingetragen.
Konvertierung der Zeichensätze
Falls das ERP-System die Zeichensätze des Subshops nicht liefern kann, so müssen diese entsprechend konvertiert werden.
Konvertierung des Zeichensatzes der "catcomplete.xml"
Bei der "catcomplete.xml" wird der Zeichensatz im Header der XML-Datei ausgewertet. Eine spezielle Konfiguration der Zeichensatzkonvertierung ist daher nicht notwendig.
Konvertierung des Zeichensatzes der Dateien "wpupdate.csv", „wpcomplete.csv“ und „*.prd“
Wenn diese Dateien konvertiert werden sollen, so muss dies in der Datei global.config im Verzeichnis „konfiguration“ des Shops eingestellt werden.
Sektion:
<ProductImportPro>
ConvertCharset = yes # [yes][no], standard = no, Zeichensatz beim Import von Produktdaten konvertieren
ImportCharset = UTF-8 # Zeichensatz in dem die Importdateien geliefert werden, standard = UTF-8
UnknownCharacters = mapreplace # [ignore] [stdreplace] [mapreplace], standard = ignore
</ProductImportPro>
ConvertCharset:
Der Parameter „ConvertCharset“ legt fest, ob der Zeichensatz der Produktdaten überhaupt konvertiert wird. Die beiden anderen Parameter sind optional.
ImportCharset:
Mit „ImportCharset“ lässt sich der Zeichensatz der Importdateien festlegen, wenn er von UTF-8 abweicht.
UnknownCharacters:
Der Parameter „UnknownCharacters“ regelt, wie mit Zeichen umgegangen werden soll, für die es keine Entsprechung im Zeichensatz des SubShops gibt:
ignore: Die Zeichen werden ersatzlos weggelassen
stdreplace: Es wird versucht das Zeichen durch ein oder mehrere ähnliche Zeichen zu ersetzen
mapreplace: Die Zeichen werden anhand einer Zuordnungstabelle in der Datei global.config konvertiert
Konvertierungstabellen
Wenn in den Importdaten Zeichen verwendet werden, die im Zeichensatz des Shops nicht vorhanden sind, so können diese mit Konvertierungstabellen in der Datei global.config in andere Zeichen konvertiert werden.
<+ImportCharsetConvertMap>
Charset = ISO-8859-1
a = %c4%83
I = %c3%8e
%56 = %c3%8e
</+ImportCharsetConvertMap>
Der Parameter „Charset“ gibt den Zeichensatz des Shops an, für den diese Tabelle verwendet werden soll. Alle übrigen Einträge der Sektion geben die gewünschten Ersetzungen an: Rechts vom „=“ steht die Zeichenfolge in der Importdatei, links davon die Zeichenfolge durch die sie ersetzt werden soll. Sowohl die Original-Zeichen als auch die Ersetzung müssen im Zeichensatz der Importdatei kodiert werden.
Alle Zeichen können URL-kodiert werden. Dabei folgt auf ein „%“ Zeichen der hexadezimale Code des Zeichens. Diese Kodierung ist bei allen Sonderzeichen (mit einem Code >= 128) empfehlenswert, da ansonsten die Gefahr besteht, dass diese Zeichen beim Bearbeiten der Datei im falschen Zeichensatz gespeichert werden.
Bemerkungen
Wenn eine Zeichenfolge nicht durch eine andere ersetzt, sondern gelöscht werden soll, so lässt sich das mit dem Spezialwert „$delete“ erreichen.
Die Konvertierungstabellen werden derzeit nur für die Konvertierung der Produktdaten verwendet, nicht für die Kategoriedaten.
Es können beliebig viele <+ImportCharsetConvertMap> Sektionen in der Datei global.config stehen. Allerdings müssen sie sich im „Charset“ Parameter unterscheiden.
Formate der Importdateien
Allgemeines
Alle Dateien mit den Extensions „csv“ und „prd“ werden in einem „character separated values“ Format gespeichert, d.h. die Dateien bestehen aus einer Header-Zeile mit den Feldnamen und beliebig vielen Datenzeilen, sowie Feldtrennern zwischen den Feldern einer Datenzeile. Feldtrenner für die Feldwerte bzw. die Feldnamen in der Header-Zeile sind Tabulator-Zeichen. Die Zeilen werden mit einem CR oder einem CRLF abgeschlossen.
Bitte achten Sie bei den Feldnamen auf die Groß-/Kleinschreibung.
Beispiel:HeaderFeld1<TAB>HeaderFeld2<TAB>HeaderFeld3<CRLF>
Feldwert1a<TAB>Feldwert2a<TAB>Feldwert3a<CRLF>
Feldwert1b<TAB>Feldwert2b<TAB>Feldwert3b<CRLF>
Datentypen
In den nachfolgenden Tabellen werden folgende Datentypen verwendet:
Datentyp | Beschreibung |
---|---|
S1 | String (Typ 1) mit allen druckbaren Zeichen außer TAB und CR/LF |
S2 | String (Typ 2) nur mit den erlaubten Zeichen: 0..9 |
S3 | String (Typ 3, alphanumerisch) nur mit den erlaubten Zeichen: 0..9 |
S4 | String (Typ 4, ASCII) mit allen druckbaren Zeichen außer TAB und CR/LF des ASCII-Codes bzw. der ersten 128 Zeichen der ISO-8859-X Codes. |
I | Signed Integer, d.h. ganzzahlige Werte mit einem optionalen Vorzeichen. Es sind nur Ziffern und Vorzeichen erlaubt. Keine anderen Zeichen, insbesondere keine Punkte als Tausendertrenner. Beispiel: |
U | Unsigned Integer, d.h. ganzzahlige Werte ohne Vorzeichen. Es sind nur Ziffern erlaubt. Keine anderen Zeichen, insbesondere keine Punkte als Tausendertrenner. Beispiel: |
F | Float, d.h. „Fließkommazahlen“ mit optionalem Vorzeichen und optionalen Nachkommastellen. Nachkommastellen werden durch einen Punkt getrennt (das Komma ist nicht erlaubt). Beispiel: Nicht erlaubt: |
Maximale Länge der Felder
Die in den Tabellen angegebene maximalen Längen werden beim Import nicht geprüft. Felder, bei denen die maximale Länge überschritten ist, werden nicht gekürzt, weder beim Import noch später bei der Anzeige im Shop.
Der Grund dafür ist, dass Felder (speziell die Produktbeschreibung) HTML-Formatierungen enthalten können. Würde nun z. B. eine Produktbeschreibung nach einem öffnenden <table> Tag abgeschnitten, aber noch vor dem schließenden </table> Tag, so wäre nicht nur die Formatierung des Feldwertes selbst betroffen, sondern die Formatierung des gesamten Inhalts der HTML-Seite, der auf die Beschreibung folgt. Im schlimmsten Fall wäre nicht nur die Darstellung der Seite betroffen, sondern auch die Funktion, wenn z. B. der „In den Warenkorb“ Button nicht mehr angezeigt wird.
Aus diesem Grund werden Felder, bei denen die maximale Länge überschritten ist, im Shop nicht bzw. mit leerem Inhalt angezeigt.
Produktdaten (wpupdate.csv/wpcomplete.csv)
Diese Dateien enthalten die zu ändernden oder neu in den Shop einzufügenden Produktdaten.
Liste der Felder (unstrukturiert)
Die Datei kann folgende Felder enthalten:
Feldname | Zulässige Zeichen/ | Bedeutung/Format |
---|---|---|
ProdIndex | S1/64 | Eine innerhalb des Subshops eindeutige ID für das Produkt. Dieses Feld ist das einzige Pflichtfeld der Datei. |
Name | S1/128 | Der Produktname. |
Name2 | S1/128 | Eine Zusatzbezeichnung des Produkts. |
Number | S1/64 | Die Nummer des Produkts/Produktnummer. |
AltNumber1 | S1/64 | Felder mit „alternativen Produktnummern“. |
InsertList | S1/4000 | Eine kommagetrennte Liste von Werbemittelcodes, die für das Produkt zulässig sind. |
Descr | S1/16000 | Die Produktbeschreibung. |
Shortdescr | S1/1024 | Die Produkt-Kurzbeschreibung. Diese Beschreibung kann z. B. in Produktlisten verwendet werden, alternativ kann dort auch eine vom Shop automatisch gekürzte Version von „Descr“ angezeigt werden. |
Image | S2/128 | Der Name des normalgroßen Produktbilds. |
Thumbnail | S2/128 | Ein kleines Produktbild für die Verwendung in Produktlisten. |
MiniThumbnail | S2/128 | Ein extrakleines Produktbild, z. B. für die Anzeige im Warenkorb. |
LargeImage | S2/128 | Ein extragroßes Produktbild, das z. B. durch den Klick auf einen „vergrößern“ Link im Shop angezeigt werden kann. |
Unit | S1/64 | Die (Verpackungs-)Einheit in der das Produkt bestellt werden kann. Beispiel: „Stück“ Wenn eine Verpackungseinheit mehrere Stück enthält, so kann diese Anzahl entweder mit in das Unit-Feld eingetragen werden oder getrennt, in einem freien Feld importiert werden. Im ersten Fall wird die Stückzahl auch im Warenkorb angezeigt und in die Bestelldaten übernommen, im zweiten nicht. |
UnitCode | S1/64 | Ein Code für die Einheit in der das Produkt bestellt werden kann. Im Gegensatz zu „Unit“ ist dieser Wert nicht dazu gedacht im Shop angezeigt zu werden, sondern beim Einlesen der Bestellungen durch ein WWS ausgewertet zu werden. Beispiel: „Stck“ |
UnitFactor | F/8 | Bei Verwendung dieses Feldes können nur noch Vielfache der unter „Unit“ angegebenen Einheit bestellt werden. |
UnitFactorGroups | S1/4048 | Der Wert des Feldes UnitFactor (siehe oben), kann kundenabhängig importiert werden. In den Kundendaten muss zu diesem Zweck eine Gruppen-ID (“UnitFactorGroupID”) angegeben werden. Format: <g><1>Gruppen-ID</1><2>UnitFactor</2></g> Beispiel: |
QuantityScaling | S1/1024 | Gibt die zulässigen Bestellmengen an. Im Gegensatz zu „UnitFactor“ müssen alle zulässigen Mengen in einer kommagetrennten Liste aufgeführt werden. |
AdditionCostFactor | F/8 | Erlaubt die Anpassung der Versandkosten für einzelne Produkte. Der hier angegebene Wert wird mit der Zahl der bestellten Artikel und einem in der in der "shop.config" zu konfigurierenden Faktor multipliziert und dann zu den Versandkosten addiert. |
FreeDelivery | S1/1 | „y“, wenn für das Produkt keine Versandkosten berechnet werden sollen. |
DeliveryCostGroup | S1/64 | Die Versandkostengruppe für die produktabhängigen Versandkosten. |
VATIndex | Zulässige Werte: 1...15 | Legt den MWSt-Satz des Produkts fest. Der zu dem VATIndex gehörende Prozentsatz wird in der shop.config konfiguriert. |
Price | F/8 | Der „normale“ Preis des Produkts. |
AltPrices | - | Zeitabhängige, alternative Preise. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
OrgPrice | F/8 | Ein „alter Preis“ eine „Preisempfehlung“ oder etwas ähnliches. Der Shop kann automatisch die Differenz zwischen „OrgPrice“ und „Price“ als Ersparnis anzeigen. |
OrgPrices | - | Entspricht vom Inhalt her dem Feld “OrgPrice”, allerdings können in “OrgPrices” zeitabhängige Preise angegeben werden. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
BestPrice | F/8 | Wenn ein Produkt abhängige Varianten hat, dann sollte hier der günstigste Preis aller Varianten eingetragen werden. Bevor im Shop alle Varianten ausgewählt sind kann dieser Preis dann als „Ab-Preis“ (z. B. „ab 2.25 EUR“) angezeigt werden. Beispiel: „2.25“ |
BestPriceData | S1/128 | Wenn “BestPrice” gefüllt ist, so kann hier der Variationsindex (“VarIndex”) und die Produktnummer der Variante angegeben werden, die den günstigsten Preis hat. Format: <4>Variationsindex</4><5>Produktnummer</5> Der Inhalt des Feldes kann benutzt werden um im Shop-Template Daten der “billigsten Variante” nachzuladen und anzuzeigen. |
BestPiecePrice | F/8 | Wenn die Stückzahl als Variante importiert wird, dann kann in diesem Feld der günstigste Preis pro Stück übergeben werden, |
BestPiecePriceQuantity | F/8 | Die zu „BestPiecePrice“ gehörende Menge |
MaxPrice | F/8 | Wenn ein Produkt abhängige Varianten hat, dann kann hier der höchste Preis aller Varianten eingetragen werden. Zusammen mit "BestPrice" kann "MaxPrice" dazu verwendet werden einen Preisbereich (von ... bis ...) anzuzeigen, bevor eine Variation ausgewählt wurde. |
MaxPriceData | S1/128 | Analog zu BestPrice/BestPriceData kann hier die Produktnummer und der Variationsindex der Variante mit dem höchsten Preis übergeben werden. Siehe BestPriceData |
BulkDiscount | Max. 100 Preise | Die Staffelpreise. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
BulkDiscountId | S1/64 | Die Staffelpreis-ID. Produkte mit der gleichen Staffelpreis-ID gelten für die Staffelpreis-Berechnung als gleich. Beispiel: Alle T-Shirts in einem Shop haben die Staffelpreis-ID „TShirt“ bekommen, ab dem Kauf von 3 Stück gilt ein herabgesetzter Staffelpreis. Wenn nun ein Kunde ein Stück vom T-Shirt „A“, ein Stück vom T-Shirt „B“ und ein Stück vom T-Shirt „C“, bestellt so bezahlt er nur den herabgesetzten Preis. |
BulkDiscountPrices |
| „Aktionspreise“, d.h. zeit- und mengenabhängige Preise. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
AreaProductPriceScale |
| Staffelpreise für Flächenprodukte. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
ValidFrom | U/10 | Uhrzeit/Datum ab dem das Produkt im Shop angezeigt werden soll als Unix-Zeit. Beispiel: „1210892400“ |
ValidUntil | U/10 | Uhrzeit/Datum bis zu dem das Produkt im Shop angezeigt werden soll als Unix-Zeit. |
TextInputFields | Max. 10 Felder | Die Texteingabefelder. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
SearchItems | S1/256 | Begriffe die bei der Suche berücksichtigt, aber nicht im Online-Shop angezeigt werden sollen. In diesem Feld wird eine Volltextsuche durchgeführt, d. h. es braucht keine spezielle Formatierung beachtet zu werden. |
MerchantName | S1/64 | Der Name des Herstellers oder Lieferanten des Produkts. |
MerchantID | S1/64 | Eine ID des Herstellers oder Lieferanten des Produkts. Im Gegensatz zu MerchantName ist dieses Feld nicht für die Anzeige im Shop sondern für die Auswertung beim Einlesen der Bestellungen gedacht. |
Weight | F/8 | Das Gewicht des Artikels in einer beliebigen Einheit, die allerdings für alle Produkte gleich sein muss. |
Volume | F/8 | Das Volumen des Artikels in einer beliebigen Einheit, die allerdings für alle Produkte gleich sein muss. Beispiel: „8.0“ |
Length | F/8 | Die Länge des Artikels in einer beliebigen Einheit, die allerdings für alle Produkte gleich sein muss und mit der von „Volume“ abgestimmt sein sollte. Beispiel: „1.0“ |
Height | F/8 | Die Höhe des Artikels (siehe Length). Beispiel: „2.52“ |
Width | F/8 | Die Breite des Artikels (siehe Length). Beispiel: „0.42“ |
MinQuantity | U/7 | Die minimale Bestellmenge für das Produkt. Beispiel: „3“ |
MaxQuantity | U/7 | Die maximal Bestellmenge für das Produkt. Beispiel: „25“ |
QuantityDecimal | Zulässige Werte: 0...6 | Die zulässigen Nachkommastellen für die Bestellmenge. Normalerweise kann ein Kunde im Shop nur ganzzahlige Bestellmengen eingeben, durch Verwendung dieses Feldes können Sie auch Fließkommawerte zulassen. |
Event | S1/1 | Tragen Sie hier „y“ ein, wenn das Produkt in der „Happy-Hour“ Kategorie angezeigt wird. Beachten Sie, dass das Produkt zusätzlich über die Dateien catupdate.csv/ catcomplete.csv der „Happy-Hour“ Kategorie zugewiesen werden muss. |
EventProductNumber | S1/64 | Eine abweichende Artikelnummer, die während der „Happy-Hour“ verwendet wird. |
EventDiscount | F/8 | Rabatt in Prozent, der für das Produkt während der „Happy-Hour“ gewährt wird. |
Variations | Max. 200 Varianten; und 2000 Einträge | Die „normalen“ Varianten. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
DepVariations/ | Max. 200 Varianten; und 100000 Einträge, Empfehlung: Die Zahl der Einträge sollte jedoch 10000 nicht überschreiten, da mit zunehmender Anzahl die Anzeige im Shop träger wird. | Die „abhängigen“ Varianten. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
CrossLinks | Max. 200 Einträge | Cross-Links, Cross-Selling-Links usw. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
Inventory | - | Lagerbestandsdaten Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
StoreId | S4/64 | Die „Lagerartikelnummer“ des Produkts. Normalerweise wird der Lagerbestand eines Artikels über den ProduktIndex zugeordnet. Falls eine davon abweichende ID verwendet werden soll, so kann sie hier eingetragen werden. |
StockEmail | S1/128 | Eine E-Mail-Adresse für Benachrichtigungen bei Unterschreitung des Meldebestandes. Ist dieses Feld leer, so wird die in der shop.config konfigurierte Adresse verwendet. Beispiel: „info@shop.de“ |
OrderInfo | S1/16000 | In dieses Feld können Daten geschrieben werden, die im Shop nicht angezeigt werden sollen, aber in den Bestelldaten benötigt werden, z. B. eine interne Artikelnummer. |
Test | S1/1 | „y“, wenn das Produkt im Shop nicht angezeigt werden soll. Durch Anhängen von „&test=on“ an die URL des Shopaufrufs lassen sich die so gekennzeichneten Produkte zu Testzwecken im Shop anzeigen. |
HideForBasket | S1/1 | „y“, wenn das Produkt im Warenkorb nicht angezeigt werden soll. |
BookDelivery | S1/1 | „y“, wenn für das Produkt eine spezielle Bücherversand-Versandkostenberechnung erfolgen soll. |
SoldOut | S1/1 | „y“, wenn das Produkt im Shop nicht bestellbar sein soll. |
Export | S1/1 | „n“ wenn das Produkt nicht durch die Dienste „PricePush“ und „Externe Suchsystem“ exportiert werden soll. |
License | S1/1 | „y“, wenn es sich bei dem Produkt um einen „Lizenzartikel“ handelt. Beim Kauf eines Lizenzartikels erhält der Kunde eine Lizenznummer zugestellt. Typischerweise handelt es sich dabei um Software die frei heruntergeladen werden kann, aber erst nach der Eingabe einer Lizenznummer ohne Einschränkungen benutzt werden kann. |
DiscountFactor | F/8 | Der „(Kunden-)Rabattfaktor“. Die gewährten Rabatte werden mit diesem Faktor multipliziert. Standardmäßig ist jedes Produkt rabattierfähig (DiscountFactor = 1), auch wenn das Feld leer übergeben wird. Soll für ein Produkt kein Rabatt gewährt werden, so können Sie dies erreichen, in dem Sie hier „0“ eintragen. Beispiel: „0.5“ |
DiscountId | S1/64 | Für die Zuordnung des Produkts zu einer Rabattgruppe. Siehe unten Rabattgruppen (discount.csv) Beispiel: „abc“ |
DiscountIDs | S1/4096 | Angabe von zeitabhängigen Zuordnungen zu einer Rabattgruppe in der Form: |
Discount | F/8 | Ein Rabatt für das Produkt, der für alle Kunden gilt. Angabe in Prozent. Beispiel: „7.89“ |
UserDiscountRate | F/8 | Jedem Kunden, der diesen Artikel kauft, wird für die gesamte Bestellung und für alle Bestellungen in der Zukunft der hier angegebene Rabatt (in Prozent) gewährt. Beispiel: „5.00“ |
BonusPoints | U/7 | Die Anzahl der Bonuspunkte, die beim Kauf dieses Produkts gutgeschrieben werden. Beispiel: „1500“ |
BonusDeny | S1/1 | „y“, wenn beim Kauf dieses Produkts keine Bonuspunkte eingelöst werden können. |
BonusProduct | S1/1 | Prämienprodukt („y“: Produkt ist ein Prämienprodukt, jeder andere Wert: Produkt ist kein Prämienprodukt) Im Gegensatz zum „normalen“ Einlösen von Bonuspunkten können Prämienprodukte nur unter Einlösung von Bonuspunkten gekauft werden und Sie können für jedes Produkt explizit angeben, wieviele Bonuspunkte zum Kauf nötig sind. |
BonusProductPrice | U/7 | Bonuspunkte die für den Kauf des Produkts nötig sind (nur bei BonusProduct=y) |
Upload | S1/1 | „y“, wenn der Besteller beim Kauf Dateien hochladen kann (typischerweise bei Druckerzeugnissen). |
Download | - | Die Daten für Download-Artikel. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
Set | Max. 500 Unterartikel | Die Set-Unterartikel des Produkts. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
OnlyAsSetChild |
| „y“ Produkt ist nur als Teil eines Sets bestellbar |
ParentProdIndex | S1/64 | Der Produktindex des Gruppierungs-Oberartikels. |
ChildProducts | - | Die Gruppierungs-Unterartikel des Produkts. Formatbeschreibung und Beispiel siehe „Meta-Felder“. |
AgeRestricted | U/7 | Gibt ein Mindestalter für den Kunden an (typische Anwendung: DVDs, Computerspiele usw., 0: Keine Altersbeschränkung) |
GiftPackage | S1/1 | „n“ wenn für das Produkt keine Geschenkverpackung möglich ist. |
GiftPackagePrice | F/8 | Der Aufpreis je Stück, wenn das Produkt mit Geschenkverpackung geliefert wird. |
NoCampaignVoucher | S1/1 | „y“, wenn auf den Kaufpreis des Produkts keine Werbegutscheine angerechnet werden können (z. B. weil dadurch die Buchpreisbindung verletzt werden würde). |
NumSearchOnly | S1/1 | „y“: Bei der Suche im Online-Shop wird nur in dem Feld mit der Produktnummer gesucht, der Inhalt aller anderen Felder wird ignoriert. Jeder andere Wert: Es wird die normale Logik der Produktsuche angewendet. |
AreaProduct | S1/1 | „y“: Der Kunde kann im Shop die von ihm gewünschten Abmessungen eingeben. Siehe auch "AreaProductRange" unter "Meta-Felder" |
DenyPayments | S1/128 | Ausgeschlossene Zahlungsarten Beispiele für Zahlungsarten-Codes: |
© 2025 WEBSALE AG | Impressum | Datenschutz