XML-Produktimport und Lieferanten-XML-Integration

Was ist XML-Produktimport und wozu dient eine Lieferanten-XML-Integration?

Beim XML-Produktimport wird ein Produktkatalog eines Lieferanten, Herstellers, Distributors oder einer anderen Datenquelle strukturiert in ein E-Commerce-System übernommen. Ein Feed kann Produktname, SKU, Barcode, Kategorie, Marke, Beschreibung, Einkaufs- oder Verkaufspreis, Bestand, MwSt., Bild-URLs, technische Merkmale und Varianten enthalten.

Die eigentliche Arbeit besteht nicht nur darin, eine XML-Datei zu öffnen. Eine produktive Integration muss Felder korrekt auf das Zielmodell abbilden, Dubletten verhindern, Bestand und Preise sicher aktualisieren, Kategorien und Varianten erhalten und Fehler nachvollziehbar protokollieren.

Ein einmaliger Import und eine dauerhafte Integration haben deshalb unterschiedlichen Umfang. Ein einmaliger Lauf lädt den aktuellen Katalog. Eine geplante Integration kann die Quelle regelmäßig prüfen, neue Produkte hinzufügen und bestehende Daten aktualisieren.

Bei Eka Sunucu wird die Umsetzung an die vorhandene Software angepasst. Bei offenen oder veränderbaren Codebasen kann eine eigene Importschicht entwickelt werden. Bei geschlossenen SaaS-Systemen prüfen wir offizielle APIs, Apps und Importfunktionen.

• Einmaliger XML-Produktimport
• Geplante Bestands- und Preissynchronisierung
• Automatische Erkennung neuer Produkte
• Zuordnung über SKU, Barcode oder Lieferanten-ID
• Kategorie-, Marken-, Merkmal- und Varianten-Mapping
• Remote-Bilder oder lokaler Bilddownload
• Marge, MwSt., Währung und Rundungsregeln
• Fehlerlogs, Fehlprodukt-Berichte und Wiederholungslogik

Wie sieht ein Beispiel für einen XML-Produktbaum aus?

Jeder Lieferant kann ein anderes XML-Schema verwenden. Das folgende Beispiel zeigt nur eine mögliche Katalogstruktur. Die Feldnamen Ihrer echten XML können völlig anders sein; entscheidend ist, welcher Knoten welche Produktinformation enthält.

Im Beispiel gibt es zwei EKA-Produkte. products ist der Wurzelknoten, jeder Datensatz liegt in einem product-Knoten und die Produktdaten befinden sich in Unterknoten. Bei der Integration wird zuerst der wiederkehrende Produktknoten erkannt und anschließend jedes Feld zugeordnet.

<products>
    <product>
        <name>EKA Pro Oyuncu Bilgisayarı</name>
        <category>Bilgisayarlar > Masaüstü Bilgisayarlar</category>
        <productCode>EKA-PC-001</productCode>
        <barcode>8690000000001</barcode>
        <brand>EKA Teknoloji</brand>
        <quantity>25</quantity>
        <price>34999.90</price>
        <tax>20</tax>
        <description>EKA Pro serisi yüksek performanslı oyuncu bilgisayarı.</description>
        <images>
            <image>https://ornek.com/eka-pc-001-1.webp</image>
            <image>https://ornek.com/eka-pc-001-2.webp</image>
        </images>
        <variants>
            <variant>
                <option name="RAM">32 GB</option>
                <sku>EKA-PC-001-32</sku>
                <stock>12</stock>
            </variant>
        </variants>
    </product>
    <product>
        <name>EKA Mekanik Oyuncu Klavyesi</name>
        <category>Bilgisayar Aksesuarları > Klavye</category>
        <productCode>EKA-KLV-002</productCode>
        <barcode>8690000000002</barcode>
        <brand>EKA Teknoloji</brand>
        <quantity>80</quantity>
        <price>2499.90</price>
        <tax>20</tax>
        <description>RGB aydınlatmalı EKA mekanik oyuncu klavyesi.</description>
        <image1>https://ornek.com/eka-klv-002-1.webp</image1>
        <image2>https://ornek.com/eka-klv-002-2.webp</image2>
    </product>
</products>

Was bedeutet XML-Feldzuordnung? Sind name, title und urun_adi dasselbe?

