Skip to content
/
InvoicePreview

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

Paginator

Metadáta stránkovania vracané pri paginovaných list endpointoch.

currentPageinteger

Aktuálna stránka výsledku.

Example: 2
perPageinteger

Počet výsledkov na jednej stránke.

Example: 10
totalPagesinteger

Celkový počet stránok.

Example: 5
totalResultsinteger

Celkový počet záznamov naprieč všetkými stránkami.

Example: 42
currentFrominteger

Poradové číslo prvého záznamu na aktuálnej stránke.

Example: 11
currentTointeger

Poradové číslo posledného záznamu na aktuálnej stránke.

Example: 20
firstPageUrlstring

URL prvej stránky.

Example: "https://app.fintoro.sk/api/public/v1/invoices?page=1"
lastPageUrlstring

URL poslednej stránky.

Example: "https://app.fintoro.sk/api/public/v1/invoices?page=5"
nextPageUrlstring or null

URL ďalšej stránky alebo null, ak ďalšia stránka neexistuje.

Example: "https://app.fintoro.sk/api/public/v1/invoices?page=3"
previousPageUrlstring or null

URL predchádzajúcej stránky alebo null, ak predchádzajúca stránka neexistuje.

Example: "https://app.fintoro.sk/api/public/v1/invoices?page=1"
linksArray of objects(PaginatorLink)

Kompletný zoznam stránkovacích linkov v poradí, v akom ich vracia backend.

links[].​urlstring or null

URL cieľovej stránky alebo null, ak daný link nie je dostupný.

Example: "https://app.fintoro.sk/api/public/v1/invoices?page=2"
links[].​labelstring

Textový label linku.

Example: "2"
links[].​activeboolean

Označuje, či ide o aktuálne aktívnu stránku.

Example: false
{
  "currentPage": 2,
  "perPage": 10,
  "totalPages": 5,
  "totalResults": 42,
  "currentFrom": 11,
  "currentTo": 20,
  "firstPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
  "lastPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=5",
  "nextPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=3",
  "previousPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
  "links": [
    { … }
  ]
}

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