• Informationen zur Schnittstellen / Unterstützte Funktionen

Die Schnittstelle muss in folgendem Ordner installiert werden: /engine/connectors/pixi/

Der alte Schnittstellen-Ordner, falls vorhanden, sollte vorher umbenannt werden.

Führen Sie einfach in Ihrer Datenbank die Befehle aus der Datei "install.sql" aus.

Legen Sie einen Shopware Backend-Benutzer für die pixi-Schnittstelle an. Dieser sollte ausschließlich für pixi zur Verfügung stehen und Adminrechte besitzen.

Die Konfigurationsmaske finden Sie unter "Einstellungen / Grundeinstellungen / Schnittstellen / pixi"

Folgende Einstellungen sollten unbedingt vorgenommen werden:

• EAN-Feld: Das Feld in dem die EAN-Nummer gespeichert werden soll. Dieses Feld muss ggf. vorher über ein neues Artikel Attribut angelegt werden.
• pixi-Datenbank: Erhalten Sie vom pixi-Support
• pixi-MandantenID: Erhalten Sie vom pixi-Support

Weitere Einstellungen sollten Sie nur in Absprache mit dem Shopware-Support durchführen.

Folgende Daten zur Einrichtung der pixi-Software müssen Sie an den pixi-Support weiterleiten:

• die Links aus dem Shopware-Backend unter "Einstellungen / Grundeinstellungen / Schnittstellen / pixi"
• die Zugangsdaten des neu angelegten Shopware Backend-Accounts

Verfügbare Felder in der Shopware Administration

letzter Artikelexport aus Shopware an pixi

Das Datum wird beim Artikelexport durch die Schnittstelle gesetzt. Damit wird sichergestellt, dass nur beim ersten Mal alle Artikel und später nur noch Artikel-Aktualisierungen erfolgen.

Man kann das Datum manuell zurücksetzen (leer), dann erfolgt dieser noch einmal komplett. Das kann in gewissen Supportfällen notwendig sein, z.B. wenn die Artikeldaten ergänzt wurden, z.B. durch ein Attribut etc.

Defaultwert = 100

100 Artikel werden in einem Schritt abgearbeitet. Dieser Wert sollte nur in Ausnahmefällen verändert und eher nach unten korrigiert werden.

Hinweis:

Die Serverparameter memory_limit, max. Ausführungszeit für Scripte und Datenverabeitung sind für den Abgleich relevant und müssten daher von den Werten ggf. nach oben korrigiert werden.

Standardmäßig wird nur die EAN benötigt. Generell ist darauf zu achten, dass diese Attribute nicht bereits anderweitig genutzt werden. Die EAN-Zuordnung erfolgt dann seitens pixi.

Beiden folgenden Felder werden ebenfalls durch pixi befüllt, falls dort gepflegt. (Abgleich bei Bestandsupdate)

• EAN-Feld: Attributsfeld für die EAN-Nummer (Unterstützt werden die Artikel Attribute attr1 bis attr20)
• (optional) Lieferdatum-Feld: (DELIVERY_DATE) beschreibt das Lieferdatum des Herstellers/Lieferanten - Kann in eine Shopware Attributsfeld geschrieben werden und optional im Template angezeigt werden. (Standard attr20)
• (optional) Feld für die Artikelmenge im Zulauf: Attributsfeld für Artikelmenge (Standard attr19)

Diese Felder werden zum Export der Artikel und Bestellungen benötigt, um diese in pixi zuzuordnen. Das kann z.B. auch bei Multishop/Subshop genutzt werden. Abweichende Daten können über die Länderflaggen definiert werden.

Diese beiden Felder werden beim Bestellexport an pixi mit übergeben.

Die Versandart kann z.B. fix definiert werden. Dieser "Text" wird dann bei jedem Export 1zu1 an pixi übergeben. Alternativ kann auch mit Smarty-Abfragen gearbeitet werden, um diese Felder dynamisch zu befüllen.

Beispiele für das Feld "Template für die Versandart"

wenn Lieferland Deutschland ist nutze "DHL", ansonsten "UPS" als Versandart

 
{if $sCustomer.shipping_country=='Deutschland'}DHL{else}UPS{/if}
 

wenn Versandart ist Spedition übergebe "SPE" ansonsten "DHL"

 
{if $sOrder.dispatch_description=='Spedition'}SPE{else}DHL{/if}
 

Versandinformationen können übergeben werden, um diese z.B. auf der Rechnung oder dem Lieferschein in pixi auszugeben.

default: Freitextfeld 1 der Versandadresse

Diese Informationen kann man durch pixi auf der Rechnung ausgeben lassen.

Möglich wäre auch die Ausgabe des Bestell-Kommentars

Folgende Variable muss dafür definiert werden:

 
{$sOrder.comment}
 

Hier wird die Shopware Kundennummer an pixi übergeben, die dann auch in pixi weiter genutzt werden kann. Denkbar sind auch die Ausgabe einer anderen Smartyvariable, wie z.B. die eMail-Adresse des Kunden.

Andere Zuordnungen, als z.B. die Kundennummer, sollten im Vorfeld mit pixi abgeklärt werden

Kundennummer:

 
{$sCustomer.customernumber|escape}
 

oder eMail-Adresse:

 
{$sCustomer.email}
 

Hier definiert man das z.B. nur Bestellungen exportiert werden, die den Status 0 haben. Nach dem Export wird der jeweilige Status auf 1 gesetzt.

Diese Werte sollten nicht verändert werden!

Hier kann der Bestellstatus direkt aus pixi heraus geupdatet werden. (aktiv = 1) Voraussetzung ist, dass dies in pixi aktiviert wurde. Weitere Informationen erhalten Sie bei pixi.

Aktuell wird dieses nicht im Shopware Template genutzt, ist aber technisch möglich.

Um Artikel eindeutig zu identifizieren wird hier das Shopware Feld definiert. Drei Werte sind hierbei möglich

articleID, articledetailsID oder ordernumber

Mögliche Variablen:

supplierID, attr* oder supplier

Hier werden nur 4 Zeichen von pixi unterstützt. Daher sollte in Shopware ein sinnvolles Feld definiert werden, was den Hersteller anhand 4 Zeichen einwandfrei identifizieren kann. Wird dieses Feld leer gelassen, so greift automatisch ein Fallback auf die supplierID.

folgende Statusänderungen sind verfügbar / werden durchgeführt

• in Bearbeitung
• teilweise ausgeliefert
• komplett ausgeliefert
• storniert / abgelehnt

Zahlstatus wird ebenfalls auf "komplett bezahlt" gestellt, sofern eine Bestellung ausgeliefert wurde (auch bei "teilweise ausgeliefert")

Der Status wird ebenfalls pro Bestellposition übergeben.