Funkcie na prácu s faktúrami. Umožňujú získanie zoznamu faktúr, detailu konkrétnej faktúry, vytvorenie novej faktúry s položkami a vygenerovanie jej PDF/HTML reprezentácie.
Rozhranie dodáva zoznam faktúr vystavených v systéme.
firma_id1).osoba_id).{
"items": [
{
"faktura_id": 124,
"datum": "2026-05-21T00:00:00.000Z",
"datum_splatnosti": "2026-06-04T00:00:00.000Z",
"datum_dodania": "2026-05-21T00:00:00.000Z",
"cislo": "FV260001",
"rok": 2026,
"pcrok": 1,
"typ_id": 1,
"firma_id": 12,
"osoba_id": null,
"cena": 1080.0,
"cena_zaklad": 900.0,
"cena_dph": 180.0,
"zrusena": false,
"uhradena": true,
"datum_zaplatene": "2026-05-21T00:00:00.000Z",
"poznamka": "Faktúra za programátorské práce",
"spis_id": 45,
"objednavka_id": 89
}
],
"paging": {
"offset": 0,
"limit": 100,
"maximum": 1
}
}
Rozhranie dodáva detail konkrétnej faktúry vrátane jej položiek.
faktura_id).{
"faktura_id": 124,
"datum": "2026-05-21T00:00:00.000Z",
"datum_splatnosti": "2026-06-04T00:00:00.000Z",
"datum_dodania": "2026-05-21T00:00:00.000Z",
"cislo": "FV260001",
"rok": 2026,
"pcrok": 1,
"typ_id": 1,
"firma_id": 12,
"osoba_id": null,
"cena": 1080.0,
"cena_zaklad": 900.0,
"cena_dph": 180.0,
"zrusena": false,
"uhradena": true,
"datum_zaplatene": "2026-05-21T00:00:00.000Z",
"poznamka": "Faktúra za programátorské práce",
"spis_id": 45,
"objednavka_id": 89,
"items": [
{
"pc": 1,
"karta_id": null,
"nazov": "Analýza a návrh",
"mj": "hod",
"mnozstvo": 2,
"cenamj": 50,
"cenazlava": 50,
"cenamjsum": 100,
"zlava": 0,
"dph": 20,
"dphmj": 10,
"dphsum": 20,
"sumcena": 120,
"sumcenamj": 60
},
{
"pc": 2,
"karta_id": null,
"nazov": "Implementácia",
"mj": "hod",
"mnozstvo": 10,
"cenamj": 80,
"cenazlava": 80,
"cenamjsum": 800,
"zlava": 0,
"dph": 20,
"dphmj": 16,
"dphsum": 160,
"sumcena": 960,
"sumcenamj": 96
}
]
}
Rozhranie vytvorí novú faktúru s položkami v databáze.
Súvisiace skladové operácie
Ak položka faktúry obsahuje karta_id (id skladovej karty), systém na pozadí vykoná nasledujúce operácie:
nazov, mj a dph sa automaticky načítajú z globálnej skladovej karty (obch_skarta).druh_id = 2, pohybtyp_id = 2 - Výdaj) na hlavnom sklade (sklad_id = 1).obch_sklad_karta, automaticky sa vytvorí nové priradenie s počiatočným množstvom 0.mnozstvo, mnozstvo_hypot) v tabuľke obch_sklad_karta pre daný sklad.mnozstvo, mnozstvo_hypot) na hlavnej skladovej karte v tabuľke obch_skarta ako sumu množstiev zo všetkých priradených skladov.obch_fakturap) s vygenerovaným skladovým pohybom (pohyb_id) a jeho položkou (pohybpolozka_id).firma_id alebo osoba_id s hodnotou väčšou ako 0.popis.false) - Ak je true, faktúra sa automaticky označí ako uhradená a nastaví sa jej dátum zaplatenia.nazov, mj, dph) zo skladovej karty. Karta nesmie byť vymazaná (zrusena).karta_id) - Názov položky.karta_id) - Merná jednotka (napr. "ks", "hod").1 pri výpočte) - Množstvo.0) - Zľava v percentách (0 - 100).karta_id) - Sadzba DPH v % (napr. 23).Pri tejto faktúre nie je definované karta_id. Pre každú položku je nutné zaslať textový nazov, mernú jednotku mj a sadzbu dph.
{
"firma_id": 12,
"popis": "Faktúra za programátorské práce",
"uhradene": true,
"items": [
{
"nazov": "Analýza a návrh",
"mnozstvo": 2,
"cena": 50,
"mj": "hod",
"dph": 23
},
{
"nazov": "Implementácia",
"mnozstvo": 10,
"cena": 80,
"mj": "hod",
"dph": 23
}
]
}
Ak je definované karta_id, hodnoty nazov, mj a dph sa automaticky doplnia zo skladovej karty. Systém automaticky vygeneruje výdajku a odpočíta tovar z hlavného skladu (sklad_id = 1).
{
"firma_id": 12,
"popis": "Faktúra s odpisom tovaru z hlavného skladu",
"items": [
{
"karta_id": 15,
"mnozstvo": 5,
"cena": 12.50
}
]
}
Každá položka môže definovať parameter sklad_id, z ktorého sa má tovar odobrať. Systém automaticky zoskupí položky a pre každý unikátny sklad vygeneruje samostatný skladový pohyb (výdajku).
{
"firma_id": 12,
"popis": "Faktúra s odpisom tovaru z viacerých skladov",
"items": [
{
"karta_id": 15,
"sklad_id": 1,
"mnozstvo": 3,
"cena": 12.50
},
{
"karta_id": 16,
"sklad_id": 2,
"mnozstvo": 2,
"cena": 24.00
}
]
}
{
"id": 124
}
Rozhranie vygeneruje vizuálnu reprezentáciu faktúry (HTML alebo PDF) na základe preddefinovanej šablóny v systéme a vyplnených dát faktúry.
pdf (alebo ak parameter chýba) - Vráti priamo binárne PDF (Content-Type: application/pdf).json - Vráti JSON objekt s base64 zakódovaným PDF v parametri pdf.html - Vráti vygenerovaný HTML dokument s Content-Type: text/html (vhodné pre náhľady).faktura_optivus.{
"id": 124,
"format": "json"
}
{
"pdf": "JVBERi0xLjQKJdPr6gok..."
}
{
"id": 124,
"format": "pdf"
}
Odpoveďou je priamo binárny tok dát PDF dokumentu s hlavičkou:
Content-Type: application/pdf