Skip to content
/
Vyhľadávanie subjektov

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

Vyhľadávanie subjektov

Request

Tento endpoint použite, keď potrebujete dohľadať údaje o firme alebo živnostníkovi podľa názvu či IČO.

Security
bearerAuth
Query
searchQuerystring>= 3 charactersrequired

Hľadaný reťazec. Môže to byť názov subjektu alebo IČO. Minimum sú 3 znaky.

Example: searchQuery=acme
legalFormstring

Voliteľný filter podľa právnej formy, ak chcete výsledky zúžiť len na firmy alebo živnostníkov.

Enum"freelancer""company"
Example: legalForm=company
limitinteger[ 1 .. 20 ]

Maximálny počet výsledkov, ktoré endpoint vráti.

Example: limit=5
curl -i -X GET \
  'https://docs.fintoro.sk/_mock/openapi/subjects?searchQuery=acme&legalForm=company&limit=5' \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Vracia zodpovedajúce subjekty z referenčného registra.

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

Zoznam nájdených subjektov.

data[].​idinteger

IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu zvyčajne viete nájsť aj cez referenčný register subjektov.

Example: 12345678
data[].​namestring

Obchodné meno alebo názov subjektu.

Example: "Acme s.r.o."
data[].​taxIdstring or null

DIČ subjektu, ak je dostupné.

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

IČ DPH subjektu, ak je dostupné.

Example: "SK2020123456"
data[].​legalFormstring

Právna forma subjektu.

Enum"freelancer""company"
Example: "company"
data[].​citystring or null

Mesto sídla alebo miesta podnikania.

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

Ulica a číslo sídla alebo miesta podnikania.

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

PSČ sídla alebo miesta podnikania.

Example: "81101"
Response
application/json
{
  "data": [
    { … }
  ]
}

Detail subjektu

Request

Vráti jeden konkrétny subjekt z referenčného registra podľa jeho ID.

Security
bearerAuth
Path
subjectintegerrequired

ID subjektu z referenčného registra.

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

Responses

Vracia detail požadovaného subjektu.

Headers
X-Request-Idstring

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

Example: "req_public_api_01"
Bodyapplication/json
idinteger

IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu zvyčajne viete nájsť aj cez referenčný register subjektov.

Example: 12345678
namestring

Obchodné meno alebo názov subjektu.

Example: "Acme s.r.o."
taxIdstring or null

DIČ subjektu, ak je dostupné.

Example: "2020123456"
vatIdstring or null

IČ DPH subjektu, ak je dostupné.

Example: "SK2020123456"
legalFormstring

Právna forma subjektu.

Enum"freelancer""company"
Example: "company"
citystring or null

Mesto sídla alebo miesta podnikania.

Example: "Bratislava"
streetstring or null

Ulica a číslo sídla alebo miesta podnikania.

Example: "Hlavná 1"
zipstring or null

PSČ sídla alebo miesta podnikania.

Example: "81101"
Response
application/json
{
  "id": 12345678,
  "name": "Acme s.r.o.",
  "taxId": "2020123456",
  "vatId": "SK2020123456",
  "legalForm": "company",
  "city": "Bratislava",
  "street": "Hlavná 1",
  "zip": "81101"
}

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