Specifikacija XML izvozne datoteke

XML format je standardiziran, jednostavan i lako čitljiv format za pohranu i dijeljenje podataka. ShopGuru dohvaća proizvode čitanjem XML datoteke vaše web trgovine, koja treba sadržavati popis proizvoda te dodatne informacije poput opisa, fotografije, cijene i drugo.

Ukoliko vaša trgovina nema XML datoteku s popisom proizvoda, pošaljite ovu uputu vašim programerima koji će ju za vas pripremiti. Datoteka mora sadržavati osnovne informacije o proizvodima, a sve dodatne informacije povećat će vašu vidljivost na ShopGuru platformi, pružiti korisnicima više informacija i povećati konačni doseg.


Osnovne informacije

Koristite niže opisanu specifikaciju kako biste ispravno pripremili XML datoteku za izvoz. Vrlo je važno da datoteka bude ispravno pripremljena kako bi ShopGuru ispravno prikazivao informacije o vašim proizvodima te kako biste maksimalno iskoristili potencijalni doseg prema korisnicima.


Primjer XML datoteke s podacima proizvoda


	<?xml version="1.0" encoding="UTF-8"?>
	<items>
		<item>
			<id>100045</id>
			<ean>0195122989286</ean>
			<mpn>262T7EA</mpn>
			<brand>HP</brand>
			<category>Prijenosna računala</category>
			<title>Laptop HP 15s-fq0030nm, N4020/4GB/256GB SSD/IntelUHD/15.6"FHD/FreeDOS</title>
			<description><![CDATA[HP 15s-fq0030nm, DOS, Intel Celeron N4020, 1.1 GHz, Core 2, 4 GB, 15,6" FHD, SSD 256 GB M.2 PCIe NVMe, Intel UHD, 802.11a/b/g/nac,Bluetooth 4.2, Masa 1.65 kg, 720p, SD, Boja Siva, HDMI, 2xUSB 3.1, USB Type-C, 3yw]]></description>
			<image>https://primjer.hr/images/262T7EA.jpg</image>
			<url>https://primjer.hr/racunala/hp-15s-fq0030nm</url>
			<price>2950.00</price>
			<currency-code>HRK</price>
			<availability>25</availability>
			<store-availability>
				<store>Zagrebačka 128, 10000 Zagreb</store>
				<quantity>25</quantity>
			</store-availability>
			<attributes>
				<attribute>
					<name>Procesor</name>
					<values>
						<value>Intel Celeron N4020</value>
					</values>
				</attribute>
				<attribute>
					<name>Radna memorija</name>
					<values>
						<value>4 GB</value>
					</values>
				</attribute>
				<attribute>
					<name>Vrsta radne memorije</name>
					<values>
						<value>DDR4</value>
					</values>
				</attribute>
				<attribute>
					<name>Dijagonala ekrana</name>
					<values>
						<value>15.6"</value>
					</values>
				</attribute>
				<attribute>
					<name>Rezolucija</name>
					<values>
						<value>1920x1080 px</value>
					</values>
				</attribute>
				<attribute>
					<name>Tehnologija ekrana</name>
					<values>
						<value>LED</value>
					</values>
				</attribute>
				<attribute>
					<name>Operativni sustav</name>
					<values>
						<value>FreeDOS</value>
					</values>
				</attribute>
				<attribute>
					<name>Boja</name>
					<values>
						<value>Srebrna</value>
					</values>
				</attribute>
			</attributes>
			<delivery-time-min>7</delivery-time>
			<delivery-time-max>10</delivery-time>
			<warranty>36 mjeseci</warranty>
			<coupon-title>Iskoristite 5% popusta za web narudžbu</coupon-title>
			<coupon-code>SHOPGURU</coupon-code>
		</items>
	</item>


Specifikacija XML elemenata

Element Primjer Napomene
<id> 100045 Obavezno
  • ID proizvoda iz baze podataka vaše web trgovine
  • mora biti jedinstvena vrijednost te se ne smije mijenjati prilikom osvježavanja podataka
<ean> 0195122989286 Obavezno
  • Obavezno je navesti EAN kod prema GS1 standardu ukoliko postoji za taj proizvod
<mpn> 262T7EA Neobavezno
  • Oznaka modela proizvoda (Manufacturer Part Number)
<brand> HP Obavezno
  • Naziv proizvođača
<category> Prijenosna računala Obavezno
  • Navesti samo jednu kategoriju
<title> Laptop HP 15s-fq0030nm, N4020/4GB/256GB SSD/IntelUHD/15.6"FHD/FreeDOS Obavezno
  • Ispravni naziv proizvoda koji sadrži ime branda, vrstu proizvoda i model
<description> HP 15s-fq0030nm, DOS, Intel Celeron N4020, 1.1 GHz, Core 2, 4 GB, 15,6" FHD, SSD 256 GB M.2 PCIe NVMe, Intel UHD, 802.11a/b/g/nac,Bluetooth 4.2, Masa 1.65 kg, 720p, SD, Boja Siva, HDMI, 2xUSB 3.1, USB Type-C, 3yw Obavezno
  • kratak tekstualni opis proizvoda
<image> https://primjer.hr/images/262T7EA.jpg Obavezno
  • URL glavne slike proizvoda u JPEG, PNG ili GIF formatu
  • minimalna preporučena veličina 300x300 px
<url> https://primjer.hr/racunala/hp-15s-fq0030nm Obavezno
  • URL stranice proizvoda
  • za praćenje marketinških podataka, možete dodati svoje UTM parametre
<price> 2399.00 Obavezno
  • koristite točku za odvajanje decimalnih brojeva
  • cijena s uključenim PDV-om
<currency-code> HRK Obavezno
  • kod valute prema ISO 4217 standardu, npr. HRK ili EUR
<availability> 25 Obavezno
  • točna količina proizvoda dostupna za kupnju i preuzimanje
  • ukoliko proizvod trenutno nije dostupan, koristite "Nedostupno", "U dolasku", "Po narudžbi" ili drugo.
<store-availability> Zagrebačka 128, 10000 Zagreb
today
25
Nebavezno
  • navedite sve sve poslovnice u kojima se nalazi ovaj proizvod u zaseban tag <store-availability>
  • unutar <store-availability> dodajte <store> za svaku poslovnicu i <quantity> s brojem raspoloživih proizvoda u toj poslovnici
<attributes> Proizvođač procesora: Intel
Procesor: Intel Celeron N4020
Radna memorija: 4 GB
Vrsta radne memorije: DDR4
Dijagonala ekrana: 15.6"
Rezolucija: 1920x1080 px
Tehnologija ekrana: LED
Operativni sustav: FreeDOS
Boja: Srebrna
Obavezno
  • navedite sve specifikacije proizvoda kako bi se proizvod ispravno prikazivao prema odabranim filterima
  • unutar <attributes> za svaku specifikaciju proizvoda dodajte <attribute> unutar kojeg se nalaze tagovi <name> i <value>
  • neki proizvodi unutar <values> mogu imati više vrijednosti
<delivery-time-min> 7 Neobavezno
  • najmanji broj dana potrebnih za dostavu proizvoda
  • koristi se kao raspon u kombinaciji s <delivery-time-max>
<delivery-time-max> 10 Neobavezno
  • najveći broj dana potrebnih za dostavu proizvoda
  • koristi se kao raspon u kombinaciji s <delivery-time-min>
<warranty> 36 mjeseci Neobavezno
  • trajanje jamstva u mjesecima ili godinama
<coupon-title> Iskoristite 5% popusta za web narudžbu Neobavezno
  • opis kupona s iznosom popusta
<coupon-code> SHOPGURU Neobavezno
  • kod kupona koji kupan unosi prilikom narudžbe u vašoj web trgovini

Tehničke napomene

  • ShopGuru dohvaća XML datoteke nekoliko puta dnevno
  • ispravnost vaše XML datoteke može provjeriti putem XML Validation alata
  • uputu za izradu XML datoteke prema našim specifikacijama, kao i sve druge dodatne informacije možete zatražiti putem emaila: admin@shopguru.hr