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:

Campo Descrizione Obbligatorio Esempio
id/codice prodotto L’ID o un codice univoco del prodotto Si 012AF1245
Titolo Titolo o nome del prodotto Si (non richiesto per Amazon) Fotocamera Digitale Nikon 456
Descrizione La 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/e L’albero delle categorie a cui appartiene il prodotto Si (non richiesto per Amazon) Fotografia;Fotocamere;Compatte
Url scheda prodotto L’url pubblico della scheda del prodotto sul vostro sito Si (non richiesto per Amazon) http://www.mio-ecommerce.com/prodotti/012AF1245.html
Url immagine prodotto L’url pubblico di un’immagine del prodotto Si (non richiesto per Amazon) http://www.mio-ecommerce.com/foto-prodotti/012AF1245.jpg
Prezzo Il prezzo del prodotto, così come riportato sul vostro sito Si 899.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 prodotto No (Richiesto se omesso “Disponibilità”) 15
Marca La marca del prodotto Obbligatorio solo per Google Shopping Nikon
EAN Codice EAN (barcode) del prodotto Obbligatorio solo per Amazon e Google Shopping 0123456789123
MPN Codice fornitore del prodotto Obbligatorio solo per Google Shopping pix#1245AF
Spese spedizione Le spese di spedizione del prodotto No 5.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.


Categoria Canale

Il campo del listino che contiene il codice della categoria marketplace da assegnare al prodotto, deve essere un campo JSON e deve avere la seguente forma:

{“categories”: [{“channel”: channel_id1, “category_id”: “category_id1”}, {“channel”: channel_id2, “category_id”: “category_id2”}, …]}

il valori per “channel” sono dei numeri che identificano i vari eBay-IT, Amazon-IT, eBay-UK, Amazon-UK, etc.; di seguito l’elenco completo per eBay ed Amazon:

nome,channel_id
Amazon Canada,30
Amazon France,24
Amazon Germany,26
Amazon Italy,28
Amazon Japan,31
Amazon Spain,27
Amazon UK,25
Amazon USA,29
eBay Australia,43
eBay Austria,5
eBay Belgium (Dutch),7
eBay Belgium (French),6
eBay Canada,3
eBay Canada (French),20
eBay China,22
eBay France,8
eBay Germany,9
eBay Hong Kong,13
eBay India,15
eBay Ireland,16
eBay Italy,1
eBay Malaysia,17
eBay Netherlands,10
eBay Philippines,18
eBay Poland,19
eBay Singapore,14
eBay Spain,11
eBay Spain,44
eBay Sweden,23
eBay Switzerland,12
eBay Taiwan,21
eBay UK,4
eBay USA,2

Quindi ad esempio per eBay-IT, eBay-UK il campo può avere il seguente valore:

{“categories”: [{“channel”: 1, “category_id”: “453525”}, {“channel”: 4, “category_id”: “332412”}]}