Vom Kartenscan zur TCG PowerTools CSV

TCG PowerTools kümmert sich um deine Cardmarket-Angebote. TCG Actana übernimmt den Schritt davor: Karten scannen, bestimmen, prüfen und als importfertige CSV exportieren. Hier steht, wie beide zusammenspielen, was der Import wirklich verlangt und wie die Actana-Datei genau aufgebaut ist.

Wer übernimmt was im Cardmarket-Workflow

TCG PowerTools ist ein Listing-Werkzeug für Verkäufer aufCardmarket. Es nimmt Bestandslisten per CSV entgegen und führt von dort deine Angebote. TCG Actana setzt einen Schritt früher an: Die Desktop-App ordnet deine Kartenbilder dem Katalog zu.

In Actana kommen deine Karten als Bilddateien herein: per Dateiauswahl, Drag-and-Drop oder über einen überwachten Scanner-Ordner. Die App versucht, Karte, Set, Sammlernummer und Sprache automatisch zuzuordnen. Als unsicher oder mehrdeutig eingestufte Treffer zeigt sie dir zur Prüfung. Zustand, Finish und Menge hältst du am Exemplar fest. Der Export erzeugt daraus eine CSV im TCG PowerTools Importformat.

Wichtig für die Erwartung: Actana lädt nichts zu Cardmarket hoch. Der Import in TCG PowerTools ist dein nächster Schritt, und dort behältst du die volle Kontrolle über Preise und Angebote.

Sammlungsansicht der TCG-Actana-Desktop-App mit Kartenliste und Marktwerten in Euro

Was der TCG PowerTools Import wirklich verlangt

Laut der offiziellen Wissensdatenbank sind nur zwei Dinge Pflicht: eineQuantity-Spalte plus eine Identifikation der Karte. Als Identifikation akzeptiert TCG PowerTools eine ID-Spalte (Cardmarket ID, Scryfall ID oder TCGplayer ID) oder die Kombination aus Name, Sammlernummer und Expansion.

Fehlen Sprache oder Zustand, setzt TCG PowerTools Standardwerte: Englisch und Near Mint. Für einen deutschen Kartenbestand ist dieser Default gefährlich, weil aus einer deutschen Karte still ein englisches Listing wird. Actana exportiert die gespeicherten Angaben deshalb explizit. Neue Scan-Einträge starten beim Zustand mit NM; prüfe und korrigiere diese Vorgabe vor dem Export. Karten ohne eindeutige Sprache werden ausgelassen.

So sieht die Actana-CSV aus

Das Preset heißt in Actana „Cardmarket-Listing (TCG PowerTools)“. Die Dateien sind komma-getrennt und UTF-8 ohne BOM. Magic nutzt bewusst ein schlankes Importschema, damit TCG PowerTools beim Zuordnen möglichst wenig Reibung erzeugt. Pokémon und die anderen unterstützten TCGs behalten die zusätzlichen Variantenspalten.

SpalteInhalt
cardmarketIdCardmarket-Produkt-ID des Drucks, sofern vorhanden
quantityAnzahl identischer Exemplare
namenach Möglichkeit englischer Kartenname, sonst gespeicherter Anzeigename
setnach Möglichkeit vollständiger Setname, sonst Set-Code
cnSammlernummer; nur im erweiterten Variantenschema
conditionZustand nach Cardmarket-Skala, von MT bis PO
languageausgeschriebener Sprachname, etwa „German“
isFirstEd„true“ bei 1st-Edition-Exemplaren; nur im erweiterten Variantenschema
isReverseHolo„true“ bei Reverse-Holo-Exemplaren; nur im erweiterten Variantenschema
isSignedbleibt im Actana-Export leer
priceAngebotspreis mit Dezimalpunkt, etwa „8.25“, sonst leer
finishTypekanonischer TCG PowerTools Wert, etwa Regular, Foil, ReverseHolo
buyPricebleibt im Actana-Export leer
commentbleibt leer und steht am Ende des festen Headers
locationoptional; wird nur bei vergebenen Lagerplätzen hinter comment ergänzt

Der schlanke Magic-Header mit einer vollständigen Beispielzeile:

cardmarketId,quantity,name,set,condition,language,isSigned,price,finishType,buyPrice,comment
12345,1,Entomb,Odyssey,NM,German,,8.25,Regular,,

Das ist eine deutschsprachige Entomb aus Odyssey, Near Mint, ein Exemplar ohne Foil, Angebotspreis 8,25 EUR. Nicht belegte Felder bleiben leer. Das erweiterte Schema für Pokémon und die anderen TCGs enthält zusätzlich cn,isFirstEd und isReverseHolo. Wenn du beim Export Lagerplätze vergibst, hängt Actana in beiden Schemas location als letzte Spalte direkt hinter comment an.

Sprache, Zustand, Menge und Finish

Sprache. Actana erkennt die Kartensprache beim Scan und exportiert sie ausgeschrieben, „German“ statt „de“. Karten ohne eindeutige Sprache werden beim Export übersprungen und gemeldet, statt als Englisch geraten zu werden.

