Vse napisano s krepko pisavo so naša navodila uporabe Shoppster z MetaKocko. 

Ostalo so navodila, ki smo jih prejeli iz strani Shoppsterja, katera podrobneje opisujejo vsebinski del XML.

 

Nastavljena obvezna polja:

  • EAN
  • Pakiranje ID
  • Pakiranje količina
  • Šifra artikla
  • Kategorija
  • Shoppster kategorija
  • Blagovna znamka
  • Naziv
  • PPC z DDV
  • Nabavna cena
  • Opis
  • Atributi
  • Slike
  • Zaloga
  • Faktor pretvorbe
  • Davek
  • Bruto teža

Če artikel nima izpolnjenega katerega od teh polj, ne bo vključen v XML. Obvezna polja se lahko tudi ureja v Dodatnih nastavitvah -> Prilagoditev izvoza -> Shoppster izvoz -> Zahtevani parametri.

 

Če artikel ni bil vključen v XML, lahko v zavihu »Zahtevki« na Shoppster prilagoditvi vidite napake preko gumba »M« v seznamu oz če je preveč napak ne bo odprlo, zato kliknite na vrstico in uporabite gumb »Prenesi« (2x je potrebno klikniti).

 

V kolikor vam na MetaKocka artiklu manjkajo dodatna tekstovna polja potrebna za uporabo Shoppster izmenjave nas prosim kontaktirajte.

 

EAN
Vsak artikel mora imeti unikatno EAN kodo.

 

Primer: <ean>8055180386866</ean>

 

V primeru, da je izdelek komplet (sestavljen iz večih artiklov - več EAN kod) se EAN koda kompleta vpiše pod značko <ean_kompleta>, EAN kode posameznih artiklov, ki sestavljajo komplet pa v značke <ean1>, <ean2>… V tem primeru je potrebno izpolniti še značko <pakiranje>, kamor se zavede oblika pakiranja in število kosov pakiranja

 

Primer: <ean_kompleta> 5035048410646</ean_kompleta>

               <ean1> 5035048410647</ean1>

               <ean2> 5035048410648</ean2>

 

<pakiranje id="skatla">2</pakiranje>

 

A picture containing text, electronics, display Description automatically generated             Text Description automatically generated A picture containing text, electronics, display Description automatically generated

Izdelek 1 (ean1: 5035048410647) + Izdelek 2 (ean2: 5035048410648)         =               komplet (ean: 5035048410646)

 

METAKOCKA: EAN se bere iz polja »Bar (Ean) kode« iz artikla. Če je artikel komplet se v »ean1«, »ean2«,… zapišejo EAN kode artiklov v kompletu v kolikor so tudi tile artikli na ceniku za izmenjavo.

 

Pakiranje – ID (npr. škatla) se vpiše v dodatno polje »Tip pakiranja« na artiklu. Količina se avtomatsko izpolni glede na število artiklov v kompletu. Če artikel ni komplet, je število = 1.

 

SKU

V to značko se vpiše vaša interna šifra, če jo imate. V nasprotnem primeru lahko vpišete tudi EAN kodo. 

 

Primer: <SKU>1568</SKU>

 

METAKOCKA: Šifra artikla iz MK


KATEGORIJA / ŠIFRA KATEGORIJE

Artikel mora imeti določeno kategorijo. Pri kategorijah je pomembno, da so čim bolj podrobne oz. specifične. Kategorija "majica", ki vsebuje vse tipe majic (moške, ženske, kratki rokavi, dolgi rokavi) je preveč splošna. Potrebno je imeti več ločenih kategorij: "ženske majice s kratkimi rokavi", "moške majice brez rokavov", … Zraven imena dodajte tudi vašo šifro kategorije.

Primer: <kategorija>ženske majice s kratkimi rokavi 0123</kategorija>

METAKOCKA: Kategorije se vpiše, kot Shoppster zahteva, v dodatno polje na artiklu »Kategorija«.

 

