Per grandi cataloghi

Generare GARAN-Label per un grande catalogo: CSV o API

Vuoi generare GARAN-Label in blocco per qualche centinaio o qualche migliaio di prodotti e prima ti servono tre risposte: lo strumento regge il mio catalogo, quanto mi costa e quanto tempo ci vuole. Questa pagina risponde a tutte e tre con numeri concreti.

Quale metodo è adatto al tuo catalogo?

Il metodo giusto dipende da due cose: quanti prodotti hanno bisogno di un label e quanto spesso cambiano quei dati.

Metodo	Dimensione del catalogo	Frequenza delle modifiche	Ideale per
Inserimento manuale	Meno di 10 label	Raramente	Piccoli negozi, una manciata di prodotti con garanzia, aggiunte occasionali.
Caricamento CSV	Da 10 a 10.000 label	Perlopiù statico, un aggiornamento ogni qualche mese	Rivenditori e marchi con un catalogo ampio ma stabile. Nessuna programmazione richiesta.
API	Qualsiasi dimensione	Modifiche frequenti, nuovi prodotti ogni settimana	Negozi alimentati da un PIM o un ERP, agenzie, chiunque voglia che il label venga creato in automatico insieme al prodotto.

Puoi combinarli: la maggior parte dei grandi cataloghi parte con un unico caricamento CSV per l'assortimento esistente e passa all'API per i nuovi prodotti. I dettagli tecnici di entrambi sono nella pagina di riferimento API & CSV.

Prima filtra, poi genera: quali SKU hanno davvero bisogno di un label

Il modo più efficace per ridurre il costo di una generazione in blocco viene prima del caricamento. Il GARAN-Label è richiesto solo per i prodotti per cui un produttore offre una garanzia commerciale di durabilità gratuita, che copre l'intero prodotto per più di due anni. Tutti gli altri prodotti hanno bisogno dell'avviso di garanzia legale gratuito, ma di nessun GARAN-Label.

Passa la tua esportazione prodotti attraverso tre domande:

È un bene fisico? Contenuti digitali e servizi sono fuori dal campo di applicazione.
Esiste una garanzia del produttore superiore a due anni? Una garanzia di esattamente due anni o meno non fa scattare il label.
È gratuita e copre l'intero prodotto? Estensioni di garanzia a pagamento e garanzie su singoli componenti non contano.

In pratica un catalogo da 5.000 SKU si riduce spesso a qualche centinaio di prodotti che rientrano davvero. Tutto il resto lo puoi togliere dal CSV prima di caricarlo. Dettagli su chi è soggetto all'obbligo →

Cosa ti serve per ogni SKU: marchio, modello, durata

Il label in sé è semplice. Riporta tre valori, e il CSV ha bisogno esattamente di queste tre colonne:

brand

Il marchio o il marchio commerciale così come compare sul prodotto.

model

L'identificativo del modello. Le varianti che lo condividono condividono il label.

duration

La durata della garanzia in anni, interi o mezzi anni, per esempio 3 o 2.5.

La parte davvero difficile: la durata della garanzia

Marchio e modello esistono in ogni sistema di negozio. La durata della garanzia del produttore di solito no. La maggior parte delle banche dati prodotto ha al massimo un campo "garanzia", e spesso quel campo contiene le condizioni del rivenditore anziché la garanzia del produttore. Dove si nasconde di solito il dato:

Listini dei fornitori e schede tecniche di prodotto, spesso come nota a testo libero.
Le condizioni di garanzia sul sito del produttore o nel foglietto nella confezione.
Un attributo del PIM o dell'ERP compilato una volta per qualche marchio e mai più aggiornato.

Scorciatoia pratica: i produttori raramente fissano la durata per singolo SKU. Di norma è costante per marchio o per serie di prodotti. Raccogli la durata una volta per marchio e serie, poi incrociala con la tua esportazione SKU. Così un lavoro di ricerca su migliaia di righe diventa un elenco di poche decine di voci.

Esempio concreto: un catalogo da 1.000 SKU

Le cifre qui sotto sono un'illustrazione con numeri tondi, non la misurazione di un cliente specifico. Mostrano come funziona il calcolo, così puoi inserire i dati del tuo catalogo.

