Vir izdelkov (product feed)

Najprej je treba ustvariti vir izdelkov, ki vsebuje vse informacije o izdelkih, razen njihove razpoložljivosti.

Pomembna pravila

  • Vrstni red elementov ni obvezen.
  • Vir vsebuje obvezne elemente, ki morajo biti vedno navedeni z ustreznimi vrednostmi.
    Podrobnejši pregled je na voljo spodaj.
  • Vse elemente brez vrednosti bo sistem ocenil kot napako. Pri obveznih elementih je treba dodati vrednost, pri neobveznih elementih pa je treba odstraniti celoten element. Prav tako ni mogoče poslati praznih elementov samo z uporabo zaključnega taga.
  • Izdelke, ki niso na zalogi, je potrebno ohraniti v zalogi izdelkov. Njihov prikaz na spletnem mestu nadzoruje Vir razpoložljivost. Podrobnejše informacije o tem, kako deaktivirati izdelek, so na voljo v članku tukaj..
  • Vsaka kategorija je označena z edinstvenim ID. Kategorijski pogoji lahko vključujejo tudi obvezne elemente, ki jih je treba vstaviti v vir z natančnimi vrednostmi.
    Izvoz drevesa kategorij skupaj s kategorijskimi pogoji lahko prenesete tukaj ali pa poiščete kategorijo na portalu MALL Partner Portal v razdelku Categories.
    Za podrobnejši opis kategorij, parametrov razvrščanja in njihovih vrednosti glejte članek tukaj.
    Sistem ne preverja pravilnosti pogojev razvrščanja. Izdelek z nepravilnimi ali manjkajočimi kategorijskimi pogoji ne bo prikazan na spletnem mestu. Pravilnost prikaza lahko preverite s svojim Sandbox računom.
  • Poskrbeti je treba, da se zagotovi možnost ustvarjanja skupin variantnih izdelkov, npr. majica v 10 barvnih različicah in 5 velikostih se zahteva kot ena skupina izdelkov/variantni izdelek. Za ustvarjanje različice izdelka so pomembni trije ključni elementi: ITEMGROUP_ID, ITEMGROUP_TITLE in VARIABLE_PARAMS. Vsi ti elementi so obvezni za ustvarjanje različic izdelkov. Podrobnejši opis teh elementov je na voljo v nadaljevanju.
  • Sistem vedno preverja izdelke po en element za drugim, dokler ne odkrije napake v podatkih o izdelku. Če odkrije napako, bo izdelek zapisan v dnevnik napak in sistem bo nadaljeval s preverjanjem naslednjega izdelka. Če je v določenem izdelku več kot ena napaka, je ob prvem predvajanju ni mogoče odkriti.

Tukaj lahko prenesete primere virov izdelkov v formatu .xml.

Opis elementov vira izdelka

ITEMS
obvezni element
 Osnovni element datoteke XML.
V viru je samo enkrat.
ITEM
obvezni element
 Vsebuje podatke o določenem izdelku ali različici.
ID
obvezni element
 ID izdelka ali različice. Tu vnesete kodo izdelka, ki se nato zapiše tudi na primer v naročila.
Vsak ID mora biti edinstven. Ne sme biti enak ITEMGROUP_ID.
Kombinacije z največ 50 znaki, dovoljeni znaki so: _, -, 0-9, a-z, A-Z (podčrtaji, vezaji, številke od nič do devet, male in velike črke brez naglasov).
STAGE
obvezni element
 Določa, ali je izdelek viden na spletu. Zavzema vrednosti live/draft.
V fazi testiranja (TESTING) je vedno treba poslati vrednost draft, vrednost live bi sistem ocenil kot napako. V tej fazi ni mogoče nastaviti vrednosti v live.
Preklop izdelkov v live se izvede šele po uspešnem preverjanju izgleda izdelka in izvedbi vseh nastavitev. Onboarding strokovnjak bo vaš račun po preverjanju preklopil v zadnjo fazo - PRODUCTION. Nato boste obveščeni, da lahko izdelke preklopite v live. Izdelki bodo nato vidni na spletnem mestu.
Vrednosti live ni mogoče vrniti v stanje draft. Če želite izdelek deaktivirati, uporabite eno od metod, opisanih tukaj.
ITEMGROUP_ID
obvezen element za variante
 Če gre za različico, ta element označuje ID skupine različic.
ITEMGROUP_ID mora biti edinstven in ne sme biti enak ID.
Kombinacije z največ 50 znaki, dovoljeni znaki so: _, -, 0-9, a-z, A-Z (podčrtaji, vezaji, številke od nič do devet, male in velike črke brez naglasov).
ELEMENT OBVEZNEN SAMO ZA IZDELKE Z RAZLIČICAMI
ITEMGROUP_TITLE
obvezen element za variante
 Če gre za različico, polje označi naslov osnovnega izdelka.
Vrednost mora vsebovati splošno ime skupine različic brez posebnosti posameznih različic (na primer brez barve, velikosti, ...).
ELEMENT OBVEZNEN SAMO ZA IZDELKE Z RAZLIČICAMI
CATEGORY_ID
obvezni element
 Identifikator kategorije
