Applicable products: Netmarkets, Netamplify, Netmonitor, Netrivals

Requisiti dei contenuti del catalogo

In questo articolo troverai consigli utili per creare e generare un catalogo prodotti ottimale in termini di formato, codifica e contenuti.

Per scoprire i diversi modi per inviare il tuo catalogo a Lengow, consulta il nostro articolo su Import Methods.

I tuoi dati di origine possono essere trasmessi a Lengow come catalogo principale oppure come fonte aggiuntiva per arricchire un catalogo principale. Le informazioni riportate di seguito si applicano a entrambi i tipi di fonte.

1. Codifica e formati supportati

Il tuo catalogo prodotti può essere in formato:

CSV (consigliato)
Per una compatibilità ottimale, scegli la codifica UTF-8. Sono supportati anche altri tipi di codifica, come ASCII e ISO 8859-1
TXT
XML
JSON
GZ

Come salvare un file in formato CSV UTF-8 usando un foglio di calcolo?

In Excel: clicca su "Save as" e seleziona il formato "CSV UTF-8".

In LibreOffice o OpenOffice: clicca su "Save as" e seleziona il formato "Text CSV", spuntando la casella "Edit filter settings". Dopo aver salvato, potrai scegliere il set di caratteri "Unicode (UTF-8)" nella finestra di dialogo.

2. Contenuti del catalogo prodotti

2.1 Consigli di Lengow

Non inserire mai caratteri speciali (accenti, %, / o altri simboli) nei titoli dei campi.
Non inserire spazi o virgole nei nomi dei campi o negli ID prodotto. Puoi usare - e _ al loro posto.
In caso di breadcrumb, per separare le categorie:
- preferisci i simboli >, / o | (esempio di valori: Scarpe> Scarpe da uomo> sneakers)
- In alternativa, usa un campo per ogni livello di categoria.

Lo stesso ID prodotto non può essere inviato a tutti i marketplace, poiché hanno requisiti diversi.

Lengow gestisce questo problema per garantire che gli ordini vengano importati con l'ID corretto, univoco e identico per ogni prodotto nel tuo back office.

Lengow associa l'ID di un prodotto all'ID che hai mappato nelle impostazioni del catalogo.
Il prodotto corrispondente deve essere presente nel feed ottimizzato, poiché l'API di Lengow usa il channel product_id per cercare il prodotto e sostituirlo con il campo identificato come ID nel catalogo del feed ottimizzato.

Nell'esempio seguente, l'ID è associato allo SKU. Lo SKU verrà visualizzato come ID in tutti gli ordini dei clienti.

Non modificare mai gli ID dei prodotti. Gli ID prodotto vengono usati per salvare le personalizzazioni effettuate sulla piattaforma e fungono da interfaccia per condividere i dati con i vari canali di marketing.
Non modificare mai i nomi dei campi del catalogo prodotti una volta che vengono usati sulla piattaforma Lengow. Non eliminare mai un campo già in uso sulla piattaforma. Puoi comunque aggiungere tutti i campi che vuoi.
Tutte le etichette dei campi del catalogo prodotti devono essere univoche. Anche ogni intestazione deve essere univoca.

2.2 Struttura generale

Di seguito trovi un elenco non esaustivo dei campi che Lengow consiglia di includere nel catalogo prodotti. Alcuni campi sono obbligatori durante la fase di mappatura in Lengow: "id", "title", "price" e "category".

Il contenuto e la struttura possono essere adattati alle tue esigenze.

Per ogni tipo di campo indichiamo la relativa definizione, il tipo di valori previsti con un esempio e i nostri consigli.

Unique_ID

Numero di riferimento permanente specifico per ogni prodotto, usato per identificarlo in modo univoco nel tempo. Un singolo prodotto deve avere sempre lo stesso identificativo. L'ID non deve essere riassegnato a un altro prodotto (massimo 25 caratteri).

Tipo di valore previsto: Alfanumerico (senza spazi o virgole)

Esempio: 1235RES56

Consiglio: obbligatorio per integrare un catalogo in Lengow

Category

Categoria a cui appartiene il prodotto. Puoi anche fare riferimento alla “product family” (campo con un massimo di 250 caratteri). Questo campo verrà usato per organizzare i prodotti per categoria (lavatrice, lettore MP3 ecc.).

Tipo di valore previsto: Alfanumerico

Esempio: High tech > televisore > televisore LCD > 100 Hertz

Consiglio: obbligatorio per integrare un catalogo in Lengow

Sub_category1

Sottocategoria a cui appartiene il prodotto.

Tipo di valore previsto: Alfanumerico

Esempio: televisore LCD

Consiglio: questo campo è fortemente consigliato per integrare il catalogo nella piattaforma Lengow

Sub_category2...

Sottocategoria a cui appartiene il prodotto.

Tipo di valore previsto: Alfanumerico

Esempio: 100 Hertz

Consiglio: questo campo è fortemente consigliato per integrare il catalogo nella piattaforma Lengow

Title

Titolo del prodotto

Tipo di valore previsto: Alfanumerico

Esempio: Televisore LCD Samsung 100 Hertz

