FAQ’s / allgemeine Fehlerbehandlung

Inhaltsverzeichnis

Keine Verbindung, keine gültige Session-ID

Bitte prüfen Sie die hinterlegten Zugangsdaten im Pixi* Control Center und in der Modul-Konfiguration.

Alle Kommunikations-Requests zwischen Pixi* und Magento basieren auf verschiedenen Urls. Bitte stellen Sie sicher, dass diese Urls nicht durch technische Limitierung beschränkt sind

(firewall, ip-whitelisting, .htaccess, http basic-auth)

Bitte gleichen Sie auf Magento-Cloud-Instanzen die Server-Konfigurationen mit den Servernamen/-adressen ab.

Es werden keine Produkte zu Pixi* exportiert

  1. Bitte prüfen Sie die Verbindung mit Pixi Control Center

  2. Prüfen Sie ggf. den Status aller Produkte. Wenn alle Produkte zu Pixi* exportiert wurden, dann findet kein Export statt.

  3. Bitte prüfen Sie ggf. die zu exportierenden Produkttypen. Standardmäßig werden nur Simples exportiert.

  4. Um einen Export wieder zu ermöglichen, müssen Sie den Export-Status der gewünschten Produkte zurücksetzen.

Die Steuersätze werden nicht korrekt übermittelt (MwSt-High statt MwSt-Low)

Bitte stellen Sie sicher, dass alle in Magento verwendeten Steuerklassen den Pixi* Steuerklassen zugewiesen sind Anwendungsfall: Korrekter Export von Steuerklassen

Es werden keine Bestellungen zu Pixi* exportiert

  1. Bitte prüfen Sie die Verbindung mit Pixi Control Center.

  2. Prüfen Sie den Status der Bestellungen. Wenn alle Bestellungen zu Pixi* exportiert wurden, dann findet kein Export statt.

  3. Prüfen Sie die Filtereinstellungen für den Export. Wenn keine Bestellungen den Exportfiltern zutreffen, dann findet kein Export statt.

  4. Prüfen Sie ggf. die Log-Datei, ob es zu Verarbeitungsfehlern kommt und evtl. Bestellungen übersprungen werden

  5. Prüfen Sie ggf. die Verarbeitung im Pixi* Control Center, da evtl. ein Formatierungsfehler vorliegen könnte. Dies könnte Exporte für andere Bestellungen blockieren, da eine Bestellung nie bestätigt wird.

Die Versanddienstleister werden nicht korrekt übermittelt

Bitte stellen Sie sicher, dass alle Magento-Versandmethoden zu Pixi*-Versanddienstleister-Codes zugewiesen wurden.

Die Zahlungsmethoden werden nicht korrekt übermittelt

Bitte stellen Sie sicher, dass alle Magento-Zahlungsoptionen zu Pixi*-Zahlungsmethoden-Codes zugewiesen wurden.

Einige Zahlungsarten stehen nicht zur Auswahl und können nicht verknüpft/gemapped werden.

Sollte es Probleme bzgl. der Auswahl von Zahlungsarten im Mapping geben so nutzen Sie die Kompatibilitätskonfiguration.

Es werden keine Bestände importiert

  1. Bitte stellen Sie sicher, dass die Konfiguration bzgl. Quellen und Lager sowie die Modul-Konfiguration korrekt sind.

  2. Prüfen Sie ggf. die Reservierungen (Bestellungen) in Magento. Die Reservierungen werden erst bei Lieferung (Bestell-Status-Import) aufgelöst. Diese Vorgänge werden über das Pixi* MSI Addon durchgeführt. Wurde das MSI-Addon erst nachträglich installiert, so können Sie manuell die Reservierung aus der Datenbank löschen, da Pixi* als Single-Source-Of-Truth angesehen wird.

Es finden keine Status-Updates bzw. EAN-Updates beim Bestandsimport statt

  1. Bitte prüfen Sie, ob die Konfiguration korrekt ist

    • Ist Attributs-Update aktiviert?

    • Ist das Attribut korrekt?

    • Wird im richtigen Scope importiert?

  2. Prüfen Sie ggf. die Indexer-Status.

