Die Imports 2.0 sind ein Administrator-Werkzeug im pixi Control Center. Dieses ermöglicht Ihnen, eine Verbindung zum Shop einzurichten und Artikel- sowie Bestellinformationen zwischen pixi und dem Shop zu synchronisieren. Die Imports 2.0 werden verwendet, um
Artikel und Bestellungen aus dem Shop in pixi zu importieren,
Lagerbestand, Artikel- und Bestelldetails von pixi zum Shop zu exportieren.
Die Imports 2.0 erlauben die Einrichtung, Überwachung und Kontrolle der Import- und Export-Prozesse sowie die Behebung von Fehlern, die beim Parsen und der Überprüfung der XML-Dateien entsprechend der Import-Bedingungen auftreten. Außerdem können Sie sich Benachrichtigungen einrichten, die den pixi Administrator im Falle von Fehlern informieren.
Um zu gewährleisten, dass keine falschen oder inkompatiblen Daten zu pixi importiert werden, werden alle eingehenden XML-Dateien hinsichtlich definierter Bedingungen geprüft. Wenn eine XML-Datei fehlerhaft ist, wird sie in einer Zwischentabelle gespeichert und nicht in pixi importiert. Tritt dieser Fall ein, werden Sie umgehend mit Hilfe einer automatischen E-Mail informiert. Dann können Sie den Fehler in der XML-Datei manuell beheben und sie erneut in pixi importieren. War der Import erfolgreich, so werden die empfangenen Daten in pixi aktualisiert bzw. übernommen.
Die Imports 2.0 werden automatisch in bestimmten Intervallen ausgeführt. Der Import/Export-Prozess wird automatisch durch einen Server Job gestartet, welcher alle 5 Minuten folgende Schritte durchführt:
Artikel-Import
Bestell-Import
Artikel-Export
Bestell-Export
Diese Schritte werden nacheinander durchgeführt. Wenn ein Prozess noch nicht beendet ist, dann wird er auch nicht neu gestartet bis alle Aufgaben abgeschlossen sind. Das Zeitintervall zwischen den einzelnen Schritten für den Artikel/Bestell-Export kann mit Hilfe zweier Datenbank-Einstellungen angepasst werden (mindestens 4 Minuten). Ab pixi 18.10: jeder einzelne Prozess läuft nun in einem separaten Server Job. Das Zeitintervall zwischen zwei Aufrufen kann für den jeweiligen Job separat konfiguriert werden. Darüber hinaus wurde ein weiterer Job für das separate Parsen der Artikel- und Bestellimport-XMLs eingerichtet.
Eine Anleitung zur Einrichtung der Imports 2.0 finden Sie hier.
Wichtige Informationen zur Behebung von Problemen beim Artikel-/Bestellimport und -export finden Sie hier.
Benutzeroberfläche
Die Benutzeroberfläche zur Administration der Imports 2.0 – Funktionalität finden Sie im pixi Control Center unter dem Reiter Import und Export.
Die Benutzeroberfläche kann in vier Abschnitte unterteilt werden:
-
Die Werkzeugleiste mit den Schaltflächen für die einzelnen Funktionen:
Neu laden: Die Ereignisse in der Tabelle werden aktualisiert.
Ansicht: Hier können Sie direkt in eine bestimmte Ansicht springen. Wenn Sie zum Beispiel in der Übersichtstabelle einen Eintrag des Artikel-Imports ausgewählt haben und anschließend den Button Ansicht klicken, gelangen Sie automatisch in die Ansicht des Artikel-Imports. Darüber hinaus werden die Felder Datum und Channel automatisch mit den Werten der zuvor ausgewählten Zeile befüllt und in der Ansicht Artikel-Import als Filter verwendet.
Optionen...: Hier können Sie die Einstellungen für den Import und Export bearbeiten.
-
Navigationsbaum zum Wechseln der Ansicht:
Übersicht: Dies ist die Standard-Ansicht, wenn Sie den Reiter Import und Export im pixi Control Center öffnen. Sie sehen hier eine Status-Übersicht der Import- und Export-Prozesse.
Artikel-Import: Hier können Sie sich den detaillierten Status des Artikel-Imports anzeigen lassen. Darüber hinaus haben Sie die Möglichkeit die Ergebnisliste durch Filterparameter anzupassen und nach importierten XML-Dateien und Datensätzen zu suchen.
Bestell-Import: Hier können Sie sich den detaillierten Status des Bestell-Imports anzeigen lassen. Darüber hinaus haben Sie die Möglichkeit die Ergebnisliste durch Filterparameter anzupassen und nach importierten XML-Dateien und Datensätzen zu suchen.
Artikel-Export: Hier haben Sie die Möglichkeit, sich den Status des Artikel-Exports anzeigen zu lassen. Sie können die Ergebnisliste durch Filterparameter anpassen und nach exportierten XML-Dateien suchen.
Bestell-Export: Hier haben Sie die Möglichkeit, sich den Status des Bestell-Exports anzeigen zu lassen. Sie können die Ergebnisliste durch Filterparameter anpassen und nach exportierten XML-Dateien suchen.
Werkzeuge: Hier finden Sie Import- & Export-Werkzeuge, um zum Beispiel den kompletten Lagerbestand von pixi zum Shop zu exportieren.
Service Status: Hier sehen Sie den Status der laufenden Prozesse zum Im- und Export der Artikel- und Bestelldaten.
Tabellarische Übersicht der Ereignisse: Je nachdem, welche Ansicht Sie gewählt haben, sehen Sie in diesem Bereich die Ereignisse des Im- und Exports.
Arbeiten mit den Imports 2.0
Öffnen Sie das pixi Control Center und wählen Sie den Reiter Import und Export aus, um zu Imports 2.0 zu gelangen.
In der Übersicht können Sie:
die aktuellen Im- und Exportprozesse überwachen,
prüfen, ob die Im- und Exportdienste laufen,
nach importierten und exportierten Artikeln und Bestellungen suchen,
mögliche Fehler in den XML-Dateien beheben.
Die Übersicht zeigt Ihnen für alle aktiven Shop-Kanäle Informationen zum Status von bereits ausgeführten und von noch ausstehenden Transaktionen an:
Anzahl der XML-Dateien in der Warteschlange für den Artikel-Export an den Shop,
letzter XML-Artikel-Export,
auf Grund von Fehlern nicht importierte Artikel,
heute empfangene fehlerhafte XML-Artikeldateien,
letzter XML-Artikel-Import,
letzter erfolgreicher Artikel-Import,
Anzahl der XML-Dateien in der Warteschlange für Bestell-Export an den Shop,
letzter XML-Bestell-Export,
auf Grund von Fehlern nicht importierte Bestellungen,
heute empfangene fehlerhafte XML-Bestelldateien,
letzter XML-Bestell-Import,
letzter erfolgreicher Bestell-Import.
Der Status „Error“ zeigt an, dass die Transaktion nicht erfolgreich war. „Warning“ wird ausgegeben, wenn eine gewisse (in den Einstellungen der Datenbank festgelegte) Zeit seit der letzten Transaktion überschritten ist, was auf mögliche Probleme mit den Im- und Export-Prozessen hindeutet.
Artikel-Import/Bestell-Import
Mit dieser Aktion fragt pixi mittels einer XML-Anfrage beim Shop nach neuen oder geänderten Daten, woraufhin der Shop eine XML-Antwort sendet. Für den Fall, dass es Unterschiede gibt, enthält die XML-Datei die Änderungen, die sich seit der letzten Anfrage ergeben haben. Der XML-Dateistatus zeigt den aktuellen Stand der Prozesse (Importieren, Parsen, Bedingungsprüfung, …) an. Gibt es keine Fehler, werden die Daten in pixi importiert und aktualisiert. Wenn Fehler auftreten, werden die Daten nicht importiert, und es wird eine automatische E-Mail an Sie gesendet. Die XML-Dateien können erneut importiert werden, nachdem die Fehler manuell behoben wurden. Weiterführende Informationen dazu finden Sie hier: Problembehebung für Imports 2.0
Bitte beachten Sie, dass bei Verwendung der URL-Verbindungsart ab pixi LOU Official auch der Import von Bundle-Artikeln unterstützt wird.
Artikel-Export
Diese Aktion synchronisiert die Lagerdaten zwischen pixi und dem Shop. Werden der Lagerbestand oder der Meldebestand in pixi geändert, wird eine XML-Datei (mit den geänderten Artikeln) generiert und an den Shop gesendet. Der Shop antwortet über XML; treten keine Fehler auf, wird die Lagermenge im Shop aktualisiert. Eventuelle Fehler in der XML-Datei können manuell behoben werden.
Bitte beachten Sie, dass die XML-Datei für jeden Artikel einzeln oder als Batch (z. B. für 100 oder auch 1000 Artikel) generiert werden kann. Dies kann in den Datenbank-Einstellungen angepasst werden. Der pixi-Administrator kann den Artikel-Export zum Shop darüber hinaus auch direkt in der Artikelinfo durchführen sowie nach dieser Transaktion in Imports 2.0 suchen.
Bestell-Export
Der Bestell-Export zusammen mit Sendungsnummer (Tracking ID) und Artikelbemerkung (wenn vorhanden) an den Shop findet statt, wenn der Bestellstatus auf HAL, ANG, AUS, RET, NLB oder STO wechselt. Für jede Bestellzeile (jeden bestellten Artikel) wird eine separate XML-Datei generiert.
Imports 2.0 ist so eingerichtet, dass es in regelmäßigen Abständen ausgeführt wird. Dies ist abhängig von der Anbindung an den Shop-Channel. In den Datenbank-Einstellungen kann das Intervall für den Artikel- und den Bestell-Export angepasst werden. Außerdem können Sie den Import- und den Export-Prozess manuell ausführen.
Suche nach importierten / exportierten Artikeln und Bestellungen
Öffnen Sie das pixi Control Center und selektieren Sie den Reiter Import und Export.
Klicken Sie in der Übersicht auf den gewünschten Unterpunkt der Baumstruktur.
Geben Sie einen oder mehrere Suchparameter an und klicken Sie auf Suche. Bitte beachten Sie, dass die Suchparameter nicht zwingend notwendig sind. Werden keine angegeben, werden die XML-Dateien oder die Artikeldatensätze in den Suchergebnissen nach dem Erstelldatum sortiert.
Doppelklicken Sie den Datensatz in der Suchergebnis-Tabelle.
Hinweise:
- Die Suche deckt nur die vergangenen 14 Tage ab.
- Klicken Sie Löschen, um die Suchparameter zurückzusetzen.
- Einmal pro Tag wird eine E-Mail („Import-Status“) mit den Artikel- und Bestell-Import-Statistiken an den pixi-Administrator versendet.
- Einmal pro Tag wird eine E-Mail („Export-Status“) mit den Artikel- und Bestell-Export-Statistiken an den pixi-Administrator versandt.
Import aller Artikel aus dem Shop
Warnung: Der Import aller Artikeldaten aus dem Shop kann zu Performance-Problemen der pixi Server führen. Benutzen Sie dieses Tool daher nur, wenn es wirklich notwendig ist und stellen Sie sicher, dass der Prozess abgeschlossen ist, bevor Sie diesen erneut ausführen.
Öffnen Sie das pixi Control Center und selektieren Sie den Reiter Import und Export.
Klicken Sie im Navigationsbaum auf Werkzeuge.
Wählen Sie unter Shop-Import den Shop-Channel aus der Liste aus.
Klicken Sie auf Import.
Alle Artikel aus den ausgewählten Kanälen werden in pixi importiert.
Export aller Artikel zum Shop
Warnung: Der Export aller Artikeldaten zum Shop kann zu Performance-Problemen der pixi Server führen. Benutzen Sie dieses Tool daher nur, wenn es wirklich notwendig ist und stellen Sie sicher, dass der Prozess abgeschlossen ist, bevor Sie diesen erneut ausführen.
Die ausgewählten Artikel und/oder Bundles werden entsprechend den Artikelexport-Einstellungen für die jeweiligen Kanäle an alle aktivierten Shops exportiert.
So führen Sie einen Artikelexport durch:
Öffnen Sie das pixi Control Center und selektieren Sie den Reiter Import und Export.
Klicken Sie im Navigationsbaum auf Werkzeuge.
Wählen Sie aus, welche Artikel und/oder Bundles unter Shopverbindung exportiert werden sollen.
Klicken Sie auf Export.
Im Bereich Shopverbindung stehen Ihnen unterschiedliche Optionen zur Verfügung, mit denen Sie genau festlegen können, welche Artikel und/oder Bundles exportiert werden sollen:
-
Lagerbestand exportieren: Wählen Sie hier aus, für welche Artikel der Lagerbestand exportiert werden soll.
Nur geänderte Artikel: Wählen Sie diese Option, wenn Sie nur den Lagerbestand der Artikel exportieren möchten, für die sich der Lagerbestand in pixi erst kürzlich geändert hat, aber noch nicht an die angebundenen Kanäle exportiert wurde.
Alle Artikel: Der Lagerbestand aller Artikel wird exportiert.
Nur Bestand neuberechnen: Wählen Sie diese Option, wenn Sie keinen Export durchführen, sondern lediglich den Bestand in pixi neuberechnen lassen möchten.
Physischer Bestand aktualisieren: Es wird der physische Bestand aktualisiert.
-
Export-Einstellungen: In diesem Abschnitt können Sie definieren, welcher Artikeltyp und Artikelstatus exportiert werden soll.
-
Artikelstatus: Wählen Sie den Artikelstatus aus, der für den Export berücksichtigt werden soll.
Aktiv: Nur aktive Artikel werden exportiert.
Aktiv + Inaktiv (auf Lager): Alle aktiven Artikel und nur inaktive Artikel mit Bestand werden exportiert.
Inaktiv mit Bestand (auf Lager): Nur inaktive Artikel mit Bestand werden exportiert.
Inaktiv: Nur inaktive Artikel werden exportiert.
Alle: Artikel in den Status "Aktiv" und "Inaktiv" werden exportiert.
-
Artikeltyp: Wählen Sie aus, welcher Artikeltyp exportiert werden soll. Wird nichts ausgewählt, werden Artikel und Bundles exportiert.
Artikel: Nur "normale" Artikel werden exportiert. Auch Artikel, die Teil eines Bundles sind.
Bundles: Nur Bundles (virtuelle Artikel) werden exportiert.
-
Hinweise:
- Für alle Artikel wird der Lagerbestand, der Meldebestand, das Lieferdatum und der Barcode exportiert.
- Für Bundles wird nur der verfügbare Lagerbestand exportiert.
- Ab pixi LOU Update 9 steht zusätzlich die Option "Schließe inaktive Artikel mit Bestand 0 ein" zur Verfügung. Per Standard ist diese Option deaktiviert, sodass nur aktive und inaktive Artikel mit Bestand erfasst werden. Aktivieren Sie diese Option, werden die Bestände sämtlicher Artikel an die Channels exportiert – auch die inaktiver Artikel ohne Bestand.
- Ab pixi AVA Update 8 steht zusätzlich die Option "Artikelexport - Status oder Location für Meldebest" (pixi Control Center > Datenbank Einstellungen > Imports 2.0 > Export) zur Verfügung. Per Standard ist diese Option leer, sodass lediglich der Status eines Artikel in Form der Werte "1" (verfügbar) oder "-99" (nicht verfügbar) exportiert wird. Um den Meldebestand einer bestimmten Location zu exportieren, geben Sie bitte die Location ID ein (bspw. "001").
Export eines einzelnen Artikels zum Shop
Informationen für einen einzelnen Artikel können mit Hilfe der Artikel Info exportiert werden.
Suchen Sie innerhalb einer pixi Applikation nach dem gewünschten Artikel.
Öffnen Sie anschließend die Artikel Info für diesen Artikel.
Klicken Sie nun Artikel in Shop exportieren im Reiter Allgemein.
Hinweis: Um zu überprüfen, ob der Artikel-Export erfolgreich war, suchen Sie im pixi Control Center > Reiter Import und Export > Artikel-Export nach diesem Eintrag.
Bestandsexport
Wenn eine Bestellung in pixi importiert wird, wird der Bestand für die bestellten Artikel automatisch zum Shop exportiert.
Ab pixi LOU Milestone 1 gibt es eine neue Einstellung im pixi Control Center > Reiter Datenbank Einstellungen > Ordner Imports 2.0 > Unterordner Export > Bestandsexport bei aktiviertem Reservierungsmodul. Mit dieser Einstellung ist es möglich, den verfügbaren Lagerbestand zu exportieren, wenn die Reservierungsfunktion aktiviert ist. Bisher wurde immer der verfügbare Lagerbestand (res.) automatisch exportiert.
Der Bestand wird nun entsprechend der Einstellungen im pixi Control Center wie folgt berechnet:
Ordner Import/ Export > Artikelimport (BMECat) > Export des physischen Lagerbestands für Artikel (nicht Bundles) |
Ordner Reservierungen > Reservierungen aktivieren |
Ordner Imports 2.0 > Export > Bestandsexport bei aktiviertem Reservierungsmodul |
Exportiert wird: |
AN |
AUS oder AN |
- |
|
AUS |
AUS |
- |
|
AUS |
AN |
AN |
|
AUS |
AN |
AUS |
Wenn die Einstellung Export des physischen Lagerbestands für Artikel aktiviert ist, dann wird immer der physische Lagerbestand exportiert – unabhängig von den Werten der anderen Einstellungen.
Wenn die Einstellung Reservierungen aktivieren deaktiviert ist, wird immer der verfügbare Lagerbestand exportiert – unabhängig von den Werten der anderen Einstellungen.
Bei aktivierten Reservierungen folgende Datenbankeinstellung die Berechnung des exportierten Bestands für Bundles: Ordner Imports 2.0 > Export > Berechnung des Bundlebestands (ab pixi AVA Update 8)