Účtovné doklady

Modul pre správu účtovných dokladov - faktúr, príjmov (bločkov), miezd a leasingov.

Zoznam účtovných dokladov

GET /api/accounting-document

Oprávnenie: ACCOUNTING_DOCUMENT_LIST

Filtre (query parametre):

Parameter	Typ	Popis
`filter_date`	string	Typ dátumu na filtrovanie: `service_delivery_date`, `invoice_date`, `due_date`, `payment_date`
`date`	string (Y-m)	Mesiac na filtrovanie, napr. `2026-03`
`payment_status`	string	Stav platby: `paid`, `partially_paid`, `unpaid`
`done_status`	string	Stav vybavenia: `finished`, `unfinished`
`type`	string	Typ dokladu: `invoice`, `receipt`, `wage`, `leasing`

Odpoveď: Stránkovaný zoznam účtovných dokladov s informáciami o platbách, prílohách a stavoch.

Vytvorenie príjmu (bločku)

POST /api/accounting-document/receipt

Oprávnenie: ACCOUNTING_DOCUMENT_CREATE

Parametre:

Parameter	Typ	Povinný	Popis
`ico`	string	áno	IČO dodávateľa (presne 8 znakov)
`supplier_name`	string	áno	Názov dodávateľa
`price`	number	áno	Celková suma (min. 0)
`payment_type`	string	áno	Typ platby: `cash` alebo `card`
`service_delivery_date`	string	áno	Dátum dodania služby (formát: `d.m.Y`)
`receipt_number`	string	nie	Číslo bločku (musí byť unikátne)
`note`	string	nie	Poznámka
`items`	array	nie	Položky bločku
`items.*.name`	string	áno*	Názov položky
`items.*.quantity`	number	áno*	Množstvo
`items.*.vat_rate`	number	áno*	Sadzba DPH
`items.*.price`	number	áno*	Cena
`accounting_data`	object	nie	Účtovné údaje o DPH
`accounting_data.vat_rate_basic`	number	nie	Základná sadzba DPH
`accounting_data.tax_base_basic`	number	nie	Základ dane (základná sadzba)
`accounting_data.vat_amount_basic`	number	nie	Suma DPH (základná sadzba)
`accounting_data.vat_rate_reduced`	number	nie	Znížená sadzba DPH
`accounting_data.tax_base_reduced`	number	nie	Základ dane (znížená sadzba)
`accounting_data.vat_amount_reduced`	number	nie	Suma DPH (znížená sadzba)
`accounting_data.free_tax_amount`	number	nie	Suma oslobodená od dane

*Povinné ak je pole items vyplnené.

Overenie bločku (eKasa)

GET /api/accounting-document/{receiptUid}/check

Oprávnenie: ACCOUNTING_DOCUMENT_CREATE

Overí bloček cez eKasa systém podľa UID kódu z bločku.

Odpoveď: Vráti údaje z bločku - cenu, IČO, dodávateľa, dátum a položky.

Vytvorenie faktúry

POST /api/accounting-document/invoice

Oprávnenie: ACCOUNTING_DOCUMENT_CREATE

Parametre:

Parameter	Typ	Povinný	Popis
`ico`	string	áno	IČO dodávateľa (8 znakov)
`supplier_name`	string	áno	Názov dodávateľa
`supplier_address`	string	áno	Adresa dodávateľa
`supplier_bank_account`	string	áno	Bankový účet dodávateľa
`service_delivery_date`	string	áno	Dátum dodania (formát: `d.m.Y`)
`invoice_date`	string	áno	Dátum vystavenia faktúry (formát: `d.m.Y`)
`due_date`	string	áno	Dátum splatnosti (formát: `d.m.Y`)
`vs`	number	áno	Variabilný symbol (unikátny v rámci IČO a dátumu)
`price`	number	áno	Suma (min. 0)
`note`	string	nie	Poznámka
`file`	file	nie	Príloha (súbor faktúry)
`receiving_invoice`	string (uuid)	nie	UUID prijatej faktúry na prepojenie

Vytvorenie leasingu

POST /api/accounting-document/leasing

Oprávnenie: ACCOUNTING_DOCUMENT_LEASING_CREATE

Parametre:

