Skip to content
/
Invoice

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

InvoicePreview

Zjednodušený preview objekt faktúry určený pre list endpoint. Neobsahuje položky ani plný snapshot klienta a bankového účtu; na detail použite detail endpoint faktúry.

idinteger

Interné ID faktúry vo Fintoro.

Example: 301
uuidstring

Stabilný UUID identifikátor faktúry.

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

Typ dokladu.

Example: "invoice"
numberstring

Číslo faktúry.

Example: "20260001"
clientobject(InvoicePreviewClient)

Zjednodušený klient patriaci k faktúre.

client.​idinteger

Interné ID klienta vo Fintoro.

Example: 101
client.​namestring

Meno osoby alebo obchodné meno klienta.

Example: "Acme s.r.o."
issueDatestring(date)

Dátum vystavenia faktúry.

Example: "2026-03-03"
dueDatestring(date)

Dátum splatnosti faktúry.

Example: "2026-03-17"
deliveryDatestring(date)

Dátum dodania.

Example: "2026-03-03"
currencyobject(Currency)

Mena faktúry ako vnorený objekt.

currency.​idinteger

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

Example: 1
currency.​symbolstring

ISO alebo interný symbol meny.

Example: "EUR"
currency.​namestring

Názov meny.

Example: "Euro"
currency.​markstring

Skrátená značka meny zobrazovaná vo Fintoro.

Example: "€"
currency.​imagestring

URL adresa ikonky meny, ak je dostupná.

Example: "https://example.test/images/currencies/eur.svg"
totalnumber(float)

Celková suma bez DPH.

Example: 200
totalWithVatnumber(float)

Celková suma s DPH.

Example: 240
toBePaidnumber(float)

Zostávajúca suma na úhradu.

Example: 240
statusstring

Aktuálny stav úhrady faktúry.

Enum"paid""unpaid""partially_paid""overdue""will_not_be_paid"
Example: "unpaid"
hasVatboolean

Informácia, či faktúra obsahuje položky s DPH.

Example: true
{
  "id": 301,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "invoice",
  "number": "20260001",
  "client": {
    "id": 101,
    "name": "Acme s.r.o."
  },
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "deliveryDate": "2026-03-03",
  "currency": {
    "id": 1,
    "symbol": "EUR",
    "name": "Euro",
    "mark": "€",
    "image": "https://example.test/images/currencies/eur.svg"
  },
  "total": 200,
  "totalWithVat": 240,
  "toBePaid": 240,
  "status": "unpaid",
  "hasVat": true
}

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
}