еФискализатор 2022 - Упутство за инсталацију ЛПФРа и ЕСИР интеграцију

eФискализатор 2022
Упутство за инсталацију ЛПФРа и ЕСИР интеграцију
Верзија документа: 1.2

Датум последње промене: 08.02.2022
Аутор: ProudSourceIT доо
Садржај
1. Увод 3
2. Предуслови 3
3. Приказ решења 3
4. Инсталација 5
5. Иницијална конфигурација 6
5.1 Провера сертификата Пореске управе 8
5.2 Провера пореске картице 9
5.3 Провера лиценце 10
5.4 Подизање сервиса за фискализацију 11
5.5 Провера ЛПФР конфигурације 12
5.6 Синхронизација времена 13
5.7 Завршетак иницијализације 15
6. Статуси 16
7. Замена Безбедносног елемента (БЕ) 18
8. Комуникација са ЕСИРом 19
8.1 Статус 19
8.2 Фискализација рачуна 19
8.3 Журнал 21
8.4 Верификациони URL и QR код 22
8.5. Додатне API руте за комуникацију са ЛПФРом 23
9. Комуникација са СУФ веб сервисима 25
10. Грешке и упозорења 26
11. Лиценцирање 27
Привредно друштво за пружање услуга из области информационих технологија
1. Увод
еФискализатор 2022 је софтверски локални процесор фискалних рачуна

(ЛПФР), креиран у потпуности у складу са Новим законом о фискализацији и
Техничким захтевима Пореске Управе Републике Србије.
Компанија ProudSourceIT доо је основана од стране два универзитетска

професора 2015. године, са циљем да развија напредна решења потребна на
финансијским тржиштима. Од заначајнијих референци истичу се ИСО8583
процесор платних картица, системи електронског банкарства, блокчејн
систем за трговање на Forex берзи и друга.
У овом документу се налази детаљно упуство за инсталацију, подешавање и

пуштање у продукциони рад, намењено за техничаре који врше инсталацију
или интеграцију Л-ПФР-а са ЕСИР-ом.
2. Предуслови
еФискализатор 2022 подржава оперативни систем Microsoft Windows, од

верзије 7 и све наредне верзије.
Поред наведеног оперативног система, предуслов за функционисање јесте и

повезан читач паметних картица, у који је потребно ставити Безбедоносни
елемент (БЕ) добијен од Пореске Управе за конкретно продајно место.
Уколико је еФискализатор 2022 инсталиран на другом рачунару у односу на

рачунар на коме се извршава ЕСИР, потребно је обезбедити локалну мрежну
конекцију између наведена два рачунара. У случају инсталације на исти
рачунар на коме је инсталиран и ЕСИР, користи се локални мрежни
интерфејс (localhost).
3. Приказ решења
еФискализатор 2022 је апликација за Windows оперативни систем којом се

управља путем графичког корисничког интерфејса. Након покретања
апликације, појављује се икона у делу за нотификације Windows
оперативног система, и визуелно је приказан статус у коме се систем налази
(зелено светло ако је ЛПФР у потпуно оперативном стању, жуто ако постоје
одређена упозорења која захтевају пажњу корисника или црвено уколико
постоји неки проблем који је потребно отклонити за нормално
функционисање система).
proudSourceIT
Будимска 20, 11000 Београд, Србија
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
ПИБ: 109242618, Матични број: 21147940, Текући рачун: 160-441648-55
Email: office@proudsourceit.rs; Посетите: www.proudsourceit.rs
3
Слика 1. Пример иконице еФискализатор у делу за нотификације
Све опције система еФискализатор 2022 су доступне уз помоћ иконе у делу

за нотификације Windows оперативног система.
Десни клик на иконицу ће понудити основни мени система.
Слика 2. Основни мени система доступан на десни клик
Опција Иницијализуј покреће иницијализацију система еФискализатор 2022.
Опција Отвори отвара екран путем кога се може видети детаљан статус
система, као и иницирати потребне команде и подешавања од стране
оператера.
Опција Покрени поново гаси систем и поново га покреће у случају да је

дошло до неке блокаде у раду.
Опција Изађи гаси систем еФискализатор 2022.
Систем еФискализатор 2022 у себи садржи све компоненте неопходне за

функционисање ЛПФРа, фискализацију и ишчитавање од стране Пореске
управе, у складу са законом и техничким упутством.
Изложен је REST API који Електронски системи за издавање рачуна (ЕСИР)

користе за комуникацију са ЛПФРом. Сви подаци, као и пакети са
фискализованим рачунима, се чувају у локалној интегрисаној бази података
на трајној меморији рачунара, у фолдеру
C:\Users\<windowsuser>\AppData\Local\LPFR.Data, датотека lpfr.db.
Систем бележи важне акције и догађаје у систему и чува сваку грешку

хронолошки у локалном времену (датум, сат, минут) и те информације се
похрањују у дневним текстуалним датотекама, на трајној меморији
рачунара, у фолдеру C:\Users\<windowsuser>\AppData\Local\LPFR.Data\logs.
Логови се чувају најмање 30 дана.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
4
4. Инсталација
Инсталациони пакет се дистрибуира путем веб сајта произвођача или на