Es gibt keine allgemeine Regel, dass ein Produktname zwingend in einem Feld namens name stehen muss. Ein Lieferant verwendet name, ein anderer title, urun_adi, ProductName oder model_name. Gleiches gilt für Bestand, Preis, Barcode und Kategorie.

Bei der Integration wird eine eindeutige Zuordnung zwischen Quell- und Zielfeldern erstellt. salePrice kann zum Verkaufspreis, stock zum Bestand und sku zum internen Produktcode werden.

Zuordnungen können bei einem stabilen einzelnen Feed fest im Code stehen oder bei mehreren Lieferanten über eine Administrationsoberfläche verwaltet werden.

<urun>
    <urun_adi>EKA Kablosuz Mouse</urun_adi>
    <stok_kodu>EKA-MOU-003</stok_kodu>
    <stok>150</stok>
    <satis_fiyati>899.90</satis_fiyati>
</urun>

<item>
    <title>EKA 27 İnç Gaming Monitör</title>
    <sku>EKA-MON-004</sku>
    <stock>32</stock>
    <salePrice>7499.90</salePrice>
</item>

Wie wird ein XML-Katalog Schritt für Schritt in einen Shop importiert?

Ein sicherer Import beginnt nicht damit, zehntausende Datensätze ungeprüft in die Produktionsdatenbank zu schreiben. Zuerst werden Quelle, Beispielprodukte und Pflichtfelder geprüft. Danach analysieren wir Produkt-, Kategorie-, Marken- und Variantenmodell des Zielshops.

Anschließend folgt ein Pilotimport. Mit wenigen Produkten werden Produkterstellung, Bilder, Kategorien, Preisberechnung, Bestandsupdate und Dublettenvermeidung getestet.

Vor dem Produktivbetrieb wird für jedes Feld definiert, was aktualisiert werden darf. Wenn Shop-Mitarbeiter Beschreibungen manuell pflegen, kann die Integration beispielsweise nur Bestand und Preis aktualisieren.

• XML-Zugriff und Format prüfen
• Wiederkehrenden Produktknoten und eindeutigen Schlüssel bestimmen
• Quellfelder auf Zielfelder abbilden
• Kategorie- und Marken-Mapping festlegen
• Varianten und Kombinationen analysieren
• Pilotimport durchführen
• Dubletten, Preise, Bestand, Bilder und Encoding testen
• Große Kataloge in Batches/Queues verarbeiten
• Cron-Intervalle und Logging konfigurieren
• Erste Produktivsynchronisierungen kontrollieren

Wie werden doppelte Produkte verhindert?

Eine der wichtigsten Entscheidungen ist der eindeutige Produktschlüssel. Produktnamen sind unzuverlässig, weil Titel geändert werden können oder mehrere Produkte gleich heißen. Bevorzugt wird eine stabile Lieferanten-ID, SKU oder ein Barcode.

Bei jeder Synchronisierung wird der Zielshop anhand dieses Schlüssels durchsucht. Fehlt der Datensatz, wird ein Produkt angelegt. Existiert er, werden nur die erlaubten Felder aktualisiert. So entstehen bei jedem Cron-Lauf keine neuen Dubletten.

Wenn Lieferantencodes geändert werden können, kann eine separate Mapping-Tabelle notwendig sein. Mehrere Lieferanten, Varianten-SKUs und Produkte ohne Barcode benötigen individuelle Regeln.

Wie lassen sich XML-Bestand und Preise automatisch aktualisieren?

Nach dem Erstimport ist die Bestands- und Preissynchronisierung meist der häufigste Prozess. Ändert sich der Lieferantenfeed, wird die Quelle erneut gelesen, das Produkt anhand seines Schlüssels gefunden und die freigegebenen Felder werden aktualisiert.

Es gibt kein allgemeingültiges Intervall. Schnell wechselnde Bestände können häufige Prüfungen erfordern, während ein sehr großer, selten geänderter Feed nicht alle paar Minuten vollständig gelesen werden sollte.

Bestandspuffer sind möglich. Beispielsweise kann ein Lieferantenbestand unter drei im Shop als null angezeigt werden. Ebenso lassen sich maximale sichtbare Mengen oder ausgewählte Lagerbestände zusammenfassen.

Preise müssen nicht unverändert übernommen werden. Marge, feste Zuschläge, MwSt., Währungsumrechnung und Rundung können kombiniert werden.

