Widget boutique en ligne

Structure du CSV

Comment former le CSV du catalogue : colonnes requises et optionnelles, formats de taille, URL d'image et types de fichiers pris en charge.

Votre catalogue est un seul tableur de SKU. Vous l'exportez depuis votre boutique ou ERP, l'importez une fois, mappez les colonnes une fois, et le widget verrouille chaque page produit sur les dimensions réelles du SKU consulté.

Fichiers pris en charge

  • CSV et TXT — délimités par virgule ou point-virgule. Le délimiteur est détecté automatiquement à partir de la première ligne.
  • XLSX et XLS — tableurs standard.
  • Jusqu'à 20 Mo par import.

La première ligne est l'en-tête. Chaque ligne suivante est un SKU.

Comment former le CSV

Vous n'avez pas besoin de renommer les colonnes de votre boutique pour correspondre aux nôtres. Exportez les en-têtes que votre système produit déjà — article, sku, size, boxes per pack, etc. — et mappez-les sur les champs Scalarcut à l'étape suivante (voir Mappage des données). L'exigence essentielle est simplement que les données dont vous avez besoin soient présentes quelque part dans le fichier :

  • un code SKU unique pour chaque ligne, et
  • la taille du carreau en millimètres.

Tout le reste est optionnel et enrichit le widget.

Colonnes requises

Champ Notes
Code SKU L'identifiant que votre boutique utilise déjà. Les lignes de panier renvoient exactement cette valeur, elle doit donc correspondre à ce que reconnaît votre tunnel.
Taille L'un des deux formats ci-dessous.

Taille

La taille peut être fournie de deux façons :

  • Une colonne combinée — par exemple 600×300, 600x300 ou 600*300. Millimètres, centimètres et mètres sont acceptés quand l'unité est écrite (par exemple 60×30 cm).
  • Deux colonnes séparées — une colonne width et une colonne height, chacune en millimètres.

Une seule colonne combinée est la plus courante, car la plupart des ERP et boutiques gardent déjà la taille dans un seul champ.

Colonnes optionnelles

Champ Notes
Nom Affiché dans la liste déroulante des matériaux du widget. Retombe sur le code SKU si vide.
Épaisseur En millimètres.
Qté par carton Carreaux par carton, pour exprimer la commande en cartons. Par défaut 1 si absent.
URL d'image URL HTTPS publique vers l'image du produit. Voir ci-dessous.
Type de matériau ceramic, porcelain, lvt, wood ou other. Les valeurs non reconnues sont mappées sur other.
Collection Regroupe les produits dans le sélecteur de collections du widget.
Id ERP / 1C Votre identifiant interne, transmis pour votre propre reporting.
Code-barres Transmis pour vos propres systèmes.
Prix Prix catalogue optionnel pour le devis à l'écran, à titre indicatif uniquement.

Les images restent sur vos serveurs

Scalarcut n'héberge pas les images de vos produits. Le CSV contient une URL HTTPS publique vers chaque image, et le widget la charge depuis votre CDN ou vitrine au moment du rendu — le fichier est référencé, jamais copié. Licence, mise en cache et stockage restent entièrement chez vous.

  • L'URL doit être en HTTPS public. Une URL http:// ou non publique est omise avec un avertissement, donc la ligne s'importe quand même et le carreau s'affiche simplement sans photo.
  • Mettez à jour l'image de votre côté et le widget récupère le changement au prochain chargement — pas besoin de réimporter.

Les prix sont indicatifs

Si vous incluez des prix, le widget les affiche dans le devis à titre indicatif. Le prix final est toujours appliqué par votre tunnel quand les lignes du panier sont ajoutées. Le widget ne débite jamais un acheteur.

Un exemple complet

Un fichier minimal mais complet :

sku,name,width_mm,height_mm,pack_qty,texture_url,material_type,collection
CER-600-300,Porcelain Grey,600,300,8,https://cdn.example.com/cer-600-300.jpg,porcelain,Porcelain
LVT-1210-180,Herringbone Oak,1210,180,10,https://cdn.example.com/lvt-1210-180.jpg,lvt,Wood

Le même catalogue avec une seule colonne de taille :

sku,name,size_mm,pack_qty,texture_url
CER-600-300,Porcelain Grey,600×300,8,https://cdn.example.com/cer-600-300.jpg
LVT-1210-180,Herringbone Oak,1210×180,10,https://cdn.example.com/lvt-1210-180.jpg

Pour un fichier complet, téléchargez le CSV de catalogue d'exemple — une petite gamme réaliste de carrelage et de sols sur quelques collections, exactement dans la forme attendue par l'importateur.

Ce qui se passe ensuite

Importez le fichier dans votre tableau de bord Scalarcut et mappez les colonnes une fois. Dès lors, les mêmes en-têtes sont reconnus automatiquement à chaque nouvel import. Pour l'étape de mappage et le processus quotidien d'ajout, d'édition et de suppression de produits, voir Mappage des données.