Корисничко упутство

Откуцај верзија 1.2 · otkucaj.com · Преузми PDF

Садржај

• 1.О програму
• 2.Појмовник
• 3.Захтеви и инсталација
• 4.Пријава и улоге
• 5.Екран Касе
• 6.Издавање рачуна корак по корак
• 7.Бар-код скенер
• 8.Начини плаћања
• 9.Рефундација
• 10.Поништавање погрешног рачуна
• 11.Копија рачуна
• 12.Предрачун и конверзија у фискални рачун
• 13.Аванс
• 14.Обука
• 15.Слање рачуна е-поштом и преузимање
• 16.Артикли
• 17.Извештаји
• 18.Подешавања
• 19.Рад без интернета
• 20.Интеграције: АПИ и WooCommerce
• 21.Безбедност и чување података
• 22.Решавање проблема
• 23.Често постављана питања
• 24.Подршка

1.О програму

Откуцај је електронски систем за издавање рачуна (ЕСИР) у смислу Закона о фискализацији. Ради као веб апликација у прегледачу, на рачунару, таблету или телефону, без инсталације посебног програма. Сваки рачун се пре издавања прослеђује процесору фискалних рачуна (ПФР), који га фискализује: додељује му број, бројач и дигитални потпис. Откуцај ради са локалним ПФР-ом (Л-ПФР), са виртуелним ПФР-ом Пореске управе (В-ПФР), а до добијања одобрења са уграђеним демо симулатором ПФР-а.

Откуцај подржава све врсте рачуна и трансакција прописане Техничким водичем Пореске управе:

Поред касе, Откуцај обухвата регистар издатих рачуна, шифарник артикала са увозом и извозом, извештаје о промету, кориснике са улогама, дневник активности, АПИ за интеграције и додатак за WooCommerce. Апликација ради и без интернета као инсталабилна PWA (поглавље 19).

Шта Откуцај јесте, а шта није

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

Из тога следе три ствари које вреди запамтити:

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

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

2.Појмовник

3.Захтеви и инсталација

Прегледачи и уређаји

Откуцај ради у сваком савременом прегледачу: Chrome, Edge, Firefox и Safari у актуелним верзијама. Препоручујемо Chrome или Edge јер у њима најбоље ради инсталација апликације и штампа. Потребан је укључен JavaScript. Екран касе је прилагођен и рачунару и таблету и телефону.

Инсталација као апликација (PWA)

Откуцај је инсталабилна прогресивна веб апликација: добија своју икону, отвара се у сопственом прозору и чува шифарник артикала локално, па се Каса отвара и без интернета.

Дугме Инсталирај апликацију постоји и на почетној страни сајта (горња трака), у одељку Подешавања, О апликацији, и као последњи корак водича кроз прве кораке (поглавље 5): клик на њега покреће исти поступак инсталације као у табели изнад.

Подешавање термалног штампача

1. Инсталирајте штампач у оперативни систем са драјвером произвођача и подесите ширину папира: ролна 58 mm или 80 mm.
2. У дијалогу штампе прегледача (Ctrl+P) подесите: маргине: без маргина (None), размера (Scale): 100%, величина папира: ваша ролна 58 или 80 mm, и искључите заглавља и подножја (Headers and footers).
3. Одштампајте пробни рачун из демо режима и проверите да журнал стаје у ширину папира и да се QR код чита камером телефона. QR код се штампа у величини од 40 до 50 mm; подразумевано 45 mm.

Штампа ради и на обичном A4 штампачу: журнал се штампа у истом облику, а остатак екрана се не штампа јер је штампа изолована само на рачун.

Два начина рада: на интернету и локално у објекту

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

Шта је потребно за локалну инсталацију

1. Рачунар са оперативним системом Windows или Linux, на коме ради PHP 8.3 или новији и MySQL 8 или MariaDB 10.6 или новији.
2. Л-ПФР, засебно одобрен код Пореске управе, инсталиран на истом рачунару или у истој мрежи, са читачем картица и безбедносним елементом. Л-ПФР није део Откуцаја (видети поглавље 1).
3. Копија програма и база података. Инсталацију и почетно подешавање ради испоручилац.

Подешавања за рад без интернета

После инсталације, у датотеци подешавања и у одељку Подешавања поставља се следеће:

