Postavke POS client-a

Ispod su naborjeni i opisani svi parametri programa E-racuni POS Client, s kojima možemo utjecat na djelovanje programa, nastavimo komunikaciju sa strojnom opremom (POS printer, POS prikazivač), odredimo i oblikujemo parametre ispisa te sam ispis POS računa i još mnogo toga.

[Database Access] - povezivanje s bazom podataka

• ServerType - s ovim parametrom odredimo vrstu baze podatka, s kojom će naš program raditi. Najčešće se koriste sljedeće baze podataka:

• Database - s tim parametrom odredimo put i ime baze podatka
• Ako imamo nastavljeno tip podatkovne baze SQLite, onda je ta vrijednost put i ime datoteke, gdje su podaci spremljeni (primjer: Database=c:\Program Files (x86)\ITC e-racuni POS\obracuni_pos.db)
• Ako imamo nastavljeno tip podatkovne baze PostgreSQL, onda je vrijednost parametra IP adresa PostgreSQL poslužitelja te ime podatkovne baze (primer: Database=127.0.0.1/obracuni_pos)

• User - korisničko ime za prijavu na poslužitelj podatkovne baze

• Password - lozinka za prijavu na poslužitelj podatkovne baze

[pos] - komunikacija s poslužiteljem E-racuni.com

• serverUrl - URL naslov poslužitelja E-računi.com. Primjer: https://eurofaktura.com:9002/

• serverAppPrefix - prefiks poslužitelja E-računi.com. Primjer: /obracuni/

[printer] - postavke printera i ispisa

• type - s tim parametrom izaberemo tip printera kojeg koristimo

*[1] Kod ispisa, jer je parametar printera "type" jednaka vrijednosti "PQ_OPTIPOS_RP58" ili "PQ_CUSTOM", određivanje parametra "port" nije potrebno. Umjesto toga je potrebno odrediti parametar "printerName"

• port - oređivanje serijskih/paralelnih vrata računala na koje je povezan printer

• printerName - ime printera, kako je zapisano u sistemskim postavkama printera (Upravljačka ploča->Uređaji i pisači). Vrijednost toga parametra se koristi samo u primjeru, kad je parametar type jednak PQ_OPTIPOS_RP58 ili PQ_CUSTOM (ispis u redu za ispis).

• typeCustomInitialization - početna inicializacija printera, koje se izvede prije ispisa. To je niz bytova po standardu ESC/POS tj. Starline (za printere Star Micronics), zapisanih u dekadskom formatu, odvojenih sa zarezom. Parameter se upotrebljava, kada je parametar type jednak vrijednosti PQ_OPTIPOS_RP58, CUSTOM ili PQ_CUSTOM. Pod početnu inicializaciju možemo smatrati naredbe, kao što su inicializacija printera i pražnjenje predmemroije printera, postavke niza znakova, tabele kodova,...

• typeCustomEndDocumentInitialization - završna inicializacija printera, koja se izvodi na kraju ispisa. To je niz bytova po standardu ESC/POS tj. Starline (za printere Star Micronics), zapisanih u dekadskom formatu, odvojenih sa zarezom. Parameter se upotrebljava, kada je parameter type jednak vrijednosti PQ_OPTIPOS_RP58, CUSTOM ili PQ_CUSTOM. Pod završnu inicializaciju možemo smatrati naredbe , kao što su rezanje računa, otvaranje kase,...

• typeCustomMagnifiedFont - postavke povečane veličine fonta na ispisu. Upiše se niz bytova po standardu ESC/POS tj. Starline (za printere Star Micronics), zapisanih u dekadskom formatu, odvojenih sa zarezom. Parameter se upotrebljava, kada je parameter type jednak vrijednosti PQ_OPTIPOS_RP58, CUSTOM ili PQ_CUSTOM.

• typeCustomNormalFont - postavke normalne veličine fonta na ispisu. Upiše se niz bytova po standardu ESC/POS tj. Starline (za printere Star Micronics), zapisanih u dekadskom formatu, odvojenih sa zarezom. Parameter se upotrebljava, kada je parameter type jednak vrijednosti PQ_OPTIPOS_RP58, CUSTOM ili PQ_CUSTOM.

• customLineSize - postavke proizvoljnog broja znakova kod normalne veličine fonta u jednom retku.

• printoutDelayForBufferRelease - postavke kašnjenja između pojedinačnih segmenta računa (glava računa, stavke, noga računa). Upiše se brojčana vrijednost i predstavlja vrijeme u milisekundama. Funkcija je upotrebljiva u primjeru, kad printerov međuspreminik prebrzo prima podatke i dođe do "buffer overflow-a" - račun se ne ispiše u cjelosti. U tom primjeru koristimo taj parametar, da damo printeru dodatno vrijeme, da ispiše podatke u međuspremniku.

Parameter se ne koristi, jer je type nastavljen kao PQ_OPTIPOS_RP58, CUSTOM ili PQ_CUSTOM - printeri toga tipa ispisuju u red za ispis i ne komuniciraju direktno s printerom preko vrata.

• typeCustomConversionMap - postavke konverzije znakova (č,ć,š,ž,đ,dž). Upotrebljivo za starije tipove printera, koji ne podupiru tabele kodova sa č,ć,š,ž,đ,dž - na taj način sprječimo ispis neželjenih znakova i č,ć,š,ž,đ,dž zamjenimo sa c,z,s,d,dz. Vrijednost parametra može biti:

• customExtraLinesBeforeCut - dodatni prazni redovi na kraju računa. Parameter upotrijebimo u primjer, kada printer ne ostavlja dovoljno praznoga papia tj. odreže ga prenisko. Vrijednost je brojčana i predstavlja broj praznih redaka, dodanih na dnu računa.

• typeCustomBaudRate - s tim parametrom možemo odrediti brzinu prijenosa podataka (baud rate). Vrijednost je brojčana i vrijednost mora odgovarati standardu komunikacije sa serijskimi vratima (4800,9600,....). Taj parametar podržava samo printer tipa "CUSTOM" i "TMU300A".

• typeCustomBarcode - ispis grafike bar koda broja računa u nogi računa. Vrijednost je niz ESC/POS tj. Starline sekvence, kako je određeno u dokumentaciji o printeru. Podatak je niz bytova u dekadskom formatu, odvojenih sa zarezom. Prethodno je potrebno provjeriti da li printer podržava ispis grfike bar koda.

• emulation - za printer je potrebno izabrati emulaciju za ispis QR koda za provjeru fiskalizacije

• fiscalBarcodeType - pored izabrane emulacije, potrebno je i izabrati tip QR koda za ispis:

[display] - postavke POS prikazivača

• type - odaberemo vrstu prikazivača kojeg upotrebljavamo. Vrijenost parametra može biti:

• port - postavke serijskih vrata (COM), preko kojih komuniciramo s prikazivačem. Vrijednost može biti broj (npr: port=1 - označuje vrata COM1).

Parametar nije potreban za prikazivače tipa "POSIFLEX_PD2300", koji se koristi za prikazivač, priklopljen na USB vrata.

[application] - postavke ispisa i druge sistemske postavke

• invoicePrinterType - postavke oblika računa. Vrijednost može biti:
• SIMPLE
• COMPLEX
• COMPLEX2
• COMPLEX3

Ispod su primjeri oblika pojedinih vrsta računa za 44 znaka/redak:

• SIMPLE:

  	Slika 1: Primjer računa SIMPLE

• COMPLEX:

  	Slika 2: Primjer računa COMPLEX

• COMPLEX2:

  	Slika 3: Primjer računa COMPLEX2

• COMPLEX3:

  	Slika 4: Primjer računa COMPLEX3

• printSoftwareID - ispis oznake programske opreme u nogi računa. Vrijednost može biti:

• showStockQuantitiesInInvoice - prikaz zalihe artikla na popisu stavki kod kreiranja računa. Pri uključivanju te opcije se s poslužitelja E-racuni.com prenesu dodatni podaci o zalihi, zbog toga sinkronizacija s poslužiteljem može potrajati malo duže. Vrijednost parametra može biti:

• filterPositiveStock - ograničenje prikaza artikala prema stanju zaliha:

• POSInvoicePrintDateWithoutTime - Ispis datuma izdavanja dokumenta bez vremena u glavi računa. Vrijednost parametra može biti:

• PrintPOSinvoiceHeaderWithoutMandantData - S tim parametrom uključimo/isključimo ispis podataka o mandantu u glavi računa, kako je postavljeno u postavkama o tvrtki. Ukoliko si stranka oblikuje svoj tekst u postavkama ispisa, upotrijebimo taj parametar kako bi izbjegli ispis dvojnih podataka (podaci o mandantu) u glavi računa. Vrijednosti mogu biti:

Ukoliko u postavkama tiskanja u izborniku "Glava dokumenta" nema upisanih podataka o tvrtki, postavke parametra "PrintPOSinvoiceHeaderWithoutMandantData" se ignoriraju te se ispisuju podaci o tvrtki, kako je nastavljeno u podacima o tvrtki!

• BarCodeType - Tu se nastavlja vrsta bar koda, koja se upotrebljava pri očitavanju s čitačem bar koda. Ovdje se misli na artikle, koji također imaju u bar kodu artikla kodiranu količinu pakiranja (automatske tehnice,....). Trenutno podržana vrijednost je EAN13.

• POSInvoicePrintInvoiceRemark - Ovdje određujemo ispis napomena, koje smo upisali u postavkama ispisa/tekst ispod. Vrijednosti parametra može biti:

• POSInvoicePrintBuyerAdditionalName - S ovim parametrom nastavljamo ispis parametra "Kupac dodatno", koji je upisan na računu. Vrijednost parametra može biti:

• PrintBuyerPhoneAndEmail - Ispis telefonskog broja i e-mail adrese kupca na računu (ukoliko je to uneseno). Vrijednost parametra može biti:

• POSInvoicePrintPaymentType - Ispis načina plaćanja računa u glavi računa. Vrijednost parametra može biti:

• POSInvoicePrinterPaperCutterEnabled - Uključivanje/isključivanje noža printera za rezanje papira. Vrijednost može biti:

• canEditInvoiceItemPrice - Ovom postavkom zadajemo želimo li omogućiti izmjenu prodajne cijene u POS client-u

• openNewInvoiceDialogAfterIssuing - Uključivanje/isključivanje automatskog otvaranja maske za novi račun nakon izdavanja prethodnog. Vrijednost može biti:

• printCashbookBalanceInDailyTurnover - Uključivanje/isključivanje prikaza stanja blagajne na ispisu dnevnog utrška. Vrijednost može biti:

• defaultLanguage - Postavke jezika programa. Vrijednost je Croatian

• defaultCountryCode - Postavke lokalizacije. Vrijednost je HR

Rad s više blagajni, povezanim na jedno skladište

• distributedObjectsServerUrl - parametar sadržava IP adresu trenutnog računala i vrata, na kojem je instaliran program E-racuni POS Client (npr: http://192.168.0.101:8000)
• distributedObjectsClientIpRange - IP adresa tj. skupina adresa, s kojima se korisnik može prijaviti u POS Client program. Skupina se označuje sa znakom * (primjer: 192.168.0.* sadrži skupinu adresa, koje imaju prva 3 segmenta IP adrese jednake upisanoj)
• coordinatorServerUrl - parametar sadrži adresu računala, na kojem je pokrenuta glavna blagajna, koja vrši sinkronizaciju s poslužiteljem E-računi.com. Parametar se upisuje samo na pomoćnim blagajnama i ne na glavnoj blagajni. Primer: http://192.168.0.100:80/obracuni

U primjeru, kada imamo više blagajni, koje rade s jednim skladištem, koristimo podatkovnu bazu PostgreSQL, koja omogučava komunikaciju s protokolom TCP/IP, jer pomoćna blagajna komunicira s bazom podataka, koja je na drugom računalu (ServerType=PostgreSQL).

[paymentTerminal] - postavke terminala za plaćanje

Prije prve upotrebe je potrebno provjeriti u konfiguraciji terminala da li je DHCP uključen; nakon pokretanja terminala kada prvi put dobije IP adresu, ona se može isključiti (ukoliko se koristi u istoj mreži kao i računalo).

• type - tip terminala za plaćanje (MonriPayment)
• IP - IP adresa koju ispiše terminal pri pokretanju (npr. 192.168.2.78)
• terminalId - ID terminala (obično zapisan na terminalu ili dobiven od proizvođača; npr. 62350141)
• tcpPort - port za upotrebu (preuzeti port je 6666)

Reference na stran

• Instalacija programa POS client