Упутство за конфигурацију

Откуцај, регистарски назив „Otkucaj“ · верзија 1.3.6 · otkucaj.com · Корисничко упутство · Упутство за инсталацију

Све што овај документ каже о прописима је наше разумевање, а не правни ни порески савет; пре одлуке проверите код књиговође или у Пореској управи.

Садржај

• 1.Ко конфигурише и шта види
• 2.Редослед конфигурисања
• 3.Тест и продукција
• 4.Режим ПФР-а
• 5.Аутентификација ЕСИР-а и ПФР-а
• 6.Безбедносни елемент
• 7.ЕСИР број и верзија софтвера
• 8.Подаци о обвезнику и продајном месту
• 9.Пореске ознаке и стопе
• 10.Заокруживање износа и пореза
• 11.Штампа
• 12.Начини плаћања
• 13.Корисници и улоге
• 14.АПИ кључеви
• 15.Обавештења
• 16.Дневник рада
• 17.Пуштање у продукцију
• 18.Контролна листа конфигурације

1.Ко конфигурише и шта види

Конфигурацију ради администратор. Само он види ставку Подешавања у бочном менију и само он може да мења било шта из овог документа. Касир на својој пријави не види ту ставку, не може да отвори њене адресе и не може да мења ни окружење, ни режим ПФР-а, ни сертификат, ни пореске стопе, ни податке о обвезнику, ни ширину рачуна, ни начине плаћања. Касир ради на Каси, види рачуне и артикле, издаје копије и рефундације, и то је све. Та подела није ствар изгледа: провера се ради на серверу, при сваком захтеву.

Екран Подешавања подељен је на девет картица, а редослед прати оно чиме се заиста почиње. Свака картица има своју адресу, па се на њу може показати директно.

2.Редослед конфигурисања

Кораци испод иду тим редом и ниједан се не прескаче. Сваки има услов по коме се види да је стварно завршен, а не само да је неко нешто уписао. Кораци 1 до 8 раде се у тест окружењу; продукција се дира тек у кораку 9.

1. Пријавите се администраторским налогом. Готово када у бочном менију постоји ставка Подешавања и када сте променили лозинку добијену при инсталацији.
2. Унесите податке о обвезнику (поглавље 8). Готово када ПИБ, пословно име, назив продајног места и адреса словно одговарају подацима о пословном простору које сте пријавили Пореској управи.
3. Подесите штампу (поглавље 11). Готово када пробни рачун изађе цео, ниједан ред не пада са ивице папира, а QR код измерен лењиром износи од 40 до 50 mm.
4. Изаберите режим начина плаћања (поглавље 12). Готово када Каса нуди тачно оне начине плаћања које тај обвезник сме да користи, и ниједан више.
5. Поставите режим ПФР-а за тест (поглавља 4 и 5). Готово када статус везе на картици Окружење и ПФР јавља да је ПФР доступан, а не поруку о грешци.
6. Поставите тест безбедносни елемент, ако се ради са В-ПФР-ом (поглавље 6). Готово када приказ уз сертификат наводи коме је издат, до када важи и његов отисак.
7. Унесите ЕСИР број и верзију (поглавље 7). Готово када провера спремности тог окружења више не пријављује да ЕСИР број недостаје.
8. Преузмите пореске стопе са ПФР-а (поглавље 9). Готово када дугме јави колико је стопа преузето и од ког датума важе, а поља у табели буду закључана.
9. Издајте пробне рачуне у тесту. Готово када кроз ПФР прођу Промет Продаја, Промет Рефундација, Копија, Предрачун, Обука и Аванс, и када се сваки од њих види у регистру рачуна.

Тек после тога иде продукција, поглавље 17. Оно што се тамо ради није понављање ових корака него њихово попуњавање стварним подацима, у другом окружењу, уз проверу спремности која не дозвољава да се полудовршена инсталација прогласи живом.

3.Тест и продукција

Свака фирма у Откуцају има два потпуно одвојена окружења и у сваком тренутку је тачно једно активно. То нису два налога и није их потребно правити: постоје од инсталације, а свеже инсталирана копија ради у тесту.

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

