Importer votre inventaire depuis un fichier CSV

Vous avez un tableur de cartes exporté depuis TCGPlayer, Dragon Shield, Manabox, Deckbox — ou depuis votre propre outil de suivi de collection ? L'importateur CSV le transforme en inventaire CardNexus en trois étapes guidées. Vous pouvez aussi l'utiliser pour mettre des cartes en vente en masse en incluant une colonne de prix.

Ce guide passe en revue chaque étape, chaque message d'erreur que vous pourriez rencontrer et la façon de le corriger.

Où le trouver

• Depuis votre inventaire — cliquez sur Import CSV.

• Depuis une liste — ouvrez la liste, puis Ajouter des produits → CSV.

• Pour mettre des cartes en vente en une seule fois — utilisez List for sale via CSV depuis votre inventaire.

Avant de commencer

Il vous faudra :

• Un fichier .csv (la plupart des tableurs et des outils de cartes à collectionner peuvent en exporter un).

• Au moins un moyen d'identifier chaque carte : un ID externe (Cardmarket ID / TCGPlayer ID / Scryfall ID), le numéro de la carte, ou le nom de la carte.

💡 Limites de fichier : jusqu'à 250 Mo et 500 000 lignes par téléchargement. Les fichiers plus volumineux doivent être divisés avant l'import.

💡 Vous n'avez pas encore de CSV ? À l'étape 1, cliquez sur Modèle CSV pour récupérer un fichier prêt à l'emploi, avec les bons intitulés de colonnes et quelques lignes d'exemple pour le jeu choisi. Remplissez-le et téléchargez-le à nouveau.

Étape 1 — Télécharger votre CSV

1. Ouvrez l'importateur depuis l'un des points d'entrée ci-dessus.

2. Choisissez le jeu concerné en haut de la page.

3. Glissez votre fichier sur la zone de téléchargement, ou cliquez pour parcourir.

4. Patientez quelques secondes — pour un fichier classique de 1 000 lignes, c'est instantané ; les très gros fichiers peuvent prendre jusqu'à une minute.

Les erreurs possibles à cette étape

Étape 2 — Mapper les colonnes

C'est ici que vous indiquez à CardNexus ce que signifie chaque colonne de votre tableur. Nous en détectons la plupart automatiquement (une colonne appelée « Qty » sera associée à Quantité, « Set Name » à Extension, et ainsi de suite), mais vous pouvez toujours modifier nos propositions.

Les colonnes prises en charge

Et si une colonne n'est pas dans mon CSV ?

Trois options pour chaque colonne CardNexus :

• Associer une colonne de votre CSV — le cas normal.

• Utiliser une valeur par défaut — appliquer la même valeur à chaque ligne. Utile quand toutes les cartes que vous importez sont, par exemple, en anglais et Near Mint.

• Pas dans mon CSV — l'ignorer complètement. Fonctionne uniquement pour les colonnes non requises (voir « Identifiants » ci-dessous).

Identifiants : comment nous reconnaissons chaque carte

C'est la partie la plus importante du mappage. CardNexus a besoin d'au moins un moyen d'identifier chaque carte. Du plus fiable au moins fiable :

1. Idéal — ID externe + type d'ID. Un Cardmarket / TCGPlayer / Scryfall ID est unique et garantit une correspondance parfaite à chaque fois. Si votre CSV en contient un, utilisez-le.

2. Excellent — Nom + Numéro d'impression. Très précis. Le numéro d'impression limite la correspondance à la bonne impression.

3. Bien — Numéro d'impression seul. Fonctionne tant que la colonne Extension est correcte elle aussi.

4. Risqué — Nom seul. Beaucoup de cartes partagent le même nom d'une extension ou d'une impression à l'autre. Nous ne pourrons pas toujours les distinguer et vous verrez des erreurs « Plusieurs correspondances trouvées » à l'étape 3.

Un petit bandeau en haut de l'étape de mappage vous indique le niveau de fiabilité atteint.