SKU nel negozio	1.000	Esportazione completa, tutte le categorie.
SKU con garanzia del produttore superiore a due anni	380	Dopo le tre domande filtro qui sopra. Agli altri 620 basta l'avviso gratuito.
Combinazioni uniche marchio + modello + durata	240	Taglie e colori condividono un identificativo di modello e quindi un label.
Crediti consumati	240	Un credito per ogni label generato. Le righe con una combinazione duplicata riutilizzano il label esistente.
Pacchetto di crediti	500 crediti a 49 €	Restano 260 crediti per i nuovi prodotti. In alternativa, due pacchetti da 100 crediti a 38 € se sai che l'assortimento non crescerà.
Il tuo tempo	Mezza giornata	Quasi tutto va nella raccolta delle durate di garanzia. Il caricamento richiede minuti, la generazione gira da sola.

Il risultato è un file con una riga per ogni riga di input e l'URL del label corrispondente. Poi scarichi le immagini e le inserisci nel tuo negozio, vedi sotto.

Preparare il file CSV

Qualsiasi foglio di calcolo, Excel compreso, può produrre il file. Quello che conta:

Colonne: brand, model, duration e, facoltativamente, force_regeneration (1 forza una nuova generazione, vuoto o 0 riutilizza un label esistente).
Separatore: virgola o punto e virgola. Excel in italiano salva di default con il punto e virgola; il caricamento riconosce dalla riga di intestazione quale hai usato.
Codifica: UTF-8, così accenti, dieresi e caratteri speciali nei nomi di marchi e modelli arrivano intatti.
Limite di righe o di dimensione del file: nessuno. Il file viene letto riga per riga, qualunque sia la dimensione.
Formato: prima del caricamento scegli PNG, EPS o PDF per l'intero file. Il PNG è quello che ti serve per il negozio, EPS e PDF sono per la stampa.
Elaborazione: gira in background con un indicatore di avanzamento. Puoi chiudere la scheda, disconnetterti e tornare più tardi; il lavoro continua.

brand;model;duration;force_regeneration
Bosch;GSR 18V-55;3;
Bosch;GSR 18V-55;3;
Makita;DHP486;3;
Miele;W1 WCD 120;5;

Le due righe Bosch sono volute: mostrano cosa fa la deduplicazione. Entrambe ricevono lo stesso URL del label, viene consumato un solo credito.

Input: una riga per prodotto o per modello.

File di risultato di una generazione in blocco di GARAN-Label con una colonna Label-URL aggiuntiva per riga

Output: le stesse righe più l'URL del label per ciascuna.

Deduplicazione: la leva sui costi delle generazioni in blocco

Un credito paga un label generato, non una riga del tuo file. La regola è semplice: marchio + modello + durata identici significano un solo label, indipendentemente da quante righe o quante varianti di prodotto vi puntano. Tre conseguenze per un grande catalogo:

Le varianti sono gratis. Dieci varianti di colore di un modello consumano un credito.
Ricaricare lo stesso file non costa nulla finché i label esistono ancora sul nostro server. Ricevi indietro gli URL esistenti.
Solo le modifiche reali costano crediti. Una durata di garanzia cambiata è una nuova combinazione e quindi un nuovo label. Anche impostare force_regeneration a 1 rigenera e consuma un credito, quindi lascialo vuoto a meno che tu non abbia bisogno di un file nuovo.

Il calcolo dell'esempio qui sopra: 1.000 righe, 240 combinazioni uniche, 240 crediti. Il prezzo è per label generato, non al mese e non per utente, quindi un catalogo che non cambia non continua a costare.

Pacchetti di crediti

Crediti	Prezzo	Prezzo per label
100	19,00 €	0,19 €
500	49,00 €	0,10 €
2000	144,00 €	0,07 €
10.000	569,00 €	0,06 €

Tutti i prezzi sono al netto dell'IVA di legge. 1 credito equivale a 1 label generato di nuovo. Le ripetizioni identiche (stesso marchio, stesso modello, stessa durata della garanzia) non costano un credito aggiuntivo. Nessun abbonamento, nessun acquisto minimo.

Portare i file nel tuo negozio: URL ospitati o self-hosting

Ogni label generato è raggiungibile tramite l'URL nel tuo file di risultato. Per un grande catalogo hai due modi per usarlo:

URL ospitato (breve termine)

Collega l'immagine direttamente. Va bene per i test e per riempire il negozio in fretta, ma i label vengono archiviati 30 giorni dopo la generazione. Dopo, il link si rompe e una nuova richiesta rigenera il label consumando un credito.

Self-hosting (consigliato)

