Odmeny
Modul pre správu provízií a odmien. Odmeny môžu byť viazané na podklady na fakturáciu alebo vytvorené samostatne. Bežní používatelia vidia len svoje odmeny, admini vidia všetky.
Zoznam odmien
GET /api/reward
Oprávnenie: REWARD_LIST
Filtre (query parametre):
| Parameter | Typ | Popis |
|---|---|---|
created_at |
string (Y-m) | Mesiac vytvorenia |
payment_at |
string (Y-m) | Mesiac vyplatenia |
user |
string (uuid) | UUID používateľa |
Odpoveď: Zoznam odmien s informáciami o zákazke, sume, percentách a stave vyplatenia.
Vytvorenie odmeny
POST /api/reward
Oprávnenie: REWARD_CREATE
Parametre:
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
order_name |
string | áno | Názov zákazky (min. 3 znaky) |
order_price |
number | áno | Cena zákazky (min. 1) |
percentage |
integer | áno | Percento odmeny (1-99) |
payment_at |
string | nie | Dátum vyplatenia (formát: Y-m-d) |
user_uuid |
string (uuid) | podmienene* | UUID používateľa |
*Povinné pre adminov. Bežní používatelia nemusia zadávať - odmena sa priradí automaticky.
Suma odmeny (reward_price) sa vypočíta automaticky z order_price * percentage / 100.
Úprava odmeny
PUT /api/reward/{uuid}
Oprávnenie: REWARD_UPDATE
Parametre sú rovnaké ako pri vytvorení.
Úprava poznámky k odmene
PUT /api/reward/{uuid}/note
Oprávnenie: REWARD_UPDATE
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
note |
string | áno | Text poznámky |
Zmazanie odmeny
DELETE /api/reward/{uuid}
Oprávnenie: REWARD_DELETE
Export odmien do Excelu
POST /api/reward/export
Oprávnenie: REWARD_EXPORT
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
items |
array | áno | Zoznam ID odmien na export |
items.* |
integer | áno | ID odmeny |
deductions |
number | nie | Odpočty (min. 0) |
Odpoveď: Excel súbor s exportovanými odmenami.