Doppelte Artikelnummern (SKU) und GTINs in WooCommerce finden

Zwei Produkte mit derselben Artikelnummer bringen den Lagerbestand, die Schnittstellen und jede Exportdatei Ihres Shops durcheinander. Zwei Produkte mit derselben GTIN sagen einem Preisvergleich wie Google Shopping, dass sie derselbe Artikel sind, sodass eines davon unbemerkt aus der Suche verschwindet. Ein Produkt ganz ohne Kennung fällt meist komplett aus dem Feed.

Nichts davon legt den Shop lahm, deshalb fällt es oft jahrelang niemandem auf. Nichts im Administrationsbereich von WooCommerce weist darauf hin.

Drei Prüfungen, sonst nichts

Prüfung	Was als Befund zählt	Funktions­weise und Prüfung von Hand
Zwei Produkte mit derselben Artikel­nummer	derselbe Code bei zwei verschiedenen Produkten	doppelte Artikel­nummer
Produkt ohne GTIN, UPC, EAN oder ISBN	das Feld für die Produkt­kennung ist leer	ohne GTIN
Zwei Produkte haben dieselbe Produkt­kennung	dieselbe GTIN bei zwei verschiedenen Produkten	doppelte GTIN

Drei Details entscheiden, ob so ein Bericht nützt oder nur lang ist:

• Übersetzungen sind keine Duplikate. Ein mehrsprachiger Shop gibt jeder Übersetzung eines Produkts absichtlich dieselbe Artikelnummer. Das Plugin liest die Übersetzungsgruppen von Polylang und WPML und behandelt eine Gruppe als ein Produkt. Ein zweisprachiger Shop bekommt also nicht für jeden Artikel einen Fehlalarm.
• Ein Shop ohne Kennungen bekommt einen Hinweis statt einer Liste. Ist das GTIN-Feld bei keinem einzigen Produkt ausgefüllt, meldet die Prüfung nichts und sagt, warum. Handgemachtes, Dienstleistungen und eigene Produktion haben keinen Hersteller-Barcode und brauchen keinen.
• Eine Prüfung, die nicht ausgeführt werden konnte, sagt das offen. Das Feld für die Produktkennung gibt es seit WooCommerce 9.2. In älteren Versionen sagt der Bericht, dass es das Feld nicht gibt. Er erklärt also weder jedes Produkt für fehlerhaft noch den Katalog für fehlerfrei.

So sieht das Ergebnis aus

Das Plugin fügt eine Ansicht unter Produkte → Duplicate SKU and GTIN Finder hinzu. Dorthin führt auch der Link Find duplicates in der Zeile des Plugins unter Plugins → Installierte Plugins. Die Oberfläche des Plugins ist vorerst auf Englisch. Jeder Befund zeigt das geprüfte Feld und den gefundenen Wert, also duplicated SKU: SB-60 statt „Problem gefunden“, mit einem Link direkt zum Produkt in Ihrem Administrationsbereich. So können Sie jede Aussage prüfen, bevor Sie etwas ändern.

Mit Download CSV bekommen Sie dieselbe Liste als Datei, mit Nachweisen und Links zum Bearbeiten. So können Sie sie an die Person weitergeben, die den Katalog pflegt. Die Zellen sind so geschützt, dass ein Tabellenprogramm keine eingeschleusten Formeln ausführt.

Was das Plugin nicht tut

• Es schreibt nie in Ihren Katalog. Es gibt keine Schaltfläche „Beheben“, und es wird keine geben: Hier steht, warum (Seite auf Englisch). Gespeichert werden das letzte Ergebnis, damit beim Neuladen der Seite keine neue Überprüfung nötig ist, und Vermerke in Ihrem Benutzerprofil, damit ein erledigter Hinweis nicht wieder erscheint. Beim Deinstallieren wird beides gelöscht.
• Es liest keine Bestelldaten. Deshalb geht die Überprüfung schnell: In einem Testkatalog mit 10.000 Produkten und Varianten dauerte sie etwa 2,5 Sekunden.
• Keine Werbung für ein Upgrade. Keine kostenpflichtige Version und kein Banner im Administrationsbereich. Nach der Aktivierung zeigt ein einziger Hinweis unter Plugins, wo Sie das Plugin finden. Er verschwindet endgültig, sobald Sie ihn schließen oder die Ansicht des Plugins öffnen.