преносном медијуму (нпр УСБ диск), одакле се покреће инсталација на
рачунару на самом продајном месту.
Слика 3. Приказ инсталационог екрана апликације еФискализатор 2022
Корисник може одлучити хоће ли пречица за покретање програма бити

смештена на Десктоп рачунара (Слика 3). Програм ће свакако бити
придружен групи програма за аутоматско покретање приликом подизања
оперативног система.
Након клика на дугме Next, следећи корак захтева потврду покретања

инсталације (Слика 4) :
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
5
Слика 4. Други корак инсталације
Кликом на дугме Install, покреће се инсталација софтвера, која даље иде без
прекида. По успешној инсталацији, аутоматски се покреће ЛПФР и почиње
процедуру иницијализације.
eFiskalizator 2022 треба конфигурисати тако да се аутоматски покреће

приликом покретања оперативног система. Препорука је да се он покрене
пре него што се покрене ЕСИР.
Алтернативно, инсталација ће поставити икону на десктоп рачунара, одакле

се увек може мануелно покренути.
Слика 5. Изглед иконе на Desktop-у
5. Иницијална конфигурација
Предуслов за функционисање јесте повезан читач паметних картица, у који

је потребно ставити Безбедоносни елемент (БЕ) добијен од Пореске Управе
за конкретно продајно место.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
6
По успешној инсталацији, неопходно је извршити иницијалну конфигурацију
система.
Слика 6. Иницијализација ЛПФРа по корацима
eFiskalizator 2022 ће приликом покретања покренути процедуру

иницијализације (Слика 6), која обухвата следеће кораке:
1. Инсталација CA сертификата Пореске управе (потребан за
остваривање TLS конекције)
2. Провера доступности читача картица као и постојање картице
a. У случају детектовања више расположивих читача и картица ПУ,
понудиће кориснику могућност да изабере који ће се користити,
b. У случају првог покретања затражиће од корисника унос ПИНа
3. Провера валидне лиценце
a. У случају детектовања истекле лиценце, понудиће кориснику
могућност да унесе лиценцу мануелно
4. Подизање ЛПФР сервиса за фискализацију
a. У случају заузећа дефинисаног порта за комуникацију, понудиће
кориснику могућност промене порта
b. У случају детекције недоступности, упозориће корисника да
провери постојање правила у Firewall или антивирус софтверу
које блокира мрежну комуникацију ЛПФРа.
5. Добављање команди за иницијализацију путем позива ка ПУ
a. У случају недоступности, понудиће могућност мануелног
очитавања команди за иницијализацију са преносног медија
(УСБ диск)
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
7
6. Синхронизација времена
a. У случају детекције одступања локалног времена од времена
очитаног са дефинисаног НТП сервера већег од 3 минуте,
захтева од корисника усклађивање локалног времена. У случају
одступања већег од 1 минута даје упозорење кориснику.
b. У случају немогућности комуникације са дефинисаним НТП
сервером, ако је прошло више од 48 часова од последње
успешне провере, инструира корисника како да најлакше
провери усклађеност времена на рачунару.
У поступку иницијализације систем ће проћи кроз шест ставки и урадити

анализу потребних услова за функционисање система. У случају да систем
детектује неки недостатак за рад система покушаће аутоматским
процедурама да исправи недостатке. Тек уколикo аутоматске процедуре не
дају резултат систем ће за одговарајућу ставку понудити кориснику
алтернативу кроз мануелне процедуре.
Слика 7. Мануелни опоравак од недостатка услова за функционисање

система
На слици 7. Може се видети пример када корисник није убацио Безбедносни

Елемент у читач картица. Систем приказује поруку кориснику да убаци
картицу. По убацивању Безбедносног Елемента (картице) систем ће поново
проћи процедуру провере те ставке и уколико се утврди да су сви услови
задовољени наставља се са иницијализацијом.
5.1 Провера сертификата Пореске управе
Прва ставка провере приликом Иницијализације односи се на потребу да на

рачунару буду инсталирани сертификати Пореске управе за успостављање
сигурне конекције између система еФискализатор 2022 и сервера Пореске
управе.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
8
Систем ће прво проверити да ли су инсталирани сви потребни сертификати
Пореске управе. Уколико сертификати нису инсталирани на рачунару
еФискализатор ће покушати аутоматски да инсталира потребне сертификате.
За ово ће бити потребно да је апликација покренута у администраторском
режиму рада.
Уколико систем не успе да аутоматски инсталира потребне сертификате

обавестиће корисника да нису задовољени потребни услови и упутиће
корисника да ручно инсталира потребне сертификате.
По успешној инсталацији и провери сертфиката корисник је обавештен да је

прва ставка успешно завршена.
Слика 8. Успешно завршен корак провере сертификата Пореске управе
5.2 Провера пореске картице
Друга ставка провере приликом Иницијализације односи се на потребу да на