Vselej mora vsebovati kodo kategorije v skladu z našim drevesom kategorij za državo, kjer se izdelki prodajajo. Kategorijska drevesa držav se lahko razlikujejo.
Kategorijski pogoji lahko vključujejo tudi obvezne elemente, ID kategorije pa morda ne zadostuje za pravilen prikaz izdelka.
Vedno preverite kategorijske pogoje za vsako kategorijo.
BRAND_ID
obvezni element
 Identifikator blagovne znamke
Vedno mora vsebovati kodo blagovne znamke ali BRAND ID. Koda blagovne znamke ni enaka dejanskemu imenu blagovne znamke.
ID blagovne znamke najdete na portalu MALL Partner Portal v razdelku Brands. Če vaša blagovna znamka še ne obstaja v našem sistemu, ustvarite zahtevo za ustvarjanje v skladu z navodili tukaj..
TITLE
obvezni element
 Ime izdelka/različice
Ne sme vsebovati imena blagovne znamke, ker se blagovna znamka samodejno doda na spletno mesto na začetek naziva iz elementa BRAND_ID. Največja dolžina je 200 znakov.
Vsebovati mora ključne besede in, če gre za različico, njeno specifikacijo (npr. barva). 
SHORTDESC
obvezni element
 Kratek opis izdelka
Ne sme vsebovati oblikovnih znakov in znakov HTML, temveč le popolne stavke.
Največja dolžina je 300 znakov.
Kratek opis je prikazan v seznamu izdelkov na spletnem mestu, zato mora na kratko predstaviti izdelek.
LONGDESC
obvezni element
 Dolg opis izdelka
Vsebuje lahko osnovne oznake HTML, njegova največja dolžina pa je 13 000 znakov.
Vsebovati mora podrobnejši opis izdelka.
PRIORITY
obvezni element
 V polje vnesite vrednost 1.
Sistem samodejno razvršča izdelke s pomočjo algoritma, ki deluje na podlagi števila klikov, prometa in prodaje določenega izdelka. 
To je zastarel element, ki ga je še treba izpolniti, vendar sploh ni upoštevan. 
Trenutno si prizadevamo za njegovo odstranitev.
PACKAGE_SIZE
obvezni element
 Prevzema vrednosti smallbox/bigbox in označuje velikost paketa.
Ta element povezuje izdelek z možnostmi dostave, zato je pomembno, da imate pravilno nastavljene nastavitve dostave.
Smallbox mora izpolnjevati 3 pogoje
- vsota vseh treh strani paketa do 175 cm
- najdaljša stran paketa največ 100 cm
- teža paketa do 20 kg
Bigbox je vsak paket, ki ne izpolnjuje zgornjih zahtev.
 
BARCODE
obvezni element
 Koda EAN izdelka je obvezna. Sistem sprejema 13 številčnih znakov.
Če ima vaš EAN 14 številčnih znakov, ga vnesite kot 13 številk brez 0 na začetku. Če imate krajši osemmestni EAN, na začetek dodajte toliko 0, kolikor jih manjka do 13 znakov.
PRICE
obvezni element
 Cena izdelka vključno z DDV za posamezno državo. Cena ne sme vključevati provizije.
VAT
obvezni element
 DDV s celim številom (npr. 21). DDV mora ustrezati davčnim stopnjam, ki veljajo v državi, v kateri se izdelki prodajajo.
RRP
obvezni element
 Priporočena maloprodajna cena
V državah zunaj Češke republike kot ločilo uporabite piko ".".
PARAM
obvezni element
 Parametri izdelka
Tu se vnesejo samo parametri in vrednosti, ki so v našem sistemu opredeljeni za kategorijo. Podrobne informacije o parametrih za vsako kategorijo so na voljo v razdelku Kategorije na portalu za partnerje MALL.
PARAM
obvezni element
NAMEIdentifikator parametra
Ne sme se uporabljati ime parametra, temveč njegov ID, ki je v angleščini. (npr. COLOR).
PARAM
obvezni element
VALUEVrednost parametra, ki mora biti vedno v lokalnem jeziku in v natančno določenem besedilu (npr. "rdeča").
VARIABLE_PARAMS
obvezen element za variante
 Označuje parametre, na podlagi katerih mora sistem ustvariti različice. Na voljo sta lahko največ 2 (npr. velikost "SIZE" in barva "COLOR").
ELEMENT OBVEZNEN SAMO ZA IZDELKE Z RAZLIČICAMI
VARIABLE_PARAMS
obvezen element za variante
PARAMIdentifikator spremenljivega parametra (npr. COLOR).
Ime parametra ni vstavljeno, temveč njegov ID. 
ELEMENT OBVEZNEN SAMO ZA IZDELKE Z RAZLIČICAMI
MEDIA
obvezni element
 Slike/variante izdelka.
