Auf dieser Seite finden Sie Gründe, warum Bestellungen oder XML-Dateien nicht in pixi importiert werden können. Die folgenden Prüfungen gelten für Bestellimporte über XML-Dateien, Shop-Schnittstellen und API-basierte Importprozesse.
Bestellimport fehlgeschlagen
Wenn eine erwartete Bestellung in pixi fehlt, prüfen Sie zuerst, ob die Bestellung pixi erfolgreich erreicht hat. Probleme können im Quellsystem, während der Datenübertragung oder während der Importverarbeitung auftreten.
Export aus dem Quellsystem bei Verwendung einer nicht von pixi unterstützten Schnittstelle
Bevor Sie beginnen, prüfen Sie, ob das Quellsystem tatsächlich versucht hat, die Bestellung zu senden. Wenn die Bestellung nie exportiert wurde oder die Übertragung fehlgeschlagen ist, muss das Problem im Shop, Marketplace, in der Middleware oder in der Integration behoben werden, bevor weitere Fehlerbehebungen in pixi durchgeführt werden. Führen Sie dazu folgende Schritte durch:
Öffnen Sie den Administrationsbereich des Shops, der Middleware oder der Integration, die Bestellungen an pixi sendet.
Suchen Sie nach der betroffenen Bestellnummer oder externen Bestellnummer.
Prüfen Sie das Export-, Übertragungs- oder API-Log für den Zeitpunkt, zu dem die Bestellung gesendet werden sollte.
Wenn das Quellsystem zeigt, dass keine XML-Datei oder API-Anfrage gesendet wurde, prüfen Sie den Zeitplan, den Endpunkt, die Zugangsdaten oder die Exportkonfiguration des Quellsystems, bevor Sie pixi prüfen.
Dateieingang in pixi
Nachdem Sie bestätigt haben, dass die Bestellung gesendet wurde, prüfen Sie, ob pixi die entsprechende XML-Datei erhalten hat. Die Importstatusinformationen in pixi helfen dabei festzustellen, ob die Datei das System erreicht hat und ob der Importprozess erfolgreich gestartet wurde.
Öffnen Sie pixi Control Center > Import und Export.
Öffnen Sie die Übersicht Imports prüfen Sie die Statusmeldungen zum Bestellimport.
Prüfen Sie den Zeitstempel. Wenn dieser älter ist als erwartet, hat pixi keine aktuelle Bestell-XML-Datei vom Quellsystem erhalten.
Wenn pixi XML-Dateien erhalten hat, aber keine Bestellung erfolgreich importiert wurde, fahren Sie mit den folgenden Fehlerprüfungen fort.
Importfehler prüfen
Wenn pixi die Datei erhalten hat, die Bestellung aber nicht importiert wurde, prüfen Sie, ob XML-Parsing- oder Validierungsfehler vorliegen. Diese Fehler weisen in der Regel auf fehlende Pflichtdaten, ungültige Werte oder XML-Strukturen hin, die nicht dem erwarteten Importformat entsprechen.
Prüfen Sie in der Bestellimport-Übersicht aufgrund von Fehlern nicht importierte Bestellungen.
Prüfen Sie heute empfangene XML-Dateien mit Fehlern.
Wenn Sie etwas finden, sehen Sie sich die zugehörigen Fehlerdetails oder den Logeintrag an und suchen Sie nach der betroffenen Bestellnummer.
Verwenden Sie den ersten für die Bestellung angezeigten Fehler als Ausgangspunkt. Spätere Meldungen können Folgefehler sein, die durch das erste ungültige Feld oder den ersten fehlenden Wert verursacht wurden.
XML-Datei mit der dokumentierten Bestellimportstruktur vergleichen
Wenn ein Importfehler ein bestimmtes Feld oder XML-Element nennt, vergleichen Sie die Datei mit der dokumentierten Spezifikation für den Bestellimport. Dadurch lassen sich fehlende Elemente, falsche Werte und Formatierungsprobleme erkennen, die verhindern, dass die Bestellung verarbeitet wird.
Öffnen oder speichern Sie die XML-Datei, die für die betroffene Bestellung gesendet wurde.
Prüfen Sie, ob die Datei die erforderliche Bestellstruktur enthält, einschließlich ORDER, ORDER_HEADER, ORDER_ITEM_LIST sowie der erforderlichen Artikel- und Preiselemente.
Prüfen Sie das im Importfehler genannte Feld. Prüfen Sie beispielsweise Firmenname, Adressfelder, USt-IdNr., Artikelnummer, Menge, Preis, Währung und Shop-ID-Werte.
Vergleichen Sie die XML-Tags und Pflichtwerte mit openTRANS Syntax-Spezifikationen für die Übergabe im XML-Format.
Häufig gestellte Fragen
Warum schlägt die Bestellung fehl, wenn ein Feld zu lang ist?
Der Import kann fehlschlagen, wenn ein Wert in der XML-Datei die zulässige Feldlänge überschreitet. Dies betrifft häufig Firmennamen, Lieferadressfelder, Adresszusätze, Kommentare oder andere Freitextfelder.
Prüfen Sie das im Importfehler genannte Feld. Kürzen Sie anschließend den Wert im Quellsystem, im Schnittstellen-Mapping oder in der XML-Datei und senden Sie die Bestellung erneut. Wenn der Fehler den Firmennamen oder Adressdaten erwähnt, prüfen Sie, ob der Firmenname in ein Adresszusatzfeld übertragen wurde. Halten Sie den Wert innerhalb der für das Zielfeld zulässigen Länge.
Was sollte ich prüfen, wenn USt-IdNr., Steuernummer oder Adressdaten den Import blockieren?
Prüfen Sie, ob USt-IdNrn., Steuernummern und Adressdetails im Quellsystem in den richtigen Feldern gespeichert sind. Ein USt-IdNr.-Feld sollte ausschließlich die USt-IdNr. enthalten. Adressfelder sollten ausschließlich Adressdaten enthalten.
Wenn die Informationen erhalten bleiben müssen, aber nicht in das Feld für USt-IdNr. oder Steuernummer gehören, verschieben Sie sie in ein geeignetes Kommentar- oder Notizfeld im Quellsystem oder im Integrations-Mapping. Senden Sie die Bestellung anschließend erneut.
Was sollte ich prüfen, wenn der Fehler mit Preis, Währung oder Bestellsummen zusammenhängt?
Prüfen Sie die Preisfelder in der XML-Datei. Stellen Sie sicher, dass die erforderlichen Preiselemente vorhanden sind und dass der Preistyp zum gesendeten Wert passt. Vergleichen Sie bei Bestellimporten die ARTICLE_PRICE-Struktur mit openTRANS Syntax-Spezifikationen für die Übergabe im XML-Format.
Wenn Ihre Frage die API-Rückgabe betrifft, beachten Sie, dass API-Calls Werte möglicherweise nur in der Bestellwährung zurückgeben. Gehen Sie nicht davon aus, dass eine API-Antwort umgerechnete EUR-Werte enthält, sofern dies nicht ausdrücklich in der jeweiligen API-Dokumentation angegeben ist.
Was sollte ich tun, wenn Sonderzeichen in der XML-Datei vorkommen?
Prüfen Sie Textfelder, die Sonderzeichen enthalten, beispielsweise „&“, Anführungszeichen, Apostrophe, Markensymbole oder andere Sonderzeichen. Wenn ein Textblock komplexe Sonderzeichen enthält, verwenden Sie CDATA, sofern dies von der XML-Spezifikation unterstützt wird, anstatt sich ausschließlich auf XML- oder HTML-Entity-Encoding zu verlassen.
Senden Sie die Bestellung nach Anpassung des Textwerts erneut und prüfen Sie, ob der Importfehler behoben ist.
Was sollte ich tun, wenn ein obligatorisches XML-Element fehlt?
Öffnen Sie die XML-Datei und vergleichen Sie sie mit der dokumentierten Bestellimportstruktur. Prüfen Sie, ob die Datei den erforderlichen Bestellkopf, die Bestellpositionsliste, Artikelkennungen, Menge, Währung und Preisinformationen enthält.
Wenn der fehlende Wert aus dem Shop oder der Middleware stammt, korrigieren Sie das Mapping im Quellsystem und senden Sie die Bestellung erneut.
Was sollte ich prüfen, wenn pixi die Bestellung überhaupt nicht erhalten hat?
Prüfen Sie zuerst das Quellsystem. Stellen Sie sicher, dass der Shop, Marketplace-Connector, die Middleware oder der API-Client die Bestellung tatsächlich an pixi gesendet hat. Prüfen Sie Export-Log, Übertragungs-Log, API-Antwort, Verfügbarkeit des Endpunkts, Zugangsdaten und Status geplanter Jobs.
Prüfen Sie anschließend pixi Control Center > Import und Export, um zu sehen, ob eine aktuelle Bestell-XML-Datei empfangen wurde. Wenn der letzte XML-Import älter ist als erwartet, hat die Bestellung pixi wahrscheinlich nicht erreicht.
Kann ich ältere XML-Dateien zur Fehlerbehebung abrufen?
Ältere Bestell-XML-Dateien sind möglicherweise nur für begrenzte Zeit verfügbar. Speichern Sie die XML-Datei oder relevante Logdetails, sobald Sie das Problem bemerken.
Wenn die ursprüngliche XML-Datei nicht mehr verfügbar ist, erstellen oder senden Sie eine neue Testbestellung aus dem Quellsystem erneut und verwenden Sie diese XML-Datei für die Fehlerbehebung.
Woher weiß ich, ob der API-Call pixi erreicht hat?
Beginnen Sie mit dem API-Client oder der Middleware, die die Anfrage sendet. Prüfen Sie Zeitstempel der Anfrage, Endpunkt, Datenbank, Shop, Zugangsdaten und die vom API-Call zurückgegebene Antwort. Wenn die Antwort nur bestätigt, dass die Anfrage angenommen wurde, prüfen Sie anschließend in pixi, ob der zugehörige XML-Import erfolgreich verarbeitet wurde.
Was sollte ich prüfen, wenn die API-Antwort nicht den erwarteten Wert enthält?
Vergleichen Sie Anfrage und Antwort mit der Dokumentation für den jeweiligen API-Call. Gehen Sie nicht davon aus, dass zugehörige Werte zurückgegeben werden, sofern sie nicht in der API-Dokumentation aufgeführt sind. Aktuelle Hinweise haben beispielsweise bestätigt, dass API-Calls Werte möglicherweise nur in der Bestellwährung zurückgeben und keine umgerechneten EUR-Werte bereitstellen.
Wann Sie den Support kontaktieren sollten
Wenden Sie sich an den Descartes pixi Support, wenn:
Die XML-Datei der dokumentierten Spezifikation entspricht, pixi die Bestellung aber weiterhin ablehnt.
Der Importfehler kein Feld und keinen Wert nennt.
Die Bestellung pixi erreicht hat, aber nicht im erwarteten Workflow sichtbar ist.
Das Problem nach einem Update oder einer Integrationsänderung begonnen hat.
Geben Sie die Bestellnummer, XML-Datei oder API-Anfrage, den Zeitstempel, das Quellsystem und die genaue Fehlermeldung an.