V članku boste našli podrobne informacije o strukturi vira XML za izdelke in razpoložljivost MALL, vključno s pravili, ki jih je treba upoštevati pri ustvarjanju obeh virov.
Pomembna splošna pravila:
- Pri tem tipu povezave delujejo samo viri MALL XML v skladu s spodnjo strukturo.
Druge vrste virov ne delujejo, sistem jih ne naloži. - Struktura MALL XML virov je enaka za vse države, samo podatki, kot so drevesa kategorij, parametri, država DDV, se bodo spremenili glede na jezik države
- Heureka feed ne deluje za to povezavo. MALL XML feed in Heureka feed sta popolnoma različni vrsti feeda in se obravnavata kot 2 različni vrsti povezav. Prav tako ni mogoče kombinirati vrst virov. Prepričajte se, da imate v MALL Partner Portalu nastavljeno pravilno vrsto povezave. Če ste nastavili napačno vrsto povezave, pišite svojemu onboarding strokovnjaku.
- Zaloge ni mogoče vstaviti v vir izdelkov, ustvariti morate ločen vir razpoložljivosti.
- Podatke je treba ustvariti na spletno dostopne naslove URL v obliki XML in samo v kodiranju UTF-8. Oblike FTP ali FTPS ne dopuščamo.
- Testiranje vira poteka neposredno na Partnerskem portalu MALL. Ko so povezave URL ustvarjene, jih je treba vstaviti v portal v razdelek Feeds in jih zagnati. Rezultat obdelave je na voljo v zavihku Statistics, kjer so tudi sporočila o napakah, ki jih je treba opraviti. Navodila za vstavljanje virov v portal in kje najti sporočila o napakah lahko najdete v članku tukaj.
Priporočamo tudi, da vedno vklopite redno nalaganje v časovnih intervalih.
Na naslednjih straneh boste našli podroben opis dveh osnovnih oblik virov XML.
stran 2 : Vir izdelka
stran 3 : Vir razpoložljivosti
Če imate dodatna vprašanja, nas lahko kontaktirate prek Centra za pomoč.
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
| POŠTA obvezni element | Osnovni element datoteke XML. V viru je samo enkrat. | |
| TOČKA 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). | |
| STOPNJA 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. | |
| NASLOV 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. | |
| PRIORITETE 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. | |
| CENA obvezni element | Cena izdelka vključno z DDV za posamezno državo. Cena ne sme vključevati provizije. | |
| DDV obvezni element | 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 | IME | Identifikator parametra Ne sme se uporabljati ime parametra, temveč njegov ID, ki je v angleščini (npr. COLOR). |
| PARAM obvezni element | VREDNOST | 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 |
| MEDIJI 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. | |
| MEDIJI 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. |
| MEDIJI obvezni element | GLAVNI | Vrednost true/false označuje, ali je to glavna slika. Največ en element MEDIA lahko vsebuje true. |
| MEDIJI 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. | |
| MEDIJI 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. |
| MEDIJI obvezni element | GLAVNI | vedno vnesite vrednost FALSE |
| MEDIJI obvezni element | ENERGY_LABEL | vedno vnesite vrednost TRUE |
| MEDIJI obvezni element | INFORMATION_LIST | vedno vnesite vrednost FALSE |
| MEDIJI 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 se energijske nalepke zahtevajo iz zakonodajnih razlogov. | |
| MEDIJI 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. |
| MEDIJI obvezni element | GLAVNI | vedno vnesite vrednost FALSE |
| MEDIJI obvezni element | ENERGY_LABEL | vedno vnesite vrednost FALSE |
| MEDIJI obvezni element | INFORMATION_LIST | vedno vnesite vrednost TRUE |
| PROMOCIJA izbirni element | Označuje promocijsko ceno izdelka. Za podrobnejši opis promocijske cene glejte tukaj. | |
| PROMOCIJA izbirni element | CENA | Akcijska cena z DDV. |
| PROMOCIJA izbirni element | IZ | Veljavnost cene od (v obliki 2022-03-20T13:00:00:00) |
| PROMOCIJA izbirni element | NA | Cena velja do (v obliki 2022-03-21T13:00:00) |
| MERE 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. | |
| MERE izbirni element | TEŽA | Teža v kg |
| MERE izbirni element | ŠIRINA | Širina v cm |
| MERE izbirni element | VIŠINA | Višina v cm |
| MERE izbirni element | DOLŽINA | Dolžina v cm |
| OZNAČITEV 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. | |
| OZNAČITEV izbirni element | IME | 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. |
| OZNAČITEV izbirni element | IZ | Datum veljavnosti oznake od (2022-03-20T13:00:00) |
| OZNAČITEV izbirni element | NA | 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 Centra za pomoč.
Vir razpoložljivosti (availability feed)
Nastavitve vira za razpoložljivost izdelkov so enake kot za vir izdelkov, vendar je struktura datoteke XML drugačna.
Pomembna pravila
- Polje URL za vir razpoložljivosti ne sme vsebovati istega sklica kot krmo za izdelek.
- Podatkovni vir razpoložljivosti je vedno ločen in ima svojo obvezno strukturo.
- Vsi elementi v feedu so obvezni.
- Vrstni red elementov ni obvezen.
- Če imate v svoji ponudbi izdelkov variantne izdelke, morate razpoložljivost vedno poslati na ID variante, nikoli na ITEMGROUP_ID.
- Brisanje izdelkov iz vira razpoložljivosti ni veljaven način za deaktiviranje izdelkov.
Podrobnejše informacije o tem, kako deaktivirati izdelek, so na voljo tukaj. - Izdelek, ki obstaja v viru izdelkov, vendar zanj ni ekvivalenta v viru razpoložljivosti, ostane v sistemu z zadnjimi naloženimi informacijami.
- Navedba razpoložljivosti za variantne in nevariantne izdelke je enaka.
- Največje število kosov na zalogi je 9 999.
- Priporočamo, da vedno navedete dejanski inventar. Za blago, izdelano po naročilu, priporočamo, da kot razpoložljivost navedete največje število kosov, ki jih lahko naročite v enem naročilu.
- Številka razpoložljivosti je lahko podana le v celih številkah, vsaka druga številka bo ocenjena kot napaka in razpoložljivost ne bo predvajana.
POZOR:
Če ste v fazi ONBOARDING in vaš račun še ni bil aktiviran, mora polje ACTIVE vedno vsebovati vrednost "true".
Tukaj lahko prenesete primer vira razpoložljivosti v obliki .xml.
Opis elementov vira razpoložljivosti
| RAZPOLOŽLJIVOSTI | Osnovni element XML (v viru se pojavi samo enkrat). |
| DOSTOPNOST | Element, ki označuje razpoložljivost za posamezne izdelke in različice. |
| ID | ID/variante izdelka. Isti mora biti kot ID, ki ste ga določili v podajanju izdelka. |
| NA ZALOGI | Število kosov na zalogi. Če je število zalog 0, izdelek ostane na zalogi, prikazan bo kot nerazpoložljiv. Vedno mora biti naveden s polnim številom. |
| AKTIVNO | Prevzema vrednosti true/false, ki se uporablja za deaktiviranje izdelka, ki je na zalogi. Podrobnejše informacije o tem, kako deaktivirati izdelek, so na voljo tukaj. Pogoj za prikaz izdelka/variante na spletnem mestu je tudi, da je element ACTIVE nastavljen na vrednost true. |
Če imate dodatna vprašanja, nas lahko kontaktirate prek Centra za pomoč.