Največje število je 20, slike pa morajo biti na belem ozadju ali brez ozadja, brez logotipov, vodnih znakov ali nalepk.
Za več informacij o zahtevah glede videza izdelka glejte tukaj..
MEDIA
obvezni element
URLURL naslov slike
Vsebovati mora največ 200 znakov brez naglasov in presledkov. Največja velikost slike je 2 MB, njena ločljivost pa 2000 × 2000 pikslov. Najmanjša velikost je 100KB.
Če spremenite sliko, morate spremeniti tudi URL.
MEDIA
obvezni element
MAINVrednost true/false označuje, ali gre za glavno sliko. Samo en element MEDIA lahko vsebuje true.
MEDIA
obvezni element
Mediji vključujejo tudi Energijske nalepke.
Pazite, da uporabite vse elemente iz primera, sicer bo onemogočen celoten vir izdelkov.
Obvezno samo za izdelke, za katere se energijske nalepke zahtevajo iz zakonodajnih razlogov.
MEDIA
obvezni element
URLURL za energijsko nalepko
Vsebovati mora največ 200 znakov brez naglasov in presledkov. Največja velikost slike je 2 MB, njena ločljivost pa 2000 × 2000 pikslov. Najmanjša velikost je 100KB.
Če ga spremenite, morate spremeniti tudi URL.
MEDIA
obvezni element
MAINvedno vnesite vrednost FALSE
MEDIA
obvezni element
ENERGY_LABELvedno vnesite vrednost TRUE
MEDIA
obvezni element
INFORMATION_LISTvedno vnesite vrednost FALSE
MEDIA
obvezni element
Mediji vključujejo tudi Informativni list.
Pazite, da uporabite vse elemente iz primera, sicer bo onemogočen celoten vir izdelkov.
Obvezno samo za izdelke, za katere so informativni listi obvezni zaradi zakonodajnih razlogov.
MEDIA
obvezni element
URL URL informativnega lista
Vsebovati mora največ 200 znakov brez naglasov in presledkov. Največja velikost slike je 2 MB, njena ločljivost pa 2000 × 2000 pikslov. Najmanjša velikost je 100KB. Če ga spremenite, morate spremeniti tudi URL. 
MEDIA
obvezni element
MAIN vedno vnesite vrednost FALSE
MEDIA
obvezni element
ENERGY_LABEL vedno vnesite vrednost FALSE
MEDIA
obvezni element
INFORMATION_LIST vedno vnesite vrednost TRUE
PROMOTION
izbirni element
 Označuje promocijsko ceno izdelka. Za podrobnejši opis promocijske cene glejte tukaj..
PROMOTION
izbirni element
PRICEAkcijska cena z DDV.
PROMOTION
izbirni element
FROMVeljavnost cene od (v obliki 2022-03-20T13:00:00:00)
PROMOTION
izbirni element
TOCena velja do (v obliki 2022-03-21T13:00:00)
DIMENSIONS
izbirni element
 Dimenzije izdelka za prevoz
Pri vključevanju DIMENZIJ v feed je vedno treba vključiti vse elemente dimenzije za pravilno nalaganje izdelkov.
Če želite na primer dodati samo dimenzijo teže (za določanje cen dostave po teži), za druge dimenzije vnesite 0.
DIMENSIONS
izbirni element
WEIGHTTeža v kg
DIMENSIONS
izbirni element
WIDTHŠirina v cm
DIMENSIONS
izbirni element
HEIGHTVišina v cm
DIMENSIONS
izbirni element
LENGTHDolžina v cm
LABEL
izbirni element
 Oznake, ki jih je mogoče uporabiti, so na voljo tukaj..
Število nalepk na izdelku ni omejeno, vendar ne smeta biti dve enaki.
LABEL
izbirni element
NAMEIdentifikator etikete
Uporabite lahko osnovne oznake FDEL (brezplačna dostava), NEW (novo) in SALE (razprodaja). Vse druge nalepke lahko uporabite le po predhodnem posvetu s prodajalcem. 
LABEL
izbirni element
FROMDatum veljavnosti oznake od (2022-03-20T13:00:00)
LABEL
izbirni element
TODatum veljavnosti oznake do (2022-03-21T13:00:00)
DELIVERY_DELAY
obvezni element
 Označuje število polnih delovnih dni za dostavo izdelka.
Vrednost mora biti celo število.
Te informacije lahko nastavite tudi za celoten portfelj v zavihku Delivery na portalu za partnerje MALL. Nastavitev zakasnitve dostave na izdelku prevlada nad nastavitvijo v prevozu. Vrednost 0 pomeni, da se podatki prevzamejo iz nastavitev prevoza. Vrednosti zamude pri dostavi pri prevozu in izdelku ali različici se ne seštevajo.

Če imate dodatna vprašanja, nas lahko kontaktirate prek FAQ, Centra za pomoč.

Kako koristna je bila ta objava?

Kliknite zvezdico, da ocenite objavo!

Povprečna ocena: / 5. Število glasov:

Ni še glasov! Bodite prvi, ki bo ocenil to objavo.