Können Marge, MwSt., Währung und Rundung auf XML-Preise angewendet werden?

Ja. Der Quellpreis kann als Rohwert behandelt und über mehrere Regeln in den Verkaufspreis umgerechnet werden. Zum Beispiel können 25 Prozent Marge, MwSt. und anschließend eine psychologische Rundung angewendet werden.

Wenn eine Marge nicht für alle Produkte passt, können Preisstufen verwendet werden. Niedrigere Preise erhalten etwa einen höheren Prozentsatz, teure Produkte einen niedrigeren. Regeln können auch nach Marke, Kategorie oder Lieferant variieren.

Bei Fremdwährungsfeeds werden Kursquelle und Aktualisierungsintervall festgelegt. Wenn der Lieferant bereits einen zuverlässigen TRY-Preis liefert, kann dieser verwendet werden; andernfalls lassen sich USD/EUR umrechnen.

• Prozentuale Marge
• Fester Zuschlag oder Abzug
• Regeln nach Kategorie / Marke / Lieferant
• Gestaffelte Margen nach Preisbereich
• Berechnung mit oder ohne MwSt.
• USD / EUR → TRY
• Mindestverkaufspreis
• Psychologische Rundung wie 899,37 → 899,90
• Listenpreis und Aktionspreis
• Separate Behandlung von Lieferanten-Aktionspreisen

Wie werden Kategorien, Marken, Merkmale und Varianten zugeordnet?

Produktname und Preis sind meist einfach; Kategoriebaum und Varianten verursachen die eigentliche Komplexität. Eine Lieferantenkategorie kann im Shop völlig anders benannt oder einsortiert sein.

Eine Mapping-Tabelle verbindet Quellkategorie und Zielkategorie. Automatische Kategorieerstellung ist möglich, kann aber ohne Kontrolle viele unerwünschte oder doppelte Kategorien erzeugen.

Varianten wie Farbe, Größe, Schuhgröße oder Kapazität können als Kombinationen unter einem Hauptprodukt vorliegen. Wenn jede Variante eigene SKU, Barcode, Preis und Bestand besitzt, müssen diese Daten in das Variantenmodell der Zielplattform überführt werden.

Wie werden Produktbilder aus XML verarbeitet?

Die meisten XML-Feeds enthalten Bild-URLs und nicht die Bilddatei selbst. Die Integration kann Remote-URLs verwenden oder Dateien in die Medienbibliothek des Zielsystems herunterladen.

Bei lokalem Download sollten Inhaltstyp, Dateigröße, Timeout und Fehler protokolliert werden. URL- oder Content-Hashes verhindern, dass dasselbe Bild bei jeder Synchronisierung erneut geladen wird.

Die Bildreihenfolge kann beibehalten werden: das erste Bild wird Hauptbild, weitere Bilder werden Galerie. Auch wiederholte image-Knoten oder lieferantenspezifische Formate können verarbeitet werden.

Wie werden XML-Feeds mit 10.000, 50.000 oder 100.000 Produkten verarbeitet?

Sehr große XML-Dateien komplett in den Arbeitsspeicher zu laden kann viel RAM verbrauchen. SimpleXML ist für kleine und mittlere Feeds bequem; bei großen Katalogen eignet sich ein Streaming-Reader wie XMLReader häufig besser, weil Produktknoten nacheinander verarbeitet werden.

Große Importe sollten nicht von einer einzelnen Browser-Anfrage abhängen. Batch-, CLI-, Cron- oder Queue-Verarbeitung kann eine begrenzte Anzahl Produkte pro Lauf verarbeiten und den Fortschritt speichern.

Die Leistung hängt nicht nur von der XML-Größe ab. Datenbankabfragen, Kategorien, Bilddownloads, Varianten und Remote-Aufrufe bestimmen die Gesamtdauer. Indizes, Mapping-Caches und kontrollierte Parallelität machen einen großen Unterschied.

Ziel ist nicht ein unbegrenztes memory_limit, sondern vorhersehbarer Ressourcenverbrauch. Shared Hosting benötigt oft kleine Cron-Batches, während VPS CLI-Worker und Queues ermöglichen.

Wie funktioniert automatische XML-Synchronisierung mit Cron Job?