рачунару буде прикључен читач паметних картица и у њега убачен
безбедносни елемент (картица пореске управе) за то продајно место.
Систем првенствено детектује да ли је присутан читач картица а потом да ли

је убачен безбедносни елемент. Уколико било који од ових услова није
задовољен кориснику се приказује адекватна порука.
Уколико су читач и картица присутни систем приступа очитавању

сертификата са картице и подешавању атрибута продајног места на основу
очитаних информација. Уколико је у питању прво покретање система
кориснику ће бити приказан дијалог за унос ПИНа за активацију картице.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
9
Слика 9. Унос ПИНа за активацију Безбедносног Елемента
Корисник има 5 покушаја да унесе исправан ПИН на шта га систем

упозорава. По уносу исправног пина безбедносни елемент је активиран,
подаци су очитани и провера ставке је успешно завршена.
Слика 10. Успешно извршена провера пореске картице
5.3 Провера лиценце

Трећа ставка провере приликом Иницијализације односи се на лиценцу за
коришћење система.
Првенствено се путем Интернет конекције са сервиса произвођача повлачи
актуелна лиценца. За лиценцирање се користе информације очитане са
Безбедносног Елемента, Конкретно Порески Идентификациони Број (ПИБ) и
Јединствени Идентификатор (ЈИД). На основу тих информација кориснику се
издаје лиценцни код који се састоји од 4 поља по 5 карактера.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
10
Уколико Интернет веза није доступна проверава се присуство лиценце у
локалном складишту. Уколико је лиценца истекла корисник се усмерава на
ручни унос лиценце.
Слика 11. Ручна активација лиценце
У сваком од случајева провере уколико је остало 7 дана до истицања

лиценце систем упозорава корисника и преводи систем у стање наранџасто.
Уколико је лиценца истекла онемогућује се рад система еФискализатор 2022
и систем прелази у стање црвено.
5.4 Подизање сервиса за фискализацију
Четврта ставка приликом Иницијализације односи се на подизање сервиса за

фискализацију. Систем прво проверава да ли је сервис већ подигнут.
Уколико јесте систем сам себи шаље статусни упит и уколико добије
успешан одговор потврђује ставку.
Уколико сервис није подигнут систем подиже сервис или на иницијалном

порту (8058) или на порту који је раније конфигурисан. Уколико се сервис
успешно подигне, систем сам себи шаље статусни упит и уколико добије
успешан одговор потврђује ставку.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
11
Слика 12. Успешно подигнут сервис за фискализацију
Ради обезбеђивања минималног простора за рад, ЛПФР ће пре подизања

сервиса проверити да ли постоји минимално 100MB слободног простора на
хард диску.
Уколико из било ког разлога систем не успе да успостави сервис обавештава

корисника и даје му инструкције за ручни опоравак.
5.5 Провера ЛПФР конфигурације
Пета ставка приликом Иницијализације односи се на повлачење и проверу

ЛПФР конфигурације.
Да би еФискализатор 2022 радио у пуном капацитету потребно је да има

конфигурацију основних атрибута потребних за повезивање на сервисе
Пореске управе, потом за управљање пореским стопама као и за проверу
подешавања времена. Потребне информације стижу путем Интернета са
сервиса Пореске управе у облику команди које се извршавају на систему и
бележе се информације у локалном складишту.
Слика 13. Успешно конфигурисан ЛПФР
Уколико команде нису доступне кроз сервис Пореске управе систем ће

проверити да ли конфигурационе параметре има сачуване у локалном
складишту. Уколико ни једно ни друго није доступно систем ће зауставити
иницијализацију на тој ставци и омогућити кориснику дугме за ручни унос.
Корисник може преузети иницијализационе команде путем портала Пореске

управе и на овом месту покренути унос команди путем екстерне меморије
(УСБ или СД картице). Видети поглавље 6.3.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
12
Комуникациони параметри које ЛПФР користи за везу са СУФ веб сервисима
се искључиво подешавају путем команди или иницијалним очитавањем из
сертификата.
5.6 Синхронизација времена

Шеста ставка приликом Иницијализације односи се синхронизацију система
са поузданим извором времена.
еФискализатор 2022 на кључним тачкама и на редовне интервале ради

проверу синхронизованости времена.
Одступање од 1 до 3 минута - сервис поузданог времена доступан
Уколико систем детектује да постоји одступање рачунарског времена на

коме ради еФискализатор 2022 од поузданог времена са Интернета од једног
до три минута систем ће исказати упозорење кориснику, пренети систем у
наранџасти статус, приказати очитано време са Интернета и сугерисати
кориснику да подеси време на рачунару и потом покрене поновно
извршавање провере.
Слика 14. Одступање времена од једног до три минута
Одступање веће од 3 минута - сервис поузданог времена доступан
Уколико систем детектује да постоји одступање рачунарског времена на

коме ради еФискализатор 2022 од поузданог времена са Интернета више од
три минута систем ће блокирати рад, пренети систем у црвени статус,
приказати очитано време са Интернета и приморати корисника да подеси
време на рачунару и потом покрене поновно извршавање провере.
Слика 15. Одступање времена веће од три минута

proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
13
Последња успешна синхронизација пре више од 48ч - сервис поузданог

времена недоступан
Уколико је дуже од 48ч недоступан сервис поузданог времена и у

међувремену није било синхронизације систем ће блокирати рад, пренети
систем у црвени статус, и приказати кориснику дугме за ручну
синхронизацију времена.
Слика 16. Последња успешна синхронизација пре више од 48 časova
Корисник у овом случају може покушати да опорави Интернет

везу након чега ће притиснути дугме за поновну проверу.
Уколико није могуће опоравити Интернет конекцију корисник може урадити

процедуру за ручну потврду времена кликом на дугме Ручно подешавање.
Кориснику се отвара дијалог (Слика 17) у коме је понуђен линк за проверу
актуелног времена као и QR код чијим скенирањем са мобилног телефона
можемо приступити поузданом извору времена.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
14
Слика 17. Ручно подешавање времена
Корисник је потребно да на свом рачунару постави време у складу са

временом из поузданог извора, да потврди штиклирањем да је усагласио
време рачунара са временом из поузданог извора и потом коначно се
сагласи притиском на дугме Време на рачунару кориговано према
инструкцијама.
Након тога систем ће бити враћен у оперативно стање.
5.7 Завршетак иницијализације
Тек након успешно завршених свих корака иницијализације, ЛПФР прелази

из статуса није иницијализован (сиво, Слика 18) у статус у функцији
(зелено, Слика 19) или статус у функцији, постоје упозорења за корисника
(жуто, Слика 20) и омогућује иницирање фискализације рачуна.
Слика 18. ЛПФР није иницијализован
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
15
Слика 19. Изглед иконе на линији по успешној иницијализацији
Слика 20. Изглед иконе на линији по успешној иницијализацији при

постојању упозорења
У случају неуспешног једног или више корака у иницијализацији, иста се

прекида и ЛПФР прелази из статуса није иницијализован (сиво) у статус ван
функције (црвено). У том случају, корисник треба да разреши проблем који
је настао и да поново покрене иницијализацију или ресетује ЛПФР, десни
клик на икону и одабир опције Inicijalizuj или опције Pokreni ponovo (Слика
22).
Слика 21. Изглед иконе када иницијализација није успешна
Слика 22. Поновна иницијализација или покретање ЛПФРа
6. Статуси
eFiskalizator 2022 омогућује праћење статуса путем иконе у System Tray делу
радне траке (Слика 23), као и на главном статусном прозору апликације,
када се исти отвори.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
16
Слика 23. Статусна порука
Могући статуси су:

1. ЛПФР је у функцији (зелена боја, Слика 19)
2. ЛПФР је у функцији, постоје упозорења за корисника (жута боја,
Слика 20)
3. ЛПФР је ван функције (црвена боја, Слика 21)
4. ЛПФР није иницијализован (сива боја, Слика 18)
Статуси су кодирани бојама и прати их текстуални опис. Корисник увек може

видети детаље отварањем статусног екрана (дупли клик на икону, Слика 24)
или преласком курсора преко иконе (Слика 23).
У доњем делу статусног екрана приказани су Произвођач, Серијски број,

верзија софтвера, док су у секцији Информације приказани подаци очитани
са БЕ, и то ПИБ, ЈИД, Назив, адреса и општина продајног места.
Слика 24. Статусни прозор
Услови за увођење у одговарајуће стање су дати у наставку:

1. ЛПФР је у функцији (зелена боја)
a. Безбедоносни елемент активан, ПИН унет
b. Лиценца активна
c. Интернет конекција активна
d. Заузеће са нерегистрованим рачунима није веће од 75%
максималног дозвољеног заузећа
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
17
e. Прошло је мање од 3 дана од последњег успешног ишчитавања
f. Датум и време су синхронизовани у последњих 48 сати
2. ЛПФР је у функцији, постоје упозорења за корисника (жута боја)

a. ПИН није унет
b. Лиценца истиче за мање од 30 дана
c. Интернет конекција није активна
d. Заузеће са нерегистрованим рачунима је веће од 75%
e. Заузеће са нерегистрованим рачунима је веће од 90%
f. Прошло је више од 3 дана а мање од 5 дана од последњег
успешног ишчитавања
g. Прошло је више од 48 сати
h. d од последње провере синхронизације датума и времена
i. БЕ истиче сертификат за мање од 30 дана
3. ЛПФР је ван функције (црвена боја)

a. Читач картица није присутан
b. Безбедоносни елемент није присутан
c. Сертификат на Безбедоносном елементу је истекао
d. Безбедоносни елемент неисправан
e. Заузеће са нерегистрованим рачунима је дошло до максималног
дозвољеног заузећа
f. Прошло је више од 5 дана од последњег успешног ишчитавања
4. ЛПФР није иницијализован (сива боја)

a. Пореске стопе нису учитане
b. URL до СУФ система није учитан
c. NTP сервер није учитан
d. Иницијална лиценца није учитана
7. Замена Безбедносног елемента (БЕ)
Замена БЕ доводи до поновног ишчитавања свих података из сертификата