Es werden keine Tracking-Infos bei Auslieferung gespeichert

  1. Prüfen Sie, ob die Tracking-Informationen im Pixi* Control Center hinterlegt sind.

  2. Bei Komplettlieferungen werden nachträglich gepflegte Tracking-Infos beim Update-Vorgang ignoriert, da es zu "Überversendungen" kommen kann.

  3. Sind also bereits Auslieferungen (datentechnisch) erfolgt, so werden keine zusätzlichen Lieferscheine mit Tracking-Infos erzeugt. Um mehrmalige Auslieferungen, also Teillieferungen , zu ermöglichen, müssen Sie im Pixi* Control Center sowie in der Konfiguration des Pixi* Connector Moduls das Feature aktivieren.

Es werden falsche bzw. nicht verarbeitbare Länderbezeichnungen im Order-Export an Pixi* übergeben

Das Pixi-Connector-Modul sendet für alle Adressen (Liefer- und Rechnungsadresse) das Land in englischer Sprache aus. Anwendungsfall: Standard-Bestell-Export

Im Pixi* Control Center besteht die Möglichkeit, die Ländertabelle um weitere Schreibweisen eines Landes zu erweitern.

Es werden keine Hersteller-Nummern an Pixi* übergeben bzw. die Produkte werden im falschen Bereich importiert

Die Lieferantenzuweisungen können definiert und exportiert werden Anwendungsfall: Korrekter Export von Lieferantenzuweisungen

  1. Bitte prüfen Sie die Konfiguration bzgl. der Lieferantenzuweisung

  2. Bitte prüfen Sie Daten in Magento für die exportierten Produkte

  3. Bitte prüfen Sie die Import-Bedingungen im Pixi* Control Center

Es werden nicht alle Adresszeilen bzw. keine Hausnummern beim Bestell-Export übermittelt

Es gibt in Magento standardmäßig die Möglichkeit bis zu fünf Zeilen für die "Straße" einer Adresse im Checkout oder im Kundenadressbuch befüllen zu lassen. Des Weiteren können zusätzliche Address-Attribute wie "Hausnummer" definiert werden.

  1. Bitte prüfen die Eigenschaften und Attribute für Kundenadressen.

  2. Bitte prüfen Sie die Konfiguration des Bestell-Exports

    1. Sollten mehrzeilige Straßen in Magento definiert sein, so muss die Anzahl auch im Konfigurationsfeld Maximum number of lines in a street address hinterlegt sein.

    2. Sollten zusätzliche Attribute für Kundenadressen definiert sein, so muss der Attributscode im Konfigurationsfeld pixi* address ZIPBOX hinterlegt sein, damit dieser ebenfalls übergeben wird.

Es wird nicht die korrekte Kategorie eines Produktes an Pixi* übermittelt

  1. Bitte prüfen Sie die Produktdaten und die Kategoriezuweisungen.

  2. Falls nötig, wählen Sie die gewünschte Kategorie aus und speichern das Produkt

    Es wird immer die letzte zugewiesene Kategorie an Pixi* übermittelt

  3. Bitte gleichen Sie das Vorgehen anhand des Anwendungsfall: Zuweisung der Produktkategorie für den Export ab.

Die Bestände in Magento stimmen nicht mit denen von Pixi* überein.