• Адреса апликације се поставља на локалну адресу, на пример http://localhost:8080 или адресу рачунара у мрежи. Тако све везе унутар апликације остају у локалној мрежи.
• Режим ПФР-а се поставља на Л-ПФР, а адреса Л-ПФР-а на ону коју је дао његов испоручилац, најчешће http://localhost:1200. Статус везе се одмах види у Подешавањима.
• Провера при пријави (Cloudflare Turnstile) се искључује, јер она захтева интернет. Пријава и даље тражи корисничко име и лозинку.
• Слање рачуна е-поштом ради само када постоји веза. Штампа и преузимање журнала раде увек.

4.Пријава и улоге

1. Отворите https://otkucaj.com и кликните Пријава.
2. Унесите корисничко име и лозинку које сте добили од администратора.
3. После пријаве отвара се екран Каса.

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

Име касира се уписује на сваки издати рачун, а свака радња се бележи у дневник активности.

Регистрација и одобравање налога

Нови обвезник може сам да отвори налог на страници Регистрација; линк ка њој постоји и на страници за пријаву. Образац тражи: пословно име, ПИБ, е-пошту, корисничко име и лозинку од најмање 10 знакова.

• Налог се отвара неактиван: пријава није могућа док га администратор не одобри у одељку Подешавања, Корисници.
• Ако су Телеграм обавештења подешена (поглавље 18), администратор одмах добија поруку о новој регистрацији.
• По активацији корисник се пријављује уобичајено, корисничким именом и лозинком.

Заштита пријаве: Cloudflare Turnstile

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

5.Екран Касе

Каса је подељена на два дела: лево је избор артикала, десно је корпа са плаћањима и дугметом за издавање.

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

Дуж леве ивице екрана стоји сајдбар са главним менијем. Дугме ⟨ при његовом дну сужава сајдбар на иконе, па Каса добија више простора; поновни клик га враћа у пуну ширину. Изабрано стање се памти по уређају.

Претрага и избор артикала

• Претрага: куцајте назив, ПЛУ или бар-код; списак се сужава док куцате. Тастер Enter потврђује унос: ако унети текст тачно одговара ПЛУ-у или ГТИН-у, артикал се одмах додаје у корпу (понашање скенера, поглавље 7).
• Категорије: испод претраге стоје дугмад категорија (нпр. Пића, Храна). Клик филтрира мрежу артикала на изабрану категорију, поновни клик враћа све.
• Мрежа артикала: клик на плочицу артикла додаје један комад у корпу.
• Слободан унос: за робу или услугу које нема у шифарнику отворите „Слободан унос“ и укуцајте назив, цену и пореску ознаку. Ставка иде у корпу као и свака друга.

Више отворених рачуна

Изнад корпе стоје картице отворених рачуна. Дугме + отвара нов празан рачун, а кликом на картицу прелазите са једног купца на другог, на пример када касир наплаћује више столова или када један купац „сачека“. Сви отворени рачуни се чувају локално у уређају и преживљавају освежавање странице и затварање прегледача; бришу се тек издавањем или ручним затварањем картице.

Корпа

• Количина: мења се тастерима − и + или директним уносом. Подржани су децимални уноси, нпр. 0,375 за 375 грама.
• Цена: јединична цена сваке ставке може се изменити директно у корпи (нпр. за робу са истакнутом акцијском ценом).
• Попуст по ставци: свака ставка има поље попуста у процентима; износ ставке се одмах прерачунава.
• Попуст на цео рачун: унесите проценат за цео рачун и Откуцај га распоређује по свакој ставци, тако да збир ставки и даље одговара ономе што ПФР обрачунава.
• Авансне ставке: дугмад за прописане авансне ставке (поглавље 13).

Поља уз рачун

• Врста рачуна (Промет, Аванс, Предрачун, Обука) и врста трансакције (Продаја, Рефундација). Копија се не бира овде него се издаје из постојећег рачуна (поглавље 11).
• ИД купца: идентификација купца у облику шифра:вредност (табела у поглављу 9). Обавезна код рефундације, а уноси се и кад купац тражи рачун са својим ПИБ-ом.
• Рекламни текст: произвољан текст који се штампа испод краја рачуна (нпр. „Хвала на поверењу“); код затварања аванса овде аутоматски стоји број и датум авансног рачуна.
• ЕСИР време: стварно време промета када се рачун издаје накнадно, нпр. за аванс уплаћен вирманом који је прокњижен наредног дана (поглавље 13).
• Плаћања: редови плаћања са аутоматским пољем „остатак“ (поглавље 8).

