Lieferantenspalten den WooCommerce-Produktfeldern zuordnen

So ordnest du Lieferantenspalten den WooCommerce-Produktfeldern zu

Mithilfe der Zuordnung von Lieferantenspalten zu WooCommerce-Produktfeldern legst du fest, welche Information aus der Preisliste zu Name, SKU, Preis, Kategorie, Bild oder Attribut im Katalog wird. Die Datei des Großhändlers verwendet eigene Bezeichnungen: Artikelnummer, Verkaufsbeschreibung, Produktfamilie, EAN. WooCommerce erwartet andere Spaltennamen und unterscheidet verschiedene Produkttypen. Ohne Zuordnungstabelle erzeugt der Import unvollständige Produktseiten, Duplikate und Feeds, die von den Kanälen abgelehnt werden.

Ein Crawler liest den sichtbaren Titel, den Beschreibungstext, die Bilder und die strukturierten Daten, die WooCommerce bereits auf der Seite ausgibt. Wenn die Beschreibungsspalte des Lieferanten im Namensfeld landet, wird der Titel zu einem Absatz. Fehlt die SKU, hat die nächste Synchronisierung keinen Schlüssel. Steht die EAN in einer freien Notiz, gelangt die GTIN nicht in die Feeds. Der Mechanismus ist sichtbar: leere oder falsch zugeordnete Felder, kein mysteriöser Algorithmus.

Warum die Lieferantendatei nie direkt für WooCommerce geeignet ist

Die Preisliste des Lieferanten ist ein Werkzeug für den Großhandel, kein Katalogschema: Spaltennamen, Dezimaltrennzeichen und Warengruppen stimmen nicht mit den nativen WooCommerce-Feldern überein.

Der Großhändler optimiert das Tabellenblatt für Besteller: interne Artikelnummer, verkürzte Beschreibung, Staffelpreis, Stückzahl pro Karton. WooCommerce optimiert die Produktseite für Käufer und Suchsysteme: verständlicher Name, stabile SKU, Preis mit einem einheitlichen Dezimaltrennzeichen, Shopkategorien, sichtbare Filterattribute und Bilder mit öffentlich erreichbaren URLs. Beide Objekte enthalten dieselben Fakten, Artikel, Preis und Barcode, aber nicht dieselbe Form.

Ein illustratives Beispiel: Ein Shop mit vierzig Artikeln erhält eine CSV-Datei mit den Spalten COD, DESCR, PZ, FAM und BARCODE. Die Zelle in DESCR enthält „VASO SMALTO BLU D20 H18 PZ/CT 6“. Dieser Text ist weder ein Titel noch eine Beschreibung noch eine Gruppe von Attributen. Er enthält drei zusammengefasste Felder. Solange du ihn nicht aufteilst, veröffentlicht der Import eine Produktseite, die ein Assistent nur schwer zitieren kann und die Google Shopping als unübersichtlichen Titel liest.

Seitentext und strukturierte Daten arbeiten zusammen: Das Markup bestätigt Preis und Verfügbarkeit, wenn beides mit der Seite übereinstimmt.

Pflichtfelder und optionale Felder eines WooCommerce-Produkts

Für eine Produktseite genügt ein Name; zum Verkaufen brauchst du einen Preis und bei aktivierter Bestandsverwaltung eine Menge; gegen Duplikate hilft die SKU. Die übrigen Felder entscheiden darüber, wie vollständig die Seite für Shop und Feed ist.

WooCommerce erkennt in der nativen CSV-Datei feste englische Bezeichnungen. Du kannst die Lieferantennamen nicht einfach in der Kopfzeile stehen lassen und hoffen, dass das Import-Plugin sie „versteht“. Benenne die Spalten entweder um oder nutze die Zuordnungsansicht unter Produkte, Importieren. Diese Felder brauchst du fast immer:

