WHMCS integracija: fiskalizacija, eFaktura i IPS plaćanje

A

Aleksandar

Poslednja izmena Nov 6, 2026

Š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.