Оно што је заједничко за оба окружења, јер не зависи од тога с којим системом Пореске управе се разговара: подаци о обвезнику, ширина папира и рачуна, рекламни текст, режим начина плаћања, корисници, АПИ кључеви и обавештења. Оно што је по окружењу: режим ПФР-а, адресе Л-ПФР-а и В-ПФР-а, ПАК, ЕСИР број и верзија, и сертификат безбедносног елемента.

3.1 Провера спремности

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

Окружење се сматра спремним када испуни све услове испод:

1. режим је Л-ПФР или В-ПФР, никако демо; демо не издаје фискалне рачуне, па је у продукцији противречност сам са собом;
2. ЕСИР број је број, дакле евиденциони број који је доделила Пореска управа, а не текст;
3. за В-ПФР: сертификат је постављен;
4. за В-ПФР: ПАК је унет, јер В-ПФР без њега одбија захтев;
5. за В-ПФР: адреса одговара том окружењу, дакле тест адреса у тесту и продукцијска у продукцији;
6. сертификат у том окружењу разликује се од сертификата у другом.

Док било шта од тога није испуњено, дугме Пребаци овде је искључено, а испод њега стоји образложење. Ако инсталација већ ради у окружењу које не испуњава услове, издавање се зауставља, а разлози се исписују изнад корпе на Каси, пре него што касир откуца рачун.

3.2 Две грешке које апликација неће дозволити

Исти сертификат у оба окружења. Тест и продукција морају имати различите безбедносне елементе. При постављању се сертификат отисне (SHA-256) и отисак се упамти, па се исти сертификат не може поставити и у једно и у друго окружење: други покушај се одбија уз поруку. Ако се исти отисак ипак затекне у оба, издавање се зауставља док се не исправи. То је једина грешка у конфигурацији која производи рачуне које нико не може да поправи, зато се проверава двоструко.

Унакрсно повезивање адреса. Ако у продукцију унесете тест адресу Пореске управе, рачуни би изгледали као прави а не би били фискални. Ако у тест унесете продукцијску адресу, пробни рачуни би отишли у стварну евиденцију. Оба уноса се одбијају већ при чувању, уз објашњење које именује адресу.

Уз то, адреса В-ПФР-а мора почињати са https://. Унос са обичним HTTP-ом се одбија при чувању: клијентски сертификат се шаље само преко заштићене везе, па би се преко HTTP-а разговарало са Пореском управом без безбедносног елемента уопште.

4.Режим ПФР-а

Свако окружење има свој режим рада, који се бира на картици Окружење и ПФР и мења без поновне инсталације.

Порт Л-ПФР-а даје његов испоручилац и он се не погађа. Ако Л-ПФР ради на другом рачунару у мрежи објекта, уместо localhost уноси се адреса тог рачунара, а мрежа између њих мора бити пролазна на том порту.

Испод поља стоји статус везе и он се очитава уживо, при сваком отварању почетне стране и Подешавања. Порука коју ПФР врати приказује се онако како је стигла, зато што је то једини податак који помаже: „картица није убачена“ и „ПАК није исправан“ решавају се на два потпуно различита места.

Промена режима не дира ниједан већ издати рачун. Сваки рачун памти режим у ком је издат, па се и после преласка са демоа на прави ПФР у регистру јасно види који су рачуни били демо.

5.Аутентификација ЕСИР-а и ПФР-а

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

В-ПФР. Веза иде преко HTTPS-а. Откуцај се представља клијентским сертификатом, а то је безбедносни елемент у облику датотеке, и уз сваки захтев шаље заглавље са ПАК-ом. У истом руковању проверава и сертификат В-ПФР-а, дакле његовог издаваоца и име домаћина; та провера је укључена и не постоји подешавање којим би се искључила. Ако сертификат није постављен, ако лозинка не отвара датотеку или ако ПАК није прихваћен, В-ПФР одбија захтев, рачун се не издаје, а порука се приказује касиру.

Л-ПФР. Веза иде преко HTTP-а у локалној мрежи и клијентски сертификат се на њој не шаље, јер у тој вези нема места за њега. Према безбедносном елементу аутентификује се сам Л-ПФР, преко читача паметних картица и ПИН-а. Откуцај картици не приступа.

