CENEJE.SI SPECIFIKACIJA ZA XML IZVOZNO DATOTEKO

Ta dokument je namenjen programerjem, ki bodo pripravili XML izvoz za objavo izdelkov vaše spletne trgovine na Ceneje.si. V primeru, da nimate svoje programerske ekipe, ta navodila posredujte podjetju, čigar platformo uporabljate za svojo spletno trgovino.

Če želite, da je vaša prisotnost na Ceneje.si čimbolj učinkovita, zagotovite, da bo vaš XML izvoz vseboval vse pomembne elemente te XML specifikacije.

Po potrditvi ustreznosti vašega XML izvoza bomo poskrbeli za prenos vaših izdelkov iz XML izvoza na naš portal in kasneje redno posodabljali cene, razpoložljivost in druge informacije.

Optimiziran in pravilno narejen XML izvoz je ključen za uspešnost sodelovanja, saj gre za vaš prvi stik z našim portalom in vašimi potencialnimi strankami. Če svojo prisotnost začnete s slabimi podatki, ne gre pričakovati dobrih rezultatov.

Pregled

• Splošne informacije
  • Definicije
  • Hitra referenca
• Specifikacije elementov
  • Korenski element
  • Element izdelka
  • Osnovne informacije o izdelku
  • Cena in razpoložljivost
  • Kategorija izdelka
  • Identifikatorji izdelka
  • Dodatne informacije o izdelku
  • Dostava
  • Podrobne specifikacije izdelka
• Dodatne zahteve
• Primer XML datoteke
• Pogoste težave in napake

Splošne informacije

Specifikacija pred vami definira prikazovanje informacij na Ceneje.si. Oblikovanje dokumenta po spodnjih navodilih je ključnega pomena za dobre prodajne rezultate. Za pripravo XML izvoza se posvetujte s svojim skrbnikom spletne strani, saj se izvoz avtomatsko generira na vaših spletnih strežnikih.

DEFINICIJE

• Izdelek. Dejanski izdelek, ki ga bodo vaše potencialne stranke iskale na Ceneje.si
• Različica. Izdelek, ki obstaja v večih različicah. Na primer majica, ki obstaja v različnih barvah in/ali velikostih, ima barvne/velikostne različice.
• Element. Polje v XML, sestavljeno iz začetne značke, podatkov in zaključne značke.
• Atribut. Lastnost izdelka

HITRA REFERENCA

Elementi		Kategorije izdelkov
Skupina	Ime elementa	Oblačila in obutev	Različice izdelka	Ostale skupine izdelkov
Korenski element	<CNJExport>	R	R	R
Element izdelka	<Item>	R	R	R
Osnovne informacije o izdelku	<ID>	R	R	R
	<name>	R	R	R
	<description>	R	R	R
	<specification>	D	D	D
	<link>	R	R	R
	<mainImage>	R	R	R
	<moreImages>	D	D	D
	<videoUrl>	O	O	O
Cena in dobavljivost	<price>	R	R	R
	<regularPrice>	D	D	D
	<clubPrice>	O	O	O
	<curCode>	O	O	O
	<stockText>	O	O	O
	<stock>	R	R	R
	<inStoreAvailability>	O	O	O
	<store>	O	O	O
	<availability>	O	O	O
	<quantity>	O	O	O
Kategorija izdelka	<fileUnder>	R	R	R
	<cenCategoryId>	O	O	O
Identifikatorji izdelka	<brand>	D	D	D
	<EAN>	R	R	R
	<CUIN>	O	O	O
	<productCode>	D	D	D
	<productModel>	D	D	D
Dodatne informacije o izdelku	<condition>	D	D	D
	<warranty>	O	O	O
	<coupon>	O	O	O
	<gift>	O	O	O
Dostava	<deliveryCost>	R	R	R
	<deliveryTimeMin>	D	D	D
	<deliveryTimeMax>	D	D	D
Podrobne specifikacije izdelka	<groupId>	R	R	D
	<attributes>	R	R	R
	<gender>	R	D	D
	<color>	R	D	D
	<size>	R	D	D
	<ageGroup>	R	D	D
	<attribute>	R	R	R
	<name>	R	R	R
	<values>	R	R	R
	<value>	R	R	R

