Convalida il tuo catalogo CSV prima di importare diecimila righe

Convalidare un CSV di catalogo inizia col sapere cosa cambierà importandolo. Poi vengono le colonne, gli identificatori e i valori. Un foglio che si apre senza avvisi può contenere due prodotti con lo stesso SKU o una taglia senza valore. Un file accettato può anche aggiornare il prodotto sbagliato.

Il test seguente serve per imparare a distinguere questi errori. Sono dieci righe inventate, con risultati verificabili. Non è un esempio di un negozio reale né un file preparato per Shopify o Frihet: usa uno schema creato per questo esercizio che dovrai sostituire con quello della destinazione.

Inizia dalla destinazione, non dal file del fornitore

Scarica un modello attuale o esporta un prodotto rappresentativo dallo strumento che riceverà i dati. Annota se creerai, aggiornerai o combinerai entrambe le operazioni; cosa identifica un record; quali campi richiede; e cosa significa lasciare una cella vuota. Conserva questa definizione insieme al file di lavoro.

Su Shopify, ad esempio, la sovrascrittura si basa sull’identificatore URL, chiamato handle. La sua documentazione richiede anche di rivedere le dipendenze tra campi di variante e opzioni. La nostra regola SKU non descrive come questo importatore identifica i prodotti. Formato dei prodotti di Shopify.

Se sposti dati tra sistemi, separa questa revisione dalla connessione tra negozio e gestione (in inglese). Un connettore disponibile non dimostra che accetti le colonne del tuo fornitore.

Definisci delle regole che puoi verificare

Nell’esercizio, ogni riga rappresenta un articolo vendibile. product_key raggruppa le sue varianti; sku deve essere presente e unico. name è obbligatorio. Una variante necessita di option_name e option_value; entrambi vuoti significano che non dichiariamo un’opzione. Se sono completi, la loro combinazione con product_key non può ripetersi.

Il file utilizza UTF-8, virgole tra i campi e otto colonne nell’ordine mostrato. price accetta numeri non negativi con punto e due decimali, senza separatore di migliaia. Per currency richiediamo EUR per questo test. Queste sono condizioni scelte per questa prova, non regole universali né prezzi commerciali. Non c’è conversione di valuta né calcolo fiscale.

Gli SKU sono conservati come testo: 001 non si converte in 1. Microsoft spiega come evitare conversioni automatiche caricando identificatori in Excel. Definisci il tipo di colonna prima di trasformare i dati; cambiare il loro aspetto in seguito non ricostruisce l’originale. Mantenere gli zeri iniziali in Excel.

Dieci righe, inclusa una che sembra corretta

Copia il blocco come testo per esaminarlo. L’ultima riga ha una colonna in meno deliberatamente. row_id è l’identificatore del test; R01 è nella seconda riga del file, perché la prima contiene le intestazioni. I nomi spagnoli dei prodotti sono valori fissi, uguali in tutte le edizioni, così i risultati restano riproducibili.

row_id,product_key,sku,name,option_name,option_value,price,currency
R01,P01,001,Taza,Color,Natural,19.90,EUR
R02,P01,002,Taza,Color,Ink,19.90,EUR
R03,P02,001,Bolsa,,,29.00,EUR
R04,P03,,Cuaderno,,,8.50,EUR
R05,P04,005,Café,,,6.00,EUR
R06,P05,006,Vaso,,,"12,50",EUR
R07,P06,007,Camiseta,Size,,24.00,EUR
R08,P01,008,Taza,Color,Natural,19.90,EUR
R09,P07,009,,,,15.00,EUR
R10,P08,010,Bandeja,,,25.00

Il risultato è otto righe bloccate, una in attesa di revisione e una che passa. Sono stati di righe, non otto errori indipendenti: R01 ha due conflitti. Puoi verificare ogni risultato confrontando le chiavi tra le righe e i campi con le regole precedenti.

Un duplicato non si risolve scegliendo la prima riga

