Eine CSV in TCG PowerTools importieren

Was PowerTools zwingend braucht

Pflicht sind zwei Dinge je Zeile: die Menge und mindestens ein Erkennungsmerkmal. Als Merkmal zählt eine ID, naheliegend die Cardmarket-ID, oder ersatzweise Name plus Sammlernummer plus Set. Und dann gibt es die Falle: Fehlen Sprache und Zustand in der Datei, setzt PowerTools sie auf Englisch und Near Mint. Bei einem deutschen Stapel ist damit jede Zeile falsch, ohne dass eine einzige Fehlermeldung erscheint. Genau deshalb schreibt CardEntry beides in jede Zeile, zusammen mit der Cardmarket-ID.

Eine Datei je Kartenspiel

Ein Wareneingang ist selten sortenrein. Der Import läuft aber je Kartenspiel, deshalb wird ein gemischter Stapel beim Export getrennt: Yu-Gi-Oh!, Pokémon und Magic bekommen jeweils eine eigene Datei. Du importierst sie nacheinander, nicht zusammen.

Die dreizehn Spalten

In dieser Reihenfolge und mit diesen Überschriften kommt die Datei aus CardEntry. Sie entspricht dem Format, das PowerTools als Beispieldatei anbietet, deshalb steht die Zuordnung in Schritt drei meist schon richtig da. Hinsehen lohnt trotzdem. So sieht eine Zeile aus:

Der Name ist ein Erkennungsmerkmal, keine Beschriftung

Beim Import wird der Kartenname zur Cardmarket-Kennung herangezogen. Ein Tippfehler oder ein übersetzter Name ist deshalb kein Schönheitsfehler: Er kann die Zeile auf eine andere Karte schieben. Aus CardEntry kommt der englische Name der zugeordneten Version, nicht der Text, den die Kamera gelesen hat.

Zustand, Sprache, Foil und Edition

Diese vier Angaben entscheiden über den Preis und lassen sich nachträglich nur einzeln korrigieren. Sie gehören deshalb in die Datei, nicht in den Shop.

• Zustand als Kürzel: MT, NM, EX, GD, LP, PL, PO. Fehlt der Zustand einer Karte, greift der Rückfallwert des Exportprofils.
• Sprache ausgeschrieben, wie Cardmarket sie führt: German, English, French, Italian, Spanish, Portuguese, Japanese, S-Chinese, Korean.
• isFirstEd, isReverseHolo, isSigned und isPlayset tragen true oder false. Leer heißt nicht false, sondern unbestimmt.

Gleiche Karten stehen einmal drin

Drei Exemplare derselben Karte in demselben Zustand, derselben Sprache und derselben Edition ergeben eine Zeile mit Menge 3. Unterscheidet sich eines dieser Merkmale oder trägt eine Karte einen eigenen Kommentar, entsteht eine eigene Zeile. Das ist kein Detail: Zusammengefasste Zeilen mit verschiedenen Zuständen wären im Shop falsch bepreist.

Zeichensatz

Die Datei ist UTF-8 mit vorangestellter Bytefolge (BOM). Ohne sie liest Excel Umlaute falsch, und aus „Dunkler Magier" wird beim ersten Öffnen Buchstabensalat, den niemand mehr zurückdreht.

Lagerplätze und die zusätzliche Spalte

Ein Lagerplatz je Karte lässt sich als Vorlage vergeben, etwa AB-C{index} für laufende Nummern in Scanreihenfolge. Er kann in die Kommentarspalte geschrieben werden oder in eine eigene location-Spalte. Die eigene Spalte kennt nur PowerTools V2, und ob ältere Fassungen eine Datei mit zusätzlicher Spalte laden, ist ungeprüft, deshalb ist sie standardmäßig aus. Wer sie einschaltet, testet zuerst mit einer kleinen Session.

Wenn Zeilen abgewiesen werden

Ein Import ist selten ganz oder gar nicht. Gehen einzelne Zeilen nicht durch, legt PowerTools eine CSV mit genau diesen Zeilen und dem Grund daneben. Diese Datei ist der schnellste Weg zurück: Sie sagt dir, ob es an einer fehlenden ID lag, an einer Karte, die es in dem Set nicht gibt, oder an einer Angabe, die das Feld nicht kennt. Der Rest deines Stapels ist zu diesem Zeitpunkt bereits drin und muss nicht noch einmal hochgeladen werden.

Was du außerhalb von CardEntry brauchst

Das Erzeugen und Herunterladen der Datei kostet dich kein fremdes Abo. Importieren und veröffentlichen kannst du in TCG PowerTools auch ohne zu zahlen: Die kostenlose Fassung liest Dateien ein und veröffentlicht bis zu 50 neue Änderungen am Tag. Wer mehr am Tag einstellt oder die automatische Bepreisung will, braucht dort ein kostenpflichtiges Abo. Das ist ein Fremdprodukt und nicht in den CardEntry-Credits enthalten.