Scarica le immagini entro i 30 giorni, caricale nella tua libreria media o sul tuo CDN e associale ai tuoi prodotti tramite SKU o modello. È un lavoro da fare una volta sola e il label resta online finché ti serve.

Come funziona l'associazione dipende dalla tua piattaforma: un metafield in Shopify, un attributo prodotto in Magento 2, un campo personalizzato in WooCommerce. Ogni guida descrive il percorso in blocco. Guide per canale di vendita →

Errori e casi limite nei file grandi

Situazione	Cosa succede	Cosa fare
Una riga è senza modello (o senza marchio o durata)	Solo quella riga viene segnata come errore nel file di risultato. Tutte le altre vengono elaborate.	Correggi la riga e caricala di nuovo in un piccolo file di recupero.
Nell'intestazione manca una colonna obbligatoria	L'intero lavoro si ferma con il messaggio "Missing required column".	Controlla i nomi dell'intestazione: esattamente `brand`, `model`, `duration`.
L'intestazione sembra corretta ma il lavoro segnala comunque la colonna `brand` mancante	Molto probabilmente il file inizia con un byte order mark invisibile. Excel ne aggiunge uno quando salvi come "CSV UTF-8".	Salva come CSV semplice, oppure rimuovi il marcatore con un editor di testo. I nomi delle colonne devono iniziare dal primissimo byte.
Righe con una durata di due anni o meno	Vengono generate come qualsiasi altra riga e consumano un credito. Lo strumento non decide al posto tuo se un label è richiesto.	Filtrale prima del caricamento; questi prodotti non hanno bisogno di un GARAN-Label.
Taglie e colori come righe separate	Le righe con lo stesso marchio, modello e durata condividono un label e un credito.	Nulla. Tieni le righe se ti aiutano ad associare il risultato ai tuoi SKU.
Virgole o punti e virgola dentro il nome di un modello	Vale il quoting CSV standard.	Racchiudi il valore tra virgolette doppie, come fa in automatico ogni foglio di calcolo.
Accenti e dieresi appaiono sbagliati nel label	Il file è stato salvato in una codifica obsoleta.	Salvalo in UTF-8 e ricaricalo con `force_regeneration` impostato a `1` per le righe interessate.

Prima testa la struttura del file: la modalità sandbox funziona anche per i caricamenti CSV e genera campioni PNG con filigrana senza consumare crediti.

Pronto a etichettare tutto il tuo catalogo?

Registrati gratis, carica un file di prova in modalità sandbox e controlla il risultato prima di acquistare un solo credito.

Prova gratis

Ti servono i parametri tecnici e il codice di esempio? Riferimento API & CSV →

Chi ha davvero bisogno del GARAN-Label →
Guide all'integrazione per canale di vendita →

FAQ

Domande sulla generazione in blocco di GARAN-Label

Quanto tempo serve per generare 1.000 GARAN-Label?

Circa due-quattro minuti. Carichi il file una volta e la generazione prosegue in background sui nostri server, a lotti, anche se chiudi il browser. Poi scarichi il file dei risultati. Per un catalogo di queste dimensioni, metti in conto un pomeriggio per preparare i dati, non per la generazione in sé.

C'è un limite di righe o di dimensione per il caricamento CSV?

No, né di righe né di dimensione del file. Il file viene letto riga per riga ed elaborato in background, quindi anche i cataloghi molto grandi funzionano senza dividere il file. Se preferisci, puoi comunque caricare un file per marchio o per fornitore, così i file di risultato restano maneggevoli.

Pago per ogni riga del mio CSV?

No. Un credito viene consumato solo quando un label viene effettivamente generato. Le righe con la stessa combinazione di marchio, modello e durata della garanzia condividono un unico label, e una riga che richiede di nuovo un label già esistente entro i suoi 30 giorni non costa nulla.

Le varianti di prodotto, come taglie o colori, hanno bisogno ciascuna del proprio label?

Di solito no. Il label mostra marchio, modello e durata della garanzia. Se le tue varianti condividono lo stesso identificativo di modello e la stessa garanzia, un solo label le copre tutte. È esattamente qui che la deduplicazione ti fa risparmiare crediti.

Che differenza c'è tra questa pagina e la pagina API?

Questa pagina ti aiuta a decidere come etichettare un grande catalogo e quanto costa. La pagina API è il riferimento tecnico con parametri e codice di esempio per cURL, PHP, Python e Node.js. Riferimento API & CSV →

Altre domande? Vedi tutte le FAQ →