Fiskala Agent

Uvod

Fiskala je Windows servis koji automatski obrađuje F-LINK ME fajlove računa (.inp) i šalje ih na vaš OFS fiskalni uređaj za registraciju. Fiskala prati folder na vašem računaru i kad se pojavi novi fajl sa računom, automatski ga obrađuje i komunicira sa fiskalnim uređajem.

Šta agent radi?

• Prati folder za nove fajlove računa
• Čita F-LINK ME format (.inp fajlovi)
• Šalje račune na OFS fiskalni uređaj putem mreže
• Arhivira uspješne račune
• Snima neuspješne račune u folder grešaka sa detaljima
• Automatski se licencira preko portala za probni period od 30 dana
• Podržava offline režim kada internet nije dostupan

Sistemski Zahtjevi

Hardverski zahtjevi

• Procesor: Intel Pentium 4 ili noviji (32-bit ili 64-bit)
• RAM: 512 MB minimum, 1 GB preporučeno
• Disk: 50 MB za program + prostor za arhivu računa
• Mreža: LAN konekcija do OFS fiskalnog uređaja

Softverski zahtjevi

Operativni sistem:

• Windows 10 (32-bit ili 64-bit)
• Windows 11 (64-bit)
• Windows Server 2016 ili noviji
• Windows 7 SP1 ili noviji (sa ažuriranjima)

Mrežni pristup:

• Pristup OFS fiskalnom uređaju na lokalnoj mreži
• Standardni port: 3566
• Internet pristup za licenciranje (opciono za offline režim)

Instalacija

Korak 1: Preuzimanje softvera

1. Preuzmite odgovarajući izvršni fajl za vaš operativni sistem:
   • Windows 64-bit: fiskala-windows-amd64.exe
   • Windows 32-bit: fiskala-windows-386.exe
2. Kreirajte folder za program (preporučena lokacija: C:\FISKALA\)
3. Premjestite preuzeti fajl u kreirani folder i preimenujte ga u fiskala.exe

Konfiguracija

Pri prvom pokretanju, Fiskala agent će automatski kreirati prazan konfiguracioni fajl config.ini u istom folderu kao fiskala.exe. Ovaj fajl morate popuniti sa podacima vašeg okruženja.

Korak 2: Popunjavanje konfiguracije

Nakon što se kreira prazan config.ini, otvorite ga u text editoru i popunite sljedeće sekcije:

[Paths] - Putanje do foldera

[Paths]
WatchDir=C:\FISKALA\Inbox
ArchiveDir=C:\FISKALA\Archive
ErrorDir=C:\FISKALA\Error
ProcessingDir=C:\FISKALA\Processing

[API] - OFS konekcija

[API]
Endpoint=http://192.168.1.101:3566/api/invoices
BearerToken=your_bearer_token_here
PINCode=1234
Timeout=30
RetryAttempts=3
RetryDelay=1

[License] - Licenciranje (automatsko)

[License]
LicenseFile=./license.lic

Parametri Konfiguracije

Ova sekcija detaljno objašnjava sve parametre konfiguracije, posebno fokusirajući se na razliku između testnog i produkcijskog režima rada. Razumijevanje ovih parametara je ključno za pravilnu konfiguraciju agenta.

[Test] - Kontrola testnog režima

Ova sekcija kontroliše da li je agent u testnom ili produkcijskom režimu. Testni režim vam omogućava da testirate sistem bez uticaja na fiskalne izvještaje.

[Test]
# Testni režim - kontroliše tip računa koji se šalje
TestMode=yes    # DEFAULT: yes (šalje Training račune)
                # Postavite na "no" za produkciju (šalje Normal račune)

# Dry run režim - prikazuje curl komande bez API poziva
DryRun=no       # DEFAULT: no (normalan rad)
                # Postavite na "yes" za debugging bez slanja na API

TestMode - Šta radi?

DryRun - Šta radi?

DryRun je potpuno različit od TestMode. DryRun kontroliše da li agent uopšte poziva API.

[Invoice] - Postavke računa

Ova sekcija definiše podrazumijevane vrijednosti za sve račune koje agent šalje. Većina ovih vrijednosti se može overrideovati iz INP fajla.

[Invoice]
# Tip računa (vidi OFS API dokumentaciju)
InvoiceType=Training  # Training | Normal | Proforma | Copy | Advance

# Tip transakcije
TransactionType=Sale  # Sale (prodaja) | Refund (refundacija/reklamacija)

# Podrazumijevani tip plaćanja
# Vrijednosti: Cash (gotovina) | Card (kartica) | Check (ček) | WireTransfer (prenos) | Voucher (vaučer) | MobileMoney (instant) | Other (drugo)
PaymentType=Cash

# Podrazumijevani kasir (prikazuje se na računu)
DefaultCashier=Prodavac 1

# Podrazumijevani ID kupca (opciono)
DefaultBuyerID=

# Prefiks broja računa za refunde (KRITIČNO!)
InvoiceNumberPrefix=ABC12XYZ-ABC12XYZ-

InvoiceType - Tipovi računa

Kontroliše koji tip računa se šalje na OFS API. Napomena: Kada je TestMode=yes, agent automatski postavlja InvoiceType=Training bez obzira na ovu postavku.

TransactionType - Tip transakcije

Određuje da li je transakcija prodaja ili refund (reklamacija).

InvoiceNumberPrefix - Prefiks broja računa (KRITIČNO za refunde!)

Ovaj parametar je kritičan za obradu refunda (reklamacija). Kada agent detektuje refund iz INP fajla, mora znati pun format broja računa koji koristi vaš POS terminal kako bi pronašao originalni račun.

Prelazak na Produkciju - Checklist

Kada ste spremni za produkciju, slijedite ovu listu:

Primjer Produkcijske Konfiguracije

Evo kompletnog primjera config.ini fajla za produkciju:

; Fiskala Produkcijska Konfiguracija

[Paths]
WatchDir=C:\FISKALA\Inbox
ArchiveDir=C:\FISKALA\Archive
ErrorDir=C:\FISKALA\Error
ProcessingDir=C:\FISKALA\Processing

[API]
Endpoint=http://192.168.1.101:3566/api/invoices
BearerToken=your_bearer_token_here
PINCode=1234
Timeout=30
RetryAttempts=3
RetryDelay=1

[Invoice]
; PRODUKCIJA - Normal računi
InvoiceType=Normal
TransactionType=Sale
PaymentType=Cash
DefaultCashier=Prodavac 1
DefaultBuyerID=
; KRITIČNO: Vaš POS prefiks (provjerite sa fiskala.exe status)
InvoiceNumberPrefix=ABC12XYZ-ABC12XYZ-

[Test]
; PRODUKCIJA - Testni režim ISKLJUČEN
TestMode=no
DryRun=no

[Logging]
Level=INFO
FilePath=C:\FISKALA\Logs\agent.log
MaxSize=10
MaxBackups=30
Console=yes

[Service]
ProcessOnStartup=yes
PollInterval=60
MaxConcurrent=1
FileEncoding=UTF-8

[TaxLabels]
; Poreske grupe - koristite Ćirilicu!
1=А  ; Nije u PDV 0%
2=Е  ; PDV 17%
4=К  ; Bez PDV 0% (export)

[TaxRates]
; Poreske stope za veleprodaju (B2B)
; Za veleprodaju cijene NE uključuju porez - agent automatski dodaje
; Za maloprodaju cijene VEĆ uključuju porez
1=0.00   ; А - Nije u PDV 0%
2=0.17   ; Е - PDV 17%
4=0.00   ; К - Bez PDV 0% (export)

[CharacterMapping]
; Mapiranje ASCII karaktera u specijalne znakove
; F-LINK ME koristi ASCII zamjene za srpske/hrvatske znakove
{=Š  ; Lijeva vitičasta → Š
}=Ž  ; Desna vitičasta → Ž
[=Č  ; Lijeva uglasta → Č
]=Ć  ; Desna uglasta → Ć
\=Đ  ; Backslash → Đ
~=Č  ; Tilda → Č

[Receipt]
SaveImage=yes
SaveText=yes
ImageDir=C:\FISKALA\Images
ImageFormat=Png

[License]
PortalURL=https://fiskala.com
Token=
LicenseFile=./license.lic

Testiranje

Nakon podešavanja konfiguracije, testirajte vezu sa OFS uređajem:

cd C:\FISKALA
fiskala.exe test

Pokretanje kao Windows Servis

Instalirajte Fiskala kao Windows servis koji automatski počinje sa računarom:

# Pokrenite Command Prompt kao Administrator
cd C:\FISKALA
fiskala.exe install
fiskala.exe start

# Provjera statusa
sc query Fiskala

Svakodnevni Rad

Nakon što je servis pokrenut, Fiskala automatski:

• Prati WatchDir folder za nove .inp fajlove
• Obrađuje svaki račun i šalje ga na OFS uređaj
• Arhivira uspješne račune u ArchiveDir
• Snima neuspješne račune u ErrorDir sa detaljima greške
• Vodi log u agent.log
• Šalje telemetriju (ako je omogućena) radi bolje podrške

Rješavanje Problema

Servis se ne pokreće

1. Provjerite da li ste pokrenuli Command Prompt kao Administrator
2. Provjerite da li config.ini postoji
3. Provjerite logove u agent.log

Greška pri slanju računa

• Provjerite IP adresu i port OFS uređaja
• Provjerite Bearer Token
• Provjerite mrežnu konekciju (ping na OFS uređaj)
• Provjerite firewall postavke

Problemi sa licencom

• Provjerite da li imate internet pristup (za prvu aktivaciju)
• Ako nemate internet, isključite telemetriju (Enabled=no)
• Provjerite da li je licenca istekla u admin portalu

Često Postavljana Pitanja

Podrška

Za dodatnu pomoć kontaktirajte: