Fintoro Public API v1 (1.0.0)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude
Connect to Cursor
Install MCP server on Cursor
Connect to VS Code
Install MCP server on VS Code

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

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

Invoice

Faktúra patriaca aktuálnej firme.

idinteger

Example: 301

uuidstring

Example: "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"

typestring

Example: "invoice"

numberstring

Example: "20260001"

companyobject(CompanySnapshot)

Snapshot dodávateľa uložený priamo na tomto doklade.

company.namestring

Obchodné meno dodávateľa uložené na faktúre.

Example: "Fintoro s.r.o."

company.subjectIdstring

IČO dodávateľa uložené na faktúre.

Example: "12345678"

company.legalFormstring

Právna forma dodávateľa uložená na faktúre.

Example: "Spoločnosť s ručením obmedzeným"

company.taxIdstring or null

DIČ dodávateľa uložené na faktúre, ak bolo k dispozícii.

Example: "2020123456"

company.vatIdstring or null

IČ DPH dodávateľa uložené na faktúre, ak bolo k dispozícii.

Example: "SK2020123456"

company.vatPayerTypeIdinteger

Typ platcu DPH dodávateľa uložený na faktúre.

Example: 4

company.countrystring

Krajina dodávateľa uložená na faktúre ako textová hodnota.

Example: "Slovensko"

company.citystring

Mesto dodávateľa uložené na faktúre.

Example: "Bratislava"

company.streetstring

Ulica a číslo dodávateľa uložené na faktúre.

Example: "Hlavná 1"

company.zipstring or null

PSČ dodávateľa uložené na faktúre.

Example: "81101"

company.logostring or null

URL alebo cesta k logu uloženému v snapshot-e, ak bolo k dispozícii.

Example: "https://app.fintoro.sk/storage/company/logo.svg"

company.signaturestring or null

URL alebo cesta k podpisu uloženému v snapshot-e, ak bol k dispozícii.

Example: "https://app.fintoro.sk/storage/company/signature.png"

company.registrationCourtstring or null

Registrový súd dodávateľa uložený na faktúre, ak bol k dispozícii.

Example: "Mestský súd Bratislava III"

company.registrationNumberstring or null

Registračné číslo dodávateľa uložené na faktúre, ak bolo k dispozícii.

Example: "12345/B"

company.emailstring or null

Kontaktný e-mail dodávateľa uložený na faktúre.

Example: "support@fintoro.sk"

company.phonestring or null

Kontaktný telefón dodávateľa uložený na faktúre.

Example: "+421900000000"

company.webstring or null

Web dodávateľa uložený na faktúre.

Example: "https://fintoro.sk"

clientobject(ClientSnapshot)

Historický snapshot klienta uložený priamo na tomto doklade.

client.idinteger

Interné ID snapshotu klienta uloženého na doklade.

Example: 101

client.namestring

Meno osoby alebo obchodné meno klienta uložené na faktúre v danom čase.

Example: "Acme s.r.o."

client.typestring

Typ klienta uložený na faktúre.

Example: "company"

client.subjectIdstring or null

IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu viete typicky dohľadať aj cez referenčný register subjektov.

Example: "12345678"

client.taxIdstring or null

DIČ klienta uložené na faktúre, ak bolo k dispozícii.

Example: "2020123456"

client.vatIdstring or null

IČ DPH klienta uložené na faktúre, ak bolo k dispozícii.

Example: "SK2020123456"

client.isVatPayerboolean

Informácia, či bol klient v čase uloženia snapshotu vedený ako platca DPH.

Example: true

client.emailstring or null

Kontaktný e-mail klienta uložený na faktúre.

Example: "billing@acme.test"

client.streetstring or null

Ulica a číslo fakturačnej adresy uložené na faktúre.

Example: "Hlavná 1"

client.citystring or null

Mesto fakturačnej adresy uložené na faktúre.

Example: "Bratislava"

client.zipstring or null

PSČ fakturačnej adresy uložené na faktúre.

Example: "81101"

client.countryIdinteger or null

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

Example: 703

client.countryCountry (object) or null