• Name: Titel der Produktseite, sichtbar auf der Seite und in Ergebnissen.
• SKU: eindeutiger Schlüssel des Shops; ohne SKU kann jeder erneute Import ein Duplikat erzeugen.
• Type: simple, variable, variation, grouped oder external.
• Regular price: Listenpreis im Shopformat, meist mit Dezimalpunkt.
• Description und Short description: langer Seitentext und Zusammenfassung in Listen.
• Categories und Tags: bereits vorhandene oder vor dem Import anzulegende Strukturen.
• Images: öffentliche URLs, eine oder mehrere, getrennt nach den Vorgaben der CSV-Datei.
• Attribute n name / Attribute n value(s): globale oder lokale Attribute wie Farbe, Größe und Material.
• Parent: SKU des übergeordneten Produkts, nur in Zeilen vom Typ variation.
• Stock und In stock?: Bestand und Verfügbarkeitskennzeichen, wenn die Bestandsverwaltung aktiviert ist.

Gewicht, Längen, Versandklasse, Steuerklasse und globale Produktkennung (GTIN, sofern sie in den Unterlagen des Lieferanten vorhanden ist) sind für die Veröffentlichung optional. Ihr Fehlen fällt in Feeds und auf der Produktseite jedoch sofort auf. Laut Google Search Central gibt es zwei wichtige Klassen strukturierter Produktdaten: Das Markup, das WooCommerce bereits erzeugt, bestätigt Fakten nur dann, wenn sie mit Titel, Preis und Verfügbarkeit im Seitentext übereinstimmen.

Wer Preislisten mehrerer Lieferanten in denselben Shop importiert

Wer Preislisten mehrerer Lieferanten in denselben Shop importiert, sollte die SKU als Namensraum behandeln. Zwei Großhändler können denselben Code „1001“ verwenden. Setze ein Präfix vor die SKU (FORN1-1001) oder führe eine Lieferantenspalte als verborgenes Attribut, niemals als Teil des Titels. Die GTIN bleibt, sofern vorhanden und gültig, die Identität des physischen Artikels; die SKU bleibt die Identität der Zeile in deinem Warenwirtschaftssystem.

Lieferantenspalten einzeln lesen und zuordnen

Öffne die CSV-Datei des Lieferanten, liste jede Überschrift auf und notiere daneben das WooCommerce-Zielfeld sowie eine Regel für Werte, die aufgeteilt oder verworfen werden müssen.

Beginne nicht mit dem Import. Erstelle zuerst eine Zuordnungstabelle mit drei eigenen Spalten: ursprüngliche Überschrift, WooCommerce-Feld und Bereinigungsregel. Die Regel verhindert, dass dieselbe Spalte in zwei oder in keinem Feld landet.

1. Öffne die Datei in einem Tabellenprogramm mit UTF-8-Kodierung. Wenn Excel die Datei mit Semikolon angelegt hat, ändere den Separator nicht zufällig, sondern prüfe ihn vor dem Speichern.
2. Fixiere die erste Zeile und gehe die Überschriften durch. Markiere CODICE, ART, ITEM und REF als mögliche SKU. DESCRIZIONE, NOME und ITEM NAME kommen als Titel infrage. EAN, GTIN, BARCODE und UPC sind mögliche globale Kennungen.
3. Öffne WooCommerce, Produkte, Importieren und vergleiche die nativen Bezeichnungen (Name, SKU, Regular price, Categories, Images, Attribute 1 name). Wenn die Namen nicht übereinstimmen, benenne die CSV-Kopfzeile um oder ordne die Felder im Dropdown der Importansicht manuell zu.
4. Notiere für jede mehrdeutige Spalte eine Regel. Beispiel: FAMIGLIA wird erst dann zu Categories, wenn du dieselben Kategorien im Shop angelegt hast; COLORE und TAGLIA gehören in globale Attribute unter Produkte, Attribute, nicht in den Titel.
5. Wähle den Type. Eine Zeile und ein verkaufbarer Artikel: simple. Dasselbe Modell mit mehreren Größen oder Farben: ein übergeordnetes variable-Produkt und variation-Zeilen mit derselben Parent-SKU.
6. Normalisiere Zahlen. Preise mit Dezimalkomma müssen in das vom Shop erwartete Format umgewandelt werden. Mengen bleiben ganzzahlig. Das Gewicht wird in der unter WooCommerce, Einstellungen, Produkte festgelegten Einheit angegeben.
7. Speichere eine Test-CSV mit zehn Zeilen, importiere sie als Entwurf, öffne eine Produktseite und prüfe Name, SKU, Preis, Bestand, Attribute und Bild, bevor du den gesamten Katalog bearbeitest.