Када се провера обавља и шта се дешава кад падне. При отварању почетне стране и Подешавања, при преузимању пореских стопа и при сваком издавању рачуна. Неуспех се не претвара у полурачун: дугме Издај рачун је искључено пре него што касир откуца целу корпу, а разлог стоји изнад корпе. Ако веза падне у самом тренутку издавања, рачун улази у локални ред чекања и није издат док не прође кроз ПФР. Како ми разумемо чл. 6 ст. 1 Закона о фискализацији, док рачун чека, промет се не завршава.

6.Безбедносни елемент

На картици Безбедносни елемент стоје два одвојена оквира, један за тест и један за продукцију. У сваки иде његов сертификат (.pfx или .p12) и његова лозинка. Датотека се уписује ван директоријума који веб сервер служи, са правима 0600, и никада се не служи посетиоцима; лозинка се чува шифровано (AES-256-GCM), кључем те инсталације, па копија базе сама по себи не открива ништа.

Отпремање се прихвата само ако се датотека стварно отвори унетом лозинком. Погрешна лозинка се не може сачувати па открити на првом правом рачуну: одбија се одмах. Прихватају се датотеке до 512 kB, што је вишеструко изнад величине сертификата. Ако мењате само лозинку, поље за датотеку оставите празно; ако мењате само датотеку, оставите празно поље за лозинку и претходна остаје на снази.

Уз сваки постављен сертификат приказује се коме је издат, до када важи и првих шеснаест знакова отиска. Оквир се обоји и упозорава тридесет дана пре истека, и посебно кад је сертификат истекао. Отисак служи и као доказ да тест и продукција не деле исти елемент (поглавље 3.2), па га вреди записати уз документацију инсталације.

Windows складиште. Ако је Откуцај инсталиран локално на Windows рачунару, уместо отпремања датотеке може се употребити сертификат који је већ инсталиран на том рачунару: бира се складиште (Тренутни корисник или Локални рачунар) и уноси се отисак сертификата, без размака. Тада нема ни датотеке ни лозинке које апликација чува. Ова могућност се приказује само тамо где стварно ради; на otkucaj.com је нема и не може је бити, јер сервер не види складиште сертификата вашег рачунара, па је отпремање датотеке једини пут.

7.ЕСИР број и верзија софтвера

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

На рачуну стоји спојен са верзијом софтвера, косом цртом: ЕСИР број: 123/1.0. Поље Верзија садржи ту другу половину. Тест окружење прихвата и резервисану вредност 000, која је служила пре одобрења, а провера спремности неће дозволити прелазак у продукцију док ЕСИР број тамо није број. Ако у продукцији остане 000, рачуни се једноставно не издају, што је боље од рачуна са погрешним бројем: неслагање између одштампаног броја и додељеног евиденционог броја је познат разлог за одбијање пријаве.

Серијски број инсталације је нешто друго и не меша се са ЕСИР бројем. Он је у облику OTK-XXXXXXXXXXXX, додељује се аутоматски при инсталацији, јединствен је за ту копију програма и не мења се ни после надоградње ни после враћања резервне копије. Заједно са произвођачем и верзијом софтвера стоји у одељку О апликацији, на картици Подаци о обвезнику; наводи се при пријави проблема и при контроли.

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

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

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

9.Пореске ознаке и стопе

На картици Порези стоји табела важећих ознака и стопа. Меродаван је ПФР, не та табела. Док је повезан Л-ПФР или В-ПФР, поља се не могу мењати ручно: закључана су, а дугме Преузми стопе са ПФР-а их освежава из извора и јавља колико је стопа преузето и од ког датума важе. Тако апликација не може да обрачуна порез по стопи коју је неко укуцао. У демо режиму ПФР-а нема од кога би се стопе преузеле, па остају уредиве и важе подразумеване српске стопе.

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

10.Заокруживање износа и пореза

