Skip to content
/
ClientSnapshot

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

CompanySnapshot

Snapshot dodávateľa uložený priamo na doklade. Tento objekt reprezentuje firemné údaje v čase vystavenia alebo posledného preuloženia dokladu, aby zostal na doklade zachovaný pôvodný názov, identifikačné údaje a adresa.

namestring

Obchodné meno dodávateľa uložené na faktúre.

Example: "Fintoro s.r.o."
subjectIdstring

IČO dodávateľa uložené na faktúre.

Example: "12345678"
legalFormstring

Právna forma dodávateľa uložená na faktúre.

Example: "Spoločnosť s ručením obmedzeným"
taxIdstring or null

DIČ dodávateľa uložené na faktúre, ak bolo k dispozícii.

Example: "2020123456"
vatIdstring or null

IČ DPH dodávateľa uložené na faktúre, ak bolo k dispozícii.

Example: "SK2020123456"
vatPayerTypeIdinteger

Typ platcu DPH dodávateľa uložený na faktúre.

Example: 4
countrystring

Krajina dodávateľa uložená na faktúre ako textová hodnota.

Example: "Slovensko"
citystring

Mesto dodávateľa uložené na faktúre.

Example: "Bratislava"
streetstring

Ulica a číslo dodávateľa uložené na faktúre.

Example: "Hlavná 1"
zipstring or null

PSČ dodávateľa uložené na faktúre.

Example: "81101"
logostring or null

URL alebo cesta k logu uloženému v snapshot-e, ak bolo k dispozícii.

Example: "https://app.fintoro.sk/storage/company/logo.svg"
signaturestring or null

URL alebo cesta k podpisu uloženému v snapshot-e, ak bol k dispozícii.

Example: "https://app.fintoro.sk/storage/company/signature.png"
registrationCourtstring or null

Registrový súd dodávateľa uložený na faktúre, ak bol k dispozícii.

Example: "Mestský súd Bratislava III"
registrationNumberstring or null

Registračné číslo dodávateľa uložené na faktúre, ak bolo k dispozícii.

Example: "12345/B"
emailstring or null

Kontaktný e-mail dodávateľa uložený na faktúre.

Example: "support@fintoro.sk"
phonestring or null

Kontaktný telefón dodávateľa uložený na faktúre.

Example: "+421900000000"
webstring or null

Web dodávateľa uložený na faktúre.

Example: "https://fintoro.sk"
{
  "name": "Fintoro s.r.o.",
  "subjectId": "12345678",
  "legalForm": "Spoločnosť s ručením obmedzeným",
  "taxId": "2020123456",
  "vatId": "SK2020123456",
  "vatPayerTypeId": 4,
  "country": "Slovensko",
  "city": "Bratislava",
  "street": "Hlavná 1",
  "zip": "81101",
  "logo": "https://app.fintoro.sk/storage/company/logo.svg",
  "signature": "https://app.fintoro.sk/storage/company/signature.png",
  "registrationCourt": "Mestský súd Bratislava III",
  "registrationNumber": "12345/B",
  "email": "support@fintoro.sk",
  "phone": "+421900000000",
  "web": "https://fintoro.sk"
}

ClientSnapshot

Historický snapshot klienta uložený priamo na doklade. Tento objekt reprezentuje stav klientskych údajov v čase vystavenia alebo posledného preuloženia dokladu. Ak si klient neskôr zmení názov alebo adresu, doklad si ponechá túto historickú hodnotu kvôli auditovateľnosti a perzistencii dát. Príklad: doklad vystavený na adresu Hlavná 1, Bratislava zostane historicky správny aj vtedy, keď má klient dnes v profile už inú adresu.

idinteger

Interné ID snapshotu klienta uloženého na doklade.

Example: 101
namestring

Meno osoby alebo obchodné meno klienta uložené na faktúre v danom čase.

Example: "Acme s.r.o."
typestring

Typ klienta uložený na faktúre.

Example: "company"
subjectIdstring or null

IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu viete typicky dohľadať aj cez referenčný register subjektov.

Example: "12345678"
taxIdstring or null

DIČ klienta uložené na faktúre, ak bolo k dispozícii.

Example: "2020123456"
vatIdstring or null

IČ DPH klienta uložené na faktúre, ak bolo k dispozícii.

Example: "SK2020123456"
isVatPayerboolean

Informácia, či bol klient v čase uloženia snapshotu vedený ako platca DPH.

Example: true
emailstring or null

Kontaktný e-mail klienta uložený na faktúre.

Example: "billing@acme.test"
streetstring or null

Ulica a číslo fakturačnej adresy uložené na faktúre.

Example: "Hlavná 1"
citystring or null

Mesto fakturačnej adresy uložené na faktúre.

Example: "Bratislava"
zipstring or null

PSČ fakturačnej adresy uložené na faktúre.

Example: "81101"
countryIdinteger or null

ID krajiny z referenčnej tabuľky krajín.

Example: 703
countryCountry (object) or null

Fakturačná krajina uložená na faktúre ako vnorený objekt.

Any of:

Fakturačná krajina uložená na faktúre ako vnorený objekt.

country.​idinteger

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

Example: 703
country.​namestring

Názov krajiny.

Example: "Slovensko"
country.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
country.​euboolean

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

Example: true
country.​flagstring

URL adresa ikony vlajky.

Example: "https://flagcdn.com/80x60/sk.png"
hasDeliveryAddressboolean

Informácia, či snapshot obsahuje samostatnú dodaciu adresu.

Example: true
deliveryStreetstring or null

Ulica a číslo dodacej adresy uložené na faktúre.

Example: "Skladová 9"
deliveryCitystring or null

Mesto dodacej adresy uložené na faktúre.

Example: "Košice"
deliveryZipstring or null

PSČ dodacej adresy uložené na faktúre.

Example: "04001"
deliveryCountryIdinteger or null

ID krajiny z referenčnej tabuľky krajín.

Example: 703
deliveryCountryCountry (object) or null

Dodacia krajina uložená na faktúre ako vnorený objekt.

Any of:

Dodacia krajina uložená na faktúre ako vnorený objekt.

deliveryCountry.​idinteger

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

Example: 703
deliveryCountry.​namestring

Názov krajiny.

Example: "Slovensko"
deliveryCountry.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
deliveryCountry.​euboolean

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

Example: true
deliveryCountry.​flagstring

URL adresa ikony vlajky.

Example: "https://flagcdn.com/80x60/sk.png"
{
  "id": 101,
  "name": "Acme s.r.o.",
  "type": "company",
  "subjectId": "12345678",
  "taxId": "2020123456",
  "vatId": "SK2020123456",
  "isVatPayer": true,
  "email": "billing@acme.test",
  "street": "Hlavná 1",
  "city": "Bratislava",
  "zip": "81101",
  "countryId": 703,
  "country": {
    "id": 703,
    "name": "Slovensko",
    "code": "SK",
    "eu": true,
    "flag": "https://flagcdn.com/80x60/sk.png"
  },
  "hasDeliveryAddress": true,
  "deliveryStreet": "Skladová 9",
  "deliveryCity": "Košice",
  "deliveryZip": "04001",
  "deliveryCountryId": 703,
  "deliveryCountry": {
    "id": 703,
    "name": "Slovensko",
    "code": "SK",
    "eu": true,
    "flag": "https://flagcdn.com/80x60/sk.png"
  }
}

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
}