XML FORMAT

JEFTINIJE.HR SPECIFIKACIJA ZA XML IZVOZNU DATOTEKU

Ovaj dokument namijenjen je programerima koji će pripremiti XML izvoz u svrhu prikaza proizvoda iz vaše web trgovine na Jeftinije.hr. Ako nemate svoj programerski tim molimo vas da proslijedite ove upute tvrtki čiju platformu za web trgovinu koristite.

Ako želite da vaša prisutnost na Jeftinije.hr bude maksimalno iskorištena, vaš XML izvoz mora sadržavati sve važne elemente navedene u ovoj specifikaciji.

Nakon potvrde ispravnosti vašeg XML izvoza, pobrinut ćemo se za prijenos vaših proizvoda iz XML izvoza na našu platformu te kasnije redovito osvježavati cijene, dostupnost proizvoda i sve ostale informacije.

Molimo vas da ne podcijenite važnost optimizacije XML izvoza. Ovaj izvoz je vaš prvi kontakt s našom platformom i vašim potencijalnim kupcima. Ako vaša prisutnost započne s lošim i nepotpunim podacima, dobri rezultati će vjerojatno izostati.

Pregled


Osnovne informacije

Ovim dokumentom definirano je kako će se informacije o vašim proizvodima prikazivati na Jeftinije.hr. Oblikovanje dokumenta prema priloženim uputama je od ključne važnosti za dobre prodajne rezultate. S obzirom da je XML izvoz automatski generiran s vaše web stranice, obavezno se posavjetujte s administratorom web poslužitelja.

Definicije

  • Proizvod. Proizvod kojeg će vaši kupci tražiti na Jeftinije.hr
  • Drugi oblik. Proizvod koji postoji u više oblika. Na primjer, majica koja postoji u različitim bojama i/ili veličini te ima druge oblike boje/veličine
  • Element Polje u XML-u, sastoji se od početne oznake, podatkovne i zaključne oznake
  • Atribut Karakteristika proizvoda


Kratka napomena

Obavezno - R(Required) - Ovaj element mora biti uključen u izvoz inače se vaši proizvodi neće prikazati na Jeftinije.hr.
Uvjetno - D(It depends) - U opisu elementa provjerite trebate li ga priložiti za svoje proizvode.
Neobavezno - O(Optional) - Dodajte element, ako želite povećati performansu svojih proizvoda.

Elementi Kategorije proizvoda
Skupina Ime elementa Odjeća & obuća Drugi oblici Ostale skupine proizvoda
Korijenski element <CNJExport> R R R
Element proizvoda <Item> R R R
Osnovne informacije o proizvodu <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
Cijena & 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 proizoda <fileUnder> R R R
<cenCategoryId> O O O
Identifikatori proizvoda <brand> D D D
<EAN> R R R
<CUIN> O O O
<productCode> D D D
<productModel> D D D
Dodatne informacije o proizvodu <condition> D D D
<warranty> O O O
<coupon> O O O
<couponCode> O O O
<gift> O O O
Dostava <deliveryCost> R R R
<deliveryTimeMin> D D D
<deliveryTimeMax> D D D
Detaljne specfikacije proizvoda <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

Niže potražite detaljna objašnjenja i više informacija o minimalnim uvjetima, najboljim praksama i primjerima pojedinih elemenata.

Specifikacije elemenata

Korijenski element

Korijenski element je <CNJExport>. Osnovni je preduvjet i dodaje se samo jednom. Sadrži sve ostale elemente.

Element proizvoda

Svaki proizvod mora biti u svom <Item> elementu (XML je osjetljiv na velika i mala slova – obratite pozornost na veliko početno slovo “I”). Sadrži sve informacije o pojedinom proizvodu. Ako proizvod dolazi u drugim oblicima, pošaljite kopiju tog elementa za svaki pojedini oblik vašeg proizvoda.

Osnovni podaci o proizvodu

Informacije o proizvodu, koje prilažete koristeći ove elemente, osnovne su za kreiranje proizvoda na Jeftinije.hr. Savjetujemo da svi prilozi budu takve kvalitete koju želite prikazati svojim kupcima.

