Skip to content
/
InvoicePreviewClient

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

InvoiceBankAccountReference

Bankový účet naviazaný na faktúru ako live väzba. Faktúra tento účet načítava aj cez soft delete, takže detail zostane dostupný aj po jeho zmazaní z aktívneho zoznamu účtov.

idinteger

Interné ID bankového účtu vo Fintoro.

Example: 201
bankIdinteger or null

ID banky z lookup endpointu bánk, ak je účet naviazaný na známu banku.

Example: 1
bankBank (object) or null

Vnorený objekt banky priradenej k účtu, ak je známa.

Any of:

Vnorený objekt banky priradenej k účtu, ak je známa.

bank.​idinteger

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

Example: 1
bank.​namestring

Názov banky.

Example: "Tatra banka"
bank.​logostring

URL adresa loga banky, ak je dostupná.

Example: "https://example.test/tatra-banka.svg"
bank.​swiftstring

SWIFT kód banky, ak je dostupný.

Example: "TATRSKBX"
namestring

Názov bankového účtu v aktuálnom stave databázy.

Example: "Hlavný účet"
ibanstring

IBAN naviazaného bankového účtu.

Example: "SK3111000000001234567890"
swiftstring

SWIFT alebo BIC kód naviazaného bankového účtu.

Example: "TATRSKBX"
isPrimaryboolean

Informácia, či je účet aktuálne vedený ako primárny účet firmy.

Example: true
autoPaymentMatchingboolean

Informácia, či je účet aktuálne napojený na automatické párovanie platieb cez open banking.

Example: true
{
  "id": 201,
  "bankId": 1,
  "bank": {
    "id": 1,
    "name": "Tatra banka",
    "logo": "https://example.test/tatra-banka.svg",
    "swift": "TATRSKBX"
  },
  "name": "Hlavný účet",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "isPrimary": true,
  "autoPaymentMatching": true
}

InvoicePreviewClient

Zjednodušený klient uložený v preview response faktúry.

idinteger

Interné ID klienta vo Fintoro.

Example: 101
namestring

Meno osoby alebo obchodné meno klienta.

Example: "Acme s.r.o."
{
  "id": 101,
  "name": "Acme s.r.o."
}