Cet article explique comment préparer un fichier d'import pour le scope "produits".

Les enregistrements dans le scope "produits" représentent des articles qui peuvent être achetés. Les «products» sont ensuite liés aux «orders» via les «order lines» (articles individuels dans chaque ticket).

🚧
Notez que les "produits" sont l'un des champs d'application qui peuvent être mis à jour : les données existantes peuvent être modifiées par les imports futurs.

Pré-requis

Connaissance de base du format CSV et de l’encodage UTF-8.
Un éditeur de texte compatible UTF-8.
Un tableur
La sous-séquence doit être définie dans le fichier de configuration dans le scope "products".

Préparer un fichier produit

Vérifiez le fichier que vous préparez pour voir s'il contient toutes les informations que vous souhaitez importer. Utilisez votre tableur pour organiser les colonnes et supprimer celles que vous ne pouvez pas (ou ne souhaitez pas) importer. N'oubliez pas de toujours enregistrer (ou d'exporter) dans un fichier CSV avec le codage UTF-8 et d'utiliser des points-virgules (";") pour séparer les colonnes.

Utilisez votre éditeur de texte préféré pour ouvrir et modifier le fichier d'import CSV.

🚧
Veuillez limiter la taille de votre fichier à 200K lignes.

En-tête et colonnes

La première ligne du fichier est l'en-tête. Assurez-vous qu'il ne contient que des noms de colonnes, sinon l'import échouera.

Les colonnes suivantes sont disponibles dans les fichiers "produits" :

product_id - l'identifiant externe du produit ; cette colonne est obligatoire et doit être unique pour chaque produit.
name – le nom du produit qui sera affiché dans Splio.
brand - la marque du produit.
description - la description du produit - des informations supplémentaires qui seront visibles dans Splio.
price - le prix nominal du produit. Il s'agit toujours d'un nombre à 2 décimales (par exemple, 2,50), libellé dans la devise par défaut de l'univers Splio.
category - le nom de la catégorie affectée au produit.
img_url - l'URL d'une image utilisée pour illustrer le produit.
sku - l'unité de stockage du produit (SKU).
Une colonne personnalisée, si elle est définie pour les produits de votre univers Splio.

Les noms de colonnes qui correspondent aux champs système sont toujours en minuscules.

N'oubliez pas que l'import échouera si vous n'incluez pas la colonne obligatoire (product_id) ou si on utilise une colonne que Splio ne peut pas reconnaître (c'est-à-dire ni l'une des colonnes par défaut ni une colonne personnalisée correctement définie).

📘
Important : veuillez noter que lors du téléchargement des prix de vos produits, vous devez saisir deux décimales après le point (soit 10,99).

Exemple de fichier

Un court fichier contenant certains produits d'origine animale peut ressembler à ceci :

product_id;name;brand;price
"0013130002004";"Dog Treats";"Milk Bone";"182.49"
"8003299918256";"Tigrito Cat Bowl";"Alessi";"38.50"
"0871864006190";"Hot Diggity Dog Dog Toy Size Medium";"Petstages";"85.25"
"0721343632993";"Maximum Absorbency Dog Puppy Pads Size 100 Package;Zanies";"119.91" 
"0045663188931";"Dog Diaper Garment Size Medium";"Topdawg Pet Supply";"115.61"

L'exemple utilise quatre colonnes standard : product_id, name, brand et price. Les valeurs correspondant à chaque colonne se trouvent dans les lignes suivantes.

Nommez votre fichier

Enregistrez votre fichier sous un nom composé du nom de l'univers, du scope ("produits"), de la sous-séquence et de la date actuelle. Par exemple :

myuniverse_products_zoo_20180416.csv

Ce nom de fichier appartient à l'univers "myunivers", sous-séquence "zoo" défini pour les produits, et est daté du 16 avril 2018.

Vous pouvez maintenant télécharger le fichier sur SFTP / FTPS.

Informations avancées

Cette partie du document contient des informations supplémentaires qui complètent le guide ci-dessus et fournissent plus de détails.

Format de fichier

Nom de fichier	products().csv
Encodage	UTF-8 without BOM
Format	CSV (no multiline)
Séparateur de colonnes	; (semicolon)
Qualificateur de texte	" (double quote, optional)
Caractère d'échappement	\ (backslash)
Fin de ligne	\n or \r\n
Séparateur décimal	. (dot)

Colonnes

Le tableau ci-dessous contient des informations détaillées sur toutes les colonnes (champs) du scope"produits".

🚧
N'oubliez pas que tous les noms de colonne sont sensibles à la casse. Pour cette raison, les noms par défaut sont tous en minuscules.

Colonne	Obligatoire	Type de données / longueur maximale	Description
product_id	Oui	Texte (max.50 caractères)	Cette colonne doit contenir l'identifiant externe du produit importé. Etant la clé primaire du scope "produits", cette colonne est obligatoire. Par conséquent, s'il est manquant, l'importation sera abandonnée. De plus, Splio sautera toutes les lignes qui ne fournissent pas de valeur "product_id".
name	Oui	Texte (max.120 caractères)	Le nom du produit
brand	Non	Texte (max.120 caractères)	Représente le nom de la marque du produit.
description	Non	Texte (max.120 caractères)	Contient une brève description du produit (assurez-vous que vous êtes conscient de la taille restreinte du champ).
price	Non	Décimal, "." (point) comme séparateur décimal. Toujours exprimé dans la devise par défaut de votre univers.	Le prix du produit.
category	Non	Texte (max.120 caractères)	La catégorie du produit.
img_url	Non	Texte (max. 2048 caractères)	L'URL d'une image du produit.
sku	Non	Texte (max.120 caractères)	Le SKU du produit.
Product custom field	Non	Texte (max.255 caractères)	Voir ci-dessous.

La fonction d'import de Splio permet d'utiliser des champs personnalisés qui ont été configurés dans votre univers. Pour inclure un champ personnalisé, utilisez soit son nom comme en-tête de colonne, soit la lettre minuscule "c" suivie de son identifiant numérique.

Par exemple, si vous avez un champ appelé "catégorie" dans votre scope "produits" et que son ID est 2, vous pouvez utiliser "catégorie" ou "c2" comme nom de la colonne.

Gardez à l'esprit que si Splio ne peut pas reconnaître le nom d'une colonne, il n'importera pas le fichier.

Logs

Les informations suivantes sont mises à disposition par Splio après l'import.

Si l'import a été abandonné ou non et, si il a été abandonné, la raison (colonne inconnue, colonne d'ID externe manquante, champ personnalisé non déclaré).
Le nombre de lignes traitées (importées + sautées) / importées / sautées
Le nombre d'enregistrements nouveaux et mis à jour
La raison pour laquelle chaque ligne a été ignorée (product_id NULL, trop de colonnes / pas assez)

Normalement, un fichier sera disponible dans le même dossier où le fichier d'import a été téléchargé.