29
FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere fisplus_pg_v1.0.0 strana 1 od 29 FisPLUS – Sertifikovani program interfejs FisLINK, FisCOMMAND moduli Uputstvo za programere Programmer’s Guide v.1.0.0 2008-08-01

Uputstvo Za Programere Galeb

Embed Size (px)

Citation preview

Page 1: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 1 od 29

FisPLUS – Sertifikovani program interfejs

FisLINK, FisCOMMAND moduli

Uputstvo za programere

Programmer’s Guide

v.1.0.0 2008-08-01

Page 2: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 2 od 29

Sadržaj

Uvod...........................................................................3

Kome je namenjen program ? ........................................................3 Načini funkcionisanja ..................................................................3

Minimalni zahtevi ............................................................5

Razmena podataka .........................................................6

Razmena – formati razmene..........................................................6 Razmena – FisLINK, FisCOMMAND ................................................7

Tabele – LINK import .....................................................10

Tabela ABC_nnn.DAT - Artikli, Bon, Komande – za FisLINK................10 Tabela REK_nnn.DAT - Reklamirani bon – za FisLINK ......................14 Tabela CMD_nnn.DAT – Komande – za FisLINK ..............................15 Tabela ART-N_nnn.DAT - Artikli novi – za FisLINK...........................16 Tabela ART-R_nnn.DAT - Artikli zanovljeni – za FisLINK ...................16 Tabela ART-D_nnn.DAT - Artikli za brisanje – za FisLINK ..................16 Tabela LLP_nnn.CSV - Komanda protokola – za FisCOMMAND ..........17

Tabele - LINK export (za FisLINK)......................................19

Tabela ZA - Detalji prodaje .......................................................19 Tabela ZB - Detalji plaćanja ......................................................21 Tabela ZB - Detalji plaćanja ......................................................21 Tabela ZC - Detalji Zatvaranja ...................................................23 Tabela ZR - Račun Original ......................................................23

Podaci koji se vraćaju ....................................................24

U vezi ABC - Artikli, Bon, Komande...............................................24 U vezi REK – Reklamiranje prometa..............................................25 U vezi CMD - Komandni tekst .....................................................25 U vezi COMM.ERR – Prekid komunikacije ......................................25 U vezi LLP - Komandni mod .......................................................26

Prilozi........................................................................27

A. Inicijalno punjenje artikala .......................................................27 B. Tabela za konverziju YUSCII u WIN1251....................................28

Page 3: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 3 od 29

Uvod

FisPLUS - program interfejs za povezivanje softverskih aplikacija sa fiskalnim štampačem FP550-Plus. Program je namenjen za podršku softverskim aplikacijama namenjenim POS (point-of-sale) radnim mestima. Kod rešenja, gde korisnički (prodajni) softver ne komunicira direktno sa fiskalnim štampačem, ovaj program omogućava implementaciju fiskalnog uredjaja. FisPLUS je okruženje za nekoliko softverskih modula: FisLINK – modul sertifikovanog drajvera za povezivanje korisničkih aplikacija sa fiskalnim štampačem koji funkcioniše u »File mod« načinu rada, FisCOMMAND – modul sertifikovanog drajvera za povezivanje korisničkih aplikacija sa fiskalnim štampačem koji funkcioniše u »Command mod« načinu rada, FisSERVIS – servisna aplikacija namenjena ovlašćenim servisima proizvođača.

Kome je namenjen program ? Sertifikovani drajver je namenjen programerima koji imaju sopstvena programska rešenja, a koji žele da ih uz minimalni napor integrišu u fiskalno rešenje, a da pri tome zadrže postojeću tehnologiju – proces rada. FisLINK, FisCOMMAND programi namenjeni kao midlleware - posrednik između vaših postojećih rešenja vezanih za poslovanje u trgovini – maloprodaja (na primer: Minimarketu, Supermarketu, specifičnoj prodaji delova, ugostiteljstvu, apotekama i slično) i Fiskalnog štampača FP550-Plus (kodna oznaka: KX) proizvođača Galeb Group - Bijeljina. Na (Point-of-Sale) naplatnom mestu pored vašeg postojećeg programa za maloprodaju - naplatu tzv. »KASA« , potrebno je instalirati i FisPLUS program. Ta dva programa rade istovremeno i sinhronizovano (FisLINK ili FisCOMMAND u pozadini – background-u). Za krajnje korisnike ovaj programa je neprimetan, i njihov svakodnevni način rada se NE menja. Pored toga FisLINK dijagnosticira i razrešava probleme nestanka papira na bonu i žurnalu, kao i prekid komunikacije i dovodi FP550-Plus u funkcionalno stanje. FisLINK olakšava rad kasira, poslovođe i poreske uprave kroz dodatne mogućnosti. Svi neophodni izveštaji za Poresku upravu, kao i Poslovođu su uključeni. Za detalje videti FisPLUS_UG_V1.0.0 (Uputstvo za rad krajnjih korisnika).

Načini funkcionisanja Fiskalni drajver može da funkcioniše u dva režima rada: »File mod« - File-ovi koji se šalju u predefinisane foldere sadrže u sebi više redova. U zavisnosti od tipa file-a inicira se skup komandi koje se prosledjuju fiskalnom štampaču.

Page 4: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 4 od 29

Tada se koristi modul FisLINK koji preuzima na sebe odgovornost da isprati integritet kompletne zatražene transakcije. Možemo da kažemo da program garantuje da jednom poslat file će biti obradjen do kraja i u uslovima: - nestanka struje na PC računaru, - prekida komunikacije sa fiskalnim štampačem u bilo kom trenutku, - nestanka i zamene papira na bonu i/ili žurnalu, itd. »Command mod« - Poslati file sadrži samo podatke za jednu komandu (iz seta korisnički dozvoljenih komandi). FisCOMMAND, koji se u ovom slučaju koristi, preuzima odgovornost da će poslate podatke korektno proslediti printeru i korisniku vratiti povratne bajtove. U ovom režimu rada odgovornost nad kompletnom transakcijom je na korisničkom softveru koji prosledjuje zahteve FisCOMMANDU-u (praćenja zastoja u radu štampača, praćenje senzora papira, integriteta započetog fiskalnog dokumenta itd.). Korisnik mora da izabere samo jedan način rada programa. U slučaju da se želi preći sa korišćenja jednog modula na primenu drugog modula mora se uraditi Dnevni izveštaj i izbrisati svi artikli iz fiskalnog printera te na početku rada poslati file sa artiklima. Istovremeno štampanje identičnih fiskalnih dokumenata u po jednom primerku na papirnoj traci za isečke i na kontrolnoj papirnoj traci kao i onemogućavanje štampanja nefiskalnih dokumenata koji sadrže ključne riječi ili simbole koje liče na fiskalni je regulisano osobinama fiskalnog štampača. Softver nema komunikaciju ka nefiskalnim štampačima tako da se štampa isključivo odvija na fiskalizovanom printeru. Štampanje svakog pojedinačno evidentiranog prometa na isječku fiskalnog računa i na kontrolnoj traci fiskalne kase-štampača ili fiskalnog štampača (a isto se odnosi i na storniranje prometa, evidentiranje reklamiranog prometa i storniranje reklamiranog prometa) zavisi isključivo od zahteva koje prosledi korisnički softver. Kako je prodajni interfejs sastavni deo korisničkog softvera na njemu je odgovornost da za svaku nastalu promenu prosledi zahtev fiskalnom drajveru.

Page 5: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 5 od 29

Minimalni zahtevi

O.S. - Operativni Sistem: Windows 98SE, NT, 2000, XP, Vista + Regional Setting : Decimal point is TAČKA. Procesor: Pentium II na 300 MHz ili više Memorija: 64 MB ili više Hard Disk: 1,0 GB slobodnog prostora COM Port: slobodan i ispravan VGA rezolucija: min 800 x 640, minimum 256 color VGA monitor: Monochrome 9 inch, Color 14 inch ili veći CD čitač: minimum 8X, ili brži. (samo za instalaciju). Cooler – hladnjak procesora: što kvalitetniji UPS - jedinica neprekidnog napajanja: poželjno, preporučujemo

Page 6: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 6 od 29

Razmena podataka

Razmena – formati razmene Da bi komunikaciju FisLINK programa i Vaših programa učinili pouzdanom i jednostavnom, podržali smo sledeće formate razmene podataka: CSV - Comma Separated Value je standardni format za razmenu podataka, koristi se najčešće za export / import podataka za EXCEL i druge programe za rad sa tabelama. Sve poznate RDBS (baze podataka) Oracle, SQL Server, Sybase, Informix, Posgres, Interbase, My SQL mogu da rade export / import podataka pomoću ovog formata podataka. Karakteristike ovog formata su da su SVAKA DVA PODATKA međusobno razdvojena zarezom (,) a da je PODATAK smešten između dva znaka duplog navoda (“), ukoliko korisnik ne šalje vrednost nekog podatka, jednostavno će upisati SAMO ZAREZ. DBF – dBase III format je standardni format za razmenu podataka, koristi se najčešće u programima tipa dBASE, FoxBase, Visual Fox, Clipper, Alaska … TXT – format fiksne širine podataka je standardni format za razmenu podataka, koristi se najčešće u programima tipa COBOL, FORTRAN, .... XML – eXtended Markup Language je standardni format za razmenu podataka, najnovije generacije koristi se najčešće u programima tipa C++, Java, C#, Pascal, …. DAT - Format je »nepostojeći format« koji se u dokumentaciji koristi kao jedan od četiri formata, u daljem tekstu ćemo umesto CSV, DBF, TXT, XML koristiti oznaku DAT. Da biste jednostavno proverili, da li ste u Vašem programu uradili sintaksno ispravnu konverziju podataka (broj polja, dužinu, tip podataka) koje bi trebalo da pošaljete u program FisPLUS, pripremili smo i PRIMERE svih ulaznih i izlaznih datoteka u svim podržanim formatima. Primere možete preuzeti sa URL: http://www.galeb.com/

Page 7: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 7 od 29

Razmena – FisLINK, FisCOMMAND Vaš Program i program FisLINK(ili FisCOMMAND) komuniciraju preko foldera:

Folder Communication v6.50

/Store/To_Kasa/...S T O R E

K A S A

L I N K

C:\METALINE

LOCAL_INSTALL_DIR

STORE_INSTALL_DIR

/Kasa/To_Store

/Lnk/From_FP

FP - 550

/Kasa/From_Store

/Lnk/To_FP

/Store/From_Kasa

B

A

A

Zašto je redosled važan ? Programi FisLINK i FisCOMMAND izvršava komande, datoteke u redosledu rastućih brojeva NNNN. Drugim rečima, ako iz bilo kog razloga FisLINK (FisCOMAND) u folderu C:/Fis/EXCH/LNK/TO_FP pronađe više datoteka sa istim nazivom a različitom sekvencom, on će ih izvršavati po rastućem broju NNNN (prvo manji broj, pa veći). Trebalo bi obezbediti da se sekvenca ne ponavlja NAJMANJE u toku jednog dana.

==> C:/METALINE/EXCH/LNK/TO_FP (sve što je poslato ka programu FisLINK, tj. Sve što Vi šaljete, tzv. »Ulazni folder«) ==> C:/METALINE/EXCH/LNK/FROM_FP (sve što je poslato ka vašem programu, tj. Sve što Vi primate, tzv. »Izlazni folder«)

Page 8: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 8 od 29

