Schweregrade

  • Blockiert den ImportStoppt wahrscheinlich den Import der Zeile oder macht das zugehörige Produkt kaputt.
  • Wird falsch importiertWird importiert, aber im Shop ist danach etwas nicht so, wie Sie es wollten.
  • AufräumenWird problemlos importiert. Aufräumen lohnt sich trotzdem: für Einheitlichkeit und spätere Pflege.

Shopify hat mir diesen Fehler gezeigt

Die Importmeldungen von Shopify sind knapp. Diese Prüfungen finden die üblichen Ursachen in Ihrer Datei.

01

Aufbau & Spaltenköpfe

Spaltenköpfe entsprechen der Shopify-Vorlage

Shopify vergleicht Spaltennamen exakt. Eine falsch geschriebene, doppelte oder unbekannte Spalte wird ignoriert oder stoppt den Import.

  • Blockiert den ImportKein ProduktexportFILE-06
  • Blockiert den ImportKopfzeile nicht in der ersten ZeileHDR-01Erklärt: Invalid CSV header: missing headers
  • Blockiert den ImportSpalte «Title» fehltHDR-02Erklärt: Invalid CSV header: missing headers
  • Blockiert den ImportSpalte doppelt vorhandenHDR-04
  • Blockiert den ImportBarcode und Barcodes zusammenHDR-05
  • Blockiert den ImportLeerzeichen um einen SpaltennamenHDR-06Erklärt: Invalid CSV header: missing headers
  • Wird falsch importiertSpaltenname anders geschriebenHDR-07Erklärt: “Choose column headings” dialog
  • Wird falsch importiertMöglicher Tippfehler im SpaltennamenHDR-08Erklärt: “Choose column headings” dialog
  • Wird falsch importiertSpalte ohne NamenHDR-10
  • Wird falsch importiertVariantenspalten ohne OptionenHDR-12
  • Wird falsch importiertSpalte mit Varianten-MetafeldHDR-13
  • AufräumenUnbekannte SpalteHDR-09Erklärt: “Choose column headings” dialog
  • AufräumenLeere Spalten ohne NamenHDR-11

Jede Zeile hat gleich viele Felder

Eine Zeile mit zu vielen oder zu wenigen Zellen bedeutet meist, dass ein Komma oder ein Anführungszeichen einen Wert geteilt hat. Die Daten landen dann in falschen Spalten.

  • Blockiert den ImportAnführungszeichen in einem WertCSV-03Erklärt: Illegal quoting on line … · Missing or stray quote on line …
  • Blockiert den ImportAnführungszeichen nie geschlossenCSV-04Erklärt: Missing or stray quote on line …
  • Blockiert den ImportText nach schliessendem AnführungszeichenCSV-05Erklärt: Illegal quoting on line …
  • Blockiert den ImportZeile mit zu vielen ZellenCSV-06
  • Wird falsch importiertZeile mit zu wenigen ZellenCSV-07

Kodierung und Zeilenenden

Shopify liest CSV-Dateien in UTF-8, mit Kommas zwischen den Spalten und LF-Zeilenenden. Andere Formate verstümmeln Zeichen oder lassen sich gar nicht lesen.

  • Blockiert den ImportSemikolons statt KommasCSV-01Erklärt: Invalid CSV header: missing headers
  • Blockiert den ImportTabulatoren oder Striche statt KommasCSV-02Erklärt: Invalid CSV header: missing headers
  • Blockiert den ImportNicht als UTF-8 gespeichertENC-01Erklärt: Illegal quoting on line …
  • Blockiert den ImportAls UTF-16 gespeichertENC-02
  • Blockiert den ImportKeine CSV-DateiFILE-01
  • Wird falsch importiertAlte Mac-ZeilenendenCSV-09
  • AufräumenByte Order Mark am AnfangENC-03

Leere Zeilen

Leere Zeilen bringen nichts und können einen Import scheitern lassen.

  • Blockiert den ImportLeere DateiFILE-02
  • Wird falsch importiertKeine ProduktzeilenFILE-03
  • AufräumenLeere ZeilenCSV-08

Durch falsche Kodierung beschädigter Text

