Specifiche dei Feed di Prodotti e Listini

Premessa
Il feed, o listino, può essere in qualunque formato (txt, csv, xml) e il tracciato è indifferente poichè ogni integrazione viene personalizzata dal nostro staff per ogni singolo cliente. Un feed simile a quello che si utilizza per TrovaPrezzi, Kelkoo, Il Più Basso o il Bracco, andrà benissimo.

Come so se il mio sito fornisce un feed di prodotti?
Se inviate già i prodotti del vostro sito su un qualunque comparatore di prezzi, allora il vostro sito è già predisposto con un feed di prodotti: basterà quindi comunicarci la sua url per i servizi GoogleShopping e Amazon o specificare l’url nel apposito campo durante la creazione di uno store su Facebook con Shopping360.

Se invece non avete mai inviato prodotti su nessun comparatore di prezzi, vi suggeriamo di contattare chi amministra o ha realizzato il vostro sito, richiedendo l’implementazione di un feed per comparatori di prezzo, e facendo riferimento alle specifiche qui di seguito descritte.

Quali campi servono nel feed?
Il feed di cui necessitiamo dovrà esportare in formato testuale (txt, csv o anche xml) l’intero catalogo dei vostri prodotti con le seguenti informazioni:

CampoDescrizioneObbligatorioEsempio
id/codice prodottoL’ID o un codice univoco del prodottoSi012AF1245
TitoloTitolo o nome del prodottoSi (non richiesto per Amazon)Fotocamera Digitale Nikon 456
DescrizioneLa descrizione del prodotto in formato testuale o HTML.Si (non richiesto per Amazon)Una fotocamera compatta fa della semplicità di utilizzo e della grande maneggevolezza i suoi punti di forza. Questo rappresenta un grande vantaggio soprattutto per chi si affaccia per la prima volta sul mondo della fotografia, perchè non deve intervenire sui vari elementi che bisogna prendere in considerazione al momento di impostare lo scatto, ma può affidarsi agli automatismi della fotocamera. Anche l’obbiettivo fisso non sostituibile semplifica di molto la vita del fotografo in erba. Il contrappasso è rappresentato dall’impossibilità di studiare e personalizzare lo scatto in tutti i particolari
Categoria/eL’albero delle categorie a cui appartiene il prodottoSi (non richiesto per Amazon)Fotografia;Fotocamere;Compatte
Url scheda prodottoL’url pubblico della scheda del prodotto sul vostro sitoSi (non richiesto per Amazon)http://www.mio-ecommerce.com/prodotti/012AF1245.html
Url immagine prodottoL’url pubblico di un’immagine del prodottoSi (non richiesto per Amazon)http://www.mio-ecommerce.com/foto-prodotti/012AF1245.jpg
PrezzoIl prezzo del prodotto, così come riportato sul vostro sitoSi899.00
DisponibilitàLo stato di disponibilità del prodotto, espressa in formato numerico (con la giacenza del prodotto) o sotto-forma di testo “disponibile/non disponibile”No (Richiesto se omesso “Quantità”)disponibile
QuantitàLa disponibilità del prodotto espressa in formato numerico con la giacenza del prodottoNo (Richiesto se omesso “Disponibilità”)15
MarcaLa marca del prodottoObbligatorio solo per Google ShoppingNikon
EANCodice EAN (barcode) del prodottoObbligatorio solo per Amazon e Google Shopping0123456789123
MPNCodice fornitore del prodottoObbligatorio solo per Google Shoppingpix#1245AF
Spese spedizioneLe spese di spedizione del prodottoNo5.00
  • I campi possono essere separati da qualunque carattere purchè non utilizzato al interno dei campi stessi. I separatori di campi tipicamente utilizzati sono | o ;.
  • Le righe possono essere separate da qualunque carattere purchè non utilizzato al interno dei campi stessi, e purchè differente dal separatore di campi. I separatori di righe tipicamente utilizzati sono o [ritorno a capo].
  • I campi non obbligatori, se specificati possono migliorare il posizionamento dei vostri prodotti su eventuali comparatori di prezzo o su GoogleShopping.
  • I campi disponibilità e quantità possono essere omessi entrambi, solo nel caso in cui il vostro feed esporti solo i prodotti effettivamente disponibili sul vostro sito. Per Amazon è comunque richiesta l’informazione sulla giacenza dei prodotti. In assenza di questa informazione i nostri sistemi imposteranno una giacenza predefinita per tutti i prodotti su Amazon.
  • La posizione dei campi nel tracciato e l’estensione del file esportato sono indifferenti poichè ogni integrazione viene personalizzata dal nostro staff per ogni singolo cliente, purchè il feed non subisca modifiche sostanziali una volta elaborato dal nostro staff.