Element Format Opis
<ID> Obavezno / Required
Osnovni identifikator vašeg proizvoda
Primjer
546AB-1
Sintaksa
Max 50 znakova
  • Upotrijebite jedinstvenu vrijednost za svaki proizvod Upotrijebite SKU proizvoda kada je to moguće
  • Koristite isti ID kada osvježavate podatke
  • Koristite isključivo ispravne Unicod znakove. Izbjegnite neispravne znakove poput Ctrl, Fn ili drugih PUA znakova
  • Koristite isti ID za isti proizvod – u svim zemljama
  • Nikada ne mijenjajte ovaj ID
  • Nikada ga ne koristite za neki drugi proizvod
<name> Obavezno / Required
Ime vašeg proizvoda
Primjer
SAMSUNG hladnjak RB37J5018SA
Sintaksa
Max 200 znakova
  • Koristite ispravno nazivlje za vaše proizvode
  • Treba sadržavati BRAND, vrstu proizvoda (hladnjak) i MODEL.
  • Nemojte dodavati promotivni tekst poput "besplatna dostava", nemojte koristiti samo velika slova …
  • Za druge oblike:
    • Upotrijebite razlikovnu karakteristiku poput boje
  • Za odjeću i obuću:
    • Nemojte dodavati veličinu u ime proizvoda
<description> Obavezno / Required
Opis vašeg proizvoda
Primjer
<p>Hladnjak kapaciteta 217 litara primjeren je upotrebi u većim kućanstvima. </p>
<p>Police i ladice u hladnjaku su optimalno razmještene, a LED osvjetljenje omogućuje dobru preglednosti i u noćnim satima. </p>

Sintaksa
“Bez” ograničenja
  • Cjelokupni tekstualni opis vašeg proizvoda
  • Ako imate tekstualni opis proizvoda isti obavezno mora biti dodan u izvoz
  • Opis mora biti u HTML kodu (bez oblikovanja!)
  • Ispravno opišite svoj proizvod – mora sadržavati iste podatke kao i na odredišnoj stranici
  • Nemojte dodavati promotivni tekst poput "besplatna dostava", nemojte koristiti samo velika slova …
  • Uključite samo podatke o proizvodu. Nemojte dodavati linkove trgovine, prodajne informacije, detalje o konkurentima, drugim proizvodima ili dodacima
<specification> Obavezno / Required
Specifikacije vašeg proizvoda
Primjer
<ul>
  <li>   Energetski razred: A +   </ li>
  <li>   Zapremnina: 217 litara   </ li>
  <li>   Dimenzije: 181x59x64   </ li>
  <li>   Automatsko odleđivanje: da   </ li>
</ ul>

Sintaksa
“Bez” ograničenja
  • Sve specifikacije vašeg proizvoda
  • Ako imate specifikacije proizvoda, iste obavezno moraju biti dodane u izvoz
  • Specifikacije moraju biti u HTML kodu (bez oblikovanja!)
  • Dodajte ispravne specifikacije proizvoda – podaci moraju biti isti kao i na odredišnoj stranici
  • Nemojte dodavati promotivni tekst poput "besplatna dostava", nemojte koristiti samo velika slova …
  • Uključite samo podatke o proizvodu. Nemojte dodavati linkove trgovine, prodajne informacije, detalje o konkurentima, drugim proizvodima ili dodacima
  • Ako ne možete odvojiti specifikacije od opisa proizvoda sve podatke dodajte u <description> element
<link> Obavezno / Required
Odredišna stranica vašeg proizvoda
Primjer
https://www.example.org/product-id
Sintaksa
Max 400 znakova
  • Direktni URL do stranice vašeg proizvoda
  • Počinje s http ili https
  • Dodajte svoje UTM parametre na URL kako biste pratili uspješnost prodaje (posjećenost, stupanj konverzije).