6.Издавање рачуна корак по корак

1. Пронађите артикле претрагом, скенером или кликом и додајте их у корпу.
2. По потреби измените количине и цене, унесите попусте.
3. Проверите врсту рачуна (за обичну продају: Промет, Продаја).
4. По потреби унесите ИД купца и рекламни текст.
5. Изаберите начин плаћања; код дељеног плаћања додајте још редова (поглавље 8).
6. Кликните Издај рачун. Откуцај шаље захтев ПФР-у, а затим приказује журнал са QR кодом.
7. Кликните Штампај за штампу, или пошаљите рачун е-поштом (поглавље 15).

Елементи издатог рачуна

Журнал је форматиран на 40 знакова по реду, на ћирилици, у распореду из Техничког водича, и садржи редом:

• ПИБ, пословно име, назив и адресу продајног места обвезника;
• ознаку касира, ИД купца ако је унет, и ЕСИР број (број из регистра одобрених ЕСИР-а, поглавље 18);
• врсту рачуна и трансакције (нпр. ПРОМЕТ ПРОДАЈА);
• ставке: назив, количина, јединична цена, износ и пореска ознака;
• ред За уплату и редове плаћања по начинима;
• порески преглед по ознакама: Ђ 20%, Е 10%, Г 0%, А ван ПДВ; стопе увек долазе из ПФР-а, никад из апликације;
• ПФР време, ПФР број рачуна у облику ЈИД-ЈИД-редни број и бројач, нпр. 143/302ПП: 143. рачун врсте Промет Продаја од укупно 302 рачуна;
• QR код и линк за проверу рачуна; штампани QR код има од 40 до 50 mm (подразумевано 45 mm);
• после краја рачуна: рекламни текст, ако је унет.

У демо режиму рачун поред тога носи јасну ознаку ДЕМО. Копија, Предрачун и Обука штампају „ОВО НИЈЕ ФИСКАЛНИ РАЧУН“ у двострукој величини слова.

7.Бар-код скенер

Откуцај ради са сваким скенером који се јавља као тастатура (USB или Bluetooth HID), без икаквог подешавања у апликацији.

• Скенер укуца бар-код у поље претраге и пошаље Enter; Откуцај пронађе артикал по ГТИН-у и одмах га дода у корпу. Исто важи и кад код или ПЛУ укуцате ручно па притиснете Enter.
• Префикс количине: укуцајте 2*код или 2xкод (нпр. 2*1001) па потврдите: ставка улази у корпу са количином 2. Ради и са скенером: укуцајте 2* па скенирајте.
• Бар-код се везује за артикал у шифарнику, поље ГТИН/бар-код (поглавље 16). Ако код није пронађен, Откуцај то јасно каже: додајте артикал у шифарник или искористите слободан унос.

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

Откуцај подржава свих седам законом прописаних начина плаћања:

Подељено плаћање

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

Режим по чл. 6 ст. 2 Правилника

За обвезнике који по чл. 6 ст. 2 Правилника о врстама фискалних рачуна евидентирају плаћања на упрошћен начин, Откуцај има посебан режим у Подешавањима: начини платна картица, чек и инстант плаћање су искључени, а такве уплате се уносе као готовина. Једна инсталација Откуцаја ради искључиво у једном режиму; режим бира администратор и важи за све касире.

9.Рефундација

Рефундација је фискални рачун којим се враћа промет: цео рачун или поједине ставке. Правила:

• Рефундација обавезно носи референтни број оригиналног рачуна (ПФР број у облику ЈИД-ЈИД-број).
• Рефундација обавезно носи ИД купца.
• Ставке се рефундирају по цени по којој су стварно наплаћене (са попустом ако га је било).

Шифарник садржи и остале идентификације из Техничког водича; наведене су најчешће.

Поступак

1. Отворите Рачуни, пронађите оригинални рачун и кликните Рефундација. Каса се отвара са попуњеним ставкама и референтним бројем оригинала.
2. Обришите ставке које се не враћају или смањите количине.
3. Унесите ИД купца, нпр. 20: и број личне карте купца.
4. Изаберите начин исплате и кликните Издај рачун: издаје се рачун Промет Рефундација.

Рефундација се може издати и ручно: на Каси изаберите трансакцију Рефундација и сами упишите референтни број. Без референтног броја и ИД купца Откуцај не дозвољава издавање.

