Mappage des données

Votre boutique appelle une colonne article ; une autre l'appelle sku. Scalarcut n'exige ni l'un ni l'autre. Vous mappez chaque colonne de votre fichier sur un champ Scalarcut une fois, et le mappage est mémorisé.

Comment fonctionne le mappage

Quand vous importez un fichier, Scalarcut lit la ligne d'en-tête et en tire une empreinte. Si vous avez déjà importé cette disposition d'en-tête, le mappage enregistré s'applique automatiquement — vous ne mappez une nouvelle disposition de colonnes qu'une seule fois.

Chaque colonne mappée porte une transformation qui indique à l'importateur comment lire la valeur :

Transformation	Utilisée pour	Comportement
trim	SKU, nom, collection, ids	Espaces supprimés.
integer	Largeur, hauteur, épaisseur, qté par carton	Analysé comme nombre entier.
parse_size_pair	Taille combinée	Accepte 600×300, 600x300, 600*300, avec mm, cm ou m.
url	URL d'image	Doit être HTTPS publique, sinon rejetée avec avertissement.
enum_map	Type de matériau	Associe des valeurs comme porcelain, gres ou керамогранит à un type connu.

Le flux d'importation

1. Importez le fichier et choisissez un mode (ci-dessous).
2. Mappez les colonnes — ou laissez un profil enregistré s'appliquer automatiquement.
3. Validez — chaque ligne est vérifiée ; erreurs et avertissements sont signalés.
4. Confirmez — vous passez en revue les compteurs créés / mis à jour / rejetés avant publication.
5. Validez l'écriture — les lignes sont écrites dans le catalogue et la révision est incrémentée.

Si une ligne échoue, vous pouvez télécharger un CSV d'erreurs listant le numéro de ligne, le SKU et la raison, corriger le fichier source et réimporter.

Règles de validation

• Une ligne a besoin d'un SKU et d'une taille. Sans l'un des deux, elle est rejetée.
• Une taille de carreau sous 10 mm est rejetée.
• Une URL d'image manquante ou non HTTPS est un avertissement, pas une erreur — le carreau s'importe quand même.

Garder le catalogue à jour

Votre catalogue change constamment. Vous n'avez pas besoin de réintégrer le widget ni de toucher à votre extrait — le widget sert toujours la dernière révision validée à chaque chargement. Le flux pour les changements quotidiens :

Ajouter de nouveaux produits

Ajoutez les nouvelles lignes à votre export habituel et réimportez. Les mêmes en-têtes sont reconnus automatiquement, donc les nouveaux SKU sont ajoutés et les existants ne sont pas touchés.

Éditer un produit

Mettez à jour la ligne de ce produit (nouvelle taille, quantité par carton corrigée, nouvelle URL d'image) et réimportez. Le SKU existant est mis à jour sur place ; les autres lignes restent inchangées.

Supprimer des produits

La suppression est un choix explicite, pour que rien ne disparaisse par accident. Choisissez le mode qui convient :

Mode	Ce qu'il fait
Upsert	Ajoute ou met à jour les lignes du fichier et laisse tout le reste tel quel. Pour ajouter et éditer.
Remplacer une collection	Remplace une collection entière — tout SKU de cette collection qui n'est plus dans le fichier est supprimé.
Sync complète du catalogue	Rend le catalogue exactement conforme au fichier — tout SKU de carreau absent du fichier est supprimé.

Pour un produit ponctuel en rupture ou arrêté, éditez le fichier et réimportez plutôt que de laisser un SKU obsolète dans le planificateur.

Les images et les prix restent à vous

Le mappage enregistre seulement d'où viennent les choses. Les images restent sur vos serveurs (référencées par URL), et les prix sont indicatifs dans le widget — le tunnel de commande reste la source de vérité.

Étapes suivantes

• Structure du CSV — les colonnes et les formats de fichier.
• Catalogue — ce que stocke le catalogue et comment le widget l'utilise.