Mappatura dati

Il tuo negozio chiama una colonna article; un altro la chiama sku. Scalarcut non richiede né l'uno né l'altro. Mappi ogni colonna del file su un campo Scalarcut una volta, e la mappatura viene ricordata.

Come funziona la mappatura

Quando carichi un file, Scalarcut legge la riga di intestazione e ne ricava un'impronta. Se hai già importato questa disposizione di intestazione, la mappatura salvata si applica automaticamente — mappi una nuova disposizione di colonne una sola volta.

Ogni colonna mappata porta una trasformazione che dice all'importatore come leggere il valore:

Trasformazione	Usata per	Comportamento
trim	SKU, nome, collezione, id	Spazi rimossi.
integer	Larghezza, altezza, spessore, pezzi per cartone	Analizzato come numero intero.
parse_size_pair	Dimensione combinata	Accetta 600×300, 600x300, 600*300, con mm, cm o m.
url	URL immagine	Deve essere HTTPS pubblico, altrimenti scartato con avviso.
enum_map	Tipo di materiale	Associa valori come porcelain, gres o керамогранит a un tipo noto.

Il flusso di importazione

1. Carica il file e scegli una modalità (sotto).
2. Mappa le colonne — o lascia che si applichi automaticamente un profilo salvato.
3. Valida — ogni riga viene controllata; errori e avvisi vengono segnalati.
4. Conferma — rivedi i conteggi creati / aggiornati / rifiutati prima di pubblicare nulla.
5. Committa — le righe vengono scritte nel catalogo e la revisione avanza.

Se una riga fallisce, puoi scaricare un CSV degli errori con numero di riga, SKU e motivo, correggere il file sorgente e ricaricare.

Regole di validazione

• Una riga ha bisogno di uno SKU e di una dimensione. Senza uno dei due, viene rifiutata.
• Una dimensione di piastrella sotto 10 mm viene rifiutata.
• Un URL immagine mancante o non HTTPS è un avviso, non un errore — la piastrella viene importata comunque.

Mantenere il catalogo aggiornato

Il tuo catalogo cambia di continuo. Non devi reincorporare il widget né toccare il tuo snippet — il widget serve sempre l'ultima revisione committata a ogni caricamento. Il flusso per i cambiamenti quotidiani:

Aggiungere nuovi prodotti

Aggiungi le nuove righe al tuo export abituale e ricarica. Le stesse intestazioni vengono riconosciute automaticamente, così i nuovi SKU vengono aggiunti e gli esistenti restano intatti.

Modificare un prodotto

Aggiorna la riga di quel prodotto (nuova dimensione, quantità per cartone corretta, nuovo URL immagine) e reimporta. Lo SKU esistente viene aggiornato sul posto; le altre righe restano invariate.

Rimuovere prodotti

La rimozione è una scelta esplicita, così nulla scompare per sbaglio. Scegli la modalità adatta:

Modalità	Cosa fa
Upsert	Aggiunge o aggiorna le righe del file e lascia tutto il resto invariato. Per aggiungere e modificare.
Sostituisci una collezione	Sostituisce un'intera collezione — ogni SKU di quella collezione non più presente nel file viene rimosso.
Sync completa del catalogo	Rende il catalogo esattamente uguale al file — ogni SKU piastrella assente dal file viene rimosso.

Per un prodotto occasionale esaurito o fuori produzione, modifica il file e reimporta invece di lasciare uno SKU obsoleto nel pianificatore.

Immagini e prezzi restano tuoi

La mappatura registra solo da dove vengono le cose. Le immagini restano sui tuoi server (referenziate per URL), e i prezzi sono solo informativi nel widget — il checkout resta la fonte di verità.

Passi successivi

• Struttura CSV — le colonne e i formati file.
• Catalogo — cosa memorizza il catalogo e come lo usa il widget.