Consiglio: obbligatorio per integrare un catalogo in Lengow

Description

Descrizione del prodotto

Tipo di valore previsto: Alfanumerico

Esempio: televisore LCD Samsung 100 Hertz, 47 pollici...

Consiglio: fortemente consigliato per integrare il catalogo in Lengow

Standard_price

Corrisponde al prezzo del prodotto sul tuo sito (54.40, 60.30 ecc.). Senza il simbolo € e con il punto come separatore decimale.

Tipo di valore previsto: Numerico

Esempio: 799.90

Consiglio: obbligatorio per integrare un catalogo in Lengow

barred_price

Se il prezzo è stato ridotto (promozione, svendita ecc.), indica in questo campo il vecchio prezzo del prodotto, IVA inclusa, in euro. Senza il simbolo € e con il punto come separatore decimale.

Tipo di valore previsto: Numerico

Esempio: 900.99

Consiglio: questo campo è fortemente consigliato per integrare il catalogo nella piattaforma Lengow

Sale_price

Prezzo del prodotto durante il periodo di saldi. Senza il simbolo € e con il punto come separatore decimale.

Tipo di valore previsto: Numerico

Esempio: 699.90

Consiglio: questo campo è fortemente consigliato per integrare il catalogo nella piattaforma Lengow

Product_URL

Corrisponde all'URL della pagina del prodotto sul tuo sito

Tipo di valore previsto: URL

Esempio: http://mysite.com/product.html

Consiglio: questo campo è obbligatorio per tutti i canali tranne i marketplace.

URL_image

Corrisponde all'URL dell'immagine del prodotto sul tuo sito. Lengow accetta tutti i tipi di formato, tuttavia alcuni canali impongono restrizioni e non accettano tutti i formati. Questo potrebbe impedire la pubblicazione dei tuoi prodotti.
Poiché Lengow non scarica le immagini, gli URL forniti devono essere accessibili pubblicamente per essere visualizzati sul sito web del canale.

Tipo di valore previsto: URL

Esempio: http://mysite.com/product_image.jpg

Consiglio: obbligatorio per integrare il catalogo in Lengow.

EAN

Questo campo è composto da 13 cifre e corrisponde al codice a barre comunemente usato per i beni di consumo in Europa. Identifica il prodotto in modo univoco e permette una migliore indicizzazione del prodotto nelle nostre categorie. European Article Number.

Tipo di valore previsto: Numerico

Esempio: 1234567891019

Consiglio: questo campo è obbligatorio per tutti i canali marketplace.

Parent_ID

Identificativo comune a tutte le varianti di un prodotto (scopri di più).

Tipo di valore previsto: Alfanumerico

Esempio: 1235RES56

Consiglio: questo campo è obbligatorio per gestire le varianti dei prodotti nella piattaforma Lengow

Size / Color / Material ...

Si tratta di valori di variante che caratterizzano il prodotto

Corrisponde alla taglia del prodotto (S, XL, XXL 37, 38, 41, 42, ...) o al suo colore (rosso, bianco, blu, ...) ecc.

È preferibile usare un campo per ogni tipo di variante, per evitare di mescolare le caratteristiche visualizzate.

Tipo di valore previsto: Alfanumerico / Testo

Consiglio: questo campo è fortemente consigliato per integrare il catalogo nella piattaforma Lengow ed è obbligatorio per pubblicare i prodotti sui marketplace.

Product_Type

Definisce il tipo di prodotto (prodotto "child", quindi con varianti, prodotto "parent" oppure prodotto "simple")

Tipo di valore previsto: Testo

Consiglio: questo campo è fortemente consigliato per la pubblicazione sui marketplace, incluso Amazon.

Brand

Corrisponde al marchio del prodotto o al nome del produttore.

Tipo di valore previsto: Alfanumerico

Esempio: SAMSUNG

Consiglio: obbligatorio per integrare il catalogo in Lengow

Delivery_costs

Corrisponde ai costi di consegna del prodotto. In questo campo deve essere indicato il prezzo, IVA inclusa, in euro, di tutti i costi relativi all'ordine: spedizione, gestione e preparazione dell'ordine ecc. Senza il simbolo € e con il punto come separatore decimale nella descrizione.

Tipo di valore previsto: Numerico

Esempio: 5.00

Consiglio: questo campo è fortemente consigliato per integrare il catalogo nella piattaforma Lengow

Delivery_time

Tempo massimo di consegna. Valore numerico interpretato per impostazione predefinita come numero di giorni. Se l'unità non è il giorno, specificala (unità accettate: ora/e; giorno/i; settimana/e; mese/i). Per gli intervalli di consegna, separa il valore minimo e quello massimo con un trattino. Indica l'unità solo se non si tratta di giorni.

Tipo di valore previsto: Numerico

Esempio: 12

Consiglio: questo campo è fortemente consigliato per integrare il catalogo nella piattaforma Lengow

Quantity_in_Stock

Corrisponde al numero di prodotti attualmente disponibili in magazzino

Tipo di valore previsto: Numerico

Esempio: 23

Consiglio: questo campo è fortemente consigliato per integrare il catalogo nella piattaforma Lengow ed è obbligatorio per la pubblicazione sulla maggior parte dei marketplace.

