Ostali članci

Specifikacija cjenika

Ovdje se nalaze informacije o cjeniku koji je potreban kako bi se ponuda trgovine što potpunije i kvalitetnije uvrstila na Nabava.net stranice.

Ako za webshop koristite Magento, osCommerce, VirtueMart, Zen Cart, PrestaShop, OpenCart ili slična popularna gotova rješenja i trebate pomoć pri izradi skripte za generiranje cjenika, slobodno nam se javite pa ćemo vidjeti možemo li pomoći.

Za bilo kakve nejasnoće ili upite obratite nam se na [email protected].

Sadržaj

  1. Osnovne informacije

  2. Specifikacije cjenika

  3. XML primjer

  4. XLS-CSV primjer


Osnovne informacije

1. Preuzimanje cjenika

Cjenik je potrebno stavljati na neku fiksnu lokaciju - npr. https://www.trgovina.hr/cjenik-nabava.xml.

  • Umjesto unaprijed pripremljenog cjenika najbolje je pružiti lokaciju skripte koja u trenutku poziva generira aktualni cjenik - npr. https://www.trgovina.hr/export-xml.php.
  • Nabava.net pokreće osvježavanje cjenika automatski nekoliko puta. Vremena provjere su 7:30h, 10:30h, 13:30h i 17:30h.

Osim gore navedenog preferiranog načina, cjenik je moguće osvježavati i ručnim upload-om putem administracijskog sučelja dostupnog na https://www.nabava.net/login.

2. Podržani formati

Najprihvatljiviji i najbolji način za prenošenje ponude je putem cjenika u XML formatu.

Moguće je obrađivati i cjenike u Excel (.XLS, .XLSX) i tekst (.CSV, .TXT) formatu.

Cjenik se može sastojati i od više datoteka - npr. cjenik-prijenosnici.xml, cjenik-komponente.xml...

Poželjno je da cjenici budu enkodirani u UTF-8.

3.  Primjeri cjenika

Sažeti primjeri cjenika za XML i XLS/CSV formate sa pripadajućim informacijama nalaze se u nastavku ovok članka, a kao zasebne datoteke dostupni su na adresama:

Riječ je o oglednim primjerima. Postoji mogućnost obrađivanja i cjenika drugačijeg formata i strukture, a u tom slučaju savjetujemo da nas kontaktirate prije eventualne prilagodbe cjenika.

4.  U slučaju da radite strukturne promjene na cjeniku potebno nas je obavijestiti! ⚠️

  • U protivnom cjenik se najvjerojatnije nakon promjene neće ispravno osvježavati i prikazivati na našim stranicama.
  • Pod strukturnim promjenama na cjeniku misli se na promjenu lokacije cjenika, promjenu formata/ekstenzije, promjenu broja/naziva/redoslijeda polja u cjeniku i slično.

Specifikacija cjenika

Polje Prioritet Opis Primjer
name Obavezno Naziv artikla koji se prikazuje na stranicama. Izrazito je bitan jer postupak (poluautomatiziranog) kategoriziranja artikala na stranicama uvelike ovisi o ovom podatku. Treba biti jasan i koncizan tj. sadržavati sve važne karakteristike po kojima se artikl razlikuje od drugih sličnih, a poželjno i ostale važnije karakteristike koji ga opisuju.
Po njemu posjetitelji obavljaju tekstualno pretraživanje na stranicama.
Monitor Dell Ultrasharp U2412M, 24", 16:10, 1920x1200, 178/178, 8ms, LED, IPS, pivot, DVI/VGA/HDMI/Display port/USB, crni
price Obavezno Cijena za krajnjeg kupca s uključenim PDV-om. 1950.00
url Obavezno URL do stranice trgovine koja sadrži detalje artikla i gumb za narudžbu. https://www.trgovina.hr/dell-u2412m.html
availability Obavezno Raspoloživost artikla.
Nabava.net razlikuje i odgovarajućim ikonama prikazuje sljedeće vrste raspoloživosti:

- Raspoloživo, isporuka odmah u trgovini
- Raspoloživo, isporuka do 2 dana nakon uplate
- U dolasku, po narudžbi
- Raspoloživost potrebno provjeriti
- Nije raspoloživo