Napomena : Programer nije u obavezi (ako mu je to komplikovano) da šalje uvek uvećani broj sekvence. On može da stalno šalje datoteku XXX_0000.DAT pod uslovom da sam vodi računa da je na prethodno poslatu datoteku dobio odgovor (pozitivan ili negativan) i da ne šalje još jednu datoteku istog tipa, sve dok program FisLINK (FisCOMMAND) nije preuzeo (izbrisao iz ulaznog foldera) »staru datoteku« istog tipa. Programer JE DUŽAN DA OBRIŠE u »Izlaznom folderu« C:/Fis /EXCH/LNK/FROM_FP datoteke koje šalje (vraća) FisLINK (FisCOMMAND) kao dokaz u uspešnom / neuspešnom izvršenju. Preporučujemo da to radite najmanje jednom dnevno (na početku ili na kraju rada Vašeg programa). Programer NE SME DA FORMIRA datoteku za slanje ka FP550-Plus u »Ulaznom folderu« C:/Fis /EXCH/LNK/TO_FP , jer će to izazvati konflikt sa programom FisLINK. On mora da je formira u nekom svom folderu (na primer C:/TEMP) i onda je »KOPIRA« u folder C:/Fis /EXCH/LNK/TO_FP. Čim program FisLINK (FisCOMMAND) »opazi« neku datoteku u tom »Ulaznom folderu«, on pokušava da je »eksluzivno otvori« , ako u tome uspe on će je uzeti u obradu i nakon obrade obrisati. Ako ne uspe (jer je Vaš program ili sistem još uvek »drži«), neće je ni uzimatu u obradu. Datoteke koje su »Read Only« NEĆE NIKAD uzimati u razmatranje (jer ne bi mogao da ih obriše nakon obrade). Potrebne izmene u Vašem programu Da bi kompletno rešenje: Vaš program za maloprodaju, FisLINK, Fiskalni štampač funkcionisalo, kao jedinstveno rešenje, potrebno je da u Vašem programu uradite sledeće: Kad god formirate fiskalni račun u Vašeg programa, potrebno je da iz Vašeg programa u nekom Vašem folderu (ili na dugme), formirate datoteku ABC_nnn.DAT po definisanom formatu, i iskopirate je u »Ulazni folder« C:/Fis /EXCH/ LNK/TO_FP. Vaš program treba da sačeka nekoliko trenutaka (sekundi) da dobije povratnu informaciju (pozitivnu ili negativnu) u »Izlazni folder« C:/Fis /EXCH/ LNK/FROM_FP. Garantujemo da ćemo Vam uvek vratiti odgovor: .OK ili .ERR Ako ćete koristiti varijantu da Vi upravljate kompletnim transakcijama (FisCOMMAND) sa fiskalnim printerom onda treba da pripremite file LLP_nnn.CSV, kopirate u isti »Ulazni folder« C:/Fis /EXCH/ LNK/TO_FP. U ovom slučaju će povratni odgovor uvek biti u »Izlaznom folderu« C:/Fis /EXCH/ LNK/FROM_FP sa imenom LLP_nnn.OK. Napomena za FisLINK: Nove artikle nije potrebno slati, jer će ih program automatski prepoznati u ABC_nnn.DAT i dodati u FP550-Plus ako je potrebno. Postoji sinhronizacija baze korisničke aplikacije sa bazom štampača, tako da ukoliko u ABC fajlu pošaljete artikle koji postoje u štampaču, ali im se razlikuje naziv ili poreska stopa, fiskalni isečak se odbija u ABC_nnn.ERR je poruka: “Naziv ili/I Poreska grupa su promenjeni na toj šifri”. Takođe, prilikom pokretanja FisLINK-a, proverava se broj artikala u fiskalnom štampaču i bazi korisnika, ukoliko je narušena sinhronizacija podataka, FisLINK automatski zatvara dan i vrši sinhronizaciju podataka:

Page 9: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 9 od 29

Nove cene nije potrebno slati, jer će ih programa automatski prepoznati u ABC_nnn.DAT i dodati u FP550-Plus ako je potrebno. Brisanje artikala nije potrebno, već je dovoljno da na kraju dana izbrišete sve artikle (osim jednog) iz FP550-Plus iz Baze podataka i ponovo nastavite sa slanjem datoteke ABC_nnn.DAT. Zato postoji posebna komanda, koju programski šaljete.

Page 10: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 10 od 29

Tabele – LINK import

Svi numeričke podaci tipa NUMERIC(NN,n) unose se u polje kao NNNNN.NN tj. sa decimalnom tačkom (bez obzira na regional settings). Atributi obeleženi kao »NOT NULL« su obavezni za unos.

Tabela ABC_nnn.DAT - Artikli, Bon, Komande – za FisLINK ART_ID VARCHAR(20) NOT NULL TAX_ID VARCHAR(1) NOT NULL PLU_NAZIV VARCHAR(40) NOT NULL CENA NUMERIC(10,2) NOT NULL KOLICINA NUMERIC(10,3) NOT NULL OPIS ATRIBUTA: ART_ID VARCHAR(20) NOT NULL (obavezno) Šifra artikla u Vašem programu za maloprodaju ili knjigovodstvo. Služi za Vaše praćenje stanja, zaliha,… Softver će za novu vrednost ART_ID dodati novi PLU u bazu artikala (uz poštovanje pravila o jednoznačnosti naziva artikala). Za ART_ID koji je već upisan u bazu artikala izvršiće se kontrola da li je sadržaj polja PLU_NAZIV i TAX_ID indentičan vrednostima koje su u bazi podataka i u suprotnom odbiti prodaju zbog nemogućnosti menjanja ovih parametara u zabranjenom periodu. TAX_ID VARCHAR(1) NOT NULL (obavezno) Šifra poreske grupe kojoj pripada artikal. (0-A, 1-E, 2-J, 3-K) Programer unosi brojeve (0 – 3), a oni se konvertuju u ćirilična slova. Zakonom je precizno definisano koja roba, usluga pripada kojoj poreskoj grupi.

Napomena: U Republici Srpskoj po Zakonu o fiskalnim kasama važi: (0 – A) nije u PDV-u 0%, (1 – E) viša stopa17% (2 – J) niža stopa, (3 – K) oslobođeno poreza 0 %,

Page 11: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 11 od 29

PLU_NAZIV VARCHAR(40) NOT NULL (obavezno) Naziv artikla u fiskalnom štampaču. Firmware – sistemski program u Fiskalnom štampaču radi proveru jedinstvenosti naziv artikla na sledeći način: Iz Naziva izbacuje vodeće i krajnje blank-ove space-ove, zatim u sredini sažme višestruke blank-ove u jedan i proveri da li takav naziv već postoji. Ako postoji odbija da prihvati novi artikal i FisLINK ga vraća kao pogrešan. Programer može da unosi naziv po YUSCII standardu, i da zahteva ili (ne zahteva) konverziju u code page WIN1251 tj. Ćirilicu. Tabela konverzije YUSCI karaktera u srpsku ćirilicu data je posebnoj tabeli. CENA NUMERIC(10,2) NOT NULL (obavezno) Cena sa obračunatim porezom (pdv). Napomena: Maksimalno dozvoljena cena po Zakonu je 999999.99 mora biti > 0.00

KOLICINA NUMERIC(10,3) NOT NULL (obavezno) Prodata - stornirana količina. Količina MOŽE biti negativna. !!! i mora biti u jednom od dozvoljenih formata:

Napomena: Naziv NE SME biti duži od 32 Ch. Naziv NE SME DA SADRŽI ZNAKE (,“) ZAREZ, DUPLE NAVODNIKE jer ih Fiskalni Printer odseca. Naziv NE SME DA SADRŽI ZNAKE, (ŠĐČĆŽšđčćž) NAŠA LATINIČNA SLOVA zbog nepodudarnosti kodnih strana PLU_NAZIV po Zakonu mora biti jedinstven, tj. NE SME SE PONOVITI isti naziv kod dva ili više artikala

TXT DBF 1234567890 1234567890 NNNNN 12345 12345.000 NNN,N 123.4 123.400 NN,NN 12.34 12.340 N,NNN 0.123 1.234

Page 12: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 12 od 29

Omogućen je u okviru ABC.dat prijem i (Storno) stavki sa negativnim količinama, ali takvih da se time KOMPLETNO stornira neka od ranije prodatih stavki, Za ulaz: Za ulaz: 1. Jelen pivo 3 kom 1. Jelen pivo 3 kom 2. Jelen pivo 1 kom 2. Jelen pivo 1 kom Nije dozvoljeno !!! Dozvoljeno !!! 3. Jelen pivo -2 kom !!! ili 3. Jelen pivo -1 kom !!! 4. Jelen pivo -4 kom !!! 4. Jelen pivo -3 kom !!! Ukoliko pošaljete neispravnu storno stavku (sa netačnom negativnom količinom), Fiskalni printer će to odbiti. Važna napomena: Molimo Vas da se upoznate sa principima funkcionisanja fiskalnog printera FP550-Plus kroz detaljne opise komunikacionog protokola. U situacijama kada program ne može da sprovede sve stavke isečka zbog ograničenja u izvršenju komandi printera može da dodje do neregularne situacije da se stornira ceo isečak. Ova situacija je pod odgovornošću korisnika tako da morate poslati i formalno ispravan file za printer. ABC_nnn.DAT - Primer ART_ID TAX_ID PLU_NAZIV CENA KOLICINA 1000 3 NAZIV 1000 100.00 12345.0002000 3 NAZIV 2000 150.00 123.4003000 3 NAZIV 3000 200.00 12.3404000 3 NAZIV 4000 250.00 1.2345000 1 NAZIV 5000 300.00 0.1236000 1 NAZIV 6000 400.00 1.000KRAJBONA 1 KRAJBONA 1.00 0PAY_1 1 PLATI CEKOM 200.00 0PAY_2 1 PLATI KARTICOM 300.00 0PAY_3 1 PLATI GOTOVINOM 900.00 0PAY_4 1 PLATI VIRMANOM 100.00 0USR_ID 1 »SIFRA KASIRA« < 4 CH 1.00 0USR_NAME 1 »IME KASIRA« < 25 CH 1.00 0CMD159 1 »4. RED FUTERA« < 32 CH 1.00 0CARD_ID 1 »BROJ KARTICE« < 20 CH 1.00 0 Napomena: CENA je maloprodajna cena artikla u bonu, KOLICINA je prodata kolicina (ako je negativna onda je storniranje evidentiranog prometa),

KRAJBONA je OBAVEZNA klauzula, ona označava da nema više prodatih artikala u Bonu.

Page 13: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 13 od 29

NEOBAVEZNI REDOVI: Nijedan red iza KRAJBONA ne mora da postoji. Mogu postojati neki a drugi ne, ali oni koji se pojavljuju MORAJU BITI u navedenom redosledu. Primer: Ne može prvo PAY_2, pa zatim PAY_1. PAY_1, PAY_2, PAY_3, PAY_4 iznosi plaćanja Ukoliko je zbir iznosa PAY_1, PAY_2, PAY_3, PAY_4 manji od iznosa računa, ostatak će biti plaćen gotovinom. Ukoliko je zbir iznosa PAY_1. PAY_2, PAY_3, PAY_4 veći od iznosa računa, iskoristiće se iznosi u redosledu PAY_1, pa zatim PAY_2, pa zatim PAY_3, pa zatim PAY_4 sve dok se na namiri račun. USR_ID, USR_NAME, CMD159, CARD_ID USR_ID nije obavezno polje i predstavlja šifru kasira koji je radio na kasi tj. izdao fiskalni isečak, biće upisano u lokalnu bazu FisLINK-a. USR_NAME nije obavezno polje i predstavlja ime kasira koje će biti upisano u lokalnu bazu FisLINK-a i odštampano na fiskalnom isečku, koji je izdao taj kasir. CMD159 je primer komande koja takodje nije obavezna, a služi za zadavanje reklamnog teksta na fiskalnom isečku(u ovom slučaju to je komanda za zadavanje 4. reda footer-a). CARD_ID je broj kartice kupca. To je neobavezno polje. Služi za identifikaciju kupca i ovaj broj kartice će biti upisan u lokalnu bazu FisLINK-a. Imaćemo uvid kom kupcu je izdat neki fiskalni isečak, sa popustom ili slično. Opcionalna polja čija primena je objašnjena u primeru. u Polja pod navodnicima »xxxx« unesite odgovarajući podatak. ABC_nnn.DAT - Obrada Program analizira file i

Ako je sintaksno neispravan file, vraća ga kao ABC_nnn.ERR Ako je ispravan onda,

proverava istovetnost naziva artikla i poreske grupe sa upisanim podacima u bazi artikala šalje najpre CMD159, da promeni 4. red footer-a. šalje podatke USR_ID, USR_NAME, šalje Nove artikle i/ili izmene cena (prema potrebi) šalje BON sa prodatim artiklima, plaća BON prema specifikaciji, zaključuje račun i otvara fioku.

Page 14: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 14 od 29

Tabela REK_nnn.DAT - Reklamirani bon – za FisLINK Ova tabela ima indentičnu strukturu kao ABC_nnn.DAT.

Da bi se reklamiranje prometa registrovalo kao poslednji red obavezno se šalje REKBROJ sa brojem reklamiranog fiskalnog računa u 3. polju.

ART_ID TAX_ID PLU_NAZIV CENA KOLICINA 1000 3 NAZIV 1000 100.00 12345.0002000 3 NAZIV 2000 150.00 123.4003000 3 NAZIV 3000 200.00 12.3404000 3 NAZIV 4000 250.00 1.2345000 1 NAZIV 5000 300.00 0.1236000 1 NAZIV 6000 400.00 1.000KRAJBONA 1 KRAJBONA 1.00 0PAY_1 1 PLATI CEKOM 200.00 0PAY_2 1 PLATI KARTICOM 300.00 0PAY_3 1 PLATI GOTOVINOM 900.00 0PAY_4 1 PLATI VIRMANOM 100.00 0USR_ID 1 »SIFRA KASIRA« < 4 CH 1.00 0USR_NAME 1 »IME KASIRA« < 25 CH 1.00 0CMD159 1 »4. RED FUTERA« < 32 CH 1.00 0CARD_ID 1 »BROJ KARTICE« < 20 CH 1.00 0REK_BROJ 1 »Broj reklamiranog racuna« 1.00 0

»Broj reklamiranog racuna« je u formatu ZZZZZ9.

Provera da li je naziv artikla i pripradnost poreskoj grupi indentična upisanim podacima u bazi artikala sprovodi se i kod ovog vida evidentiranja prometa.

