Skip to content
/
InvoiceInput

Fintoro Public API v1 (1.0.0)

Stabilné API pre integrácie tretích strán napojené na konkrétnu firmu vo Fintoro. Nájdete tu aj read-only lookup endpointy pre číselníky a banky, plus referenčné tabuľky pre rýchle overenie stabilných ID hodnôt.

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Mock server
https://docs.fintoro.sk/_mock/openapi
Produkčné Public API.
https://app.fintoro.sk/api/public/v1
Relatívny prefix pre preview prostredie.
https://docs.fintoro.sk/api/public/v1

Lookupy

Read-only lookup endpointy pre integračné dáta. Tieto endpointy vracajú číselníky so stabilnými ID, ktoré môžete bezpečne cachovať na svojej strane. Banky sa priebežne synchronizujú z open banking zdroja a zvyčajne sa len dopĺňajú o nové záznamy; existujúce ID ostávajú zachované kvôli kompatibilite. V praxi odporúčame banky synchronizovať približne raz týždenne.

Operations

Subjekty

Vyhľadanie a overenie údajov o subjekte ešte pred vytvorením klienta.

Operations

Klienti

Správa klientov aktuálnej firmy. Táto sekcia pokrýva zoznam, detail, vytvorenie, úpravu aj zmazanie klienta vrátane fakturačnej adresy, dodacej adresy a klientských predvolených hodnôt použiteľných pri skladaní payloadov nových dokladov.

Operations

Bankové účty

Správa bankových účtov aktuálnej firmy. Táto sekcia pokrýva zoznam, detail, vytvorenie, úpravu aj zmazanie účtu vrátane údajov o banke, primárnom účte a stave open banking napojenia.

Operations

Faktúry

CRUD operácie nad faktúrami aktuálnej firmy.

Operations

Schemas

Schemas

InvoiceClientInput

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.

namestring

Názov firmy alebo meno osoby. Ak clientId neposielate, toto pole je povinné.

Example: "Acme s.r.o."
typestring

Typ klienta. Povolené hodnoty sú person a company. Ak ho nepošlete, backend ho dopočíta z identifikačných údajov.

Enum"person""company"
Example: "company"
subjectIdstring or null

IČO klienta alebo firmy. Pri slovenských firmách sa používa aj na párovanie existujúceho klienta.

Example: "12345678"
taxIdstring or null

DIČ klienta alebo firmy.

Example: "2020123456"
vatIdstring or null

IČ DPH klienta alebo firmy. Pri firmách ide o primárny matching údaj, ak je k dispozícii.

Example: "SK2020123456"
isVatPayerboolean

Voliteľná informácia, či je klient platca DPH. Ak ju nepošlete a vyplníte vatId, backend ju dopočíta automaticky.

Example: true
emailstring or null(email)

Kontaktný e-mail klienta. Môže sa použiť aj na dopárovanie existujúceho klienta.

Example: "billing@acme.test"
streetstring or null

Fakturačná ulica klienta. Pri sparse override mení len snapshot na tomto doklade.

Example: "Hlavná 1"
citystring or null

Fakturačné mesto klienta.

Example: "Bratislava"
zipstring or null

Fakturačné PSČ klienta.

Example: "81101"
countryIdinteger or null

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.

Example: 703
hasDeliveryAddressboolean

Voliteľný príznak dodacej adresy. Ak ho nepošlete, backend ho vie odvodiť z dodacích polí.

Example: true
deliveryStreetstring or null

Dodacia ulica klienta pre snapshot na tomto doklade.

Example: "Skladová 5"
deliveryCitystring or null

Dodacie mesto klienta pre snapshot na tomto doklade.

Example: "Trnava"
deliveryZipstring or null

Dodacie PSČ klienta pre snapshot na tomto doklade.

Example: "91701"
deliveryCountryIdinteger or null

ID krajiny dodacej adresy z referenčnej tabuľky krajín.

Example: 703
{
  "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
}

InvoiceInput

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.

Any of:

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.

