Skip to content
/
Zoznam klientov

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

Zoznam klientov

Request

Vráti klientov patriacich aktuálnej firme. Endpoint je vhodný na synchronizáciu klientov do externého systému alebo vlastného frontendu a podporuje základné fulltextové vyhľadávanie, filtrovanie a triedenie.

Security
bearerAuth
Query
searchstring

Fulltextové vyhľadávanie podľa názvu, mesta, PSČ alebo krajiny.

Example: search=bratislava
sortBystring

Pole, podľa ktorého sa majú klienti zoradiť.

Default "name"
Enum"name""city""zip""countryId""createdAt""updatedAt"
Example: sortBy=name
sortDirectionstring

Smer zoradenia.

Default "asc"
Enum"asc""desc"
Example: sortDirection=desc
typestring

Filter podľa typu klienta.

Enum"person""company"
Example: type=company
subjectIdstring

Filter podľa IČO klienta alebo firmy.

Example: subjectId=12345678
taxIdstring

Filter podľa DIČ klienta alebo firmy.

Example: taxId=2020123456
vatIdstring

Filter podľa IČ DPH klienta alebo firmy.

Example: vatId=SK2020123456
countryIdinteger

Filter podľa fakturačnej krajiny klienta z referenčnej tabuľky krajín.

Example: countryId=703
curl -i -X GET \
  'https://docs.fintoro.sk/_mock/openapi/clients?search=bratislava&sortBy=name&sortDirection=desc&type=company&subjectId=12345678&taxId=2020123456&vatId=SK2020123456&countryId=703' \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Zoznam klientov.

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(Client)

Zoznam klientov patriacich aktuálnej firme.

data[].​idinteger

Interné ID klienta vo Fintoro.

Example: 101
data[].​namestring

Meno osoby alebo obchodné meno klienta.

Example: "Acme s.r.o."
data[].​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"
data[].​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"
data[].​taxIdstring or null

DIČ klienta, ak je dostupné.

Example: "2020123456"
data[].​vatIdstring or null

IČ DPH klienta, ak je dostupné.

Example: "SK2020123456"
data[].​isVatPayerboolean

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

Example: true
data[].​emailstring or null

Kontaktný e-mail klienta.

Example: "billing@acme.test"
data[].​streetstring or null

Ulica a číslo fakturačnej adresy.

Example: "Hlavná 1"
data[].​citystring or null

Mesto fakturačnej adresy.

Example: "Bratislava"
data[].​zipstring or null

PSČ fakturačnej adresy.

Example: "81101"
data[].​countryCountry (object) or null

Fakturačná krajina klienta ako vnorený objekt.

Any of:

Fakturačná krajina klienta ako vnorený objekt.

data[].​country.​idinteger

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

Example: 703
data[].​country.​namestring

Názov krajiny.

Example: "Slovensko"
data[].​country.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
data[].​country.​euboolean

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

Example: true
data[].​country.​flagstring

URL adresa ikony vlajky.

Example: "https://flagcdn.com/80x60/sk.png"
data[].​hasDeliveryAddressboolean

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

Example: true
data[].​deliveryStreetstring or null

Ulica a číslo dodacej adresy.

Example: "Skladová 9"
data[].​deliveryCitystring or null

Mesto dodacej adresy.

Example: "Košice"
data[].​deliveryZipstring or null

PSČ dodacej adresy.

Example: "04001"
data[].​deliveryCountryCountry (object) or null

Dodacia krajina klienta ako vnorený objekt.

Any of:

Dodacia krajina klienta ako vnorený objekt.

data[].​deliveryCountry.​idinteger

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

Example: 703
data[].​deliveryCountry.​namestring

Názov krajiny.

Example: "Slovensko"
data[].​deliveryCountry.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
data[].​deliveryCountry.​euboolean

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

Example: true
data[].​deliveryCountry.​flagstring

URL adresa ikony vlajky.

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

Dátum a čas vytvorenia klienta.

Example: "2026-03-03T12:00:00+01:00"
data[].​updatedAtstring or null(date-time)

Dátum a čas poslednej úpravy klienta.

Example: "2026-03-03T15:45:00+01:00"
data[].​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
data[].​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
data[].​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
data[].​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
data[].​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
data[].​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í."
data[].​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
data[].​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
data[].​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
data[].​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."
Response
application/json
{
  "data": [
    { … }
  ]
}

Vytvoriť klienta

Request

Vytvorí nového klienta pre aktuálnu firmu. V requeste posielate business dáta klienta a voliteľné klientské predvolené hodnoty, ktoré sa ukladajú pri klientovi a pri tvorbe nových dokladov sa používajú ako fallback defaulty, ak explicitnú hodnotu nepošlete v payloade. Ak pošlete Idempotency-Key, rovnaký key s rovnakým payloadom vráti pôvodnú odpoveď bez druhého vytvorenia klienta.

Security
bearerAuth
Headers
Idempotency-Keystring

Voliteľný identifikátor requestu pre bezpečné retry. Použite unikátnu hodnotu pre každé create volanie, ktoré chcete vedieť bezpečne zopakovať.

Example: invoice-create-2026-03-03-001
Bodyapplication/jsonrequired
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."
curl -i -X POST \
  https://docs.fintoro.sk/_mock/openapi/clients \
  -H 'Authorization: Bearer <YOUR_Token_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: invoice-create-2026-03-03-001' \
  -d '{
    "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."
  }'

Responses

Klient bol vytvorený.

Headers
X-Request-Idstring

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

Example: "req_public_api_01"
Idempotency-Keystring

Pôvodný idempotency key, ak bol poslaný v requeste.

Idempotency-Statusstring

Original pri prvom spracovaní alebo Repeated pri vrátení pôvodnej odpovede.

Enum"Original""Repeated"
Bodyapplication/json
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."
Response
application/json
{
  "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."
}

Detail klienta

Request

Vráti detail jedného klienta aktuálnej firmy vrátane vnorených krajín a klientských predvolených hodnôt, ktoré môžete použiť pri tvorbe nových dokladov.

Security
bearerAuth
Path
clientintegerrequired

ID klienta.

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

Responses

Detail klienta.

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 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."
Response
application/json
{
  "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."
}

Upraviť klienta

Request

Aktualizuje klienta aktuálnej firmy. Pošlite len polia, ktoré chcete zmeniť. Pri dodacej adrese a inferred poliach platí rovnaké správanie ako pri vytvorení klienta.

Security
bearerAuth
Path
clientintegerrequired

ID klienta.

Example: 101
Bodyapplication/jsonrequired
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."
curl -i -X PUT \
  https://docs.fintoro.sk/_mock/openapi/clients/101 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "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."
  }'

Responses

Klient 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 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."
Response
application/json
{
  "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."
}

Zmazať klienta

Request

Zmaže klienta aktuálnej firmy. Po úspešnom spracovaní endpoint nevracia response body.

Security
bearerAuth
Path
clientintegerrequired

ID klienta.

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

Responses

Klient 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

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