## Šta radi

HAFiskal modul za WHMCS (dodatak „HAFiskal fiskalizacija“) automatski izdaje fiskalni račun za svaku plaćenu WHMCS fakturu.

- Kada faktura pređe u status **Paid**, modul je šalje HAFiskalu, a HAFiskal izdaje fiskalni račun preko procesora Poreske uprave.
- Fiskalni račun (broj, QR kod, tekst računa i link za proveru) čuva se uz fakturu. Vidi se u WHMCS adminu, u klijentskoj zoni i u mejlu kupcu.
- Kada se faktura vrati (Refunded), modul može sam da stornira fiskalni račun.
- Ako fiskalizacija ne uspe, modul sam pokušava ponovo. Dupli račun ne može da nastane.
- Po želji šalje **eFakture na SEF** pravnim licima i nudi plaćanje **IPS QR kodom**.

Važi za verziju modula **2.0.5**.

## Šta je potrebno u HAFiskalu

1. Dodatak **WHMCS integracija** i modul **HAFiskal API** u paketu firme. Za eFakture je potreban i modul **eFakture**, a za IPS plaćanje dodatak **IPS naplata**.
2. Nova integracija tipa **WHMCS** u delu **Integracije (API)**, sa API ključem. Ključ se prikazuje **samo jednom**, zato ga odmah kopirajte (vidite i članak „Integracije: API ključ, webhookovi i log fiskalizacije“).
3. Poreske stope koje koristite u WHMCS-u (npr. 20%) moraju postojati i u HAFiskalu. Za strane kupce potrebna je i stopa 0% („Oslobođeno PDV-a“).

Modul (zip fajl) dobijate od podrške: podrska@hafiskal.rs.

## Instalacija

1. Zip raspakujte u glavni folder WHMCS-a, preko postojećih fajlova. Isto važi i za svaku nadogradnju.
2. U WHMCS adminu otvorite **System Settings → Addon Modules**, nađite **HAFiskal fiskalizacija** i kliknite **Activate**.
3. Kliknite **Configure** i popunite:
   - **HAFiskal API URL:** https://api.hafiskal.rs (već je upisano);
   - **API ključ:** ključ iz HAFiskala.
4. U delu **Access Control** označite uloge koje smeju da koriste modul i kliknite **Save Changes**.
5. Otvorite **Addons → HAFiskal fiskalizacija → Podešavanja** i kliknite **Testiraj vezu**. Ako je sve u redu, vidite naziv firme i spisak poslovnih prostora.

## Prvo podešavanje (obavezno)

### Datum početka fiskalizacije

Na vrhu taba **Podešavanja** upišite datum od kada se fiskalizuje. Faktura plaćena pre tog datuma **nikad** se ne fiskalizuje, ni automatski ni ručno.

Opcija **Blokiraj fiskalizaciju zaostalih računa** je podrazumevano **Da**. Tada modul šalje samo nove uplate od datuma početka i ponavlja neuspele pokušaje.

### Načini plaćanja

Svaki način plaćanja iz WHMCS-a povežite sa načinom plaćanja na fiskalnom računu: **Prenos na račun**, **Platna kartica**, **IPS plaćanje (instant)** ili **Gotovina**.

Faktura plaćena načinom plaćanja koji nije povezan **se ne fiskalizuje**, a na svim karticama modula stoji crveno upozorenje. Čim ga povežete, modul sam šalje fakture koje su čekale.

Na fiskalni račun ide stvarna uplata. Ako je faktura plaćena iz dva dela, na računu su dva plaćanja. Deo plaćen kreditom sa naloga klijenta ide kao način plaćanja izabran u Configure → **Način plaćanja za kredit**.

### Opcije

U tabu **Podešavanja → Opcije** birate Da/Ne za:

- **Automatska fiskalizacija:** račun se izdaje čim faktura postane plaćena.
- **Pošalji fiskalni račun emailom:** kupac dobija mejl „HAFiskal Fiskalni Racun“.
- **Prikaži fiskalni račun u klijentskoj zoni:** račun stoji ispod stavki fakture.
- **Automatski storno:** kada fakturu označite kao Refunded, fiskalni račun se stornira.
- **Automatski ponovni pokušaji:** WHMCS cron ponavlja neuspele fiskalizacije.
- **Test PDV 10%:** samo za testiranje sa Poreskom. U radu mora biti **Ne**.

Kliknite **Sačuvaj opcije**. Izbor odavde ima prednost nad istim poljima u Configure.

## Kupci: pravna i fizička lica

U tabu **Pravna / fizička lica** birate koje polje klijenta u WHMCS-u označava pravno lice i da li pravno lice prima eFakture. Ako takva polja nemate, kliknite **Napravi podrazumevana polja**. Modul pravi polja „Tip lica“ (Fizičko lice / Pravno lice) i „eFaktura“ (Ne / Da).

Podrazumevana pravila:

- **fizičko lice:** dobija fiskalni račun;
- **pravno lice bez eFakture:** dobija fiskalni račun, a na računu je kupac sa PIB-om;
- **pravno lice sa eFakturom:** ne dobija fiskalni račun, nego eFakturu.

Faktura koja po pravilu ne dobija fiskalni račun ima status „preskočeno“ i razlog. Ako je ipak potreban, kliknite **Ipak fiskalizuj** na fakturi.

Pravno lice bez ispravnog PIB-a (9 cifara) dobija račun bez kupca, a u pregledu fakture stoji upozorenje.

## Strane valute

Fiskalni račun se uvek izdaje **u dinarima**. U tabu **Valute i kurs** za svaku stranu valutu birate:

- **ručni kurs** (1 jedinica = X dinara), ili
- **srednji kurs NBS na dan plaćanja** (automatski).

Valuta bez kursa = faktura se **ne fiskalizuje**. Kada unesete kurs, fakture koje su čekale šalju se same. Korišćeni kurs se vidi na računu, npr. „10,00 USD × 117,5 = 1.175,00 RSD“.

## Strani kupci (van Srbije)

Strani kupac je klijent čija država na profilu nije Srbija. Prazna država znači domaći kupac.

- Strani kupac dobija na svim stavkama oznaku **G** (0%, oslobođeno PDV-a). Iznos na računu je ono što je stvarno platio.
- Posle fiskalnog dela računa ide tekst o mestu prometa usluge van Srbije (posebno za pravno, a posebno za fizičko lice). Tekst menjate u tabu **Valute i kurs → Strani kupci (van Srbije)**.
- Poreska pravila u WHMCS-u (Setup → Payments → Tax Configuration) podesite samo za Srbiju.

Pravilo o PDV-u za strane kupce proverite sa knjigovođom.

## Gde se vidi fiskalni račun

- **WHMCS admin:** na fakturi je dugme **HAFiskal** sa statusom, brojem računa i akcijama:
  - Fiskalizuj ponovo;
  - Osveži iz HAFiskala;
  - Pošalji klijentu;
  - Storniraj.
- **Klijentska zona:** račun sa QR kodom i linkom „Proveri račun na sajtu Poreske uprave“, odmah ispod stavki fakture.
- **Mejl kupcu:** šablon „HAFiskal Fiskalni Racun“ (menja se u Setup → Email Templates). Fiskalni račun možete ubaciti i u postojeće WHMCS mejlove za fakture, preko polja za mejl šablone koja počinju sa „hafiskal_“ (npr. polje za ceo račun sa QR kodom).
- **HAFiskal panel:** Fiskalizacija → Poslednji računi i Integracije (API) → Log fiskalizacije.

## Ponovni pokušaji

WHMCS cron (obično na 5 minuta) sam ponavlja plaćene fakture koje nisu fiskalizovane. Pauze između pokušaja su 5, 10, 20, 40, 60 minuta i duže, najviše 10 puta (oko jedan dan). Pre svakog pokušaja HAFiskal proverava kod Poreske da račun nije već izdat.

Ako Poreska odbije sadržaj (npr. pogrešna poreska stopa), ispravite uzrok pa kliknite **Fiskalizuj ponovo** na fakturi.

## eFaktura (SEF)

Tab **eFaktura (SEF)** radi samo ako firma u HAFiskalu ima modul **eFakture**. Bez njega na fakturi stoji dugme „eFaktura – proširi licencu“.

U Configure upišite SEF API ključeve (demo i produkcija) i izaberite:

- **Aktivno okruženje:** demo ili produkcija;
- **Automatski okidač:** samo ručno, pri kreiranju fakture ili pri plaćanju;
- **Obračun PDV-a:** bez PDV-a, stopa iz WHMCS-a ili fiksna stopa;
- **Slanje u CIR:** automatski za korisnike javnih sredstava (JBKJS).

## IPS QR plaćanje

Kupac fakturu plaća skeniranjem QR koda u aplikaciji svoje banke. Plaćanje ide preko HAFiskal servera, pa u WHMCS-u ne upisujete podatke banke.

1. U HAFiskalu firma mora imati dodatak **IPS naplata** i podešen Payten (IPS QR Naplata).
2. U WHMCS-u otvorite **Setup → Payments → Payment Gateways**, nađite **IPS QR plaćanje (HAFiskal)** i kliknite **Activate**.
3. Preporučeno: u HAFiskalu, u delu **Integracije (API) → Webhook**, dodajte adresu sa kartice **Podešavanja → IPS QR plaćanje (HAFiskal)** u modulu i izaberite događaje za uspešnu i neuspelu uplatu. Prikazanu tajnu upišite u Configure → **IPS webhook tajna**. Bez toga plaćanje i dalje radi, samo se uplata potvrđuje proverom statusa.

Na fakturi je dugme **Plati IPS QR kodom**. QR važi oko 3 minuta, a posle isteka kupac klikne **Generiši novi QR**. Kada banka potvrdi uplatu, faktura se sama označi kao plaćena, a fiskalni račun ide sa načinom plaćanja „Instant plaćanje“.

## Česti problemi

- **Faktura se ne fiskalizuje:** proverite redom:
  - da li je način plaćanja povezan;
  - da li strana valuta ima kurs;
  - da li je faktura plaćena posle datuma početka fiskalizacije;
  - da li je kupac po pravilu „preskočen“.

  Razlog piše u dugmetu HAFiskal na fakturi.
- **Kupac ne vidi račun u klijentskoj zoni:** u Podešavanja → Opcije uključite „Prikaži fiskalni račun u klijentskoj zoni“. U dugmetu HAFiskal na fakturi piše da li je prikaz uključen i zašto se račun ne vidi.
- **Testiraj vezu javlja grešku:** proverite API URL (bez „/v1“ i „/api“ na kraju) i da je ključ prepisan ceo. Ako ste pravili novi ključ u HAFiskalu, upišite novi.
- **Crveno upozorenje „obrišite folder starog modula“:** posle prelaska sa verzije pre 2.0 obrišite stari folder modula. Dok on postoji, modul ne fiskalizuje (zaštita od duplog računa). Za pomoć se javite podršci.

Svi pozivi prema HAFiskalu vide se u WHMCS-u: **Utilities → Logs → Module Log** (modul „hafiskal“). API ključ je tamo sakriven.