numberstring or null

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.

Example: "20260001"
proformaIdinteger or null

Voliteľné ID zálohovej faktúry, z ktorej sa faktúra vytvára.

Example: 401
orderIdinteger or null

Voliteľné ID objednávky, z ktorej sa faktúra vytvára.

Example: 501
quotationIdinteger or null

Voliteľné ID cenovej ponuky, z ktorej sa faktúra vytvára.

Example: 601
clientIdinteger or nullrequired

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.

Example: 101
clientobject

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.

client.​namestring

Názov firmy alebo meno osoby. Ak clientId neposielate, toto pole je povinné.

Example: "Acme s.r.o."
client.​typestring

Typ klienta. Povolené hodnoty sú person a company. Ak ho nepošlete, backend ho dopočíta z identifikačných údajov.

Enum"person""company"
Example: "company"
client.​subjectIdstring or null

IČO klienta alebo firmy. Pri slovenských firmách sa používa aj na párovanie existujúceho klienta.

Example: "12345678"
client.​taxIdstring or null

DIČ klienta alebo firmy.

Example: "2020123456"
client.​vatIdstring or null

IČ DPH klienta alebo firmy. Pri firmách ide o primárny matching údaj, ak je k dispozícii.

Example: "SK2020123456"
client.​isVatPayerboolean

Voliteľná informácia, či je klient platca DPH. Ak ju nepošlete a vyplníte vatId, backend ju dopočíta automaticky.

Example: true
client.​emailstring or null(email)

Kontaktný e-mail klienta. Môže sa použiť aj na dopárovanie existujúceho klienta.

Example: "billing@acme.test"
client.​streetstring or null

Fakturačná ulica klienta. Pri sparse override mení len snapshot na tomto doklade.

Example: "Hlavná 1"
client.​citystring or null

Fakturačné mesto klienta.

Example: "Bratislava"
client.​zipstring or null

Fakturačné PSČ klienta.

Example: "81101"
client.​countryIdinteger or null

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.

Example: 703
client.​hasDeliveryAddressboolean

Voliteľný príznak dodacej adresy. Ak ho nepošlete, backend ho vie odvodiť z dodacích polí.

Example: true
client.​deliveryStreetstring or null

Dodacia ulica klienta pre snapshot na tomto doklade.

Example: "Skladová 5"
client.​deliveryCitystring or null

Dodacie mesto klienta pre snapshot na tomto doklade.

Example: "Trnava"
client.​deliveryZipstring or null

Dodacie PSČ klienta pre snapshot na tomto doklade.

Example: "91701"
client.​deliveryCountryIdinteger or null

ID krajiny dodacej adresy z referenčnej tabuľky krajín.

Example: 703
numericalSeriesIdinteger or null

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.

Example: 12
bankAccountIdinteger or 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.

Example: 201
issueDatestring or null(date)

Dátum vystavenia. Ak ho nepošlete, použije sa dnešný dátum.

Example: "2026-03-03"
dueDateDaysinteger or null

Počet dní splatnosti. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: 14
deliveryDatestring or null(date)

Dátum dodania. Ak ho nepošlete, použije sa issueDate.

Example: "2026-03-03"
variableSymbolinteger or null

Variabilný symbol. Ak ho nepošlete, backend ho odvodí z finálneho čísla faktúry.

Example: 20260001
constantSymbolinteger or null

Konštantný symbol. Priorita je payload → klientská predvolená hodnota → null.

Example: 308
specificSymbolinteger or null

Špecifický symbol. Priorita je payload → klientská predvolená hodnota → null.

Example: 55
discountTypestring or null

Typ zľavy na úrovni celého dokladu.

Example: "percentage"
discountValuenumber or null(float)

Hodnota zľavy na úrovni celého dokladu.

Example: 10
transferTaxLiabilityboolean

Príznak prenesenej daňovej povinnosti. Ak ho nepošlete, použije sa false.

Example: false
deliveryMethodIdinteger or null

ID spôsobu dodania z referenčnej tabuľky spôsobov dodania. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: 1
paymentMethodIdinteger or null

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: 1
currencyIdinteger or null

ID meny z referenčnej tabuľky mien. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: 1
currencyRatenumber or null(float)

Kurz meny k EUR. Ak ho nepošlete, backend ho vyrieši server-side podľa currencyId a deliveryDate.

Example: 1
languageIdinteger or null

ID jazyka z referenčnej tabuľky jazykov. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: 1
qrTypeIdinteger or null

ID QR typu z referenčnej tabuľky QR typov. Ak ho nepošlete, použije sa document settings firmy.

Example: 1
notestring or null

Poznámka na doklade. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: "Ďakujeme za objednávku."
textAboveItemsstring or null

Text nad položkami. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: "Dakujeme za spoluprácu."
itemsArray of objects(InvoiceItemInput)required

Položky faktúry. Toto pole je povinné aj vtedy, keď väčšinu ostatných hodnôt necháte dopočítať backendom.

Any of:

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.

items[].​namestring

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.

Example: "Konzultácia"
items[].​descriptionstring or null

Voliteľný popis položky. Pri priceListItemId môže prepísať alebo doplniť popis z cenníkovej položky.

Example: "Mesačný balík konzultácií"
items[].​unitPricenumber(float)

Jednotková cena bez DPH. Pri manuálnej položke je povinná. Pri priceListItemId môže prepísať cenu načítanú z cenníka.

Example: 100
items[].​unitIdinteger

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.

Example: 1
items[].​quantitynumber(float)required

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.

Example: 2
items[].​vatRatenumber(float)

Sadzba DPH v percentách. Pri manuálnej položke je povinná. Pri priceListItemId môže prepísať sadzbu z cenníkovej položky.

Example: 20
items[].​discountTypestring or null

Typ zľavy na úrovni položky. Povolené hodnoty sú percentage a fixed.

Example: "percentage"
items[].​discountValuenumber or null(float)

Hodnota zľavy na úrovni položky. Ak pošlete discountType, musíte poslať aj toto pole.

Example: 10
items[].​discountNamestring or null

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.

Example: "Vernostná zľava"
items[].​uuidstring or null

Voliteľný UUID identifikátor položky používaný pri interných sync scenároch. Pri bežnom public create ho neposielate.

Example: "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
items[].​priceListItemIdinteger or nullrequired

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.

Example: 501
items[].​warehouseAllocationsArray of objects(InvoiceWarehouseAllocation)

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.

items[].​warehouseAllocations[].​warehouseIdinteger
Example: 1
items[].​warehouseAllocations[].​quantitynumber(float)
Example: 2
{
  "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": [
    { … }
  ]
}

InvoiceUpdateInput

Payload pre aktualizáciu faktúry. items sú povinné vždy. Ostatné polia sú voliteľné; ak ich nepošlete, zachová sa existujúca hodnota na faktúre. clientId ani client posielať nemusíte.

numberstring or null

Manuálne číslo faktúry. Ak ho nepošlete, zachová sa existujúce číslo faktúry. Ak pošlete nové číslo bez variableSymbol, backend z neho odvodí nový variabilný symbol.

Example: "20260001"
proformaIdinteger or null

Voliteľné ID zálohovej faktúry naviazanej na faktúru. Ak pole nepošlete, zachová sa aktuálna väzba. Pošlite null, ak chcete väzbu odstrániť.

Example: 401
orderIdinteger or null

Voliteľné ID objednávky naviazanej na faktúru. Ak pole nepošlete, zachová sa aktuálna väzba. Pošlite null, ak chcete väzbu odstrániť.

Example: 501
quotationIdinteger or null

Voliteľné ID cenovej ponuky naviazanej na faktúru. Ak pole nepošlete, zachová sa aktuálna väzba. Pošlite null, ak chcete väzbu odstrániť.

Example: 601
clientIdinteger or null