Große Kataloge

Die Ansicht führt die Überprüfung in einer einzigen Anfrage aus. In einem sehr großen Shop kann das an das Zeitlimit Ihres Hosters stoßen: In einem Testkatalog mit 50.000 Artikeln dauerte die Überprüfung 22 Sekunden. Bei mehr als 5.000 Produkten und Varianten weist die Ansicht vorher darauf hin. Der WP-CLI-Befehl hat diese Grenze nicht:

wp merchlint-duplicate-sku-finder scan
wp merchlint-duplicate-sku-finder scan --format=csv

Er zeigt, wie viele Befunde jede Prüfung ergeben hat, und speichert das Ergebnis. Die vollständige Liste mit Nachweisen steht danach in der Ansicht bereit.

Voraussetzungen

WordPress	6.5 oder neuer
WooCommerce	9.0 oder neuer; die beiden GTIN-Prüfungen brauchen 9.2, weil es das Feld erst seit dieser Version gibt
PHP	7.4 oder neuer
Mehrsprachig	erkennt die Übersetzungsgruppen von Polylang und WPML
Lizenz	GPL-2.0-or-later, kostenlos

Fragen

Wie finde ich doppelte Artikelnummern in WooCommerce?

Installieren Sie das Plugin, öffnen Sie Produkte → Duplicate SKU and GTIN Finder und klicken Sie auf Scan now. Jedes Produkt, das seine Artikelnummer mit einem anderen teilt, steht in der Liste, mit der gelesenen Artikelnummer und einem Link zum Bearbeiten. Download CSV gibt Ihnen dieselbe Liste als Datei. Das Plugin vergleicht veröffentlichte Produkte und ihre Varianten. Übersetzungen eines Produkts zählen nicht als Duplikate.

WooCommerce selbst lehnt eine doppelte Artikelnummer beim Speichern ab. Es hat aber keine Ansicht, die die Paare auflistet, die schon in Ihrem Katalog sind. Diese Paare sind auf einem anderen Weg in den Katalog gelangt, zum Beispiel über ein Werkzeug, das direkt in die Datenbank schreibt. Wie Sie sie von Hand suchen: doppelte Artikelnummer.

Was bedeutet „Ungültige oder doppelte Artikelnummer“?

WooCommerce zeigt diese Meldung, wenn Sie ein Produkt mit einer Artikelnummer speichern, die schon zu einem anderen Produkt oder einer Variante gehört. Auch ein Entwurf oder ein privates Produkt belegt seine Artikelnummer, nur ein Produkt im Papierkorb nicht. Im klassischen Produkt-Editor werden Ihre anderen Änderungen gespeichert, und die Artikelnummer behält ihren alten Wert.

Unter dieser Meldung ergänzt das Plugin eine Zeile mit dem Produkt, das den Code bereits verwendet, samt Link zum Bearbeiten:

Codes aus anderen Quellen, zum Beispiel aus dem Importprotokoll, fügen Sie unter Produkte → Duplicate SKU and GTIN Finder im Abschnitt Who has this code? ein. Das Plugin findet auch, was die Produktsuche nicht anzeigt: eine Variante, deren Produkt nicht mehr existiert, einen Platzhalter aus einem nicht abgeschlossenen Import und eine veraltete Zeile in der WooCommerce-Nachschlagetabelle für Produkte. Die Zeile unter der Meldung fehlt in der Schnellbearbeitung (dort verwirft WooCommerce eine bereits vergebene Artikelnummer ohne jede Meldung) und im blockbasierten Produkt-Editor.

