XML-Import
Übertragen Sie Produkt-, Kategorie-, Kunden- und Bestelldaten per HTTP-Request in Ihren Shop. Die XML-Import-Schnittstelle verarbeitet die Daten serverseitig und liefert eine strukturierte Antwort im JSON-Format mit Ergebnisübersicht und Fehlermeldungen.
Verfügbare Imports
Produkte
Import und Aktualisierung von Produktdaten inkl. Beschreibungen, Preisen, Bildern und Attributen.
Dokumentation →Bestände & Status
Schnelle Aktualisierung von Lagerbeständen und Produktstatus – optimiert für häufige Updates mit minimalem Datenumfang.
Dokumentation →Kategorien
Import von Kategoriestrukturen inkl. Hierarchie, Beschreibungen und SEO-Daten.
Dokumentation →Bestellungen aktualisieren
Aktualisierung von Bestellstatus, Tracking-Nummern und Versandinformationen bestehender Bestellungen.
Dokumentation →Kunden
Import von Kundendaten inkl. Adressen, Kundengruppen, Newsletter-Abonnements und externen Kundennummern.
Dokumentation →Merkmale
Batch-Verarbeitung
Verarbeiten Sie mehrere Datensätze in einer einzelnen Anfrage – ideal für Massenimports und regelmäßige Aktualisierungen.
JSON-Response
Strukturierte Verarbeitungsantwort mit Status pro Datensatz – maschinell auslesbar für nahtlose Integration.
Validierung
Automatische Prüfung aller übermittelten Daten mit detaillierten Fehlermeldungen bei ungültigen Einträgen.
API-Schlüssel
Zugriff über konfigurierbare API-Keys mit individuellen Berechtigungen für sichere Datenübertragung.
HTTPS-Verschlüsselung
Alle Daten werden verschlüsselt übertragen – sichere Kommunikation zwischen Shop und externen Systemen.
Fehlerbehandlung
Detaillierte Fehlermeldungen bei ungültigen Daten ermöglichen schnelle Diagnose und Korrektur.
Antwort und Fehlerfälle
Jeder Import antwortet mit einem JSON-Objekt. Seit xoPort API 2.115.0 (Shop 4.9.65) enthält es zusätzlich:
outcome:ok(keine Datei abgelehnt),partial(einzelne Dateien abgelehnt, die übrigen verarbeitet) oderfailed(Dateien abgelehnt, keine verarbeitet)files.failed: abgelehnte Dateien mit Anzahl, Dateinamen, Fehlermeldung samt Zeile und Ablageortwarnings.invalid_xml_chars_removed: Anzahl der entfernten Zeichen, die XML 1.0 nicht erlaubt
Zeichen, die XML 1.0 verbietet (z. B. Steuerzeichen in Beschreibungstexten), entfernt der Import, bevor er die Datei verarbeitet. Lässt sich eine Datei trotzdem nicht als XML lesen, wird sie nicht archiviert, sondern nach xoport/xml/import/error/ verschoben und dort wie das Archiv nach der Aufbewahrungsfrist gelöscht (Standard 14 Tage). Abgelehnte Dateien stehen nicht unter files.processed.filenames.
"state": "error" und HTTP 422. Einzelne abgelehnte Dateien ändern den HTTP-Status nicht – prüfen Sie dafür outcome bzw. files.failed.count. "state": "success" allein beweist keinen Import.