Заокруживање није подешавање и нема поља којим би се мењало; описано је овде зато што конфигурација мора да га наведе. Сви новчани износи воде се и приказују на две децимале, а количина на три. Заокружује се тако што се друга децимала повећава ако је следећа цифра 5 или већа, а остаје иста ако је мања од 5: 1,005 постаје 1,01, а 1,004 постаје 1,00. Тако се добијају износ ставке (количина пута јединична цена, са попустом ако га има), укупан износ рачуна, износ сваког плаћања и повраћај. Количина иде на три децимале зато што се роба продаје и на меру, па 0,375 kg остаје 0,375; сувишне нуле се на рачуну не исписују.

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

11.Штампа

На картици Штампа и плаћање подешавају се четири ствари: ширина папира, ширина рачуна у знаковима, подразумевани рекламни текст и режим начина плаћања (поглавље 12).

Ширина папира бира се између А4, ролне од 80 mm и ролне од 58 mm, и мора одговарати папиру који је стварно у штампачу. Она одређује величину стране при штампи; без ње прегледач претпоставља A4 и својим уклапањем нечујно мења физичку величину QR кода, а он мора остати између 40 и 50 mm. Најмања подржана ролна је 58 mm; ужа од 57 mm није подржана, јер журнал у прописаном распореду не стаје у мање знакова по реду.

Облик рачуна на листу. На ролни и на А4 листу се по овом подешавању штампа журнал који је ПФР потписао, дословно. Поред тога, од верзије 1.3.6, рачун се на листовима А4 и А5 може одштампати као документ, што се бира на самој страници рачуна и у позиву АПИ-ја: заглавље продавца, поља касира и купца, врста рачуна, табела ставки, плаћање и порез, ПФР метаподаци, QR код унутар оквира и завршна линија, а испод ње само рекламно поље. Распоред и садржај су описани у поглављу 6.2 корисничког упутства.

Ширина рачуна у знаковима је број знакова у реду журнала: уобичајено 40 за ролну од 80 mm и 32 за ролну од 58 mm, а дозвољени распон је од 32 до 64. Из тог броја се изводи величина слова, зато што је ширина отиска фиксна: 46 mm на ролни од 58 mm и 68 mm на ролни од 80 mm, што одговара ширини коју термална глава стварно отискује. Ако рачун не стаје у папир, смањује се број знакова, а никада размера штампе: размера мења и величину QR кода.

QR код се штампа на 41 mm на ролни од 58 mm и на 45 mm на ролни од 80 mm и на листовима А4 и А5. Обе вредности су унутар прописаних 40 до 50 mm. Слику прави сам ПФР и штампа се његова; сопствену апликација црта само у демо режиму, где ПФР-а нема.

Подразумевани рекламни текст се штампа на сваком рачуну испод линије КРАЈ ФИСКАЛНОГ РАЧУНА, дакле изван фискалног дела, и дуг је највише 500 знакова. Касир га на Каси може изменити или обрисати за појединачни рачун. У дијалогу штампе прегледача остаје да се једном по уређају поставе маргине на „без маргина“, размера на 100% и да се искључе заглавља и подножја.

12.Начини плаћања

Откуцај подржава свих седам начина плаћања прописаних чл. 6 Правилника о врстама фискалних рачуна и сваки у захтеву према ПФР-у носи свој нумерички код из Техничког водича:

Стандардни режим нуди свих седам начина. Режим по чл. 6 ст. 2 Правилника о врстама фискалних рачуна је, како ми разумемо тај члан, обавезан за уређај преко кога се евидентира услуга предаје хране и пића за конзумацију на лицу места или промет хране и пића у објекту пекаре: искључује платну картицу, чек и инстант плаћање, које касир тада уноси као готовину, па остају кодови 0, 1, 4 и 5. Искључени начини се не нуде на Каси, а захтев који их садржи одбија се и преко АПИ-ја, уз објашњење; провера је на серверу, не само у изгледу екрана.

Једна инсталација ради искључиво у једном од ова два режима. Режим бира администратор и он важи за све касире и за све интеграције. Ако обвезник има више продајних места са различитим режимима, то су различите инсталације.

13.Корисници и улоге

На картици Корисници отварају се налози, додељује се улога (администратор или касир), ресетује се лозинка и деактивира се касир који више не ради. Лозинка има најмање 10 знакова. Име корисника се исписује и штампа на сваком рачуну који он изда, као идентификација касира (Техничко упутство, 16.П3). Довољна је ознака која касира јединствено идентификује, на пример име или интерна шифра запосленог; пуно име и презиме није обавезно, а због заштите података о личности препоручујемо најмање што је довољно.