Ohne das Plugin geben Sie die Artikelnummer in das Suchfeld unter Produkte → Alle Produkte ein. Diese Suche findet auch Entwürfe, private Produkte und die Artikelnummern von Varianten. Bei einer Variante zeigt sie das Produkt, zu dem die Variante gehört.

Zum Feld für die Produktkennung gibt es eine eigene Fassung der Meldung, „GTIN, UPC, EAN oder ISBN ungültig oder dupliziert.“ (ab WooCommerce 9.2), und sie erscheint unter denselben Bedingungen.

Wie finde ich WooCommerce-Produkte ohne GTIN?

Seit WooCommerce 9.2 hat jedes Produkt ein Feld für GTIN, UPC, EAN oder ISBN. Seit 10.4 hat die Produktliste dafür auch eine Spalte, die standardmäßig ausgeblendet ist: Blenden Sie sie unter „Ansicht anpassen“ ein und sortieren Sie danach, dann stehen Produkte ohne Nummer oben. Varianten stehen nicht in dieser Liste. Ein variables Produkt, dessen Varianten keine Nummer haben, sieht dort also unauffällig aus. Das Plugin listet alle auf: jedes Produkt mit einem Link zum Bearbeiten und ein variables Produkt nur einmal, mit der Zahl seiner Varianten ohne Code. Warum ein leeres Feld Sie Geld kostet: ohne GTIN.

Wie prüfe ich, ob eine GTIN oder EAN gültig ist?

Ob die Nummer gültig ist, prüft das Plugin nicht. Es findet Produkte ohne GTIN und GTINs, die bei mehr als einem Produkt stehen. Um Prüfziffer, Länge und Format einer ganzen Liste von Codes zu prüfen, nutzen Sie das kostenlose Werkzeug EAN prüfen: Fügen Sie eine Spalte mit Codes ein oder wählen Sie eine Produktexportdatei (CSV, TXT oder XLSX). Es läuft in Ihrem Browser, und die Datei wird nirgendwohin gesendet.

Eine richtig aufgebaute Nummer beweist noch nicht, dass sie zu diesem Produkt gehört. Nur das Register von GS1 zeigt, ob der Hersteller sie registriert hat.

Wo Sie das Plugin bekommen

Das Plugin steht im Plugin-Verzeichnis von WordPress.org als Merchlint – Duplicate SKU and GTIN Finder for WooCommerce und wird wie jedes andere über Plugins → Plugin hinzufügen installiert. Fragen und Probleme gehören in sein Support-Forum auf WordPress.org. Sie können uns auch direkt über Kontakt schreiben, gern auf Deutsch.

Der Name beginnt mit unserem eigenen, weil die Prüfer von WordPress.org als ersten Begriff etwas Unverwechselbares verlangt haben statt einer allgemeinen Formulierung. Das ist nachvollziehbar: „Duplicate SKU Finder“ beschreibt eine Kategorie, kein Produkt. Die Prüfungen, die Ansicht und die CSV-Datei sind dieselben, die diese Seite beschreibt.

Woher die Prüflogik kommt

Die Prüflogik stammt aus Merchlint, einem Plugin für das vollständige Katalog-Audit in WooCommerce vom selben Anbieter, Baltano. Dieses Plugin bringt eine eigene Kopie mit eigenen Klassennamen mit. Deshalb laufen beide ohne Konflikt nebeneinander im selben Shop. Wenn Sie auch den Rest des Katalogs prüfen lassen wollen, also Preise, Bestand, Bilder und Kategorien, ist Merchlint genau dafür da.

Diese Seite wurde noch nicht von Muttersprachlern geprüft. Klingt etwas falsch oder stimmt etwas nicht? Schreiben Sie an contact@merchlint.com.