Ein ausdrücklich illustratives Vorher-Nachher-Beispiel: Vorher steht in einer einzigen Zelle „MAGLIA COTONE UOMO BLU M 19,90 8001234567897“. Nach der Zuordnung stammt die SKU aus der Artikelnummer; der Name lautet „Baumwollshirt blau, Herren“; die Attribute sind Material Baumwolle, Farbe Blau und Größe M; Regular price ist 19.90; die GTIN wird nur übernommen, wenn der Barcode in den Unterlagen des Lieferanten steht und die Prüfziffer erfüllt. Der Hinweis auf den Karton gehört nicht in den Titel.

Wer wenig Zeit für die tägliche Routine hat

Wer wenig Zeit für die tägliche Routine hat, ordnet nicht jede neue Zeile manuell zu. Lege die Zuordnungstabelle als Vorlage fest und benenne bei jeder Preisliste nur die Kopfzeile um. Fügt der Lieferant eine Spalte hinzu, behandelst du sie als Ausnahme: Du ignorierst sie oder ordnest sie einem bereits vorhandenen Attribut zu. Der versteckte Aufwand liegt nicht im Import, sondern darin, jeden Montag dieselben Regeln neu festzulegen.

Häufige Fehler

Die Mapping-Fehler, die SEO und Feeds beeinträchtigen, sind immer ähnlich: ein unbereinigter Titel, die Kategorie des Großhändlers statt der Shopkategorie, eine erfundene oder falsch platzierte GTIN und Varianten, die als einfache Produkte importiert werden.

Titel entspricht der Lieferantenbeschreibung. Im Shop erscheint ein vollständig großgeschriebener Name mit Stückzahl pro Karton, internen Codes und angehängten Maßen. Das passiert, weil DESCR die einzige Textspalte ist und in Name landet. Extrahiere einen kurzen Titel aus Produkt, Material und besonderem Merkmal und verschiebe den Rest in Description oder Attribute. Die Groß- und Kleinschreibung wird erst danach vereinheitlicht, nicht anstelle der Bereinigung.

Lieferantenkategorie wird als Shopkategorie kopiert. Unter Produkte, Kategorien entstehen Dutzende doppelte Einträge („CERAMICA“, „Ceramica“, „ceramiche“) und die Theme-Filter gruppieren nichts. Ursache ist, dass FAMIGLIA nicht deiner eigenen Taxonomie entspricht. Lege zuerst den Kategoriebaum in WooCommerce an und ordne ihn mithilfe einer Entsprechungstabelle zu (FAMIGLIA „CER-VAS“ → Kategorie „Vasen“). Die Google-Produkttaxonomie ist ein eigenes Feld: Sie ist nicht der Shop-Slug und darf nicht ohne Bestätigung in der CSV improvisiert werden.

GTIN am falschen Ort oder erfunden. Der Feed meldet fehlende, doppelte oder ungültige Kennungen; auf der Produktseite steht der Code in den Notizen. Das geschieht, wenn BARCODE in Description landet oder jemand eine EAN von einer Drittanbieter-Website kopiert. Übernimm den Code nur aus den Unterlagen des Lieferanten (Spalte, Verpackungsfoto oder PDF) und lasse das Feld leer, wenn er fehlt. Eine GTIN wird nicht im Internet gesucht und nicht erzeugt.

Varianten werden als einfache Produkte importiert. Es entstehen drei Seiten für „dasselbe Shirt, drei Größen“, drei URLs und Preise, die beim ersten Update auseinanderlaufen. Ursache ist eine Lieferantenzeile pro untergeordneter SKU, während der Import für alle Zeilen Type simple verwendet. Die Lösung: eine Parent-Zeile mit Type variable und den Variationsattributen; untergeordnete Zeilen mit Type variation, Parent gleich der SKU des übergeordneten Produkts und genau einem Attributwert pro Zeile. Laut dem WooCommerce Developer Blog werden Variationsgalerien ab WooCommerce 11.1 für jeden Shop aktiviert sein. Daher lohnt es sich, auch Bilder pro Variante und nicht nur das Bild des übergeordneten Produkts zuzuordnen.

Ein Kunsthandwerker mit Keramik und etwa vierzig Artikeln