<mainImage> Obavezno / Required
URL glavne slike vašeg proizvoda
Primjer
https://www.example.org/image1.jpg
Sintaksa
Max 200 znakova
  • Za URL slike:
    • Direktni ULR do glavne slike vašeg proizvoda
    • Počinje s http ili https
    • URL mora biti napisan bez razmaka, akcenata ili drugih posebnih znakova (na primjer: ć, č, đ, š, ž, ü, …)
  • Za sliku:
    • Ispravno prikažite proizvod koji prodajete
    • Koristite najvišu dostupnu rezoluciju
    • Koristite neki od prihvaćenih formata: non-animated GIF (.gif), JPEG (.jpg/.jpeg), PNG (.png)
    • Za proizvode koji ne spadaju u kategoriju Odjeće i obuće, koristite slike minimalnih dimenzija 300 x 300 piksela
    • Za proizvode iz kategorije odjeće i obuće koristite slike minimalnih dimenzija 600 x 600 piksela
    • Nemojte koristiti izrezanu ili smanjenu sliku
    • Nemojte uključiti promotivni tekst, vodene žigove ili iscrtane granice
    • Nemojte priložiti generičku ili „placeholder“ sliku
<moreImages> Obavezno / Required (kada proizvod ima više od jedne slike)
Neobavezno (kada proizvod ima jednu sliku)
URL dodatnih slika vašeg proizvoda URL-i su odvojeni zarezom
Primjer https://www.example.org/image2.jpg, https://www.example.org/image3.jpg, https://www.example.org/image4.jpg
Sintaksa
Max 1000 znakova
<videoUrl> Neobavezno
URL video prezentacije vašeg proizvoda
Primjer
https://www.youtube.com/watch?v=x1La2Y140Bc
Sintaksa
Max 400 znakova
  • Ako vi ili proizvođač imate video prikaz vašeg proizvoda, možete ga ovdje dodati
  • Bit će prihvaćeni samo URL-i s www.youtube.com

Cijena & dostupnost

Ovi elementi definiraju cijene i dostupnost vaših proizvoda. Ove informacije prikazane su potencijalnim kupcima na Jeftinije.hr. Ako se cijena i dostupnost vaših proizvoda često mijenja, molimo vas da nas obavijestite kako bismo mogli pravilno postaviti sinkronizaciju cjenovnih podataka. Prema zadanim postavkama, sinkronizacija se obavlja samo jednom na dan oko 0:30 AM.

Element Format Opis
<price> Obavezno / Required
Cijena vašeg proizvoda
Primjer
1230.99
Sintaksa
Brojčana vrijednost
  • Točna cijena vašeg proizvoda s uključenim PDV-om
  • Mora odgovarati cijeni na odredišnoj stranici
  • Možete koristiti točku ili zarez kao oznaku decimale
    • Uvijek koristite istu oznaku decimale u cijelom izvozu
  • Pobrinite se da je na odredišnoj stranici cijena navedena u nacionalnoj valuti i na lako vidljivom mjestu
  • Proizvod mora biti moguće kupiti online prema navedenoj cijeni
  • Pobrinite se da svaki korisnik zemlje u kojoj prodajte može kupiti proizvod po navedenoj cijeni i to bez plaćanja članarine
  • Nemojte navesti cijenu 0 (dozvoljeno je navesti cijenu 0, ali proizvodi s cijenom 0 neće biti objavljeni na Jeftinije.hr)
<regularPrice> Obavezno / Required (kada je proizvod na rasprodaji)
Neobavezno (kada proizvod nije na rasprodaji)
Cijena vašeg proizvoda prije rasprodaje
Primjer
1430.99
Sintaksa
Brojčana vrijednost
  • Obavezno / Required kada je proizvod na rasprodaji
  • Točna cijena vašeg proizvoda s uključenim PDV-om prije nego li je bila snižena
  • Možete koristiti točku ili zarez kao oznaku decimale
    • Uvijek koristite istu oznaku decimale u cijelom izvozu
<clubPrice> Neobavezno
Cijena vašeg proizvoda za članove kluba
Primjer
1130.99
Sintaksa
Brojčana vrijednost
  • Točna cijena vašeg proizvoda s uključenim PDV-om za članove kluba
  • Možete koristiti točku ili zarez kao oznaku decimale
    • Uvijek koristite istu oznaku decimale u cijelom izvozu