Spodaj najdete več podrobnosti, ki vključujejo informacije o minimalnih zahtevah in najboljših praksah ter primere za vsak element.

Specifikacije elementov

KORENSKI ELEMENT

ELEMENT IZDELKA

OSNOVNE INFORMACIJE O IZDELKU

Element	Oblika	Opis
<ID>	Obvezno / Required Edinstven identifikator izdelka Primer 546AB-1 Sintaksa Max 50 znakov	Uporabite unikatno vrednost za vsak izdelek. Tam kjer lahko, uporabite SKU šifro izdelka Ob posodabljanju podatkov vedno obdržite enak ID za isti izdelek Uporabljajte samo veljavne Unicode znake. Izogibajte se neveljavnim znakom kot so control, function, ali private area znaki Med izvozi za različne države uporabljajte enak ID za enake izdelke ID se ne sme spremeniti Enak ID ne sme nikoli biti uporabljen za drug izdelek.
<name>	Obvezno / Required Ime vašega izdelka Primer SAMSUNG hladilnik z zamrzovalnikom RB37J5018SA Sintaksa Max 200 znakov	Natančno opišite svoj izdelek Ime mora vsebovati ZNAMKO tip izdelka in MODEL Ne vključujte promocijskega besedila kot je "zastonj dostava" ali samo velike tiskane črke Za različice Vključite razlikovalni element (npr. barva). Za oblačila in obutev Ime ne sme vsebovati velikosti.
<description>	Obvezno / Required Opisni opis vašega izdelka Primer <p>Prostostoječ hladilnik z zamrzovalnikom ima 267 L prostornine hladilnega in 98 L prostornine zamrzovalnega dela.</p> <p>Police in predali v notranjosti so optimalno razporejeni, LED osvetljava pa omogoča vidljivost tudi ponoči.</p> Sintaksa ”Brez” omejitev	Celoten besedilni opis vašega izdelka Če imate besedilni opis izdelka, mora biti vključen v izvozu Besedilo mora biti v HTML kodi (brez oblikovanja!) Natančno opišite svoj izdelek – opis mora vsebovati enake podatke kot pristajalna stran Ne vključujte promocijskega besedila kot je "zastonj dostava" ali velikih tiskanih črk Vključite zgolj informacije o produktu, brez povezav do vaše trgovine, prodajnih informacij, podatkov o drugih ponudnikih, izdelkih ali dodatkih
<specification>	Obvezno / Required Specifikacije vašega izdelka Primer <ul>   <li>   Energijski razred: A +   </ li>   <li>   Prostornina: 217 litrov   </ li>   <li>   Dimenzije: 181x59x64   </ li>   <li>   Funkcija Auto defrost: da   </ li> </ ul> Sintaksa “Brez” omejitev	Vse specifikacije vašega izdelka Če imate specifikacije izdelka, morajo biti vključene v izvozu Specifikacije morajo biti v HTML kodi (brez oblikovanja!) Samo točne specifikacije izdelka - vsebovati morajo enake informacije kot pristajalna stran Ne vključujte promocijskega besedila kot je "zastonj dostava" ali velikih tiskanih črk Vključite zgolj informacije o produktu, brez povezav do vaše trgovine, prodajnih informacij, podatkov o drugih ponudnikih, izdelkih ali dodatkih Če specifikacij ne morete izločiti iz svojega opisa, jih vključite v element <description>
<link>	Obvezno / Required Pristajalna stran vašega izdelka Primer https://www.example.org/product-id Sintaksa Max 400 znakov	Neposreden URL naslov do vašega izdelka Začeti se mora s http ali https Za spremljanje uspešnosti prodaje (obiskanost, stopnja konverzije) URL-jem dodajte svoje lastne UTM parametre.
<mainImage>	Obvezno / Required URL slike, ki najbolje predstavlja vaš izdelek Primer https://www.example.org/image1.jpg Sintaksa Max 200 znakov	Za URL slike: Neposreden URL do glavne slike vašega izdelka Začeti se mora s http ali https URL mora biti brez presledkov, naglasov in posebnih znakov (na primer ć, č, đ, š, ž, ü, …) Za sliko: Natančna predstavitev izdelka, ki ga prodajate Mora biti najvišje resolucije, ki vam je na voljo Uporabite splošno veljavne formate: statičen GIF (.gif), JPEG (.jpg/.jpeg), PNG (.png) Za izdelke, ki ne spadajo v kategorijo Oblačil & obutve, uporabite sliko velikosti vsaj 300 x 300 pixlov Za izdelke iz kategorije Oblačil & obutve, uporabite sliko velikosti vsaj 600 x 600 pixlov Ne uporabljajte raztegnjenih ali miniaturnih slik Ne sme vključevati promocijskih besedil, vodnih žigov, oznak trgovine ali obrob Ne vključujte generičnih slik za izdelke brez slik
<moreImages>	Obvezno / Required (ko ima vaš izdelek več kot eno sliko) Priporočeno / Optional (ko ima vaš izdelek le eno sliko) URL-ji dodatnih slik vašega izdelka. URL-ji so med seboj ločeni z vejico. Primer https://www.example.org/image2.jpg, https://www.example.org/image3.jpg, https://www.example.org/image4.jpg Sintaksa Max 1000 znakov	Zahteve so enake tistim za element <mainImage>
<videoUrl>	Priporočeno / Optional URL povezava do videoposnetka vašega izdelka. Primer https://www.youtube.com/watch?v=x1La2Y140Bc Sintaksa Max 400 znakov	V primeru, da imate vi ali proizvajalec izdelka na voljo videoposnetek o izdelku, ga lahko vključite tu Sprejete bodo samo URL povezave z www.youtube.com