Ein Kunsthandwerker, der Keramik verkauft und etwa vierzig Artikel verwaltet, erhält vom Atelier häufig ein Blatt, in dem Glasur, Durchmesser und Stückzahl pro Kiste in derselben Zelle stehen. Hier ist die Zuordnung kurz und muss nur einmal erfolgen: eigene SKU, Name mit Form und Farbe, Attribute Durchmesser und Glasur sowie Gewicht für den Versand. Ein variables Produkt ist nicht nötig, wenn jede Vase ein Einzelstück ist: Type simple, unterschiedliche Bilder und kein Parent.

CSV-Import von der Lieferantenliste in den veröffentlichten Katalog

Der native WooCommerce-CSV-Import veröffentlicht nur, was du zuvor zugeordnet hast: Lade eine Testdatei hoch, ordne die Spalten zu, prüfe eine Produktseite als Entwurf und importiere erst danach den gesamten Katalog.

Der Weg im WordPress-Backend lautet Produkte, Importieren. WooCommerce fordert die Datei an und zeigt anschließend jede CSV-Überschrift neben einem Menü bekannter Felder. Wenn du die Spalten in die nativen Namen (Name, SKU, Regular price) umbenannt hast, erfolgt die Zuordnung fast automatisch. Bei COD und DESCR musst du sie manuell auswählen. Die Option zur Aktualisierung bestehender Produkte verwendet die SKU als Schlüssel: Ohne SKU erzeugt die Aktualisierung neue Zeilen.

1. Exportiere zuerst die CSV-Datei eines bereits veröffentlichten Produkts unter Produkte, Exportieren, und nutze sie als Vorlage für die Spalten. Sie enthält das Vokabular, das der Import eindeutig versteht.
2. Kopiere die Werte des Lieferanten unter diese Überschriften, nicht umgekehrt. Die ursprüngliche Preisliste bleibt ein Archiv; die Importdatei ist eine bereinigte Ableitung.
3. Setze Published beim ersten Durchlauf auf -1 (Entwurf). So landen keine Produktseiten mit schmutzigen Titeln im Shop.
4. Lade die Datei hoch, kontrolliere die Zuordnung Spalte für Spalte, starte den Import und öffne drei Beispielseiten: eine einfache, eine Variante und eine ohne Bild.
5. Korrigiere die Tabelle statt der einzelnen Produktseiten und importiere erneut mit Aktualisierung nach SKU. Wenn Name, Preis, Bestand und Attribute übereinstimmen, setze Published auf 1.

Wenn der Lieferant keine CSV-, sondern eine gesetzte Preisliste liefert, findet die Extraktion vor dem Mapping statt. Dann geht es zunächst vom PDF zu den Produktdaten, erst danach werden die Spalten an die WooCommerce-Felder angepasst. Dasselbe gilt für ein Etikettenfoto: Zuerst werden die sichtbaren Fakten erfasst, anschließend SKU, Name und Attribute zugeordnet.

Mapping großer Kataloge beschleunigen, ohne alles manuell zu bearbeiten

Bei großen Katalogen wird das Mapping schneller, wenn Zuordnungsregeln, globale Attribute und Kategorien vor dem Import festgelegt werden. Danach aktualisierst du nur die Spalten, die der Lieferant tatsächlich geändert hat.

Die Versuchung ist groß, tausende Zeilen zu öffnen und Titel von Hand zu bereinigen. Das skaliert nicht. Bereite den Shop vor: Unter Produkte, Attribute legst du Farbe, Größe, Material und Marke als globale Attribute an und hinterlegst die bereits im Shop verwendeten Werte. Unter Produkte, Kategorien definierst du den Kategoriebaum. In der Zuordnungstabelle legst du die Entsprechungen des Lieferanten zu diesen Listen fest. Der Import schreibt bekannte Werte; neue Werte fallen auf, weil sie nicht mit der Liste übereinstimmen.

• Aktualisiere bei einer erneuerten Preisliste per SKU nur Preis, Bestand und Verfügbarkeit.
• Halte Name und Description aus der automatischen Erneuerung heraus, wenn du sie bereits in gut lesbarem Deutsch überarbeitet hast.
• Trenne die Dateien: eine für neue SKUs, eine für Aktualisierungen und eine für Varianten.
• Mische einfache Produkte und Varianten nicht in derselben CSV, solange die Parent-Spalte nicht vollständig und konsistent ist.
• Entferne Spalten ohne Zielfeld aus der Importdatei, etwa Staffelrabatte, Mindestbestellmenge und interne Notizen des Großhändlers.