<curCode> Neobavezno
Kod valute u kojoj su prikazane cijene u izvozu
Primjer
EUR
Supported values
EUR
HRK
RSD
BAM
  • Jedine prihvaćene vrijednosti su:
    • EUR (Euro)
    • HRK (Hrvatska kuna)
    • RSD (Srpski dinar)
    • BAM (Konvertibilna mark)
<stockText> Neobavezno
Opis zaliha vašeg proizvoda
Primjer
Samo 10 proizvoda na zalihama
Sintaksa
Max 50 znakova
  • Ispravno navedite opis zaliha vašeg proizvoda i uskladite ih sa stanjem zaliha na odredišnoj stranici
  • Navedite samo točne informacije o zalihama
  • Dodatni primjeri:
    • Posljednji komad
    • Samo 10 proizvoda na zalihama
    • Provjeri
    • ...
<stock> Obavezno / Required
Zalihe vašeg proizvoda
Primjer
Out of stock
Podržane vrijednosti
in stock
preorder
out of stock
  • Ispravno navedite opis zaliha vašeg proizvoda i uskladite ih sa stanjem zaliha na odredišnoj stranici
  • Navedite samo točne informacije o zalihama
  • Dodatno objašnjenje podržanih vrijednosti:
    • in stock (proizvod će biti poslan najkasnije 1 dan nakon narudžbe ili je dostupan za osobno preuzimanje)
    • preorder (proizvod će biti poslan u roku od 2 – 10 radnih dana od datuma narudžbe ili je dostupan za osobno preuzimanje)
    • out of stock (za proizvod nema poznatog datuma dostave)
<inStoreAvailability> Neobavezno
Sadrži elemente koji donose informacije o dostupnosti proizvoda u fizičkim trgovinama – dostupnim za osobno preuzimanje. Elementi su: <store>
<availability>
<quantity>
  • Ovaj element morate ponoviti za svaku pojedinu poslovnicu.
<store> Neobavezno
Ime i lokacija vaše trgovine. Primjer
CCO West, Jankomir 33, 10000 Zagreb
Sintaksa
Max 100 znakova
  • Ispravno navedite lokacije trgovine u ovom formatu:
    • Shopping centar (neobavezno)
    • ulica i kućni broj (obavezno)
    • poštanski broj & grad (obavezno)
  • svaku informaciju odvojite zarezom (,)
<availability> Neobavezno
Dostupnost proizvoda za osobno preuzimanje i kada Primjer
today
Podržane vrijednosti
today
tomorrow
no
  • Ispravno navedite koliko je proizvoda dostupno za kupnju i preuzimanje u trgovini (navedeno u <store> elementu)
  • Navedite samo točne informacije
  • Dodatna pojašnjenja podržanih vrijednosti:
    • today (kupac može doći u trgovinu danas tijekom radnog vremena I kupiti ovaj proizvod ILI naručiti ga online i preuzeti ga tijekom radnog vremena trgovine)
    • tomorrow (kupac može naručiti proizvod online i preuzeti ga danas ili sutra tijekom radnog vremena trgovine)
    • no (proizvod nije dostupan za osobno preuzimanje)
  • „Today“ i „tomorrow“ se odnosi samo na radne dane
<quantity> Neobavezno Količina proizvoda dostupnih na pojedinim lokacijama trgovina
Primjer
10
Sintaksa
Cijeli broj, jednak ili veći od 0
  • Ispravno navedite koliko je proizvoda dostupno za kupnju i preuzimanje u trgovini (navedeno u <store> elementu)
  • Navedite samo točne informacije

Kategorija proizoda

Ovi elementi pomažu nam razumjeti što prodajete, kako bismo bolje rasporedili vaše proizvode po kategorijama na Jeftinije.hr i tako ih bolje predstaviti potencijalnim kupcima.

Element Format Opis
<fileUnder> Obavezno / Required
Kategorizacija vašeg proizvoda
Primjer
Muška odjeća & Modni dodaci > Odjeća > Kaputi & Jakne
Sintaksa
Max 400 znakova
  • Ispravna kategorizacija proizvoda iz vaše web trgovine
  • Vrlo važno za raspoređivanje vaših proizvoda po Jeftinije.hr kategorijama
  • Uključite samo 1 kategoriju
  • Uključite najrelevantniju kategoriju
  • Uključite cijelu kategorizaciju
    • Glavna kategorija - Kategorija - Potkategorija
