Skip to content
/
Paginator

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
}