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:

Nome campo	Tipo	Descrizione
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:

Nome campo	Tipo	Descrizione
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.