ComTrade Cash Registers SDK 2005v1

Šta je ComTrade Osnovni Korisnički Interfejs?
ComTrade Osnovni Korisnički Interfejs predstavlja skup svih osnovnih operacija i komandi na srednjem nivou komunikacije između korisničkog programa koji ga koristi s jedne strane i ComTrade fiskalnog uređaja s druge strane.
ComTrade Osnovni Korisnički Interfejs šalje komandu ComTrade fiskalnom uređaju, ComTrade fiskalni uređaj obrađuje, adresira, tu komandu, potom je izvršava i rezultate nakon izvršene komande/operacije vraća nazad ComTrade Korisničkom Interfejsu. ComTrade Korisnički Interfejs povratnu vrednost, rezultat, dalje prosleđuje korisničkom programu koji dalje taj isti rezultat obrađuje kako je predvideo sam programer koji je pisao korisnički program za krajnjeg korisnika.
ComTrade Osnovni Korisnički Interfejs koristi objektno orijentisanu filozofiju rada i distribuira se kao ActiveX Dll biblioteka.

Za koga je namenjen ComTrade Osnovni Korisnički Interfejs?
ComTrade Osnovni Korisnički Interfejs je prevashodno namenjen programerima (software developers – ljudima koji pišu programe) ili ljudima koji poseduju osnove elementarnog programiranja u savremenim programskim jezicima kao što su MS Visual Basic, MS Visual Fox Pro, MS Visual C++, MS Visual Basic dot.NET, MS Visual C#, MS Visual Basic For Applications (MS Office, Corel, AutoCad i sl.), Borland Delphi, ASP, PHP, ColdFusion i sl.

Potrebni preduslovi za korišćenje ComTrade Osnovnog Korisničkog Interfejsa
Za korišćenje ComTrade Osnovnog Korisničkog Interfejsa potrebno je sledeće:
- PC računar
- ComTrade fiskalni uređaj
- Operativni sistem MS Windows (Windows 98, Windows NT, Windows 2000, Windows XP, Windows Server, Windows VISTA – preporuka Windows XP)
- Instaliran ComTrade Osnovni Korisnički Interfejs na računaru
- Licenca za korišćenje
- Razvojna licenca tj. run-time kod ako se koristi za razvoj sopstvenih aplikativnih rešenje

Modeli licenciranja ComTrade Osnovnog Korisničkog Interfejsa
Licenciranje ComTrade Cash Registers SDK se vrši na tri načina sa i bez razvojne licence za korisnike,programere i to:

1. Licenciranje po IBFM-u (serijskom broju fiskalnog modula)	Ova licenca je namenjena krajnjim korisnicima koji imaju mali broj fiskalnih uređaja tj. jednu do dve.
2. Licenciranje po PIB-u (po firmi)	Ova licenca je namenjena krajnjim korisnicima koji imaju više fiskalnih uređaja.
3. Licenciranje po računaru korisnika (po računaru)	Ova licenca je namenjena korisnicima koji rade sa više CT fiskalnih uređaja, primer serviseri, distributeri, programeri i sl.

   Programer za svaki tip licence, bilo da se radi o razvoju programa ili o dristribuciji aplikacije za krajnjeg korisnika dobavlja, kupuje, jednu od navedenih licenci sa razvojnom licencom.

    Razvojna licenca je jedinstvena i važi samo za jednu izdatu korisničku licencu.

    Ograničenje Demo verzije je u tome što se pre rada sa fiskalnim uređajem prikazuje ekran u vremenskom trajanju od 5 sekundi za Windows aplikacije nakon čega korisnik treba da klikne na dugme UREDU da bi se izvršio proces, odnosno 10 sekundi se čeka pre izvršenja komande za web orijentisane aplikacije.

Tehnički pregled trenutnih operacija, komandi i instrukcija koje se mogu izvršiti koristeći ComTrade Cash Registers SDK 

OPIS Instrukcije, komande, operacije	REŽIM
	Čitanje	Pisanje