Исплата у готовини: потпис купца

Када се новац купцу враћа у готовини, после рефундације одмах издајте и Копију рефундације (дугме Копија на управо издатој рефундацији). Копија Рефундација штампа простор „Потпис купца“: купац се потписује при преузимању новца, а потписани примерак остаје продавцу као доказ исплате.

10.Поништавање погрешног рачуна

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

1. Отворите Рачуни, пронађите погрешан рачун и кликните Рефундација. Оставите све ставке и количине: поништава се цео рачун.
2. У поље ИД купца унесите 10: и свој ПИБ (нпр. 10:СВОЈПИБ).
3. Изаберите исти начин плаћања као на оригиналу и кликните Издај рачун.
4. Ако је купац и даље ту, издајте одмах нов, исправан рачун Промет Продаја.

11.Копија рачуна

Копија се издаје накнадно, из већ издатог рачуна: отворите рачун у регистру и кликните Копија. Откуцај аутоматски попуњава референтни број оригинала (без референтног броја копија није могућа) и издаје рачун врсте Копија кроз ПФР.

• Копија штампа „ОВО НИЈЕ ФИСКАЛНИ РАЧУН“ у двострукој величини слова и не улази у промет.
• Копија Рефундације штампа и простор „Потпис купца“ (поглавље 9).
• Типична употреба: купац је изгубио рачун, потребан је дупликат за рекламацију или књиговодство, потврда исплате рефундације.

12.Предрачун и конверзија у фискални рачун

Предрачун је понуда: пролази кроз ПФР као врста Предрачун, али није фискални рачун, не улази у промет и штампа „ОВО НИЈЕ ФИСКАЛНИ РАЧУН“. Издаје се са Касе избором врсте Предрачун.

Када купац прихвати понуду и плати:

1. Отворите предрачун у регистру рачуна.
2. Кликните Издај фискални рачун. Каса се отвара са свим ставкама предрачуна, а референтни број предрачуна је аутоматски попуњен.
3. Изаберите начин плаћања и кликните Издај рачун: издаје се нормалан рачун Промет Продаја.

13.Аванс

Авансни рачун се издаје када купац плати пре испоруке добра или услуге. Откуцај покрива цео животни циклус аванса: издавање, додатне уплате, и затварање у један клик.

Издавање авансног рачуна

1. На Каси изаберите врсту Аванс. Појављују се дугмад прописаних авансних ставки:

2. Кликните ставку по пореској стопи будуће испоруке. Количина је увек 1, а као цену унесите износ примљеног аванса.
3. Ако будућа испорука садржи робу по различитим стопама, додајте по једну авансну ставку за сваку стопу и поделите износ.
4. Изаберите начин плаћања (типично пренос на рачун) и издајте рачун Аванс Продаја.

ЕСИР време: уплате примљене раније

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

Додатни аванси

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

Затварање аванса у један клик

Када се роба испоручи или услуга изврши, отворите последњи авансни рачун у регистру и кликните Затвори аванс. Откуцај тада:

1. аутоматски издаје рачун Аванс Рефундација на укупан примљени износ, са референтним бројем авансног рачуна (овај рачун служи затварању и не предаје се купцу);
2. попуњава Касу за коначни рачун Промет Продаја: референтни број је попуњен, а у рекламном тексту аутоматски стоји број и датум последњег авансног рачуна.

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

14.Обука

Врста Обука служи за увежбавање особља и пробу опреме: рачун пролази цео ток као прави (ПФР, журнал, QR код, штампа), али штампа „ОВО НИЈЕ ФИСКАЛНИ РАЧУН“ у двострукој величини слова, не улази у промет и искључен је из свих извештаја. Користите Обуку за пробу штампача и после сваке промене ПФР режима (поглавље 18), пре првог правог рачуна.

15.Слање рачуна е-поштом и преузимање

На страници сваког рачуна у регистру доступно је:

• Пошаљи е-поштом: унесите адресу купца; Откуцај шаље журнал рачуна и линк за проверу. Погодно за онлајн продају и купце који не желе папир.
• Преузми .txt: журнал као текстуални фајл, нпр. за архиву или слање кроз друге канале.
• Штампај: штампа на термалном штампачу 58 или 80 mm или на A4; штампа се само рачун, без остатка екрана.
• PDF: у дијалогу штампе изаберите одредиште „Сачувај као PDF“ (или „Microsoft Print to PDF“) и рачун се чува као PDF документ.