Fakturačná krajina uložená na faktúre ako vnorený objekt.

Any of:

Fakturačná krajina uložená na faktúre ako vnorený objekt.

client.country.idinteger

Stabilné ID krajiny používané v API.

Example: 703

client.country.namestring

Názov krajiny.

Example: "Slovensko"

client.country.codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"

client.country.euboolean

Informácia, či krajina patrí do Európskej únie.

Example: true

client.country.flagstring

URL adresa ikony vlajky.

Example: "https://flagcdn.com/80x60/sk.png"

client.hasDeliveryAddressboolean

Informácia, či snapshot obsahuje samostatnú dodaciu adresu.

Example: true

client.deliveryStreetstring or null

Ulica a číslo dodacej adresy uložené na faktúre.

Example: "Skladová 9"

client.deliveryCitystring or null

Mesto dodacej adresy uložené na faktúre.

Example: "Košice"

client.deliveryZipstring or null

PSČ dodacej adresy uložené na faktúre.

Example: "04001"

client.deliveryCountryIdinteger or null

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

Example: 703

client.deliveryCountryCountry (object) or null

Dodacia krajina uložená na faktúre ako vnorený objekt.

Any of:

Dodacia krajina uložená na faktúre ako vnorený objekt.

client.deliveryCountry.idinteger

Stabilné ID krajiny používané v API.

Example: 703

client.deliveryCountry.namestring

Názov krajiny.

Example: "Slovensko"

client.deliveryCountry.codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"

client.deliveryCountry.euboolean

Informácia, či krajina patrí do Európskej únie.

Example: true

client.deliveryCountry.flagstring

URL adresa ikony vlajky.

Example: "https://flagcdn.com/80x60/sk.png"

bankAccountobject(InvoiceBankAccountReference)

Bankový účet naviazaný na faktúru ako live väzba načítaná aj cez soft delete.

bankAccount.idinteger

Interné ID bankového účtu vo Fintoro.

Example: 201

bankAccount.bankIdinteger or null

ID banky z lookup endpointu bánk, ak je účet naviazaný na známu banku.

Example: 1

bankAccount.bankBank (object) or null

Vnorený objekt banky priradenej k účtu, ak je známa.

Any of:

Vnorený objekt banky priradenej k účtu, ak je známa.

bankAccount.bank.idinteger

Stabilné ID banky používané vo Fintoro. Po doplnení nových bánk sa existujúce ID nemenia ani neprepisujú.

Example: 1

bankAccount.bank.namestring

Názov banky.

Example: "Tatra banka"

bankAccount.bank.logostring

URL adresa loga banky, ak je dostupná.

Example: "https://example.test/tatra-banka.svg"

bankAccount.bank.swiftstring

SWIFT kód banky, ak je dostupný.

Example: "TATRSKBX"

bankAccount.namestring

Názov bankového účtu v aktuálnom stave databázy.

Example: "Hlavný účet"

bankAccount.ibanstring

IBAN naviazaného bankového účtu.

Example: "SK3111000000001234567890"

bankAccount.swiftstring

SWIFT alebo BIC kód naviazaného bankového účtu.

Example: "TATRSKBX"

bankAccount.isPrimaryboolean

Informácia, či je účet aktuálne vedený ako primárny účet firmy.

Example: true

bankAccount.autoPaymentMatchingboolean

Informácia, či je účet aktuálne napojený na automatické párovanie platieb cez open banking.

Example: true

variableSymbolinteger

Example: 20260001

constantSymbolinteger or null

Example: 308

specificSymbolinteger or null

Example: 55

issueDatestring(date)

Example: "2026-03-03"

dueDatestring(date)

Example: "2026-03-17"

deliveryDatestring(date)

Example: "2026-03-03"

discountTypestring or null

Example: "percentage"

discountValuenumber or null(float)

Example: 10

transferTaxLiabilityboolean

Example: false

numericalSeriesIdinteger or null

Example: 12

deliveryMethodIdinteger

ID spôsobu dodania z referenčnej tabuľky spôsobov dodania.

Example: 1

