# DigiPOS

Uputstvo za korišćenje · administrator, konobar, kasir, kuvar

Generisano iz UPUTSTVO.md

# DigiPOS — корисничко упутство

С.О.К. доо Краљево · ЕСИР DigiPOS вер. 2.0 · јул 2026.

Ово упутство прати све примере из ЕСИР досијеа (део 17 / sandbox V-ПФР). За сваки тип рачуна дати су:

1. слике екрана (како се ради на каси),
2. исечак као у досијеу (термални изглед, 80 mm).

Програм ради у прегледачу на рачунару, таблету или телефону. У режиму standalone

са подешеним В-ПФР параметрима каса може самостално да ради и на мобилном

уређају. Инсталација / конфигурација: посебна упутства.

## Садржај

1. Покретање, пријава, улоге
2. Три режима рада касе
3. Администрација и пореске стопе
4. Каса — основни екрани
5. Примери из досијеа (корак по корак + слике)
6. Ресторан и кухиња
7. Извештаји
8. Преглед слика

## 1. Покретање, пријава, улоге

1. Покрените `start.bat` → отворите http://localhost:3000 (каса) или /admin.
2. При пријави апликација аутоматски проверава везу са L-ПФР / V-ПФР (10-П2). Ако веза није успостављена, појављује се црвена трака — клик на обавештење поново покушава конекцију. Без везе продаја (наплата, аванс, копија, рефундација) се не наставља. Ручно: Admin → Подешавања → Провери LPFR.

Улога | Наплата | Копија | Реф. | Admin
--- | --- | --- | --- | ---
Конобар | да | да | не | не
Касир | да | да | да | не
Админ | да | да | да | да
Кувар | — | — | — | само Кухиња

Почетни PIN 1234 — одмах променити.

## 2. Три режима рада касе

DigiPOS ради у сва три режима. Касир исти програм; разликује се веза са ERP-ом:

# | Режим | Шта значи за корисника
--- | --- | ---
1 | Standalone | Каса на једном рачунару, локална база (`digipos.db`). Цене и артикли у Admin → Artikli (види §3.1). Увоз/извоз по потреби. Без везе са ERP-ом.
2 | ERP у cloudu — стална конекција | Каса је стално повезана са ERP-ом у cloudu. Ако нестане интернет, наставља локално; по враћању везе sync.
3 | ERP на захтев | Каса ради локално; синхронизација са ERP-ом кад се затражи (Админ → Подешавања → Синхронизација) — није стално online.

Тип објекта (засебно од горњег): у Подешавањима `restoran` (столови, кухиња) или `prodavnica` (брза каса). Оба типа раде у сва три режима.

Фискални рад (наплата, аванс, обука, копија, рефундација) исти је у свим режимима — захтева везу са L/V-ПФР.

## 3. Администрација и пореске стопе

1. Корисници — PIN, улоге.
2. Подешавања — тип објекта `restoran` / `prodavnica` (види §2 и три режима рада), власник, објекат, LPFR, штампач. ESIR број је трајно уграђен у верзију (не мења се на каси). У режиму 2/3: подешавања везе са ERP-ом (стална или на захтев).
3. Пореске стопе — при првом успешном повезивању са ПФР-ом преузимају се аутоматски.

По потреби: Шифарник пореских стопа → Преузми стопе са ПФР-а → ERP група → ознака → Сачувај.

1. Артикли — цена, баркод (GTIN), пореска група, ЈМ.

### 3.1 Промена цене у standalone режиму

У режиму 1 (Standalone) цене се воде у самој каси — поље Maloprodajna cena је изменљиво.

1. Отворите http://localhost:3000/admin и пријавите се као админ.
2. Таб Artikli.
3. Кликни на ред артикла (или Dodaj за нови).
4. У модалу унесите / измените Maloprodajna cena.
5. Sačuvaj.

На каси одмах важи нова цена при следећем додавању у корпу.

Напомена: у режимима са ERP-ом (2 и 3) цена на овом екрану је често read-only — води се у књиговодству / нивелацијом по објекту, не ручно на каси.

Без мапирања стопа продаја се одбија.

## 4. Каса — основни екрани

Продавница: скенирај / кликни артикал → NAPLATI → плаћање (+ опционо купац) → ИЗДАЈ РАЧУН.

Аванс: дугме Avans → узми аванс, па касније Zatvori robom (види 4.11–4.13).

## 5. Примери из досијеа — како се ради

Испод сваког примера: (А) екран на каси → (Б) исечак из досијеа.

Датотеке исечака: `sertifikacija-sandbox/png/` (исто као у досијеу).

### 4.1 Промет Продаја (ПП) — упитник П11 · `01-PP`

Циљ: обичан промет, само готовина.

1. Додајте ставке у корпу.
2. NAPLATI → пун износ у Готовина, остала плаћања празна.
3. Купац = без → ИЗДАЈ РАЧУН.

А — екран наплате (готовина):

Б — исечак:

### 4.2 Вишеструко плаћање — `02-PP-mix`

1. Додајте ставке → NAPLATI.
2. Део у Готовина, остатак у Картица (збир ≥ укупно).
3. ИЗДАЈ РАЧУН.

А — екран (mix):

Б — исечак:

### 4.3 Вирман (пренос) + купац — `03-PP-virman`

1. NAPLATI → пун износ у Пренос на рачун.
2. Купац: тип 10 PIB + ПИБ.
3. ИЗДАЈ РАЧУН.

А — екран:

Б — исечак:

### 4.4 Промет + ПИБ купца — упитник П1 · `04-PP-kupac`

1. NAPLATI → плаћање.
2. Купац: 10 PIB + број ПИБ-а.
3. ИЗДАЈ РАЧУН — на исечку ред ИД купца.

А — екран:

Б — исечак:

### 4.5 Промет + ЈБКЈС — П1б · `14-PP-jbkjs`

1. NAPLATI.
2. Купац: 12 PIB+JBKJS, у поље `ПИБ:ЈБКЈС` (нпр. `100000003:12345`).
3. ИЗДАЈ РАЧУН.

А — екран:

Б — исечак:

### 4.6 Промет Рефундација (ПР) — `05-PR`

1. Таб Рачуни → датум → промет који сторнирате.
2. Refundacija (касир / админ) → потврдите.
3. Штампа ПР са референцом на оригинални ПФР број.

А — екран:

Б — исечак:

### 4.7 Копија Продаје (КП) — упитник П12 · `06-KP`

1. Рачуни → промет (или аванс).
2. Kopija.
3. На исечку: ОВО НИЈЕ ФИСКАЛНИ РАЧУН.

А — екран:

Б — исечак:

### 4.8 Копија Рефундације (КР) — `07-KR`

1. Рачуни → ранија рефундација.
2. Kopija.

А — екран:

Б — исечак:

### 4.9 Предрачун Продаја (РП) — упитник П13 · `08-RP`

1. Ресторан: отворите сто → артикли у корпу.
2. Предрачун (не наплата).

А — екран:

Б — исечак:

### 4.10 Обука (ОП) — тачка 8 матрице · упитник П14 · `09-OP`

Обавеза за контролу ПУРС-а: ЕСИР мора да издаје тип документа Обука (`invoiceType` 3). То није фискални промет — на исечку стоји ОВО НИЈЕ ФИСКАЛНИ РАЧУН; служи за обуку особља и демонстрацију без књижења промета.

#### Корак по корак — Обука Продаја

1. Додајте ставке у корпу (продавница) или на столу (ресторан).
2. NAPLATI → унесите плаћање као иначе (готовина / картица / …).
3. Обавезно укључите опцију Obuka — nije fiskalni račun.
4. Дугме постаје зелено ИЗДАЈ ОБУКУ (уместо „ИЗДАЈ РАЧУН“) → кликните.
5. Штампа се Обука Продаја (ОП).
6. У табу Računi тип је Obuka. У ресторану сто остаје отворен (обука није наплата).