Zustand. Neue Scan-Einträge beginnen mit NM. Prüfe und ändere diese Vorgabe am Exemplar auf der Cardmarket-Skala MT, NM, EX, GD, LP, PL, PO. Die CSV übernimmt das gespeicherte Kürzel.

Menge. quantity ist die Anzahl identischer Exemplare einer Zeile, also gleicher Druck, Zustand, Sprache und gleiches Finish.

Finish. finishType trägt kanonische TCG PowerTools Werte wie Regular, Foil, ReverseHolo, StampedHolo, ReverseCosmosHolo, MasterballHolo oder PokeballHolo. Bei Magic hängen die angebotenen Finish-Optionen von den verfügbaren Variantendaten ab. Eine Grenze nennen wir offen: Foil wird nicht optisch erkannt, weil Dokumentenscanner dafür kein verlässliches Signal liefern. Das Finish setzt du selbst.

Reverse Holo. Bei Reverse-Exemplaren setzt Actana beides zusammen:isReverseHolo auf „true“ und finishType auf den passenden Reverse-Wert, etwa ReverseHolo oder ReverseCosmosHolo. Das Boolean-Feld markiert den Reverse-Status; finishType bewahrt die konkrete Finish-Art.

Preis. Der Preis gehört strikt zum Finish. Eine Foil- oder Reverse-Zeile bekommt nie den Preis der Normalversion als Ersatz. Fehlt der passende Marktwert, bleibt das Feld lieber leer, als dass eine Foil-Karte zum Normalpreis in dein Listing rutscht.

Eine Datei je Spiel

Der Export erzeugt für jedes im Export enthaltene unterstützte Spiel eine eigene CSV. Das gilt für Magic, Pokémon, One Piece und Riftbound. Der Grund liegt beim Importziel: TCG PowerTools verarbeitet eine CSV immer im Kontext des dort aktiven Spiels, eine Spiel-Spalte kennt das Format nicht. Deine Sammlung in Actana darf gemischt bleiben, erst der Export teilt sie sauber auf.

Typische Importprobleme

  1. Veränderte Spalten. TCG PowerTools verlangt beim Import, dass jede Spalte dem richtigen Feld zugeordnet ist. Am sichersten importierst du den von Actana erzeugten Header unverändert und kontrollierst die Zuordnung vor dem Import.
  2. Excel formatiert um. Öffnen und erneut speichern kann das Trennzeichen auf Semikolon umstellen, Preise in Dezimalkommas verwandeln und führende Nullen aus Sammlernummern kürzen. Am sichersten importierst du die Datei unverändert. Musst du sie bearbeiten, speichere als „CSV UTF-8 (durch Trennzeichen getrennt)“ und kontrolliere danach Preis- und cn-Spalte.
  3. Preis mit Komma statt Punkt. TCG PowerTools liest den Preiswert 1:1. Ein Centbetrag wie „825“ wird so zum Angebot über 825 EUR statt 8,25 EUR, und ein Komma-Wert wie „8,25“ kommt nicht verlässlich an. Actana schreibt deshalb immer einen Dezimalpunkt, „8.25“.
  4. Fehlende Sprache. Ohne Sprachangabe setzt TCG PowerTools Englisch als Standard, bei deutschen Karten entsteht so das falsche Listing. Actana schreibt die Sprache immer aus und überspringt Karten ohne eindeutige Sprache, statt zu raten. Übersprungene Karten meldet der Export, damit nichts still verschwindet.

CSV-Export oder ID-Converter?

Zwei Wege führen bei uns zu einer TCG PowerTools Datei, und sie lösen verschiedene Probleme. Der CSV-Export in der Desktop-App erzeugt die Datei aus deiner eigenen gescannten Sammlung. TCG Actana befindet sich in der Alpha: Der Installer für Windows (x64) und Macs mit Apple Silicon ist frei ladbar. Dein Konto erstellst du mit E-Mail-Adresse und Passwort direkt in der App. Die Alpha kostet aktuell 0 €, ist aber weder ein Kauf noch ein Abo und keine Zusage dauerhaft kostenlosen Zugangs.

Hast du dagegen schon eine TCGplayer-CSV mit Product IDs, brauchst du keinen Scan und kein Konto. Der freie ID-Converter wandelt sie direkt im Browser in eine TCG PowerTools kompatible Datei mit Cardmarket-IDs um. Deine CSV-Datei bleibt im Browser; von ihrem Inhalt sendet der Converter für die Zuordnung nur die enthaltenen Product IDs an die Actana-API. Er erwartet Product IDs, keine Seller-SKUs. Die Zuordnungsabdeckung ist je Spiel unterschiedlich und bei Pokémon derzeit lückenhaft; nicht zugeordnete IDs weist das Werkzeug getrennt aus.

Kurz: Sammlung in Actana gescannt, dann Export in der App. TCGplayer-Liste schon vorhanden, dann ID-Converter.

Was der Magic-Karten-Scanner erkennt und wie du ihn nutzt, zeigt die Produktseite. Grundlagen zum CSV-Format und zu den anderen Presets stehen im ArtikelDer CSV-Export erklärt.

Quellen