Condizioni

il campo “Condizione” deve contenere i valori sotto riportati per pubblicare la condizione del prodotto venduto:

eBay

nuovo: new (o lasciare vuoto)
usato: used
ricondizionato dal venditore: refurbished_seller
ricondizionato dal produttore: refurbished_manufacturer
come nuovo: like_new
usato (stato molto buono): used_very_good
usato (buono stato): used_good
usato (stato abbastanza buono): used_fairly_good

Amazon

usato: used
ricondizionato dal venditore: refurbished_seller
ricondizionato dal produttore: refurbished_manufacturer


Devi gestire anche delle varianti ?

Per Amazon, Eprice, Cdiscount le varianti sono identificate dal codice EAN.
Per pubblicare su EBAY , ogni prodotto può avere un numero qualsiasi di varianti che sono
codificate in un unico campo “varianti”.
Il campo varianti ha la seguente forma

[
{"sku": "codice_sku_univoco",
"quantity": quantità_variante,
"ean": "codice_ean",
"price": prezzo_variante,
"mpn": "codice_produttore",
"isbn": "codice_isbn",
"title": "titolo_variante",
"url_image": "immagine_variante",
"attributes": {
"nome1": "valore1",
"nome2": "valore2",
..(altri attributi)..
}
},
..(altre varianti)..
]

in grassetto i campi obbligatori (deve esserci almeno un attributo, tipo taglia, colore, materiale, …); di seguito un esempio:

[
{
"sku": "000700_0921S_010_249426",
"quantity": 1,
"ean": "8051774939005",
"attributes": {
"taglia": "46",
"colore": "nero"
}
},
{
"sku": "000700_0921S_010_244815",
"quantity": 2,
"ean": "8051774939012",
"attributes": {
"taglia": "48",
"colore": "rosso"
}
},
{
"sku": "000700_0921S_010_244816",
"quantity": 4,
"ean": "8051774939029",
"attributes": {
"taglia": "50"
}
},
{
"sku": "000700_0921S_010_244817",
"quantity": 2,
"ean": "8051774939036",
"attributes": {
"taglia": "52"
}
},
{
"sku": "000700_0921S_010_244819",
"quantity": 3,
"ean": "8051774939050",
"attributes": {
"taglia": "56"
}
},
{
"sku": "000700_0921S_010_244820",
"quantity": 5,
"ean": "8051774939067",
"attributes": {
"taglia": "58"
}
},
{
"sku": "000700_0921S_010_249427",
"quantity": 5,
"ean": "8051774939074",
"attributes": {
"taglia": "60"
}
}
]

Attributi (eBay)
Con Sellrapido Online è possibile inserire in un campo le specifiche dell’oggetto eBay.

Questo campo si chiama “Attributi”, è codificato come stringa JSON, ed è modificabile dalla scheda prodotto.

Per impostarlo direttamente nel listino occorre codificarlo come l’esempio seguente

{“attributes”: [{“name”: “Rapporto d’aspetto”, “value”: “250”},{“name”: “Diametro”, “value”: “10”},{“name”: “Larghezza”, “value”: “20”}]}

I nomi degli attributi debbono coincidere ESATTAMENTE con quelli voluti dal sito eBay di destinazione. Quindi il valore del campo “name” cambia da paese a paese.

Per tale ragione è necessario creare listini diversi per siti eBay diversi.


Compatibilità/K-type (eBay)

Con Sellrapido Online è possibile inserire in un campo le compatibilità dell’oggetto eBay.

Anche questi dati sono modificabili dalla scheda prodotto.

I k-type sono un caso particolare di compatibilità, rientrano quindi nella codifica del campo “compatibility”.

Tale campo deve avere la struttura JSON

{“compatibility”: [{“name”: “name1”, “value”: “value1”}, {“name”: “name2”, “value”: “value2”}, {“name”: “name3”, “value”: “value3”}, …]}

nel caso specifico dei k-type il name deve essere sempre uguale a “KType”, quindi ad esempio

{“compatibility”: [{“name”: ” KType “, “value”: “234145672”}, {“name”: ” KType “, “value”: “56222431”}, {“name”: ” KType “, “value”: “7901243”}]}

nel caso più generale il name assumerà valori dipendenti dalla categoria eBay di pubblicazione, ad esempio tipo “anno”, “modello”, “model”, “year”, etc.