Uporabi se lahko tudi obstoječ izbor kategorij v MK, katere se bodo v XML izpisale razdeljene z vejico, vendar je potrebno v prilagoditvi izvoza pri zahtevanih parametrih in XML odgovoru zamenjati »customCategory« z »category«.

 

ŠIFRA SHOPPSTER KATEGORIJE

V to značko se vpiše šifra naše kategorije, katera je povezana z razvrstitvijo artiklov v pravilno kategorijo na naši spletni strani. Seznam šifer kategorij vam posredujemo.

Primer: <sifra_kategorije>1568</ sifra_kategorije >

METAKOCKA: Shoppster šifra kategorije se vpiše v dodatno polje »Koda kategorije spl.tr«.

 

BLAGOVNA ZNAMKA

Vsak artikel mora imeti določeno blagovno znamko. Blagovna znamka naj bo zapisana v UPERCASE fontu.

 

Primer: <proizvajalec>SAMSUNG</proizvajalec>

 

METAKOCKA: Blagovna znamka se vpiše v dodatno polje »Blagovna znamka«

 

MODEL

V to značko se vpisuje modelna oznaka izdelka.

 

Primer: <model>WAN28262BY</model>

 

METAKOCKA: Model se vpiše v dodatno polje »Model«

 

NAZIV

Naziv artikla mora vsebovati tri podatke: BLAGOVNA ZNAMKA + tip artikla + modelna oznaka (ARMANI EXCHANGE + ženska majica s kratkimi rokavi + 8NYTDL YJ73Z).

<naziv>ARMANI EXCHANGE ženska majica s kratkimi rokavi 8NYTDL YJ73Z</naziv>

 

METAKOCKA: Naziv artikla v MK

 
PMPC

Priporočena maloprodajna cena z DDV. Ločilo naj bo pika.

 

Primer: <ppc>83.90</ppc>

 

METAKOCKA: PPC z ddv iz cenika. Upošteva se popust.

 

NABAVNA CENA

Neto nabavna cena za Shoppster v EUR. Ločilo naj bo pika.

 

Primer: <nabavna_cena>41.58</nabavna_cena> 

 

METAKOCKA: V dodatnih nastavitvah je potrebo izbrati »Dodatni cenik 1«. Izbran cenik mora biti nabavni cenik v katerega se za vsak artikel iz prodajnega cenika za izmenjavo, zapiše neto ceno (če je vpisan popust, se bo ta upošteval), katera se v XML uporabi za nabavno ceno.

 

 

OPIS

Opis naj bo v HTML obliki znotraj CDATA značke.

 

Primer: <opis>

<![CDATA[ Univerzalni fiksni stenski nosilec GoGEN za LED, LCD in plazemski televizor. Nosilec nudi hitro in enostavno vgradnjo na steno zahvaljujoč integrirani vodni tehtnici. Ima nastavljive ročice in inteligenten sistem pritrditve ročic na vodoravni konzoli. Nastavljive roke nudijo združljivost s standardi VESA do 200 x 200 mm.<br>Zasnova nosilca je preizkušena za TV-je do 43 "diagonale in teže do 30 kg.Tehnične lastnosti: - za diagonalo od 24˝ (62 cm) do 43" (106cm)<br>- primeren za: 75x75, 100x100, 200x100; 200x200<br>- oddaljenost TV-ja od stene 26mm<br>- maksimalna obremenitev 30 kg<br>- barva: črna<br>- vodna tehtnica<br><br>Garancija: 1 leto ]]>

</opis>

 

METAKOCKA: Opis artikla iz MK.

 

ATRIBUTI

Poleg opisa se doda tudi značko <atributi> v katero se vpisujejo lastnosti artikla, po katerih se lahko kasneje filtrira izdelke v kategoriji.

 

Primer: <atributi>

    <atribut id="Barva">črna</atribut>

    <atribut id="Blagovna_znamka">SAMSUNG</atribut>

    <atribut id="Diagonala_zaslona">127 cm (50 inch) </atribut>

    <atribut id="Energijski_razred">A</atribut>