пореског обвезника са убачене БЕ, као и брисања меморисаног ПИНа.
По замени БЕ, ЛПФР ће проћи поново процедуру иницијализације, без

потребе за интервенцијом од стране корисника, осим уколико буде
детектован проблем током поновне иницијализације са новим БЕ.
Замена БЕ неће обуставити ишчитавање рачуна уколико је картица за исто

окружење. Уколико се убаци БЕ за друго окружење (тест или продукција)
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
18
ишчитавањеће бити на чекању док се поново не убаци БЕ за окружење за
које су пакети припремљени.
8. Комуникација са ЕСИРом
ЛПФР еФискализатор 2022 обезбеђује стандардни REST API интерфејс путем

кога ЕСИР комуницира. Интерфејс је реализован у потпуности према
техничком упутству, а према дефинисаном протоколу од стране Пореске
Управе. Пуна УРЛ адреса се може видети на статусном прозору (Слика 24).
Преглед подржаних активности следи у наредним поглављима.
8.1 Статус
ЕСИР може иницирати очитавање статуса и пратећих података путем

покретања статус команде, при чему ће одговор бити враћен у формату
дефинисаном у техничком упутству ПУ. Поред стандардних кодова статуса,
биће враћени и додатни кодови, дефинисани у поглављу 10.
8.2 Фискализација рачуна
ЛПФР фискализује рачуне у локалу, без потребе за активном Интернет

конекцијом. Фискализовани рачун се пре враћања одговора ЕСИРу смешта у
локалну базу података, одакле касније следи ишчитавање, удаљено или
локално.
ЛПФР прати статус картице и читача и у случају детектовања вађења

картице прелази у статус грешке, и враћа неки од кодова грешака, у
зависности од конкретног проблема. Уколико се ЛПФР налази у неком од
статуса грешке, одмах ће одбити захтев за фискализацијом. Такође, у
случају неуспешног потписивања од стране БЕ, ЛПФР ће одбити затев ЕСИРа
и вратити одговарајући код грешке, у складу са техничким упутством ПУ.
ЕСИР може креирати следеће типове рачуна: Промет, Аванс, Копија, Обука и
Предрачун. По иницирању захтева од стране ЕСИРа, извршиће се
иницијална провера структуре и прослеђених вредности за креирање рачуна
(обавезна поља, дужина и провера типа података). Биће извршена и
додатна провера датума и времена, тако да тренутно време не сме бити
мање од времена креирања претходног фискалног рачуна, потом провера да
RequestId није већ обрађен. На крају, биће проверен расположиви простор
на физичком меморијском медијуму (хард диск рачунара) и у случају
недостатка простора захтев за креирањем рачуна ће бити одбијен.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
19
Затим ће бити обрачунате пореске стопе за сваку ставку рачуна, у складу са
прослеђеним лабелама за сваки артикал и вредностима пореских стопа
добијеним од ПУ. Заокруживање добијених износа се врши на 4 децимале
методом HalfRoundUp. Уколико је БЕ доступан, као и ПИН у интерној
меморији, следи дигитално потписивање рачуна са тренутним датумом и
временом. Једном потписан рачун се шифрира AES-256 алгоритмом, уз
употребу једнократно генерисаног кључа, потом се кључ шифрира јавним
кључем ПУ очитаним из дигиталног сертификата са БЕ. Потом се тако
заштићени рачун и кључ спремају у пакет за ишчитавање који се чува у
локалној, интегрисаној бази података. Нити један пакет неће бити обрисан
из базе уколико није добијена потврда о ишчитавању. Након успешног
чувања у бази података Л-ПФР креира журнал фајл и генерише URL за
проверу исправности (верификацију) рачуна. Потом чува спремљен одговор
уз захтев у бази података и шаље фискализоване податке ЕСИР-у, у склопу
одоговора на захтев за фисклаизацију рачуна.
Цео процес фискализације једног рачуна траје приближно 0.5 секунди.

Имајући у виду да еФискализатор 2022 подржава истовремени пријем и
обраду више захтева, уско грло представља само потписивање рачуна које
врши БЕ. Све остале обраде зависе пре свега од перформанси рачунара на
коме се ЛПФР извршава. Можемо закључити да овако реализован ЛПФР
никако не угрожава рад и перформансе ЕСИРа.
У случају да ЕСИР не добије одговор у предвиђеном року, потребно је

проверити статус фискализације рачуна како не би дошло до дупле
фискализације рачуна. Провера статуса се врши позивом руте
api/v3/invoices/<requestId>. Управо због ове провере је пожељно слати
јединствени RequestId као део HTTP заглавља приликом сваког захтева за
фискализацијом рачуна.
Препоручени ток комуникације између ЕСИРа и ЛПФРа је:

1. ESIR позива POST /api/v3/invoices руту, са JSON захтевом за
фискализацијом рачуна и јединственим RequestId у HTTP Header
2. ЛПФР одговара са:

2.1. 200 OK, JSON response, са фискализованим рачуном
2.2. 200 OK, са JSON Error model, грешка за конкретно поље захтева
2.3. 400 Bad Request, са конкретним кодом грешке
2.4. Не одговара у времену подешеном на страни ЕСИРа као connection или
HTTP request timeout
2.4.1. ESIR позива GET /api/v3/invoices/<requestId>

2.4.2. ЛПФР одговара са:
2.4.2.1. 200 OK, JSON response, рачун фискализован
2.4.2.2. 200 OK, празан одговор - фискализација рачуна није успела!
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
20
2.4.2.3. 200 OK, "4005" - Фискализација рачуна у току
2.4.2.3.1. ESIR понавља корак 2.4.1, док не добије одговор као у кораку
2.4.2.1 или 2.4.2.2
2.4.2.3.2. ESIR не жели више да чека на одговор и:

2.4.2.3.2.1. Позива POST /api/v3/restart руту
2.4.2.3.2.2. Чека N секунди, и позива GET /api/v3/attention руту све док
не добије 200 ОК, потом иде даље
2.4.2.3.2.3. Позива POST api/v3/pin руту
2.4.2.3.2.4. Понавља корак 2.4.1. и добија коначни статус фискализације
рачуна, као у кораку 2.4.2.1. или 2.4.2.2.
2.4.2.3.2.5. ESIR штампа рачун или одбацује рачун, у зависности од
одговора
8.3 Журнал
ЛПФР генерише журнал у складу са техничким упутством. На следећој слици

дат је пример генерисаног журнала.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
21
Слика 25. Пример журнала
8.4 Верификациони URL и QR код
ЛФПР генерише и јединствени верификациони УРЛ, као и његову графичку

репрезентацију у форми QR кода, у који уграђује све неопходне
параметре и на начин дефинисан у Техничкој документацији.
Пример генерисаног URLa:
https://sandbox.suf.purs.gov.rs/v/?vl=A1BTTk5ONUIzUFNOTk41QjPYAAAArAAAA
ICWmAAAAAAAAAABfXcKxBcAAACDjrL1ivdvlA2aDWoE7gVTXypDUdrWqZk
XgBGBQoaa9GaQWxPIIamj9YoeVJT6fT5ZZ89lwTIpd4FhCv3Di1hYWJd1I0R
4KiE6M09JIaRGPGUf8qHyXpipzeSfpUEQqa+flUS8GRkW6a4pYf5KbM3YbJp8
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
22
mET4y5G3rQt9nMsyaGjHH1otXZEKs5Tf3VTP9U7XBWLG3JpvLipN7avVinVO
1p4hOBcfaFwhtbneNaLuq3FQHCM6K9CWjeqwmX5PxoyN3QAvojNRCObQo
FvAi0Q0Jy3OXiTuxrL7XZr/TV0W18+3SUn2CTCwKhOhifAeuqgTZiVjeoGuyX
JsV2tyAOuJYluS8ID4G2zKWzVpPKiCUVZzUIgEafO62jmQS3p1yW5BdRmldc
zJTvXw0jh5yd2XOj4lpDvKS6aCuZSaDCEe5JsbBSPnl5CPdWf7M+n6lv8SEWf
tzrUBNBGpyL90QCy7x06xbL+g6IsuDPKFwKH6wCY2ckdInVLhRr3sfTbZaUy
s3EtmJB3IOCMysu+3+S0+mehhohfmkYVPvJLrjFuy4aaz4VnkSMBJ1AttSA8
0AWg5mScHVcRk9WH7K3AF6DCVdleOYEdXSAoQFptU/7BxEIqODe+uYBRC
9WKgklqe5GdZqnGRJv0ptz8R8Tf23+/CwpSn6vSW/pCbAou2l/i9d0lQb6LDd
W2ae+1VXqKahb4=
Пример генерисаног QR кода:
Слика 26. Пример QR кода
8.5. Додатне API руте за комуникацију са ЛПФРом
Поред стандардних API рута, еФискализатор 2022 нуди и додатне услуге

путем следећих рута:
1. Рута GET / api / v3 / lpfr-status, враћа статус самог

ЛПФРа, број непослатих / непотврђених рачуна и датум
истицања лиценце
2. Рута POST / api / v3 / restart рестартује ЛПФР апликацију

и може се користити у случају проблема са картицом
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
23
(грешка 2220) или других проблема у комуникацији са
ЛПФРом
3. Рута GET api / v3 / card враћа податке са БЕ о пореском

обвезнику
4. Дневна статистика о промету (YYYY-MM-DD) доступна до 7

дана уназад, кроз руте:
4.1. GET / api / v3 / stats

Одговор је 200 OK и JSON са укупним прометом и
рефундацијом, по свакој од пореских стопа и сваком од
начина плаћања за текући дан
4.2. GET / api / v3 / stats / {date}

Датум у YYYY-MM-DD формату (пример: 2021-12-28)
Одговор је 200 OK ако је датум валидан и JSON са укупним
прометом и рефундацијом, по свакој од пореских стопа и
сваком од начина плаћања за текући дан или 400 Bad
Request за невалидан датум
5. GET аpi / v3 / stats-history ?dateFrom={dateFrom}

