Importer votre inventaire depuis un CSV

Transformez un tableur venu de TCGplayer, Manabox, Dragon Shield ou de votre propre tracker en inventaire CardNexus en trois étapes guidées — et mettez tout en vente au passage si vous le souhaitez.

Dernière mise à jour Il y a 23 jours

Vous avez un tableur de cartes — exporté depuis TCGplayer, Manabox, Dragon Shield, une marketplace ou votre propre tracker 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 parcourt chaque étape, chaque message que vous pourriez voir, et la façon de le résoudre.

Où trouver l'importateur CSV

Pour ajouter des cartes à votre inventaire — depuis votre inventaire, choisissez Ajouter des cartes et sélectionnez l'option CSV.
Pour ajouter des cartes à une liste — ouvrez la liste, puis Ajouter des produits et choisissez CSV.
Pour ajouter des cartes à un import en masse déjà commencé — ouvrez l'import, puis Importer un CSV.
Pour importer et mettre vos cartes en vente en même temps — depuis votre inventaire, utilisez Mettre en vente et choisissez CSV. Le jeu vous sera demandé en premier.

Vous choisissez toujours le jeu avant d'envoyer votre fichier, et un fichier correspond à un jeu. Si votre tableur mélange plusieurs jeux, découpez-le en un fichier par jeu.

Avant de commencer

Il vous faut :

Un fichier .csv. La plupart des tableurs et des outils de cartes à collectionner peuvent en exporter un — dans Excel ou Numbers, utilisez Fichier → Enregistrer sous → CSV.
Au moins un moyen d'identifier chaque carte : un ID CardNexus, un ID externe (Cardmarket, TCGplayer, Scryfall…), un numéro d'impression ou le nom de la carte.
Une quantité pour chaque ligne.

Pas encore de fichier ? À l'étape 1, cliquez sur Modèle CSV pour obtenir un CSV prêt à l'emploi, avec les bons intitulés de colonnes et quelques lignes d'exemple déjà remplies pour le jeu choisi. Complétez-le et renvoyez-le.

Un profil vendeur vérifié est nécessaire pour utiliser la version « mise en vente » de l'importateur. Si vous n'avez pas encore terminé la vérification vendeur, commencez par là.

Étape 1 — Envoyez votre fichier

Ouvrez l'importateur depuis l'un des points d'entrée ci-dessus.
Glissez votre fichier sur la zone d'envoi, ou cliquez pour le sélectionner.
Patientez quelques secondes. Un fichier classique de 1 000 lignes est instantané ; les très gros fichiers peuvent prendre jusqu'à une minute.

Quelle taille mon fichier peut-il faire ?

Destination de l'import	Taille maximale	Nombre de lignes maximum
Dans votre inventaire, une liste, ou en vente	250 Mo	500 000 lignes
Dans un import en masse déjà commencé	30 Mo	30 000 lignes

Au-delà de 2 000 lignes, l'import s'exécute en arrière-plan et une fenêtre de progression s'affiche — vous n'avez pas besoin de garder la page ouverte d'une manière particulière.

Les messages possibles à cette étape

Ce que nous affichons	Ce que cela signifie	Comment le résoudre
Le fichier est vide	Le fichier ne contient aucun contenu.	Réexportez-le depuis votre outil d'origine.
La première ligne ne contient aucun nom de colonne	Votre CSV n'a pas de ligne d'en-tête.	Ajoutez une ligne d'en-tête (par exemple Nom, Extension, Quantité, État) et renvoyez le fichier.
Le CSV ne contient qu'un en-tête — ajoutez au moins une ligne de données	Vous n'avez envoyé que les intitulés de colonnes.	Ajoutez au moins une carte et renvoyez le fichier.
Votre fichier dépasse la limite de lignes	Trop de lignes pour cette destination.	Découpez-le en fichiers plus petits et importez-les les uns après les autres.
Fichier trop volumineux	Le fichier lui-même est trop lourd.	Découpez-le, ou supprimez les colonnes inutiles avant d'exporter.
Type de fichier non pris en charge. Veuillez envoyer un fichier .csv	Nous ne lisons que les fichiers .csv.	Enregistrez votre tableur au format CSV et renvoyez-le.
Nous n'avons pas pu lire le fichier	Le fichier est endommagé, ou utilise un encodage que nous ne savons pas lire.	Ouvrez-le dans un tableur et enregistrez-le en CSV UTF-8.

Étape 2 — Associez les colonnes

