Skip to content
/
InvoiceItemInput

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

InvoiceWarehouseAllocation

warehouseIdinteger
Example: 1
quantitynumber(float)
Example: 2
{
  "warehouseId": 1,
  "quantity": 2
}

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