paymentMethodIdinteger

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady.

Example: 1

currencyIdinteger

ID meny z referenčnej tabuľky mien.

Example: 1

currencyRatenumber(float)

Example: 1

languageIdinteger

ID jazyka z referenčnej tabuľky jazykov.

Example: 1

qrTypeIdinteger

ID QR typu z referenčnej tabuľky QR typov.

Example: 1

notestring or null

Example: "Ďakujeme za objednávku."

textAboveItemsstring or null

Example: "Dakujeme za spoluprácu."

itemsTotalnumber(float)

Example: 200

itemsTotalWithVatnumber(float)

Example: 240

totalnumber(float)

Example: 200

totalWithVatnumber(float)

Example: 240

toBePaidnumber(float)

Example: 240

statusstring

Example: "unpaid"

hasVatboolean

Example: true

creditNotesSumTotalWithVatnumber(float)

Example: 0

itemsArray of objects(InvoiceItem)

items[].idinteger

Example: 1

items[].namestring

Example: "Konzultácia"

items[].descriptionstring or null

Example: "Mesačný balík konzultácií"

items[].unitPricenumber(float)

Example: 100

items[].unitIdinteger

ID jednotky z referenčnej tabuľky jednotiek.

Example: 1

items[].quantitynumber(float)

Example: 2

items[].vatRatenumber(float)

Example: 20

items[].discountNamestring or null

Example: "Vernostná zľava"

items[].discountTypestring or null

Example: "percentage"

items[].discountValuenumber or null(float)

Example: 10

items[].priceListItemIdinteger or null

Example: 501

items[].totalnumber(float)

Example: 200

items[].totalWithVatnumber(float)

Example: 240

{
  "id": 301,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "invoice",
  "number": "20260001",
  "company": {
    "name": "Fintoro s.r.o.",
    "subjectId": "12345678",
    "legalForm": "Spoločnosť s ručením obmedzeným",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "vatPayerTypeId": 4,
    "country": "Slovensko",
    "city": "Bratislava",
    "street": "Hlavná 1",
    "zip": "81101",
    "logo": "https://app.fintoro.sk/storage/company/logo.svg",
    "signature": "https://app.fintoro.sk/storage/company/signature.png",
    "registrationCourt": "Mestský súd Bratislava III",
    "registrationNumber": "12345/B",
    "email": "support@fintoro.sk",
    "phone": "+421900000000",
    "web": "https://fintoro.sk"
  },
  "client": {
    "id": 101,
    "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,
    "country": { … },
    "hasDeliveryAddress": true,
    "deliveryStreet": "Skladová 9",
    "deliveryCity": "Košice",
    "deliveryZip": "04001",
    "deliveryCountryId": 703,
    "deliveryCountry": { … }
  },
  "bankAccount": {
    "id": 201,
    "bankId": 1,
    "bank": { … },
    "name": "Hlavný účet",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "isPrimary": true,
    "autoPaymentMatching": true
  },
  "variableSymbol": 20260001,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "deliveryDate": "2026-03-03",
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "numericalSeriesId": 12,
  "deliveryMethodId": 1,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "qrTypeId": 1,
  "note": "Ďakujeme za objednávku.",
  "textAboveItems": "Dakujeme za spoluprácu.",
  "itemsTotal": 200,
  "itemsTotalWithVat": 240,
  "total": 200,
  "totalWithVat": 240,
  "toBePaid": 240,
  "status": "unpaid",
  "hasVat": true,
  "creditNotesSumTotalWithVat": 0,
  "items": [
    { … }
  ]
}

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

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": [
    { … }
  ]
}

Fintoro Public API v1 (1.0.0)CopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from ClaudeConnect to CursorInstall MCP server on CursorConnect to VS CodeInstall MCP server on VS Code

Lookupy

Subjekty

Klienti

Bankové účty

Faktúry

Schemas

Invoice

InvoiceClientInput

InvoiceInput

Fintoro Public API v1 (1.0.0)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude
Connect to Cursor
Install MCP server on Cursor
Connect to VS Code
Install MCP server on VS Code