Availability

Disponibilità del prodotto. Valore numerico interpretato per impostazione predefinita come numero di giorni. 0 = disponibile in magazzino. Se l'unità non è il giorno, specificala (unità accettate: ora/e; giorno/i; settimana/e; mese/i). Se la disponibilità indica un intervallo, separa il valore minimo e quello massimo con un trattino. Indica l'unità solo se non si tratta di giorni.

Tipo di valore previsto: Numerico

Esempio: 0

Consiglio: questo campo è consigliato per integrare il catalogo nella piattaforma Lengow

MPN

Numero prodotto del produttore

Tipo di valore previsto: Alfanumerico

Esempio: PRD567HT

Consiglio: questo campo è fortemente consigliato per integrare il catalogo nella piattaforma Lengow

2.3 Formato CSV o TXT

I delimitatori accettati sono:

barra verticale/pipe (|)
virgola
punto e virgola
tabulazione

Assicurati che il file non contenga righe vuote.

2.4 Formato XML

I valori di testo non devono contenere:

> : sostituiscilo con >
< : sostituiscilo con <
& : sostituiscilo con &

È importante indicare il nome del nodo che identifica il prodotto.
Ad esempio, nell'immagine accanto, il nome del nodo è: <product>

Tutti gli attributi devono essere compilati nel primo prodotto; in caso contrario, non saranno visibili in Lengow, poiché l'indicizzatore si basa sul primo prodotto.

<?xml version="1.0" encoding="UTF-8"?>
<product>
    <product_id>1235RES56</product_id>
    <title>TV LCD 100 Hertz Samsung</title>
    <description>TV LCD 100 Hertz Samsuns, 47-inch screen...</description>
    <price_including_tax>790.99</price_including_tax>
    <pricenorebate>990.99</pricenorebate>
    <sale_price>690.99</sale_price>
    <category>High Tech &gt; TV &gt TV LCD</category>
    <sub_category1>High Tech</sub_category1>
    <sub_category2>TV</sub_category2>
    <sub_category3>TV LCD</sub_category3>
    <product_URL>http://mysite.com/productsXXXX.html</product_URL>
    <image_URL>http://www.mysite.com/Photos/Products/XXXXX.jpg</image_URL>
    <EAN>1234567890128</EAN>
    <MPN>PRD567HT</MPN>
    <brand>SAMSUNG</brand>
    <delivery_costs>5.00</delivery_costs>
    <delivery_time>12</delivery_time>
    <delivery_description>Same day delivery for London</delivery_description>
    <quantity_in_stock>23</quantity_in_stock>
    <Availability>0</Availability>
    <Warranty>3</Warranty>
    <size>47</size>
    <colour>Black</colour>
    <material/>
    <gender/>
    <weight>20.55</weight>
    <condition>new</condition>
    <sales>1</sales>
    <promo_texte/>
    <promo_percentage>30</promo_percentage>
    <start_date_promo>26-06-2016 08-00-00</start_date_promo>
    <end_date_promo>04-08-2016 16-00-00</end_date_promo>
    <ecotax>0</ecotax>
    <currency>EUR</currency>
</product>

2.5 Formato JSON

Ecco un esempio di catalogo prodotti in formato JSON.

[
 {
 "categorie": "High Tech > Télévision > Télévision LCD",
 "delai_de_livraison": 7,
 "description": "Télévision LCD 100 Hertz Samsung,47 pouces...",
 "devise": "EUR",
 "dimensions": {
 "hauteur": 65.0,
 "largeur": 120.0,
 "profondeur": 2.5
 },
 "ecotaxe": 0,
 "frais_de_livraison": 0,
 "garantie": 3,
 "id": 2,
 "marque": "Samsung",
 "prix": 399.0,
 "titre": "Télévision LCD 100 Hertz Samsung",
 "url_image": "http://monsite.com/photos/produit_2.jpg",
 "url_produit": "http://monsite.com/télévision/produit2"
 },
 {
 "categorie": "High Tech > Télévision > Télévision LCD",
 "delai_de_livraison": 7,
 "description": "Télévision LCD 200 Hertz Samsung, 50 pouces",
 "devise": "EUR",
 "dimensions": {
 "Hauteur": 70.0,
 "largeur": 125.0,
 "profondeur": 2.5
 },
 "ecotaxe": 0,
 "frais_de_livraison": 0,
 "garantie": 3,
 "id": 3,
 "marque": "Samsung",
 "prix": 499.0,
 "titre": "Télévision LCD 200 Hertz Samsung",
 "url_image": "http://monsite.com/photos/produit_3.jpg",
 "url_produit": "http://monsite.com/télévision/produit3"
 }
]

Aggiornato 30 ottobre 2026 14:37

Requisiti dei contenuti del catalogo

1. Codifica e formati supportati

Come salvare un file in formato CSV UTF-8 usando un foglio di calcolo?

2. Contenuti del catalogo prodotti

2.1 Consigli di Lengow

2.2 Struttura generale

2.3 Formato CSV o TXT

2.4 Formato XML

Commenti

Articoli in questa sezione