.png?width=100&height=47&name=byrd_logo_classic_transparent%20(3).png){kind=logo}
Il est possible d’importer des produits via un fichier CSV dans notre tableau de bord client.
Pour accéder à cette option, il vous suffit de cliquer sur le bouton « Nouveau produit » sur la page « Inventaire » (comme auparavant pour créer un produit via le formulaire de création) :
Par défaut, l’option « Import CSV » est sélectionnée. Toutefois, si vous souhaitez créer le produit via notre formulaire, vous pouvez toujours le faire en sélectionnant l’onglet « Manuel » :
Une fois le fichier complété avec tous les produits à importer, il vous suffit de déposer le fichier CSV dans la zone en pointillés sur la page ou de cliquer dessus pour ouvrir l’explorateur de fichiers.
Voici une description des colonnes / en-têtes pris en charge dans le fichier CSV.
| En-tête / champ | Exemple | Description / valeurs possibles |
|---|---|---|
| SKU | sku-a | Identifiant SKU tel que dans la boutique e-commerce. (Champ obligatoire) |
| name | prod-a | Nom du produit. (Champ obligatoire) |
| netValue | 1.01 | Coût du produit auprès du fournisseur. (Champ obligatoire) |
| organic | FALSE | Indique s’il s’agit d’un produit biologique ou non (stockage spécial requis). Accepte TRUE/FALSE. |
| lotsEnabled | FALSE | Indique si les lots doivent être suivis lors de la réception et de l’expédition de ce produit. Accepte TRUE/FALSE. |
| fragile | TRUE | Indique s’il s’agit d’un produit fragile nécessitant un emballage supplémentaire. Accepte TRUE/FALSE. |
| description | example description of product a | Description du produit. |
| barcode | ABC-abc-1234 | Un code-barres unique, qui devient le code-barres principal du produit. Accepte des chiffres et des caractères, jusqu’à 48, selon le type de code-barres sélectionné. Pour définir plusieurs codes-barres, utilisez plutôt barcodes. |
| barcodeType | code_128 | Type du code-barres. Accepte « ean_13 », « code_128 », « gs1_128 », « qr_code ». S’applique à tous les codes-barres de la ligne et vaut « code_128 » par défaut lorsqu’il est laissé vide. |
| barcodes | ABC-abc-1234|ABC-abc-5678 | Un ou plusieurs codes-barres pour le produit, séparés par une barre verticale ( | ). Le premier de la liste devient le code-barres principal. Jusqu’à 25 par produit, chacun jusqu’à 48 caractères. |
| reorderPoint | 10 | Le niveau de stock en dessous duquel le produit est signalé dans l’e-mail de notification quotidien (s’il est activé). |
| customsTariffNumber | 111111 | Numéro de tarif douanier. Accepte uniquement des chiffres d’une longueur de 6, 8 ou 10. |
| originCountryCode | DE | Code pays à deux lettres de l’origine du produit. |
| weight | 0.25 | Poids du produit tel qu’envoyé à l’entrepôt. |
Remarque : seules les 3 premières colonnes sont obligatoires, toutes les autres sont facultatives. Toutefois, dans la version actuelle, si une colonne est incluse dans le fichier CSV, le système attend qu’elle contienne des données valides, et l’import n’est pas autorisé si elle est vide (cela sera modifié dans une version ultérieure).
Utiliser plusieurs codes-barres
Un produit peut porter plusieurs codes-barres. C’est utile lorsque vous modifiez un code-barres en production et que l’ancien et le nouveau doivent fonctionner en même temps, sur l’ensemble de votre catalogue.
Indiquez-les tous dans une seule cellule barcodes, séparés par une barre verticale ( | ) :
| SKU | name | netValue | barcode | barcodeType | barcodes |
|---|---|---|---|---|---|
| sku-a | prod-a | 1.01 | code_128 | ABC-abc-1234|ABC-abc-5678 |
Avant l’import : une cellule barcodes vide est une instruction, pas une absence de valeur. Elle nous indique que le produit ne doit avoir aucun code-barres. Si vous importez un fichier pour modifier un élément sans rapport, comme les noms ou les prix, retirez la colonne barcodes du fichier plutôt que de laisser ses cellules vides.
Ce qu’il advient des codes-barres existants d’un produit
La colonne barcodes fait foi. Après l’import, le produit possède exactement les codes-barres indiqués dans votre fichier et aucun autre : tout ce qu’il possédait auparavant et qui ne figure pas dans votre fichier est supprimé.
L’ancienne colonne barcode se comporte différemment, afin que le fait de réimporter un fichier créé avant l’existence de cette fonctionnalité ne supprime pas discrètement des codes-barres que vous avez ajoutés depuis.
| Ce que contient votre fichier | Résultat |
|---|---|
| Une colonne barcodes, avec des valeurs | Le produit se retrouve avec exactement les codes-barres que vous avez indiqués. Tous les autres sont supprimés. |
| Une colonne barcodes laissée vide, barcode renseigné | Le produit se retrouve avec ce seul code-barres. Tous les autres sont supprimés. |
| Une colonne barcodes laissée vide, barcode également vide | Tous les codes-barres du produit sont supprimés. |
| Aucune colonne barcodes, barcode renseigné | Cette valeur devient le code-barres principal. Les autres codes-barres du produit sont conservés. |
| Aucune colonne barcodes, ni barcode | Les codes-barres du produit restent exactement tels quels. |
Pour supprimer volontairement tous les codes-barres d’un produit, incluez la colonne barcodes et laissez cette colonne ainsi que barcode vides pour cette ligne.
Bon à savoir
- Le premier code-barres que vous indiquez devient le code-barres principal. C’est celui qui apparaît comme code-barres principal du produit dans le tableau de bord. L’ordre des autres n’a pas d’importance.
- barcodeType s’applique à tous les codes-barres de la ligne, et non à des valeurs individuelles. Laissez-le vide et ils sont tous traités comme code_128.
- Renseignez soit barcode, soit barcodes, mais pas les deux. Si vous renseignez les deux et qu’ils ne correspondent pas, la ligne est rejetée. Les deux colonnes sont deux façons d’exprimer la même chose, et barcodes est celle qui prend en charge plusieurs valeurs.
- Chaque code-barres peut comporter jusqu’à 48 caractères, et un produit peut en avoir jusqu’à 25.
Pourquoi une ligne comportant des codes-barres peut échouer
En plus de la validation habituelle, une ligne est rejetée si :
- barcode et barcodes sont tous deux renseignés et se contredisent.
- le même code-barres est indiqué deux fois dans une ligne.
- plus de 25 codes-barres sont indiqués dans une ligne.
- un code-barres dépasse 48 caractères.
- barcodeType est ean_13 mais une valeur n’est pas un numéro EAN-13 valide. Les codes-barres EAN-13 sont vérifiés chiffre par chiffre, de sorte qu’une faute de frappe est détectée ici.
- un code-barres d’unité d’emballage dans la même ligne est identique à l’un des codes-barres du produit.
Comme pour toute autre erreur, le reste du fichier est tout de même importé, et vous pouvez utiliser « Afficher uniquement les erreurs » pour trouver les lignes à corriger.
Quels sont les champs obligatoires dans le CSV pour créer un produit ?
Les champs obligatoires sont SKU, name et netValue. Ils doivent être présents et remplis dans le fichier pour que celui-ci soit accepté. Tous les autres champs sont facultatifs et le produit sera créé avec ces champs vides ou avec leur valeur par défaut (par exemple, FALSE).
Lorsque vous téléchargez un fichier CSV contenant toutes les informations correctes du produit, notre système indique que tous les produits ont passé la validation et sont prêts à être importés.
Une fois que vous cliquez sur le bouton « Créer des produits », les nouveaux SKU sont ajoutés à la liste « Inventaire ».
Si un produit existant possède la même SKU, ses détails sont écrasés par les informations fournies dans le CSV, car il n’est pas possible d’avoir deux produits avec le même champ SKU.
Si votre fichier comporte une colonne barcodes, cela inclut le remplacement des codes-barres du produit par exactement ceux que vous indiquez.
Si certains produits ne passent pas nos validations, le système indique quels produits comportent des erreurs, la numérotation correspondant à l’ordre des produits dans le fichier CSV.
Vous pouvez également décider de n’importer que les produits qui passent la validation, en cliquant sur « Créer des produits », ou bien cliquer sur le bouton « Annuler » et réessayer avec le fichier corrigé.
Vous pouvez sélectionner l’option « Afficher uniquement les erreurs » pour masquer tous les SKU valides et n’afficher que ceux qui comportent des erreurs, afin de trouver plus facilement ce qui doit être modifié.
Si aucun des produits du fichier CSV ne passe nos validations, vous ne pourrez que cliquer sur le bouton « Réessayer » et télécharger un nouveau fichier avec les erreurs corrigées.
Le bouton « Réessayer » permet de télécharger un nouveau fichier :
Un message d’erreur s’affiche si le fichier CSV ne contient pas l’un des 3 champs obligatoires :
Pour le moment, l’outil d’import ne prend en charge que les fichiers CSV comportant au maximum 100 produits. Si vous devez importer plus de 100 produits, il sera nécessaire de les répartir dans des fichiers distincts. Sinon, le tableau de bord affichera le message d’erreur suivant :
Pour toute autre question, n’hésitez pas à contacter notre équipe de gestion de compte, qui se fera un plaisir de vous aider.