Struttura CSV

Il tuo catalogo è un unico foglio di calcolo di SKU. Lo esporti dal negozio o ERP, lo carichi una volta, mappi le colonne una volta, e il widget blocca ogni pagina prodotto sulle dimensioni reali dello SKU visualizzato.

File supportati

• CSV e TXT — delimitati da virgola o punto e virgola. Il delimitatore viene rilevato automaticamente dalla prima riga.
• XLSX e XLS — fogli di calcolo standard.
• Fino a 20 MB per caricamento.

La prima riga è l'intestazione. Ogni riga successiva è uno SKU.

Come formare il CSV

Non devi rinominare le colonne del tuo negozio per farle coincidere con le nostre. Esporta le intestazioni che il tuo sistema già produce — article, sku, size, boxes per pack e così via vanno tutte bene — e mappale sui campi Scalarcut nel passaggio successivo (vedi Mappatura dati). Il requisito essenziale è semplicemente che i dati che ti servono siano presenti da qualche parte nel file:

• un codice SKU univoco per ogni riga, e
• la dimensione della piastrella in millimetri.

Tutto il resto è opzionale e arricchisce il widget.

Colonne obbligatorie

Campo	Note
Codice SKU	L'identificatore che il tuo negozio già usa. Le righe carrello restituiscono esattamente questo valore, quindi deve coincidere con ciò che riconosce il tuo checkout.
Dimensione	Uno dei due formati qui sotto.

Dimensione

La dimensione può essere fornita in due modi:

• Una colonna combinata — ad esempio 600×300, 600x300 o 600*300. Millimetri, centimetri e metri sono tutti accettati quando l'unità è scritta per esteso (ad esempio 60×30 cm).
• Due colonne separate — una colonna width e una colonna height, ciascuna in millimetri.

Una singola colonna combinata è la più comune, dato che la maggior parte degli ERP e dei negozi conserva già la dimensione in un unico campo.

Colonne opzionali

Campo	Note
Nome	Mostrato nel menu a tendina dei materiali del widget. Ripiega sul codice SKU se vuoto.
Spessore	In millimetri.
Pezzi per cartone	Piastrelle per cartone, così l'ordine può essere espresso in cartoni. Predefinito 1 se assente.
URL immagine	URL HTTPS pubblico all'immagine del prodotto. Vedi sotto.
Tipo di materiale	ceramic, porcelain, lvt, wood o other. I valori non riconosciuti vengono mappati su other.
Collezione	Raggruppa i prodotti nel selettore collezioni del widget.
Id ERP / 1C	Il tuo identificatore interno, trasportato per il tuo reporting.
Codice a barre	Trasportato per i tuoi sistemi.
Prezzo	Prezzo di listino opzionale per il preventivo a schermo, solo informativo.

Le immagini restano sui tuoi server

Scalarcut non ospita le immagini dei tuoi prodotti. Il CSV contiene un URL HTTPS pubblico per ogni immagine, e il widget la carica dal tuo CDN o vetrina al momento del rendering — il file è referenziato, mai copiato. Licenze, cache e archiviazione restano interamente con te.

• L'URL deve essere HTTPS pubblico. Un URL http:// o non pubblico viene omesso con un avviso, così la riga viene importata comunque e la piastrella viene renderizzata solo senza foto.
• Aggiorna l'immagine dal tuo lato e il widget recepisce la modifica al caricamento successivo — nessun nuovo caricamento necessario.

I prezzi sono solo informativi

Se includi i prezzi, il widget li mostra nel preventivo a titolo informativo. Il prezzo finale è sempre applicato dal tuo checkout quando le righe carrello vengono aggiunte. Il widget non addebita mai un acquirente.

Un esempio completo

Un file minimo ma completo:

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

Lo stesso catalogo con una singola colonna dimensione:

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

Per un file completo, scarica il CSV catalogo di esempio — una piccola gamma realistica di piastrelle e pavimenti su alcune collezioni, esattamente nella forma che l'importatore si aspetta.

Cosa succede dopo

Carica il file nella dashboard Scalarcut e mappa le colonne una volta. Da lì le stesse intestazioni vengono riconosciute automaticamente a ogni nuovo caricamento. Per il passaggio di mappatura e il processo quotidiano di aggiunta, modifica e rimozione dei prodotti, vedi Mappatura dati.