</atributi>

 

Graphical user interface Description automatically generated

Primer prikaza filtra atributov.

 

METAKOCKA: Atribute se vnese preko dodatnega polja »Atributi« na tak način: »Barva=Bela;Velikost=M;Svetlost=200,…«. (brez navednic)

ID in vrednost atributa se ločuje z »=«, atributi so pa ločeni z »;«.

 

MEDIJI

 

  • Značka <slika>

 

Slike morajo biti v .jpg formatu. Linke/povezave slik se vpiše v eno vrstico in loči z vejico.

 

Primer: 

<slika>https://www.shoppster.si/nohtek/1600/xml-382-1903176-9999-7.jpg,https://www.shoppster.si/nohtek/1000/xml-382-1903176-9999-7-2.jpg</slike>

 

Na prvem mestu je vedno najpomembnejša slika.

A white washing machine Description automatically generated with medium confidence

Prikaz slik izdelka: prva slika bo vedno prikazana kot glavna slika izdelka, ostale slike so prikazane v galeriji

 

 

  • Značka <varnostni_list> 

Če je pri artiklu obvezen varnostni list, se ga doda v značko <varnostni_list> v obliki linka (PDF format).

Primer: <varnostni_list>http://test.com</varnostni_list>

 

  • Značka <produktni_list>

Če je pri artiklu obvezen produktni list, se ga doda v značko <produktni_list> v obliki linka(PDF format).

Primer: <produktni_list>http://test.com</produktni_list>

Graphical user interface, text, application Description automatically generated

Če je prisoten produktni/informacijski list se ob artiklu prikazuje label/nalepka z linkom do produktnega lista.

 

 

  • Značka <energijska_nalepka>  

Če je pri artiklu obvezana energijska nalepka, se jo doda v značko <energijska_nalepka> v obliki linka(PDF format).

Primer:<energijska_nalepka>http://test.com</energijska_nalepka>

Graphical user interface, text, application, chat or text message Description automatically generated

Če je prisotna energijska nalepka, se pri izdelku prikazuje label/nalepka z energijsko vrednostjo.

 

METAKOCKA: Glavna slika artikla se vpiše v dodatno polje »Slika velika«. Ostale slike se vpišejo v dodatno polje »Dodatna slika 1«. URL-ji dodatnih slik so v MK ločeni z »;«. 

Lahko se tudi uporabi samo polje »Dodatna slika 1« in je glavna slika prvi URL v seznamu.

 

Energijska nalepka, produktni list in varnostni list se vpišejo v istoimenska polja na artiklu.

 

BENEFIT

Če ima izdelek ugodnost/benefit (podaljšana jamstva, itd.) se doda v značko v obliki kode, ki vam jo posredujemo.

 

Primer:  <benefit>Bosch_pomivalni_stroji_5_let</benefit>

 

Graphical user interface, text, application Description automatically generated

Ugodnost/benefit je nato prikazan ob izdelku

 

METAKOCKA: Benefit se vpiše v dodatno polje »Benefit«.

 

ZALOGA

Zahtevana je številčna zaloga razpoložljivih kosov za dobavo/prodajo. 

 

V primeru, da je trenutna zaloga izdelka 0, vendar bo izdelek nazaj dobavljiv v relativno kratkem času (do 10 dni) se uredi podaljšan dobavni rok v skladu z vašim zapisanim dobavnim rokom v znački <dobavni_rok>. 

 

Primer: <zaloga>12</zaloga>

 

METAKOCKA: Zaloga se bere iz izbranih skladišč. Rezervacije se ne upoštevajo (Lahko se pa nastavi, da se).

 

FAKTOR PRETVORBE

V to polje se vpisuje številčna vrednost izdelkov v pakiranju artikla (primer: CD-R – pakiranje 10kos.) Podatek je obvezen zaradi preračuna cene za en kos. V primeru, da artikel predstavlja 1 kos se v polje vpiše vrednost 1.

 