&dateTo={dateTo}
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
24
Одговор враћа статистику продаје за одабрани временски
период. Структура одговора је иста као и за претходну
руту.
6. Ако ЕСИР жели да користи статистику продаје по сменама,

из менија Подешавања потребно је активирати опцију Рад у
сменама, после чега следеће руте постају активне:
5.1. Статистика промета за текућу смену

GET / api / v3 / shift
начина плаћања за текућу смену
5.2. Статистика промета за смену

GET / api / v3 / shift / {id}
начина плаћања за одабрану смену или 400 Bad Request за
невалидан ИД смене
5.3. Крај смене и почетак нове смене

POST / api / v3 / shift
начина плаћања за управо затворену смену
9. Комуникација са СУФ веб сервисима
ЛПФР комуницира са СУФ веб сервисима у потпуности у складу са техничким

водичем ПУ. На почетку очитава Api URL из сертификата похрањеног на БЕ.
Исти сертификат се користи за успостављање TSL сигурне конекције ка СУФ
веб сервисима. Потом се путем руте api/v3/sdc/token захтева ауторизациони
токен. Сва даља комуникација се ауторизује уз помоћ добијеног токена.
Одмах након добијања токена се позива рута /api/v3/sdc/commands путем

које се захтевају команде са основним комуникационим параметрима,
адресом НТП сервера као и пореске стопе. Тек након добијања наведених
команди, ЛПФР може прећи у оперативно стање и примати даље захтеве за
фискализацијом.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
25
На сваких више од 5 минута позива се рута /api/v3/sdc/audit-proof, путем
које се шаље АРП генерисан од стране БЕ. Такође се шаљу и непослати а
фискализовани рачуни на руту /api/v3/sdc/audit. Иста рута се позива и
одмах пошто се изврши фискализација сваког рачуна.
Команда PoA (Proof of Audit), као и друге команде, може стићи од ПУ као
одговор на сваки од позива ка СУФ веб сервису. Приликом стизања команде,
иста се без одлагања извршава на БЕ, и у случају потврдног одговора
пакети са успешно послатим рачунима се означавају као ишчитани, након
чега је дозвољено њихово брисање из локалне базе података. Команде се
обрађују искључиво у пристиглом редоследу. Након успешног извршавања
сваке од команди, шаље се потврда путем СУФ веб сервиса.
На сваких 5 минута ЛПФР позива и /api/v3/sdc/notify руту, чиме обавештава

СУФ веб сервисе о свом активном статусу.
10. Грешке и упозорења
Осим стандардних грешака дефинисаних у техничком водичу, eFiskalizator

2022 враћа и следеће грешке и упозорења до којих може доћи у
свакодневном раду:
Табела 1. Шифарник додатних статуса

Шифра Опис Тип
3000 Непозната грешка Грешка
3001 Потребна реиницијализација Грешка
3002 Сертификат истекао Грешка
3003 Ишчитавање није завршено више од 5 дана Грешка
3004 Разлика између НТП времена и локалног времена Грешка

већа од 3 минута
3005 Време није синхронизовано дуже од 48 сати Грешка
3006 Датум издавања рачуна млађи од последњег већ Грешка

фискализованог рачуна
3007 RequiestId је већ регистрован Грешка
3008 Лиценца истекла Грешка
3009 Не постоји пореска стопа за послати датум рачуна Грешка
3010 На локалном складишту има мање од 100mb Грешка

proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
26
слободно
4000 Ишчитавање није завршено више од 3 дана, мање од Упозорење

5 дана
4001 Разлика системског времена у односу на НТП време Упозорење

већа од 1 минута, мање од 3 минута
4002 Сертификат истиче за мање од 30 дана Упозорење
4003 Лиценца истиче за мање од 7 дана Упозорење
4004 TaxCore API није доступан Упозорење
4005 Фискализација рачуна у току Упозорење
4006 Неуспешно креиран аудит пакет Упозорење
4008 Рачуни нису потврђени дуже од 5 дана Упозорење
4009 Неки рачуни су одбијени од стране ПУ Упозорење
11. Лиценцирање
еФискализатор 2022, као комерцијално решење за ЛПФР, поседује

механизам лиценцирања описан у овом поглављу.
Лиценце се издају за сваку инсталацију ЛПФРа у формату јединственог кода

дужине 20 карактера. Лиценце могу важити 1 месец, 3 месеца, 6 месеци или
годину дана. Приликом прве инсталације и убацивања безбедоносног
елемента, ЛПФР ће послати податке: ПИБ и ЈИД до лиценцног сервера, након
чега ће аутоматски бити генерисана пробна лиценца са пробним периодом
важења.
Након тога, потребно је да се купи лиценца за наредни временски период.
Након инсталације неопходно је да корисник пошаље емаил на адресу

licenca@fiskalizacija.in.rs са следећим подацима:
● Порески идентификациони број (ПИБ)
● Јединствени идентификатор (ЈИД)
Наведене информације се могу прочитати са статусног екрана ЛПФР