CENA IN RAZPOLOŽLJIVOST

Element	Oblika	Opis
<price>	Obvezno / Required Cena vašega izdelka Primer 1230.99 Sintaksa Številčna vrednost	Točna cena vašega izdelka, ki vključuje vse davke Cena se mora ujemati s ceno na vaši pristajalni strani Kot decimalno ločilo se lahko uporabi pika ali vejica Čez cel dokument uporabljajte enako decimalno ločilo Poskrbite, da vaša pristajalna stran izdelka vključuje ceno v pravilni valuti in na jasni in vidni poziciji Izdelek mora biti na voljo za spletni nakup po predloženi ceni Vsak kupec v državi prodaje mora imeti možnost nakupa izdelka po tej ceni in brez plačila članstva Ne predložite cene 0. Cena z vrednostjo 0 je sicer dovoljena, vendar izdelki s to ceno ne bodo objavljeni na Ceneje.si)
<regularPrice>	Obvezno / Required (ko je izdelek znižan) Priporočeno / Optional (ko izdelek ni znižan) Cena izdelka pred znižanjem Primer 1430.99 Sintaksa Številčna vrednost	Obvezno ko ima izdelek znižano ceno Točna cena izdelka z vključenimi davki pred znižanjem Kot decimalno ločilo se lahko uporabi pika ali vejica Čez cel dokument uporabljajte enako decimalno ločilo
<clubPrice>	Priporočeno / Optional Cena vašega izdelka za člane Primer 1130.99 Sintaksa Številčna vrednost	Točna cena vašega izdelka z vključenimi davki za člane vašega kluba Kot decimalno ločilo se lahko uporabi pika ali vejica Čez cel dokument uporabljajte enako decimalno ločilo
<curCode>	Priporočeno / Optional Valuta cen v izvozu Primer EUR Dovoljene vrednosti EUR HRK RSD BAM	Edine dovoljene vrednosti so: EUR (Euro) HRK (Hrvaška kuna) RSD (Srbski dinar) BAM (konvertibilna marka Bosne in Hercegovine)
<stockText>	Priporočeno / Optional Opisna vrednost zaloge izdelka Primer Samo 10 izdelkov na zalogi Sintaksa Max 30 znakov	Natančno predložite opisno zalogo vašega izdelka, ki se mora ujemati z zalogo pristajalne strani izdelka Navedite samo točne podatke o zalogi Dodatni primeri: Zadnji kos 2 – 3 dni Preverite ...
<stock>	Obvezno / Required Zaloga vašega izdelka Primer Ni na zalogi Dovoljene vrednosti in stock preorder out of stock	Predložite točno zalogo izdelka, ki se mora ujemati z zalogo na vaši pristajalni strani izdelka. Predložite samo točne podatke o zalogi Dodatna razlaga dovoljenih vrednosti: in stock (izdelek bo odposlan najkasneje 1 dan po naročilu ali je na voljo za osebni prevzem) preorder (izdelek bo odposlan v 2 do 10 delovnih dneh od datuma naročila ali bo na voljo za osebni prevzem) out of stock (izdelek nima znanega datuma dostave)
<inStoreAvailability>	Priporočeno / Optional Vsebuje elemente z informacijami o razpoložljivosti v fizičnih poslovalnicah – dostopno za osebni prevzem Ti elementi so: <store> <availability> <quantity>	Element morate ponoviti za vsako lokacijo vaše trgovine.
<store>	Priporočeno / Optional Lokacija vaše trgovine Primer BTC Hala A, Šmartinska cesta 152, 1000 Ljubljana Sintaksa Max 100 znakov	Vključite točno lokacijo trgovine v naslednji obliki: Nakupovalno središče (opcijsko) Ulica in hišna številka (obvezno) Poštna številka & kraj (obvezno) podatke ločite z vejico (,)
<availability>	Priporočeno / Optional Ali je izdelek na voljo za osebni prevzem in kdaj Primer today Dovoljene vrednosti today tomorrow no	Točno vpišite ali in kdaj je izdelek na voljo za osebni prevzem v trgovini (ki jo določite v elementu <store>) Vključite samo točne podatke Dodatna razlaga dovoljenih vrednosti: today (stranka lahko vstopi v trgovino kadarkoli v delovnem času in kupi ta izdelek ALI izdelek naroči na spletu in ga prevzame isti dan med delovnim časom) tomorrow (stranka lahko izdelek naroči na spletu in ga prevzame najkasneje jutri v delovnem času poslovalnice) no (izdelek ni na voljo za osebni prevzem) »Today« in »tomorrow« se nanaša le na delovne dni.
<quantity>	Priporočeno / Optional Količina izdelkov, ki so na voljo v določeni poslovalnici Primer 10 Sintaksa Celo število, večje ali enako 0	Točno navedite število razpoložljivih izdelkov za nakup in prevzem v poslovalnici (ki ste jo definirali v element <store> element) Vključite samo točne podatke