<cenCategoryId> Neobavezno
ID kategorije s našeg portala
Primjer
1528
Sintaksa
Max 10 brojčanih znakova
  • Navedite ID kategorije s našeg portala koja odgovara vašem proizvodu
  • Ako želite priložiti ove podatke molimo vas da nas kontaktirate kako bismo vam poslali našu kategorizaciju
  • Proizvodi s ovim podacima bit će raspoređeni po Jeftinije.hr kategorijama u roku od 48 sati

Identifikatori proizvoda

Ovi elementi koriste se kao identifikatori koji na globalnom tržištu definiraju proizvode koje prodajete. Koristimo identifikatore proizvoda, kako bismo mogli povezati vaše proizvode s proizvodima drugih trgovaca. Samo onda kada možemo identificirati vaš proizvod, možemo ga povezati s drugim proizvodima i tako stvoriti dodatnu vrijednost korisnicima.

Element Format Opis
<brand> Obavezno / Required (za sve proizvode koji imaju naveden brand)
Neobavezno (za proizvode koji nemaju naveden brand)
Brand vašeg proizvoda
Primjer
Samsung
Sintaksa
Max 50 znakova
  • Dostavite prepoznatljivo ime branda vašeg proizvoda
  • Ako ne možete dostaviti ime branda, vrijednost ostavite praznu. Na primjer nemojte koristiti N/A, Generički, No brand, ili Brand ne postoji
  • Nemojte dostavljati Original Equipment Manufacturer (OEM) brand kako biste naglasili da je vaš proizvod replika ili kompatibilan s OEM-om branda proizvoda
<EAN> Obavezno / Required (za sve proizvode koji imaju EAN broj dodijeljen od proizvođača)
Neobavezno (za proizvode koji nemaju EAN broj)
EAN broj ili Global Trade Item Number (GTIN) vašeg proizvoda
Primjer
8806088059785
Sintaksa
Točno 13 brojčanih znakova
  • Morate uključiti EAN kod vašeg proizvoda, ako postoji
  • Priložite jedino točan EAN kod kako je definirano u službenom GS1 sustavu standarda, uključujući ove uvjete:
    • Kontrolna znamenka postoji i točno je navedena
    • EAN nije ograničen (GS1 raspona 02, 04, 2)
    • EAN nije kupon (GS1 prefiks raspona 98 - 99)
<CUIN> Neobavezno
Točan CUIN kod vašeg proizvoda sa Jeftinije.hr
Primjer
CX0078266A
Sintaksa
Max 10 znakova
  • CUIN kod je jedinstveni kod proizvoda na Jeftinije.hr.
  • Ovaj kod možete pronaći na svakoj stranici proizvoda na Jeftinije.hr (pod poljem “Podaci”)
  • Vaš proizvod s navedenim CUIN kodom bit će automatski povezan s postojećim proizvodom na Jeftinije.hr u roku od 48 sati.
<productCode> Obavezno / Required (za sve proizvode u kategoriji automobilskih guma)
Neobavezno (za sve ostale proizvode)
Interni kod ili kod dobavljača vašeg proizvoda
Primjer
516843-845
Sintaksa
Max 20 znakova
  • Bilo koji kod proizvoda koji imate – može biti i kod dobavljača
  • Ako je vaš proizvod iz kategorije automobilskih guma, morate priložiti SAP kod u ovom polju (6-znamenkasti broj).
<productModel> Neobavezno
Kod proizvođača vašeg proizvoda (model)
Primjer
RB37J5018SA
Sintaksa
Max 20 znakova
  • Model vašeg proizvoda
  • Koristite najprecizniji mogući model. Na primjer, isti proizvodi u različitim bojama trebali biste imati različite modele

Dodatni podaci o proizvodu

Iskoristite te elemente za prosljeđivanje dodatnih informacija o proizvodu koje korisnicima pomažu s kupovnom odlukom.

