Specifikacija cjenika
@nabava.netOvdje 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
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>
<sprice>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 > Komponente > 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: