Funkcionalnost omogoča izvoz podatkov (ceniki, itd) v poljubni obliki (JSON, CSV, XML, itd), ki se določi kot predloga. Uporabno v primeru, ko želimo artikle s cenami, zalogo, slikami, itd izvoziti v strukturirani obliki za zunanji servis, kot so spletne trgovine ali ERP sistemi.
Podprte predloge :
- Mimovrste
- BigBang
- BigBang - akcijska cena
- EnaA
- Shoppster (Navodila)
Primer nove definicije
Primer - BigBang:
- Predpriprava (lahko uporabite obstoječe artikle, cenike, skladišča):
- V MetaKocki, če še nimate vnešenih artiklov, katere bi izmenjevali z Bigbangom jih ustvarite
- Ustvarimo prodajni cenik, ki bo veljal za izmenjavo z Bigbangom, v kolikor ta cenik še ne obstaja
- Ustvarimo novo skladišče v kolikor bo točno to skladišče veljalo za izmenajvo, v nasprotnem primeru uporabimo obstoječe skladišče
- V Dodatne nastavitve -> Prilagoditev izvoza -> kliknemo gumb "Nova"
- Izberemo "BigBang" predlogo in potrdimo z gumbom "Dodaj"
- V prilagoditvi izberemo cenik, ki bo veljal za Bigbang in skladišče, ki se bo uporabilo, ter shranimo
- Če sedaj odpremo URL se artikli ne bodo prikazali, ker nimajo izpolnjenih zahtevanih parametrov
- Potrebno dopolniti manjkajoče zahtevane parametre za artikle:
- Na ceniku se bodo prikazali dodatni PPC stolpci. Izpolniti je potrebno PPC in nastaviti davek.
- Na artiklu je potrebno izbrati kategorijo in vpisati blagovno znamko
- Na ceniku se bodo prikazali dodatni PPC stolpci. Izpolniti je potrebno PPC in nastaviti davek.
- Sedaj če ponovno odpremo URL se bodo artikli izpisali.
Nastavitve
Za posamezno prilagoditev izvoza se lahko nastavi:
Ime
Ime povezave, ki se prikaže samo v seznamu povezav. Poljubno določite
UUID
Edinstveni identifikator, ki se uporabi v URL naslovu za identifikacijo izmenjave. Pripravi se samodejno ob novi izmenjavi in ga ni mogoče spremeniti.
Varnostni ključ
Varnostni niz, ki se uporabi v URL naslovu za overjanje izmenjave. Pripravi se samodejno ob novi izmenjavi in ga je mogoče spremeniti.
URL
Spletna povezava preko katere se dostopa do izpisa izmenjave. Ta URL delite z Bigbangom in vsebuje podatke, ki jih zahtevajo.
Email za javljanje napak
V kolikor pride pri generiranju izpisa (prejemnik klikne na URL) izmenjave do napak, bo poslan email z napakami na vnešen email naslov. Vnešenih je lahko več email naslovov ločenih z vejico. Email se v enem dnevu pošlje največ 5x.
Primer uporabe: na določenem artiklu manjkajo zahtevani podatki, ko na strani Bigbanga odprejo poslan URL, boste prejeli katere napake so prisotne v generiranih podatkih.
Dovoljeni IP naslovi
Za dodatno varnost lahko vpišete IP s katerega dovolite, dostop do podatkov, ki se nahajajo na URLju, ki ste ga delili
Vir podatkov
Izbira iz kje se berejo podatki za generiranje izpisa izmenjave.
Osnovni cenik
V kolikor je izbran cenik, kot vir podatkov, je tukaj potrebno izbrati enega ali več cenikov iz katerih se bodo brali artikli. Prikazujejo se samo prodajni ceniki. Če ima več cenikov isti artikel se bo artikel upošteval samo iz prvega cenika.
Dodatni cenik 1
V kolikor je izbran cenik, kot vir podatkov, je na voljo opcija za izbiro dodatnega cenika. Prikazujejo se nabavni in prodajni ceniki. Ta cenik služi zgolj, kot dopolnitev osnovnemu ceniku. Če ima dodatni cenik enake artikle, kot osnovni cenik, se za te artikle lahko uporabi, kot dodatek, cene iz dodatnega cenika. Primer so recimo akcijske ali nabavne cene.
Skladišče
Izbrati je potrebno enega ali več skladišč iz katerih so bo brala zaloga artiklov.
Zahtevani parametri
Tukaj se, ločeno z vejico, vpiše vse parametre, ki so nujni za izmenjavo. Le ti se vpišejo samodejno, lahko pa jih spreminjate. Če, na primer, izpisujemo artikle in artikel nima izpolnjenih vseh navedenih parametrov, se ta artikel ne bo dodal v izpis in bo zanj javljena napaka, katero boste prejeli na email.
Opcijski parametri
Tukaj se, ločeno z vejico, vpiše vse parametre, ki so opcijski za izmenjavo. Če, na primer, izpisujemo artikle in artikel nima izpolnjenih vseh navedenih parametrov, bo za ta artikel izpisano obvestilo, da ima manjkajoče parametre. Artikel se bo še vedno dodal v končni izpis. Opcijski parametri, ki jih lahko dodate, so na voljo spodaj v tabeli Seznam parametrov
Odgovor - tip
Tip predloge, ki se izpiše. (Json, Xml, Text)
Odgovor - predloga
Se generira avtomatsko ob dodani novi predlogi.
Tukaj mora biti vpisana predloga za izmenjavo v tipu izbranem zgoraj. Predloga mora biti izpolnjena v FreeMarker stilu in uporabljeni morajo biti parametri iz seznama parametrov spodaj.
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>
Napake - predloga
Se generira avtomatsko ob dodani novi predlogi.
Tukaj mora biti vpisana predloga napak za izmenjavo v tipu izbranem zgoraj. Predloga mora biti izpolnjena v FreeMarker stilu in uporabljeni morajo biti parametri iz seznama parametrov spodaj. Ta predloga bo izpisana v primeru napak pri generiranju izpisa za izmenjavo.
Dodatne nastavitve
MetaKocka podpora lahko nastavi še dodatne nastavitve :
Omejitev št. klicev
Koliko klicev lahko izvedete v tekočem dnevu. Privzeta vrednost je 100. V kolikor rabite večjo vrednost, pišite na podporo.
Seznam parametrov
V predlogi lahko uporabite naslednje parametre.
| Parameter | Pomen | Extra column ID |
| company_title | Ime vašega podjetja | |
| products | Seznam artiklov iz izbranega cenika | |
| product.number | Zaporedna številka artikla v podanem seznamu | |
| product.id | MetaKocka ID artikla | |
| product.name | Naziv artikla | |
| product.code | Šifra artikla | |
| product.ean | Barkoda artikla | |
| product.description | Opis artikla | |
| product.packedAmount | Količina na paket | |
| product.packagingAmount | Število artiklov v kompletu. Privzeto 1, avtomatsko se nastavi na več, če so artikli v kompletu tudi v izbranem ceniku. | |
| product.isSet | True/False, če je artikel komplet | |
| product.eanList | Seznam barkod artiklov v kompletu | |
| ean.count | Zaporedna številka barkode arikla v kompletu | |
| ean.value | Barkoda artikla v kompletu | |
| product.brand | Blagovna znamka artikla | |
| product.brand_fUP | Blagovna znamka artikla - velike tiskane črke | |
| product.largeImg | Slika velika | slika_velika |
| product.smallImg | Slika mala | slika_mala |
| product.extraImg1 | Dodatna slika 1 | dodatna_slika_1 |
| product.extraImg2 | Dodatna slika 2 | dodatna_slika_2 |
| product.extraImg3 | Dodatna slika 3 | dodatna_slika_3 |
| product.extraImg4 | Dodatna slika 4 | dodatna_slika_4 |
| product.imagesComma | Združen niz slik razdeljenih z vejico. Niz se sestavi na podlagi zgornjih polj za slike. Kar je vpisano v "Slika velika" bo vedno na začetku seznama. | |
| product.images | Seznam samo dodatnih slik. V seznamu ima vsaka slika svojo številko in URL. | |
| image.number | Številka dodatne slike | |
| image.url | URL dodatne slike | |
| product.url | URL | url |
| product.sellerUrl | Spletna stran proizvajalca | spletna_stran_proizvajalca |
| product.instructions | Navodila | instructions |
| product.packagingType | Tip pakiranja | product_packaging_type |
| product.categoryShopCode | Koda kategorije spl.tr. | webshop_category_code |
| product.model | Model | product_model |
| product.attributes | Atributi - Primer zapisa "Barva=Črna;Velikost=M;..." | product_attributes |
| attribute.id | "Barva" iz zgornjega primera | |
| attribute.value | "Črna" iz zgornjega primera | |
| product.energySticker | Energijska nalepka | energy_sticker |
| product.productPaper | Produktni list | product_paper |
| product.securityPaper | Varnostni list | security_paper |
| product.benefit | Benefit | product_benefit |
| product.supplyDate | Dobavni rok (dni) | product_supply_date |
| product.groupId | ID skupine artiklov | product_group_id |
| product.warranty | Garancija | product_warranty |
| product.customCategory | Kategorija | product_category |
| product.discount | Popust iz cenika. Stolpec "P(%)" | |
| product.discount_fSI | Popust iz cenika. Stolpec "P(%)". Decimalno ločilo je vejica. | |
| product.ppc | PPC iz cenika. Stolpec "PPC" | |
| product.ppcWithDiscount | PPC z upoštevanim popustom | |
| product.ppcWithDdv | PPC z davkom iz cenika. Stolpec "PPC z DDV" | |
| product.ppcWithDdv_fSI | PPC z davkom iz cenika. Stolpec "PPC z DDV". Decimalno ločilo je vejica. | |
| product.ppcTaxFactor | PPC DDV iz cenika. Stolpec "PPC DDV (%)" | |
| product.ppcExtra | PPC z upoštevanim popustom iz dodatnega cenika | |
| product.netPriceExtra | Neto cena iz dodatnega cenika | |
| product.netPriceWithDiscountExtra | Neto cena s popustom iz dodatnega cenika | |
| product.grossPriceExtra | Cena z DDV iz dodatnega cenika | |
| product.netPrice | Neto cena iz cenika. Stolpec "Cena" | |
| product.netPrice_fSI | Neto cena iz cenika. Stolpec "Cena". Decimalno ločilo je vejica. | |
| product.taxRate | DDV iz cenika. Stolpec "DDV (%)" | |
| product.category | Niz kategorij. Niz se sestavi iz vseh kategorij, ki jih ima artikel izbrane. Kategorije ločuje vejica. | |
| product.properties | Seznam kategorij, ki so označene, kot lastnost. To se nastavi samo preko vklopljene funkcionalnosti "Enaa kategorije". | |
| property.value | Naziv kategorije | |
| property.title | Če ima starševske kategorije, če obstaja, drugače naziv kategorije. | |
| product.stock | Stanje zaloge prikazano z "1" ali "0" | |
| product.stockText | Stanje zaloge prikazano z "Na zalogi" ali "Ni na zalogi" | |
| product.stockTextYesNo | Stanje zaloge prikazano z "da" ali "ne" | |
| product.stockAmount | Količina zaloge | |
| product.nonNegativeStockAmount | Količina zaloge. Če je zaloga manjša od 0, se vrednost nastavi na 0. | |
| product.reservationAmount | Količina rezervacij | |
| product.stockWithReservationAmount | Količina zaloge z upoštevanimi rezervacijami | |
| product.stockWithReservationAmount_fSI | Količina zaloge z upoštevanimi rezervacijami. Decimalno ločilo je vejica | |
| product.stockWithReservationAmountTextYesNo | Stanje zaloge z upoštevanimi rezervacijami prikazano z "da" ali "ne" | |
| product.stockWithReservationAmountText | Stanje zaloge z upoštevanimi rezervacijami prikazano z "Na zalogi" ali "Ni na zalogi" | |
| product. stockWithReservationAmountNumber | Stanje zaloge z upoštevanimi rezervacijami prikazano z "1" ali "0" | |
| product.length | Dolžina | |
| product.length_fSI | Dolžina. Decimalno ločilo je vejica | |
| product.width | Širina | |
| product.width_fSI | Širina. Decimalno ločilo je vejica | |
| product.height | Višina | |
| product.height_fSI | Višina. Decimalno ločilo je vejica | |
| product.weight | Bruto teža | |
| product.weight_fSI | Bruto teža. Decimalno ločilo je vejica. | |
| product.weight_net | Teža | |
| product.weight_net_fSI | Teža. Decimalno ločilo je vejica. |
Nekateri parametri imajo v stolpec "Extra column ID" zapisano vrednost. To pomeni, da je stolpec dodatni, saj v MK privzeto ne obstaja. Potrebno ga je dodati z uporabo ID-ja ter naziva iz stolpca "Pomen".
Pregled zahtevkov
Pretekle zahtevke je mogoče videti v Dodatne nastavitve -> Prilagoditev izvoza -> "Izberete izvoz" -> Zahtevki.
Do napak pride, če so v prilagoditvi nastavljeni zahtevani parametri in teh parametrov vsaj en artikel ne izpolnjuje v celoti. Takrat bo v stolpcu "Napake" pisalo "Error - missing data" saj artikel ni bil dodan v izpis. Kateri parametri so pa manjkali se pa lahko vidi preko gumba "M" oz če je napak preveč je potrebno klikniti na vrstico in potem dvakrat na gumb "Prenesi".
Na enak način delujejo opcijski parametri, razlika je samo, da bo tip napake "Warning - missing data" in artikel bo vseeno vključen v izpis.
Napake, ki so posledica manjkajočih zahtevanih parametrov, bodo tudi poslane na email naslov (limit 5 mail-ov na dan) v kolikor je le-ta vpisan v prilagoditvi.