ID existujúceho klienta. Ak ho pošlete, faktúra sa priradí k tomuto klientovi. Ak zároveň pošlete objekt client, použije sa ako sparse override snapshotu klienta pre tento konkrétny doklad. Ak clientId ani client nepošlete, zachová sa aktuálny klient aj snapshot na doklade.

Example: 101
clientobject

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.

client.​namestring

Názov firmy alebo meno osoby. Ak clientId neposielate, toto pole je povinné.

Example: "Acme s.r.o."
client.​typestring

Typ klienta. Povolené hodnoty sú person a company. Ak ho nepošlete, backend ho dopočíta z identifikačných údajov.

Enum"person""company"
Example: "company"
client.​subjectIdstring or null

IČO klienta alebo firmy. Pri slovenských firmách sa používa aj na párovanie existujúceho klienta.

Example: "12345678"
client.​taxIdstring or null

DIČ klienta alebo firmy.

Example: "2020123456"
client.​vatIdstring or null

IČ DPH klienta alebo firmy. Pri firmách ide o primárny matching údaj, ak je k dispozícii.

Example: "SK2020123456"
client.​isVatPayerboolean

Voliteľná informácia, či je klient platca DPH. Ak ju nepošlete a vyplníte vatId, backend ju dopočíta automaticky.

Example: true
client.​emailstring or null(email)

Kontaktný e-mail klienta. Môže sa použiť aj na dopárovanie existujúceho klienta.

Example: "billing@acme.test"
client.​streetstring or null

Fakturačná ulica klienta. Pri sparse override mení len snapshot na tomto doklade.

Example: "Hlavná 1"
client.​citystring or null

Fakturačné mesto klienta.

Example: "Bratislava"
client.​zipstring or null

Fakturačné PSČ klienta.

Example: "81101"
client.​countryIdinteger or null

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.

Example: 703
client.​hasDeliveryAddressboolean

Voliteľný príznak dodacej adresy. Ak ho nepošlete, backend ho vie odvodiť z dodacích polí.

Example: true
client.​deliveryStreetstring or null

Dodacia ulica klienta pre snapshot na tomto doklade.

Example: "Skladová 5"
client.​deliveryCitystring or null

Dodacie mesto klienta pre snapshot na tomto doklade.

Example: "Trnava"
client.​deliveryZipstring or null

Dodacie PSČ klienta pre snapshot na tomto doklade.

Example: "91701"
client.​deliveryCountryIdinteger or null

ID krajiny dodacej adresy z referenčnej tabuľky krajín.

Example: 703
numericalSeriesIdinteger or null

ID číselného radu. Ak ho nepošlete, zachová sa existujúci číselný rad. Pošlite null, ak chcete väzbu na číselný rad odstrániť pri manuálnom číslovaní.

Example: 12
bankAccountIdinteger or null

ID bankového účtu, ktorý sa má použiť na faktúre. Ak ho nepošlete, zachová sa aktuálny bankový účet faktúry.

Example: 201
issueDatestring or null(date)

Dátum vystavenia. Ak ho nepošlete, zachová sa aktuálny dátum vystavenia.

Example: "2026-03-03"
dueDateDaysinteger or null

Počet dní splatnosti. Ak ho nepošlete a nemeníte issueDate, zachová sa aktuálna splatnosť. Ak zmeníte issueDate bez tohto poľa, backend zachová pôvodný počet dní medzi vystavením a splatnosťou.

Example: 14
deliveryDatestring or null(date)

Dátum dodania. Ak ho nepošlete a nemeníte issueDate, zachová sa aktuálny dátum dodania. Ak zmeníte issueDate bez tohto poľa, použije sa nový issueDate.

Example: "2026-03-03"
variableSymbolinteger or null

Variabilný symbol. Ak ho nepošlete a nemeníte number, zachová sa aktuálny variabilný symbol. Ak zmeníte number bez tohto poľa, backend ho odvodí z nového čísla faktúry.

Example: 20260001
constantSymbolinteger or null

Konštantný symbol. Ak ho nepošlete, zachová sa aktuálna hodnota. Pošlite null, ak ho chcete vymazať.