In manchen Fällen kann es zu Abweichungen der Bestände aufgrund von System-Eigenschaften kommen. Hierzu zählen meistens zeitliche Differenzen zwischen der Aktualisierung des Bestandes bis zur Sichtbarkeit im Shop-Frontend. Magento-Indexer sowie Magento-Caches sind für die korrekte Anzeige im Frontend verantwortlich.

  1. Bitte prüfen Sie die Verbindung mit Pixi Control Center

  2. Bitte prüfen Sie die Konfiguration für Lager und Quellen

  3. Bitte prüfen Sie die Einstellungen und Werte des Produktes.

    Das Produkt muss der gewünschten Website zugeordnet sein.

    Das Produkt muss über die konfigurierte Stock/Source versorgt werden.

  4. Bitte prüfen Sie den Status der Indexer bzw. wann der letzte Lauf des Stock-Indexers war.

    Wir empfehlen eine "On Schedule" Indexer-Konfiguration. Dabei müssen Cron-Gruppe/Cron-Job für die Indexierung korrekt eingerichtet sein.

    Um manuell den Index zu aktualisieren, kann das Magento-CLI-Kommando bin/magento indexer:reindex genutzt werden.

  5. Ggf. leeren Sie den Magento-Cache um Aktualisierungen im Frontend zu erzwingen.

    Eine Leerung des Caches wirkt sich negativ auf die Performance des Shops aus.

  6. Bitte prüfen Sie die Datenbanktabelle inventory_reservation, ob es noch Bestandsreservierungen eines Produktes gibt.

    Hier können unter anderem Differenzen auftreten, wenn das Pixi-MSI-Addon nicht installiert und konfiguriert wurde.

    Ggf. löschen Sie veraltete Reservierungen aus der Datenbank, wenn das Pixi-MSI-Addon nachträglich installiert wurde.

    Seit Version 3.0.0 werden Reservierungen über das Pixi-Magento-Connector Modul vorgenommen. Das Pixi-MSI-Addon wird nur bis Magento Version 2.4.3 benötigt.

  7. Bitte prüfen Sie, ob vor der Reservierungsauflösung durch den Confirm-Order-Request bereits eine Auflösung stattfindet. Dies kann ggf. durch Drittanbieter-Module oder Eigenentwicklungen der Fall sein.

Es is kein Rechnungsdruck für digitale Bestellungen möglich.

Die Funktionalität wird seit Version 2.5.2 unterstützt und kann einfach über die Zuordnung der Versandmethoden in Konfiguration des Bestellexports angepasst werden.

  1. Bitte prüfen Sie die Pixi* Connector Version

  2. Bitte konfigurieren Sie die Zuordnung Versandmethoden in der Konfiguration des Bestellexports .

    Der Versanddienstleister für digitale Bestellung ist standardmäßig Digital Order

Wo kann der Export-Status von Bestellungen zu Pixi* eingesehen werden?

Seit Version 2.5.3 werden die Status-Übergänge "exportiert, bestätigt, zurückgesetzt" im Magento-Backend bei den Kommentaren der Bestellung eingesehen werden. In Versionen davor kann der Status nur über die Datenbank ermittelt werden.

Können Bestellungen nur aus einem bestimmten Store exportiert werden?

  • Seit Version 2.6.0 kann mit HTTP-Parametern der Export von Bestellungen bzgl. Stores eingeschränkt werden.

  • In Version 3.1.0 wurde die Filterung anhand der HTTP-Parameter verbessert

  • Seit Version 3.1.0 ist es auch möglich per Konfiguration gewünschte Stores vom Order-Export auszuschließen.

Ist Pixi mit Magento 2.4.4 bzw. PHP 8.1 kompatibel?

Ja. Mit Version 3.0.0 wurde die Kompatibilität zu PHP 8.1 geschaffen. Bitte prüfen die Migrationsbeschreibung

Warum werden Bestellungen Magentoseitig nicht abgeschlossen?

Standardmäßig wird nur der Order-Status bei einem Order-Update gesetzt. Magento-intern wird allerdings der Order-State in vielen Funktionalitäten wie z.B. Reports genutzt. Da Pixi* keine Schnittstelle für die Faktura bietet, können keine Rechnungsdaten über das Modul gesetzt und somit auch kein Order-Abgleich durchgeführt werden. Ab Version 3.1.0 kann über eine Konfiguration erlaubt werden, ob auch ein Order-State-Update ausgeführt werden soll.

Warum werden vom PSP nicht bestätigte Bestellungen an Pixi exportiert?