1. Artikli
- Baza artikala	Da	Da
- Lager artikala	Da	Da
- Provera artikla po PLU/Barkodu	Da	n-a
- Broj artikala u fiskalnom uređaju	Da	n-a
- Isčitavanje baze prodatih artikala	Da	n-a
- Brisanje artikala iz uređaja	n-a	Da
- Provera postojanja artikla pre brisanja	Da	n-a
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
- Podrška za oba pisma (ćirilica i latnica) sa automatskom konverzijom iz jednog pisma u drugo pri čitanju ili pisanju	Da	Da
- Podrška za XML fajlove	Da	Da
2. EKRAN, DISPLAY
- Čitanje ekrana OPERATER – Ekran br. 1	Da	n-a
- Čitanje ekrana OPERATER – Ekran br. 2	Da	n-a
- Čitanje ekrana KUPCA	Da	n-a
- Prikaz MEĐUZBIRA na ekranu operatera i kupca	Da	n-a
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
3. GRAFIČKI LOGO, GRAFIČKA REKLAMNA PORUKA
- Ažuriranje grafičkog loga br. 1	n-a	Da
- Ažuriranje grafičkog loga br. 2	n-a	Da
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
- Podrška za XML fajlove	Da	Da
4. IZVEŠTAJI
- Izrada dnevnog izveštaja	n-a	Da
- Anuliranje prodaje artikala	n-a	Da
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
5. JEDINICE MERE
- Baza jedinica mera - sistemske	Da	n-a
- Baza jedinica mere - korisničke	Da	Da
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
- Podrška za oba pisma (ćirilica i latnica) sa automatskom konverzijom iz jednog pisma u drugo pri čitanju ili pisanju	Da	Da
- Podrška za XML fajlove	Da	Da
6. KASIRI
- Baza kasira	Da	Da
- Statistika po kasiru (prodata količina, prodata vrednost)	Da	n-a
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
- Podrška za oba pisma (ćirilica i latnica) sa automatskom konverzijom iz jednog pisma u drugo pri čitanju ili pisanju	Da	Da
- Podrška za XML fajlove	Da	Da
7. MEMORIJA FISKALNOG UREĐAJA
- Čitanje sadržaja FISKALNE memorije po blokovima ili kompletnog sadržaja	Da	n-a
- Čitanje sadržaja PROGRAMSKE memorije po blokovima ili kompletnog sadržaja	Da	n-a
- Mogućnost snimanja sadržaja u eksterni lokalni fajl	n-a	Da
8. ODELJENJA
- Baza odeljenja	Da	Da
- Statistika po odeljenju (prodata količina, prodata vrednost)	Da	n-a
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
- Podrška za oba pisma (ćirilica i latnica) sa automatskom konverzijom iz jednog pisma u drugo pri čitanju ili pisanju	Da	Da
- Podrška za XML fajlove	Da	Da
9. PARAMETRI KASE
- Osnovni parametri kase (brizna protoka, grafika na kraju, grafika na početku, identifikacija kase, intenzitet štampe, meni održavanja, pojedinačna promena, štampanje međuzbira, štampanje ukupno komada, štampanje zbira u eurima, tonski signal, vrednost bon/kartice po postavci, zaduživanje kasira)	Da	Da
- Korisnički parametri (PIB i IBFM)	Da	n-a
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
- Podrška za XML fajlove	Da	Da
10. PORESKE STOPE
- Baza poreskih stopa	Da	n-a
- Statistika po poreskoj stopi	Da	n-a
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
- Podrška za XML fajlove	Da	Da
11. ZAGLAVLJE I REKLAMNA PORUKA
- Isečak ZAGLAVLJE	Da	Da
- Isečak REKLAMNA PORUKA	n-a	Da
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
- Podrška za oba pisma (ćirilica i latnica) sa automatskom konverzijom iz jednog pisma u drugo pri čitanju ili pisanju	Da	Da
- Podrška za XML fajlove	Da	Da
12. PRODAJA
- Prodaja artikala – kao klasičan štampač	n-a	Da
- Prodaja artikala – kao fiskalna kasa	n-a	Da
- Storniranje artikala	n-a	Da
- Plaćanje – automatski keš	n-a	Da
- Plaćanje – keš, ček ili kartica ili kombinacija 2 od 3 ili sva 3 načina plaćanja	n-a	Da
- Provera postojanja artikla	Da	n-a
- Ulaz gotovine	n-a	Da
- Izlaz gotovine	n-a	Da
- Prikaz međuzbira	Da	n-a
- Izrada izveštaja (vidi tačku 4. IZVEŠTAJI)	Da	n-a
- Čitanje sadrzaja ekrana na fiskalnom uređaju (vidi tačku 2. EKRAN, DISPLAY)	Da	n-a
- Status fiskalnog uređaja (vidi tačku 13. STATUS KASE)	Da	n-a
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
- Mogućnost snimanja i učitavanja artikala računa u/iz XML fajla	Da	Da
13. STATUS KASE
- Pregled statusa kase (broj PLU-a, broj pokušaja, broj transakcija, kasir, tip i podtip, stanje menija, trenutno stanja rada, zadnja greška)	Da	n-a
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
14. TASTATURA
- Zaključavanje tastature fiskalnog uređaja	n-a	Da
- Otključavanje tastature fiskalnog uređaja	n-a	Da
- Omogućen pristup i rad sa tasterima fiskalnog uređaja	n-a	Da
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
15. TIPOVI ARTIKLA
- Baza tipova artikala	Da	n-a
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
- Podrška za XML fajlove	Da	Da
- Podrška za oba pisma (ćirilica i latnica) sa automatskom konverzijom iz jednog pisma u drugo pri čitanju ili pisanju	Da	Da
16. VALUTE
- Baza valuta	Da	Da
- Statistika po valuti (prodata količina, prodata vrednost)	Da	n-a
- Pristup korisničkom interfejsu preko istog objekta na osnovnom nivou	Da	Da
- Podrška za oba pisma (ćirilica i latnica) sa automatskom konverzijom iz jednog pisma u drugo pri čitanju ili pisanju	Da	Da
- Podrška za XML fajlove	Da	Da
17. OSTALO
- Jedinstven interfejs za rad sa podacima tkz. Data Adapter	n-a	n-a
- Jedinstven interfejs za slanje i primanje podataka tkz. Prenos Podataka	n-a	n-a
- Centralizovani deo s komandama sa mogućnostima lakog proširenja i od strane programera	n-a	n-a
- Centralizovani deo s tasterima fiskalnog uređaja sa mogućnostima lakog proširenja i od strane programera	n-a	n-a
- Uključivanje WEB moda ako se radi o web aplikacijama – isključuje se prikazivanje prozora ali je vreme čekanja na izvršavanje bilo koje instrukcije preko interfejsa 10 sekundi.	n-a	n-a

