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.
- Nevariantni izdelek z vsemi elementi
- Nevariantni izdelek, samo z obveznimi elementi
- Nevariantni izdelek z energijsko nalepko in informativnim listom
- Variantni izdelek z vsemi elementi
- Vzorec MALL XML FEED z vsemi primeri
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). Posebni znaki niso dovoljeni. | |
| 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. To so osnovne oznake HTML, ki jih lahko uporabite v dolgem opisu: <a>, <b>, <br>, <div>, <dl>, <dt>, <em>, <hr>, <i>, <img>, <li>, <ol>, <p>, <strong>, <sub>, <sup>, <table>, <tbody>, <td>, <tfoot>, <th>, <thead>, <tr>, <u>, <ul>. V oznakah ni treba uporabljati slogov po meri, brez njih se bo besedilo najbolje prilagodilo našim stranem. Če imate v opisu kakršne koli tabele, morate še vedno dodati <table class="“tbl“">da bo miza odzivna. | |
| 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 | NAME | Identifikator parametra Ne sme se uporabljati ime parametra, temveč njegov ID, ki je v angleščini. (npr. COLOR). |
| PARAM obvezni element | VALUE | Vrednost 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 | PARAM | Identifikator 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. Podvojene slike (URL ali vsebina) ni mogoče vstaviti. | |
| MEDIA obvezni element | URL | URL 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 | MAIN | Vrednost 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 | URL | URL 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 | MAIN | vedno vnesite vrednost FALSE |
| MEDIA obvezni element | ENERGY_LABEL | vedno vnesite vrednost TRUE |
| MEDIA obvezni element | INFORMATION_LIST | vedno 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 | PRICE | Akcijska cena z DDV. |
| PROMOTION izbirni element | FROM | Veljavnost cene od (v obliki 2022-03-20T13:00:00:00) |
| PROMOTION izbirni element | TO | Cena 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 | WEIGHT | Teža v kg |
| DIMENSIONS izbirni element | WIDTH | Širina v cm |
| DIMENSIONS izbirni element | HEIGHT | Višina v cm |
| DIMENSIONS izbirni element | LENGTH | Dolž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 | NAME | Identifikator 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 | FROM | Datum veljavnosti oznake od (2022-03-20T13:00:00) |
| LABEL izbirni element | TO | Datum 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č.
Slovenščina 
Čeština 
English 
Polski 
Magyar