Skip to content
/
Zoznam jednotiek

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

Zoznam bánk

Request

Vráti aktuálny zoznam bánk, ktoré môžete použiť pri vytváraní alebo aktualizácii bankového účtu. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý aktuálny dataset. Zoznam bánk sa priebežne synchronizuje z open banking zdroja, ale existujúce ID ostávajú zachované kvôli kompatibilite s uloženými bankovými účtami. V praxi odporúčame banky synchronizovať približne raz týždenne.

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

Responses

Zoznam bánk.

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

Celý aktuálny zoznam bánk dostupných pre bankové účty.

data[].​idinteger

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

Example: 1
data[].​namestring

Názov banky.

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

URL adresa loga banky, ak je dostupná.

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

SWIFT kód banky, ak je dostupný.

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

Zoznam krajín

Request

Vráti fixný číselník krajín používaný naprieč public API. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID krajín sú stabilné v rámci tejto verzie API a rovnaké hodnoty nájdete aj v referenčnej tabuľke krajín.

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

Responses

Zoznam krajín.

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

Celý zoznam krajín dostupných v tejto verzii API.

data[].​idinteger

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

Example: 703
data[].​namestring

Názov krajiny.

Example: "Slovensko"
data[].​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
data[].​euboolean

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

Example: true
data[].​flagstring

URL adresa ikony vlajky.

Example: "https://flagcdn.com/80x60/sk.png"
Response
application/json
{
  "data": [
    { … }
  ]
}

Zoznam jazykov

Request

Vráti fixný číselník jazykov používaný naprieč public API. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID jazykov sú stabilné v rámci tejto verzie API a rovnaké hodnoty nájdete aj v referenčnej tabuľke jazykov.

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

Responses

Zoznam jazykov.

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

Celý zoznam jazykov dostupných v tejto verzii API.

data[].​idinteger

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

Example: 1
data[].​namestring

Názov jazyka.

Example: "Slovenčina"
data[].​codestring

Krátky jazykový kód.

Example: "sk"
data[].​flagstring

URL adresa ikony vlajky priradenej k jazyku.

Example: "https://flagcdn.com/80x60/sk.png"
Response
application/json
{
  "data": [
    { … }
  ]
}

Zoznam mien

Request

Vráti fixný číselník mien používaný naprieč public API. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID mien sú stabilné v rámci tejto verzie API a rovnaké hodnoty nájdete aj v referenčnej tabuľke mien.

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

Responses

Zoznam mien.

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

Celý zoznam mien dostupných v tejto verzii API.

data[].​idinteger

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

Example: 1
data[].​symbolstring

ISO alebo interný symbol meny.

Example: "EUR"
data[].​namestring

Názov meny.

Example: "Euro"
data[].​markstring

Skrátená značka meny zobrazovaná vo Fintoro.

Example: "€"
data[].​imagestring

URL adresa ikonky meny, ak je dostupná.

Example: "https://example.test/images/currencies/eur.svg"
Response
application/json
{
  "data": [
    { … }
  ]
}

Zoznam spôsobov dodania

Request

Vráti fixný číselník spôsobov dodania používaný naprieč public API. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID spôsobov dodania sú stabilné v rámci tejto verzie API a rovnaké hodnoty nájdete aj v referenčnej tabuľke spôsobov dodania.

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

Responses

Zoznam spôsobov dodania.

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

Celý zoznam spôsobov dodania dostupných v tejto verzii API.

data[].​idinteger

Stabilné ID spôsobu dodania používané v API.

Example: 1
data[].​namestring

Názov spôsobu dodania.

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

Zoznam spôsobov úhrady

Request

Vráti fixný číselník spôsobov úhrady používaný naprieč public API. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID spôsobov úhrady sú stabilné v rámci tejto verzie API a rovnaké hodnoty nájdete aj v referenčnej tabuľke spôsobov úhrady.

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

Responses

Zoznam spôsobov úhrady.

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

Celý zoznam spôsobov úhrady dostupných v tejto verzii API.

data[].​idinteger

Stabilné ID spôsobu úhrady používané v API.

Example: 1
data[].​namestring

Názov spôsobu úhrady.

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

Zoznam QR typov

Request

Vráti fixný číselník QR typov používaný naprieč public API. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID QR typov sú stabilné v rámci tejto verzie API a rovnaké hodnoty nájdete aj v referenčnej tabuľke QR typov.

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

Responses

Zoznam QR typov.

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

Celý zoznam QR typov dostupných v tejto verzii API.

data[].​idinteger

Stabilné ID QR typu používané v API.

Example: 1
data[].​namestring

Názov QR typu.

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

Zoznam jednotiek

Request

Vráti fixný číselník jednotiek používaný naprieč public API. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID jednotiek sú stabilné v rámci tejto verzie API a rovnaké hodnoty nájdete aj v referenčnej tabuľke jednotiek.

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

Responses

Zoznam jednotiek.

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

Celý zoznam jednotiek dostupných v tejto verzii API.

data[].​idinteger

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

Example: 1
data[].​namestring

Názov jednotky.

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

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