KATEGORIJA IZDELKA

Element	Oblika	Opis
<fileUnder>	Obvezno / Required Celotna kategorizacija vašega izdelka Primer Moška oblačila in dodatki > Oblačila > Plašči in jakne Sintaksa Max 400 znakov	Točna struktura kategorizacije izdelka z vaše spletne trgovine Izjemno pomembno za razvrščanje izdelkov v kategorije na Ceneje.si Vključite le eno kategorizacijo Vključite najpomembnejšo kategorizacijo Vključite celotno pot kategorije: Glavna kategorija - Kategorija - Podkategorija
<cenCategoryId>	Priporočeno / Optional ID kategorije z našega portala Primer 1528 Sintaksa Max 10 številskih znakov	Predložite ID kategorije z našega portala, kamor spada vaš izdelek Če bi želeli predložili te podatke nas prosim kontaktirajte, da vam pošljemo našo kategorizacijo Izdelki s tem podatkom bodo v Ceneje.si kategorije razvrščeni v roku 48 ur

IDENTIFIKATORJI IZDELKA

Element	Oblika	Opis
<brand>	Obvezno / Required (za vse izdelke z znamko) Priporočeno / Optional (za izdelke brez znamke) Ime znamke vašega izdelka Primer Samsung Sintaksa Max 50 znakov	Navedite blagovno znamko izdelka, kot jo poznajo potrošniki Če podatka o znamki nimate, pustite ta element prazen. Ne uporabljajte vrednosti kot so N/A, Generic, Brez znamke ali Ne obstaja V primeru kompatibilnih izdelkov ali kopij, ne navajajte znamke proizvajalca originalne opreme (OEM – Original Equipment Manufacturer)
<EAN>	Obvezno / Required (za vse nove izdelke s predpisanimi EAN kodami s strani proizvajalca) Priporočeno / Optional (za vse izdelke brez EAN kode) EAN ali GTIN (Global Trade Item Number) koda vašega izdelka Primer 8806088059785 Sintaksa Natančno 13 številskih znakov	EAN kodo morate vključiti, če ta obstaja za vaš izdelek Navedite le veljavne EAN kode, kot so definirane v uradnem vodiču GS1. ta vključuje te zahteve: Kontrolna cifra je vključena in pravilna EAN ni omejen (predpona GS1 v razponu 02, 04, 2) EAN ni kupon (predpona GS1 v razponu 98-99)
<CUIN>	Priporočeno / Optional CUIN koda izdelka s Ceneje.si, ki se natančno ujema z vašim izdelkom Primer CX0078266A Sintaksa Max 10 znakov	CUIN koda je unikatna koda izdelka s Ceneje.si. Kodo lahko najdete ob vsakem izdelku na Ceneje.si (v zavihku “Podatki”) Vaši izdelki s CUIN kodami se bodo avtomatično povezali z obstoječimi izdelki na Ceneje.si v roku 48 ur
<productCode>	Obvezno / Required (za vse izdelke iz kategorij pnevmatik) Priporočeno / Optional (za vse ostale izdelke) Interna ali dobaviteljeva koda vašega izdelka Primer 516843-845 Sintaksa Max 20 znakov	Kakršna koli koda izdelka, ki vam je na voljo – lahko je proizvajalčeva koda izdelka Če je vaš izdelek iz kategorije pnevmatik, morate na tem mestu vključiti SAP kodo vašega izdelka (6-mestno število)
<productModel>	Priporočeno / Optional Your product’s manufacturers code (model) Primer RB37J5018SA Sintaksa Max 20 characters	Model vašega izdelka Uporabite čimbolj specifičen model izdelka. Na primer, različne barve enakega izdelka morajo imeti različne modele

