Skip to content
/
InvoiceWarehouseAllocatio...

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

InvoiceItem

Jedna položka faktúry.

idinteger
Example: 1
namestring
Example: "Konzultácia"
descriptionstring or null
Example: "Mesačný balík konzultácií"
unitPricenumber(float)
Example: 100
unitIdinteger

ID jednotky z referenčnej tabuľky jednotiek.

Example: 1
quantitynumber(float)
Example: 2
vatRatenumber(float)
Example: 20
discountNamestring or null
Example: "Vernostná zľava"
discountTypestring or null
Example: "percentage"
discountValuenumber or null(float)
Example: 10
priceListItemIdinteger or null
Example: 501
totalnumber(float)
Example: 200
totalWithVatnumber(float)
Example: 240
{
  "id": 1,
  "name": "Konzultácia",
  "description": "Mesačný balík konzultácií",
  "unitPrice": 100,
  "unitId": 1,
  "quantity": 2,
  "vatRate": 20,
  "discountName": "Vernostná zľava",
  "discountType": "percentage",
  "discountValue": 10,
  "priceListItemId": 501,
  "total": 200,
  "totalWithVat": 240
}

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": [
    { … }
  ]
}