Guide d'importation pour les téléchargements CSV

Last updated: November 13, 2026

Sur la plateforme Coolset, vous pouvez télécharger les éléments suivants en masse à l’aide d’un téléchargement csv :

  • Produits,

  • Fournisseurs,

  • Articles de commande (commandes d'achat ou de vente)

  • Origines.

Avant de commencer

Chaque catégorie possède ses propres colonnes obligatoires et types de données.
Il est important de utiliser les noms de colonnes exacts et saisir les types de données corrects comme indiqué dans le modèle ou le tableau fourni ci‑dessous.

Vous pouvez soit :

  • Créer votre propre fichier CSV en suivant la structure requise, ou

  • Télécharger un modèle préformaté directement depuis la plateforme.

Téléchargement du modèle

  1. Dans la plateforme Coolset, sélectionnez la catégorie que vous souhaitez télécharger.

  2. Cliquez sur « Import » dans le coin supérieur droit.

  3. Téléchargez le modèle CSV fourni pour cette catégorie.

Screenshot 2025-10-09 at 16.37.11.png

Ouverture du modèle CSV dans Microsoft Excel

Le modèle est un .csv fichier.
Pour l’ouvrir avec les colonnes correctement affichées dans Excel :

  1. Ouvrez Microsoft Excel.

  2. Allez dans l’onglet Données.

  3. Cliquez sur Obtenir des données → Depuis le texte/CSV.

  4. Sélectionnez votre fichier modèle téléchargé et chargez les données.

Votre fichier apparaîtra désormais dans une structure de colonnes claire.

Screenshot 2025-10-09 at 16.39.40.png

Remplissage du modèle

Lors du remplissage du modèle (ou de la création du vôtre), suivez les tableaux à la fin de cette page pour vous guider :

  • Nom de colonne – Les noms exacts à utiliser pour les colonnes de votre fichier.

  • Type de données – Le format des données attendues dans chaque colonne (par ex., texte, nombre).

  • Description – Explique quelles informations fournir.

  • Obligatoire – Indique si la colonne doit être remplie pour un téléchargement réussi.

Téléchargement de votre fichier CSV

Une fois votre fichier CSV prêt :

  1. Accédez à l’élément que vous souhaitez télécharger.

  2. Cliquez sur « Import » dans le coin supérieur droit.

  3. Glissez‑déposez votre fichier dans la zone de téléchargement, ou cliquez sur la case pour parcourir votre ordinateur.

  4. Une fois votre fichier sélectionné, cliquez sur « Import » pour démarrer le téléchargement.

Avant le téléversement, vérifiez deux éléments :

  • Enregistrez le fichier au format CSV UTF-8. Coolset peut uniquement lire les fichiers CSV enregistrés avec l’encodage UTF-8. Excel enregistre souvent les fichiers CSV dans un format régional à la place, ce qui constitue la raison la plus courante d’un échec de téléversement. Dans Excel, accédez à Fichier → Enregistrer sous et choisissez CSV UTF-8 (délimité par des virgules) (.csv) comme type de fichier.

  • Une erreur interrompt l’intégralité du téléversement. Si une ligne de votre fichier contient une erreur, rien dans le fichier n’est importé, y compris les lignes correctes. Corrigez la ligne qui a échoué et téléversez à nouveau l’intégralité du fichier.

  • Que se passe-t-il lorsque je téléverse à nouveau le même fichier ? Une réimportation met à jour les enregistrements existants et en ajoute de nouveaux. Elle ne supprime jamais rien. Coolset associe chaque ligne à un enregistrement existant à l’aide de son external_id.

Screenshot 2025-10-09 at 16.51.46.png

Colonnes requises et descriptions

Produits

Nom de colonne

Type de données

Description

Obligatoire

external_id

texte

Identifiant unique du produit provenant de votre système externe (par ex. ERP, CRM). Utilisé pour relier les données entre les systèmes.

TRUE

name

texte

Nom du produit.

TRUE

description

texte

Informations descriptives supplémentaires sur le produit.

FALSE

hs_code

Nombre entier de 6 chiffres maximum (sans décimales)

Code du Système harmonisé (SH) identifiant le produit pour la classification douanière.

TRUE

commodity

texte

Catégorie de marchandise à laquelle appartient le produit (par ex. cattle, cocoa, coffee, palm_oil, rubber, soya et wood).

TRUE

scientific_name

texte

Nom scientifique de l'espèce. Obligatoire uniquement pour les produits à base de bois.

FALSE

common_name

texte

Nom commun (non scientifique) de l'espèce. Obligatoire uniquement pour les produits à base de bois.

FALSE

sku

texte

Unité de gestion des stocks (SKU) du produit.

TRUE

type

texte

Indique si le produit est fabriqué, acheté ou produit.

TRUE

bill_of_materials

texte

Liste séparée par des virgules des external_ids des produits qui composent la nomenclature de ce produit (s'il est fabriqué).

FALSE

Fournisseurs

Nom de la colonne

Type de données

Description

Obligatoire

external_id

texte

Identifiant unique provenant de votre ERP ou CRM

TRUE

company_name

texte

Nom légal du fournisseur

TRUE

description

texte

Remarques facultatives concernant le fournisseur

FALSE

country_code

texte (2 caractères)

Code ISO 3166-1 alpha-2 (par ex. NL, DE)

TRUE

is_self_managed

TRUE ou FALSE

Définissez sur TRUE si vous effectuez une auto-déclaration au nom de ce fournisseur

FALSE

contact_name

texte

Personne de contact principale, laissez vide en cas d’autogestion

FALSE

contact_email

texte

Adresse e-mail de contact utilisée pour les invitations, laissez vide en cas d’autogestion

FALSE

additional_contact_emails

texte

Adresses e-mail supplémentaires à inviter chez le même fournisseur, en plus du contact principal.

FALSE

type

texte

Type de partenaire de la chaîne de valeur. Renseignez toujours "supplier"

TRUE

Articles de commande

Nom de la colonne

Type de données

Description

Obligatoire

external_id

texte

Identifiant unique de l’article de commande provenant de votre système externe (par ex. ERP, CRM). Utilisé pour relier les données entre les systèmes.

TRUE

action

texte

Type d’activité pour cette commande. L’action est soit 'buying', soit 'selling'.

TRUE

border_cross_country_code

texte

Code du pays de l’UE où les marchandises entrent dans l’UE ou en sortent, c’est-à-dire NL, DE.

TRUE

order_external_id

texte

Identifiant de la commande associée. Tous les articles appartenant à la même commande partagent cet identifiant.

TRUE

order_created_at

date

Date de création de la commande (format : YYYY-MM-DD).

TRUE

order_arrival_at

date

Date à laquelle la commande devrait arriver (format : YYYY-MM-DD).

FALSE

value_chain_external_id

texte

Identifiant externe du fournisseur (correspondant à l’external_id du fournisseur lors de l’importation des fournisseurs).

TRUE

buyer_product_external_id

texte

Identifiant externe du produit (correspondant à l’external_id du produit lors de l’importation des produits).

TRUE lorsque l’action est buying

seller_product_external_id

texte

Identifiant externe du produit (correspondant à l’external_id du produit lors de l’importation des produits).

TRUE lorsque l’action est selling

volume

Un nombre avec décimales

Quantité de produit incluse dans l’article de commande.

TRUE

unit

texte (3 caractères maximum)

Unité de mesure du produit : kg.

TRUE

Origines

Nom de colonne

Type de données

Description

Obligatoire

external_id

texte

Identifiant unique provenant de votre système externe (par ex. ERP, CRM). Utilisé pour relier les données entre les systèmes.

FALSE

name

texte

Nom lisible par l'utilisateur de la zone ou de l'origine

TRUE

description

texte

Texte facultatif décrivant l'origine

FALSE

country_code

texte (2 caractères max.)

Code ISO 3166-1 alpha-2 (p. ex. NL, FR, US)

TRUE

coordonnées

texte

(format GeoJSON)

Tableau de coordonnées dans l’ordre [longitude, latitude] ; peut représenter un point ou la limite d’un polygone.

TRUE