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,600x300ou600*300. Millimètres, centimètres et mètres sont acceptés quand l'unité est écrite (par exemple60×30 cm). - Deux colonnes séparées — une colonne
widthet une colonneheight, 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.