Oznake koje će se stavljati u ovo polje ne moraju nužno odgovarati gore spomenutim opcijama (u tom slučaju će se raditi mapiranje na gornje opcije).
Tekstualna vrijednost koja će se prikazivati na stranicama može biti oznaka direktno iz cjenika ili (nakon mapiranja) jedna od gore spomenutih opcija.
0 / ne / nije raspoloživo
1 / da / raspoloživo odmah
2 / raspoloživo, isporuka nakon uplate
3 / stiže za X dana
internal_product_id Poželjno Interna šifra artikla u trgovini. Treba biti jedinstvena i ne smije se mijenjati tokom vremena. 123456
category Poželjno Oznaka kategorije kojoj artikl pripada. Ne mora odgovarati Nabava.net kategorijama (mada bi bilo idealno). Pomaže u ispravnom kategoriziranju artikla. Računala > Komponente > Monitori
image_url Poželjno URL do glavne slike artikla. https://www.trgovina.hr/dell-u2412m.jpg
description Poželjno Detaljniji opis artikla. Izrazito je poželjno je da se u polju zadrži formatiranje redaka tj. oznake novog retka (\n - line feed - CHR(10)) kako bi posjetiteljima opis bio što čitljiviji.
Ako su dostupne strukturirane specifikacije, tada ih treba staviti u polje "specification"!!
Dell Ultrasharp U2412M monitor sa IPS matricom, LED pozadinskim osvjetljenjem i dijagonalom od 24" predstavlja best-buy izbor za vaš novi monitor. Izdvojene karakteristike:
- LED IPS matrica
- 178/178 kut gledanja
- opcija pivotiranja, podešavanje po visini
brand Opcionalno Naziv proizvođača/brend proizvoda. Dell
shipping cost Poželjno Iznos troška dostave na području cijele Hrvatske. Moguće vrijednosti:
iznos veći od nule = cijena dostave artikla
0  = besplatna dostava
Ako cijena dostave nije jedinstvena na području cijele Hrvatske ili ovisi i o drugim parametrima, ovo polje treba ostaviti praznim, a detalje navesti u polju "shipping_info".
35.00
0
gting (ean/upc/isbn) Poželjno Jedinstvena trgovinska oznaka artikla / barkod. Ovisno o dostupnom podatku treba ispuniti adekvatno polje. 5711045254291
mpn Opcionalno Proizvođačeva oznaka artikla (manufacturer part number). 860-10161
price_credit_cards /
price_visa_premium
price_visa
price_diners
price_mastercard
 
Opcionalno Cijena artikla za kartice.
Ako je cijena ista za sve kartice dovoljno je postaviti jedno polje ("price_credit_cards") u protivnom je za svaku dostupnu karticu potrebno postaviti adekvatno polje.
2047.50
regular_price Opcionalno Ako je ovo polje postavljeno, a vrijednost različita od one u polju "price" to onda znači da polje "price" sadrži akcijsku cijenu te je to moguće na stranicama posjetiteljima posebno istaknuti. 2100.00
comment Opcionalno Dodatna napomena vezana uz artikl. Ponuda dostupna samo do datuma xx.xx.xxxx.
Prvih X kupaca dobiva na poklon i HDMI kabel
shipping_info Opcionalno Informacije oko uvjeta dostave definiraju se na nivou cijele trgovine, a ovim poljem moguće je navesti dodatne posebne informacije koje vrijede za konkretan artikl. Besplatna dostava ako je monitor naručen u sklopu konfiguracije.
brand_product_url Opcionalno URL do proizvođačeve stranice koja sadrži informacije o proizvodu. https://www.dell.com/en-us/shop/dell-ultrasharp-24-monitor-u2419h/apd/210-arcf/monitors-monitor-accessories
warranty Opcionalno Jamstvo. 36 mjeseci / 3 godine
specification Opcionalno Strukturirane specifikacije artikla - pogledati konkretne primjere cjenika za više. [primjer u XML formatu]
<group_name>Ekran</group_name>
<key>Dijagonala</key>
<value>24"</value>
<group_name>Ekran</group_name>
<key>Vrijeme odziva</key>
<value>8ms</value>
additional_image_url Opcionalno URL do dodatnih slika proizvoda (slika artikla sa strane, u drugim bojama i slično). https://www.trgovina.hr/dell-u2412m-back.jpg

