Vydané faktúry

Modul pre správu faktúr vygenerovaných z podkladov na fakturáciu. Umožňuje generovanie PDF faktúr, priradenie platieb, odosielanie emailom a export.

Zoznam vydaných faktúr

GET /api/accounting-basis-invoice

Oprávnenie: BASIS_INVOICE_LIST

Filtre (query parametre):

Parameter	Typ	Popis
`date_issue`	string (Y-m)	Dátum vystavenia - mesiac
`date_bill`	string (Y-m)	Dátum splatnosti - mesiac
`payment_status`	string	Stav platby: `paid`, `partially_paid`, `unpaid`

Odpoveď: Stránkovaný zoznam faktúr s informáciami o platbách, DPH a histórii odosielania.

Generovanie faktúr (hromadné)

POST /api/accounting-basis-invoice/invoices

Oprávnenie: BASIS_INVOICE_GENERATE

Vygeneruje PDF faktúry pre vybrané podklady.

Parameter	Typ	Povinný	Popis
`items`	array	áno	Zoznam UUID faktúr (min. 1)
`items.*`	string (uuid)	áno	UUID faktúry

Odpoveď: PDF súbor (pri viacerých faktúrach zlúčený do jedného PDF).

Generovanie jednej faktúry (PDF)

GET /api/accounting-basis-invoice/{uuid}/invoice

Oprávnenie: BASIS_INVOICE_GENERATE

Vygeneruje a stiahne PDF faktúru.

Odpoveď: PDF súbor zobrazený inline v prehliadači.

Zmazanie faktúry

DELETE /api/accounting-basis-invoice/{uuid}

Oprávnenie: BASIS_INVOICE_DELETE

Správa platieb k faktúram

Priradenie platby k faktúre

PUT /api/accounting-basis-invoice/payment/{payment_uuid}

Oprávnenie: BASIS_INVOICE_ASSIGN_PAYMENT

Parameter	Typ	Povinný	Popis
`document_uuid`	string (uuid)	áno	UUID faktúry

Zrušenie platby

DELETE /api/accounting-basis-invoice/{invoice_uuid}/payment/{payment_uuid}

Oprávnenie: BASIS_INVOICE_CANCEL_PAYMENT

Akceptovanie platby

PUT /api/accounting-basis-invoice/{invoice_uuid}/payment/{payment_uuid}/accept

Oprávnenie: BASIS_INVOICE_ACCEPT_PAYMENT

Potvrdí priradenie platby k faktúre.

Import faktúr

Nahranie importu

POST /api/accounting-basis-invoice/import

Oprávnenie: BASIS_INVOICE_IMPORT

Parameter	Typ	Povinný	Popis
`file`	file	áno	XML súbor s faktúrami

Zoznam importov

GET /api/accounting-basis-invoice/imports

Oprávnenie: BASIS_INVOICE_IMPORT

Vráti zoznam vykonaných importov s počtom naimportovaných faktúr.

Odosielanie faktúr emailom

Získanie emailových adries pre faktúru

GET /api/accounting-basis-invoice/{uuid}/sending-emails

Oprávnenie: BASIS_INVOICE_SENDING

Vráti emailové adresy, na ktoré sa má faktúra odoslať (z identifikačnej karty klienta).

Hromadné získanie emailov

POST /api/accounting-basis-invoice/sending-emails

Oprávnenie: BASIS_INVOICE_SENDING

Parameter	Typ	Povinný	Popis
`items`	array	áno	Zoznam UUID faktúr

Odoslanie faktúr emailom

POST /api/accounting-basis-invoice/send-emails

Oprávnenie: BASIS_INVOICE_SENDING

Parameter	Typ	Povinný	Popis
`emails`	array	áno	Zoznam emailov (min. 1)
`emails.*.uuid`	string (uuid)	áno	UUID faktúry
`emails.*.email`	string (email)	áno	Email príjemcu

Upomienky

Zoznam faktúr s upomienkami

GET /api/accounting-basis-invoice/reminder-issued

Oprávnenie: AB_INVOICE_REMINDER_LIST

Filtre:

Parameter	Typ	Popis
`per_page`	number	Počet záznamov na stránku
`page`	number	Číslo stránky
`sort_by_column`	string	Stĺpec na triedenie
`sort_by_order`	string	Smer: `asc` alebo `desc`
`search`	string	Vyhľadávanie
`date_issue`	string (Y-m)	Dátum vystavenia
`date_bill`	string (Y-m)	Dátum splatnosti
`is_paid`	boolean	Či je zaplatená
`reminder_issued_number`	integer	Číslo upomienky (1-3)

Zmena aktivity notifikácie upomienky

PUT /api/accounting-basis-invoice/reminder-issued/{uuid}/notify-activity

Oprávnenie: AB_INVOICE_REMINDER_NOTIFY_ACTIVITY

Parameter	Typ	Povinný	Popis
`activity`	boolean	áno	Zapnúť/vypnúť notifikácie

Export upomienok

POST /api/accounting-basis-invoice/reminder-issued/export

Oprávnenie: AB_INVOICE_REMINDER_LIST

Parameter	Typ	Povinný	Popis
`items`	array	áno	Zoznam UUID faktúr

Odpoveď: Excel súbor.

História emailov

GET /api/accounting-basis-invoice/{uuid}/mail-history/{type}

Oprávnenie: AB_INVOICE_REMINDER_MAIL_HISTORY

Vráti históriu odoslaných emailov pre danú faktúru podľa typu.

Export faktúr

POST /api/accounting-basis-invoice/export

Oprávnenie: BASIS_INVOICE_EXPORT

Parameter	Typ	Povinný	Popis
`items`	array	áno	Zoznam UUID faktúr

Odpoveď: Excel súbor.