Uvoz i izvoz podataka

Prilagodba izvoza

Ažurirano 17.10.2026

Funkcionalnost omogućava izvoz podataka (cjenici, itd.) u željenom formatu (JSON, CSV, XML, itd.), koji se određuje kao predložak. Ovo je korisno kada želimo izvoziti proizvode s cijenama, zalihama, slikama, itd. u strukturirani format za vanjski servis, kao što su online trgovine ili ERP sistemi.


Podržani predlošci:

  • Mimovrste
  • BigBang
  • BigBang - akcijska cijena
  • EnaA
  • Shoppster (Upute)


Primjer nove definicije

Primjer - BigBang:

  1. Predpriprava (možete koristiti postojeće proizvode, cijenike, skladišta)
    1. U MetaKocki, ako još nemate unesenih proizvoda, koje bi razmjenili s BigBangom, kreirajte ih
    2. Kreirajte prodajni cjenik, koji će važiti za razmjenu sa BigBangom, ukoliko taj cjenik i dalje postoji
    3. Kreirajte novo skladište ukoliko baš to skladište bude važilo za razmjenu, u protivnom koristite postojeće skladište
  2. U Dodatnim postavkama -> Prilagodba izvoza -> kliknite na gumb "Nova"
  3. Odaberite "BigBang" predložak i potvrdite s gumbom "Dodaj"
  4. U prilagodbi odaberite cjenik koji će važiti za BigBang i skladište koje će se koristiti, te spremite
  5. Ako sada otvorite URL, proizvodi se neće prikazati, pošto nemaju ispunjene zahtjevane parametre
  6. Potrebno je dopuniti zahtjevane parametre za proizvode koji nedostaju
    1. Na cjeniku će se prikazati dodatni PPC stupci. Potrebno je ispuniti PPC i podesiti porez.
    2. Na proizvodu je potrebno odabrati kategoriju i upisati brend
  7. Ako ponovno otvorite URL, proizvodi će se ispisati.



Postavke



Za pojedinačnu prilagodbu izvoza, može se podesiti: 


Ime

Ime veze, koja se prikazuje samo u popisu veza. Po želji odredite

UUID

Jedinstveni identifikator, koji se koristi u URL adresi za identifikaciju razmjene. Kreira se automatski prilikom nove razmjene i nije moguće izmijeniti ga.


Sigurnosni ključ

Sigurnosni niz koji se koristi u URL adresi za uki se uporabi v URL naslovu za overjanje izmenjave. Pripravi se samodejno ob novi izmenjavi in ga je mogoče spremeniti. 


URL

Online veza preko koje se pristupa Spletna povezava preko katere se dostopa do izpisa izmenjave. Ovaj URL dijelite s BigBangom i kao takav sadrži podatke koje oni zahtjevaju. 


E-mail za javljanje pogreški

Ukoliko dođe do pogreški prilikom generiranja ispisa razmjene (primatelj klikne na URL), poslat će se e-mail s pogreškama na unesenu e-mail adresu. Može biti uneseno više e-mail adresa odvojenih zarezom. E-mail se u jednom danu može poslati najviše 5 puta.


Primjer korištenja: za određeni proizvod nedostaju zahtjevani podaci, kada na strani BigBang-a otvore poslan URL, znat ćete koje pogreške su prisutne u generiranim podacima.


Dozvoljene IP adrese

Za dodatnu sigurnost možete upisati IP adresu s koje dozvoljavate pristup podacima, koji se nalaze na URL-u koji ste podijelili


Izvor podataka

Odaberite odakle će se čitati podaci za generiranje ispisa razmjene.


Osnovni cjenik

Ukoliko je odabran cjenik, kao izvor podataka, ovdje je potrebno odabrati jedan ili više cjenika iz kojih će se čitati proizvodi. Prikazuju se samo prodajni cjenici. Ako postoji više cjenika, isti proizvod će se uzeti u obzir samo iz prvog cjenika.


Dodatni cjenik 1

Ukoliko je odabran cjenik kao izvor podataka, dostupna je opcija za odabir dodatnog cjenika. Prikazat će se nabavni i prodajni cjenici. Ovaj cjenik služi samo kao dopuna osnovnom cjeniku. Ako dodatni cjenik ima iste proizvode kao i osnovni cjenik, za te proizvode se kao dodatak mogu koristiti cijene iz dodatnog cjenika. Primjer su akcijske ili nabavne cijene.


Skladište

Potrebno je odabrati jedno ili više skladišta iz kojih će se čitati zaliha proizvoda.


Obavezni parametri