Parameter	Typ	Povinný	Popis
`ico`	string	áno	IČO (8 znakov)
`supplier_name`	string	áno	Názov dodávateľa
`supplier_address`	string	áno	Adresa
`supplier_bank_account`	string	áno	Bankový účet
`service_delivery_date`	string	áno	Dátum dodania (formát: `d.m.Y`)
`invoice_date`	string	áno	Dátum vystavenia (formát: `d.m.Y`)
`due_days`	integer	áno	Počet dní splatnosti (min. 1)
`vs`	number	áno	Variabilný symbol
`price`	number	áno	Suma (min. 0)
`start_at`	string	áno	Začiatok leasingu (formát: `d.m.Y`)
`end_at`	string	áno	Koniec leasingu (formát: `d.m.Y`, musí byť po `start_at`)
`note`	string	nie	Poznámka
`file`	file	nie	Príloha

Úprava leasingu

PUT /api/accounting-document/leasing/{uuid}

Oprávnenie: ACCOUNTING_DOCUMENT_LEASING_EDIT

Parametre:

Parameter	Typ	Povinný	Popis
`price`	number	áno	Nová suma (min. 0)

Úprava faktúry

PUT /api/accounting-document/{uuid}/invoice

Oprávnenie: ACCOUNTING_DOCUMENT_INVOICE_UPDATE

Parametre:

Parameter	Typ	Povinný	Popis
`due_date`	string	áno	Dátum splatnosti (formát: `Y-m-d`)
`invoice_date`	string	áno	Dátum vystavenia (formát: `Y-m-d`)
`service_delivery_date`	string	áno	Dátum dodania (formát: `Y-m-d`)
`price`	number	áno	Suma (min. 0)
`supplier_bank_account`	string	áno	Bankový účet
`vs`	number	áno	Variabilný symbol

Správa platieb

Zoznam nepriradených platieb

GET /api/accounting-document/payment

Oprávnenie: ACCOUNTING_DOCUMENT_PAYMENT_LIST

Filtre:

Parameter	Typ	Popis
`date_from`	date	Dátum od
`date_to`	date	Dátum do

Nahranie súboru s platbami

POST /api/accounting-document/upload

Oprávnenie: ACCOUNTING_DOCUMENT_PAYMENT_UPLOAD

Nahrá CSV súbor s bankovými platbami na importovanie do systému.

Parameter	Typ	Povinný	Popis
`file`	file	áno	CSV súbor (formáty: text/csv, text/plain, application/vnd.ms-excel)

Priradenie platby k dokladu

PUT /api/accounting-document/payment/{payment_uuid}/document

Oprávnenie: ACCOUNTING_DOCUMENT_PAYMENT_ASSIGN

Parameter	Typ	Povinný	Popis
`document_uuid`	string (uuid)	áno	UUID účtovného dokladu

Zrušenie platby z dokladu

DELETE /api/accounting-document/{document_uuid}/payment/{payment_uuid}

Oprávnenie: ACCOUNTING_DOCUMENT_PAYMENT_CANCEL

Zrušenie manuálnej platby

DELETE /api/accounting-document/{document_uuid}/payment

Oprávnenie: ACCOUNTING_DOCUMENT_PAYMENT_CANCEL

Zmazanie platby

DELETE /api/accounting-document/payment/{payment_uuid}

Oprávnenie: ACCOUNTING_DOCUMENT_PAYMENT_DELETE

Zmena typu platby

PUT /api/accounting-document/{uuid}/update-payment-type

Oprávnenie: ACCOUNTING_DOCUMENT_PAYMENT_TYPE_CHANGE

Parameter	Typ	Povinný	Popis
`payment_type`	string	áno	Typ platby: `cash` alebo `card`

Zmena stavu na vybavený/nevybavený

PUT /api/accounting-document/{uuid}/done

Oprávnenie: ACCOUNTING_DOCUMENT_IS_DONE_CHANGE

Parameter	Typ	Povinný	Popis
`action`	boolean	áno	`true` = vybavený, `false` = nevybavený

Úprava poznámky

PUT /api/accounting-document/{uuid}/note

Oprávnenie: ACCOUNTING_DOCUMENT_NOTE_CHANGE

Parameter	Typ	Povinný	Popis
`note`	string	nie	Text poznámky

Správa príloh

Pridanie prílohy

POST /api/accounting-document/{uuid}/file

Oprávnenie: ACCOUNTING_DOCUMENT_FILE_ADD

Parameter	Typ	Povinný	Popis
`file`	file	áno	Súbor na priloženie

Zmazanie prílohy

DELETE /api/accounting-document/{uuid}/file/{media_uuid}

Oprávnenie: ACCOUNTING_DOCUMENT_FILE_DELETE

Import miezd

POST /api/accounting-document/import-wages

Oprávnenie: ACCOUNTING_DOCUMENT_WAGE_IMPORT

Importuje mzdové údaje zo XML súboru.

Parameter	Typ	Povinný	Popis
`file`	file	áno	XML súbor s mzdovými údajmi