Element Format Opis
<condition> Obavezno / Required (za sve proizvode koji su popravljani, otpakirani, obnovljeni ili korišteni)
Neobavezno (za sve nove proizvode)
Stanje vašeg proizvoda
Primjer
new
Podržane vrijednosti
new
renew
refurbished
reboxed
used
  • Navedite ispravno stanje proizvoda
<warranty> Neobavezno
Informacije o jamstvu vašeg proizvoda
Primjer
3 godine
Sintaksa
Max 50 znakova
<coupon> Neobavezno
Opis onoga što kupac dobije koristeći <couponCode>
Primjer
Kupon za 10% popusta na kupovinu u našoj trgovini
Sintaksa
Max 75 znakova
<couponCode> Neobavezno
Kupon kojeg kupac treba da iskoristi njegove pogodnosti
Primjer
KODA10CENEJE
Sintaksa
Max 15 znakova
<gift> Neobavezno
Poklon kojeg kupac dobiva kada kupi ovaj proizvod
Primjer
Majica
Sintaksa
Max 150 znakova

Dostava

Ovi elementi će biti korišteni kako bismo korisnicima pružili točne informacije o troškovima i rokovima dostave. Korisnici se oslanjaju na cijenu dostave i vrijeme isporuke kada donose odluku o kupnji. Vrlo je važno da dostavite točne i kvalitetne podatke o dostavi.

Element Format Opis
<deliveryCost> Obavezno / Required
Cijena dostave vašeg proizvoda
Primjer
3.45
Sintaksa
Brojčana vrijednost
  • Ispravno navedite trošak dostave vašeg proizvoda
  • Možete koristiti točku ili zarez kao oznaku decimale
    • Uvijek koristite istu oznaku decimale u cijelom izvozu
<deliveryTimeMin> Obavezno / Required (za sve proizvode koji u elementu <stock> imaju vrijednost in stock ili preorder)
Neobavezno (za sve ostale proizvode)
Najkraće vrijeme (u danima) između dana kada je predana narudžba i dana dostave proizvoda.
Primjer
2
Sintaksa
Cijeli broj, jednak ili veći od 0
<deliveryTimeMax> Obavezno / Required (za sve proizvode koji u elementu <stock> imaju vrijednost in stock ili preorder)
Neobavezno (za sve ostale proizvode)
Najduže vrijeme (u danima) između dana kada je predana narudžba i dana dostave proizvoda.
Primjer
3
Sintaksa
Cijeli broj, jednak ili veći od 0

Detaljne specfikacije proizvoda

Ovi elementi koriste se za navođenje specifičnih karakteristika proizvoda koje kupci inače traže. Isto tako, ovi elementi se koriste za povezivanje drugih oblika i prepoznavanje razlika među njima te kako bi se potencijalnim kupcima pomoglo filtrirati proizvode prema atributima na Jeftinije.hr.

Element Format Opis
<groupId> Obavezno / Required (za sve druge oblike proizvoda)
Neobavezno (za sve ostale proizvode)
ID za grupu proizvoda koji dolaze u različitim oblicima (drugi oblici)
Primjer
546AB
Sintaksa
Max 50 znakova
  • Koristite jedinstvene vrijednosti za svaku grupu drugih oblika. Koristite glavni SKU gdje je to moguće
  • Neka vrijednost ostane ista kada osvježavate podatke o proizvodu
  • Koristite jedino ispravne Unicode znakove. Izbjegnite nepravilne znakove poput Ctrl, Fn ili druge PUA znakove
  • Koristite <groupId> za skupinu proizvoda koja se razlikuje po jednom ili više ovih elementa:
  • Uključite iste elemente za svaki proizvod u grupi. Na primjer, ako se proizvod razlikuje po veličini i boji priložite <size> i <color> za svaki proizvod koji dijeli istu vrijednost u <groupId>
  • Ako se vaš proizvod razlikuje po dizajnu atributa koji nije obuhvaćen gornjim elementima, nemojte koristiti ovaj element
