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.
Szczegóły w tabeli poniżej. - 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 člankutukaj.
- 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
Če imate dodatna vprašanja, nas lahko kontaktirate prek Centra za pomoč.
| 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. Tukaj vnesete kodo izdelka, ki je nato dodeljena tudi naročilom, na primer. Vsak ID mora biti edinstven. Ne sme biti enak kot ITEMGROUP_ID. Kombinacija največ 50 znakov, dovoljeni znaki so: _ – 0-9 a-z A-Z (podčrtaji, pomišljaji, številke od nič do devet, male in velike črke brez diakritičnih znakov). | |
| STAGE obvezni element | Določa, ali je izdelek viden na spletu. Prevzame vrednosti live/draft. V fazi implementacije (TESTING) je vedno treba poslati draft vrednosti, saj bi sistem vrednost live ocenil kot napako. Vrednosti live v tej fazi ni mogoče nastaviti. Izdelki se preklopijo v aktivno stanje šele po uspešnem preverjanju videza izdelka in vseh opravljenih nastavitvah.. Po preverjanju bo specialist za uvajanje vaš račun preklopil v zadnjo fazo – PRODUCTION. Nato vas bo obvestil, da je mogoče izdelke preklopiti v live stanje. Izdelki bodo nato vidni na spletni strani. Aktivne vrednosti ni mogoče vrniti v stanje osnutka. Za deaktivacijo izdelka 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 Vedno mora vsebovati kodo kategorije v skladu z našim drevesom kategorij za državo, kjer so izdelki implementirani. Dreva posameznih držav se lahko razlikujejo. Kategorični pogoji lahko vključujejo tudi obvezne elemente, ID kategorije morda ne bo zadostoval za pravilen prikaz izdelka. Vedno preverite kategorične pogoje za posamezne kategorije. | |
| BRAND_ID obvezni element | Identifikator blagovne znamke Vedno mora vsebovati kodo blagovne znamke oziroma ID blagovne znamke. Koda blagovne znamke ni enaka njenemu pravemu imenu. ID blagovne znamke najdete na portalu MALL Partner pod vsemi blagovnimi znamkami. Če vaša blagovna znamka še ne obstaja v našem sistemu, lahko ustvarite zahtevo za njeno izdelavo v skladu z navodili tukaj. | |
| TITLE obvezni element | Ime izdelka/variante Ne sme vsebovati imena blagovne znamke, saj se blagovna znamka samodejno doda na prvo mesto elementa BRAND_ID na spletnem mestu. Največja dolžina je 200 znakov. Vsebovati mora ključne besede in, če gre za varianto, njeno specifikacijo (na primer barvo). Posebni znaki niso dovoljeni. | |
| SHORTDESC obvezni element | Kratek opis izdelka Ne sme vsebovati znakov za oblikovanje ali HTML, samo cele povedi. Največja dolžina je 300 znakov. The maximum length is 300 characters. Kratek opis je prikazan v seznamu izdelkov na spletni strani, 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 | Sprejema vrednosti smallbox/bigbox škatla in označuje velikost paketa. Ta element povezuje izdelek s prevozom, zato je pomembno, da je vzpostavljen pravilen prevoz.. Smallbox škatla mora izpolnjevati 3 pogoje: – vsota vseh treh stranic paketa je do 175 cm – najdaljša stranica paketa je največ 100 cm – teža paketa je do 20 kg A Bigbox škatla je vsak paket, ki ne izpolnjuje zgornjih pogojev. | |
| BARCODE obvezni element | Koda EAN izdelka je za nas obvezna. Sistem sprejema 13 številskih znakov. Če ima vaša koda EAN 14 številskih znakov, jo vnesite kot 13 števk brez začetne ničle. Če imate krajšo 8-mestno kodo EAN, dodajte toliko ničel, kolikor manjka v 13 znakih. | |
| PRICE obvezni element | Cena izdelka vključuje DDV, ki velja za posamezno državo. Cena morda ne vključuje provizije. | |
| VAT obvezni element | DDV kot celo število (npr. 21). DDV mora ustrezati davčnim stopnjam, ki veljajo v državah, kjer se izdelki izvajajo.. | |
| RRP obvezni element | Priporočena maloprodajna cena V državah zunaj Češke republike kot ločilo uporabite piko ".". | |
| PARAM obvezni element | Parametri izdelka Tukaj se vnesejo samo parametri in vrednosti, ki so v našem sistemu definirani za dano kategorijo. Podrobne informacije o parametrih za posamezne kategorije najdete v razdelku Kategorije na portalu MALL Partner. | |
| PARAM obvezni element | NAME | Identifikator parametra Ne sme se uporabiti imena parametra, temveč njegov ID, ki je v angleškem jeziku (npr. COLOR). |
| PARAM obvezni element | VALUE | Vrednost parametra, ki mora biti vedno v lokalnem jeziku in v natančno določeni besedi (npr. "rdeča"). |
| VARIABLE_PARAMS obvezen element za variante | Označuje parametre, na podlagi katerih naj sistem ustvari različice. Lahko sta največ 2 (na primer velikost "SIZE" in barva "COLOR").. ELEMENT OBVEZEN SAMO ZA IZDELKE Z VARIANTNIMI IZDELKI | |
| 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 | Podvojene slike (URL ali vsebina) ni mogoče vstaviti. 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 je to glavna slika. Samo en element MEDIA lahko vsebuje vrednost true. |
| MEDIA obvezni element | Energijska nalepka je vstavljena tudi v medij. Upoštevajte, da je treba uporabiti vse elemente iz primera, sicer celoten vir izdelkov ne bo deloval. Obvezno le za izdelke, za katere so energijske nalepke potrebne zaradi 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 | V medij je vstavljen tudi Informativni list. Upoštevajte, da je treba uporabiti vse elemente iz primera, sicer celoten vir izdelkov ne bo deloval. Obvezno le za izdelke, za katere so informativni listi potrebni 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 formatu 2022-03-20T13:00:00) |
| PROMOTION izbirni element | TO | Veljavnost cene do (v formatu 2022-03-21T13:00:00) |
| DIMENSIONS obvezni element | Dimenzije izdelka za pošiljanje Pri vključevanju DIMENZIJ v vir je vedno treba vključiti vse elemente dimenzij,da se izdelki pravilno naložijo. Če morate na primer dodati samo dimenzijo teže (za oblikovanje cene pošiljanja na podlagi teže), za ostale dimenzije vnesite vrednost 0. | |
| DIMENSIONS obvezni element | WEIGHT | Teža v kg |
| DIMENSIONS obvezni element | WIDTH | Širina v cm |
| DIMENSIONS obvezni element | HEIGHT | Višina v cm |
| DIMENSIONS obvezni element | LENGTH | Dolžina v cm |
| LABEL izbirni element | Nalepke, ki jih lahko uporabite, najdete tukaj. Število nalepk na izdelku ni omejeno, vendar nobeni dve ne smeta biti 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-20T13:00:00) |
| DELIVERY_DELAY obvezni element | Označuje število polnih delovnih dni za dostavo izdelka. Vrednost mora biti celo število. Ta podatek je mogoče nastaviti tudi za celoten portfelj vseh razdelkov Transport na portalu MALL Partner. Nastavitev zakasnitve dostave za izdelek je nadrejena nastavitvi v transportu. Vrednost 0 pomeni, da so podatki vzeti iz nastavitve transporta. Vrednosti zakasnitve dostave za transport in za izdelek ali različico se ne seštevajo. | |
| TARIC_CODE obvezni element | Oznaka kombinirane nomenklature (KN), ki ustreza vašemu izdelku. Te oznake so ključne za carinske deklaracije pri uvozu ali izvozu blaga znotraj EU in v/iz EU. Če niste prepričani o pravilni oznaki, priporočamo uporabo uradne baze podatkov EU o kombinirani nomenklaturi ali posvetovanje s carinskim strokovnjakom. Sistem sprejme 8 številčnih znakov kode KN. |
Slovenščina 
Čeština 
English 
Magyar 
Hrvatski