Skip to content
/
Unit

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

QrType

QR typ dostupný v lookup endpointoch public API.

idinteger

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

Example: 1
namestring

Názov QR typu.

Example: "Negenerovať"
{
  "id": 1,
  "name": "Negenerovať"
}

Unit

Jednotka dostupná v lookup endpointoch public API.

idinteger

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

Example: 1
namestring

Názov jednotky.

Example: "ks"
{
  "id": 1,
  "name": "ks"
}

Subject

Subjekt z referenčného registra. Typicky ho použijete ako podklad pri vytváraní klienta.

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"
{
  "id": 12345678,
  "name": "Acme s.r.o.",
  "taxId": "2020123456",
  "vatId": "SK2020123456",
  "legalForm": "company",
  "city": "Bratislava",
  "street": "Hlavná 1",
  "zip": "81101"
}