<attributes> Obavezno / Required
Ovaj element sadrži sve atribute proizvoda. Svaki u svom <attribute> elementu. Sadrži i neke predodređene atribute kao elemente:
<gender>
<color>
<size>
<ageGroup>
  • Uključite sve atribute proizvoda koje vaš proizvod ima
<gender> Obavezno / Required (za sve druge oblike proizvoda i proizvode iz kategorije Odjeća i obuća)
Neobavezno (za sve ostale proizvode)
Spol kojem je vaš proizvod namijenjen
Primjer
male
Supported values
unisex
female
male
  • Za druge oblike:
    • Uključite s istim vrijednostima za <groupId> i različitim vrijednostima za <gender>
<color> Obavezno / Required (za sve druge oblike proizvoda i proizvode iz kategorije Odjeća i obuća)
Neobavezno (za sve ostale proizvode)
Boja/e vašeg proizvoda
Primjer
bijela
Sintaksa
Max 40 znakova
  • Nemojte koristiti brojeve poput 0 2 4 6 8
  • Nemojte koristiti znakove koji nemaju brojčanu vrijednost poput #fff000
  • Nemojte koristiti samo 1 slovo poput R
  • Nemojte se odnositi na proizvod ili sliku riječima “vidi sliku”
  • Nemojte spajati nazive boja u 1 riječ, poput CrvenaŽutaPlava odvojite ih znakom /
  • Nemojte koristiti vrijednost koja ne označava boju poput različit, drugi oblik, varijacija, ženski, muški ili N/A
  • Za druge oblike:
    • Uključite s istim vrijednostima za <groupId> i različitim vrijednostima za <color>
<size> Obavezno / Required (za sve druge oblike proizvoda i proizvode iz kategorije Odjeća i obuća)
Neobavezno (za sve ostale proizvode)
Veličina vašeg proizvoda
Primjer
XL
EU 42
Sintaksa
Max 40 znakova
  • Za druge oblike:
    • Uključite s istim vrijednostima za <groupId> i različitim vrijednostima za <size>
    • U slučaju različitih veličina za različita tržišta, morate navesti na koje se tržište navedena veličina odnosi. Primjeri:
      • EU 41
      • US 8
      • UK 7.5
<ageGroup> Obavezno / Required (za sve druge oblike proizvoda i proizvode iz kategorije Odjeća i obuća)
Neobavezno (za sve ostale proizvode)
Dobna skupina kojoj je namijenjen vaš proizvod
Primjer
adult
Podržane vrijednosti
newborn
infant
toddler
kids
adult
  • Uključite jednu vrijednost po proizvodu
  • Za druge oblike:
    • Uključite s istim vrijednostima za <groupId> i različitim vrijednostima za <ageGroup>
    • Dodatna objašnjenja podržanih vrijednosti:
      • newborn (do 3 mjeseca starosti)
      • infant (od 3-12 mjeseci starosti)
      • toddler (od 1-5 godina starosti)
      • kids (od 5-13 godina starosti)
      • adult (tinejdžeri ili stariji)
<attribute> Obavezno / Required
Svaki atribut vašeg proizvoda dobiva svoj <attribute> element. Sadrži ove elemente:
<name>
<values>
<name> Obavezno / Required
Naziv atributa za koji ćete dostaviti vrijednost
Primjer
Material
Sintaksa
Max 100 znakova
<values> Obavezno / Required
Ovaj element sadrži sve vrijednosti atributa. Svaki u svom <value> element.
  • Uključite sve vrijednosti atributa koje vaš proizvod ima.
<value> Obavezno / Required
Vrijednosti ranije specificiranih atributa
Primjer
100% Pamuk
Sintaksa
Max 100 znakova

Dodatni zahtjevi

Primjer XML dokumenta

