Skip to content
/
Bank

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

BankAccount

Bankový účet patriaci aktuálnej firme. Objekt spája business údaje účtu, informáciu o banke a stav napojenia na open banking.

idinteger

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

Example: 201
bankIdinteger or null

ID banky z lookup endpointu bánk. Ak je null, účet nie je naviazaný na konkrétnu banku z lookupu.

Example: 1
bankBank (object) or null

Vnorený objekt banky zodpovedajúci bankId, ak je banka známa a stále dostupná v lookup datasete.

Any of:

Vnorený objekt banky zodpovedajúci bankId, ak je banka známa a stále dostupná v lookup datasete.

bank.​idinteger

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

Example: 1
bank.​namestring

Názov banky.

Example: "Tatra banka"
bank.​logostring

URL adresa loga banky, ak je dostupná.

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

SWIFT kód banky, ak je dostupný.

Example: "TATRSKBX"
isPrimaryboolean

Označuje, či je tento účet aktuálne vedený ako primárny bankový účet firmy.

Example: true
autoPaymentMatchingboolean

Označuje, či je účet aktuálne napojený na automatické párovanie platieb cez open banking. Hodnota je odvodená od existencie open banking napojenia, neposiela sa v requeste.

Example: true
namestring

Používateľský názov bankového účtu zobrazený vo Fintoro.

Example: "Hlavný účet"
ibanstring

IBAN bankového účtu.

Example: "SK3111000000001234567890"
swiftstring

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

Example: "TATRSKBX"
autoPairingStrategystring

Stratégia automatického párovania platieb pre tento účet.

Enum"none""by_variable_symbol""by_price""by_variable_symbol_and_price""by_all_symbols""by_all_symbols_and_price"
Example: "by_variable_symbol"
balancenumber or null(float)

Posledný známy zostatok účtu, ak je dostupný z open banking napojenia.

Example: 1234.56
lastSyncedAtstring or null

Dátum a čas poslednej úspešnej synchronizácie účtu cez open banking, ak je dostupný.

Example: "2026-03-01 10:15:16"
openBankingValidUntilstring or null(date)

Dátum, do ktorého je platný aktuálny open banking súhlas, ak existuje.

Example: "2026-04-30"
createdAtstring or null

Dátum a čas vytvorenia bankového účtu.

Example: "2026-03-03 12:00:00"
updatedAtstring or null

Dátum a čas poslednej zmeny bankového účtu.

Example: "2026-03-03 15:45:00"
{
  "id": 201,
  "bankId": 1,
  "bank": {
    "id": 1,
    "name": "Tatra banka",
    "logo": "https://example.test/tatra-banka.svg",
    "swift": "TATRSKBX"
  },
  "isPrimary": true,
  "autoPaymentMatching": true,
  "name": "Hlavný účet",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "autoPairingStrategy": "by_variable_symbol",
  "balance": 1234.56,
  "lastSyncedAt": "2026-03-01 10:15:16",
  "openBankingValidUntil": "2026-04-30",
  "createdAt": "2026-03-03 12:00:00",
  "updatedAt": "2026-03-03 15:45:00"
}

Bank

Banka dostupná v lookup endpointoch public API. Zoznam sa priebežne synchronizuje z open banking zdroja, no existujúce ID bánk ostávajú zachované kvôli kompatibilite s uloženými bankovými účtami.

idinteger

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

Example: 1
namestring

Názov banky.

Example: "Tatra banka"
logostring

URL adresa loga banky, ak je dostupná.

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

SWIFT kód banky, ak je dostupný.

Example: "TATRSKBX"
{
  "id": 1,
  "name": "Tatra banka",
  "logo": "https://example.test/tatra-banka.svg",
  "swift": "TATRSKBX"
}

BankAccountCreateInput

Payload pre vytvorenie bankového účtu. Posielate iba business dáta účtu. Polia, ktoré nepošlete a majú backendový default, sa dopočítajú na strane servera.

bankIdinteger or null

Voliteľné ID banky z lookup endpointu bánk. Použite ho, ak chcete účet naviazať na konkrétnu banku z verejného lookupu.

Example: 1
namestring

Názov bankového účtu, pod ktorým ho budete identifikovať vo Fintoro.

Example: "Hlavný účet"
ibanstring

IBAN bankového účtu. Musí byť validný a unikátny v rámci aktuálnej firmy.

Example: "SK3111000000001234567890"
swiftstring

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

Example: "TATRSKBX"
autoPairingStrategystring

Stratégia automatického párovania platieb pre tento účet. Ak pole nepošlete, použije sa predvolená hodnota by_variable_symbol.

Default "by_variable_symbol"
Enum"none""by_variable_symbol""by_price""by_variable_symbol_and_price""by_all_symbols""by_all_symbols_and_price"
Example: "by_variable_symbol"
isPrimaryboolean

Označuje, či má byť účet vedený ako primárny účet firmy. Aktuálna implementácia novovytvorený účet nastaví ako primárny účet firmy aj pri vynechaní tohto poľa alebo pri odoslaní false, preto toto pole zatiaľ nefunguje ako tvrdý prepínač.

Default true
Example: true
{
  "bankId": 1,
  "name": "Hlavný účet",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "autoPairingStrategy": "by_variable_symbol",
  "isPrimary": true
}