C'est ici que vous indiquez à CardNexus ce que signifie chaque colonne de votre tableur. Nous en détectons la plupart pour vous — une colonne « Qty » devient Quantité, « Set Name » devient Extension — mais vous pouvez modifier chacune de nos propositions.

Les colonnes sont réparties en deux groupes : Identifiant du produit (comment nous reconnaissons la carte) et Détails du produit (tout le reste).

Les identifiants — comment nous reconnaissons chaque carte

Vous devez associer au moins un identifiant. Ils ne se valent pas tous, et un bandeau en haut de l'étape vous indique notre niveau de confiance dans le choix que vous avez fait.

Identifiant	Quelle fiabilité	De quoi il s'agit
ID CardNexus	Parfait — une correspondance exacte à chaque fois	Notre propre numéro de produit. Il figure dans tous les exports CardNexus : réimporter un fichier que vous avez exporté chez nous fonctionne donc parfaitement.
ID externe	Excellent	Un code produit issu d'une autre plateforme : Cardmarket, TCGplayer, Scryfall, et d'autres selon le jeu. Vous choisissez également son type dans un menu déroulant. Un ID externe est recherché sur l'ensemble du jeu : un nom d'extension erroné ou manquant ne cassera donc pas la ligne.
Numéro d'impression (avec le nom de la carte ou l'extension)	Bon	Le numéro imprimé sur la carte, comme 223/264, EN001 ou 12a.
Nom seul	Risqué	Beaucoup de cartes partagent un nom entre extensions et impressions. Attendez-vous à des « Plusieurs correspondances trouvées » à l'étape 3, que vous devrez résoudre à la main.

Les autres colonnes