Primer: <faktor_pretvorbe>10</faktor_pretvorbe>

 

METAKOCKA: Število kosov v paketu se vpisuje v polje »Kol./paket (koli)« na artiklu.


GARANCIJA
Vsak artikel naj ima podatek o garancijskem roku v mesecih. Oblika zapisa je vedno vrednost (24) + enota (mesecev)

 

Primer: <garancija>24 mesecev</garancija>

Graphical user interface, text, application, email Description automatically generated

Primer prikaza trajanja garancije pod opisom izdelka.

 

METAKOCKA: Garancija se vpiše v dodatno polje »Garancija«.


DAVEK

Vsak artikel mora imeti podatek o davčni stopnji. Zapise katere uporabljamo v sistemu so  si-22=22%, si-9.5=9,5%, si-5=5%).

Primer:<davek>si-22</davek>
 Če imajo vsi artikli enak davek (običajno 22) značka ni nujno potrebna.

 

METAKOCKA: Vpiše se v polje »DDV%« na prodajnem ceniku. »si-» se doda avtomatsko v XML.


BRUTO TEŽA

Teža artikla ja obvezen podatek (v kg). Bruto teža je teža artikla z transportno embalažo.

 

Primer: <bruto_teza enota="kg">70</bruto_teza>

 

METAKOCKA: Vpiše se v polje »Bruto teža« na artiklu. Je v KG.

 

 

LOGISTIČNI PODATKI

Polja vsebujejo podatke o velikosti artikla v transportni embalaži. Enota zapisa podatka je v cm.

 

Primer: <globina_bruto enota="cm">80</globina_bruto>

<sirina_bruto enota="cm">90</sirina_bruto>

<visina_bruto enota="cm">70</visina_bruto>

 

METAKOCKA: Vpisuje se v polja »Višina«, »Širina«, »Dolžina« na artiklu. So v mm.

 

 

PAKIRANJE

V značko se vpisuje oblika transportne embalaže samega artikla (škatla, paleta…).

 

Primer: <pakiranje id="skatla">1</pakiranje>

 

METAKOCKA: Pakiranje – ID (npr. škatla) se vpiše v dodatno polje »Tip pakiranja« na artiklu. Količina se avtomatsko izpolni glede na število artiklov v kompletu. Če artikel ni komplet, je število avtomatsko 1.

 

 

ID GROUP

Artikle lahko povežemo v skupine. Če obstajajo npr. slušlke v različnih barvah (velikosti), se lahko te artikle združi. Namen skupin je, da stranka lažje najde druge barve ali velikosti istega izdelka.

Graphical user interface Description automatically generated

 

Za ta namen potrebuje vsak artikel dva podatka. Prvi je <id_group> ki označuje vse artikle, ki spadajo skupaj. Vsi artikli iz iste skupine, morajo imeti enak <id_group>. To je lahko neka šifra ali številka, važno je samo, da je unikatna  za vsako skupino.

 

Primer: <id_group>AX125</id_group>

 

METAKOCKA: Vpisuje se v polje »ID skupine artiklov«.


VELIKOST/BARVA

Drugi podatek pomemben za grupiranje artiklov je barva in/ali velikost. To je podatek na podlagi katerega se grupirani artikli med seboj ločijo. Vsak artikel iz iste skupine mora imeti drugačno vrednost. Podatke vpišete v značko atributi in sicer vsakega v svojo podznačko.

 

Primer:

<atributi>

    <atribut id="Barva">bela</atribut>

    <atribut id="Velikost">M</atribut>

</atributi>

Chart, bubble chart Description automatically generated

 

 

 

 

 

 

 

 

Primer prikaza izbire barve in velikosti ob izdelku.

 

 

Opomba: Samo poimenovanje samih značk ni pomembno. 

 

METAKOCKA: Atribute se vnese preko dodatnega polja »Atributi« na tak način »Barva=Bela;Velikost=M;Svetlost=200,…«. Med ID in vrednostjo atributa je »=«, atributi so pa ločeni z »;«.