Storniranje evidentiranog reklamiranog prometa se šalje sa negativnim predznakom u količini ali se mora voditi računa da se može stornirati samo ista količina sa neke od evidentiranih stavki.

Za reklamirani isečak treba voditi računa da li ima dovoljno sredstava plaćanja da može da se izvrši povrat. U slučaju primanja drugih sredstava plaćanja povrat će biti izvršen sa poslatim načinom plaćanja.

Page 15: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 15 od 29

Tabela CMD_nnn.DAT – Komande – za FisLINK KOMANDA VARCHAR(3) NOT NULL TEKST VARCHAR(40) NOT NULL

KOMANDA VARCHAR(3) NOT NULL (obavezno), Šifra komande koja se šalje Fiskalnom štampaču. TEKST VARCHAR(40) NOT NULL, (obavezno) max. dozvoljeno 30 Ch KOMANDE ZA PRODAJU 10 proizvoljan tekst Prikaži u gornjem redu display tekst do 20 ch 20 proizvoljan tekst Prikaži u donjem redu display tekst do 20 ch 30 Otvori Fioku (na kraju računa se otvara automatski) 50 100 Unesi depozit u kasu od 100.00 dinara 60 200 Izvadi depozit iz kase od 200.00 dinara 70 Pošalji zvučni signal – Beep 156 Promeni tekst u 1. liniji footera (od 4 linije) 159 Promeni tekst u 4. liniji footera (od 4 linije) KOMANDE – OBAVEZNI IZVEŠTAJI 80 Štampaj Presek stanja - (X izveštaj) 90 Štampaj (Z izveštaj) tj. zatvori dan 100 DDMMYY-DDMMYY Štampaj periodični izveštaj DDMMYY-DDMMYY 200 Štampaj artikle prodate u toku dana KOMANDE ZA BRISANJE PODATAKA 140 Briši sve artikle iz Baze i FP ANALITIKA PRODAJE (artikli, plaćanja, zetovanja) 220 DDMMYY-DDMMYY Vraća files Analitika prodaje za period, ZA, ZB, ZC 230 DDMMYY-DDMMYY Izbriši iz baze analitiku prodaje za period 240 Vraća files Analitika prodaje za otvoren dan XA, XB 250 DDMMYY-DDMMYY Vraća files za storno ZAS, ZBS 260 Pređi na letnje vreme (dan je zatvoren!) 270 Pređi na zimsko vreme (dan je zatvoren !) 130 Vraća file Artikli.dat sa svim artiklima koji su u bazi Sve File-e koje FisLINK vraća, nalaze se u folderu Exch/Lnk/From_FP Datoteke ZAS i ZBS identične su datotekama ZA i ZB samo što sadrže samo storno stavke.

Napomena ! U jednoj tabeli – „slanju“ možete poslati više komandi, jednu za drugom. Komande se mogu slati pre ili posle ABC_nnn.DAT

Page 16: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 16 od 29

Napomena: Ako želite da vizuelno pratite tok evidentiranja prometa posle prodaje svakog artikla iz vašeg programa ispišete na displeju naziv artikla i cenu, onda posle svake prodaje artikla u vašem programu pošaljite fajl CMD_1.DAT u kome ćete poslati naziv i cenu tog artikla (komande 10 i 20).

Tabela ART-N_nnn.DAT - Artikli novi – za FisLINK Ova tabela ima istu strukturu kao i tabela ABC_nnn.DAT do reda KRAJ BONA. Šaljete SAMO NOVE Artikle (ako želite). Novi artikli će se proslediti (upisati) ODMAH u Fiskalni štampač. Napomena: Program će i dalje obradom datoteke ABC.DAT dodavati nove artikle, menjati im cenu i sl.

Tabela ART-R_nnn.DAT - Artikli zanovljeni – za FisLINK Ova tabela ima istu strukturu kao i tabela ABC_nnn.DAT do reda KRAJ BONA. Šaljete SAMO ZANOVLJENE (renew) Artikle (kojima ste promenili naziv i/ili poresku grupu). Prijem ove datoteke zahteva da MetaLINK ODMAH zatvori dan, da bi te promene prosledio u Fiskalni štampač. Zato pazite kada će te je poslati. Napomena: Opciju koristiti kada se zbog izmene Zakona o PDV-u nekim artiklima promeni poreska grupa.

Tabela ART-D_nnn.DAT - Artikli za brisanje – za FisLINK Ova tabela ima istu strukture kao i tabela ABC_nnn.DAT do reda KRAJ BONA. Šaljete SAMO Artikle koje želite TRAJNO da izbrišete iz fiskalnog štampača (isključite iz asortimana). Ova datoteka biće obrađena tek nakon zatvaranja dana. Napomena: Preporučujemo da ukoliko imate potrebu, na kraju dana (posle Zatvaranja dana) pošaljete istovremeno i ART-R_nnn-DAT i ART-D_nnn.DAT, time izbegavate »nepotrebno« dodatno zatvaranje dana.

Page 17: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 17 od 29

Tabela LLP_nnn.CSV - Komanda protokola – za FisCOMMAND Ova tabela ima sledeću strukturu

KOMANDA VARCHAR(3) NOT NULL TEKST VARCHAR(100)

