Skip to content
/
BankAccount

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

ClientInput

Payload pre vytvorenie alebo aktualizáciu klienta. Pošlite len business dáta klienta a voliteľné klientské predvolené hodnoty, ktoré si chcete pri klientovi uložiť ako fallback defaulty pre tvorbu nových dokladov.

namestring

Meno osoby alebo obchodné meno klienta.

Example: "Acme s.r.o."
typestring

Voliteľný typ klienta. Povolené hodnoty sú person a company. Ak ho nepošlete, použije sa person, prípadne company, ak pošlete subjectId, taxId alebo vatId.

Default "person"
Enum"person""company"
Example: "company"
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"
taxIdstring or null

DIČ klienta.

Example: "2020123456"
vatIdstring or null

IČ DPH klienta.

Example: "SK2020123456"
isVatPayerboolean

Voliteľná informácia, či je klient platca DPH. Ak ju nepošlete a vyplníte vatId, nastaví sa automaticky na true.

Example: true
emailstring or null

Kontaktný e-mail klienta.

Example: "billing@acme.test"
streetstring or null

Ulica a číslo fakturačnej adresy.

Example: "Hlavná 1"
citystring or null

Mesto fakturačnej adresy.

Example: "Bratislava"
zipstring or null

PSČ fakturačnej adresy.

Example: "81101"
countryIdinteger or null

ID fakturačnej krajiny z referenčnej tabuľky krajín.

Example: 703
deliveryStreetstring or null

Ulica a číslo dodacej adresy. Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.

Example: "Skladová 9"
deliveryCitystring or null

Mesto dodacej adresy. Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.

Example: "Košice"
deliveryZipstring or null

PSČ dodacej adresy. Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.

Example: "04001"
deliveryCountryIdinteger or null

ID krajiny dodacej adresy z referenčnej tabuľky krajín. Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.

Example: 703
preferredDeliveryMethodIdinteger or null

Predvolená hodnota spôsobu dodania pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky spôsobov dodania.

Example: 1
preferredPaymentMethodIdinteger or null

Predvolená hodnota spôsobu úhrady pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky spôsobov úhrady.

Example: 1
preferredCurrencyIdinteger or null

Predvolená hodnota meny pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky mien.

Example: 1
preferredLanguageIdinteger or null

Predvolená hodnota jazyka pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky jazykov.

Example: 1
preferredDueDaysinteger or null

Predvolený počet dní splatnosti. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.

Example: 14
preferredNotestring or null

Predvolená poznámka. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.

Example: "Splatnosť 14 dní."
stripeCustomerIdstring or null

Externé ID zákazníka v Stripe, ak si ho pri klientovi evidujete.

Example: "cus_public_api_123"
systemeioContactIdinteger or null

Externé ID kontaktu v Systeme.io, ak si ho pri klientovi evidujete.

Example: 123456
preferredVariableSymbolinteger or null

Predvolený variabilný symbol. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.

Example: 2026001
preferredConstantSymbolinteger or null

Predvolený konštantný symbol. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.

Example: 308
preferredSpecificSymbolinteger or null

Predvolený špecifický symbol. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.

Example: 55
preferredTextAboveItemsstring or null

Predvolený text nad položkami. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.

Example: "Dakujeme za spoluprácu."
{
  "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,
  "deliveryStreet": "Skladová 9",
  "deliveryCity": "Košice",
  "deliveryZip": "04001",
  "deliveryCountryId": 703,
  "preferredDeliveryMethodId": 1,
  "preferredPaymentMethodId": 1,
  "preferredCurrencyId": 1,
  "preferredLanguageId": 1,
  "preferredDueDays": 14,
  "preferredNote": "Splatnosť 14 dní.",
  "stripeCustomerId": "cus_public_api_123",
  "systemeioContactId": 123456,
  "preferredVariableSymbol": 2026001,
  "preferredConstantSymbol": 308,
  "preferredSpecificSymbol": 55,
  "preferredTextAboveItems": "Dakujeme za spoluprácu."
}

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"
}