R01 sembra completa quando letta da sola. Il conflitto appare scorrendo l’intero insieme: condivide SKU con una borsa e combinazione di variante con un’altra tazza. Per questo la verifica deve marcare tutti i membri del gruppo, non approvare il primo e rifiutare l’ultimo.

Chiedi a chi gestisce il catalogo di confermare se c’è un riferimento errato, un prodotto ripetuto o una variante mal descritta. Salva la decisione con il valore precedente, il nuovo e il suo motivo. Non cancellare R08 solo perché il suo nome coincide; un catalogo reale può distinguere materiale, dimensione o altre opzioni che questo foglio semplificato non include.

Per il tuo lotto reale, confronta anche con i riferimenti che già esistono nella destinazione. Uno SKU unico all’interno del CSV può comunque coincidere con un altro prodotto al di fuori del file. Definisci inoltre come trattare spazi e differenze di maiuscole prima di normalizzare: pulire un identificatore può unire riferimenti che dovevano rimanere separati.

Separa formato, testo e significato

R06 contiene "12,50": le virgolette mantengono il prezzo in una singola cella. Contare le virgole a mano darebbe una diagnosi errata; utilizza un lettore CSV. L’RFC 4180 descrive questa convenzione di virgolette, ma non definisce di quali colonne ha bisogno un catalogo né come interpretare un prezzo. La sintassi CSV di R06 è valida; è il valore del prezzo a non rispettare la regola del campo.

Non effettuare una sostituzione globale di virgole con punti: cambieresti sia separatori che contenuto. Identifica prima il campo, conferma il formato di origine e converti il suo valore in modo controllato. Un valore vuoto non equivale a zero; registrare prezzo zero sarebbe una decisione commerciale che nessuno ha confermato.

R05 richiede un’altra verifica. Il testo Café è salvato con byte UTF-8 validi; questo non dimostra che il nome sia corretto. L’avviso di questo esercizio è preparato per quel valore specifico, non è un rilevatore universale di codifica. Confronta il nome con la fonte e rivedi in quale passaggio si è deformato. Salvare nuovamente testo già danneggiato come UTF-8 non recupera automaticamente i suoi caratteri.

Prima di aggiornare, verifica cosa viene conservato

Una colonna assente e una cella vuota possono produrre cambiamenti diversi. Shopify documenta che, in caso di sovrascrittura, un campo facoltativo presente ma vuoto può cancellare il valore esistente; omettere la sua colonna può conservarlo. Avverte anche che un’importazione avviata non può essere annullata e raccomanda una copia preventiva. Condizioni di importazione di Shopify.

L’identità di una variante può anche cambiare: Shopify avverte che modificare i valori delle opzioni elimina i suoi identificatori precedenti e ne crea di nuovi. Rivedi le connessioni che dipendono da essi prima di correggere un’opzione tramite CSV. Opzioni e identificatori di varianti.

Prepara un confronto tra stato precedente, modifica prevista e risultato osservato. Includi i campi che devono rimanere uguali. Prova in un ambiente di test disponibile e conserva insieme le righe correlate di un prodotto; dieci righe consecutive non sempre rappresentano dieci prodotti completi.

In un’operazione reale, sceglieresti casi diversi: prodotto semplice, varie opzioni, caratteri accentati, prezzo vuoto e aggiornamento di un riferimento esistente. Questo campione testa il percorso. Quindi applica le regole al file completo: i duplicati possono essere separati da migliaia di righe. Consulta le integrazioni per identificare gli strumenti del tuo flusso e verifica le regole sui dati di ciascuno.

Registra una decisione verificabile

Prima di caricare, annota versione del file, destinazione, responsabile, regole applicate, problemi risolti e confronto del test. Se manca una conferma, conserva il lotto in sospeso; un messaggio di «importato» non sostituisce tale revisione.

Frihet supporta l’importazione CSV di prodotti, all’interno delle sue funzioni di gestione. Lo schema e le verifiche manuali di questo articolo sono indipendenti: non testano campi ammessi né validazioni automatiche di Frihet. Usa il modello del tuo importatore e chiarisci prima le righe di cui non sai ancora spiegare il risultato.