Skip to content
/
Zoznam bankových účtov

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

Zoznam bankových účtov

Request

Vráti všetky bankové účty aktuálnej firmy v jednom zozname. Endpoint nepodporuje filtrovanie ani stránkovanie, preto je vhodný najmä na synchronizáciu účtov do externého systému alebo vlastného frontendu.

Security
bearerAuth
curl -i -X GET \
  https://docs.fintoro.sk/_mock/openapi/bank-accounts \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Zoznam bankových účtov.

Headers
X-Request-Idstring

Unikátny identifikátor requestu pre traceovanie, audit a support diagnostiku.

Example: "req_public_api_01"
Bodyapplication/json
dataArray of objects(BankAccount)

Zoznam všetkých bankových účtov patriacich aktuálnej firme.

data[].​idinteger

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

Example: 201
data[].​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
data[].​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.

data[].​bank.​idinteger

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

Example: 1
data[].​bank.​namestring

Názov banky.

Example: "Tatra banka"
data[].​bank.​logostring

URL adresa loga banky, ak je dostupná.

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

SWIFT kód banky, ak je dostupný.

Example: "TATRSKBX"
data[].​isPrimaryboolean

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

Example: true
data[].​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
data[].​namestring

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

Example: "Hlavný účet"
data[].​ibanstring

IBAN bankového účtu.

Example: "SK3111000000001234567890"
data[].​swiftstring

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

Example: "TATRSKBX"
data[].​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"
data[].​balancenumber or null(float)

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

Example: 1234.56
data[].​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"
data[].​openBankingValidUntilstring or null(date)

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

Example: "2026-04-30"
data[].​createdAtstring or null

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

Example: "2026-03-03 12:00:00"
data[].​updatedAtstring or null

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

Example: "2026-03-03 15:45:00"
Response
application/json
{
  "data": [
    { … }
  ]
}

Vytvoriť bankový účet

Request

Vytvorí nový bankový účet aktuálnej firmy. V requeste posielate len business dáta účtu. Response vráti výsledný uložený objekt vrátane informácie, či je účet aktuálne vedený ako primárny a či je napojený na open banking.

Security
bearerAuth
Bodyapplication/jsonrequired
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
curl -i -X POST \
  https://docs.fintoro.sk/_mock/openapi/bank-accounts \
  -H 'Authorization: Bearer <YOUR_Token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "bankId": 1,
    "name": "Hlavný účet",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "autoPairingStrategy": "by_variable_symbol",
    "isPrimary": true
  }'

Responses

Bankový účet bol vytvorený.

Headers
X-Request-Idstring

Unikátny identifikátor requestu pre traceovanie, audit a support diagnostiku.

Example: "req_public_api_01"
Bodyapplication/json
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"
Response
application/json
{
  "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"
}

Detail bankového účtu

Request

Vráti detail jedného bankového účtu aktuálnej firmy. Okrem samotných údajov o účte vracia aj vnorený objekt banky, stav primárneho účtu a open banking metadata, ak sú dostupné.

Security
bearerAuth
Path
bankAccountintegerrequired

ID bankového účtu.

Example: 201
curl -i -X GET \
  https://docs.fintoro.sk/_mock/openapi/bank-accounts/201 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Detail bankového účtu.

Headers
X-Request-Idstring

Unikátny identifikátor requestu pre traceovanie, audit a support diagnostiku.

Example: "req_public_api_01"
Bodyapplication/json
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"
Response
application/json
{
  "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"
}

Upraviť bankový účet

Request

Aktualizuje bankový účet aktuálnej firmy. Pošlite len polia, ktoré chcete zmeniť. Ak pošlete isPrimary: true, účet sa nastaví ako primárny účet firmy.

Security
bearerAuth
Path
bankAccountintegerrequired

ID bankového účtu.

Example: 201
Bodyapplication/jsonrequired
bankIdinteger or null

Voliteľné ID banky z lookup endpointu bánk. Pošlite null, ak chcete väzbu na banku odstrániť.

Example: 1
namestring

Nový názov bankového účtu.

Example: "Hlavný účet"
ibanstring

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

Example: "SK3111000000001234567890"
swiftstring

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

Example: "TATRSKBX"
autoPairingStrategystring

Nová stratégia automatického párovania platieb pre tento účet. Ak pole vynecháte, zostane zachovaná existujúca hodnota.

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

Pošlite true, ak chcete účet nastaviť ako primárny účet firmy. Ak pole vynecháte alebo pošlete false, aktuálne priradenie primárneho účtu zostane bez zmeny a účet sa touto operáciou neprepne na neprimárny.

Example: true
curl -i -X PUT \
  https://docs.fintoro.sk/_mock/openapi/bank-accounts/201 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "bankId": 1,
    "name": "Hlavný účet",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "autoPairingStrategy": "by_price",
    "isPrimary": true
  }'

Responses

Bankový účet bol aktualizovaný.

Headers
X-Request-Idstring

Unikátny identifikátor requestu pre traceovanie, audit a support diagnostiku.

Example: "req_public_api_01"
Bodyapplication/json
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"
Response
application/json
{
  "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"
}

Zmazať bankový účet

Request

Zmaže bankový účet aktuálnej firmy. Po úspešnom spracovaní endpoint nevracia response body.

Security
bearerAuth
Path
bankAccountintegerrequired

ID bankového účtu.

Example: 201
curl -i -X DELETE \
  https://docs.fintoro.sk/_mock/openapi/bank-accounts/201 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Bankový účet bol zmazaný.

Headers
X-Request-Idstring

Unikátny identifikátor requestu pre traceovanie, audit a support diagnostiku.

Example: "req_public_api_01"
Response
No content

Faktúry

CRUD operácie nad faktúrami aktuálnej firmy.

Operations

Schemas

Schemas