Payload pre vytvorenie faktúry. V bežnom prípade stačí poslať clientId a items; ostatné polia môže backend dopočítať. Musíte poslať buď clientId, alebo objekt client.
Payload pre vytvorenie faktúry. V bežnom prípade stačí poslať clientId a items; ostatné polia môže backend dopočítať. Musíte poslať buď clientId, alebo objekt client.
Manuálne číslo faktúry. Ak ho nepošlete, backend ho vygeneruje z číselného radu. Ak ho pošlete bez numericalSeriesId, faktúra môže zostať mimo číselného radu.
ID existujúceho klienta. Toto je odporúčaný spôsob tvorby faktúry. Ak zároveň pošlete objekt client, použije sa ako sparse override snapshotu klienta pre tento konkrétny doklad.
Sparse klientský payload používaný pri tvorbe alebo úprave faktúry. Ak pošlete clientId, tento objekt slúži ako voliteľný override snapshotu klienta iba pre konkrétny doklad. Ak clientId nepošlete, backend sa podľa tohto objektu pokúsi nájsť existujúceho klienta alebo vytvoriť nového.
Názov firmy alebo meno osoby. Ak clientId neposielate, toto pole je povinné.
Typ klienta. Povolené hodnoty sú person a company. Ak ho nepošlete, backend ho dopočíta z identifikačných údajov.
IČO klienta alebo firmy. Pri slovenských firmách sa používa aj na párovanie existujúceho klienta.
IČ DPH klienta alebo firmy. Pri firmách ide o primárny matching údaj, ak je k dispozícii.
Voliteľná informácia, či je klient platca DPH. Ak ju nepošlete a vyplníte vatId, backend ju dopočíta automaticky.
Kontaktný e-mail klienta. Môže sa použiť aj na dopárovanie existujúceho klienta.
Fakturačná ulica klienta. Pri sparse override mení len snapshot na tomto doklade.
ID krajiny z referenčnej tabuľky krajín. Pri firmách sa spolu so subjectId používa aj na dopárovanie existujúceho klienta.
Voliteľný príznak dodacej adresy. Ak ho nepošlete, backend ho vie odvodiť z dodacích polí.
Dodacia ulica klienta pre snapshot na tomto doklade.
Dodacie mesto klienta pre snapshot na tomto doklade.
Dodacie PSČ klienta pre snapshot na tomto doklade.
ID krajiny dodacej adresy z referenčnej tabuľky krajín.
ID číselného radu. Ak ho nepošlete a nepošlete ani number, použije sa primárny číselný rad pre faktúry. Ak pošlete manuálne number bez tohto poľa, numericalSeriesId zostane null.
ID bankového účtu, ktorý sa má použiť na faktúre. Ak ho nepošlete, použije sa primárny bankový účet firmy. Ak firma nemá nastavený žiadny primárny bankový účet, endpoint vráti 422 validation error s chybou pri bankAccountId.
Dátum vystavenia. Ak ho nepošlete, použije sa dnešný dátum.
Počet dní splatnosti. Priorita je payload → klientská predvolená hodnota → document settings firmy.
Dátum dodania. Ak ho nepošlete, použije sa issueDate.
Variabilný symbol. Ak ho nepošlete, backend ho odvodí z finálneho čísla faktúry.
Konštantný symbol. Priorita je payload → klientská predvolená hodnota → null.
Špecifický symbol. Priorita je payload → klientská predvolená hodnota → null.
Príznak prenesenej daňovej povinnosti. Ak ho nepošlete, použije sa false.
ID spôsobu dodania z referenčnej tabuľky spôsobov dodania. Priorita je payload → klientská predvolená hodnota → document settings firmy.
ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady. Priorita je payload → klientská predvolená hodnota → document settings firmy.
ID meny z referenčnej tabuľky mien. Priorita je payload → klientská predvolená hodnota → document settings firmy.
Kurz meny k EUR. Ak ho nepošlete, backend ho vyrieši server-side podľa currencyId a deliveryDate.
ID jazyka z referenčnej tabuľky jazykov. Priorita je payload → klientská predvolená hodnota → document settings firmy.
ID QR typu z referenčnej tabuľky QR typov. Ak ho nepošlete, použije sa document settings firmy.
Poznámka na doklade. Priorita je payload → klientská predvolená hodnota → document settings firmy.
Text nad položkami. Priorita je payload → klientská predvolená hodnota → document settings firmy.
Položky faktúry. Toto pole je povinné aj vtedy, keď väčšinu ostatných hodnôt necháte dopočítať backendom.
Payload jednej položky faktúry. Podporované sú tri režimy: manuálna položka, priceListItemId + quantity, alebo priceListItemId s čiastočnými override poľami. Povinné je vždy quantity. Ak nepošlete priceListItemId, musíte poslať aj name, unitId, unitPrice a vatRate. Ak priceListItemId pošlete, backend si z cenníkovej položky vie dopočítať názov, jednotku, cenu a sadzbu DPH; payload potom slúži len ako sparse override.
Názov položky. Pri manuálnej položke je povinný. Pri použití priceListItemId môže slúžiť ako override názvu z cenníka.
Voliteľný popis položky. Pri priceListItemId môže prepísať alebo doplniť popis z cenníkovej položky.
Jednotková cena bez DPH. Pri manuálnej položke je povinná. Pri priceListItemId môže prepísať cenu načítanú z cenníka.
ID jednotky z referenčnej tabuľky jednotiek. Pri manuálnej položke je povinné. Pri priceListItemId môže prepísať jednotku z cenníkovej položky.
Množstvo položky. Toto pole je povinné vždy, bez ohľadu na to, či ide o manuálnu položku alebo o položku z cenníka.
Sadzba DPH v percentách. Pri manuálnej položke je povinná. Pri priceListItemId môže prepísať sadzbu z cenníkovej položky.
Typ zľavy na úrovni položky. Povolené hodnoty sú percentage a fixed.
Hodnota zľavy na úrovni položky. Ak pošlete discountType, musíte poslať aj toto pole.
Názov zľavy na úrovni položky. Ak ho pri discountType a discountValue nepošlete, backend doplní lokalizované Zľava podľa jazyka dokladu.
Voliteľný UUID identifikátor položky používaný pri interných sync scenároch. Pri bežnom public create ho neposielate.
ID cenníkovej položky. Ak ho pošlete, backend vie z tejto položky hydratovať názov, jednotku, cenu a sadzbu DPH a payload môže slúžiť len ako sparse override.
Voliteľné rozpisy množstiev po skladoch. Používajte ich len pri položkách, ktoré majú väzbu na skladové karty a potrebujete explicitne určiť pohyby po skladoch.
{ "number": "20260001", "proformaId": 401, "orderId": 501, "quotationId": 601, "clientId": 101, "client": { "name": "Acme s.r.o.", "type": "company", "subjectId": "12345678", "taxId": "2020123456", "vatId": "SK2020123456", "isVatPayer": true, "email": "billing@acme.test", "street": "Hlavná 1", "city": "Bratislava", "zip": "81101", "countryId": 703, "hasDeliveryAddress": true, "deliveryStreet": "Skladová 5", "deliveryCity": "Trnava", "deliveryZip": "91701", "deliveryCountryId": 703 }, "numericalSeriesId": 12, "bankAccountId": 201, "issueDate": "2026-03-03", "dueDateDays": 14, "deliveryDate": "2026-03-03", "variableSymbol": 20260001, "constantSymbol": 308, "specificSymbol": 55, "discountType": "percentage", "discountValue": 10, "transferTaxLiability": false, "deliveryMethodId": 1, "paymentMethodId": 1, "currencyId": 1, "currencyRate": 1, "languageId": 1, "qrTypeId": 1, "note": "Ďakujeme za objednávku.", "textAboveItems": "Dakujeme za spoluprácu.", "items": [ { … } ] }