А — екран наплате (обука укључена):

А2 — исто + ИД купца (П7):

А3 — евиденција на каси:

Б — исечак из досијеа:

#### Обука Рефундација (П8)

1. Računi → изаберите ранију Obuka (продаја).
2. Refundacija → потврдите.
3. Издаје се Обука / REF (исти `invoiceType` 3, `transactionType` 1) — и даље није фискални промет.

А — екран (дугме Refundacija уз Obuka):

### 4.11 Аванс Продаја (АП) — упитник П15 · `10-AP`

Корак 1 — узми аванс (купци уплате део цене унапред):

1. На каси кликните Avans.
2. Изаберите пореску ознаку и износ.
3. Uzmi avans → штампа се Аванс Продаја (АП).

А — екран (узми аванс):

Б — исечак АП:

### 4.12–4.13 Како се аванс затвара коначним рачуном · `11-AR` + `12-PP-avans`

По спецификацији 9.1, једно дугме Zatvori robom шаље ПФР-у два документа:

Редослед | Тип | Штампа купцу | Значење
--- | --- | --- | ---
1 | Аванс Рефундација (АР) | не (интерно) | затвара / поништава авансни рачун АП
2 | Промет Продаја (ПП) | да | коначни рачун са правом робом; купац плаћа само разлику (укупно − аванс)

Корак 2 — роба у корпу:

1. Додајте у корпу артикле који се испоручују (укупна цена ≥ уплаћени аванс).

Корак 3 — затвори аванс:

1. Поново Avans → у табели Otvoreni avansi кликните Zatvori robom.
2. ЕСИР издаје АР (без штампе купцу) па одмах коначни ПП.

Б — исечци из досијеа:

### 4.14 GTIN (баркод) + нулта стопа — `13-PP-gtin`

1. Admin → Артикли — унесите баркод (GTIN) и пореску групу мапирану на ПФР.
2. На каси скенирајте / додајте артикал → NAPLATI → ИЗДАЈ РАЧУН.

А — екрани:

Б — исечак:

## 6. Ресторан и кухиња

Дугме | Значење
--- | ---
Пошаљи | у кухињу
Предрачун | види 4.9
Наплати | промет (4.1–4.5)
Avans | види 4.11–4.13

## 7. Извештаји

Таб Извештај / Admin → датум → промет, рефундације. На крају смене: Одјава.

## 8. Преглед слика UI

Слика | Пример / опис
--- | ---
14-prodavnica-kasa | Каса (дугме Avans)
20-naplata-gotovina | 4.1 ПП готовина
21-naplata-mix | 4.2 вишеструко
22-naplata-virman | 4.3 вирман + купац
23-naplata-kupac-pib | 4.4 ПИБ
24-naplata-jbkjs | 4.5 ЈБКЈС
07-racuni | 4.6–4.8 реф / копија
03-porudzbina-sto | 4.9 предрачун
25-naplata-obuka | 4.10 обука — ИЗДАЈ ОБУКУ
28-naplata-obuka-kupac | 4.10 обука + ПИБ (П7)
29-racuni-obuka | 4.10 листа Računi тип Obuka + Refundacija
15-avans-uzmi | 4.11 узми аванс
17-avans-korpa-roba | 4.12 роба пре затварања
16-avans-zatvori | 4.12–4.13 Zatvori robom
26 / 27 | 4.14 корпа / артикли GTIN
`sertifikacija-sandbox/png/*` | исечци из досијеа

*С.О.К. доо Краљево · DigiPOS · корисничко упутство (прати досије део 17)*

`npm run docs:korisnicko` → `DigiPOS-ESIR-korisnicko.odt`