Standardmäßig werden Bestellungen aufgrund ihres Status an Pixi exportiert. Dazu gibt es modul-seitig einige Filteroptionen .

Es kann vorkommen, dass bei asynchronen Zahlungsbestätigungen die Freigabe durch den PSP etwas mehr Zeit in Anspruch nimmt und zwischenzeitlich die Bestellung bereits an Pixi exportiert wird.

Um diesen Umstand zu korrigieren, können Sie über die Konfiguration einen Zeitversatz (Delay) einstellen. So kann auf die Antwort des PSP gewartet werden, um die Bestellung korrekt oder bei Zahlungsverweigerung gar nicht an Pixi zu exportieren.

Werden Auflösungen von Bestandsreservierungen und Bestandskorrekturen durchgeführt?

Ja. Das Modul bietet eine in sich geschlossene Korrektur von Bestand und Reservierungen. Dabei wird geprüft, ob es sich um eine Bestellung von/für Pixi handelt. Da über das Modul keine Faktura und Stornierungen bietet, werden die Bestände/Reservierungen bei Bestellbestätigung von Pixi ("Order-Confirmation) gesetzt. (siehe Ablauf )

Kann die Korrektur der Bestandsreservierung deaktiviert werden?

Nein. Das Pixi-Modul basiert auf Magento-Standard-Funktionen. MSI inkl. der Reservierungslogik ist das Standard-Feature bzgl. Lagerverwaltung in Magento.

Wurde das MSI-Feature deaktiviert, so kann per Magento-Eventhandling der "Observer" bzgl. Pixi-Reservierungsverwaltung deaktiviert werden.

Ist Pixi-Magento-Connector mit TechDivision Pacemaker kompatibel?

Ja. Generell sind beide Module innerhalb eines Magento-Shops unabhängig voneinander nutzbar. Bezüglich des Exports von Bestellungen und den darauf folgenden Bestandsreservierungskorrekturen wurde das Kompatibilitätsmodul Pacemaker-Pixi-Link geschaffen, welches die Organisation beider Lösungen übernimmt. Das Zusatzmodul kann einfach per Composer installiert werden. composer require techdivision/pacemaker-pixi-link

Sind store-bezogene Imports/Exports möglich?

Grundsätzlich ja, wobei es im Detail um die Funktion und deren Risiken geht. Folgend eine Übersicht zu den Funktionen:

  • Produkt-Export

    Wie hier beschrieben ist der Produkt-Export von Magento zu Pixi nicht store- und auch nicht website-fähig lösbar. Produktdaten werden global gehalten. Über die Einstellungen im Pixi-Control-Center können Sie dennoch eine spezifische Store-Url angeben. Dabei ist zu beachten, dass dann z.B. die Produktnamen oder die Beschreibung in der jeweiligen Store-Sprache exportiert werden.

    Über optionale Url-Parameter können Produkte, welche einem bestimmten Store zugewiesen sind, gefiltert und exportiert werden

  • Bestell-Export

    Über Url-Parameter können Bestellungen aus den gewünschten Stores gefiltert und exportiert werden. Siehe hier .

  • Bestands-Import

    Bestände werden global über die MSI-Lagerverwaltung gehalten. Da Pixi ein solches Lager repräsentiert, wird die Bestandsinformation im konfiguriertem Lager importiert. Die Zusatzoptionen bzgl. EAN- und Status-Update lassen sich per Konfiguration und Url-Einstellungen im Pixi-Control-Center einstellen. Dabei ist zu beachten, dass eine nachträgliche Änderung der Einstellung zu einem globalen Import zu Problemen führt. Die website-/store-spezifischen Werten müssen bereinigt werden.

    Über optionale Url-Parameter kann festgelegt werden auf welcher Ebene die Aktualisierung der Produktattribute (z.B. Status) stattfinden soll.

  • Bestellstatus-Import

    Über einen, vom Pixi-Control-Center gesetzten Url-Parameter, wird die bestimmte Bestellung aktualisiert.