KOMANDA VARCHAR(3) NOT NULL (obavezno), Šifra komande koja se šalje Fiskalnom štampaču (decimalna vrednost broja komande). Korisniku je na raspolaganju sledeći set komandi: 1. Komanda 21h (33) Brisanje displeja; 2. Komanda 23h (35) Prikazivanje teksta na donjem redu dispelja; 3. Komanda 2Bh (43) Zadavanje HEADER-a I FOOTER-a; 4. Komanda 2Ch (44) Pomeranje papira; 5. Komanda 2Dh (45) Sečenje papira; 6. Komanda 30h (48) Otvaranje fiskalnog isečka; 7. Komanda 32h (50) Poreske stope koje se zadaju u odgovarajućem periodu; 8. Komanda 33h (51) Kontrolni iznos – medjuzbir; 9. Komanda 34h (52) Registrovanje i prikazivanje na displeju; 10. Komanda 35h (35) Evidentiranje plaćanje (total); 11. Komanda 38h (56) Zatvaranje fiskalnog isečka ; 12. Komanda 3Eh (60) Korekcija časovnika na letnje/zimsko vreme; 13. Komanda 3Fh (63) Prikazivanje datuma i vremena; 14. Komanda 3Eh (62) Vraća datum i sat ; 15. Komanda 40h (63) Podaci o poslednjem dnevnom izveštaju; 16. Komanda 41h (65) Podaci o iznosima u toku dana; 17. Komanda 44h (68) Broj slodobnih prostora u fiskalnoj memoriji; 18. Komanda 45h (69) Dnevni fiskalni izveštaj/Presek stanja; 19. Komanda 46h (70) Službena uplata I podizanje novca; 20. Komanda 47h (71) Štampanje dijagnostičkih podataka; 21. Komanda 4Ah(74) Utvrdjivanje statusa; 22. Komanda 4Ch (76) Status fiskalne transakcije; 23. Komanda 4Fh (79) Periodični izveštaj iz fiskalne memorije; 24. Komanda 50h (80) Zvučni signal; 25. Komanda 50h (81) Informacija o prodaji u isečku; 26. Komanda 53h(83) Zadavanje decimalnih mesta i dozvoljenih poreza; 27. Komanda 5Ah (90) Vraća dijagnostičku informaciju; 28. Komanda 61h (97) Očitavanje zadatih porekskih stopa; 29. Komanda 63h (99) Očitavanje IBO i IPO broja; 30. Komanda 64h (100) Prikazivanje teksta na displeju; 31. Komanda 65h (101) Zadavanje lozinke operatera; 32. Komanda 66h (102) Zadavanje imena operatera; 33. Komanda 67h (103) Podaci o tekućem isečku; 34. Komanda 68h (104) Nuliranje podataka o operateru; 35. Komanda 68h (105) Izveštaj po operaterima; 36. Komanda 6Ah (106) Otvaranje fioke; 37. Komanda 6Bh (107) Definisanje i očitavanje artikala (bez parametra “DA”); 38. Komanda 6Eh (110) Dodatna informacija o zadanom danu; 39. Komanda 6Fh (111) Izveštaj po artiklima; 40. Komanda 70h (112) Dobijanje informacija o operateru; 41. Komanda 71h (113) Dobijanje broja poslednjeg odštampanog dokumenta; 42. Komanda 72h (114) Podaci o dnevnom fiskalnom izveštaju ili fiskalnom periodu.

Page 18: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 18 od 29

TEKST VARCHAR(100) Sadržaj ovog polja je definisan u opisu Prostora za podatke navedenih komandi u Korisničkom uputstvu fiskalnog printera FP550-Plus. Molimo Vas da detaljno proučite ove informacije kao i da se upoznate sa principima funkcionisanja svih navedenih komandi protokola. Od ove sintakse jedino se odstupa u dva slučaja:

1. Kod komande 30h (48) Otvaranje fiskalnog isečka postoji odstupanje. Očekivani prostor za podatke sadrži i vrednost IBSA. Sertifikovani drajver će preuzeti vrednost ovog parametra iz kriptovanog licencnog fajla i omogućiti izvršenje ove komande.

2. Kod komande 34h (52) Registrovanje prodaje i prikazivanje na displeju. Ova komanda ima tri oblika:

a. 52,”Sadržaj_parametara_komande$Naziv_artikla$Poreska_grupa”

Primer: 52,”S00001*10$Hleb$E”, Parametri u okviru navodnika predstavljaju sledeće: Prodaje se artikal PLU=2, 10 komada, naziv artikla je Hleb i poreska grupa E. Program najpre proverava da li ovaj artikal postoji u fiskalnom štampaču, sa identičnim nazivom i poreskom stopom i ako ima izvršiće komandu prodaje, a ukoliko postoje razlike vratiće poruku da se razlikuje naziv artikla ili poreska grupa. Postoji sinhronizacija baze artikala sa bazom artikala u fiskalnom štampaču. Takođe, omogućeno je storniranje prodatih stavki ovom komandom sa sledećim parametrima:

b. 52,”VF” – stornira se prodati artikal u prvoj stavci isečka c. 52,”VL” – stornira se prodati artikal u poslednjoj stavci isečka

Primeri za LLP_nnn.CSV: Sadržaj Komanda 33, Brisanje displeja 35,”Prikaz teksta” Prikaz teksta na donjem redu displeja 48,"1,0000,1" Otvaranje fiskalnog isecka 52,”S00001*10$Hleb$E” Prodaja artikla PLU=1, 10 komada 53,"P100" Primljeno 100KM 56, Zatvaranje fiskalnog isečka

Page 19: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 19 od 29

Tabele - LINK export (za FisLINK)

Svi numeričke podaci tipa NUMERIC(NN,n) unose se u polje kao NNNNN.NN tj. sa decimalnom tačkom (bez obzira na regional settings). Atributi obeleženi kao »NOT NULL« su obavezni.

Tabela ZA - Detalji prodaje Tabela PRODAJA predstavlja pojedinačno prodate artikle, u okviru jednog Zetovanja ZET_ID (zatvaranja fiskalnog dana), jednog prodajnog mesta TRM_ID.

ZET_ID VARCHAR(6) NOT NULL TRM_ID VARCHAR(3) NOT NULL DTM_TRAN VARCHAR(25) NOT NULL DTM_ZET VARCHAR(25) BON_ID INTEGER USR_ID VARCHAR(4) ART_ID VARCHAR(10) TAX_ID VARCHAR(1) PLU_NAZIV VARCHAR(40) KOLICINA NUMERIC(10,3) CENA NUMERIC(10,2) IZNOS NUMERIC(10,2) PRC_POPUST NUMERIC(10,2) IND_STORNO VARCHAR(1) FP_COMMAND VARCHAR(50) OPIS ATRIBUTA: ZET_ID VARCHAR(6) NOT NULL,

Jedinstveni broj ZET-ovanja.

TRM_ID VARCHAR(3) NOT NULL, Jedinstvena šifra terminala tj. EPoS radnog mesta.

DTM_TRAN VARCHAR(25) NOT NULL, Datum i vreme transakcije, kada se desila prodaja. Napomena: Svaki slog u jednoj datoteci ZA ima različiti DTM_TRAN.

DTM_ZET VARCHAR(25) Datum i vreme zetovanja, kada je dan zatvoren. Napomena: Svi slogovi u jednoj datoteci ZA imaju isti DTM_ZET.

BON_ID INTEGER Broj računa, fiskalnog isečka.

Page 20: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 20 od 29

USR_ID VARCHAR(4) Šifra korisnika sistema, kasira.

ART_ID VARCHAR(20) Šifra artikla u BackOffice-u.

TAX_ID VARCHAR(1) Šifra poreske grupe (od A do Z)

PLU_NAZIV VARCHAR(40) Naziv artikla koju koristi printer do max. 32 znaka.

