Diese Dokumentation beschreibt wichtige Hinweise, die bei der Anbindung eines Shops oder PIM-Systems an pixi zu beachten sind.

Siehe auch: BMEcat Syntax-Spezifikationen für die Übergabe im XML Format, OPENtrans Syntax-Spezifikationen für die Übergabe im XML-Format

Primärschlüssel

Für jeden Artikel ist ein eindeutiger Primärschlüssel notwendig, welcher sich unter keinen Umständen während der gesamten „Lebenszeit“ des Artikels ändern darf. Der Primärschlüssel darf auch nach dem Löschen des Artikels im Shop-System unter keinen Umständen ein weiteres Mal verwendet werden. Der Primärschlüssel hat folgende Syntax in der XML-Struktur für den sog. BMECat-Export:

 <SUPPLIER_AID> 

Hinweis: Ein nicht eindeutiger Primärschlüssel verursacht schwerwiegende Fehler bei der Zuordnung der Artikel zu einer Bestellung und beim Export des Lagerbestands. Artikel werden doppelt importiert, etc.

Grundsätzlich erfolgt die Artikelverwaltung weiterhin im Shop-System (Pflege von Artikelbeschreibung, Preisen, etc.). Einzig der Bestand eines jeden Artikels wird von pixi verwaltet und entsprechend zurück an das Shop-System exportiert. D.h. alle Artikel müssen im Shop-System vorhanden sein und entsprechend für den Export bereitgestellt werden.

Artikel-Varianten

Jede Variante eines Artikels (Farbe, Größe, etc.) ist im Shop-System als eigenständiger Artikel mit eigenständigem Primärschlüssel ("SUPPLIER_AID") an pixi zu übergeben.

Beispiel mit zwei-dimensionalen Varianten:

Ein Artikel mit dem Namen „Matratze Comfort Plus“ gibt es in verschiedenen Farben und Größen (Varianten), der Hauptartikel hat im Shop-System entsprechend folgenden Artikelnamen: „Matratze Comfort Plus“

Der Artikel ist in folgenden Größen verfügbar: 120 x 180 cm, 180 x 160 cm, 180 x 180 cm

Der Artikel ist des Weiteren in drei unterschiedlichen Farben verfügbar: weiß, blau, rot

Somit ergeben sich folgende Varianten-Artikel, welche als solche einzeln an pixi übergeben werden müssen:

Der Artikel mit den zwei unterschiedlichen Attributen mit jeweils 3 Varianten muss somit als 9 unterschiedliche Artikel an pixi übergeben werden:

• Matratze Comfort Plus, Größe: 120 x 180 cm, Farbe: weiß

• Matratze Comfort Plus, Größe: 120 x 180 cm, Farbe: blau

• Matratze Comfort Plus, Größe: 120 x 180 cm, Farbe: rot

• Matratze Comfort Plus, Größe: 180 x 160 cm, Farbe: weiß

• Matratze Comfort Plus, Größe: 180 x 160 cm, Farbe: blau

• Matratze Comfort Plus, Größe: 180 x 160 cm, Farbe: rot

• Matratze Comfort Plus, Größe: 180 x 180 cm, Farbe: weiß

• Matratze Comfort Plus, Größe: 180 x 180 cm, Farbe: blau

• Matratze Comfort Plus, Größe: 180 x 180 cm, Farbe: rot

Mit welchem Artikelnamen, bzw. in welcher Reihenfolge die einzelne Variante im Artikelnamen genannt wird, ist frei wählbar.

Tipp: Bitte denken Sie auch bei den einzelnen Varianten-Artikeln an den eindeutigen Primärschlüssel!

Die Verfahrensweise bei Artikeln mit eindimensionalen Varianten ist kongruent zum oben genannten Beispiel.

Zum Seitenanfang

Artikelpreise

Preise sind bis pixi LOU grundsätzlich brutto und in der Währung Euro (€) an pixi zu übergeben, Ausnahme ist alleinig der Einkaufspreis im Artikel-Export (BMEcat). Ab pixi ELI ist der Import von Nettopreisen möglich, beachten Sie dazu bitte Nettopreise in pixi.

Preise bzw. Wertangaben sind in den XML Dateien grundsätzlich mit Punkt statt Komma und je nach Bestelltyp mit 2 oder 4 Nachkommastellen anzugeben. Ist der entsprechende Wert gleich „Null“ ist als Feldwert „0.00“ anzugeben.

Beispiel: 0,01 € -> 0.01 oder 12,34 € -> 12.34

pixi unterstützt nur einen Preis pro Artikel im Artikelstamm. Es werden keine Staffel-Preise oder verschiedene Preislisten unterstützt. Allerdings kann bei jeder Bestellung ein für den Kunden individueller Preis übergeben werden, der den Preis im Artikelstamm nicht verändert.

Mehrsprachigkeit

Wird ein mehrsprachiges Shop-System verwendet, sind im Artikel-Import zu pixi (BMEcat) alle Artikelnamen grundsätzlich in Deutsch zu übergeben, die Sprache des Artikelnamens im Bestell-Import zu pixi (OPENtrans) ist frei wählbar.

Abwicklung bei Zahlungsweise „Kreditkarte“

Das Shop-System übernimmt bereits die Autorisierung der Bestellsumme und übergibt an pixi nur die benötigte sog. Transaktions-ID. Diese Art der Übergabe ist nur möglich, wenn die technische Abwicklung über den Dienstleister „iPayment“ oder „Computop“ stattfindet.

Rabatte und Skonto

• Möglichkeit 1: Sie übergeben alle Rabatte, Skonto summiert in einem Wert in der Bestellung.

• Möglichkeit 2 (empfohlen): Sie übergeben Skonto und Rabatt pro Bestellzeile entweder absolut oder prozentual zum Wert der jeweiligen Bestellzeile. Evtl. zusätzlich in Abzug zu bringende Wert- und Promotion-Gutscheine werden pro Bestellung übergeben.

• 
  

Anbindung von sog. Multi- & Sub-Shop-Systemen

pixi ist in der Lage mehrere Mandanten pro Kunden (pro Datenbank) zu verwalten. Pro Mandant ist jeweils die eindeutige im Bestellexport (OPENtrans) zu übergeben, der Artikelstamm wird Mandanten-unabhängig geführt und ist global für alle Mandanten vorhanden. Pro Mandant kann jeweils eine eigene URL mit den jeweiligen Funktionen aufgerufenen werden (z.B. wenn es sich um das gleiche Shop-System mit mehreren Datenbanken und verschiedenen URL’s handelt.) oder die Funktionsaufrufe erfolgen für alle Mandanten über ein und dieselbe URL (vorwiegend für Sub-Shop-Systeme genutzt).

XML Codierung

Bitte benutzen Sie für das XML eine ISO Codierung für Umlaute etc. Eine Codierung nach UTF / Unicode wird im Moment nicht unterstützt.

Zum Seitenanfang