DODATNE INFORMACIJE O IZDELKU

Element	Oblika	Opis
<condition>	Obvezno / Required (za vse izdelke, ki niso novi in imajo status renew, refurbished, reboxed ali so rabljeni) Priporočeno / Optional (za vse nove izdelke) Stanje vašega izdelka Primer new Sintaksa new new renew refurbished reboxed used	Natančno navedite stanje vašega izdelka
<warranty>	Priporočeno / Optional Informacije o garanciji vašega izdelka Primer 3 leta Sintaksa Max 50 znakov
<coupon>	Priporočeno / Optional Kupon, ki ga kupec prejme ob nakupu tega izdelka Primer Ob nakupu prejmete kupon za 5 % popust ob vašem naslednjem nakupu Sintaksa Max 150 znakov
<gift>	Priporočeno / Optional Darilo, ki ga kupec prejme ob nakupu tega izdelka Primer majica Sintaksa Max 150 znakov

DOSTAVA

Element	Oblika	Opis
<deliveryCost>	Obvezno / Required Cena dostave vašega izdelka Primer 3.45 Sintaksa Številčna vrednost	Natančno navedite ceno dostave izdelka Kot decimalno ločilo se lahko uporabi pika ali vejica Čez cel dokument uporabljajte enako decimalno ločilo
<deliveryTimeMin>	Obvezno / Required (za vse elemente, ki imajo v elementu <stock> vrednost in stock ali preorder) Priporočeno / Optional (za vse ostale izdelke) Najkrajši čas (v dnevih) od naročila do dostave izdelka. Primer 2 Sintaksa Celo število, večje ali enako 0	Najkrajši možni čas (v dnevih) za dostavo izdelka Upoštevajte le delovne dni, brez vikendov Za navajanje časovnega obdobja predložite <deliveryTimeMin> v kombinaciji z <deliveryTimeMax>
<deliveryTimeMax>	Obvezno / Required (za vse elemente, ki imajo v elementu <stock> vrednost na in stock ali preorder) Priporočeno / Optional (za vse ostale izdelke) Najkrajši čas (v dnevih) od naročila do dostave izdelka. Primer 3 Sintaksa Celo število, večje ali enako 0	Najdaljši možni čas (v dnevih) za dostavo izdelka Upoštevajte le delovne dni, brez vikendov Za navajanje časovnega obdobja predložite <deliveryTimeMin> v kombinaciji z <deliveryTimeMax>