Wurde eine Datei irgendwann in der falschen Kodierung gespeichert, wird aus é ein é, und Kundinnen und Kunden sehen im Shop unleserliche Zeichen.

  • Wird falsch importiertVerstümmelte ZeichenENC-04
  • Wird falsch importiertVerlorenes Zeichen (�)ENC-05
  • Wird falsch importiertUnsichtbares SteuerzeichenENC-06
  • Wird falsch importiertExcel-Zeilenumbruch-CodeXL-06

Typografische Anführungszeichen in HTML-Tags

HTML-Attribute brauchen gerade Anführungszeichen. Typografische, meist aus Word oder Google Docs eingefügt, machen Links und Formatierungen kaputt.

  • Wird falsch importiertTypografische Anführungszeichen in einem HTML-TagTXT-14

Leerzeichen am Anfang oder Ende

In der Tabelle unsichtbar, aber Teil des Werts: «HP-014 » und «HP-014» sind für Shopify und Apps verschiedene Werte.

  • Wird falsch importiertUnsichtbares ZeichenTXT-02
  • AufräumenLeerzeichen am Anfang oder EndeTXT-01

02

Handles, Titel & SKUs

Zeilen ohne Handle

Über das Handle erkennt Shopify, zu welchem Produkt eine Varianten- oder Bildzeile gehört.

  • Blockiert den ImportKeine Handle-Spalte, Zeilen ohne TitelHDR-03
  • Blockiert den ImportZeile ohne Handle und TitelPROD-02
  • AufräumenKein HandleHDL-06
  • AufräumenKeine Handle-SpalteHDR-16

Handle-Format

Handles werden Teil der Produkt-URL: Kleinbuchstaben, Zahlen und Bindestriche, keine Leerzeichen.

  • Blockiert den ImportLeerzeichen im HandleHDL-01
  • Blockiert den ImportUngültige Zeichen im HandleHDL-02
  • Wird falsch importiertHandle zu langHDL-05
  • AufräumenGrossbuchstaben im HandleHDL-03

Handle weicht innerhalb eines Produkts ab

Schreibt eine Zeile eines Produkts das Handle leicht anders, behandelt Shopify sie als eigenes Produkt.

  • Wird falsch importiertHandle anders geschriebenHDL-07

Ein Handle für zwei Produkte

Shopify gruppiert Zeilen nach Handle. Ein zweites Produkt mit demselben Handle wird deshalb mit dem ersten zusammengelegt.

  • Wird falsch importiertEin Handle für zwei ProduktePROD-12

Dasselbe Produkt doppelt erfasst

Zwei getrennte Zeilenblöcke für ein Produkt entstehen meist durch Kopieren oder Sortieren. Shopify kann dabei Bilder oder Varianten verlieren.

  • Wird falsch importiertProduktzeilen auseinandergerissenPROD-03Erklärt: Validation failed: options are not unique

Fehlender Produkttitel

Shopify braucht einen Titel, um ein Produkt anzulegen.

  • Blockiert den ImportProdukt ohne TitelPROD-01

Anbieter uneinheitlich geschrieben

Eine zweite Schreibweise erscheint in Filtern und Berichten als zweiter Anbieter.

  • AufräumenAnbieter anders geschriebenTXT-15

Doppelte SKUs

Shopify erlaubt sie, aber Lagerabgleich, Versand und viele Apps behandeln beide Varianten als einen Artikel.

  • Wird falsch importiertSKU mehrfach verwendetOPT-09

Varianten ohne SKU

Ein Fulfillment-Service braucht eine SKU, um zu wissen, was er verschicken soll.

  • Blockiert den ImportSKU fehlt für Fulfillment-ServiceOPT-10

Von Excel beschädigte Barcodes

Excel kürzt lange Zahlen in wissenschaftliche Schreibweise und entfernt führende Nullen. Die verlorenen Ziffern lassen sich aus der Datei nicht wiederherstellen.

  • Wird falsch importiertVon Excel beschädigte ZahlXL-01
  • Wird falsch importiertBarcode sieht falsch ausXL-02
  • Wird falsch importiertBarcodes falsch getrenntXL-07

03

Varianten

Exakt doppelte Zeilen

Eine Zeile, die eine andere kopiert, fügt dieselbe Variante zweimal hinzu. Das lehnt Shopify ab.

  • Blockiert den ImportExakte Kopie einer anderen ZeileOPT-12Erklärt: Validation failed: options are not unique

