Chargement de la page…
Prima di importare un catalogo grossista, verificate come minimo l'identificativo prodotto, l'identificativo variante, il nome, il brand, il prezzo e la sua natura fiscale, la valuta, lo stock, l'unità di vendita, il minimo d'ordine, l'immagine e il timestamp. La presenza di una colonna non basta: bisogna anche conoscerne la definizione, il formato e il livello di precisione. Un campo stock contenente "sì" non dimostra una quantità, e un campo price senza valuta né indicazione IVA esclusa/inclusa non permette un calcolo di redditività affidabile. Il riflesso corretto consiste quindi nel creare un dizionario delle colonne, testare alcune righe e bloccare l'importazione non appena un'ambiguità riguarda l'identità, il prezzo o la quantità ordinabile.
Iniziare dal significato, non dal nome della colonna
Due fornitori possono chiamare EAN dati diversi. Per uno, il valore indica la variante venduta; per l'altro, può essere vuoto, troncato da un foglio di calcolo o replicato su tutti i colori. Al contrario, article_code, reference o barcode può contenere l'identificativo realmente utile. Il nome dell'intestazione non è quindi mai una prova.
Richiedete la documentazione del feed e associate ogni colonna a quattro informazioni: definizione di business, tipo di dato, unità e regola di aggiornamento. Per un prezzo, annotate ad esempio se si tratta di un prezzo pubblico o negoziato, IVA esclusa o inclusa, unitario o per cartone. Per uno stock, distinguete quantità numerica, semplice disponibilità e testo libero. Per un identificativo, conservate il valore come stringa per non perdere gli zeri iniziali.
GS1 precisa che il GTIN identifica un articolo commerciale e che la sua rappresentazione può variare a seconda degli standard di scambio. In GS1 XML, è in particolare rappresentato su quattordici cifre con riempimento a sinistra, mentre altri formati accettano una lunghezza variabile. Ciò giustifica una normalizzazione controllata, ma non l'invenzione di un codice assente. La validazione della chiave di controllo del GTIN deve avvenire prima di qualsiasi deduplicazione.
La griglia di controllo prioritaria
| Famiglia | Colonne da cercare | Domanda di validazione | Decisione se manca la prova |
|---|---|---|---|
| Identità | GTIN/EAN/UPC, SKU, MPN | Il codice appartiene alla variante venduta? | Mettere la riga in revisione |
| Descrizione | nome, brand, variante | Taglia, colore o quantità sono espliciti? | Non unire automaticamente |
| Prezzo | prezzo, valuta, IVA esclusa/inclusa | L'importo si riferisce all'unità ordinabile? | Bloccare il calcolo del margine |
| Stock | quantità, disponibilità | Si tratta di un numero, un booleano o un tempo di attesa? | Conservare il livello di prova esatto |
| Ordine | MOQ, step, cartone | Quante unità occorre realmente acquistare? | Non dedurlo dal titolo |
| Media | immagine principale | L'immagine corrisponde alla variante giusta? | Escluderla dal matching visivo |
| Tempo | data di aggiornamento | Quando sono stati osservati prezzo e stock? | Contrassegnare il dato come non datato |
Questa tabella va compilata con esempi reali del file. Le celle vuote, 0, N/A e null non hanno necessariamente lo stesso significato. Una quantità pari a zero può indicare una rottura di stock; una cella vuota può significare "sconosciuto", "non applicabile" o semplicemente un errore di esportazione. Solo la documentazione del fornitore permette di decidere.
Procedura riproducibile prima dell'importazione
1. Conservate il file grezzo, la sua data di ricezione e un'impronta di controllo. Non correggete mai l'originale. 2. Leggete la codifica, il separatore e le intestazioni senza aprire prima il file in un foglio di calcolo che potrebbe riformattare gli identificativi. 3. Prelevate un piccolo lotto diversificato: prodotto semplice, variante, articolo in rottura di stock, eventuale sconto e riga con campi vuoti. 4. Costruite il dizionario delle colonne con la documentazione ufficiale del fornitore e segnate ogni interpretazione non confermata. 5. Controllate i GTIN come stringhe, poi validate la loro lunghezza consentita e la loro chiave di controllo. Un risultato matematicamente valido non dimostra tuttavia né l'attribuzione né la corrispondenza al prodotto. 6. Ricalcolate il prezzo unitario a partire dall'unità di vendita, dal confezionamento esplicito e dal minimo d'ordine. Non deducete un pack da una foto. 7. Confrontate almeno due righe di ogni caso di business con la scheda ufficiale o il portale fornitore. 8. Importate un lotto canarino, osservate i rifiuti, poi ampliate solo se le regole restano stabili.
L'obiettivo non è ottenere zero celle vuote. È non trasformare mai un'assenza di prova in una certezza. Un catalogo parziale ma correttamente tipizzato è più utilizzabile di un file apparentemente completo le cui unità sono ambigue.
Gli errori che falsano silenziosamente un'analisi
Il primo errore è convertire automaticamente i GTIN in numeri. La notazione scientifica, la soppressione di uno zero iniziale o l'aggiunta di un decimale rende il valore inutilizzabile. Il secondo consiste nel prendere il prezzo più visibile come costo d'acquisto: può trattarsi di un prezzo consigliato al pubblico, di una tariffa promozionale o di un importo per lotto. Il terzo è tradurre InStock con una quantità arbitraria. Schema.org definisce InStock come un'indicazione di disponibilità; da solo non fornisce il numero di unità.
Verificate anche i duplicati. Uno stesso GTIN ripetuto su più righe non è automaticamente un'anomalia se queste righe rappresentano magazzini o offerte distinte. Diventa pericoloso quando è attribuito a varianti realmente diverse. La diagnosi dettagliata è presentata nel metodo di rilevamento dei duplicati di varianti.
Infine, separate i campi ricevuti dai campi calcolati. prix_source, devise_source e stock_source devono restare tracciabili. Le conversioni, i punteggi e le ipotesi appartengono a colonne distinte con una data e una regola esplicita. Senza questa separazione, una correzione successiva diventa impossibile da verificare.
Checklist decisionale
- Il file grezzo e il suo timestamp sono conservati.
- Ogni identificativo resta una stringa di caratteri.
- Il GTIN corrisponde alla variante e supera la sua chiave di controllo.
- Il prezzo è collegato a una valuta, un'unità e una natura fiscale (IVA esclusa/inclusa) documentate.
- Lo stock numerico non è confuso con una disponibilità booleana.
- Il MOQ, lo step d'ordine e il contenuto del cartone sono separati.
- L'immagine principale è un URL ufficiale ed è collegata alla variante giusta.
- I valori vuoti e nulli hanno un'interpretazione documentata.
- Le trasformazioni sono distinte dai dati sorgente.
- Un canarino è stato controllato prima di ogni volume significativo.
Cosa può automatizzare ArbitragePro+ / cosa deve verificare il venditore
La specifica proposta controle-colonnes-catalogue potrebbe rilevare le intestazioni, tipizzare i valori, segnalare i GTIN non validi, evidenziare le valute mancanti e classificare lo stock secondo il suo livello di precisione. Produrrebbe un report di prove e ambiguità, senza decidere al posto del fornitore.
Il venditore deve confermare contrattualmente il significato dei campi, la natura fiscale dei prezzi, le unità ordinabili, i diritti d'uso del feed e la corrispondenza delle varianti. Resta inoltre responsabile di verificare che le trasformazioni riflettano le proprie condizioni commerciali.
Passare dalla diagnosi al catalogo monitorato
Consultare la pagina Fonti di ArbitragePro+ per esaminare i connettori e le informazioni di provenienza disponibili.
Fonti ufficiali
- GS1, «Global Trade Item Number (GTIN)», https://www.gs1.org/standards/id-keys/gtin — consultato il 2026-08-17.
- GS1 Support, «Required format of GTIN in GS1 EDI standards», https://support.gs1.org/support/solutions/articles/43000734355-what-is-the-required-format-of-gtin-in-gs1-edi-standards- — consultato il 2026-08-17.
- Schema.org, «ItemAvailability», https://schema.org/ItemAvailability — consultato il 2026-08-17.