# DigiPOS

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

Generisano iz UPUTSTVO.md

# DigiPOS — упутство за конфигурацију (ЕСИР)

С.О.К. доо Краљево

ЕСИР: DigiPOS вер. 2.0

Краљево, јул 2026.

## Конфигурација

Након инсталације, програм се покреће преко `start.bat` (или иконе на радној површини).

Конфигурацију система ради искључиво С.О.К. доо Краљево или од њега одабрани инсталатер са Уговором о пружању услуга.

1. Отворите администрацију: http://localhost:3000/admin
2. Пријавите се PIN-ом администратора (почетни PIN 1234 — одмах променити).

1. Изаберите картицу Подешавања. Попуните потребне податке и кликните Сачувај.

Поље | Шта унети
--- | ---
Режим рада (инсталација) | Један од три: (1) standalone, (2) ERP у cloudu — стална конекција, (3) ERP на захтев — види техничко §1.1
Тип објекта (UI) | `restoran` или `prodavnica` — у сва три режима
Власник | Фирма (обвезник) — након повезивања са ПФР-ом поља се допуњују аутоматски (види доле)
Објекат | Продајно место
ESIR број | Уграђен у апликацију након одобрења ПУРС-а — види се у подешавањима, не може се мењати
LPFR адреса | URL API v3 са `/` на крају, или `DEMO` за обуку/тест
LPFR PIN / ПАК | PIN за Л-ПФР, или ПАК за В-ПФР дигитални сертификат
V-ПФР PFX (опционо) | Путања до клијентског сертификата (празно = Л-ПФР)
Фискални штампач | Тачно име Windows штампача (било који драјвер), `FILE` (проба у `prints\`) или `NONE`

1. После чувања, каса и админ аутоматски проверавају везу са ПФР-ом (црвена трака ако не успе; клик = поновни покушај). Ручни тест: Провери LPFR. Ако веза није успостављена — исправите адресу/PIN/сертификат; продаја се не наставља док веза не буде исправна.

### Прво повезивање са ПФР-ом (аутоматски sync)

Чим је веза са ПФР-ом успешна (прва пријава / први успешан `GET /api/lpfr/status`), DigiPOS одмах преузима:

Шта | Извор | Локално
--- | --- | ---
Пореске стопе и фискалне ознаке | `currentTaxRates` из `/status` | мапа ERP група → ознака (`tax_labels`)
Назив обвезника, ПИБ, назив објекта, адреса / место | поља из `/status` или, ако их тамо нема, из одговора на први потписани рачун | `vlasnik` / `objekti` (приказ у Admin)

DigiPOS не измишља стопе ни податке обвезника — само оно што врати ПФР (или DEMO симулатор).

Касније у Подешавањима / шифарнику можете локално исправити приказ (мапе стопа, назив фирме…). То не мења садржај фискалног исечка:

> На фискалном исечку иду само подаци које врати ПФР у одговору на рачун (ПИБ, назив, објекат, адреса, стопе, QR…). Локална измена у Admin-у служи за приказ и рад програма, не за заглавље исечка.

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

1. Корисници — промените PIN 1234, додајте запослене (име, PIN, улога).

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

Ресторан: по потреби Столови.

#### Промена цене (standalone)

У режиму Standalone (без ERP-а):

1. Admin → Artikli → изаберите артикал.
2. Поље Maloprodajna cena — унесите нову цену (поље је изменљиво само у standalone).
3. Sačuvaj.

У режимима са ERP-ом (стална веза / на захтев) цене се мењају у ERP-у / нивелацијом — на каси су read-only.

Тиме је основна конфигурација завршена. Даљи рад касира / конобара описан је у корисничком упутству.

### Три режима рада (нагласак)

# | Режим | Када се бира
--- | --- | ---
1 | Standalone | Почетни setup „Pokreni standalone“ / SQLite — без везе са ERP-ом; са В-ПФР параметрима и на мобилном
2 | ERP у cloudu — стална конекција | Каса ↔ ERP у cloudu стално; offline само кад нема везе
3 | ERP на захтев | Подешавања → Синхронизација са централом — sync кад се затражи

Фискални захтеви (ПФР, стопе, рачуни) исти су у сва три режима.

*С.О.К. доо Краљево · DigiPOS · упутство за конфигурацију (ЕСИР)*

Технички детаљи API: `docs/ESIR-TEHNICKO-UPUTSTVO.md`