Eine GTIN wird ausschließlich aus den Unterlagen des Händlers, einem Verpackungsfoto, PDF oder einer CSV-Spalte gelesen und muss die Prüfziffer bestehen: Sie wird weder erfunden noch im Internet gesucht.

Wer dieselbe Preisliste auf mehrere Verkaufskanäle abstimmt

Wer dieselbe Preisliste auf mehrere Verkaufskanäle wie Amazon, eBay und Etsy abstimmt, muss eine führende Quelle für die Fakten festlegen. WooCommerce verwaltet SKU, Shop-Titel, Preis und Bestand. Marktplätze erhalten einen abgeleiteten Export, nicht die unverarbeitete CSV des Lieferanten. Wenn du den Amazon-Titel in das Name-Feld des Shops schreibst, verlierst du die für die Shopseite nützliche Formulierung. Besser ist ein Attribut oder eine Exportspalte je Kanal und ein einziger Name, der für die Website-Produktseite gedacht ist.

Für einen möglichen Feed an Einkaufsassistenten gelten weiterhin die neun Felder der OpenAI-Spezifikation (item_id, title, description, url, brand, seller_name, image_url, availability, price mit Währung). GTIN und MPN sind optional. Diese Felder werden nach dem WooCommerce-Mapping befüllt, nicht anstelle von Name und SKU. Die Bezeichnungen link und image_link gehören zu Merchant Center und nicht in diesen Feed.

Wie Katapic dabei hilft, die Preisliste den richtigen Feldern zuzuordnen

Katapic importiert CSV-Dateien, PDFs und Fotos, ergänzt nur leere Felder mit geprüften Fakten und spielt die Produktseiten über die bidirektionale Synchronisierung an WooCommerce zurück.

Wenn der Lieferant ein Tabellenblatt sendet, gelangt der CSV-Import in den Arbeitskatalog. Bei einer gesetzten Preisliste extrahiert die seitenweise Auswertung Texte und eingebettete Bilder und ordnet sie den Produkten zu. Ein Foto entspricht einer Produktseite: Aus dem Bild erkennt Katapic Produkt, Marke, Kategorie und Attribute, und alles bleibt vor der Veröffentlichung bearbeitbar. Das Ergänzen leerer Felder ist ein separater, ausdrücklich angeforderter Vorgang mit Quellenangabe.

Der kostenlose Scan eines öffentlichen WooCommerce-Katalogs funktioniert ohne Konto und ausschließlich lesend. Er zeigt pro Produktseite zwei Bewertungen (klassische Suche und Eignung für Assistenten) sowie eine Prüfung der Datenbereitschaft auf fehlende oder fehlerhafte Felder; Relevanz und Vollständigkeit kommen mit einem kostenlosen Konto hinzu. Für jede Shopkategorie wird eine Kategorie der Google-Taxonomie vorgeschlagen. Du bestätigst sie, und die bestätigte Kennung gelangt in die Feeds. Wahrscheinliche Varianten, etwa derselbe Titel mit Größe, Farbe oder Packung, werden als Varianten eines einzigen Produkts vorgeschlagen und erst nach Bestätigung gruppiert.

Die WooCommerce-Synchronisierung ist bidirektional und verwendet das kostenlose Plugin. Die Überarbeitung von Produktseiten durchläuft eine Prüfung von Aussagen: Marken, Zertifizierungen und Markengeschichte werden nicht erfunden. Wenn ein im Internet gefundenes Maß dem Titel des Händlers widerspricht, bleibt die Angabe des Händlers bestehen. Kostenlose Korrekturen wie Groß- und Kleinschreibung bei vollständig großgeschriebenen Titeln, HTML-Bereinigung, Zustand, die Kennzeichnung „ohne Hersteller-GTIN“, Variantengruppierung und Bestätigung der Google-Kategorie erfolgen nur nach ausdrücklicher Bestätigung und können rückgängig gemacht werden. Um den WooCommerce-Katalog zu bereinigen, wird mit den bereits vorhandenen Fakten gearbeitet und nicht mit einem Text, der an deiner Stelle erzeugt wurde.

Häufige Fragen zum CSV-Mapping in WooCommerce