Primeri koda u Visual Basic-u za korišćenje ComTrade Cash Registers SDK-a

Primer br. 1: Uzorak koda u MS VB/VBA/VBScript/ASP/VB.NET koji vrši isčitavanje sadržaja ekrana, displeja, fisklanog uređaja:

' Deklaracija promenljive tipa cEkran  Dim Ekran As cEkran  ' Kreiraj novu instancu objekta cEkran  Set Ekran = New cEkran  With Ekran       ' Procitaj sadrzaj ekrana (ekran korisnika, operatera erkan 1 & 2)       .Procitaj VremeCekanja:=1500       ' Prikazi u MessageBox-u procitani sadrzaj       MsgBox "Ekran korisnika prikazuje:" & vbCrLf & .EkranKorisnika       ' Prikazi u MessageBox-u procitani sadrzaj       MsgBox "Ekran operatera br. 1 prikazuje:" & vbCrLf & .EkranOperatera1       ' Prikazi u MessageBox-u procitani sadrzaj       MsgBox "Ekran operatera br. 2 prikazuje:" & vbCrLf & .EkranOperatera2  End With  ' Oslobodi memorijske resurse  Set Ekran = Nothing

Primer br. 2: Uzorak koda u MS VB/VBA/VBScript/ASP/VB.NET koji vrši prodaju i storniranje artikala kao fiskalna kasa:

' Deklaracija promenljive tipa cProdaja  Dim Prodaja As cProdaja  ' Kreiraj novu instancu objekta cProdaja  Set Prodaja = New cProdaja  With Prodaja       ' Otvaranje novog racuna       .NoviRacun TipKonekcije:=ctFiskalnaKasa, NacinProdaje:=ctKaoFiskalnaKasa       ' Prodaj artikal sa barkodom 1101 i kolicinom od 3       .ProdajArtikal Barkod:=1101, Kolicina:=3       ' Prodaj artikal sa barkodom 1234 i kolicinom od 2       .ProdajArtikal Barkod:=1234, Kolicina:=2       ' Storniraj artikal 1 komad artkla sa barkodom 1101       .StornirajArtikal Barkod:=1101, Kolicina:=1       ' Placanje i zatvaranje racuna,       ' opcija placanja automatski kes ili       ' placanje kombinacijom KES, CEK i KARTICA       .PlacanjeRacuna Kes:=1000, Cek:=0, Kartica:=0  End With  ' Oslobodi memorijske resurse  Set Prodaja = Nothing

Primer br. 3: Uzorak koda u MS VB/VBA/VBScript/ASP/VB.NET koji vrši prodaju i storniranje artikala kao klasičan štampač:

' Deklaracija promenljive tipa cProdaja  Dim Prodaja As cProdaja  ' Kreiraj novu instancu objekta cProdaja  Set Prodaja = New cProdaja  With Prodaja       ' Otvaranje novog racuna       .NoviRacun TipKonekcije:=ctFiskalnaKasa, NacinProdaje:=ctKaoStampac       ' Prodaj artikal sa barkodom 1101 i kolicinom od 3       .ProdajArtikal Barkod:=1101, Kolicina:=3       ' Prodaj artikal sa barkodom 1234 i kolicinom od 2       .ProdajArtikal Barkod:=1234, Kolicina:=2       ' Storniraj artikal 1 komad artkla sa barkodom 1101       .StornirajArtikal Barkod:=1101, Kolicina:=1       ' Placanje i zatvaranje racuna,       ' opcija placanja automatski kes ili       ' placanje kombinacijom KES, CEK i KARTICA       .PlacanjeRacuna Kes:=1000, Cek:=0, Kartica:=0  End With  ' Oslobodi memorijske resurse  Set Prodaja = Nothing

Primer br. 4: Uzorak koda u MS VB/VBA/VBScript/ASP/VB.NET koji vrši emulaciju unapred definisanog tastera BALGAJNIK/OPERATER:

' Deklaracija promenljive tipa cTasteri  Dim Tasteri As cTasteri  ' Kreiraj novu instancu objekta cTasteri  Set Tasteri = New cTasteri  ' Emulacija pritiska tastera BLAGAJNIK/OPERATER  Tasteri.Item("ctOneBlagajnik").Izvrsi  ' Oslobodi memorijske resurse  Set Tasteri = Nothing