KOLICINA NUMERIC(10,3) Količina prodatog artikla.

CENA NUMERIC(10,2) Cena sa porezom (PDV) prodatog artikla.

IZNOS NUMERIC(10,2) Iznos prodaje artikla. (Količina * cena).

PRC_POPUST NUMERIC(10,2) Procenat popusta u stavci. Napomena: Svi slogovi u jednoj BON_ID imaju isti PRC_POPUST, jer je popust tj. promena cene dozvoljena samo na nivou celog bona.

IND_STORNO VARCHAR(1) Indikator da li je stavka stornirana. Napomena: Storno stavke neće biti prikazane u okviru ZA datoteke. Ali postoji posebna komanda kojom se mogu dobiti sve storno stavke, radi analize.

FP_COMMAND VARCHAR(50) Za internu upotrebu.

File Puni naziv = ZATrmSeq_GGGG-MM-DD.DAT Trm broj terminala, EPoS Seq broj dokumenta GGGG-MM-DD Godina-mesec-dan

Page 21: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 21 od 29

Tabela ZB - Detalji plaćanja Tabela plaćanja predstavlja pojedinačno plaćanje svakog bona, u okviru jednog Zetovanja ZET_ID (zatvaranja fiskalnog dana), jednog prodajnog mesta TRM_ID.

ZET_ID VARCHAR(6) NOT NULL TRM_ID VARCHAR(3) NOT NULL DTM_TRAN VARCHAR(25) NOT NULL DTM_ZET VARCHAR(25) BON_ID INTEGER USR_ID VARCHAR(4) IZNOS NUMERIC(10,2) KUSUR NUMERIC(10,2) PAY_1 NUMERIC(10,2) PAY_2 NUMERIC(10,2) PAY_3 NUMERIC(10,2) PAY_4 NUMERIC(10,2) PAY_5 NUMERIC(10,2) PAY_6 NUMERIC(10,2) CARD_ID VARCHAR(20) ITEMS_NO INTEGER IND_POPUST VARCHAR(1) IND_STORNO VARCHAR(1)

OPIS ATRIBUTA: ZET_ID VARCHAR(6) NOT NULL

Jedinstveni broj ZET-ovanja.

TRM_ID VARCHAR(3) NOT NULL Jedinstvena šifra terminala tj. EPoS radnog mesta..

DTM_TRAN VARCHAR(25) NOT NULL Datum i vreme transakcije, naplate bona.

DTM_ZET VARCHAR(25) Datum i vreme zetovanja. Napomena: Svi slogovi u jednoj datoteci ZB imaju isti DTM_ZET.

BON_IZNOS NUMERIC(10,2) Numerička vrednost iznosa bona.

USR_ID VARCHAR(4) NOT NULL Šifra korisnika sistema, kasira.

BON_ID INTEGER Numerička oznaka bona.

IZNOS NUMERIC(10,2) Numerički iznos plaćeno.

KUSUR NUMERIC(10,2) Numerički kusur.

PAY_1 NUMERIC(10,2) Iznos plaćanja u vrsti plaćanja broj 1

Page 22: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 22 od 29

PAY_2 NUMERIC(10,2)

Iznos plaćanja u vrsti plaćanja broj 2

PAY_3 NUMERIC(10,2) Iznos plaćanja u vrsti plaćanja broj 3

PAY_4 NUMERIC(10,2) Iznos plaćanja u vrsti plaćanja broj 4, (koristi se samo u CG).

PAY_5 NUMERIC(10,2) Iznos plaćanja u vrsti plaćanja broj 5, za buduću upotrebu

PAY_6 NUMERIC(10,2) Iznos plaćanja u vrsti plaćanja broj 6, za buduću upotrebu

CARD_ID VARCHAR(20)

ITEMS_NO INTEGER Ukupni broj stavki u bonu.

IND_POPUST VARCHAR(1) Da li je u bonu bilo popusta na nekoj od stavki.

IND_STORNO VARCHAR(1) Da li je u bonu bilo storno stavki.

File Puni naziv = ZBTrmSeq_GGGG-MM-DD.DAT Trm broj terminala EPoS Seq broj dokumenta GGGG-MM-DD Godina-mesec-dan

Page 23: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 23 od 29

Tabela ZC - Detalji Zatvaranja Tabela ZATVARANJA DANA predstavlja jedan slog, u okviru jednog Zetovanja ZET_ID (zatvaranja fiskalnog dana), jednog prodajnog mesta TRM_ID. ZET_ID VARCHAR(6) NOT NULL TRM_ID VARCHAR(3) NOT NULL DTM_TRAN VARCHAR(25) END_BON_ID INTEGER BR_BONOVA INTEGER BR_STAVKI INTEGER FP_IZNOS NUMERIC(10,2) DB_KUSUR NUMERIC(10,2) DB_PAY1 NUMERIC(10,2) DB_PAY2 NUMERIC(10,2) DB_PAY3 NUMERIC(10,2) DB_PAY4 NUMERIC(10,2) DB_PAY5 NUMERIC(10,2) DB_PAY6 NUMERIC(10,2) FP_VAT0 NUMERIC(10,2) FP_VAT1 NUMERIC(10,2) FP_VAT2 NUMERIC(10,2) FP_VAT3 NUMERIC(10,2) FP_VAT4 NUMERIC(10,2) FP_VAT5 NUMERIC(10,2) FP_VAT6 NUMERIC(10,2) FP_VAT7 NUMERIC(10,2) FP_VAT8 NUMERIC(10,2)

OPIS ATRIBUTA:

Tabela ZR - Račun Original Tabela ZR je identična tabeli ZA samo što sadrži podatke za jedan fiskalni isečak.

OPIS ATRIBUTA:

File Puni naziv = ZCTrmSeq_GGGG-MM-DD.DAT Trm broj terminala EPoS Seq broj dokumenta GGGG-MM-DD Godina-mesec-dan

File Puni naziv = ZRTrmBrRacunaGGGG-MM-DD.DAT Trm broj terminala EPoS BrRacun broj računa iz Baze GGGG-MM-DD Godina-mesec-dan

Page 24: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 24 od 29

Podaci koji se vraćaju

Program FisLINK kao odgovor na svaku primljenu datoteku, programu koji je poslao (Vašem programu) šalje OBAVEZNO odgovor (u redu - OK, nije u redu - ERR).