Ovdje se upisuju svi parametri (odvojeni zarezom) koji su obavezni za razmjenu. Isti se upisuju automatski, dok ih također možete i izmijeniti. Ako na primjer, ispisujete proizvode i proizvod nema ispunjene parametre koji su navedeni, taj proizvod neće biti dodan u ispis i za njega će se javiti pogreška, koju ćete primiti preko e-maila.


Opcijski parametri

Ovdje se upisuju svi parametri (odvojeni zarezom) koji su opcioni za razmjenu. Ako na primjer, ispisujete proizvode i proizvod nema sve ispunjene parametre koji su navedeni, za taj proizvod će se ispisati obavijest o parametrima koji nedostaju. Proizvod će se unatoč tome ipak dodati u završni ispis. Opcioni parametri koje možete dodati su dostupni u donjoj tabeli Popis parametara

Odgovor - tip

Tip predloška, koji se ispisuje. (Json, Xml, Text)


Odgovor - predložak


Generira se automatski prilikom dodavanja novog predloška


Ovdje mora biti upisan predložak za razmjenu u tipu odabranom iznad. Predložak mora biti ispunjen u FreeMarker stilu, dok parametri iz donjeg popisa parametra moraju biti upotrijebljeni. 

Primeri uporabe:1. Nastavljanje vrednosti: <izdelek st="${product.number!""}">2. Pogoj: <#if product.url??><url>${product.url!""}</url></#if>3. Seznam: <#list products as product><izdelek st="${product.number!""}"></#list>
XML


Napake - predložak


Generira se automatski prilikom dodavanja novog predloška


Ovdje mora biti upisan predložak pogreški za razmjenu u tipu odabranom iznad. Predložak mora biti ispunjen u FreeMarker stilu, dok parametri iz donjeg popisa parametra moraju biti upotrijebljeni. Ovaj predložak će biti ispisan u slučaju pogreški prilikom generiranja ispisa za razmjenu.


Dodatne postavke

MetaKocka podrška može podesiti i sljedeće postavke:


Ograničenje broja poziva

Koliko poziva možete izvesti u tekućem danu. Podrazumijevana vrijednost je 100. Ukoliko Vam je potrebna veća vrijednost, obratite se podršci.


Popis parametara

U predlošku možete koristiti sljedeće parametre

ParametarZnačenje
Extra column ID
company_titleIme Vaše firme
productsPopis proizvoda iz odabranog cjenika
product.numberUzastopni broj proizvoda u danom popisu
product.idMetaKocka ID proizvoda
product.nameNaziv proizvoda
product.codeŠifra proizvoda
product.eanBar-kod proizvoda
product.descriptionOpis proizvoda
product.packedAmountKoličina po paketu
product.packagingAmountBroj proizvoda u kompletu. Podrazumijevano je 1, automatski se podesi na više, ako proizvodi u kompletu pripadaju i odabranom cjeniku.
product.isSetTrue/False, ako je proizvod komplet
product.eanListPopis bar-kodova proizvoda u kompletu
ean.countUzastopni broj bar-koda proizvoda u kompletu
ean.valueBar-kod proizvoda u kompletu
product.brandBrend proizvoda
product.brand_fUPBrend proizvoda - velika pisana slova
product.largeImgSlika velikaslika_velika
product.smallImgSlika malaslika_mala
product.extraImg1Dodatna slika 1dodatna_slika_1
product.extraImg2Dodatna slika 2dodatna_slika_2
product.extraImg3Dodatna slika 3dodatna_slika_3
product.extraImg4Dodatna slika 4dodatna_slika_4
product.imagesCommaZdružen niz slika odvojenih zarezom. Niz se sastavi na temelju gornjih polja za slike. Ono što je upisano u "Slika velika" će uvijek biti na početku popisa.
product.imagesPopis samo dodatnih slika. U popisu svaka slika ima svoj broj i URL.
image.numberBroj dodatne slike
image.urlURL dodatne slike
product.urlURLurl
product.sellerUrlWeb stranica proizvođačaspletna_stran_proizvajalca
product.instructionsUpute
instructions
product.packagingTypeVrsta pakiranjaproduct_packaging_type
product.categoryShopCodeKod kategorije onl.tr.webshop_category_code
product.modelModelproduct_model
product.attributesAtributi - Primjer zapisa "Barva=Črna;Velikost=M;..."product_attributes
attribute.id"Boja" iz gornjeg primjera
attribute.value"Crna" iz gornjeg primjera
product.energyStickerEnergijska naljepnicaenergy_sticker
product.productPaperProduktni listproduct_paper
product.securityPaperSigurnosno-tehnički listsecurity_paper
product.benefitBenefitproduct_benefit
product.supplyDateRok dostave (dana)product_supply_date
product.groupIdID grupe proizvodaproduct_group_id
product.warrantyGarancijaproduct_warranty
product.customCategory
Kategorijaproduct_category
product.discountPopust iz cjenika. Stupac "P(%)"
product.discount_fSIPopust iz cjenika. Stupac "P(%)". Decimalni separator je zarez.
product.ppcPPC iz cjenika. Stupac "PPC"
product.ppcWithDiscountPPC s obračunatim popustom
product.ppcWithDdvPPC s porezom iz cjenika. Stupac "PPC s PDV-om"
product.ppcWithDdv_fSIPPC s porezom iz cjenika. Stupac "PPC s PDV-om". Decimalni separator je zarez.
product.ppcTaxFactorPPC PDV iz cjenika. Stupac "PPC PDV (%)"
product.ppcExtraPPC s obračunatim popustom iz dodatnog cjenika
product.netPriceExtraNeto cijena iz dodatnog cjenika
product.netPriceWithDiscountExtraNeto cijena s popustom iz dodatnog cjenika
product.grossPriceExtraCijena s PDV-om iz dodatnog cjenika
product.netPriceNeto cijena iz cjenika. Stupac "Cijena"
product.netPrice_fSINeto cijena iz cjenika. Stupac "Cijena". Decimalni separator je zarez.
product.taxRatePDV iz cjenika. Stupac "PDV (%)"
product.categoryNiz kategorija. Niz se sastavlja iz svih kategorija koje su odabrane za proizvod. Kategorije odvaja zarez.
product.propertiesPopis kategorija, koje su označene kao svojstva. To se podešava samo preko aktivirane funkcionalnosti "Enaa kategorije".
property.valueNaziv kategorije
property.titleAko postoji nadređena kategorija, u protivnom naziv kategorije.
product.stockStanje zaliha prikazano sa "0" ili "1"
product.stockTextStanje zaliha prikazano sa "Na lageru" ili "Nije na lageru"
product.stockTextYesNoStanje zaliha prikazano sa "da" ili "ne"
product.stockAmountKoličina zaliha