Les valeurs que nous ne reconnaissons pas (ex. l'état « M/NM »)

Si votre CSV utilise des graphies inhabituelles — M/NM, EX-NM, proxy, etched-holo, Anglais — nous gérons automatiquement les variantes courantes. Pour tout ce que nous ne reconnaissons pas, il vous sera demandé de choisir la valeur CardNexus correspondante une seule fois, et nous appliquerons votre choix à chaque ligne contenant la même valeur brute. Pas besoin de les corriger une par une.

Quand vous avez terminé

Le pied de page affiche une indication s'il manque quelque chose :

• « Mappez un identifiant pour continuer » — vous n'avez mappé aucune des colonnes ID externe / Numéro d'impression / Nom.

• « Mappez X champs requis pour continuer » — des attributs requis pour ce jeu n'ont toujours pas de colonne mappée ni de valeur par défaut.

• « Résolvez X avertissements pour continuer » — certaines valeurs de votre CSV (ex. une graphie d'état inhabituelle) attendent encore que vous choisissiez la valeur CardNexus correspondante.

Une fois que tout est au vert, cliquez sur Valider et continuer.

Étape 3 — Vérifier les résultats et corriger les erreurs

Nous vérifions maintenant chaque ligne par rapport au catalogue CardNexus. La plupart des lignes ressortent généralement Valides et prêtes. Les autres sont regroupées par erreur, pour que vous puissiez en corriger beaucoup à la fois.

Quatre compteurs s'affichent en haut :

• Lignes totales — le nombre de lignes de votre fichier.

• Valides et prêtes — les lignes que nous pouvons importer telles quelles.

• Erreurs restantes — les lignes qui attendent encore une décision de votre part.

• Exclues — les lignes que vous avez choisi d'ignorer.

Deux façons de corriger les erreurs

• Grouper par erreur (par défaut) — regroupe les erreurs identiques (ex. les 47 lignes qui ont écrit l'extension « Alfa » au lieu de « Alpha » apparaissent comme un seul groupe ; corrigez une fois, tout est corrigé). C'est le moyen le plus rapide de nettoyer un gros fichier.

• Toutes les lignes invalides — une liste à plat, ligne par ligne, si vous préférez traiter chaque cas individuellement.

Basculez de l'une à l'autre avec les boutons de la barre d'outils.

Les erreurs que vous pouvez rencontrer

Extension invalide

Ces noms d'extension ne correspondent à aucune extension de notre catalogue. Choisissez la correspondance la plus proche parmi nos suggestions.

Vous avez écrit « Stellr Crown » — nous vous suggérerons « Stellar Crown ». Cliquez sur la suggestion pour corriger toutes les lignes d'un coup. Si aucune suggestion ne convient, votre CSV fait peut-être référence à une extension que nous ne prenons pas encore en charge — excluez ces lignes pour le moment.

Carte introuvable

Nous n'avons pas trouvé ces cartes dans notre catalogue. Vérifiez le nom et le numéro d'impression, ou supprimez ces lignes.

La combinaison nom + numéro d'impression n'existe pas pour cette extension. Les causes les plus fréquentes :

• Une faute de frappe dans le nom ou le numéro de la carte.

• Une mauvaise extension mappée à l'étape précédente.

• La carte appartient à une extension qui n'est pas encore dans notre catalogue.

Vous pouvez modifier la ligne manuellement (une fenêtre de recherche s'ouvre — choisissez la bonne carte dans CardNexus), ou l'exclure.

Plusieurs correspondances trouvées

Plusieurs cartes correspondent à ce nom. Choisissez l'impression précise voulue.

Une carte de ce nom existe en plusieurs impressions (extensions différentes, illustrations alternatives, promos…). Nous listons chaque impression en suggestion — choisissez-en une. Si de nombreuses lignes présentent la même ambiguïté, Corriger X lignes applique le même choix à tout le groupe.

Langue non disponible

Ces cartes existent mais n'ont pas été imprimées dans la langue demandée. Choisissez une langue disponible ou excluez les lignes.

La carte existe, mais pas dans la langue que vous avez indiquée. Nous affichons toutes les langues dans lesquelles elle a été imprimée — choisissez-en une et nous mettrons à jour toutes les lignes concernées.

Finition non disponible

Ces cartes n'ont pas été imprimées avec la finition demandée. Choisissez une finition disponible ou excluez les lignes.

Même principe : la carte n'existe pas en « Foil » (par exemple), mais uniquement en Non-foil. Choisissez une finition qui existe, ou excluez.

Entrée en double

Plusieurs lignes correspondent à la même carte. Cliquez sur Fusionner pour additionner leurs quantités en une seule entrée.

Plusieurs lignes décrivent exactement la même carte (même impression, langue, état, finition). Fusionner additionne les quantités en une seule entrée — c'est généralement ce que vous voulez. Vous pouvez aussi ne conserver que la première ou la dernière occurrence.

Invalid vendor ID type

These rows use a vendor ID that doesn't apply to this game.

Vous avez choisi, par exemple, « Cardmarket ID » comme type d'ID à l'étape 2, mais ce jeu n'est pas vendu sur Cardmarket. Revenez à l'étape 2 et choisissez le bon type (ou excluez ces lignes).

Autres actions

• Exclure la ligne — ignorer uniquement cette ligne.

• Exclure (bouton en bas d'un groupe) — ignorer toutes les lignes du groupe. Utile pour « ces 200 cartes ne sont pas encore sur CardNexus — on s'en occupera plus tard ».

• Annuler ma correction — chaque correction affiche un lien d'annulation au cas où vous changeriez d'avis.

• Télécharger le fichier d'erreur — en cours de route, vous pouvez télécharger un CSV contenant uniquement les lignes invalides avec le libellé de leur erreur. Pratique si vous préférez les corriger dans votre tableur et les réimporter plus tard.

Vendre vos cartes au moment de l'import

Si vous avez ouvert l'importateur via List for sale via CSV, deux choses changent :

1. Une colonne Prix devient obligatoire à l'étape de mappage.

2. Chaque carte importée est créée et mise en vente en une seule fois, au prix indiqué dans le CSV, dans la devise de votre profil vendeur.

Nous acceptons de nombreux formats de prix — 12.50, 12,50, 12,50 €, $12.50 fonctionnent tous. Nous ne convertissons pas les devises ; la valeur est reprise telle quelle dans votre devise active.

💡 Bon à savoir : un profil vendeur vérifié est nécessaire pour utiliser List for sale via CSV. Si vous n'avez pas encore terminé la vérification vendeur, faites-le d'abord — puis revenez ici.

⚠️ Les annonces sont créées immédiatement à la fin de l'import. Si vous souhaitez vérifier les prix avant leur mise en ligne, importez d'abord sans prix, puis utilisez la mise en vente en masse depuis votre inventaire.

Dernière étape

Cliquez sur Importer les éléments valides quand vous êtes prêt. Une fenêtre de confirmation résume ce qui va se passer :

• Combien de lignes seront importées.

• Combien de lignes vous avez choisi d'exclure.

• Combien de lignes invalides seront ignorées.

• Combien de lignes n'ont pas pu être lues du tout (identifiant ou quantité manquant).

Confirmez, et nous ajoutons tout à votre inventaire. Vous serez redirigé vers votre inventaire (ou votre liste) une fois l'opération terminée.

FAQ

L'import va-t-il dupliquer des lignes qui existent déjà dans mon inventaire ? Oui — chaque ligne du CSV ajoute de la quantité à votre inventaire. Si vous possédez déjà trois exemplaires d'une carte et que votre CSV en contient deux de la même impression/langue/état/finition, vous en aurez cinq. Utilisez la fusion des doublons pour combiner au sein d'un même import ; la déduplication entre imports, elle, reste à votre charge.

Puis-je télécharger à nouveau le même fichier après l'avoir corrigé ? Absolument. Chaque téléchargement démarre une session vierge — votre mappage et vos corrections précédents sont réinitialisés.

Mon CSV est énorme (plusieurs centaines de milliers de lignes). Est-ce que cela fonctionnera ? Jusqu'à 500 000 lignes dans un seul fichier, oui. Au-delà, divisez le fichier (votre tableur peut généralement le faire avec un filtre ou en enregistrant par morceaux).

CardNexus conserve-t-il mon fichier CSV d'origine ? Non. Votre fichier reste dans votre navigateur pendant le mappage et la correction des erreurs, et seules les cartes que vous importez réellement sont enregistrées sur votre compte. Si vous fermez l'onglet avant la fin, rien n'est conservé.

Je vois l'avertissement « Nous ne pouvons pas encore reconnaître vos cartes ». Que faire ? Vous n'avez mappé aucune colonne ID externe, Numéro d'impression ou Nom — il nous en faut au moins une pour identifier une carte. Revenez à l'étape 2 et mappez l'une de ces trois colonnes (un ID externe est l'idéal si vous en avez un).

Mon import a partiellement réussi — certaines lignes sont passées, d'autres non. Que faire maintenant ? C'est rare, et cela traduit généralement un incident temporaire de notre côté. Ouvrez votre inventaire pour vérifier quelles lignes ont été importées, puis téléchargez un nouveau CSV ne contenant que les lignes manquantes. Si le problème persiste, contactez le support.

Puis-je importer directement un CSV exporté depuis TCGPlayer / Manabox / Dragon Shield ? Oui — c'est le cas d'usage le plus courant. La détection automatique devrait associer la plupart des colonnes. Si quelques-unes ne sont pas reconnues, mappez-les simplement à la main à l'étape 2.

Et Cardmarket ? Cardmarket ne propose pas d'export CSV de votre stock via son site — seuls les vendeurs disposant d'un accès API peuvent récupérer leur stock par programmation. Si vous avez obtenu un CSV de cette façon (ou si vous l'avez construit à la main à partir de vos données Cardmarket), l'importateur le lira comme n'importe quel autre CSV — et mapper la colonne ID externe sur Cardmarket ID nous donne la correspondance la plus précise.