Овде се и одобравају налози пристигли са странице за регистрацију. Такав налог се отвара неактиван и пријава са њим није могућа док га администратор не активира. Деактивација налога, промена лозинке и дугме Одјави ме свуда прекидају и трајну пријаву на свим уређајима тог корисника, не само тренутну сесију.

14.АПИ кључеви

Кључеви служе спољним програмима: веб продавници, ERP-у, додатку за WooCommerce. Генеришу се и опозивају на картици АПИ кључеви, свакоме се даје ознака по којој се зна коме припада, а ограничење је 240 захтева у минуту по кључу.

Кључ се приказује само једном, у тренутку генерисања; у бази остаје само његов отисак, па се изгубљен кључ не може прочитати него само заменити новим. Одмах га пренесите на сигурно место. Компромитован кључ се опозива истог часа и генерише се нов; опозив делује одмах, а рачуни већ издати тим кључем остају нетакнути.

15.Обавештења

Картица Обавештења шаље поруку у Телеграм за сваки издати рачун: врсту рачуна, износ, начине плаћања, ПФР број, бројач и линк за проверу. Подешавање је необавезно, али је корисно код продавница повезаних преко АПИ-ја, где власник иначе не види рачун у тренутку издавања.

1. Бот токен: у Телеграму отворите @BotFather, командом /newbot направите бота и ископирајте токен.
2. Chat ID: број разговора, најлакше преко бота @userinfobot. Може бити и ID групе, ако обавештења треба да види више људи; тада бота додајте у групу.
3. Укључите прекидаче за рачуне преко АПИ-ја и/или са Касе, према томе шта желите да пратите.
4. Кликните Пошаљи пробну поруку. Готово када порука стварно стигне у Телеграм; ако не стигне, ништа друго није ни подешено.

На исту адресу стиже и обавештење о свакој новој регистрацији налога која чека одобрење (поглавље 13).

16.Дневник рада

Дневник бележи ко је и када издао рачун, мењао артикле, подешавања, кориснике и АПИ кључеве, укључујући промену окружења и постављање сертификата, свако са временом и IP адресом. Уписује се сам, не може се искључити подешавањем и не може се уређивати кроз апликацију.

На картици Дневник рада приказује се последњих 200 радњи. Старије остају у бази и излазе из ње са резервном копијом (поглавље 6 Упутства за инсталацију), што је и место где им је при контроли право место: дневник је помоћ при утврђивању ко је шта урадио, а не замена за регистар рачуна.

17.Пуштање у продукцију

Продукција се попуњава тек кад обвезник има безбедносни елемент, односно ПАК, и кад ЕСИР има евиденциони број Пореске управе. До тада нема шта да се уписује и покушај преласка се одбија, што је исправно.

1. На картици Окружење и ПФР изаберите оквир за продукцију и попуните га стварним подацима: режим Л-ПФР или В-ПФР, продукцијска адреса, ПАК и евиденциони ЕСИР број.
2. На картици Безбедносни елемент поставите стварни сертификат у оквир за продукцију. Мора бити различит од тест сертификата; исти се одбија.
3. Проверите да провера спремности за продукцију не пријављује ништа.
4. Притисните Пребаци овде и потврдите питање. Од тог тренутка сваки рачун врсте Промет или Аванс је фискални рачун; Копија, Предрачун и Обука то нису.
5. Преузмите пореске стопе поново (поглавље 9) и прегледајте шифарник артикала, јер продукцијски систем може имати другачији скуп ознака од тест система.
6. Издајте један рачун врсте Обука и одштампајте га: он пролази цео ток као прави, али не улази у промет. Проверите заглавље, ЕСИР број, QR код и штампу.
7. Тек тада издајте први прави рачун.

18.Контролна листа конфигурације

Конфигурација је завршена када сваки ред буде потврђен. Редови 1 до 8 односе се на окружење у ком се ради; ред 9 надаље само на прелазак у продукцију.