Welche Felder sind beim CSV-Import für ein WooCommerce-Produkt erforderlich?

Für die Produktseite ist mindestens Name erforderlich. Zum Verkaufen brauchst du Regular price und bei aktivierter Bestandsverwaltung Stock mit In stock?. Die SKU ist im Erstellungsformular nicht vorgeschrieben, doch ohne SKU kann der Import nicht aktualisieren und erzeugt Duplikate. Type wird benötigt, sobald Varianten vorhanden sind. Kategorien, Bilder, Attribute und GTIN verhindern die Veröffentlichung nicht, aber eine Produktseite ohne diese Fakten bleibt für Shop und Feed unvollständig.

Wie werden die Spalten der Lieferantendatei den WooCommerce-Produktfeldern zugeordnet?

Erstelle eine Zuordnungstabelle: Jede Überschrift der Preisliste erhält ein Zielfeld (SKU, Name, Regular price, Categories, Images, Attribute) und eine Bereinigungsregel. Benenne anschließend die CSV-Kopfzeile in die nativen Namen um oder ordne die Felder unter Produkte, Importieren manuell zu. Teste den Import mit zehn Zeilen als Entwurf. Erst wenn Titel, Preis und Attribute übereinstimmen, importierst du den Rest und aktualisierst nach SKU.

Wo wird die EAN des Lieferanten im WooCommerce-Produkt eingetragen?

Die EAN gehört in die globale Produktkennung (GTIN), nicht in Titel oder Beschreibung. Übernimm sie nur, wenn sie in den Unterlagen des Lieferanten steht und die Prüfziffer erfüllt. Ist die Spalte leer, bleibt auch das Feld leer: Suche keinen Code im Internet und erfinde keinen. Eine EAN in den Notizen gelangt nicht in die Feeds und hilft der Produktseite nicht.

Wie importiert man eine WooCommerce-Produkt-CSV ohne doppelte SKUs?

Jede Zeile muss im Shop eine eindeutige SKU besitzen. Wähle beim Import die Aktualisierung bestehender Produkte; WooCommerce verwendet die SKU als Schlüssel. Setze ein Präfix vor SKUs, wenn zwei Lieferanten denselben Code verwenden. Importiere eine Datei ohne SKU nicht zweimal. Prüfe zunächst unter Produkte, Alle Produkte nach der SKU und starte erst danach die Aktualisierung von Preisen und Beständen.

Wie weist man WooCommerce-Produkten eine Google-Kategorie zu?

Die Shopkategorie unter Produkte, Kategorien ist nicht die Kategorie der Google-Taxonomie. Lege zuerst den internen Kategoriebaum fest und ordne die Lieferantenfamilie diesem Baum zu. Danach verknüpfst du separat die bestätigte Google-ID für die Feeds. Kopiere die FAMIGLIA-Bezeichnung des Großhändlers nicht direkt in das Google-Feld. Ohne Bestätigung bleibt eine für das Theme nützliche Shopkategorie bestehen, nicht jedoch eine Taxonomie-ID für die Kanäle.

Was passiert, wenn die Varianten des Lieferanten in getrennten Zeilen ankommen?

Wenn jede Größe oder Farbe in einer Zeile steht und als simple importiert wird, entstehen ähnliche Produktseiten und getrennte URLs. Die korrekte Zuordnung besteht aus einem variable-Parent mit den Variationsattributen sowie variation-Kindern mit Parent gleich der SKU des übergeordneten Produkts. Jede untergeordnete Zeile enthält nur einen Attributwert. Bilder für Varianten werden der untergeordneten Zeile und nicht nur dem Parent zugeordnet, damit die Galerie das passende Produkt zeigt.

Kann man eine PDF-Preisliste wie eine zuzuordnende CSV behandeln?

Ja, aber in zwei Schritten. Zuerst werden Fakten wie Code, Name, Preis und gegebenenfalls eingebettete Bilder aus Seiten und Tabellen extrahiert und in einer Tabelle gesammelt. Anschließend folgt diese Tabelle denselben Mapping-Regeln wie eine CSV: SKU, Name, Preis, Kategorien und Attribute. Wer die Extraktion überspringt und eine hundertseitige PDF-Datei von Hand kopiert, erzeugt unübersichtliche Titel und leere Felder.