Format und Inhalt - WS-SFTP-Produkte PRO (DE)

Format und Inhalt - WS-SFTP-Produkte PRO (DE)

Inhaltsverzeichnis

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

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

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
a..z
A..Z
Punkt ".", Doppelpunkt ":"
Slash "/", Backslash "\", Bindestrich "–", Unterstrich "_"

S3

String (Typ 3, alphanumerisch) nur mit den erlaubten Zeichen:

0..9
a..z
A..Z

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:
25
-312
+13

U

Unsigned Integer, d.h. ganzzahlige Werte ohne Vorzeichen. Es sind nur Ziffern erlaubt. Keine anderen Zeichen, insbesondere keine Punkte als Tausendertrenner.

Beispiel:
25

F

Float, d.h. „Fließkommazahlen“ mit optionalem Vorzeichen und optionalen Nachkommastellen. Nachkommastellen werden durch einen Punkt getrennt (das Komma ist nicht erlaubt).

Beispiel:
1
1.0
-1.00
1002033
10033.80

Nicht erlaubt:
111,1
121.004,20

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/
max. Länge

Bedeutung/Format

Feldname

Zulässige Zeichen/
max. Länge

Bedeutung/Format

ProdIndex

S1/64

Eine innerhalb des Subshops eindeutige ID für das Produkt. Dieses Feld ist das einzige Pflichtfeld der Datei.
Beispiel: „78459abc“

Name

S1/128

Der Produktname.
Beispiel: „Kaffeemaschine, Edelstahl“

Name2

S1/128

Eine Zusatzbezeichnung des Produkts.

Number

S1/64

Die Nummer des Produkts/Produktnummer.
Beispiel: „78459-abc“

AltNumber1
AltNumber2
AltNumber3
AltNumber4
AltNumber5

S1/64

Felder mit „alternativen Produktnummern“.
Die in diesen Feldern importierten Nummern können bei Direktbestellungen alternativ zu dem im „Number“ Feld eingepflegten Wert verwendet werden.

InsertList

S1/4000

Eine kommagetrennte Liste von Werbemittelcodes, die für das Produkt zulässig sind.
Beispiel: „01,XY,58“

Descr

S1/16000

Die Produktbeschreibung.
Beispiel: „Höchste Produktqualität durch...“

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.
Beispiel: „78459abc.jpg“

Thumbnail

S2/128

Ein kleines Produktbild für die Verwendung in Produktlisten.
Beispiel: „78459abc.jpg“

MiniThumbnail

S2/128

Ein extrakleines Produktbild, z. B. für die Anzeige im Warenkorb.
Beispiel: „78459abc.jpg“

LargeImage

S2/128

Ein extragroßes Produktbild, das z. B. durch den Klick auf einen „vergrößern“ Link im Shop angezeigt werden kann.
Beispiel: „78459abc.jpg“

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.
Beispiel: „3“, in diesem Fall könnten nur noch 3,6,9 usw. Stück 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.
In den Produktdaten muss für jede Gruppen-ID der zugehörige Unitfactor importiert werden.

Format:

<g><1>Gruppen-ID</1><2>UnitFactor</2></g>

Beispiel:
<g><1>wholesale</1><2>10</2></g>

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.
Beispiel: 1,5,8

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.
Beispiel: „2.5“

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.
Beispiel: „1“

Price

F/8

Der „normale“ Preis des Produkts.
Beispiel: „1.99“

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.
Beispiel: „2.85“

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.
Ohne die Verwendung der Staffelpreis-ID würde er den vollen Preis zahlen.

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.
Beispiel: „1210986000“

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.
Beispiel: „Begriff1,Begriff2 Begriff3“

MerchantName

S1/64

Der Name des Herstellers oder Lieferanten des Produkts.
Beispiel: „Meier AG“

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.
Beispiel: „5.0“

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.
Beispiel: „2“

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.
Beispiel: „7.0“

Variations

Max. 200 Varianten; und 2000 Einträge

Die „normalen“ Varianten. Formatbeschreibung und Beispiel siehe „Meta-Felder“.

DepVariations/
DepVarFile

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.
Beispiel: „087-XYZ“

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:
(für “unbegrenzt gültig” kann 0 in <2> angegeben werden)

<g><1>ab UnixTimestamp</1><2>bis UnixTimestamp</2><3>DiscountID</3></g>

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).
Kaufgutscheine können für das Produkt in jedem Fall eingelöst werden.

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
Dieses Feld enthält eine kommagetrennte Liste der Zahlungsarten-Codes mit denen der Kunde das Produkt nicht bezahlen kann.

Beispiele für Zahlungsarten-Codes:
1=Kreditkarte
3=Nachnahme
4=Bankeinzug/Lastschrift
5=Vorauskasse
6=Rechnung

Eine Liste aller Zahlungsarten-Codes finden Sie in der Frontend- und Designer-Dokumentation:
https://doku.websale.net/index.html?mats_verwendete_zahlungsartencodes.html

© 2025 WEBSALE AG | Impressum | Datenschutz