Cron kann den Integrationsbefehl nach einem Zeitplan ausführen. Bestand kann beispielsweise alle 15 Minuten, Preise stündlich und ein vollständiger Katalog nachts geprüft werden.

Nicht jede Arbeit muss in derselben Aufgabe laufen. Leichte Bestands- und Preisprüfungen können häufig, Bilder und Beschreibungen seltener verarbeitet werden.

Ein Lock ist wichtig. Startet ein neuer Lauf bevor der vorige beendet ist, können Produkte parallel verändert werden. Job-Status oder Queue verhindern Überschneidungen; Logs sollten Start, Dauer, Produktanzahl und Fehler erfassen.

Können mehrere Lieferanten-XML-Feeds an einen Shop angebunden werden?

Ja. Mehrere XML-Quellen können denselben Shop speisen. Wenn dieselbe SKU oder derselbe Barcode in mehreren Feeds vorkommt, muss eine Geschäftsregel bestimmen, welche Quelle Vorrang hat.

Mögliche Strategien sind Lieferantenpriorität, niedrigster Einkaufspreis oder aktuell verfügbare Ware. Bestände mehrerer Lieferanten können auch zusammengeführt werden, wenn die Bestellweiterleitung dazu passt.

Da jeder Lieferant andere Feldnamen nutzen kann, ist ein eigenes Mapping-Profil je Quelle meist die sauberste Lösung.

Welche E-Commerce-Systeme können eine individuelle XML-Produktintegration erhalten?

Die Machbarkeit hängt stärker vom technischen Zugriff als vom Markennamen ab. Individuelle PHP- oder Laravel-Projekte mit Quellcode- und Datenbankzugriff können analysiert und mit einer eigenen Integrationsschicht erweitert werden. WooCommerce, OpenCart und PrestaShop lassen sich entsprechend ihrem Produkt- und Variantenmodell anbinden.

Geschlossene SaaS-Plattformen geben keinen Quellcode frei. Dort bestimmen offizielle API-, App-, Webhook- und Importfunktionen, welche Automatisierung möglich ist.

Deshalb versprechen wir nicht ungeprüft, jedes System anbinden zu können. Sie müssen Ihre Software jedoch nicht bei uns gekauft haben; bei ausreichendem Quellcode- oder API-Zugriff prüfen wir die passende Lösung.

Warum unterscheidet sich die Umsetzung bei WooCommerce, OpenCart, PrestaShop und individuellem PHP?

WooCommerce verwaltet Produkte über WordPress-Posts, Taxonomien, Metadaten und Untervarianten. OpenCart verwendet eigene Tabellen für Produkte, Kategorien, Optionen, Sprachen und Shops. PrestaShop besitzt ein anderes Kombinationen- und Merkmalsmodell. Ein individuelles PHP-Projekt kann völlig anders aufgebaut sein.

Dasselbe XML an vier Systeme anzubinden bedeutet daher vier unterschiedliche Datenmodelle zu bedienen. Wo möglich, nutzen wir die Service-/Modellschicht der Plattform; direkte Datenbankzugriffe werden nur nach Prüfung von Datenintegrität und Seiteneffekten eingesetzt.

Eka Sunucu bietet unabhängige Entwicklungs- und Supportleistungen und ist kein offizielles Supportteam oder autorisierter Vertreter von WooCommerce, OpenCart oder PrestaShop.

Kann XML als URL, geschützter Feed, gzip-Datei oder mit anderem Encoding vorliegen?

Lieferantenfeeds können öffentlich per HTTPS oder mit Basic Auth, Token, Query-Parametern oder IP-Freigaben geschützt sein. Authentifizierung kann integriert werden; Zugangsdaten sollten sicher konfiguriert und nicht offen im Code gespeichert werden.

Große Kataloge können gzip-komprimiert geliefert werden. Andere Feeds nutzen Nicht-UTF-8-Encoding, CDATA-Beschreibungen oder XML-Namespaces. Diese Unterschiede werden im Parser berücksichtigt.

Bei Remote-Abrufen sind Timeouts, HTTP-Status, TLS-Prüfung und sinnvolle Größenlimits wichtig. Ist die Quelle vorübergehend nicht erreichbar, sollte ein Netzwerkfehler nicht automatisch als Bestand null interpretiert werden.

Häufige Probleme beim XML-Produktimport und Lösungsansätze