product.nonNegativeStockAmountKoličina zaliha. Ako su zalihe manje od 0, vrijednost se podesi na 0.
product.reservationAmountKoličina rezervacija
product.stockWithReservationAmountKoličina zaliha s uključenim rezervacijama
product.stockWithReservationAmount_fSIKoličina zaliha s uključenim rezervacijama. Decimalni separator je zarez
product.stockWithReservationAmountTextYesNoStanje zaliha s uključenim rezervacijama prikazano sa "da" ili "ne"
product.lengthDužina
product.length_fSIDužina. Decimalni separator je zarez.
product.widthŠirina
product.width_fSIŠirina. Decimalni separator je zarez.
product.heightVisina
product.height_fSIVisina. Decimalni separator je zarez.
product.weightBruto težina
product.weight_fSIBruto težina. Decimalni separator je zarez.
product.weight_netTežina
product.weight_net_fSITežina. Decimalni separator je zarez.


Neki parametri u stupcu imaju "Extra column ID" kao zapisanu vrijednost. To znači da je stupac dodatni, pošto u MK standardno ne postoji. Potrebno ga je dodati korištenjem ID-a i naziva iz stupca "Značenje".


Pregled zahtjeva

Prošle zahtjeve moguće je vidjeti u Dodatnim postavkama -> Prilagodba izvoza -> "Odaberite izvoz" -> Zahtjevi.

Do pogreške dođe, ako su u prilagodbi podešeni zahtjevani parametri i te parametre barem jedan proizvod ne ispunjava u cijelosti. U tom slučaju, u stupcu ''Pogreške'' će pisati "Error - missing data" pošto proizvod nije bio dodan u ispis. Pregled parametara koji su nedostajali dostupan je preko gumba ''M'' odnosno ako je pogreški previše potrebno je kliknuti na redak i potom dvaput na gumb ''Preuzmi''.

Na isti način rade i opcioni parametri, razlika je samo u tome što će vrsta pogreške "Warning - missing data" i proizvod svakako biti uključeni u ispis.


Pogreške, koje su posljedica zahtjevanih parametara koji nedostaju, bit će također poslane na e-mail adresu (limit 5 e-mailova na dan) ukoliko je ista upisana u prilagodbi.

Je li ovaj članak bio od pomoći?

To je odlično!

Zahvaljujemo na povratnim informacijama

Žao nam je! Nismo mogli biti od pomoći

Zahvaljujemo na povratnim informacijama

Obavijestite nas kako možemo poboljšati ovaj članak!

Odaberite barem jedan od razloga
Potrebna je potvrda CAPTCHA.

Povratne informacije poslane

Cijenimo vaš trud i pokušat ćemo popraviti članak