Skip to content
/
DeliveryMethod

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

Currency

Mena dostupná v lookup endpointoch public API.

idinteger

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

Example: 1
symbolstring

ISO alebo interný symbol meny.

Example: "EUR"
namestring

Názov meny.

Example: "Euro"
markstring

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

Example: "€"
imagestring

URL adresa ikonky meny, ak je dostupná.

Example: "https://example.test/images/currencies/eur.svg"
{
  "id": 1,
  "symbol": "EUR",
  "name": "Euro",
  "mark": "€",
  "image": "https://example.test/images/currencies/eur.svg"
}

DeliveryMethod

Spôsob dodania dostupný v lookup endpointoch public API.

idinteger

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

Example: 1
namestring

Názov spôsobu dodania.

Example: "Nezadaný"
{
  "id": 1,
  "name": "Nezadaný"
}

PaymentMethod

Spôsob úhrady dostupný v lookup endpointoch public API.

idinteger

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

Example: 1
namestring

Názov spôsobu úhrady.

Example: "Platba prevodom"
{
  "id": 1,
  "name": "Platba prevodom"
}