Cardmarket-CSV-Export: was Händler wissen müssen

Zuletzt aktualisiert: 2. Oktober 2026

Dieser Guide beschreibt, welche Dateien Lumex Pro für Cardmarket erzeugt, was in ihnen steht und wie du sie einsetzt. Alle Angaben zu Spalten, Codes und Limits stammen direkt aus dem Export-Code von Lumex Pro.

Kurzfassung

• Lumex Pro erzeugt zwei Dateiarten: eine CSV im Cardmarket-API-Schema (Semikolon) und eine Bulk-Listing-Datei für das Cardmarket-Webformular „List Bulk Items“ (Komma).
• Beide Dateien sind UTF-8 mit BOM, die Zeilen enden mit CRLF.
• Exportiert werden nur freigegebene Karten (Status approved) mit gesetztem Preis.
• Eine Funktion für den CSV-Upload von Angeboten haben wir im Verkäuferbereich von Cardmarket nicht gefunden (Stand Juli 2026, bitte in der Cardmarket-Hilfe gegenprüfen). Wie du Karten tatsächlich einträgst, steht unten.

Wichtig vorab: Cardmarket und CSV

Im Verkäuferbereich von Cardmarket haben wir (Stand Juli 2026) keine eigene Funktion, die wir finden konnten, um Angebote per CSV hochzuladen. Mehrere Artikel auf einmal einzutragen geht über das Webformular „List Bulk Items“, das sich mit Browser-Erweiterungen ausfüllen lässt. Cardmarket kann das ändern. Prüfe den aktuellen Stand in der Cardmarket-Hilfe, bevor du deinen Ablauf darauf aufbaust.

Format 1: CSV im Cardmarket-API-Schema

Die Spalten entsprechen dem Schema des Endpunkts POST /stock der Cardmarket-REST-API. Wir haben es mit den Open-Source-Werkzeugen pymkm und mkmcsv abgeglichen, die mit echten Cardmarket-Daten arbeiten. Lumex Pro hat derzeit keinen API-Zugang zu Cardmarket und lädt diese Datei nicht selbst hoch. Sie ist für einen möglichen späteren API-Zugang vorgesehen; eine Zusage ist das nicht.

Eigenschaften der Datei:

• Trennzeichen Semikolon, Kodierung UTF-8 mit BOM, Zeilenende CRLF.
• Eine Kopfzeile, danach eine Zeile je Artikel.
• Preise mit Punkt und zwei Nachkommastellen, zum Beispiel 1.50.
• Die Flags (isFoil, isSigned und so weiter) stehen als 0 oder 1 in der Datei.
• Zustand und Sprache stehen als Zahlencode. Ist beides nicht bekannt oder nicht zuordenbar, bleibt die Zelle leer.
• Ein Feld wird in Anführungszeichen gesetzt, wenn es ein Semikolon, ein Anführungszeichen oder einen Zeilenumbruch enthält. Anführungszeichen im Text werden verdoppelt.
• Beginnt ein Textfeld mit =, +, -, @, Tabulator oder Zeilenumbruch, stellt Lumex Pro ein ' voran. Tabellenprogramme behandeln das Feld dann als Text und nicht als Formel.

Die Kopfzeile lautet:

idProduct;amount;price;idLanguage;condition;isFoil;isSigned;isAltered;isPlayset;isReverseHolo;isFirstEd;comments

Eine Beispielzeile mit erfundenen Werten (idProduct 123456, zwei Stück, 1,50, Deutsch, Near Mint, Foil):

idProduct;amount;price;idLanguage;condition;isFoil;isSigned;isAltered;isPlayset;isReverseHolo;isFirstEd;comments
123456;2;1.50;3;2;1;0;0;0;0;0;

Zustandscodes

Sprachcodes

Die Zuordnung stammt aus den Auswahllisten eines Cardmarket-Kontos (Stand 1. Juli 2026) und wurde mit den Open-Source-Werkzeugen pymkm und mkmcsv abgeglichen. Maßgeblich ist immer, was Cardmarket selbst anzeigt.

Dateigröße

Pro Datei schreibt Lumex Pro höchstens 500.000 Zeilen und 250 MB. Größere Bestände teilt der Export automatisch auf mehrere Dateien auf.

Format 2: Bulk-Listing-Datei für „List Bulk Items“