Optionsnamen, die zwischen Zeilen wechseln

Eine Option braucht auf jeder Zeile eines Produkts denselben Namen. Shopify verwendet den Namen aus der ersten Zeile.

  • Wird falsch importiertOptionsname wechseltOPT-05
  • Wird falsch importiertOptionsname anders geschriebenOPT-06

Optionswerte in zwei Schreibweisen

Shopify behandelt «Sage» und «sage » als zwei verschiedene Werte. Das Produkt erhält so eine zusätzliche Variante.

  • Wird falsch importiertOptionswerte nur anders geschriebenOPT-02Erklärt: Validation failed: options are not unique

Typografische Anführungszeichen in Optionswerten

Typografische und gerade Zoll-Zeichen sehen gleich aus, sind aber verschiedener Text. Filter und Apps behandeln 10” und 10" als zwei Werte.

  • AufräumenTypografische Zoll-Zeichen im OptionswertOPT-13

Variantenzeilen ohne Optionswert

Jede Variante braucht für jede Option des Produkts einen Wert.

  • Blockiert den ImportOptionswert fehltOPT-03

Wiederholte Optionskombinationen

Jede Kombination von Optionswerten darf pro Produkt nur einmal vorkommen. Wiederholungen lehnt Shopify mit «options are not unique» ab.

  • Blockiert den ImportDoppelte VarianteOPT-01Erklärt: Validation failed: options are not unique
  • Blockiert den ImportVarianten ohne echte OptionenOPT-08Erklärt: Validation failed: options are not unique

04

Preise, Gewichte & TRUE/FALSE-Felder

Preisformat

Shopify braucht einen reinen Betrag: Ziffern mit Punkt als Dezimaltrennzeichen, ohne Währungssymbol oder -kürzel.

  • Blockiert den ImportPreis ist keine reine ZahlPRICE-01Erklärt: Price is not a number
  • Blockiert den ImportDezimalkomma oder TausendertrennzeichenPRICE-02Erklärt: Price is not a number
  • Blockiert den ImportSchweizer Schreibweise «.–»PRICE-03Erklärt: Price is not a number
  • Blockiert den ImportNegativer BetragPRICE-04Erklärt: Price is not a number

Fehlende Preise

Shopify füllt einen leeren Preis mit 0.00. Die Variante wäre dann gratis im Shop.

  • Wird falsch importiertPreis fehltPRICE-05
  • Wird falsch importiertPreis ist 0PRICE-06

Format des Vergleichspreises

Der Vergleichspreis folgt demselben Format wie der Preis: Ziffern mit Punkt, sonst nichts.

Die Prüfungen des Preisformats (PRICE-01 bis PRICE-04), angewendet auf die Spalten mit dem Vergleichspreis. PRICE-01, PRICE-02, PRICE-03, PRICE-04

Vergleichspreis gleich oder unter dem Preis

Der Vergleichspreis sollte der alte, höhere Preis sein. Ist er tiefer oder gleich, zeigen die meisten Themes keinen Rabatt.

  • Wird falsch importiertVergleichspreis unter dem PreisPRICE-07
  • AufräumenVergleichspreis gleich PreisPRICE-08

Gewichte in der Gramm-Spalte

Die Gewichtsspalte erwartet ganze Gramm, und die Versandkosten richten sich danach. Kilogramm oder Einheiten darin führen zu falschen Versandkosten.

  • Blockiert den ImportGewicht ist keine ZahlINV-05
  • Wird falsch importiertGewicht mit NachkommastellenINV-06

TRUE/FALSE-Spalten

Spalten wie Published oder Requires shipping akzeptieren nur true oder false.

  • Wird falsch importiertWeder true noch falseVAL-01

Status-Werte

Shopify akzeptiert active, draft oder archived, auf Englisch.

  • Blockiert den ImportStatus leerPROD-04
  • Blockiert den ImportStatus ungültigPROD-05

Bestands- und Fulfillment-Werte