16.Артикли

Мени Артикли је шифарник робе и услуга. Свако поље артикла:

CSV увоз и извоз

Дугмад Извоз CSV и Увоз CSV служе за масован рад са шифарником, нпр. пренос из старог програма или ажурирање цена у Excel-у. Формат: UTF-8, колоне раздвојене тачка-зарезом:

plu;name;unit;price;label;gtin;active;category
1001;Кока-кола 0,5 l;ком;180,00;Ђ;8600123456789;1;Пића

Ред са већ постојећим ПЛУ-ом ажурира тај артикал, ред са новим ПЛУ-ом додаје нов. Препоручен ток: Извоз CSV, измена у табеларном програму, Увоз CSV.

17.Извештаји

Мени Извештаји (администратор) нуди, за произвољан период:

• дневни промет;
• промет по пореским ознакама;
• промет по начину плаћања;
• промет по касиру;
• најпродаваније артикле.

Правила обрачуна: у промет улазе фискализовани рачуни врсте Промет и Аванс; рефундације умањују промет; Обука, Предрачун и Копија су у потпуности искључени. Свака табела има дугме Извези CSV: изаберите месец и проследите фајл књиговођи.

18.Подешавања

Мени Подешавања је доступан администратору и подељен је на одељке:

Подаци о обвезнику

ПИБ, пословно име, назив продајног места и адреса: штампају се у заглављу сваког рачуна. Проверите их пре првог рачуна.

ЕСИР број

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

ПФР режим

Избор процесора фискалних рачуна, са живим статусом везе (провера у реалном времену да ли ПФР одговара):

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

Режим плаћања

Стандардни режим (свих 7 начина) или режим по чл. 6 ст. 2 Правилника (поглавље 8). Једна инсталација ради искључиво у једном режиму.

Пореске ознаке

Преглед важећих ознака и стопа: Ђ 20%, Е 10%, Г 0%, А ван ПДВ. Стопе долазе искључиво из ПФР-а; апликација их не измишља нити дозвољава ручну измену обрачуна.

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

Отварање налога, додела улоге (администратор или касир), ресет лозинке, деактивација касира који више не ради. Овде се и одобравају налози пристигли са странице за регистрацију: такав налог је неактиван док га администратор не активира (поглавље 4).

АПИ кључеви

Генерисање и опозив кључева за интеграције (поглавље 20). Кључ се приказује само једном, при генерисању: одмах га сачувајте на сигурно место. Компромитован кључ одмах опозовите и генеришите нов.

Дневник активности

Хронолошки запис: ко је и када издао рачун, мењао артикле, подешавања, кориснике и кључеве, са временом и IP адресом.

О апликацији

Произвођач, назив и верзија ЕСИР-а, дугме Инсталирај апликацију (поглавље 3) и дугме Водич које поново покреће водич кроз прве кораке (поглавље 5).

Телеграм обавештења

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

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

Када је Телеграм подешен, на исту адресу стиже и обавештење о свакој новој регистрацији налога (поглавље 4).

19.Рад без интернета

Откуцај има три слоја рада без мреже, и важно је разумети шта који гарантује:

1. Апликација се отвара и офлајн (PWA)

Инсталирана апликација чува свој код и шифарник артикала локално у уређају. Каса се зато отвара и без интернета: артикли, претрага, корпа и отворени рачуни раде нормално.

2. Локални ред чекања

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

3. Потпуна офлајн фискализација: Л-ПФР

Једини начин да се рачуни фискализују без интернета је Л-ПФР на истом рачунару (localhost) или у локалној мрежи: локални процесор потписује рачуне офлајн, а податке Пореској управи испоручује накнадно, у року од 5 дана. В-ПФР, насупрот томе, захтева интернет за свако издавање: за рад без интернета користите Л-ПФР.

20.Интеграције: АПИ и WooCommerce

Откуцај АПИ v1

АПИ служи за издавање рачуна из веб продавница, ERP-а и других система. Аутентификација је Bearer кључем из Подешавања; ограничење је 240 захтева у минуту по кључу. Пуна спецификација са шемама захтева и одговора: /api-docs.

curl -H "Authorization: Bearer VAS_KLJUC" https://otkucaj.com/api/v1/status

Грешке долазе у облику {"error":{"code":"...","message":"..."}}:

WooCommerce додатак

За WordPress продавнице постоји готов додатак који аутоматски фискализује поруџбине:

1. Преузмите otkucaj-fiskalizacija.zip.
2. У WordPress управи: Додаци, Додај нови, Отпреми додатак; изаберите преузети zip, кликните Инсталирај, па Активирај.
3. У подешавањима додатка унесите: адресу Откуцаја (https://otkucaj.com), АПИ кључ (генерисан у Подешавањима Откуцаја), статус поруџбине који окида издавање рачуна (нпр. „Завршено“), и мапирање начина плаћања WooCommerce-а на фискалне начине плаћања.
4. По издавању, додатак у сваку поруџбину уписује ПФР број рачуна и линк за проверу, па су видљиви и трговцу и купцу.
5. Ако поједини производи иду по другој пореској ознаци, поставите им мета поље otkucaj_label (вредност: Ђ, Е, Г или А).

21.Безбедност и чување података

• Сав саобраћај иде искључиво преко HTTPS-а.
• Лозинке се чувају само као хешеви савременим алгоритмом; нико, ни администратор, не може прочитати туђу лозинку.
• Налози имају улоге са различитим правима (поглавље 4); подешавања и кључеви су доступни само администратору.
• Свака радња се бележи у дневник активности са временом и IP адресом.
• АПИ кључеви се приказују само једном и могу се опозвати у сваком тренутку.
• Ограничење броја захтева (rate limiting) штити и пријаву и АПИ од злоупотребе.
• Сви обрасци су заштићени од CSRF напада.
• База података се аутоматски архивира сваког дана.

22.Решавање проблема

23.Често постављана питања

Да ли је Откуцај одобрен од Пореске управе?
Откуцај је у поступку припреме пријаве за одобрење. До одобрења ради у демо режиму: рачуни носе ознаку ДЕМО и нису фискални. По одобрењу се уписује ЕСИР број и прелази на Л-ПФР или В-ПФР.

Морам ли нешто да инсталирам?
Не. Откуцај ради у прегледачу. Инсталација као апликација (PWA) је опциона и препоручена због рада без интернета и брже пречице.

Који штампач ми треба?
Било који термални штампач ролне 58 или 80 mm са драјвером за ваш систем, или обичан A4 штампач. Услов је само да QR код на папиру буде од 40 до 50 mm.

Шта се дешава кад нестане интернет?
Каса се и даље отвара и рачуни улазе у локални ред чекања, па се аутоматски издају по повратку везе. За потпуну офлајн фискализацију потребан је Л-ПФР; В-ПФР без интернета не ради (поглавље 19).

Погрешио сам рачун. Могу ли да га изменим?
Не, издати фискални рачун се не мења. Поништите га рефундацијом са сопственим ПИБ-ом као ИД купца, па издајте исправан рачун (поглавље 10).

Како да пренесем артикле из старог програма?
Извезите их у CSV и увезите у Откуцај (поглавље 16). За веће шифарнике то је посао од неколико минута.

Може ли више касира да ради истовремено?
Да. Сваки касир има свој налог, а име касира стоји на сваком рачуну. Један касир уз то може држати више отворених рачуна у картицама.

Ради ли Откуцај на телефону и таблету?
Да, екран касе је прилагођен додиру и малим екранима, а апликација се инсталира и на Android и на iPhone.

Како купац проверава рачун?
Скенирањем QR кода са рачуна, односно отварањем линка за проверу. Фискални рачуни се проверавају у систему Пореске управе (suf.purs.gov.rs); демо рачуни воде на демо проверу и јасно су означени.

Шта је ЕСИР број и одакле ми?
То је број под којим је ЕСИР уписан у регистар одобрених елемената фискализације. Додељује се при одобрењу; администратор га уписује у Подешавања и од тада се штампа на сваком рачуну.

24.Подршка

Е-пошта: [email protected]

Да бисмо помогли брзо, у пријави проблема наведите:

• назив обвезника и продајног места;
• ПФР режим (Демо, Л-ПФР или В-ПФР);
• тачан датум и време догађаја (нпр. 19.08.2026 у 14:35);
• ПФР број рачуна, ако се тиче конкретног рачуна;
• тачан текст поруке о грешци, а идеално и снимак екрана;
• кораке који су претходили проблему;
• уређај и прегледач (нпр. Windows 11, Chrome; Android, инсталирана апликација).

Званичне информације о фискализацији: purs.gov.rs. Погледајте и АПИ документацију, Политику приватности и Услове коришћења.