Example: 308
specificSymbolinteger or null

Špecifický symbol. Ak ho nepošlete, zachová sa aktuálna hodnota. Pošlite null, ak ho chcete vymazať.

Example: 55
discountTypestring or null

Typ zľavy na úrovni celého dokladu.

Example: "percentage"
discountValuenumber or null(float)

Hodnota zľavy na úrovni celého dokladu.

Example: 10
transferTaxLiabilityboolean

Príznak prenesenej daňovej povinnosti. Ak ho nepošlete, zachová sa aktuálna hodnota na faktúre.

Example: false
deliveryMethodIdinteger or null

ID spôsobu dodania z referenčnej tabuľky spôsobov dodania. Ak ho nepošlete, zachová sa aktuálna hodnota na faktúre.

Example: 1
paymentMethodIdinteger or null

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady. Ak ho nepošlete, zachová sa aktuálna hodnota na faktúre.

Example: 1
currencyIdinteger or null

ID meny z referenčnej tabuľky mien. Ak ho nepošlete, zachová sa aktuálna mena faktúry.

Example: 1
currencyRatenumber or null(float)

Kurz meny k EUR. Ak ho nepošlete a nemeníte currencyId ani dátum dodania, zachová sa aktuálny kurz. Ak zmeníte menu alebo dátum dodania bez tohto poľa, backend vyrieši nový kurz server-side.

Example: 1
languageIdinteger or null

ID jazyka z referenčnej tabuľky jazykov. Ak ho nepošlete, zachová sa aktuálny jazyk faktúry.

Example: 1
qrTypeIdinteger or null

ID QR typu z referenčnej tabuľky QR typov. Ak ho nepošlete, zachová sa aktuálna hodnota na faktúre.

Example: 1
notestring or null

Poznámka na doklade. Ak ju nepošlete, zachová sa aktuálna poznámka. Pošlite null, ak ju chcete vymazať.

Example: "Ďakujeme za objednávku."
textAboveItemsstring or null

Text nad položkami. Ak ho nepošlete, zachová sa aktuálna hodnota. Pošlite null, ak ho chcete vymazať.

Example: "Dakujeme za spoluprácu."
itemsArray of objects(InvoiceItemInput)required

Položky faktúry. Toto pole je pri update povinné vždy.

Any of:

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.

items[].​namestring

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.

Example: "Konzultácia"
items[].​descriptionstring or null

Voliteľný popis položky. Pri priceListItemId môže prepísať alebo doplniť popis z cenníkovej položky.

Example: "Mesačný balík konzultácií"
items[].​unitPricenumber(float)

Jednotková cena bez DPH. Pri manuálnej položke je povinná. Pri priceListItemId môže prepísať cenu načítanú z cenníka.

Example: 100
items[].​unitIdinteger

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.

Example: 1
items[].​quantitynumber(float)required

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.

Example: 2
items[].​vatRatenumber(float)

Sadzba DPH v percentách. Pri manuálnej položke je povinná. Pri priceListItemId môže prepísať sadzbu z cenníkovej položky.

Example: 20
items[].​discountTypestring or null

Typ zľavy na úrovni položky. Povolené hodnoty sú percentage a fixed.

Example: "percentage"
items[].​discountValuenumber or null(float)

Hodnota zľavy na úrovni položky. Ak pošlete discountType, musíte poslať aj toto pole.

Example: 10
items[].​discountNamestring or null

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.

Example: "Vernostná zľava"
items[].​uuidstring or null

Voliteľný UUID identifikátor položky používaný pri interných sync scenároch. Pri bežnom public create ho neposielate.

Example: "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
items[].​priceListItemIdinteger or nullrequired

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.

Example: 501
items[].​warehouseAllocationsArray of objects(InvoiceWarehouseAllocation)

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.

items[].​warehouseAllocations[].​warehouseIdinteger
Example: 1
items[].​warehouseAllocations[].​quantitynumber(float)
Example: 2
{
  "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": [
    { … }
  ]
}