CompanySnapshot

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

InvoiceItemInput

Payload jednej položky faktúry. Podporované sú tri režimy: manuálna položka, priceListItemId + quantity, alebo priceListItemId s čiastočnými override poľami. Povinné je vždy quantity. Ak nepošlete priceListItemId, musíte poslať aj name, unitId, unitPrice a vatRate. Ak priceListItemId pošlete, backend si z cenníkovej položky vie dopočítať názov, jednotku, cenu a sadzbu DPH; payload potom slúži len ako sparse override.

Any of:

Payload jednej položky faktúry. Podporované sú tri režimy: manuálna položka, priceListItemId + quantity, alebo priceListItemId s čiastočnými override poľami. Povinné je vždy quantity. Ak nepošlete priceListItemId, musíte poslať aj name, unitId, unitPrice a vatRate. Ak priceListItemId pošlete, backend si z cenníkovej položky vie dopočítať názov, jednotku, cenu a sadzbu DPH; payload potom slúži len ako sparse override.

namestring

Názov položky. Pri manuálnej položke je povinný. Pri použití priceListItemId môže slúžiť ako override názvu z cenníka.

Example: "Konzultácia"

descriptionstring or null

Voliteľný popis položky. Pri priceListItemId môže prepísať alebo doplniť popis z cenníkovej položky.

Example: "Mesačný balík konzultácií"

unitPricenumber(float)

Jednotková cena bez DPH. Pri manuálnej položke je povinná. Pri priceListItemId môže prepísať cenu načítanú z cenníka.

Example: 100

unitIdinteger

ID jednotky z referenčnej tabuľky jednotiek. Pri manuálnej položke je povinné. Pri priceListItemId môže prepísať jednotku z cenníkovej položky.

Example: 1

quantitynumber(float)required

Množstvo položky. Toto pole je povinné vždy, bez ohľadu na to, či ide o manuálnu položku alebo o položku z cenníka.

Example: 2

vatRatenumber(float)

Sadzba DPH v percentách. Pri manuálnej položke je povinná. Pri priceListItemId môže prepísať sadzbu z cenníkovej položky.

Example: 20

discountTypestring or null

Typ zľavy na úrovni položky. Povolené hodnoty sú percentage a fixed.

Example: "percentage"

discountValuenumber or null(float)

Hodnota zľavy na úrovni položky. Ak pošlete discountType, musíte poslať aj toto pole.

Example: 10

discountNamestring or null

Názov zľavy na úrovni položky. Ak ho pri discountType a discountValue nepošlete, backend doplní lokalizované Zľava podľa jazyka dokladu.

Example: "Vernostná zľava"

uuidstring or null

Voliteľný UUID identifikátor položky používaný pri interných sync scenároch. Pri bežnom public create ho neposielate.

Example: "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"

priceListItemIdinteger or nullrequired

ID cenníkovej položky. Ak ho pošlete, backend vie z tejto položky hydratovať názov, jednotku, cenu a sadzbu DPH a payload môže slúžiť len ako sparse override.

Example: 501

warehouseAllocationsArray of objects(InvoiceWarehouseAllocation)

Voliteľné rozpisy množstiev po skladoch. Používajte ich len pri položkách, ktoré majú väzbu na skladové karty a potrebujete explicitne určiť pohyby po skladoch.

warehouseAllocations[].warehouseIdinteger

Example: 1

warehouseAllocations[].quantitynumber(float)

Example: 2

{
  "name": "Konzultácia",
  "description": "Mesačný balík konzultácií",
  "unitPrice": 100,
  "unitId": 1,
  "quantity": 2,
  "vatRate": 20,
  "discountType": "percentage",
  "discountValue": 10,
  "discountName": "Vernostná zľava",
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "priceListItemId": 501,
  "warehouseAllocations": [
    { … }
  ]
}

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"
  }
}

Fintoro Public API v1 (1.0.0)CopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from ClaudeConnect to CursorInstall MCP server on CursorConnect to VS CodeInstall MCP server on VS Code

Lookupy

Subjekty

Klienti

Bankové účty

Faktúry

Schemas

InvoiceItemInput

CompanySnapshot

ClientSnapshot

Fintoro Public API v1 (1.0.0)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude
Connect to Cursor
Install MCP server on Cursor
Connect to VS Code
Install MCP server on VS Code