Colonne	De quoi il s'agit	Exemples
Quantité	Le nombre d'exemplaires. Obligatoire, et ce doit être un nombre entier supérieur à zéro.	1, 4, 10
Extension	L'extension à laquelle appartient la carte. Le nom comme le code fonctionnent.	Alpha, Stellar Crown, M10
Finition	Le traitement foil.	Foil, Standard, Reverse Holo, Etched, Cold Foil
État	L'état de la carte.	Near Mint, NM, LP, Lightly Played
Langue	La langue d'impression.	English, EN, Japanese, Français
Variante (seulement sur certains jeux)	Les styles alternatifs.	Extended Art, Borderless, Full Art
Emplacement	L'endroit où vous rangez l'article. Les nouveaux emplacements sont créés automatiquement.	Classeur A, Boîte 3
Tags	Des tags séparés par des virgules. Les nouveaux tags sont créés automatiquement.	Échange, Favoris
Commentaire	Un commentaire public, affiché aux acheteurs lorsque l'article est mis en vente.	Léger frottement sur le bord au dos
Note interne	Une note privée pour vous. Jamais montrée aux acheteurs.	Acheté dans ma boutique de jeux
Prix (uniquement lors d'un import en vente)	Le prix auquel vous souhaitez vendre chaque exemplaire.	12.50, 12,50, 12,50 €

Si une colonne est absente de votre fichier, vous avez trois possibilités :

Associer une colonne de votre CSV — le cas normal.
Définir une valeur par défaut pour toutes les lignes — appliquer la même valeur à chaque ligne. Idéal quand tout ce que vous importez est, par exemple, en anglais et Near Mint.
Ne rien indiquer — possible uniquement pour les colonnes qui ne sont pas obligatoires.

Si vous n'associez rien pour l'État, la Finition ou la Langue, nous retenons par défaut Near Mint, Standard et Anglais.

Et si mon fichier écrit les choses autrement ?

Nous comprenons déjà la plupart des écritures courantes : NM, M/NM, Lightly Played, LP, EX, foil, holo, non-foil, EN, Anglais, 日本語 et bien d'autres. Pour tout ce que nous ne reconnaissons pas, nous vous demandons de choisir la valeur CardNexus correspondante une seule fois, et nous appliquons votre choix à toutes les lignes qui utilisaient la même écriture. Vous n'avez jamais à les corriger une par une.

Avant de pouvoir continuer

Le pied de page vous indique ce qui manque encore :

« Associez un identifiant pour continuer » — vous n'avez associé ni ID CardNexus, ni ID externe, ni numéro d'impression, ni nom de carte.
« Associez X champs obligatoires pour continuer » — une colonne obligatoire n'a encore ni association ni valeur par défaut.
« Résolvez X valeurs non associées pour continuer » — certaines écritures de votre fichier attendent encore que vous choisissiez la valeur CardNexus correspondante.

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

Étape 3 — Vérifiez le résultat et corrigez ce qui ne va pas

Nous confrontons alors chaque ligne au catalogue CardNexus. La plupart des lignes reviennent normalement en Valides et prêtes ; les autres sont regroupées pour que vous puissiez en corriger beaucoup d'un coup.

Trois compteurs figurent en haut : Lignes totales, Valides et prêtes et Erreurs restantes.

Vous disposez aussi de deux façons de traiter les problèmes, au choix dans la barre d'outils :

Grouper par erreur (par défaut) — les problèmes identiques sont regroupés. Si 47 lignes ont écrit l'extension « Alfa » au lieu de « Alpha », elles apparaissent comme un seul groupe : corrigez une fois, les 47 sont corrigées. C'est de loin la façon la plus rapide de nettoyer un gros fichier.
Toutes les lignes invalides — une liste à plat, avec recherche, si vous préférez procéder ligne par ligne.

Les problèmes que vous pouvez rencontrer

Extension invalide — Ces noms d'extension ne correspondent à aucune extension de notre catalogue. Vous avez écrit « Stellr Crown », nous proposons « Stellar Crown ». Cliquez sur la suggestion pour corriger toutes les lignes concernées d'un coup. Si rien ne convient, l'extension n'est peut-être pas encore dans notre catalogue — excluez ces lignes pour le moment.

Carte introuvable — Nous n'avons pas trouvé ces cartes dans notre catalogue. La combinaison nom + numéro d'impression n'existe pas pour cette extension. En général une faute de frappe, une mauvaise extension associée à l'étape 2, ou une extension que nous ne proposons pas encore. Vous pouvez examiner la ligne et choisir la bonne carte à la main, ou l'exclure.

Plusieurs correspondances trouvées — Plusieurs cartes correspondent à ce nom. Le nom existe dans plusieurs impressions — extensions différentes, illustrations alternatives, promos. Nous listons les impressions (jusqu'à 25) pour que vous puissiez choisir. Si plusieurs lignes partagent la même ambiguïté, Tout corriger applique votre choix à l'ensemble du groupe.

Langue non disponible — Ces cartes n'ont pas été imprimées dans la langue demandée. La carte existe, mais pas dans cette langue. Nous vous montrons toutes les langues dans lesquelles elle a réellement été imprimée — choisissez-en une et nous mettons à jour toutes les lignes concernées.

Finition non disponible — Ces cartes n'ont pas été imprimées dans la finition demandée. Même principe : la carte n'existe pas en Foil, seulement en Standard, par exemple. Choisissez une finition disponible ou excluez les lignes.

Entrée en double — Plusieurs lignes correspondent à la même carte. Plusieurs lignes décrivent exactement la même chose : même impression, même langue, même état, même finition, même emplacement de rangement et mêmes tags. Fusionner additionne leurs quantités en une seule entrée, ce qui est généralement ce que vous voulez. Les lignes qui ne diffèrent que par l'emplacement ou les tags ne sont pas considérées comme des doublons : vous pouvez donc garder une ligne par classeur.

Invalid vendor ID type (ce libellé n'est pas encore traduit) — Ces lignes utilisent un type d'ID externe qui n'est pas configuré pour ce jeu. Vous avez choisi, par exemple, Cardmarket comme type d'ID externe, mais ce jeu n'est pas vendu sur Cardmarket. Revenez à l'étape 2 et choisissez un type qui s'applique au jeu.

Vos autres options

Exclure — ignorer une ligne, une valeur ou un groupe entier. Utile pour « ces 200 cartes ne sont pas encore sur CardNexus, je m'en occuperai plus tard ».
Annuler — chaque correction et chaque exclusion peut être annulée.
Télécharger le fichier d'erreur — télécharger un CSV contenant uniquement les lignes encore en erreur, avec leur libellé d'erreur, pour les retravailler dans votre tableur.

Les lignes écartées sans erreur

Certaines lignes ne peuvent pas être lues du tout et sont mises de côté sans bruit. Cela arrive quand une ligne n'a aucun identifiant, une quantité inutilisable (vide, zéro, décimale ou textuelle), ou — lors d'un import en vente — aucun prix. Le nombre de lignes écartées vous est indiqué dans le récapitulatif, avant que vous ne confirmiez.

Importer et mettre en vente en une seule fois

Si vous avez ouvert l'importateur par le point d'entrée mise en vente, deux choses changent :

Une colonne Prix devient obligatoire.
Chaque ligne crée l'entrée d'inventaire et la met en vente, en une seule opération.

Les prix sont souples : 12.50, 12,50, 12,50 € et $12.50 sont tous compris. Deux points à garder en tête :

Nous ne convertissons pas les devises. Le nombre est repris tel quel, dans la devise de votre profil vendeur. Il n'y a pas de colonne de devise.
N'utilisez pas de séparateur de milliers. Un prix écrit 1,234 est rejeté ; écrivez 1234.

Vos annonces sont en ligne dès la fin de l'import. Si vous souhaitez revoir vos prix avant que les acheteurs ne les voient, importez d'abord sans prix, puis utilisez les outils de mise en vente en masse depuis votre inventaire.

Pour finir

Cliquez sur Importer les éléments valides quand vous êtes prêt. Une fenêtre de confirmation résume exactement ce qui va se passer : combien de lignes seront importées, combien vous en avez exclues, combien de lignes invalides seront ignorées et combien n'ont pas pu être lues.

Confirmez, et vos cartes sont ajoutées. Vous êtes ensuite redirigé vers votre inventaire, votre liste ou votre import — selon votre point de départ.

Si vous importiez dans un import en masse, rien n'est encore dans votre inventaire : vos lignes sont préparées dans l'espace d'import, où vous pouvez encore les ajuster, et elles ne rejoignent votre inventaire qu'au moment où vous validez l'import.

Questions fréquentes

Puis-je importer un fichier exporté depuis TCGplayer, Manabox ou Dragon Shield ? Oui — c'est l'usage le plus courant de l'importateur. Il n'y a pas de bouton dédié à chaque outil : nous lisons vos intitulés de colonnes et en reconnaissons la plupart automatiquement. Ce que nous manquons, vous l'associez à la main à l'étape 2, ce qui prend quelques secondes.

Et Cardmarket ? Cardmarket ne propose pas d'export de stock depuis son site — seuls les vendeurs disposant d'un accès API peuvent extraire leur stock. Si vous avez obtenu un CSV de cette façon, ou si vous en avez construit un à partir de vos données Cardmarket, l'importateur le lit comme n'importe quel autre fichier. Associez la colonne ID externe et choisissez Cardmarket comme type pour la correspondance la plus précise possible.

L'import va-t-il s'ajouter à ce que je possède déjà, ou le remplacer ? Il s'ajoute. Si vous possédez déjà trois exemplaires d'une carte et que votre fichier en contient deux de plus, avec la même impression, la même langue, le même état et la même finition, vous vous retrouvez avec cinq. La fusion des doublons fonctionne à l'intérieur d'un même import ; elle ne compare pas avec ce qui se trouve déjà dans votre inventaire.

Puis-je renvoyer le même fichier après l'avoir corrigé ? Oui. Chaque envoi démarre une session vierge : votre association de colonnes et vos corrections précédentes sont réinitialisées.

Mon fichier est énorme. Est-ce que ça va marcher ? Jusqu'à 500 000 lignes dans un seul fichier. Au-delà, il faut le découper, ce que votre tableur sait généralement faire avec un filtre.

CardNexus conserve-t-il mon fichier d'origine ? Non. Votre fichier reste dans votre navigateur pendant que vous associez les colonnes et corrigez les erreurs, et seules les cartes réellement importées sont enregistrées sur votre compte. Fermez l'onglet avant la fin et rien n'est conservé.

Je vois « Nous ne pouvons pas encore reconnaître vos cartes ». Que faire ? Vous n'avez pas associé d'identifiant. Revenez à l'étape 2 et associez un ID CardNexus, un ID externe, un numéro d'impression ou un nom de carte — un ID CardNexus ou un ID externe dès que vous en avez un.

Puis-je exporter mon inventaire CardNexus et le réimporter ? Oui, et c'est l'aller-retour le plus fiable que nous proposons : nos exports contiennent l'ID CardNexus, la quantité, ainsi que vos emplacements, tags, commentaires et notes, tous reconnus automatiquement au retour.

Mon import n'a réussi qu'en partie — certaines lignes sont passées, d'autres non. C'est rare, et généralement dû à un incident temporaire de notre côté. Vérifiez votre inventaire pour voir quelles lignes sont arrivées, puis envoyez un nouveau fichier contenant uniquement les manquantes. Si cela se reproduit, contactez le support.