U vezi ABC - Artikli, Bon, Komande Vaš program šalje datoteku kompletan bon - račun sa svim podacima (o artiklima, prodaji, plaćanjima i komande) sa jedinstvenim nazivom ABC_nnn.(CSV, DBF, TXT, XML), a po formatu (ABC_nnn.DAT). Vidi poglavlje: Tabele – LINK import. Program Fis - LINK prihvata ABC_nnn.DAT, vrši logičku proveru stavki i Akcija Ako je u redu Ako nije u redu Šalje nove artikle u FP Šalje promene cena u FP Šalje podatke u FP U /TO_FP briše datoteku U /FROM_FP vraća ABC_nnnn.OK ABC_nnnn.ERR Sadržaji datoteka ABC_nnn.OK i/ili ABC_nnn.ERR su tekstualni podaci. Program vraća datoteku ABC_nnn.OK ako je sve u redu, a datoteku ABC_nnn.ERR ako je bilo grešaka. U samoj datoteci ABC_nnn.ERR je tekstualni opis greške. Sadržak datoteke ABC_nnn.OK je Broj fiskalnog isečka, «Iznos fiskalnog isečka« primer: 001500,1020.50

Napomena: Jednom poslat bon koji je prošao kroz fiskalni modul i koji je odštampan na fiskalnom štampaču, NE MOŽE SE nikako naknadno stornirati.

Page 25: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 25 od 29

U vezi REK – Reklamiranje prometa Program FisLINK prihvata REK_nnn.DAT, vrši logičku proveru stavki i Akcija Ako je u redu Ako nije u redu Šalje podatke u FP U /TO_FP briše datoteku U /FROM_FP vraća REK_nnnn.OK REK_nnnn.ERR Sadržaji datoteka REK_nnn.OK i/ili REK _nnn.ERR su tekstualni podaci. Program vraća datoteku REK_nnn.OK ako je sve u redu, a datoteku REK _nnn.ERR ako je bilo grešaka. U samoj datoteci REK_nnn.ERR je tekstualni opis greške.

U vezi CMD - Komandni tekst Vaš program šalje datoteku: CMD_00000.(CSV, DBF, TXT, XML). a po formatu (CMD_nnn.DAT). Vidi poglavlje: Tabele – LINK import. Akcija Ako je u redu Ako nije u redu Čita komande po redu Izvršava komande po redu U /TO_FP Briše datoteku Briše datoteku U /FROM_FP vraća CMD_nnn.OK CMD_nnn.ERR Sadržaji datoteka .OK i ili .ERR su tekstualni podaci. Program vraća datoteku CMD_nnn.OK ako je sve u redu, a datoteku CMD_nnn.ERR ako je bilo grešaka. U samoj datoteci CMD_nnn.ERR je tekstualni opis greške.

U vezi COMM.ERR – Prekid komunikacije Ukoliko pri obradi ABC_nnn.DAT, CMD_nnn.DAT, dođe do prekida komunikacije sa FP550-Plus(prekid napajanja, prekid na kablu display-a, ...), odmah po konstatovanju prekida, program vraća file COMM_nnn.ERR u kome je tekst moguće greške. Nakon toga program FisLINK se automatski gasi – prekida. Preporučujemo da po prijemu poruke COMM.ERR obavestite kasira i prekinete rad sa vašim »KASA« programom. Nakon ponovnog startovanja FisLINK, program će nastaviti sa obradom primljenih file-ova i poslati odgovor (.ERR ili .OK).

Page 26: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 26 od 29

U vezi LLP - Komandni mod Vaš program šalje datoteku: LLP_nnn.CSV. Vidi poglavlje: Tabele – LINK import. Akcija Ako je u redu Ako nije u redu Izvršava komandu U /TO_FP Briše datoteku Briše datoteku U /FROM_FP vraća LLP_nnn.OK LLP_nnn.OK Program uvek vraća LLP_nnn.OK koji sadrži: 12 povratnih bajtova statusa printera, tekst koji sadrži Odgovor iz opisa komande. Primeri LLP_nnn.OK odgovora: AABBCCDDEEFF,”odgovor od fiskalnog štampača”

Page 27: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 27 od 29

Prilozi

A. Inicijalno punjenje artikala

Za total Faza total total total za 1000 PLU No min' min' HH min min

0

Prvih 7.500 7.500 14 14 0 14 1,9 sledećih 7.500 15.000 24 38 0 38 3,2 sledećih 7.500 22.500 32 70 1 10 4,3 sledećih 7.500 30.000 40 110 1 50 5,3 sledećih 7.500 37.500 48 158 2 38 6,4 sledećih 7.500 45.000 57 215 3 35 7,6 sledećih 7.500 52.500 66 281 4 41 8,8 sledećih 7.500 60.000 76 357 5 57 10,1 sledećih 7.500 67.500 87 444 7 24 11,6 lzadnjih 6.600 74.100 91 535 8 55 13,7

Promena cene 7.500 8 1,6

Brisanje 7.500 4 0,5 Brisanje 15.000 7 0,5 Brisanje 30.000 14 0,5 Brisanje 45.000 21 0,5 Brisanje 60.000 28 0,5 brisanje 65.000 30 0,5

Page 28: Uputstvo Za Programere Galeb

FisPLUS V1.0.0 – Sertifikovani program interfejs FisLINK, FisCOMMAND – Uputstvo za programere

fisplus_pg_v1.0.0 strana 28 od 29

B. Tabela za konverziju YUSCII u WIN1251

Dec Hex Asc Ћир

64 40 @ Ж

65 41 A А

66 42 B Б

67 43 C Ц

68 44 D Д

69 45 E Е

70 46 F Ф

71 47 G Г

72 48 H Х

73 49 I И

74 4A J Ј

75 4B K К

76 4C L Л

77 4D M М

78 4E N Н

79 4F O О

80 50 P П

81 51 Q Љ

82 52 R Р

83 53 S С

84 54 T Т

85 55 U У

86 56 V В

87 57 W Њ

88 58 X Џ

89 59 Y

90 5A Z З

91 5B [ Ш

92 5C \ Ђ

93 5D ] Ћ

94 5E ^ Ч

95 5F _

Dec Hex Asc Ћир

96 60 ` ж

97 61 a а

98 63 B б

99 63 c ц

100 64 d д

101 65 e e

102 66 f ф

103 67 g г

104 68 h х

105 69 i и

106 6A j ј

107 6B k к

108 6C l л

109 6D m м

110 6E n н

111 6F o о

112 70 p п

113 71 q љ

114 72 r р

115 73 s с

116 74 t т

117 75 u У

118 76 v в

119 77 w њ

120 78 x џ

121 79 y

122 7A z з

123 7B { ш

124 7C | ђ

125 7D } ћ

126 7E ~ ч

Page 29: Uputstvo Za Programere Galeb