Echte Kataloge enthalten oft Datenprobleme: fehlende SKU, doppelte Barcodes, unbekannte Kategorien, Komma-Preise, HTML-Beschreibungen, nicht erreichbare Bilder oder unerwartete Varianten.

Eine robuste Integration verschluckt Fehler nicht. Sie protokolliert, welches Produkt warum übersprungen wurde, verarbeitet nach Möglichkeit weitere Produkte und unterscheidet wiederholbare Netzwerkfehler von dauerhaften Datenfehlern.

Lieferanten können die XML-Struktur ohne Vorankündigung ändern. Wenn price plötzlich sale_price heißt, sollte das System nicht stillschweigend 0 schreiben. Pflichtfeldprüfungen und Warnungen reduzieren dieses Risiko.

Was ist der Unterschied zwischen XML-Import, XML-Export, CSV, Excel, JSON und API?

XML-Import bringt externe Daten in den Shop. XML-Export erstellt aus Shopdaten einen Feed für ein anderes System. Beide Richtungen können in einem Projekt vorkommen.

Liefert der Anbieter XML, das Ziel akzeptiert aber nur CSV, kann eine XML→CSV-Konvertierung entwickelt werden. Auch XML→JSON, API→XML oder individuelle Exportfeeds sind möglich.

APIs eignen sich häufig besser für transaktionale Echtzeitkommunikation, während XML-Feeds bei Katalogen weiterhin verbreitet sind. Wenn eine API verfügbar ist, sollte die nachhaltigste Methode gewählt werden.

Wie werden Sicherheit und Datenintegrität bei XML-Integrationen geschützt?

Externes XML wird als nicht vertrauenswürdige Eingabe behandelt. Parser-Verhalten, Entity-Auflösung, Dateigröße und Netzwerkzugriffe werden begrenzt; Datenbankzugriffe sollten validiert und parametrisiert erfolgen.

Remote-Bild-URLs sollten auf erwartete Protokolle beschränkt und bei Bedarf gegen SSRF abgesichert werden. Können Administratoren Feed-URLs konfigurieren, sind Berechtigungen und CSRF-Schutz relevant.

Vor Livebetrieb sollten Datenbank und kritische Dateien gesichert, wenn möglich Staging-Tests durchgeführt und ein Rollback-Pfad vorhanden sein. Vorschauen auf große Änderungen reduzieren das Risiko fehlerhafter Mappings.

Wie wird ein Angebot für XML-Integration kalkuliert?

Ein fester Einheitspreis ist für XML-Projekte nicht realistisch. 500 einfache Produkte einmalig zu importieren ist etwas anderes als 75.000 variable Produkte aus mehreren Lieferanten alle paar Minuten zu synchronisieren.

Der Umfang hängt von Produktzahl, XML-Komplexität, Variantenmodell, Kategorie-Mapping, Bildverarbeitung, Preisformeln, Update-Häufigkeit, Codequalität, API-Limits, Anzahl Lieferanten und gewünschtem Administrationsbereich ab.

Für eine schnelle Vorprüfung senden Sie XML-URL oder Beispieldatei, Shop-URL und gewünschte Regeln per WhatsApp. Sensible Serverzugänge sind für die erste Umfangsprüfung nicht zwingend erforderlich.

Ablauf einer XML-Integration bei Eka Sunucu

Zuerst prüfen wir Feed, Zielplattform und gewünschte Felder. Umfang und technische Grenzen werden anschließend festgehalten.

Die Entwicklung erfolgt wenn möglich in Test- oder Staging-Umgebung. Mapping, Kategorien, Varianten, Preis- und Bestandsregeln werden mit Beispielprodukten geprüft, bevor der vollständige Import läuft.

Bei Übergabe werden Zeitpläne, Update-Regeln und Administrationsoptionen dokumentiert. Ändert der Lieferant später die XML-Struktur, kann Wartung nötig sein; sichtbare Logs und Fehlermeldungen erleichtern die Diagnose.

• 1. XML- und Shop-Prüfung
• 2. Feld-/Kategorie-/Varianten-Mapping
• 3. Preis- und Bestandsregeln
• 4. Pilotimport
• 5. Fehler- und Dublettentests
• 6. Vollständiger Katalogimport
• 7. Cron-/Queue-Automatisierung
• 8. Live-Prüfung und Übergabe