Feed prodotti
Specifiche tecniche per la creazione del feed prodotti per smartypilot
Formato del file
Il feed deve essere un file CSV con codifica UTF-8.
Il delimitatore deve essere punto e virgola (;) o virgola (,).
Il file deve contenere un'intestazione con i nomi dei campi, senza caratteri speciali o spazi.
Campi Obbligatori
ll feed deve contenere i seguenti campi obbligatori:
id
Stringa
ID univoco del prodotto
sku
Stringa
Codice SKU del prodotto
brand
Stringa
Marca del prodotto
main_image_url
Stringa
URL dell'immagine principale del prodotto
main_category_path
Stringa
Percorso della categoria principale (es: "Elettronica > Smartphone")
name
Stringa
Nome del prodotto
description
Stringa
Descrizione del prodotto senza HTML
ean
stringa
Codice EAN del prodotto (se disponibile)
product_url
Stringa
URL completo della pagina del prodotto nel sito eCommerce
final_price_no_reduction
Decimale
Prezzo originale senza sconti (es. "199.99")
final_price_with_reduction
Decimale
Prezzo finale scontato (es. "149.99")
currency
Stringa
Valuta del prezzo (es. "EUR")
availability
Booleano
Disponibilità del prodotto ("1" per disponibile, "0" per non disponibile)
quantity
Intero
Quantità disponibile
Campi Opzionali
Oltre ai campi obbligatori, è possibile includere i seguenti campi opzionali per migliorare la qualità del feed:
cost_price
Decimale
Prezzo di costo del prodotto
prices_other_currencies
Json
Prezzi in altre valute in formato JSON es. [ {'currency':'USD', 'price': '199.99'}, {'currency':'GBP', 'price': '234.99'} ]
has_combinations
Booleano
Indica se il prodotto ha varianti ("1" per sì, "0" per no)
min_quantity
Intero
Quantità minima acquistabile
Attributi personalizzati
È possibile aggiungere ulteriori colonne nel file CSV per rappresentare attributi specifici del prodotto. Queste colonne possono avere nomi a scelta e verranno considerate come attributi aggiuntivi del prodotto. Esempio:
id;sku;brand;main_image_url;main_category_path;name;description;ean;product_url;final_price_no_reduction;final_price_with_reduction;currency;availability;quantity;color;size;material
12345;ABC123;Samsung;https://example.com/image.jpg;Elettronica > Smartphone;Galaxy S21;Smartphone 5G con display AMOLED;8801643670429;https://example.com/prodotto/12345;899.99;799.99;EUR;1;50;Nero;128GB;Alluminio
Regole di validazione
Campi testuali: Non devono contenere caratteri speciali o HTML.
Campi numerici: Devono essere formattati senza separatore delle migliaia e con il punto come separatore decimale (es. "199.99").
URL: Devono essere validi e completi (iniziare con http:// o https://).
Categorie: Il campo main_category_path deve essere strutturato gerarchicamente con > come separatore.
Prezzi: Devono essere espressi come numeri decimali senza simboli di valuta. I prezzi possono essere indicati con o senza tasse (IVA) così come devono essere visualizzati nella ricerca e nel sito
Requisiti per l'aggiornamento del feed prodotti
Il feed deve essere accessibile tramite URL pubblico.
Il file deve essere aggiornato con cadenza regolare per riflettere cambiamenti di prezzo, disponibilità e nuovi prodotti.
La struttura del feed deve rimanere coerente nel tempo, senza modifiche ai nomi dei campi ad evvezzione degli attributi che possono essere aggiunti a piacere.
Seguire queste specifiche garantirà una corretta integrazione dei prodotti nel sistema di ricerca Smartypilot.
Last updated