Dieses Format ist für das Cardmarket-Webformular „List Bulk Items“ gedacht. Das Formular lädt jeweils eine Expansion und gleicht Zeilen über den Kartennamen ab, nicht über idProduct. Ausgefüllt wird es üblicherweise mit einer Browser-Erweiterung. Lumex Pro verweist dafür auf eine Open-Source-Erweiterung eines Drittanbieters, betreibt sie aber nicht selbst. Lumex Pro übernimmt keine Gewähr für Funktion, Sicherheit oder Fortbestand der Erweiterung. Die Nutzung erfolgt auf eigene Verantwortung; prüfe vor der Installation Berechtigungen und Quellcode.

Eigenschaften der Datei:

• Trennzeichen Komma (nicht Semikolon), UTF-8 mit BOM, Zeilenende CRLF.
• Zustand und Sprache stehen als Text, zum Beispiel Near Mint und German, damit die Datei vor dem Einlesen lesbar bleibt.
• Foil und Signiert stehen als Y oder N.
• Preise mit Punkt und zwei Nachkommastellen.

Die Kopfzeile lautet:

Name,Set,Language,Condition,Quantity,Price,Comment,IsFoil,IsSigned

Dieselbe Beispielkarte in diesem Format:

Name,Set,Language,Condition,Quantity,Price,Comment,IsFoil,IsSigned
Example Card,Example Set,German,Near Mint,2,1.50,,Y,N

Aufteilung nach Expansion und Seite

Das Cardmarket-Formular zeigt eine Expansion in Blöcken von etwa 100 Karten, sortiert nach Sammlernummer. Die Erweiterung findet nur Karten, die auf der gerade geladenen Seite stehen. Deshalb gibt es zwei Wege:

• Seitenbewusster Export (Magic): Lumex Pro berechnet für jede Karte, auf welcher Seite des Formulars sie voraussichtlich steht, und erzeugt eine Datei je Expansion und Seite. Dazu gibt es einen Link, der das Formular mit der passenden Expansion und Seite öffnet.
• Klassischer Export: eine Datei je Expansion, mit höchstens 100 Zeilen pro Datei. Dieser Weg dient als Ausweichlösung, falls die Seitenberechnung bei einer Expansion nicht passt. Karten ohne Seitenberechnung (zum Beispiel Pokémon) werden ebenfalls so ausgegeben.

Zeigt Cardmarket für eine Expansion mehr als 300 Artikel, blättert das Formular nicht weiter. Lumex Pro berechnet die Seite dann innerhalb der Seltenheit (common, uncommon, rare, mythic) und setzt den Seltenheitsfilter im Link. Für andere Seltenheiten gibt es in diesem Fall keinen Link, du nimmst den klassischen Export.

Im seitenbewussten Export kannst du außerdem eine Preisregel auswählen, die beim Download auf die Preise angewendet wird.

So gehst du vor

1. Karten scannen, prüfen, im Staging den Preis setzen und freigeben.
2. Im Bereich Listing das Format wählen und die Datei laden.
3. Bei der Bulk-Listing-Datei: das Cardmarket-Formular für die Expansion öffnen und die Datei mit der Browser-Erweiterung einlesen.
4. Die Karten in Lumex Pro als gelistet markieren, damit sie beim nächsten Export nicht erneut in der Datei stehen.

Häufige Stolpersteine

• Falsches Trennzeichen: Das API-Schema nutzt Semikolon, das Bulk-Listing-Format Komma. Beim Öffnen in einem Tabellenprogramm hilft es, das Trennzeichen manuell zu wählen.
• Leere Zustands- oder Sprachzelle: Die Karte hat im Staging keinen Zustand oder keine Sprache, oder der Wert gehört nicht zu den oben aufgeführten Codes.
• Karte fehlt in der Datei: Sie ist nicht freigegeben oder hat keinen Preis.
• Karte wird im Formular nicht gefunden: Sie steht auf einer anderen Formularseite, als die Berechnung vorhergesagt hat. Nimm in diesem Fall den klassischen Export.

Weiterlesen

Wie das Zusammenspiel von Scan, Staging und Export in Lumex Pro aussieht, steht auf der Startseite. Tarife findest du auf der Seite Preise. Wenn du erst überlegst, auf Cardmarket regelmäßig zu verkaufen, hilft der Guide Cardmarket-Verkäufer werden.