<?xml version="1.0" encoding="UTF-8"?>
<CNJExport>
<Item>
<ID><![CDATA[DM1054]]></ID>
<name><![CDATA[SAMSUNG hladnjak RB37J5018SA]]></name>
<description><![CDATA[<p>Hladnjak kapaciteta 217 litara primjeren je upotrebi u većim kućanstvima.</p><p>Police i ladice u hladnjaku su optimalno razmještene, a LED osvjetljenje omogućuje dobru preglednosti i u noćnim satima.</p>]]></description>
<specifications><![CDATA[<ul><li>Energetski razred: A +</ li><li>Zapremnina: 217 litara</ li><li>Dimenzije: 181x59x64 </ li><li>Automatsko odleđivanje: 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>HRK</curCode>
<stockText><![CDATA[Samo 10 proizvoda na zalihama]]></stockText>
<stock>preorder</stock>
<inStoreAvailability>
   <store><![CDATA[CCO West, Jankomir 33, 10000 Zagreb]]></store>
   <availability>today</availability>
   <quantity>2</quantity>
</inStoreAvailability>

<inStoreAvailability>
   <store><![CDATA[Vice Vukova 6, 10000 Zagreb]]></store>
   <availability>today</availability>
   <quantity>3</quantity>
</inStoreAvailability>

<inStoreAvailability>
   <store><![CDATA[Janka Polića Kamova 81A, 51000 Rijeka]]></store>
   <availability>tomorrow</availability>
   <quantity>1</quantity>
</inStoreAvailability>

<inStoreAvailability>
   <store><![CDATA[Josipa Jovića 93, 21000 Split]]></store>
   <availability>no</availability>
   <quantity>0</quantity>
</inStoreAvailability>

<fileUnder><![CDATA[Home & Dom & Vrt – Bijela tehnika - Hladnjaci]]></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 godina]]></warranty>
<coupon>Kupon za 10% popusta na kupovinu u našoj trgovini</coupon>
<couponCode><![CDATA[KODA10CENEJE]]></couponCode>
<gift></gift>
<deliveryCost>3,40</deliveryCost>
<deliveryTimeMin>2</deliveryTimeMin>
<deliveryTimeMax>7</deliveryTimeMax>
<groupId></groupId>
<attributes>
  <gender></gender>
  <color><![CDATA[bijeli]]></color>
  <size></size>
  <ageGroup></ageGroup>
  <attribute>
     <name><![CDATA[Energetski razred]]></name>
     <values>
      <value><![CDATA[A+]]></value>
     </values>
   </attribute>
   <attribute>
     <name>![CDATA[Zapremnina]]</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>

Uobičajeni problemi i pogreške

  • U tekstualnim elementima (<name>, <description> …) koristite CDATA (kao u nižem primjeru). XML dokument mora biti ispravan i dobro konstruiran. Ovdje možete provjeriti ispravnost vašeg XML-a:
  • Postavite točno prvu liniju u XML-u <?xml version="1.0" encoding="UTF-8"?>. Najviše grešaka u kodiranju događa se zbog nepravilnog postavljanja ove vrijednosti. Kodiranje ne mora biti samo “UTF-8” može biti i “windows-1250” ili neko drugo kodiranje. Važno je da koristiti isto kodiranje kako je definirano u prvoj liniji koda.
  • Sve oznake su osjetljive na veliko i malo slovo.
  • Kadgod budete mijenjali platformu/sustav vašeg web shopa, molimo vas obratite pažnju na to da se ne promijeni i ID proizvoda. Kontaktirajte nas prije nego provedete izmjene, kako bismo vam mogli pružiti odgovarajuće informacije i podršku, te za vas pripremiti lagani prijelaz na nove ID-eve.
  • Molimo vas, kreirajte <fileUnder> vrlo pažljivo. Ova informacija je ključna za razvrstavanje vaših proizvoda po Jeftinije.hr kategorijama.
  • <EAN>, <productCode> i <productModel> su elementi koje koristimo za povezivanje proizvoda i ponuda, pobrinite se da ispunite ove elemente kodovima iz baze podataka vaših proizvoda.

Ako imate bilo kakvih pitanja vezanih uz ove XML specifikacije, rado ćemo odgovoriti na njih. Kontaktirajte nas na urednik@ceneje.si.

Hvala vam na suradnji.

Želiš među prvima saznati najbolje sezonske ponude?
Prijavi se na e-novosti koje ti pripremamo svaki tjedan.

Upiši ispravan e-mail

Hvala na prijavi. Uskoro možeš očekivati nove tjedne e-novosti.