апликације. Након регистроване уплате лиценца ће бити прослеђена путем
емаила и активирана на лиценцном серверу. У случају немогућности
контактирања лиценцног сервера, лиценца се може активирати и ручно,
путем опције Ручна активација лиценце из секције за иницијализацију.
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
27
Уколико је лиценца валидна, добиће потврду и у статусној линији ће бити

приказана активна лиценца са датумом истицања. У супротном, корисник ће
добити грешку и захтев да покуша поновни унос лиценце.
Приликом сваког новог дана, ЛПФР ће подсетити корисника колико је још

дана остало до истека лиценце уколико је остало још мање од 7 дана до
истека лиценце.
Слика 27. Ручни унос лиценце
proudSourceIT
Тел: +381 (69) 34-88-695, +381 (69) 88 - 93 - 496
28

еФискализатор 2022 - Упутство за инсталацију ЛПФРа и ЕСИР интеграцију

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

еФискализатор 2022 - Упутство за инсталацију ЛПФРа и ЕСИР интеграцију

Uploaded by

Copyright:

Available Formats

eФискализатор 2022

Упутство за инсталацију ЛПФРа и ЕСИР интеграцију

Верзија документа: 1.2

7. Замена Безбедносног елемента (БЕ) 18

9. Комуникација са СУФ веб сервисима 25

10. Грешке и упозорења 26

еФискализатор 2022 је софтверски локални процесор фискалних рачуна

Компанија ProudSourceIT доо је основана од стране два универзитетска

У овом документу се налази детаљно упуство за инсталацију, подешавање и

еФискализатор 2022 подржава оперативни систем Microsoft Windows, од

Поред наведеног оперативног система, предуслов за функционисање јесте и

Уколико је еФискализатор 2022 инсталиран на другом рачунару у односу на

еФискализатор 2022 је апликација за Windows оперативни систем којом се

Слика 1. Пример иконице еФискализатор у делу за нотификације

Све опције система еФискализатор 2022 су доступне уз помоћ иконе у делу

Десни клик на иконицу ће понудити основни мени система.

Слика 2. Основни мени система доступан на десни клик

Опција Иницијализуј покреће иницијализацију система еФискализатор 2022.

Опција Покрени поново гаси систем и поново га покреће у случају да је

Опција Изађи гаси систем еФискализатор 2022.

Систем еФискализатор 2022 у себи садржи све компоненте неопходне за

Изложен је REST API који Електронски системи за издавање рачуна (ЕСИР)

Систем бележи важне акције и догађаје у систему и чува сваку грешку

Инсталациони пакет се дистрибуира путем веб сајта произвођача или на

Слика 3. Приказ инсталационог екрана апликације еФискализатор 2022

Корисник може одлучити хоће ли пречица за покретање програма бити

Након клика на дугме Next, следећи корак захтева потврду покретања

Слика 4. Други корак инсталације

eFiskalizator 2022 треба конфигурисати тако да се аутоматски покреће

Алтернативно, инсталација ће поставити икону на десктоп рачунара, одакле

Слика 5. Изглед иконе на Desktop-у

Предуслов за функционисање јесте повезан читач паметних картица, у који

Слика 6. Иницијализација ЛПФРа по корацима

eFiskalizator 2022 ће приликом покретања покренути процедуру

У поступку иницијализације систем ће проћи кроз шест ставки и урадити

Слика 7. Мануелни опоравак од недостатка услова за функционисање

На слици 7. Може се видети пример када корисник није убацио Безбедносни

5.1 Провера сертификата Пореске управе

Прва ставка провере приликом Иницијализације односи се на потребу да на

Уколико систем не успе да аутоматски инсталира потребне сертификате

По успешној инсталацији и провери сертфиката корисник је обавештен да је

Слика 8. Успешно завршен корак провере сертификата Пореске управе

5.2 Провера пореске картице

Друга ставка провере приликом Иницијализације односи се на потребу да на

Систем првенствено детектује да ли је присутан читач картица а потом да ли

Уколико су читач и картица присутни систем приступа очитавању

Слика 9. Унос ПИНа за активацију Безбедносног Елемента

Корисник има 5 покушаја да унесе исправан ПИН на шта га систем

Слика 10. Успешно извршена провера пореске картице

5.3 Провера лиценце

Слика 11. Ручна активација лиценце

У сваком од случајева провере уколико је остало 7 дана до истицања

5.4 Подизање сервиса за фискализацију

Четврта ставка приликом Иницијализације односи се на подизање сервиса за

Уколико сервис није подигнут систем подиже сервис или на иницијалном

Ради обезбеђивања минималног простора за рад, ЛПФР ће пре подизања

Уколико из било ког разлога систем не успе да успостави сервис обавештава

5.5 Провера ЛПФР конфигурације

Пета ставка приликом Иницијализације односи се на повлачење и проверу

Да би еФискализатор 2022 радио у пуном капацитету потребно је да има

Слика 13. Успешно конфигурисан ЛПФР

Уколико команде нису доступне кроз сервис Пореске управе систем ће

Корисник може преузети иницијализационе команде путем портала Пореске

5.6 Синхронизација времена