XML primjer

Nazivi tagova, a i sama strukura XML-a ne mora nužno biti identična strukturi donjeg predloška (ali naravno poželjno je da je što sličnija). 

Idealno je u ""description"" tagu zadržati oznaku novog reda (\n - line feed - CHR(10)) iz originalnog teksta jer će tako posjetiteljima tekst (koji će se prenijeti na stranice) biti znatno čitljiviji!"

<products>                
    <product>            
        <name>Monitor Dell Ultrasharp U2412M, 24", 16:10, 1920x1200, 178/178, 8ms, LED, IPS, pivot, DVI/VGA/HDMI/Display port/USB, crni</name>        
        <price>1950.00</price>        
        <url>http://www.trgovina.hr/dell-u2412m.html</url>        
        <availability>raspoloživo</availability>        
        <internal_product_id>123456</internal_product_id>        
        <category>Računala &gt; Komponente &gt; Monitori</category>        
        <image_url>http://www.trgovina.hr/dell-u2412m.jpg</image_url>        
        <description>Dell Ultrasharp U2412M monitor sa IPS matricom, LED pozadinskim osvjetljenjem i dijagonalom od 24"" predstavlja best-buy izbor za vaš novi monitor. Izdvojene karakteristike:        
                
        - LED IPS matrica        
        - 178/178 kut gledanja        
        - opcija pivotiranja, podešavanje po visini        
                
        </description>        
        <shipping_cost>35,00</shipping_cost>        
        <ean>5711045254291</ean>        
        <mpn>860-10161</mpn>        
        <price_credit_cards>2047.50</price_credit_cards>        
        <regular_price>2100.00</regular_price>        
        <comment>Prvih 30 kupaca dobiva na poklon i HDMI kabel.</comment>        
        <shipping_info>Besplatna dostava ako je monitor naručen u sklopu konfiguracije.</shipping_info>        
        <brand>Dell</brand>        
        <brand_product_url>http://accessories.us.dell.com/sna/productdetail.aspx?sku=320-2676</brand_product_url>        
        <warranty>36 mjeseci</warranty>        
        <specification>        
            <group_name>Zaslon</group_name>    <!-- opcionalno -->    
            <key>Dijagonala</key>    <!-- opcionalno -->    
            <value>24"</value>        
        </specification>        
        <specification>  
     
            <key>Boja uređaja</key>    <!-- opcionalno -->    
            <value>crna</value>        
        </specification>        
        <specification> 
       
            <value>Integriran TV tuner</value>        
        </specification>        
        <additional_image_url>
http://www.trgovina.hr/dell-u2412m-back.jpg</additional_image_url>        
        <additional_image_url>http://www.trgovina.hr/dell-u2412m-side.jpg</additional_image_url>        
        <parent_id>323461A32</parent_id>        
    </product>            
</products> 

XLS / CSV primjer

Idealno je u "description" polju zadržati oznaku novog reda (\n - line feed - CHR(10)) iz originalnog teksta jer će tako posjetiteljima tekst (koji će se prenijeti na stranice) biti znatno čitljiviji!

Ako je cjenik CSV formata poželjno je da se vrijednosti stupaca nalaze unutar dvostrukih navodnika ("), a stupci razdvojeni točkom-zarezom (;). U tom slučaju:

  • dvostruke navodnike se stavlja u unutar polja na način da se dvaput navedu ("")
  • novi red generalno označava i novi artikl ali ako se želi oznaka novog reda staviti unutar vrijednosti nekog polja onda se to radi tako da se koristi (samo) znak \n (line feed - CHR(10)), a ne kombinacija \r\n (tj. ne stavlja se carriage return - CHR(13) ispred)

Polja "additional_image_url" i "specification" mogu imati više vrijednosti (pogledati XML primjer) - njih se u XLS/CSV formatima odvaja znakom novog retka (\n).

Polje "specification" jednostavno je definirati XML-om no ne i formatima XLS/CSV - predloženi izgled tog polja su linije formata (group_name i key su opcionalni):

  • group_name#key:value

Primjeri cjenika u zasebnim datotekama: