Baza znanja
Pretražite članke ili izaberite neku od kategorija ispod.
Pregled po temama
Uputstva, vodiči i odgovori organizovani po kategorijama.
Akcitvacija naloga
Aktivacija naloga i izbor paketa
Prijava korisnika
Podešavanje poslovnog prostora
Podešavanje ESIR-a
Artikli
Cene
Poreske stope
Izdavanje računa
Avansni račun
Promet-prodaja
Refundacija
Kopija računa
QR kod
Elektronski račun
Štampanje
Pregled računa
Greške
Rad bez štampača / elektronska dostava
API
Detaljna objasnjenja upotrebe našeg api servisa za korisnike koji sami razvijaju aplikacije a koriste naš API za fiskalizaciju i efakture.
Panel
Vodič kroz HAFiscal panel: meni, početna strana, kupci, magacin, izvodi, izveštaji, paket i korisnici.
Popularni članci
Šta drugi korisnici trenutno čitaju.
Shopify integracija
Kada povežete Shopify prodavnicu, HAFiskal sam izdaje fiskalni račun za svaku plaćenu narudžbinu. Za povraćaj novca sam radi storno i izdaje nov račun. Ne morate ništa da prekucavate. Šta vam treba - Modul za API fiskalizaciju u vašem paketu (vidi Moj paket i Moji računi). Shopify nema poseban modul ni cenu. - Podešenu kasu, odnosno sertifikat i PAK (vidi Povezivanje kase sa PFR). - Valutu prodavnice RSD. Narudžbine u drugoj valuti se ne fiskalizuju. - Ulogu vlasnika ili administratora u HAFiskal-u. 1. Povežite prodavnicu 1. U HAFiskal panelu otvorite Integracije (API) i karticu Shopify. 2. Upišite adresu prodavnice, na primer moja-prodavnica.myshopify.com, i kliknite Poveži. 3. Otvara se Shopify. Odobrite aplikaciju HAFiskal. 4. Vraćate se u panel sa porukom da je prodavnica povezana. Na kartici prodavnice proverite oznake: Povezano, Licenca aktivna i Webhookovi registrovani. Ako neka oznaka nije zelena, kliknite Webhookovi i polja kupca. Jedna Shopify prodavnica može biti povezana samo sa jednom firmom. 2. Povežite načine plaćanja (obavezno) Za svaki način plaćanja iz Shopify-a izaberite kako se vodi na računu: Platna kartica, Prenos na račun, IPS (instant plaćanje) ili Gotovina / pouzeće. Sistem predlaže izbor, a predlog prihvatate klikom na (primeni). Na kraju kliknite Sačuvaj podešavanja. Važno: - Spisak načina plaćanja se pojavljuje tek posle prve plaćene narudžbine. Ta narudžbina čeka sa statusom Nemapirano plaćanje dok ne sačuvate izbor, a zatim se fiskalizuje sama. - Narudžbina sa nepovezanim načinom plaćanja se ne fiskalizuje. - Poklon kartica nema predlog, pa je povežite ručno ako je koristite. 3. Ostala podešavanja Na istoj kartici možete da podesite: | Podešavanje | Podrazumevano | |---|---| | Fiskalni račun za pravno lice / za fizičko lice | Da / Da | | Pouzeće fiskalizuj tek kad je isporučeno | Da | | Pošalji fiskalni račun kupcu mejlom | Da | | Upiši firmu, PIB i MB u polja kupca u Shopify adminu | Da | | Preskoči test narudžbine | Da | | PDV stopa za stavke bez Shopify poreza | 20% | | Poslovna lokacija | podrazumevana lokacija firme | Kada se izdaje račun - Kad je narudžbina plaćena u celosti. Delimično plaćena narudžbina čeka. - Za pouzeće se račun izdaje kad označite da je narudžbina isporučena, ako je to podešavanje uključeno. - Na računu su svi proizvodi, a dostava je posebna stavka. Popusti se prikazuju kao popust na stavkama. - Otkazane narudžbine, test narudžbine i narudžbine od 0 dinara se preskaču. - Isti račun se nikad ne izdaje dvaput. Gde se vidi račun - Fiskalizacija → Poslednji računi: tu je svaki izdat račun, kao i računi sa kase. Odatle ga štampate, šaljete mejlom ili pravite kopiju (vidi Pregled izdatih fiskalnih računa). - Integracije (API) → Log fiskalizacije: poslednji pokušaji fiskalizacije iz svih integracija, i uspešni i neuspešni. - U Shopify-u, na narudžbini: dobija oznaku fiskalizovano, a broj računa i link za proveru su upisani u podatke narudžbine. - Kupac dobija račun mejlom, u PDF prilogu, ako je to podešavanje uključeno. Mejl ide sa vaše adrese ako ste podesili slanje mejlova (vidi Slanje mejlova (SMTP) i izgled mejla). Na kartici Shopify, u tabeli Narudžbine, vidite stanje svake narudžbine (npr. Fiskalizovano, Nemapirano plaćanje, Ponovni pokušaj) i poruku ako nešto nije u redu. Povraćaj novca Kad u Shopify-u vratite novac: - ceo iznos: račun se stornira; - deo iznosa: ceo račun se stornira i odmah se izdaje nov račun za ono što kupac zadržava. Više povraćaja na istoj narudžbini obrađuje se redom. Ako je vraćena i dostava, ona ne ide na nov račun. Storno i nov račun se vide u Poslednji računi, a stanje povraćaja u tabeli Refundacije na kartici Shopify. Kupac posle povraćaja za sada ne dobija mejlom storno ni nov račun. Podaci firme kupca (PIB i matični broj) Kupac koji kupuje kao firma može sam da unese naziv firme, PIB i matični broj, i tada račun glasi na firmu. Na korpi (svi Shopify planovi): 1. U Shopify-u otvorite Online Store → Themes → Customize i stranicu korpe. 2. Kliknite Add block → Apps i izaberite blok HAfiscal - podaci. 3. Kupac bira Fizičko lice ili Pravno lice. Za pravno lice unosi Naziv firme, PIB i Matični broj. PIB i matični broj se proveravaju odmah. Dok podaci nisu ispravni, kupac ne može da pređe na plaćanje; to se može isključiti u podešavanjima bloka. Na stranici za plaćanje (samo Shopify Plus): ista polja dodajete u Settings → Checkout → Customize. U editoru dozvolite aplikaciji da zaustavi plaćanje kad podaci nisu ispravni. Brza dugmad za plaćanje (Shop Pay, Apple Pay i slično) preskaču korpu. Za takve narudžbine se koriste podaci firme sačuvani u profilu kupca, ako postoje, a inače se račun izdaje bez podataka kupca. Podatke firme kupca vidite u Shopify adminu, u profilu kupca. Kupci ih ne vide javno. Ako račun nije izdat Razlog vidite u Log fiskalizacije i na kartici Shopify, u tabeli Narudžbine, u koloni Poruka. U Shopify-u narudžbina dobija oznaku fiskalizacija-greska. - Ako fiskalni servis nije dostupan, sistem sam pokušava ponovo, do 10 puta, sa sve dužim pauzama. - Ako je potrebna vaša provera, ispravite razlog i kliknite Fiskalizuj ponovo. - Za povraćaje postoji dugme Ponovi. Ako modul za API fiskalizaciju nije u paketu, narudžbine čekaju i fiskalizuju se same čim se modul aktivira. Šta za sada nije podržano - Prodaja poklon kartica, napojnice, carine i dodatne naknade. Takve narudžbine traže ručnu obradu. - Prikaz računa na stranici statusa narudžbine i u nalogu kupca. - eFaktura za Shopify narudžbine. Prekid veze Na kartici prodavnice kliknite Prekini vezu. Zatim obrišite aplikaciju i u Shopify adminu, u Settings → Apps. Već izdati računi ostaju sačuvani u HAFiskal-u.
Elektronski računeFakture (SEF): podešavanje i slanje
HAFiskal šalje vaše fakture na Sistem elektronskih faktura (SEF). Potreban je modul eFakture (SEF). 1. Podešavanje U Podešavanja → eFakture (SEF): Podešavanja, tab eFakture (SEF) 1. Na SEF portalu, u Podešavanja → Upravljanje API, generišite API ključ. 2. Nalepite ga u polje API ključ. 3. Izaberite Okruženje: Demo ili Produkcija. Izbor se čuva odmah. Ključevi za demo i produkciju su različiti, pa ključ mora odgovarati okruženju. 4. Kliknite Sačuvaj ključ. Opcija Kada kupac prihvati ponudu, automatski je pretvori u fakturu i pošalji na SEF šalje fakturu na SEF čim kupac prihvati ponudu preko linka. Radi samo za kupce kojima je označeno Ima eFakture. Opciju čuvate dugmetom Sačuvaj u tom delu. 2. Slanje fakture Na strani fakture kliknite Pošalji na SEF. Dugme se vidi kada faktura ima broj, odnosno kada je poslata. Pre slanja proverite: - da je u Podešavanja → Firma unet tekući račun firme; - da kupac ima ispravan PIB (9 cifara) ili JMBG (13 cifara). Ako nešto nedostaje, dobićete poruku šta treba dopuniti. Jedna faktura se šalje samo jednom. Ponovo se može poslati samo ako ju je SEF odbio. 3. Status na SEF-u Na strani fakture, u delu Status na SEF-u: | Status | Značenje | |---|---| | Nije poslato | Faktura još nije slata | | Poslata | SEF je primio fakturu | | Odobrena | Kupac je prihvatio | | Odbijena | Kupac ili SEF je odbio; razlog je ispisan crvenom bojom | | Otkazana | Otkazana na SEF-u | Osveži status preuzima trenutni status sa SEF-a. Prikazuje se i SEF broj fakture. Meni eFakture Pregled eFaktura U meniju eFakture je pregled po tabovima Izlazne, Ulazne, Čekaju odluku i Odbijene. Slanje i ostale radnje se rade sa strane fakture. Preuzimanje ulaznih faktura sa SEF-a još nije povezano, pa tabovi Ulazne i Čekaju odluku za sada ne prikazuju vaše stvarne ulazne fakture.
Podešavanje poslovnog prostoraSlanje mejlova (SMTP) i izgled mejla
HAFiskal mejlom šalje ponude, fakture, otpremnice i fiskalne račune. Podešavanje je u Podešavanja → Email (SMTP). Podešavanja, tab Email (SMTP) SMTP podešavanja Ako SMTP ne podesite, mejlovi idu preko sistemskog naloga. Da bi išli sa vaše adrese, npr. prodaja@vasafirma.rs, unesite podatke od vašeg email provajdera: | Polje | Primer | |---|---| | SMTP server (host) | mail.vasafirma.rs | | Port | 587, ili 465 uz SSL | | Koristi SSL | Uključite za port 465 | | Korisničko ime i Lozinka | Podaci naloga sa kog se šalje | | „Šalje“ adresa (From) | prodaja@vasafirma.rs | Kliknite Sačuvaj SMTP podešavanja. Kada kasnije menjate podešavanja, polje lozinke ostavite prazno i postojeća lozinka ostaje sačuvana. Izgled email-a Birate izgled mejla za ponude i fakture: - Prost tekst (podrazumevano); - Dizajn 1 ili Dizajn 2: HTML mejl sa QR kodom za plaćanje fakture, odnosno za prihvatanje ponude. Izbor se čuva čim kliknete na karticu. Kada slanje ne uspe Ako ručno slanje ne uspe, pojaviće se poruka da slanje nije uspelo. Proverite SMTP podatke, a pre svega lozinku i port. Proverite i da li kupac ima unetu email adresu. Automatski mejlovi, npr. posle prihvatanja ponude, ne prekidaju radnju ako slanje ne uspe.
Pregled računaPregled izdatih fiskalnih računa
Svi fiskalni računi su u Fiskalizacija → Poslednji računi. Spisak izdatih fiskalnih računa Filteri - Period: Danas (podrazumevano), Ovog meseca ili Od - do. - Status: Svi, Nacrt ili Fiskalizovani. Izbor „Svi“ ne prikazuje nacrte, odnosno započete račune koji nisu naplaćeni. Njih vidite ako izaberete Nacrt. - Broj redova na strani: 10, 20, 30, 40 ili Prikaži sve. Statusi | Status | Značenje | |---|---| | Nacrt | Račun je započet, a nije naplaćen | | Čeka uplatu | Uplata nije u celosti evidentirana | | Spreman za fiskalizaciju | Naplaćen, čeka slanje | | Fiskalizovano | Račun je izdat | | Neuspela fiskalizacija | Slanje nije uspelo. Otvorite račun na kasi i pokušajte ponovo | | Stornirano | Za račun je izdata refundacija | | Otkazano | Otkazan pre fiskalizacije | Akcije | Ikona | Akcija | |---|---| | Štampač | Prikaz računa, štampa kopije i slanje mejlom (vidi Kopija fiskalnog računa) | | Strelica unazad | Storno fiskalizovanog računa (vidi Storno (refundacija) fiskalnog računa) | | Novčanica | Zatvaranje avansa konačnim računom (samo za avansne račune) | Storniran račun ostaje u spisku, sa statusom Stornirano. Račune izdate preko API-ja, npr. iz web prodavnice, pratite i u Integracije (API) → Log fiskalizacije.
APIIntegracije: API ključ, webhookovi i log fiskalizacije
Meni Integracije (API) služi za povezivanje spoljnih sistema, kao što su WooCommerce, WHMCS, Shopify, POS ili vaš ERP, koji preko API-ja izdaju fiskalne račune. Tehnička uputstva za programere su u portalu API dokumentacija našeg centra za pomoć. Integracije i API ključevi Integracija i API ključ 1. Kliknite Nova integracija. 2. Unesite Naziv (npr. „WooCommerce - web prodavnica“) i izaberite Tip. 3. Opciono izaberite Poslovnu lokaciju. Tada sistem koji šalje račune ne mora da je navodi u svakom zahtevu. 4. Kliknite Sačuvaj. Forma za novu integraciju Zatim u kartici integracije kliknite Novi ključ. Ključ ima oblik fk_live_... i prikazuje se samo jednom. Kopirajte ga odmah i unesite u sistem koji povezujete. Ako ga izgubite, napravite nov. Pravila: - Firma može imati samo jedan aktivan API ključ, u svim integracijama zajedno. - Rotiraj (kružna strelica) opoziva stari ključ i odmah izdaje nov. - Opozovi (kanta) gasi ključ. Sistem koji ga koristi odmah prestaje da radi. - Opozvan ključ se može trajno obrisati. - Deaktiviraj gasi celu integraciju. Webhookovi Tab Webhookovi Webhook obaveštava vaš sistem kada se promeni stanje računa ili IPS plaćanja, pa taj sistem ne mora sam da proverava. Kliknite Novo webhook odredište, unesite URL i izaberite događaje: fiskalizacija uspela, fiskalizacija neuspela, dokument otkazan, dokument storniran, IPS plaćanje uspelo, IPS plaćanje neuspelo. Tajni ključ (whsec_...) se prikazuje samo jednom. Koristi se za proveru potpisa u zaglavlju X-HAfiscal-Signature. Firma može imati jedan aktivan webhook. Ako isporuka ne uspe, HAFiskal pokušava ponovo. Isporuka se pokušava najviše 8 puta ukupno, u razmacima do dva sata. Log fiskalizacije Tab Log fiskalizacije Poslednjih 10 pokušaja fiskalizacije preko API-ja: vreme, integracija, broj narudžbine (External ID), iznos, status i fiskalni broj, ili poruka greške. Log se osvežava sam na 15 sekundi. Koristan je kada proveravate da li web prodavnica ispravno šalje račune. Mrežni uređaji Tab Mrežni uređaji prikazuje POS uređaje sa promenljivom IP adresom koji se javljaju preko API-ja. Uređaj koji se ne javi 30 minuta dobija status Neaktivan.
GreškeČeste greške pri fiskalizaciji i radu u panelu
Najčešće poruke o grešci u HAFiskal panelu, šta znače i kako da ih rešite. Fiskalizacija | Poruka ili simptom | Uzrok | Rešenje | |---|---|---| | Na kasi piše Sertifikat nije podešen | Nije unet sertifikat ili PAK kod | Otpremite ZIP arhivu i PDF potvrdu u Podešavanja → Fiskalizacija (PFR) | | Na kasi piše Servis nije dostupan | Podešavanja su uneta, ali fiskalni servis ne odgovara | Proverite internet vezu i pokušajte ponovo; ako traje, javite se podršci | | „Fiskalizacija nije podešena - unesite PFX sertifikat i PAK/PAC kod u Podešavanjima.“ | Isto kao „Sertifikat nije podešen“ | Kao iznad | | mac verify failure | PAK ili lozinka ne odgovaraju tačno tom sertifikatu | Otpremite ZIP i PDF koji su izdati zajedno (vidi Povezivanje kase sa PFR) | | „Fiskalizacija za ‚Обука/Копија/Предрачун‘ još nije implementirana“ | Izabrana je vrsta računa koja se još ne podržava | Na kasi u „Врста рачуна“ izaberite Промет | | Račun ima status Neuspela fiskalizacija | Slanje nije uspelo; razlog je u poruci | Otklonite uzrok i pokušajte ponovo. Račun se ne izdaje dva puta | | „Storno nije uspeo: ...“ | Refundacija nije prošla | Račun ostaje fiskalizovan; otklonite uzrok i ponovite storno | Fakture i ponude | Poruka | Rešenje | |---|---| | „Dokument u statusu ... se više ne može menjati.“ | Menja se samo nacrt. Poslat dokument stornirajte i napravite nov | | „Dokument u statusu ... se ne može obrisati - storniraj ga umesto toga.“ | Dokument sa uplatom ili prihvaćena ponuda se ne briše, nego stornira | | „Iznos mora biti veći od nule“ | Uneti iznos (cena artikla ili iznos uplate) je 0; unesite iznos veći od nule | | „Kupac nema unetu email adresu.“ | Unesite email kod kupca ili ga upišite pri slanju | | „Slanje nije uspelo. Proverite da li je email servis podešen...“ | Proverite Podešavanja → Email (SMTP) | eFakture (SEF) | Poruka | Rešenje | |---|---| | „SEF API ključ nije podešen...“ | Unesite ključ u Podešavanja → eFakture (SEF) | | „Tekući račun firme nije unet...“ | Unesite tekući račun u Podešavanja → Firma | | „Kupac mora imati unet ispravan PIB (9 cifara) ili JMBG (13 cifara)...“ | Ispravite podatke kupca | | „Ova faktura je već poslata na SEF.“ | Faktura se šalje jednom; ponovo samo ako je odbijena | Nalog i paket | Poruka ili simptom | Rešenje | |---|---| | Stavka menija ne postoji | Modul nije u paketu; dodajte ga u Moj paket | | „Modul ... je onemogućen u Vašem paketu...“ | Isto kao iznad | | Dostignut limit korisnika ili magacina | Kliknite Aktiviraj dodatno mesto ili Aktiviraj dodatni magacin i platite ponudu | | „Korisnik sa ovim emailom već postoji u sistemu...“ | Za novog korisnika koristite drugu email adresu | | „Nalog firme je privremeno suspendovan.“ | Javite se podršci |