Specifiche tecniche feed catalogo

 

Premessa

Dopo aver aperto un ticket di assistenza per l'apertura di uno spazio FTP, dovrai depositare al suo interno il feed del catalogo che dovrà essere in formato .csv.

Quali campi servono nel feed?

Il feed dovrà contenere i seguenti dati:

Posizione dei campi, estensione del file e separatori

1. Posizione dei campi nel tracciato ed estensione del file

La posizione dei campi nel tracciato e l'estensione del file esportato sono indifferenti, poiché ogni integrazione viene personalizzata dal nostro staff per ciascun cliente.

2. Separatore campi/righe

I campi e le righe del feed devono essere separati tramite l'utilizzo di un simbolo.

Puoi utilizzare un qualsiasi separatore di campo o riga (i più usati sono "|" oppure ";"). 

Attenzione

  • non è possibile utilizzare lo stesso separatore sia per i campi che per le righe.

  • il simbolo che scegli come separatore di campo non deve essere presente come dato all’interno dei campi.

Esempio: se decidi di usare il punto e virgola come separatore di campo, questo simbolo non dovrà mai essere presente all'interno dei campi popolati e non potrà essere usato come separatore per le righe.


Condizione del prodotto

Opzionalmente è possibile inserire il campo relativo alle condizioni del prodotto.

Il campo Condizione deve contenere, a seconda dello stato del prodotto, uno dei seguenti valori:

 

Attenzione: il testo contenuto nel campo Descrizione condizioni non deve superare i 255 caratteri.


Inserzione con prezzo intero barrato e prezzo scontato

In caso di pubblicazione su un canale di vendita che supporta la gestione del prezzo barrato (es. sito e-commerce, eBay ecc.) è possibile mostrare due prezzi all'interno dell'inserzione:

  1. Prezzo intero sbarrato
  2. Prezzo scontato 

Per farlo, è necessario mappare nel feed del listino due colonne:

  • colonna "Prezzo 1": in questa colonna andrà inserito il prezzo scontato.
  • colonna "Prezzo 6": in questa colonna andrà inserito il prezzo di partenza non scontato (che apparirà sbarrato nell'inserzione).

Attenzione: il prezzo barrato (prezzo 6), per essere pubblicato, deve essere superiore al prezzo scontato (prezzo 1).


Come gestire le varianti

La gestione delle varianti cambia a seconda del canale di vendita sul quale scegli di pubblicare il catalogo:

  • per Amazon, Eprice, IBS, PcComponents, Leroy Merlin, ManoMano, Cdiscount le varianti sono identificate dal codice EAN e nel feed ogni variante è codificata da una riga di prodotto.
  • per eBay, Aliexpress e siti e-commerce le varianti devono essere raggruppate.
    Per raggruppare le varianti esse vanno codificate all'intero di un unico campo Varianti.
    Il campo deve avere 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)..

]

 

Attenzione: i campi in grassetto sono obbligatori. 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"

}

}

]


Come gestire gli attributi

La creazione degli attributi segue la stessa logica delle varianti, devono esserci una testa e una coda e dei valori al loro interno.

Di seguito un esempio:

{"attributes":
[
{"name":"Produttore processore","value":"Intel"},
{"name":"Famiglia processore","value":"Intel i5"},
{"name":"Modello del processore","value":"i5-1245U"},
{"name":"Generazione del processore","value":"Intel i5 di 12a generazione"}
]
}


Mappare la categoria canale a monte

Qualora non volessi mappare la categoria canale nelle impostazioni di pubblicazione di  SellRapido, puoi mappare questo valore direttamente all'interno del feed.

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”}, …]} 

I valori per "channel" sono dei codici che identificano canale di vendita e nazione di vendita. Di seguito l'elenco dei canali e relativi codici:

nome,channel_id

AliExpress English,424

AliExpress Español,430

AliExpress Français,427

AliExpress Italiano,421

Amazon Canada,30

Amazon France,24

Amazon Germany,26

Amazon Italy,28

Amazon Japan,31

Amazon MEX,325

Amazon Netherlands,460

Amazon Spain,27

Amazon Turkish,457

Amazon UK,25

Amazon United Arab Emirates,447

Amazon USA,29

Amzon POL,490

Bestshopping Italy,45

CDiscount France,37

Cliccaprezzi Italy,77

Custom,42

Daasy Italy,46

Doofinder Italy,63

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 Portugal,44

eBay Singapore,14

eBay Spain,11

eBay Sweden,23

eBay Switzerland,12

eBay Taiwan,21

eBay UK,4

eBay USA,2

eBayMotors,433

ePRICE Italy,38

Facebookproducts France,200

Facebookproducts Germany,216

Facebookproducts Italy,47

Facebookproducts Spain,232

Fnac Belgium,415

Fnac France,409

Fnac Portugal,418

Fnac Spain,412

Googleshopping,56

IBS Italia,68

Idealo Italy,57

Kelkoo Italy,58

Kijiji Italy,403

Kirivo Italy,40

Magento,86

Newcart,101

OnBuy UK,436

Pagomeno Italy,60

PixPlace Belgium,451

Pixplace France,34

Pixplace Germany,33

Pixplace Italy,32

PixPlace Portugal,454

Pixplace Spain,35

PixPlace UK,36

Prestashop English,391

Prestashop French,397

Prestashop German,400

Prestashop Italian,127

Prestashop Spanish,394

Rakuten France,273

Real.de Germany,444

Shoprapido English,140

Shoprapido French,179

Shoprapido German,153

Shoprapido Italian,39

Shoprapido Spanish,166

Shopify,360

Shopmania Italy,61

Trovaprezzi Italy,62

WooCommerce,406

Yatego Germany,41

 

Ad esempio per eBay-IT e eBay-UK il campo avrà il seguente valore:

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