Skip to content
/
ClientInput

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

Client

Klient aktuálnej firmy vrátane klientských predvolených hodnôt. Tieto hodnoty neaplikuje API automaticky, ale môžete ich použiť ako odporúčaný default pri skladaní payloadov nových dokladov.

idinteger

Interné ID klienta vo Fintoro.

Example: 101
namestring

Meno osoby alebo obchodné meno klienta.

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

Typ klienta. Hodnota person reprezentuje fyzickú osobu, hodnota company firmu alebo živnostníka evidovaného ako podnikateľský subjekt.

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, ak je dostupné.

Example: "2020123456"
vatIdstring or null

IČ DPH klienta, ak je dostupné.

Example: "SK2020123456"
isVatPayerboolean

Informácia, či je klient aktuálne evidovaný ako platca DPH.

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"
countryCountry (object) or null

Fakturačná krajina klienta ako vnorený objekt.

Any of:

Fakturačná krajina klienta ako vnorený objekt.

country.​idinteger

Stabilné ID krajiny používané v API.

Example: 703
country.​namestring

Názov krajiny.

Example: "Slovensko"
country.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
country.​euboolean

Informácia, či krajina patrí do Európskej únie.

Example: true
country.​flagstring

URL adresa ikony vlajky.

Example: "https://flagcdn.com/80x60/sk.png"
hasDeliveryAddressboolean

Informácia, či má klient uloženú samostatnú dodaciu adresu odlišnú od fakturačnej adresy.

Example: true
deliveryStreetstring or null

Ulica a číslo dodacej adresy.

Example: "Skladová 9"
deliveryCitystring or null

Mesto dodacej adresy.

Example: "Košice"
deliveryZipstring or null

PSČ dodacej adresy.

Example: "04001"
deliveryCountryCountry (object) or null

Dodacia krajina klienta ako vnorený objekt.

Any of:

Dodacia krajina klienta ako vnorený objekt.

deliveryCountry.​idinteger

Stabilné ID krajiny používané v API.

Example: 703
deliveryCountry.​namestring

Názov krajiny.

Example: "Slovensko"
deliveryCountry.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
deliveryCountry.​euboolean

Informácia, či krajina patrí do Európskej únie.

Example: true
deliveryCountry.​flagstring

URL adresa ikony vlajky.

Example: "https://flagcdn.com/80x60/sk.png"
createdAtstring or null(date-time)

Dátum a čas vytvorenia klienta.

Example: "2026-03-03T12:00:00+01:00"
updatedAtstring or null(date-time)

Dátum a čas poslednej úpravy klienta.

Example: "2026-03-03T15:45:00+01:00"
preferredDeliveryMethodIdinteger or null

Predvolená hodnota spôsobu dodania pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, 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 používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, 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 používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, 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 používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, 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 používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.

Example: 14
preferredNotestring or null

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

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

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

Example: 2026001
preferredConstantSymbolinteger or null

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

Example: 308
preferredSpecificSymbolinteger or null

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

Example: 55
preferredTextAboveItemsstring or null

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

Example: "Dakujeme za spoluprácu."
{
  "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",
  "country": {
    "id": 703,
    "name": "Slovensko",
    "code": "SK",
    "eu": true,
    "flag": "https://flagcdn.com/80x60/sk.png"
  },
  "hasDeliveryAddress": true,
  "deliveryStreet": "Skladová 9",
  "deliveryCity": "Košice",
  "deliveryZip": "04001",
  "deliveryCountry": {
    "id": 703,
    "name": "Slovensko",
    "code": "SK",
    "eu": true,
    "flag": "https://flagcdn.com/80x60/sk.png"
  },
  "createdAt": "2026-03-03T12:00:00+01:00",
  "updatedAt": "2026-03-03T15:45:00+01:00",
  "preferredDeliveryMethodId": 1,
  "preferredPaymentMethodId": 1,
  "preferredCurrencyId": 1,
  "preferredLanguageId": 1,
  "preferredDueDays": 14,
  "preferredNote": "Splatnosť 14 dní.",
  "preferredVariableSymbol": 2026001,
  "preferredConstantSymbol": 308,
  "preferredSpecificSymbol": 55,
  "preferredTextAboveItems": "Dakujeme za spoluprácu."
}

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