WRAPPER se više ne razvija, mada je potpuno finkcionalan !
  • Kao alternativu proučite HRFiskalizator koji je jako kompatibilan sa Wrapperom.
    HrFiskalizator uz to podržava i druge napredne mogučnosti, kao što je slanje na fiskalizaciju pratečih dokumenata, izrada QRCoda, napojnice, itd.

    • Wrapper.exe - Program za komunikaciju sa CIS porezne uprave korištenjem DLL datoteke Raverus.FiskalizacijaDev.dll.

    Wrapper omogučava čitav niz kompleksnih operacija , i za njegovo korištenje je potrebno solidno informatičko znanje.
    One funkcije programa koje vam se čine nepotrebne zaboravite i ne umarajte se njima, iskoristite program na vama najjednostavniji način.

    Wrapper je u kompleksan program.

    Na njegov rad utiče mnoštvo vanjskih činbenika.

    Nemože se garantirati da če funkcionirati ispravno u svim programskim okruženjima.

    Stoga svoju korisničku aplikaciju dobro prilagodite radu sa Wrapperom.

    ZA KONAČNO ISPRAVNO FUNKCIONIRANJE PROCESA FISKALIZACIJE, I ISPRAVNOST DOBIVENIH PODATAKA
    ODGOVORAN JE PROIZVOĐAČ KORISNIČKE APLIKACIJE, I OBVEZNIK FISKALIZACIJE !
    Aktualna Verzija :
    podržava TLS1.1 i TLS1.2

    NOVOSTI. Stare verzije 2.x.x.x neče se moći korstiti od 07.01.2017 zbog ukudanja SSL protokola i prelaska na isključivo TLS1.1 ili 1.2

    Pazi, Verzije od 3.0.0.0 zahtjeva za rad .NET 4,5 ili više te ne radi na WINXP

    Za rad pod Win XP proučite HRFiskalizator koji je jako kompatibilan sa Wrapperom.
    HrFiskalizator uz to podržava i druge napredne mogučnosti, kao što je slanje na fiskalizaciju pratečih dokumenata, izrada QRCoda itd.
    ZIP sa NOVOM verijom ne sadrži tesnu okolinu i primjere, koje možete skinuti ovdje ovdje.

    Program možete skinuti ovdje : Download Link(moguće da je na Web serveru ukljućena HTTP kompresija - ukoliko ZIP skinut Explorerom ne valja treba zip skinuti Firefoxom ili Chrome browserom)

    Za rad Wrappera su iz ZIPA neophodni : Wrapper.exe , WrapperLib1.dll i Raverus.FiskalizacijaDEV.dll , ostalie datoteke su pomočne ili opcionalne.
    Wrapper ne zahtjeva priloženi Raverus.FiskalizacijaDEV.COM niti obratno.

    Predviđena uporaba programa je za podpisivanje i slanje u CIS xml datoteka kreiranih u drugim aplikacijama.

    • Program se izvršava bez prikaza prozora (nevidljivo za krajnjeg korisnika)što je neophodno kod pozivanja primjenu uz Clipper , Clarion i drugih DOS-BOX programskih okruženja (može se pozivati i iz windows aplikacija).
    • Nakon toga izvorna aplikacija obrađuje dobivene rezultate.


      • Opis upotrebe :
    • Certifikate instalirati kao i za Raverus.FiskalizacijaDev.EXE.exe ( više o projektu Raverus.fiskalizacijaDEV ) (Korisnički certifikat može biti neinstaliran uz korištenje iz pfx datoteke.)
    • U isti folder kopirati Wrapper.exe, Wrapper.ini , i WrapperLib1.dll , WrKonfig.exe, staviti svoju pfx datoteku sa certifikatom (netreba ako se certifikat učitava iz Stora)
    • U racun.xml i prostor.xml radi probe upisati svoj OIB (ovo su primjer datoteke, aplikaciju možete testirati i na osobno kreiranim datotekama - u tom slučaju u bat datoteke morate kao ulaznu datoteku upisati ime svoje ulazne datoteke)
    • U .bat datoteke unjeti svoje parametre naziva i passworda certifikata - i malo probati načine rada, radi upoznavanja
    • Za opis parametara moguće je pokrenuti program bez ikakvih parametara a zatim se malo radi upoznavanja igrati a opcijama u meniju programa.
    • U direktoriju applikacije se nakon uspješne potvrde CIS_a kreira različite datoteke čiji sadržaj definira sljedeča tablica.
    • Izvorna aplikacija potom obrađuje dobivene rezultate.

      • UKRATKO - NAJEDNOSTAVNIJI NAČIN UPOTREBE

      U svojoj aplikaciji kreirajte obične txt datoteke prema ovim primjerima i pošaljite ih pozivajuči Wrappera na ispod primjera datoteke opisan način.
      ili proučite OVDJE primjere za rad u rezidentnom modu. Shemu slanja računa Wrapperom iz rezidentnog moda pogledajte ovdje.
      Wraper odgovara na sve zadatke kao i iz naredbenog redka i vrača odgovor po ovoj shemi.
      Za podešavanje opcija unutar Wrapper.ini datoteke i prijavu poslovnih prostora u CIS iskoristite Wrapper.Konfigurator

      Besplatan upis korisnika je poželjan na Web adresi http://mvv.hr/wrapper/index.php , ali nema nikakvu ulogu u funkcionalnosti Wrappera.

      Ako iz nekog razloga OIB želite proglasiti za BANNED pri korištenju Wrappera to možete učiniti na na istoj web adresi ali za to trebate password koji možete
      besplatno dobiti ako me kontaktirate na E-mail vlado.vrbanec@mvv.hr .

    • Od korisnika programa očekuje da učestvuje u promociji osnovne djelatnosti (trgovina shop.mvv.hr ), proizvođaća Wrappera i to tako da kod kase, na ulaznim vratima ili prikladnom mjestu drži našu reklamnu naljepnicu veličine max A5,ili na svojem web shopu istiće link na naš itd...
      •    
      Opis argumenata kojim se trenutna verzija poziva - ujedno predstavlja i kratke upute koje se otvaraju ako Wrapper.exe pokrenemo bez argumenata :
    • Na Wrapper.exe se mogu primjeniti svi parametri kojima se poziva FiskalizacijaDEV.exe izuzev četvrtog parametra ,opis poziva FiskalizacijaDEV.exe: pogledajte ovdje

    • Aplikacija je testirana na WIN XP i WIN 7 operativnim sustavima i sve prijavljene greške proizlaze iz pogrešaka upisanih u xml datoteke te ispravnost pozivanja aplikacije.
    • Eventualne greške koje prijavljuju antivirusni programi slobodno zanemarite.

    Detalje evolucije programa po verzijama pogledajte : ovdje

     

    1) Unos parametara za pozivanje programa upisanih u textualnu datoteku, u kojoj je svaki red jedan programski argumenat.
    Takva datotaka se pri pokretanju programa učitava kao : Wrapper.exe USEINI mojaDatotekaSaArgumentima.
    Istu strukturu ima i datoteka sa naredbama koju prosljeđujemo Wrapperu u RESIDENTNOM modu.
    Datoteka može imati bilo koji nastavak.

    2) Pozivanje programa sa skračenim prvim argumentom po translacijskoj tablici :

    Manje bitni pozivi prisutni radi unazadne kompatibilnosti :
    		 Datoteka odgovora Moguči odgovori
    DST = DOHVATISTATUS Status.txt green ili red
    GUID = GENERIRAJUUID UUID.txt UID string
    GZKI = GENERIRAJZKI ZKI.txt ZKI string
    RZPP = RACUNZAHTJEVPOTPISI    
    RZPS = RACUNZAHTJEVPOSALJI    
    PPZPP = POSLOVNIPROSTORZAHTJEVPOTPISI    
    PPZPS = POSLOVNIPROSTORZAHTJEVPOSALJI    

    NOVO od verzije 3.0.2.1

    RPZ=RACCUNPROVJERAPOSALJI

    Svi ostali parametri i XML datoteka kao kod RZ

    		 Kao kod RZ

    1 red) UUID primljenog odgovora
    2) red Tekst primljenog odgovora (U slučaju ispravnog računa "Poruka je ispravna.")
    3 red ) prazan red
    4 red ) Šifra primljenog odgovora
    VRIJEME = DOHVATIVRIJEME Vrijeme.txt 05.12.2012/14:46:30 ili GREŠKA
    Uobičajeni pozivi pri slanju datoteke :
    RZ = RACUNZAHTJEV
    PPZ = POSLOVNIPROSTORZAHTJEV
    Napredni pozivi za slanje datoteke u TXT obliku :
    RZTXT = RACUNZAHTJEVTXT
    PPZTXT= POSLOVNIPROSTORZAHTJEVTXT
    Poziv u REZIDENTNI način rada : Shemu slanja računa Wrapperom iz rezidentnog moda pogledajte ovdje.

    RES ZADATAK.INI oib DatotekaSaKomandama(mijenja Wrapper.ini osim ako se navede "-" )

    ( u memoriji čeka na datoteku istog formata kakvu šaljemo naredbom USEINI )
    Omogučava obavljanje zadatak svake sekunde pa i češće.
    Poziv uz učitavanje naredbenog redka iz datoteke :
    INI = USEINI Primjer : USEINI DatotekaSaKomandama
    Poziv za enkripciju passworda:
    ENCP = ENCRYPTPASS
    * za pozivanje se mogu kao prvi parametar koristiti ili skračeni ili normalni oblik poziva
     
    *Eventualne neupisane nove mogučnosti pozivanja pogledajte u evluciji programa
    Dodatni mogući pozivanja u REZIDENTNOM MODU:
    SHOWBALLOON (SWB) Prikazuje hint kod sata
    Primjer :
    SHOWBALLOON
    2000 trajanje
    Naslov
    Ovo je text
    1 IKONE mogu biti 1=error 2=Warning svi_ostali_brojevi=info
    POKAZIFORMU (PKF) pokazuje formu
    SAKRIFORMU (SKF) sakriva formu
    SETVAR

    Mijenja vrijednosti varijabli koje Wrapper učitava iz Wrapper.ini datoteke novom funkcijom
    Mijenjati sa mogu sve vrijednosti iz ini datoteke.
    Primjer :
    		 SETVAR
    FormaOnError
    true
    0 1 bi upisao vrijednost u Wrapper.ini za drugo pokretanje
    DatotekaOdgovora.txt
    PING Detekcija dali Wrapper radi i čeka na DatotekuSaKomandama
    Ako radi javlja sa sa dva kratka bipa. i u datoteku PING.TXT upisuje OK
    KILLWRAPPER (KILLW) Zatvara svaku instancu Wrappera koja pročita datoteku sa naredbama
     
    3) Prije slanju zahtjeva u CIS izračunava i upisuje u datoteku zahtjeva( za Poslovni prostor i račun) <tns:IdPoruke> i <tns:DatumVrijeme> tako da ih u matičnoj aplikaciji netreba upisivati.

    4) Dobivene rezultate komunikacije sa CISom ili podatke o grešci vrača u TX datoteku sa odgovorom definiranoj parametrom 4.(Datoteka sa ispravnim odgovorom u prvom redu sadrži UUID , u drugom JIR , u trečem datum i vrijeme zaprimanja poruke u CIS_u , u četvrtom ZKI koji je kreiran pri dostavi zahtjeva CIS_u.)

    Preddefinirana kodna stranica odgovora se CP852 ali se može mjenjati unutar datoteke Wrapper.ini
    5) Vrača sistemsku varablu ERRORLEVEL
    100 Ako se aplikacija srušila prije kraja procedure (ili za zadanu proceduru nije definirana povratna vrijednost)
    0 Ako je cijela zadana procedura prošla bez greške
    1 Ako je u tijeku izvršenja zadane procedure došlo do greške
    6) Omogučuje upis povratnih informacija u textualne datoteke u kodnoj tablici preddefiniranoj u Wrapper.ini datoteci
    7) Pri pojavi greške (ako je parametar11 = true) otvara formu sa greškom (ukoliko je parametar11 = false ne otvara formu ali obavjest i podatke o grešci vrača u TX datoteku sa odgovorom definiranoj parametrom 4.)
    Usprkos toga što je parametar11=false forma če se otvoriti u slučaju nekih značajnijih sistemskih greški.
    8)Omogućuje unos parametra passworda u enkriptiranom obliku i tako omogučuje dobru zaštitu od krađe datoteke certifikata ako se za rad koristi certifikat u datoteci.
    Naime nakon svakog kopiranja datoteke cerifikata (recimo FISKAL1.PFX) potrebno je izračunati enkriptirani password.
    To se vrši pozivanjem Wrappera parametrima ENCRYPTPASS imeCertaDatoteke.pfx PasswordPfxDatoteke.
    Wrapper u direktoriju kreira novu datoteku pos imenom imeCertaDatoteke.txt u kojoj možemo pročitati Encrypted password za samo tu PFX datoteku.
    Txt datoteka je privremena i možemo je obrisati nakon što smo pročitali enkriptirani password.
    Kao password certfikata se za pozivanje Wrappera može koristiti obični ili enkriptirani password.
    Prilikom svakog narednog kopiranja *.PFX datoteke enkriptirani password treba ponovno izračunati. Stoga je nemoguća uporaba datoteke certifikata (na drugom računalu ili čak folderu) uz poznavanje samo enkriptiranog passworda.
    PAZI! u slučaju pozivanja funkcije ENCRYPTPASS sa krivim paswordom, Encrypted password če biti vraćen ali on če kao i originalni biti pogrešan.
    9)U slučaju dužeg čekanja na odgovor CIS_a, u trayu otvara baloon sa porukom "Još pokušavam osvariti Komunikaciju sa CISOM" kako korisnik nebi nasilno zatvorio matičnu aplikaciju koja čeka na izvršenje.
    10)Komunikaciju prekida po isteku time-out preddefiniranog vremenskog intervala , kako applikacija na odgovor nebi čekala beskonačno(i vrača grešku).
    11)Vlastitom detekcijom grešaka, olakšava programeru detekciju pogreški unutar pozivnih parametara i XML datoteka
    12)U slučaju povrata greške sa CIS servera - vraća stvarni text vračene greške
    13)Omogučuje slanje zadnje greške E_mailom - jednim klikom - na u Wrapper.ini preddefiniranu Email adresu

    Specifikacije vračenih podataka u TXT datoteci definiranoj parametrom 4:

    Broj reda TXT datoteke Upisani podatak
      RACUNZAHTJEV u slučaju urednog izvršenja
    1 UUID
    2 JIR
    3 Datum i vrijeme zaprimanja poruke u CIS_u
    4 ZKI koji je kreiran pri dostavi zahtjeva CIS_u.
      RACUNZAHTJEV u slučaju GREŠKE
    1  
    2  
    3  
    4 ZKI koji je kreiran pri dostavi zahtjeva CIS_u (neče biti upisan ako izazvana greška ne omogučuje izračun ili upis).
    5 nadalje <BEGINERROR>Text greške koja se dogodila pri lokalnoj obradi zahtjeva ili je vračena sa servera<ENDERROR>
      POSLOVNIPROSTORZAHTJEV u slučaju urednog izvršenja
    1 OK
      POSLOVNIPROSTORZAHTJEV u slučaju GREŠKE
    1 <BEGINERROR>Text greške koja se dogodila pri lokalnoj obradi zahtjeva ili je vračena sa servera<ENDERROR>

    14)Omogučuje uporabu konfiguracijske datoteke Wrapper.ini u kojoj se mogu preddefinirati sljedeće postavke
    U slučaju da se bilo koja od postavki unutar Wrapper.ini izostavi, primjenju se defaultne postavke, a isto tako ako ini datoteka uopče nije u folderu.

    Postavka Opis postavke :
    url_CIS URL CIS servera sa kojim želimo komunicirati (ako je blokiran vrača u program vrača "false")
    Primjer : url_CIS=https://cistest.apis-it.hr:8449/FiskalizacijaServiceTest
    mailto mail adresa za slanje porke greške
    Primjer : mailto=vlado.vrbanec@mvv.hr
    TXToutCodePage određuje kodnu stranicu u kojoj če Wrapper upisati txt u povratne TXT datoteke.
    Kodne stranice : http://msdn.microsoft.com/en-us/library/system.text.encoding.getencodings.aspx
    Default je CP852
    Primjer TXToutCodePage=CP852
    MaxLogSize Određuje broj redova u log datoteci nakon koje se ista briše default = 0
    Primjer : MaxLogSize=100
    BaloonPause Interval u kojem če Wrapper provjeravati ponovnu dostupnost servera CISA - nakon detektiranog gubitka konekcije
    Primjer : BaloonPause=3000 (provjerava jeli CIS dostupan svake 3 sekunde
    CISTimeout Određuje koliko će Wrapper čekati na odgovor CISa
    Primjer : CISTimeout = 20000 (20 sekundi)
    UsporediOIB

    Ako je false Wrapper prije slanja ne komparira OIBz certifikata i iz XML datoteke

    PAZI ! Ako ime korisnika ili naziv firme sadrži string "HR" - opciju OBAVEZNO STAVITI FALSE - jer če funkcija u protivnom usporediti pogrešan string iz certikfikata a ne OIB
    Primjer : UsporediOIB=True
    MessureTime Mjeri i prikazuje vremena potrebna za izvršenje zadatka
    Primjer : MessureTime=true
    SpremiXMLizmjene Sprema fizički u ulaznu datoteku <tns:IdPoruke>,<tns:DatumVrijeme> i <tns:ZastKod>
    U suprotnom datoteka ostaje nepromjenjena a XML string poslan u CIS sadrži sve podatke.
    Primjer : SpremiXMLizmjene=True
    BrisiDatotekuSaKomandama Nakon učitavanja Naredbi iz datoteke sa Naredbama istu briše sa diska ako je True ( "-" zadržava vrijednost iz Wrapper.ini)
    Primjer : BrisiDatotekuSaKomandama=True
    FormaOnResident Prikazuje formu iako Wrapper radi u rezidentnom modu
    Primjer : FormaOnResident=False
    DebugMode Uvjek mora biti true (koristi se za potrebe testiranja programa)
    Primjer : DebugMode=false
    FileReadTimeout Određuje Timeout čitanja datoteke nakon detekcije izmjenjenog stanja
    Veči Timeout osigurava veču sigurnost da neče doči do greške u čitanju iz datoteke sa komandama ali usporava izvršene zadatka.Kod večeg opterečenja procesora ili slabog računala staviti veći broj
    Primjer : FileReadTimeout=200
    UseHotkey Omogučuje iniciranje slanja datoteke u RESIDENTNOM modu pritiskom na tipke CTRL_L+CTRL_R
    Primjer : UseHotkey=False
    Beep_on_ok Zvučni signal nakon uspješno obavljenog zadatka
    Primjer : Beep_on_ok=True
    Beep_on_error Zvučni signal nakon NEUSPJELOG zadatka
    Primjer : Beep_on_error=True
    FormaOnError Prikazuje formu nakon SVAKOG NEUSPJELOG zadatka
    Primjer : FormaOnError=false
    FormaOnOk Prikazuje formu nakon SVAKOG USPJELOG zadatka
    Primjer : FormaOnOk=false
    ProvjeravajPotpisCisa
    		 Određuje dali će Wrapper provjeravati digitalni potpis u povratnoj XML datoteci
    Primjer : ProvjeravajPotpisCisa = false
    loggingDatoteka Određuje ime log datoteke (ako nije navedeno koristi se Wrapper.log)
    Primjer : loggingDatoteka=log1234.log
    TrayMenuP Određuje dali će biti prikazan skračeni Produkcijski korisnički meni u Trayu
    Primjer : TrayMenuP=True
       
      *Eventualne neupisane nove opcije Wrapper.ini datoteke pogledajte u evoluciji programa

    Primjer datoteke Wrapper.ini pogledajte ovdje

    14)Omogučuje konverziju i slanje u CIS txt datoteka sa podacima koje je vrlo jednostavno izraditi u DOS programima. Za tu namjenu uvedena su četiri nova pozivna argumenta RACUNZAHTJEVTXT i POSLOVNIPROSTORZAHTJEVTXT.

    Primjer datoteke sa računom za slanje Racuntxt.txt Redovi sa # su opisni i program ih ne procesira
    Primjer slanja:Wrapper.exe RACUNZAHTJEVTXT false Racuntxt.xml Racun_odg.txt true true "FISKAL1.pfx" pass true true true
    .Bat datoteka koja demonstrira proces skinite ovdje.
    Primjer datoteke sa PROSTOROM za slanje Prostortxt.txt Redovi sa # su opisni i program ih ne procesira
    Primjer slanja: PPZTXT false Prostortxt.xml Prostor_odg.txt true true "FISKAL1.pfx" pass true true true
    .Bat datoteka koja demonstrira proces skinite ovdje.

     

     
    Neka pitanja i odgovore vezana uz Wrapper pročitajte OVDJE

     

    Program se upotrebljava na vlastitu odgovornost.

    • Eventualna pitanja ili pomoć možete potražiti na mom e_mailu : vlado.vrbanec@mvv.hr