Bestand, Inventory tracker, Verhalten bei Ausverkauf, Fulfillment-Service und Verpackungsmasse akzeptieren nur bestimmte Werte.

  • Blockiert den ImportBestand ist keine ganze ZahlINV-01
  • Blockiert den ImportInventory tracker ungültigVAL-02
  • Blockiert den ImportVerhalten bei Ausverkauf ungültigVAL-03
  • Blockiert den ImportVerhalten bei Ausverkauf fehltVAL-04
  • Blockiert den ImportFulfillment-Service ungültigVAL-06
  • Blockiert den ImportVerpackungsmasse unvollständigVAL-07
  • Wird falsch importiertBestand mit NachkommastellenINV-02
  • Wird falsch importiertNegativer BestandINV-03
  • Wird falsch importiertBestand ohne TrackerINV-04

Gewichtseinheiten

Die angezeigte Gewichtseinheit muss g, kg, lb oder oz sein.

  • Blockiert den ImportGewichtseinheit ungültigVAL-05

Geschenkkarten als versandpflichtig markiert

Geschenkkarten werden nicht verschickt. Ob eine Geschenkkarten-Zeile Versand verlangen soll, ist eine Ermessensfrage; diese Prüfung gehört deshalb nur zum bezahlten Audit.

Nicht automatisiert: Dafür braucht es eine Beurteilung, deshalb gehört diese Prüfung nur zum bezahlten Audit.

05

Bilder & fehlende Angaben

Bildlinks mit http

Shopify verlangt https-Links, und manche Server verweigern den Download über http.

  • Wird falsch importiertBildlink mit httpIMG-02

Bildlinks, die keine Bilddateien sind

Shopify lädt jedes Bild von genau einer öffentlichen Webadresse. Lokale Dateipfade, mehrere Links in einer Zelle oder kaputte Links funktionieren nicht.

  • Blockiert den ImportBildlink ist keine WebadresseIMG-01Erklärt: Validation failed: getaddrinfo: nodename nor servname provided…
  • Blockiert den ImportMehrere Bildlinks in einer ZelleIMG-03Erklärt: Validation failed: getaddrinfo: nodename nor servname provided…
  • Wird falsch importiertLeerzeichen oder Anführungszeichen im BildlinkIMG-05Erklärt: Validation failed: getaddrinfo: nodename nor servname provided…
  • Wird falsch importiertVerkleinerte BildversionIMG-06

Doppelte Bildpositionen

Jedes Bild braucht eine eigene Positionsnummer ab 1, sonst ist die Reihenfolge der Galerie unvorhersehbar.

  • Blockiert den ImportBildposition ungültigIMG-08
  • Wird falsch importiertBildposition doppeltIMG-09

Bilder ohne Alt-Text

Freiwillig, aber Screenreader und die Bildersuche nutzen ihn.

  • AufräumenBilder ohne Alt-TextIMG-13

Produkte ohne Beschreibung

Der Import klappt, aber die Produktseite bleibt unter dem Preis leer. Beim Aktualisieren löscht eine leere Zelle zudem die bestehende Beschreibung.

  • AufräumenProdukte ohne BeschreibungPROD-13

+

Weitere Prüfungen

Prüfungen zu Shopify-Limits und -Formaten, die zu keiner der 39 Audit-Prüfungen gehören.

  • Blockiert den ImportDatei über 15 MBFILE-04
  • Blockiert den ImportOptionswert ohne OptionsnamenOPT-04Erklärt: Option value provided for unknown options
  • Blockiert den ImportOptionen lückenhaft oder doppeltOPT-07Erklärt: Option value provided for unknown options
  • Blockiert den ImportZu viele VariantenPROD-07
  • Blockiert den ImportZu viele BilderPROD-09
  • Blockiert den ImportTitel zu langPROD-10
  • Blockiert den ImportTags über den Shopify-LimitsTXT-09
  • Blockiert den ImportFehlerwert aus der TabelleXL-03Erklärt: Price is not a number
  • Wird falsch importiertAlt-Text zu langIMG-11
  • Wird falsch importiertBildangaben ohne BildIMG-14
  • Wird falsch importiertGeschenkkarte im ImportPROD-11
  • Wird falsch importiertFehlerhaftes HTML in der BeschreibungTXT-04
  • Wird falsch importiertSkript oder Formular in der BeschreibungTXT-05
  • Wird falsch importiertMaskiertes HTML in der BeschreibungTXT-06
  • Wird falsch importiertTags mit Semikolon getrenntTXT-10
  • Wird falsch importiertMehrere Kollektionen in einer ZelleTXT-13
  • Wird falsch importiertFormel statt WertXL-04