PODROBNE SPECIFIKACIJE IZDELKA

Element	Oblika	Opis
<groupId>	Obvezno / Required (za vse izdelke, ki so različice) Priporočeno / Optional (za vse ostale izdelke) ID za skupino izdelkov, ki obstajajo v različnih različicah Primer 546AB Sintaksa Max 50 znakov	Uporabite unikatno vrednost za vsako skupino različic. Kjer lahko, uporabite SKU šifro starševskega izdelka Ob posodabljanju podatkov vedno obdržite enak ID za isto skupino izdelkov Uporabljajte samo veljavne Unicode znake. Izogibajte se neveljavnim znakom kot so control, function, ali private area znaki Element <groupId> uporabite za skupino izdelkov, ki se razlikujejo po eni ali več spodnjih lastnosti: <color> (barva) <size> (velikost) <gender> (spol) <ageGroup> (starostna skupina) Za vsak izdelek v skupini vključite enake elemente. Na primer, če se izdelek razlikuje po velikosti in barvi, vključite elemente <size> in <color> za vsak izdelek, ki ima enak <groupId> Če se vaši izdelki razlikujejo po lastnostih, ki niso vključeni v zgornje elemente, ne uporabite tega elementa
<attributes>	Obvezno / Required Ta element vsebuje vse atribute izdelka, vsakega v svojem <attribute> elementu. Vključuje tudi nekaj vnaprej definiranih atributov v obliki elementov: <gender> <color> <size> <ageGroup>	Vključite vse atribute, ki jih ima vaš izdelek
<gender>	Obvezno / Required(za vse izdelke, ki so različice in za izdelke iz kategorij oblačil in obutve) Priporočeno / Optional(za vse ostale izdelke) Spol, kateremu je namenjen izdelek. Primer male Supported values unisex female male	Za različice: Vključite enako vrednost <groupId> in različne vrednosti za <gender>
<color>	Obvezno / Required (za vse izdelke, ki so različice in za izdelke iz kategorij oblačil in obutve) Priporočeno / Optional (za vse ostale izdelke) Barve vašega izdelka Primer bela Sintaksa Max 40 znakov	Ne uporabljajte številk (npr. 0 2 4 6 8) Ne uporabljajte znakov, ki niso alfanumerični (npr #fff000) Ne uporabljajte zgolj ene črke (npr. R) Ne sklicujte se na sliko (npr. “kot na sliki“) Ne združite več barv v eno besedo, ampak jih ločite z / (npr. namesto RdečaRozaModra uporabite Rdeča / Roza / Modra) Ne uporabite vrednosti, ki ni barva (npr. različno, več, N/A, moško, žensko) Za različice: Vključite enako vrednost <groupId> in različne vrednosti za <color>
<size>	Obvezno / Required (za vse izdelke, ki so različice in za izdelke iz kategorij oblačil in obutve) Priporočeno / Optional (za vse ostale izdelke) Velikost vašega izdelka Primer XL EU 42 Sintaksa Max 40 znakov	Za različice: Vključite enako vrednost <groupId> in različne vrednosti za <size> V primeru različnih velikosti za različne trge morate definirati za kateri trg velja navedena velikost. Primeri: EU 41 US 8 UK 7.5
<ageGroup>	Obvezno / Required (za vse izdelke, ki so različice in za izdelke iz kategorij oblačil in obutve) Priporočeno / Optional (za vse ostale izdelke) Starostna skupina, kateri je namenjen izdelek Primer adult Supported values newborn infant toddler kids adult	Vključite eno vrednost na izdelek Za različice: Vključite enako vrednost <groupId> in različne vrednosti za <ageGroup> Dodatna razlaga dovoljenih vrednosti: newborn (do 3 mesecev starosti) infant (med 3 in 12 meseci starosti) toddler (med 1 in 5 let starosti) kids (med 5 in 13 let starosti) adult (najstniki in starejši)
<attribute>	Obvezno / Required Vsak atribut vašega izdelka spada v ločen <attribute> element. Ta vsebuje sledeča elementa: <name> <values>	Vključite vse atribute, ki jih ima vaš izdelek Vrednosti vnaprej definiranih atributov vključite v spodnjih elementih: <gender> <color> <size> <ageGroup>
<name>	Obvezno / Required Ime atributa, katerega vrednost boste vključili Primer Material Sintaksa Max 100 znakov
<values>	Obvezno / Required Ta element vsebuje vse vrednosti za ta atribut. Vsakega vključite v svojem <value> element.	Vključite vse vrednosti atributa, ki jih ima vaš izdelek
<value>	Obvezno / Required Vrednost prej določenega atributa Primer 100% bombaž Sintaksa Max 100 znakov

Dodatne zahteve

• XML izvoz oblikujte po zgornjih navodilih. Za boljše razumevanje je spodaj priložen primer XML izvoza. Dodatno XML datoteko z različnimi primeri izdelkov lahko prenesete tukaj (ali pa ste jo prejeli na elektronki naslov kot priponko). Datoteko odprite v primernem programu (priporočamo Notepad++), saj vključuje tudi komentarje.
• XML datoteko shranite na svojem strežniku in nam pošljite URL povezavo do nje. Do tega URL-ja bomo redno dostopali z namenom posodabljanja vaših podatkov o izdelkih na Ceneje.si.
• Nekatere informacije se v našo bazo prenesejo samo enkrat, zato je za te podatke še posebej pomembno, da že na začetku vključite le pravilne in končne informacije. Dodatne spremembe teh podatkov prinesejo dodatne stroške. Dnevno posodabljamo le spodnje podatke:
  • <CUIN>
  • <link>
  • <price>
  • <regularPrice>
  • <clubPrice>
  • <stockText>
  • <stock>
  • <inStoreAvailability>
  • <store>
  • <availability>
  • <quantity>
  • <cenCategoryId>
  • <deliveryCost>
  • <deliveryTimeMin>
  • <deliveryTimeMax>
  • <condition>
  • <warranty>
  • <coupon>
  • <gift>

Primer XML datoteke

<?xml version="1.0" encoding="UTF-8"?>
<CNJExport>
<Item>
<ID><![CDATA[DM1054]]></ID>
<name><![CDATA[SAMSUNG refrigerator RB37J5018SA]]></name>
<description><![CDATA[<p>Prostostoječ hladilnik z zamrzovalnikom ima 267 L prostornine hladilnega in 98 L prostornine zamrzovalnega dela.</p><p>Police in predali v notranjosti so optimalno razporejeni, LED osvetljava pa omogoča vidljivost tudi ponoči.</p>]]></description>
<specifications><![CDATA[<ul><li>Energijski razred: A +</ li><li>Volumen: 217 liters</ li><li>Dimenzije: 181x59x64 </ li><li>Program Auto defrost: da</li></ul>]]></specifications>
<link><![CDATA[https://www.example.org/product/RB37J5018SA/]]></link>
<mainImage><![CDATA[https://www.example.org/image01.jpg]]></mainImage>
<moreImages><![CDATA[https://www.example.org/image02.jpg,https://www.example.org/image03.jpg]]></moreImages>
<videoUrl><![CDATA[https://www.youtube.com/watch?v=x1La2Y140Bc]]> </videoUrl>
<price>659,90</price>
<regularPrice>699,90</regularPrice>
<clubPrice>620,90 </clubPrice>
<curCode>EUR</curCode>
<stockText><![CDATA[2 do 7 dni]]></stockText>
<stock>preorder</stock>
<inStoreAvailability>
   <store><![CDATA[BTC hala A, Šmartinska cesta 152, 1000 Ljubljana]]></store>
   <availability>today</availability>
   <quantity>2</quantity>
</inStoreAvailability>
<inStoreAvailability>
   <store><![CDATA[Tržaška cesta 87, 2000 Maribor]]></store>
   <availability>today</availability>
   <quantity>3</quantity>
</inStoreAvailability>
<inStoreAvailability>
   <store><![CDATA[Ankaranska cesta 3, 6000 Koper]]></store>
   <availability>tomorrow</availability>
   <quantity>1</quantity>
</inStoreAvailability>
<inStoreAvailability>
   <store><![CDATA[Ulica Mirka Vadnova 7, 4000 Kranj]]></store>
   <availability>no</availability>
   <quantity>0</quantity>
</inStoreAvailability>
<fileUnder><![CDATA[Home & Dom & Vrt- Bela tehnika - Hladilniki]]></fileUnder>
<cenCategoryId>221</cenCategoryId>
<brand><![CDATA[SAMSUNG]]> </brand>
<EAN><![CDATA[8806088059785]]></EAN>
<CUIN><![CDATA[CX0078266A]]></CUIN>
<productCode><![CDATA[516843-845]]></productCode>
<productModel><![CDATA[RB37J5018SA]]></productModel>
<condition><![CDATA[new]]></condition>
<warranty><![CDATA[5 let]]></warranty>
<coupon></coupon>
<gift></gift>
<deliveryCost>3,40</deliveryCost>
<deliveryTimeMin>2</deliveryTimeMin>
<deliveryTimeMax>7</deliveryTimeMax>
<groupId></groupId>
<attributes>
  <gender></gender>
  <color><![CDATA[bel]]></color>
  <size></size>
  <ageGroup></ageGroup>
  <attribute>
     <name><![CDATA[Energijski razred]]></name>
     <values>
      <value><![CDATA[A+]]></value>
     </values>
   </attribute>
   <attribute>
     <name>![CDATA[Prostornina]]</name>
     <values>
      <value>![CDATA[217 l]</value>
     </values>
   </attribute>
   <attribute>
     <name>![CDATA[Tehnologije]]</name>
     <values>
      <value>![CDATA[Twin Cooling Plus]]</value>
      <value>![CDATA[Space Max]]</value>
      <value>![CDATA[Fresh Zone]]</value>
     </values>
   </attribute>
</attributes>
</Item>
</CNJExport>


Pogoste težave in napake

• V elementih z besedilom (<name>, <description> …) uporabite CDATA (kot v zgornjem primeru). XML datoteka mora biti veljavna in pravilno oblikovana. Veljavnost XML datoteke lahko preverite tu:
  • https://www.w3schools.com/xml/xml_validator.asp
  • https://www.xmlvalidation.com/
  • ali pa si XML datoteko shranite na računalnik in jo odprete v spletnem brskalniku (najboljše izkušnje imamo z brskalnikom Firefox)
• Prva vrstica v XML datoteki mora biti pravilno nastavljena: <?xml version="1.0" encoding="UTF-8"?>. Večina encoding težav se zgodi zaradi napačne nastavitve te vrednosti. Vrednost je lahko “UTF-8”, “windows-1250” ali kakršnokoli drugo kodiranje. Pomembno je, da je kodiranje, uporabljeno v dokumentu, enako tistemu, ki je deklariran v prvi vrstici dokumenta.
• Vse značke so občutljive na velike/male črke in se morajo popolnoma ujemati s predpisanimi.
• V primeru, da boste menjali platformo ali sistem vaše spletne trgovine, bodite pozorni, da ID-ji izdelkov ostanejo isti. Pred spremembami nas prosim kontaktirajte – z veseljem vam pomagamo z dodatnimi informacijami in podporo ter vam pomagamo ob prehodu na nove ID-je.
• Posebno pozornost namenite oblikovanju <fileUnder>. Ta informacija je ključna za umeščanje vaših izdelkov znotraj kategorij na Ceneje.si.
• Za povezovanje izdelkov in ponudb se uporablja elemente <EAN>, <productCode> in <productModel>, zato se tu še posebej prepričajte, da nam posredujete pravilne in kvalitetne podatke iz svoje baze izdelkov.

Za kakršnakoli vprašanja glede priprave XML izvoza in teh navodil smo vam vedno na voljo. Pišite nam na urednik@ceneje.si in z veseljem vam bomo pomagali.