FIS API - Prehľad systému
Čo je FIS?
FIS (Fiscal Information System) je interný fiškálny informačný systém pre správu účtovníctva, fakturácie, úloh, odmien a ďalších firemných procesov. Systém je postavený ako REST API s tokenovou autentifikáciou.
Hlavné moduly
| Modul | Popis |
|---|---|
| Účtovné doklady | Správa faktúr, príjmov, miezd a leasingov |
| Podklady na fakturáciu | Vytváranie podkladov, z ktorých sa generujú faktúry |
| Vydané faktúry | Generovanie, odosielanie a správa faktúr z podkladov |
| Odmeny | Evidencia provízií a odmien viazaných na podklady |
| Úlohy | Kanban board pre správu úloh a projektov |
| Nástenka / Novinky | Interné správy a oznámenia pre zamestnancov |
| Identifikačné karty klientov | Evidencia klientov s IČO, DIČ a kontaktnými údajmi |
| Prijaté faktúry | Zoznam faktúr prijatých od dodávateľov |
| Odmeny | Evidencia a export províznych odmien |
Autentifikácia
Systém používa tokenovú autentifikáciu (Laravel Sanctum). Po prihlásení dostanete Bearer token, ktorý musíte posielať v hlavičke každej požiadavky:
Authorization: Bearer {váš_token}
Roly a oprávnenia
Systém má 6 rolí:
| Rola | Popis |
|---|---|
| ADMIN | Plný prístup do celého systému |
| BTS | Obchodné operácie |
| ENVIRO | Environmentálne / facility management |
| EKO | Ekonomika a účtovníctvo |
| SERVIS | Servis a údržba |
| SEKRE | Sekretariát a administrácia |
Každý endpoint vyžaduje špecifické oprávnenie. Ak nemáte požadované oprávnenie, API vráti chybu 403.
Formát odpovedí
API vracia odpovede v JSON formáte. Zoznamy sú stránkované a obsahujú metadáta o stránkovaní. Dátumy sa používajú vo formáte d.m.Y (napr. 27.03.2026) pre vstup a Y-m-d pre niektoré filtre.
Nahlásenie problému
Ak narazíte na chybu v systéme, môžete ju nahlásiť cez endpoint POST /api/report-problem s popisom problému a cestou (URL) kde sa chyba vyskytla.