# DigiPOS — упутство за инсталацију (ЕСИР) **С.О.К. доо Краљево** **ЕСИР:** DigiPOS вер. 2.0 **Краљево, јул 2026.** Инсталацију програма врши **власник / овлашћено лице на свом рачунару** (на даљину), или **С.О.К. доо Краљево** / одобрени инсталатер. Ово упутство описује **потпуно аутономну** инсталацију — **без доласка** у објекат власника. **Три режима рада касе** (иста апликација): 1. **Самостални** — нулта инсталација, локална SQLite база (`digipos.db`); без везе са ERP-ом. Каса на телефону (PWA) уз **В‑ПФР**. **Важно:** самостална инсталација сервера **на iPhone-у није могућа** (види одељак испод); на Android-у је могућа преко Termux-а или преко облака / PC. 2. **ERP у облаку — стална конекција** — сталан рад са ERP-ом; при прекиду везе прво офлајн, па синхронизација; 3. **ERP на захтев** — локални рад; синхронизација са ERP-ом кад се затражи. Испод је **самостална инсталација на даљину** на рачунару (режим 1). Режим 2 и 3 додају ERP подешавања (види **Упутство за конфигурацију** и техничко упутство §1.1). Одељак **Самостални на мобилном** описује употребу на телефону после подизања сервера. --- ## инсталација на даљину на рачунару (препоручено) Адреса: **https://digi-knjigovodstvo.rs/esir-setup/** Сервер DigiPOS инсталира се на **Windows** или **Linux** (x64). Телефон је касније само каса (PWA). ### Windows 10/11 (један клик) 1. На рачунару у објекту отворите горњу адресу (или пошаљите линк власнику). 2. Преузмите **`DigiPOS-ESIR-Setup.cmd`** и покрените га (ако Windows прикаже SmartScreen: *More info* → *Run anyway*). 3. Скрипт **сам** преузима пакет, инсталира аутостарт, покреће сервер и отвара прегледач на `http://localhost:3000`. 4. Одмах улазите у **прво подешавање**: - корак 1: фирма, ПИБ, објекат, врста (малопродаја / угоститељство); - корак 2: **В-ПФР / Л-ПФР** адресе, PIN или ПАК, опционо PFX, фискални штампач → **Сачувај и покрени**. 5. Пријава PIN-ом **1234** — одмах променити (Админ → Корисници). Инсталација се завршава у `%LOCALAPPDATA%\DigiPOS` (обично `C:\Users\\AppData\Local\DigiPOS`). ### Linux (x64) 1. Преузмите **`https://digi-knjigovodstvo.rs/download/digipos-linux-x64.tar.gz`**. 2. Распакујте: `tar -xzf digipos-linux-x64.tar.gz && cd digipos`. 3. Системски сервис: `sudo ./install.sh` → `/opt/digipos` или без root: `./install.sh --user` → `~/.local/share/digipos`. 4. Отворите `http://localhost:3000` (или IP рачунара) и завршите исто **прво подешавање**. 5. PIN **1234** — одмах променити. Пакет садржи уграђени Node и systemd јединицу. Потребан је **x86_64** Linux (ARM није у овом пакету). **Није потребан** одлазак сервисера у објекат кад власник има интернет, Windows или Linux x64 и податке за ПФР (или користи `DEMO` за обуку). --- ## Самостални на мобилном телефону (инсталација и употреба) DigiPOS се **може користити** као каса на мобилном телефону (PWA). Сервер (база + PFX ка В‑ПФР) увек мора негде да ради — на PC у објекту, хостовано у облаку, или (само Android) у Termux-у. > **НИЈЕ МОГУЋЕ: самостална инсталација на iPhone-у** > На iPhone / iPad **не може** да се инсталира DigiPOS сервер (Node + SQLite + PFX) као на > Windows-у или као на Android-у (Termux). iOS не дозвољава овај модел. > iPhone је **само клијент** (Safari → Додај на Почетни екран). Сервер + В‑ПФР морају бити на > **PC у објекту** или на **хостованој каси** (облак С.О.К.). > Не постоји `Setup` / APK / Termux еквивалент за самостални iPhone. ### А) Има рачунар у објекту (Windows / Linux) + телефон као каса | Корак | Шта урадити | |-------|-------------| | 1 | На рачунару инсталирајте DigiPOS (Windows Setup / ZIP или Linux tar.gz). | | 2 | Унесите **В‑ПФР** (URL, ПАК, PFX). | | 3 | На телефону отворите `http://:3000` (Chrome / Safari). | | 4 | **Додај на почетни екран** (PWA). | | 5 | Рад преко Wi‑Fi или мобилног интернета (ако је каса јавно доступна HTTPS). | ### Б) Само телефон — Android и iPhone (без рачунара у објекту) Иста **употреба** касе на Android и iPhone (PWA), али **инсталација сервера** није иста: - **Android:** могућ облак **или** самостални сервер на телефону (Termux, одељак В). - **iPhone:** самостална инсталација сервера на уређају је **немогућа**. Обавезан је облак или PC. За рад без PC у локалу: сервер + В‑ПФР у **облаку С.О.К.**; касиру само мобилни интернет. | Корак | Android | iPhone | |-------|---------|--------| | 1 | С.О.К. подиже хостовану HTTPS касу + В‑ПФР | исто | | 2 | Chrome → линк касе | Safari → линк касе | | 3 | ⋮ → **Инсталирај апликацију** / Додај на почетни екран | Дели → **Додај на Почетни екран** | | 4 | Пријава PIN-ом, рад касе | исто | Упутство: **https://digi-knjigovodstvo.rs/esir-setup/mobilni.html** Хостовање (оператер): `scripts/provision-cloud-kasa.sh` ### В) Android — сервер на самом телефону (Termux) Опционо, за техничаре: DigiPOS Node ради у Termux-у на Android-у (без облака и без PC). `bash <(curl -fsSL https://digi-knjigovodstvo.rs/esir-setup/install-android-termux.sh)` > **iPhone:** ова опција **не постоји**. Самостална инсталација на iPhone-у је **немогућа**. **Није обавезан** локални Л‑ПФР ни ERP. Штампа: мрежни / хостовани штампач, или `FILE` / преглед за тест. --- ## Предуслови 1. Рачунар са **Windows 10/11** (64 бита) **или Linux x64**, и приступом интернету (за преузимање). 2. Штампач (касније или у кораку 2): термални ESC/POS / мрежни; на Windows-у и било који Windows штампач; за тест: `FILE`. 3. **ПФР:** В-ПФР (URL + PFX + ПАК) и/или Л-ПФР (локална адреса + PIN), или `DEMO`. 4. **Безбедносни елемент** за продукцију: ПАК/PFX (В-ПФР) или smart-картица (Л-ПФР). --- ## Алтернатива — ручни пакет **Windows:** преузмите `digipos-windows-x64.zip` → распакујте → **`instaliraj.bat`**. **Linux:** видети одељак изнад (`digipos-linux-x64.tar.gz` → `./install.sh`). У прегледачу завршите исто **прво подешавање** (фирма → ПФР → штампач). ### Изворни код / развој `npm install` + `node server.js` / `start.bat` — за С.О.К. развој, не за типичну теренску поставку. --- ## После инсталације Даља фина подешавања (стопе после првог ПФР синхронизације, корисници, артикли) — **Упутство за конфигурацију**. Рад касира — **корисничко упутство**. --- *С.О.К. доо Краљево · DigiPOS · упутство за инсталацију (ЕСИР)*