Skip to content
/
Vytvoriť faktúru

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

Zoznam faktúr

Request

Vráti paginovaný zoznam faktúr aktuálnej firmy v zjednodušenom preview tvare. Tento endpoint je určený na listy, synchronizáciu a rýchly prehľad nad dokladmi. Na detail jedného dokladu použite detail endpoint faktúry.

Security
bearerAuth
Query
numberstring

Filter podľa čísla dokladu.

Example: number=2026
clientIdinteger

Filter podľa klienta.

Example: clientId=101
paymentStatusstring

Filter podľa stavu úhrady.

Enum"paid""unpaid""partially_paid""overdue""will_not_be_paid"
Example: paymentStatus=overdue
issueDateFromstring(date)

Dátum vystavenia od.

Example: issueDateFrom=2026-02-01
issueDateTostring(date)

Dátum vystavenia do.

Example: issueDateTo=2026-02-28
dueDateFromstring(date)

Dátum splatnosti od.

Example: dueDateFrom=2026-03-01
dueDateTostring(date)

Dátum splatnosti do.

Example: dueDateTo=2026-03-31
totalFromnumber(float)

Minimálna celková suma s DPH v mene firmy.

Example: totalFrom=100
totalTonumber(float)

Maximálna celková suma s DPH v mene firmy.

Example: totalTo=1000
sortBystring

Pole pre triedenie. Podporované sú len hodnoty, ktoré podporuje interný list filter faktúr.

Default "issueDate"
Enum"number""issueDate""dueDate""deliveryDate""totalWithVatEur"
Example: sortBy=issueDate
sortDirectionstring

Smer triedenia.

Default "desc"
Enum"asc""desc"
Example: sortDirection=desc
perPageinteger[ 1 .. 500 ]

Počet výsledkov na stránku.

Default 10
Example: perPage=10
pageinteger>= 1

Číslo stránky.

Default 1
Example: page=2
curl -i -X GET \
  'https://docs.fintoro.sk/_mock/openapi/invoices?number=2026&clientId=101&paymentStatus=overdue&issueDateFrom=2026-02-01&issueDateTo=2026-02-28&dueDateFrom=2026-03-01&dueDateTo=2026-03-31&totalFrom=100&totalTo=1000&sortBy=issueDate&sortDirection=desc&perPage=10&page=2' \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Paginovaný zoznam faktúr v preview tvare.

Headers
X-Request-Idstring

Unikátny identifikátor requestu pre traceovanie, audit a support diagnostiku.

Example: "req_public_api_01"
Bodyapplication/json
dataArray of objects(InvoicePreview)

Zoznam preview objektov faktúr pre aktuálnu stránku.

data[].​idinteger

Interné ID faktúry vo Fintoro.

Example: 301
data[].​uuidstring

Stabilný UUID identifikátor faktúry.

Example: "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
data[].​typestring

Typ dokladu.

Example: "invoice"
data[].​numberstring

Číslo faktúry.

Example: "20260001"
data[].​clientobject(InvoicePreviewClient)

Zjednodušený klient patriaci k faktúre.

data[].​client.​idinteger

Interné ID klienta vo Fintoro.

Example: 101
data[].​client.​namestring

Meno osoby alebo obchodné meno klienta.

Example: "Acme s.r.o."
data[].​issueDatestring(date)

Dátum vystavenia faktúry.

Example: "2026-03-03"
data[].​dueDatestring(date)

Dátum splatnosti faktúry.

Example: "2026-03-17"
data[].​deliveryDatestring(date)

Dátum dodania.

Example: "2026-03-03"
data[].​currencyobject(Currency)

Mena faktúry ako vnorený objekt.

data[].​currency.​idinteger

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

Example: 1
data[].​currency.​symbolstring

ISO alebo interný symbol meny.

Example: "EUR"
data[].​currency.​namestring

Názov meny.

Example: "Euro"
data[].​currency.​markstring

Skrátená značka meny zobrazovaná vo Fintoro.

Example: "€"
data[].​currency.​imagestring

URL adresa ikonky meny, ak je dostupná.

Example: "https://example.test/images/currencies/eur.svg"
data[].​totalnumber(float)

Celková suma bez DPH.

Example: 200
data[].​totalWithVatnumber(float)

Celková suma s DPH.

Example: 240
data[].​toBePaidnumber(float)

Zostávajúca suma na úhradu.

Example: 240
data[].​statusstring

Aktuálny stav úhrady faktúry.

Enum"paid""unpaid""partially_paid""overdue""will_not_be_paid"
Example: "unpaid"
data[].​hasVatboolean

Informácia, či faktúra obsahuje položky s DPH.

Example: true
paginatorobject(Paginator)

Informácie o stránkovaní aktuálneho výsledku.

paginator.​currentPageinteger

Aktuálna stránka výsledku.

Example: 2
paginator.​perPageinteger

Počet výsledkov na jednej stránke.

Example: 10
paginator.​totalPagesinteger

Celkový počet stránok.

Example: 5
paginator.​totalResultsinteger

Celkový počet záznamov naprieč všetkými stránkami.

Example: 42
paginator.​currentFrominteger

Poradové číslo prvého záznamu na aktuálnej stránke.

Example: 11
paginator.​currentTointeger

Poradové číslo posledného záznamu na aktuálnej stránke.

Example: 20
paginator.​firstPageUrlstring

URL prvej stránky.

Example: "https://app.fintoro.sk/api/public/v1/invoices?page=1"
paginator.​lastPageUrlstring

URL poslednej stránky.

Example: "https://app.fintoro.sk/api/public/v1/invoices?page=5"
paginator.​nextPageUrlstring or null

URL ďalšej stránky alebo null, ak ďalšia stránka neexistuje.

Example: "https://app.fintoro.sk/api/public/v1/invoices?page=3"
paginator.​previousPageUrlstring or null

URL predchádzajúcej stránky alebo null, ak predchádzajúca stránka neexistuje.

Example: "https://app.fintoro.sk/api/public/v1/invoices?page=1"
paginator.​linksArray of objects(PaginatorLink)

Kompletný zoznam stránkovacích linkov v poradí, v akom ich vracia backend.

paginator.​links[].​urlstring or null

URL cieľovej stránky alebo null, ak daný link nie je dostupný.

Example: "https://app.fintoro.sk/api/public/v1/invoices?page=2"
paginator.​links[].​labelstring

Textový label linku.

Example: "2"
paginator.​links[].​activeboolean

Označuje, či ide o aktuálne aktívnu stránku.

Example: false
Response
application/json
{
  "data": [
    { … }
  ],
  "paginator": {
    "currentPage": 2,
    "perPage": 10,
    "totalPages": 5,
    "totalResults": 42,
    "currentFrom": 11,
    "currentTo": 20,
    "firstPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
    "lastPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=5",
    "nextPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=3",
    "previousPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
    "links": [ … ]
  }
}

Vytvoriť faktúru

Request

Vytvorí novú faktúru aktuálnej firmy.

Odporúčaný flow

Odporúčaný happy path je poslať clientId a items. To je najjednoduchší spôsob, ak klient už vo Fintoro existuje.

Ak klienta ešte vo Fintoro nemáte alebo nechcete robiť samostatný krok na jeho vytvorenie, pošlite objekt client bez clientId. Backend sa pokúsi klienta dopárovať k existujúcemu záznamu a ak nič nenájde, vytvorí nového klienta.

Ak pošlete clientId aj objekt client, objekt client sa správa ako sparse override snapshotu klienta pre tento konkrétny doklad. Môžete tak upraviť napríklad adresu dodania alebo kontaktné údaje len na tejto faktúre bez zmeny klienta v databáze.

Ako fungujú defaulty

Väčšina dokladových polí je voliteľná. Backend ich vyhodnocuje v tomto poradí:

  1. explicitná hodnota z payloadu,
  2. klientské predvolené hodnoty,
  3. firemné document settings,
  4. systémový resolver.

V praxi to znamená napríklad:

  • deliveryMethodId, paymentMethodId, currencyId a languageId sa môžu dopočítať z klienta alebo z firemných nastavení,
  • number a numericalSeriesId sa doplnia z primárneho číselného radu, ak ich nepošlete,
  • variableSymbol sa bez explicitnej hodnoty odvodí z finálneho čísla dokladu,
  • bankAccountId sa bez explicitnej hodnoty vezme z primárneho bankového účtu firmy,
  • currencyRate sa dopočíta podľa meny a dátumu dodania,
  • issueDate a deliveryDate defaultujú na dnešný deň.

Ako funguje client resolution

Ak clientId nepošlete, objekt client sa používa na dopárovanie alebo vytvorenie klienta. Matching prebieha deterministicky v tomto poradí:

  • pri firmách: vatId, potom countryId + subjectId, potom name + email, potom name + street,
  • pri fyzických osobách: name + email, potom name + street.

Ak matching nič nenájde, vytvorí sa nový klient. Ak matching nájde viac klientov, backend použije prvý záznam v stabilnom poradí.

Ak pošlete explicitné clientId alebo bankAccountId a taký záznam neexistuje alebo nepatrí aktuálnej firme, endpoint vráti 404.

Ak bankAccountId nepošlete a firma nemá nastavený žiadny primárny bankový účet, endpoint vráti 422.

Ako fungujú položky

Položka môže byť vytvorená tromi spôsobmi:

  1. ako manuálna položka s vlastným názvom, jednotkou, cenou a DPH,
  2. cez priceListItemId a quantity,
  3. cez priceListItemId a sparse override vybraných polí, napríklad ceny alebo názvu.

Ak pošlete zľavu bez discountName, backend doplní lokalizovaný názov zľavy podľa jazyka dokladu.

Príklady requestov

Existujúci klient a manuálna položka:

{
  "clientId": 101,
  "issueDate": "2026-03-04",
  "items": [
    {
      "name": "Mesačný paušál",
      "quantity": 1,
      "unitId": 1,
      "unitPrice": 120.0,
      "vatRate": 23
    }
  ]
}

Inline klient bez clientId:

{
  "client": {
    "type": "company",
    "name": "Acme s.r.o.",
    "email": "faktury@acme.test",
    "countryId": 703,
    "subjectId": "12345678",
    "street": "Hlavná 1",
    "city": "Bratislava",
    "zip": "81101"
  },
  "items": [
    {
      "name": "Implementácia API",
      "quantity": 10,
      "unitId": 7,
      "unitPrice": 80.0,
      "vatRate": 23
    }
  ]
}

Cenníková položka s minimálnym payloadom:

{
  "clientId": 101,
  "items": [
    {
      "priceListItemId": 501,
      "quantity": 2
    }
  ]
}

Ak pošlete Idempotency-Key, rovnaký key s rovnakým payloadom vráti pôvodnú odpoveď bez druhého vytvorenia faktúry.

Security
bearerAuth
Headers
Idempotency-Keystring

Voliteľný identifikátor requestu pre bezpečné retry. Použite unikátnu hodnotu pre každé create volanie, ktoré chcete vedieť bezpečne zopakovať.

Example: invoice-create-2026-03-03-001
Bodyapplication/jsonrequired
Any of:

Payload pre vytvorenie faktúry. V bežnom prípade stačí poslať clientId a items; ostatné polia môže backend dopočítať. Musíte poslať buď clientId, alebo objekt client.

numberstring or null

Manuálne číslo faktúry. Ak ho nepošlete, backend ho vygeneruje z číselného radu. Ak ho pošlete bez numericalSeriesId, faktúra môže zostať mimo číselného radu.

Example: "20260001"
proformaIdinteger or null

Voliteľné ID zálohovej faktúry, z ktorej sa faktúra vytvára.

Example: 401
orderIdinteger or null

Voliteľné ID objednávky, z ktorej sa faktúra vytvára.

Example: 501
quotationIdinteger or null

Voliteľné ID cenovej ponuky, z ktorej sa faktúra vytvára.

Example: 601
clientIdinteger or nullrequired

ID existujúceho klienta. Toto je odporúčaný spôsob tvorby faktúry. Ak zároveň pošlete objekt client, použije sa ako sparse override snapshotu klienta pre tento konkrétny doklad.

Example: 101
clientobject

Sparse klientský payload používaný pri tvorbe alebo úprave faktúry. Ak pošlete clientId, tento objekt slúži ako voliteľný override snapshotu klienta iba pre konkrétny doklad. Ak clientId nepošlete, backend sa podľa tohto objektu pokúsi nájsť existujúceho klienta alebo vytvoriť nového.

client.​namestring

Názov firmy alebo meno osoby. Ak clientId neposielate, toto pole je povinné.

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

Typ klienta. Povolené hodnoty sú person a company. Ak ho nepošlete, backend ho dopočíta z identifikačných údajov.

Enum"person""company"
Example: "company"
client.​subjectIdstring or null

IČO klienta alebo firmy. Pri slovenských firmách sa používa aj na párovanie existujúceho klienta.

Example: "12345678"
client.​taxIdstring or null

DIČ klienta alebo firmy.

Example: "2020123456"
client.​vatIdstring or null

IČ DPH klienta alebo firmy. Pri firmách ide o primárny matching údaj, ak je k dispozícii.

Example: "SK2020123456"
client.​isVatPayerboolean

Voliteľná informácia, či je klient platca DPH. Ak ju nepošlete a vyplníte vatId, backend ju dopočíta automaticky.

Example: true
client.​emailstring or null(email)

Kontaktný e-mail klienta. Môže sa použiť aj na dopárovanie existujúceho klienta.

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

Fakturačná ulica klienta. Pri sparse override mení len snapshot na tomto doklade.

Example: "Hlavná 1"
client.​citystring or null

Fakturačné mesto klienta.

Example: "Bratislava"
client.​zipstring or null

Fakturačné PSČ klienta.

Example: "81101"
client.​countryIdinteger or null

ID krajiny z referenčnej tabuľky krajín. Pri firmách sa spolu so subjectId používa aj na dopárovanie existujúceho klienta.

Example: 703
client.​hasDeliveryAddressboolean

Voliteľný príznak dodacej adresy. Ak ho nepošlete, backend ho vie odvodiť z dodacích polí.

Example: true
client.​deliveryStreetstring or null

Dodacia ulica klienta pre snapshot na tomto doklade.

Example: "Skladová 5"
client.​deliveryCitystring or null

Dodacie mesto klienta pre snapshot na tomto doklade.

Example: "Trnava"
client.​deliveryZipstring or null

Dodacie PSČ klienta pre snapshot na tomto doklade.

Example: "91701"
client.​deliveryCountryIdinteger or null

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

Example: 703
numericalSeriesIdinteger or null

ID číselného radu. Ak ho nepošlete a nepošlete ani number, použije sa primárny číselný rad pre faktúry. Ak pošlete manuálne number bez tohto poľa, numericalSeriesId zostane null.

Example: 12
bankAccountIdinteger or null

ID bankového účtu, ktorý sa má použiť na faktúre. Ak ho nepošlete, použije sa primárny bankový účet firmy. Ak firma nemá nastavený žiadny primárny bankový účet, endpoint vráti 422 validation error s chybou pri bankAccountId.

Example: 201
issueDatestring or null(date)

Dátum vystavenia. Ak ho nepošlete, použije sa dnešný dátum.

Example: "2026-03-03"
dueDateDaysinteger or null

Počet dní splatnosti. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: 14
deliveryDatestring or null(date)

Dátum dodania. Ak ho nepošlete, použije sa issueDate.

Example: "2026-03-03"
variableSymbolinteger or null

Variabilný symbol. Ak ho nepošlete, backend ho odvodí z finálneho čísla faktúry.

Example: 20260001
constantSymbolinteger or null

Konštantný symbol. Priorita je payload → klientská predvolená hodnota → null.

Example: 308
specificSymbolinteger or null

Špecifický symbol. Priorita je payload → klientská predvolená hodnota → null.

Example: 55
discountTypestring or null

Typ zľavy na úrovni celého dokladu.

Example: "percentage"
discountValuenumber or null(float)

Hodnota zľavy na úrovni celého dokladu.

Example: 10
transferTaxLiabilityboolean

Príznak prenesenej daňovej povinnosti. Ak ho nepošlete, použije sa false.

Example: false
deliveryMethodIdinteger or null

ID spôsobu dodania z referenčnej tabuľky spôsobov dodania. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: 1
paymentMethodIdinteger or null

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: 1
currencyIdinteger or null

ID meny z referenčnej tabuľky mien. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: 1
currencyRatenumber or null(float)

Kurz meny k EUR. Ak ho nepošlete, backend ho vyrieši server-side podľa currencyId a deliveryDate.

Example: 1
languageIdinteger or null

ID jazyka z referenčnej tabuľky jazykov. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: 1
qrTypeIdinteger or null

ID QR typu z referenčnej tabuľky QR typov. Ak ho nepošlete, použije sa document settings firmy.

Example: 1
notestring or null

Poznámka na doklade. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: "Ďakujeme za objednávku."
textAboveItemsstring or null

Text nad položkami. Priorita je payload → klientská predvolená hodnota → document settings firmy.

Example: "Dakujeme za spoluprácu."
itemsArray of objects(InvoiceItemInput)required

Položky faktúry. Toto pole je povinné aj vtedy, keď väčšinu ostatných hodnôt necháte dopočítať backendom.

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.

items[].​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"
items[].​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í"
items[].​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
items[].​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
items[].​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
items[].​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
items[].​discountTypestring or null

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

Example: "percentage"
items[].​discountValuenumber or null(float)

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

Example: 10
items[].​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"
items[].​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"
items[].​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
items[].​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.

items[].​warehouseAllocations[].​warehouseIdinteger
Example: 1
items[].​warehouseAllocations[].​quantitynumber(float)
Example: 2
curl -i -X POST \
  https://docs.fintoro.sk/_mock/openapi/invoices \
  -H 'Authorization: Bearer <YOUR_Token_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: invoice-create-2026-03-03-001' \
  -d '{
    "number": "20260001",
    "proformaId": 401,
    "orderId": 501,
    "quotationId": 601,
    "clientId": 101,
    "client": {
      "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,
      "hasDeliveryAddress": true,
      "deliveryStreet": "Skladová 5",
      "deliveryCity": "Trnava",
      "deliveryZip": "91701",
      "deliveryCountryId": 703
    },
    "numericalSeriesId": 12,
    "bankAccountId": 201,
    "issueDate": "2026-03-03",
    "dueDateDays": 14,
    "deliveryDate": "2026-03-03",
    "variableSymbol": 20260001,
    "constantSymbol": 308,
    "specificSymbol": 55,
    "discountType": "percentage",
    "discountValue": 10,
    "transferTaxLiability": false,
    "deliveryMethodId": 1,
    "paymentMethodId": 1,
    "currencyId": 1,
    "currencyRate": 1,
    "languageId": 1,
    "qrTypeId": 1,
    "note": "Ďakujeme za objednávku.",
    "textAboveItems": "Dakujeme za spoluprácu.",
    "items": [
      {
        "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": [
          {
            "warehouseId": 1,
            "quantity": 2
          }
        ]
      }
    ]
  }'

Responses

Faktúra bola vytvorená.

Headers
X-Request-Idstring

Unikátny identifikátor requestu pre traceovanie, audit a support diagnostiku.

Example: "req_public_api_01"
Idempotency-Keystring

Pôvodný idempotency key, ak bol poslaný v requeste.

Idempotency-Statusstring

Original pri prvom spracovaní alebo Repeated pri vrátení pôvodnej odpovede.

Enum"Original""Repeated"
Bodyapplication/json
idinteger
Example: 301
uuidstring
Example: "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
typestring
Example: "invoice"
numberstring
Example: "20260001"
companyobject(CompanySnapshot)

Snapshot dodávateľa uložený priamo na tomto doklade.

company.​namestring

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

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

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

Example: "12345678"
company.​legalFormstring

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

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

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

Example: "2020123456"
company.​vatIdstring or null

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

Example: "SK2020123456"
company.​vatPayerTypeIdinteger

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

Example: 4
company.​countrystring

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

Example: "Slovensko"
company.​citystring

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

Example: "Bratislava"
company.​streetstring

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

Example: "Hlavná 1"
company.​zipstring or null

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

Example: "81101"
company.​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"
company.​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"
company.​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"
company.​registrationNumberstring or null

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

Example: "12345/B"
company.​emailstring or null

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

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

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

Example: "+421900000000"
company.​webstring or null

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

Example: "https://fintoro.sk"
clientobject(ClientSnapshot)

Historický snapshot klienta uložený priamo na tomto doklade.

client.​idinteger

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

Example: 101
client.​namestring

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

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

Typ klienta uložený na faktúre.

Example: "company"
client.​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"
client.​taxIdstring or null

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

Example: "2020123456"
client.​vatIdstring or null

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

Example: "SK2020123456"
client.​isVatPayerboolean

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

Example: true
client.​emailstring or null

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

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

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

Example: "Hlavná 1"
client.​citystring or null

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

Example: "Bratislava"
client.​zipstring or null

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

Example: "81101"
client.​countryIdinteger or null

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

Example: 703
client.​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.

client.​country.​idinteger

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

Example: 703
client.​country.​namestring

Názov krajiny.

Example: "Slovensko"
client.​country.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
client.​country.​euboolean

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

Example: true
client.​country.​flagstring

URL adresa ikony vlajky.

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

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

Example: true
client.​deliveryStreetstring or null

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

Example: "Skladová 9"
client.​deliveryCitystring or null

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

Example: "Košice"
client.​deliveryZipstring or null

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

Example: "04001"
client.​deliveryCountryIdinteger or null

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

Example: 703
client.​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.

client.​deliveryCountry.​idinteger

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

Example: 703
client.​deliveryCountry.​namestring

Názov krajiny.

Example: "Slovensko"
client.​deliveryCountry.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
client.​deliveryCountry.​euboolean

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

Example: true
client.​deliveryCountry.​flagstring

URL adresa ikony vlajky.

Example: "https://flagcdn.com/80x60/sk.png"
bankAccountobject(InvoiceBankAccountReference)

Bankový účet naviazaný na faktúru ako live väzba načítaná aj cez soft delete.

bankAccount.​idinteger

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

Example: 201
bankAccount.​bankIdinteger or null

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

Example: 1
bankAccount.​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.

bankAccount.​bank.​idinteger

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

Example: 1
bankAccount.​bank.​namestring

Názov banky.

Example: "Tatra banka"
bankAccount.​bank.​logostring

URL adresa loga banky, ak je dostupná.

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

SWIFT kód banky, ak je dostupný.

Example: "TATRSKBX"
bankAccount.​namestring

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

Example: "Hlavný účet"
bankAccount.​ibanstring

IBAN naviazaného bankového účtu.

Example: "SK3111000000001234567890"
bankAccount.​swiftstring

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

Example: "TATRSKBX"
bankAccount.​isPrimaryboolean

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

Example: true
bankAccount.​autoPaymentMatchingboolean

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

Example: true
variableSymbolinteger
Example: 20260001
constantSymbolinteger or null
Example: 308
specificSymbolinteger or null
Example: 55
issueDatestring(date)
Example: "2026-03-03"
dueDatestring(date)
Example: "2026-03-17"
deliveryDatestring(date)
Example: "2026-03-03"
discountTypestring or null
Example: "percentage"
discountValuenumber or null(float)
Example: 10
transferTaxLiabilityboolean
Example: false
numericalSeriesIdinteger or null
Example: 12
deliveryMethodIdinteger

ID spôsobu dodania z referenčnej tabuľky spôsobov dodania.

Example: 1
paymentMethodIdinteger

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady.

Example: 1
currencyIdinteger

ID meny z referenčnej tabuľky mien.

Example: 1
currencyRatenumber(float)
Example: 1
languageIdinteger

ID jazyka z referenčnej tabuľky jazykov.

Example: 1
qrTypeIdinteger

ID QR typu z referenčnej tabuľky QR typov.

Example: 1
notestring or null
Example: "Ďakujeme za objednávku."
textAboveItemsstring or null
Example: "Dakujeme za spoluprácu."
itemsTotalnumber(float)
Example: 200
itemsTotalWithVatnumber(float)
Example: 240
totalnumber(float)
Example: 200
totalWithVatnumber(float)
Example: 240
toBePaidnumber(float)
Example: 240
statusstring
Example: "unpaid"
hasVatboolean
Example: true
creditNotesSumTotalWithVatnumber(float)
Example: 0
itemsArray of objects(InvoiceItem)
items[].​idinteger
Example: 1
items[].​namestring
Example: "Konzultácia"
items[].​descriptionstring or null
Example: "Mesačný balík konzultácií"
items[].​unitPricenumber(float)
Example: 100
items[].​unitIdinteger

ID jednotky z referenčnej tabuľky jednotiek.

Example: 1
items[].​quantitynumber(float)
Example: 2
items[].​vatRatenumber(float)
Example: 20
items[].​discountNamestring or null
Example: "Vernostná zľava"
items[].​discountTypestring or null
Example: "percentage"
items[].​discountValuenumber or null(float)
Example: 10
items[].​priceListItemIdinteger or null
Example: 501
items[].​totalnumber(float)
Example: 200
items[].​totalWithVatnumber(float)
Example: 240
Response
application/json
{
  "id": 301,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "invoice",
  "number": "20260001",
  "company": {
    "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"
  },
  "client": {
    "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": { … },
    "hasDeliveryAddress": true,
    "deliveryStreet": "Skladová 9",
    "deliveryCity": "Košice",
    "deliveryZip": "04001",
    "deliveryCountryId": 703,
    "deliveryCountry": { … }
  },
  "bankAccount": {
    "id": 201,
    "bankId": 1,
    "bank": { … },
    "name": "Hlavný účet",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "isPrimary": true,
    "autoPaymentMatching": true
  },
  "variableSymbol": 20260001,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "deliveryDate": "2026-03-03",
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "numericalSeriesId": 12,
  "deliveryMethodId": 1,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "qrTypeId": 1,
  "note": "Ďakujeme za objednávku.",
  "textAboveItems": "Dakujeme za spoluprácu.",
  "itemsTotal": 200,
  "itemsTotalWithVat": 240,
  "total": 200,
  "totalWithVat": 240,
  "toBePaid": 240,
  "status": "unpaid",
  "hasVat": true,
  "creditNotesSumTotalWithVat": 0,
  "items": [
    { … }
  ]
}

Detail faktúry

Request

Vráti detail jednej faktúry aktuálnej firmy. Response obsahuje snapshot dodávateľa, historický snapshot klienta uložený priamo na doklade a naviazaný bankový účet použitý na faktúre. Snapshoty firmy a klienta reprezentujú stav údajov v čase práce s faktúrou kvôli auditovateľnosti a historickej perzistencii, bankový účet je live väzba načítaná aj cez soft delete.

Security
bearerAuth
Path
invoiceintegerrequired

ID faktúry.

Example: 301
curl -i -X GET \
  https://docs.fintoro.sk/_mock/openapi/invoices/301 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Detail faktúry.

Headers
X-Request-Idstring

Unikátny identifikátor requestu pre traceovanie, audit a support diagnostiku.

Example: "req_public_api_01"
Bodyapplication/json
idinteger
Example: 301
uuidstring
Example: "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
typestring
Example: "invoice"
numberstring
Example: "20260001"
companyobject(CompanySnapshot)

Snapshot dodávateľa uložený priamo na tomto doklade.

company.​namestring

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

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

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

Example: "12345678"
company.​legalFormstring

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

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

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

Example: "2020123456"
company.​vatIdstring or null

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

Example: "SK2020123456"
company.​vatPayerTypeIdinteger

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

Example: 4
company.​countrystring

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

Example: "Slovensko"
company.​citystring

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

Example: "Bratislava"
company.​streetstring

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

Example: "Hlavná 1"
company.​zipstring or null

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

Example: "81101"
company.​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"
company.​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"
company.​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"
company.​registrationNumberstring or null

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

Example: "12345/B"
company.​emailstring or null

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

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

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

Example: "+421900000000"
company.​webstring or null

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

Example: "https://fintoro.sk"
clientobject(ClientSnapshot)

Historický snapshot klienta uložený priamo na tomto doklade.

client.​idinteger

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

Example: 101
client.​namestring

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

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

Typ klienta uložený na faktúre.

Example: "company"
client.​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"
client.​taxIdstring or null

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

Example: "2020123456"
client.​vatIdstring or null

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

Example: "SK2020123456"
client.​isVatPayerboolean

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

Example: true
client.​emailstring or null

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

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

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

Example: "Hlavná 1"
client.​citystring or null

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

Example: "Bratislava"
client.​zipstring or null

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

Example: "81101"
client.​countryIdinteger or null

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

Example: 703
client.​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.

client.​country.​idinteger

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

Example: 703
client.​country.​namestring

Názov krajiny.

Example: "Slovensko"
client.​country.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
client.​country.​euboolean

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

Example: true
client.​country.​flagstring

URL adresa ikony vlajky.

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

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

Example: true
client.​deliveryStreetstring or null

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

Example: "Skladová 9"
client.​deliveryCitystring or null

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

Example: "Košice"
client.​deliveryZipstring or null

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

Example: "04001"
client.​deliveryCountryIdinteger or null

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

Example: 703
client.​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.

client.​deliveryCountry.​idinteger

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

Example: 703
client.​deliveryCountry.​namestring

Názov krajiny.

Example: "Slovensko"
client.​deliveryCountry.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
client.​deliveryCountry.​euboolean

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

Example: true
client.​deliveryCountry.​flagstring

URL adresa ikony vlajky.

Example: "https://flagcdn.com/80x60/sk.png"
bankAccountobject(InvoiceBankAccountReference)

Bankový účet naviazaný na faktúru ako live väzba načítaná aj cez soft delete.

bankAccount.​idinteger

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

Example: 201
bankAccount.​bankIdinteger or null

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

Example: 1
bankAccount.​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.

bankAccount.​bank.​idinteger

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

Example: 1
bankAccount.​bank.​namestring

Názov banky.

Example: "Tatra banka"
bankAccount.​bank.​logostring

URL adresa loga banky, ak je dostupná.

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

SWIFT kód banky, ak je dostupný.

Example: "TATRSKBX"
bankAccount.​namestring

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

Example: "Hlavný účet"
bankAccount.​ibanstring

IBAN naviazaného bankového účtu.

Example: "SK3111000000001234567890"
bankAccount.​swiftstring

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

Example: "TATRSKBX"
bankAccount.​isPrimaryboolean

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

Example: true
bankAccount.​autoPaymentMatchingboolean

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

Example: true
variableSymbolinteger
Example: 20260001
constantSymbolinteger or null
Example: 308
specificSymbolinteger or null
Example: 55
issueDatestring(date)
Example: "2026-03-03"
dueDatestring(date)
Example: "2026-03-17"
deliveryDatestring(date)
Example: "2026-03-03"
discountTypestring or null
Example: "percentage"
discountValuenumber or null(float)
Example: 10
transferTaxLiabilityboolean
Example: false
numericalSeriesIdinteger or null
Example: 12
deliveryMethodIdinteger

ID spôsobu dodania z referenčnej tabuľky spôsobov dodania.

Example: 1
paymentMethodIdinteger

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady.

Example: 1
currencyIdinteger

ID meny z referenčnej tabuľky mien.

Example: 1
currencyRatenumber(float)
Example: 1
languageIdinteger

ID jazyka z referenčnej tabuľky jazykov.

Example: 1
qrTypeIdinteger

ID QR typu z referenčnej tabuľky QR typov.

Example: 1
notestring or null
Example: "Ďakujeme za objednávku."
textAboveItemsstring or null
Example: "Dakujeme za spoluprácu."
itemsTotalnumber(float)
Example: 200
itemsTotalWithVatnumber(float)
Example: 240
totalnumber(float)
Example: 200
totalWithVatnumber(float)
Example: 240
toBePaidnumber(float)
Example: 240
statusstring
Example: "unpaid"
hasVatboolean
Example: true
creditNotesSumTotalWithVatnumber(float)
Example: 0
itemsArray of objects(InvoiceItem)
items[].​idinteger
Example: 1
items[].​namestring
Example: "Konzultácia"
items[].​descriptionstring or null
Example: "Mesačný balík konzultácií"
items[].​unitPricenumber(float)
Example: 100
items[].​unitIdinteger

ID jednotky z referenčnej tabuľky jednotiek.

Example: 1
items[].​quantitynumber(float)
Example: 2
items[].​vatRatenumber(float)
Example: 20
items[].​discountNamestring or null
Example: "Vernostná zľava"
items[].​discountTypestring or null
Example: "percentage"
items[].​discountValuenumber or null(float)
Example: 10
items[].​priceListItemIdinteger or null
Example: 501
items[].​totalnumber(float)
Example: 200
items[].​totalWithVatnumber(float)
Example: 240
Response
application/json
{
  "id": 301,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "invoice",
  "number": "20260001",
  "company": {
    "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"
  },
  "client": {
    "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": { … },
    "hasDeliveryAddress": true,
    "deliveryStreet": "Skladová 9",
    "deliveryCity": "Košice",
    "deliveryZip": "04001",
    "deliveryCountryId": 703,
    "deliveryCountry": { … }
  },
  "bankAccount": {
    "id": 201,
    "bankId": 1,
    "bank": { … },
    "name": "Hlavný účet",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "isPrimary": true,
    "autoPaymentMatching": true
  },
  "variableSymbol": 20260001,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "deliveryDate": "2026-03-03",
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "numericalSeriesId": 12,
  "deliveryMethodId": 1,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "qrTypeId": 1,
  "note": "Ďakujeme za objednávku.",
  "textAboveItems": "Dakujeme za spoluprácu.",
  "itemsTotal": 200,
  "itemsTotalWithVat": 240,
  "total": 200,
  "totalWithVat": 240,
  "toBePaid": 240,
  "status": "unpaid",
  "hasVat": true,
  "creditNotesSumTotalWithVat": 0,
  "items": [
    { … }
  ]
}

Upraviť faktúru

Request

Aktualizuje existujúcu faktúru aktuálnej firmy.

Ako funguje update

  • items sú povinné vždy.
  • Ak pole nepošlete, zachová sa existujúca hodnota na faktúre.
  • Ak nepošlete clientId ani objekt client, zachová sa aktuálny klient aj jeho snapshot na doklade.
  • Ak pošlete clientId a/alebo objekt client, klient a snapshot sa prepočítajú rovnako ako pri create flowe.

Chybové stavy

  • 404, ak explicitne pošlete clientId alebo bankAccountId, ktoré neexistuje alebo nepatrí firme.
  • 422, ak payload neprejde business validáciou, napríklad pri nevalidných položkách faktúry.
Security
bearerAuth
Path
invoiceintegerrequired

ID faktúry.

Example: 301
Bodyapplication/jsonrequired
numberstring or null

Manuálne číslo faktúry. Ak ho nepošlete, zachová sa existujúce číslo faktúry. Ak pošlete nové číslo bez variableSymbol, backend z neho odvodí nový variabilný symbol.

Example: "20260001"
proformaIdinteger or null

Voliteľné ID zálohovej faktúry naviazanej na faktúru. Ak pole nepošlete, zachová sa aktuálna väzba. Pošlite null, ak chcete väzbu odstrániť.

Example: 401
orderIdinteger or null

Voliteľné ID objednávky naviazanej na faktúru. Ak pole nepošlete, zachová sa aktuálna väzba. Pošlite null, ak chcete väzbu odstrániť.

Example: 501
quotationIdinteger or null

Voliteľné ID cenovej ponuky naviazanej na faktúru. Ak pole nepošlete, zachová sa aktuálna väzba. Pošlite null, ak chcete väzbu odstrániť.

Example: 601
clientIdinteger or null

ID existujúceho klienta. Ak ho pošlete, faktúra sa priradí k tomuto klientovi. Ak zároveň pošlete objekt client, použije sa ako sparse override snapshotu klienta pre tento konkrétny doklad. Ak clientId ani client nepošlete, zachová sa aktuálny klient aj snapshot na doklade.

Example: 101
clientobject

Sparse klientský payload používaný pri tvorbe alebo úprave faktúry. Ak pošlete clientId, tento objekt slúži ako voliteľný override snapshotu klienta iba pre konkrétny doklad. Ak clientId nepošlete, backend sa podľa tohto objektu pokúsi nájsť existujúceho klienta alebo vytvoriť nového.

client.​namestring

Názov firmy alebo meno osoby. Ak clientId neposielate, toto pole je povinné.

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

Typ klienta. Povolené hodnoty sú person a company. Ak ho nepošlete, backend ho dopočíta z identifikačných údajov.

Enum"person""company"
Example: "company"
client.​subjectIdstring or null

IČO klienta alebo firmy. Pri slovenských firmách sa používa aj na párovanie existujúceho klienta.

Example: "12345678"
client.​taxIdstring or null

DIČ klienta alebo firmy.

Example: "2020123456"
client.​vatIdstring or null

IČ DPH klienta alebo firmy. Pri firmách ide o primárny matching údaj, ak je k dispozícii.

Example: "SK2020123456"
client.​isVatPayerboolean

Voliteľná informácia, či je klient platca DPH. Ak ju nepošlete a vyplníte vatId, backend ju dopočíta automaticky.

Example: true
client.​emailstring or null(email)

Kontaktný e-mail klienta. Môže sa použiť aj na dopárovanie existujúceho klienta.

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

Fakturačná ulica klienta. Pri sparse override mení len snapshot na tomto doklade.

Example: "Hlavná 1"
client.​citystring or null

Fakturačné mesto klienta.

Example: "Bratislava"
client.​zipstring or null

Fakturačné PSČ klienta.

Example: "81101"
client.​countryIdinteger or null

ID krajiny z referenčnej tabuľky krajín. Pri firmách sa spolu so subjectId používa aj na dopárovanie existujúceho klienta.

Example: 703
client.​hasDeliveryAddressboolean

Voliteľný príznak dodacej adresy. Ak ho nepošlete, backend ho vie odvodiť z dodacích polí.

Example: true
client.​deliveryStreetstring or null

Dodacia ulica klienta pre snapshot na tomto doklade.

Example: "Skladová 5"
client.​deliveryCitystring or null

Dodacie mesto klienta pre snapshot na tomto doklade.

Example: "Trnava"
client.​deliveryZipstring or null

Dodacie PSČ klienta pre snapshot na tomto doklade.

Example: "91701"
client.​deliveryCountryIdinteger or null

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

Example: 703
numericalSeriesIdinteger or null

ID číselného radu. Ak ho nepošlete, zachová sa existujúci číselný rad. Pošlite null, ak chcete väzbu na číselný rad odstrániť pri manuálnom číslovaní.

Example: 12
bankAccountIdinteger or null

ID bankového účtu, ktorý sa má použiť na faktúre. Ak ho nepošlete, zachová sa aktuálny bankový účet faktúry.

Example: 201
issueDatestring or null(date)

Dátum vystavenia. Ak ho nepošlete, zachová sa aktuálny dátum vystavenia.

Example: "2026-03-03"
dueDateDaysinteger or null

Počet dní splatnosti. Ak ho nepošlete a nemeníte issueDate, zachová sa aktuálna splatnosť. Ak zmeníte issueDate bez tohto poľa, backend zachová pôvodný počet dní medzi vystavením a splatnosťou.

Example: 14
deliveryDatestring or null(date)

Dátum dodania. Ak ho nepošlete a nemeníte issueDate, zachová sa aktuálny dátum dodania. Ak zmeníte issueDate bez tohto poľa, použije sa nový issueDate.

Example: "2026-03-03"
variableSymbolinteger or null

Variabilný symbol. Ak ho nepošlete a nemeníte number, zachová sa aktuálny variabilný symbol. Ak zmeníte number bez tohto poľa, backend ho odvodí z nového čísla faktúry.

Example: 20260001
constantSymbolinteger or null

Konštantný symbol. Ak ho nepošlete, zachová sa aktuálna hodnota. Pošlite null, ak ho chcete vymazať.

Example: 308
specificSymbolinteger or null

Špecifický symbol. Ak ho nepošlete, zachová sa aktuálna hodnota. Pošlite null, ak ho chcete vymazať.

Example: 55
discountTypestring or null

Typ zľavy na úrovni celého dokladu.

Example: "percentage"
discountValuenumber or null(float)

Hodnota zľavy na úrovni celého dokladu.

Example: 10
transferTaxLiabilityboolean

Príznak prenesenej daňovej povinnosti. Ak ho nepošlete, zachová sa aktuálna hodnota na faktúre.

Example: false
deliveryMethodIdinteger or null

ID spôsobu dodania z referenčnej tabuľky spôsobov dodania. Ak ho nepošlete, zachová sa aktuálna hodnota na faktúre.

Example: 1
paymentMethodIdinteger or null

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady. Ak ho nepošlete, zachová sa aktuálna hodnota na faktúre.

Example: 1
currencyIdinteger or null

ID meny z referenčnej tabuľky mien. Ak ho nepošlete, zachová sa aktuálna mena faktúry.

Example: 1
currencyRatenumber or null(float)

Kurz meny k EUR. Ak ho nepošlete a nemeníte currencyId ani dátum dodania, zachová sa aktuálny kurz. Ak zmeníte menu alebo dátum dodania bez tohto poľa, backend vyrieši nový kurz server-side.

Example: 1
languageIdinteger or null

ID jazyka z referenčnej tabuľky jazykov. Ak ho nepošlete, zachová sa aktuálny jazyk faktúry.

Example: 1
qrTypeIdinteger or null

ID QR typu z referenčnej tabuľky QR typov. Ak ho nepošlete, zachová sa aktuálna hodnota na faktúre.

Example: 1
notestring or null

Poznámka na doklade. Ak ju nepošlete, zachová sa aktuálna poznámka. Pošlite null, ak ju chcete vymazať.

Example: "Ďakujeme za objednávku."
textAboveItemsstring or null

Text nad položkami. Ak ho nepošlete, zachová sa aktuálna hodnota. Pošlite null, ak ho chcete vymazať.

Example: "Dakujeme za spoluprácu."
itemsArray of objects(InvoiceItemInput)required

Položky faktúry. Toto pole je pri update povinné vždy.

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.

items[].​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"
items[].​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í"
items[].​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
items[].​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
items[].​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
items[].​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
items[].​discountTypestring or null

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

Example: "percentage"
items[].​discountValuenumber or null(float)

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

Example: 10
items[].​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"
items[].​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"
items[].​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
items[].​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.

items[].​warehouseAllocations[].​warehouseIdinteger
Example: 1
items[].​warehouseAllocations[].​quantitynumber(float)
Example: 2
curl -i -X PUT \
  https://docs.fintoro.sk/_mock/openapi/invoices/301 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "number": "20260001",
    "proformaId": 401,
    "orderId": 501,
    "quotationId": 601,
    "clientId": 101,
    "client": {
      "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,
      "hasDeliveryAddress": true,
      "deliveryStreet": "Skladová 5",
      "deliveryCity": "Trnava",
      "deliveryZip": "91701",
      "deliveryCountryId": 703
    },
    "numericalSeriesId": 12,
    "bankAccountId": 201,
    "issueDate": "2026-03-03",
    "dueDateDays": 14,
    "deliveryDate": "2026-03-03",
    "variableSymbol": 20260001,
    "constantSymbol": 308,
    "specificSymbol": 55,
    "discountType": "percentage",
    "discountValue": 10,
    "transferTaxLiability": false,
    "deliveryMethodId": 1,
    "paymentMethodId": 1,
    "currencyId": 1,
    "currencyRate": 1,
    "languageId": 1,
    "qrTypeId": 1,
    "note": "Ďakujeme za objednávku.",
    "textAboveItems": "Dakujeme za spoluprácu.",
    "items": [
      {
        "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": [
          {
            "warehouseId": 1,
            "quantity": 2
          }
        ]
      }
    ]
  }'

Responses

Faktúra bola aktualizovaná.

Headers
X-Request-Idstring

Unikátny identifikátor requestu pre traceovanie, audit a support diagnostiku.

Example: "req_public_api_01"
Bodyapplication/json
idinteger
Example: 301
uuidstring
Example: "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
typestring
Example: "invoice"
numberstring
Example: "20260001"
companyobject(CompanySnapshot)

Snapshot dodávateľa uložený priamo na tomto doklade.

company.​namestring

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

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

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

Example: "12345678"
company.​legalFormstring

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

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

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

Example: "2020123456"
company.​vatIdstring or null

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

Example: "SK2020123456"
company.​vatPayerTypeIdinteger

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

Example: 4
company.​countrystring

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

Example: "Slovensko"
company.​citystring

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

Example: "Bratislava"
company.​streetstring

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

Example: "Hlavná 1"
company.​zipstring or null

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

Example: "81101"
company.​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"
company.​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"
company.​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"
company.​registrationNumberstring or null

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

Example: "12345/B"
company.​emailstring or null

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

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

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

Example: "+421900000000"
company.​webstring or null

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

Example: "https://fintoro.sk"
clientobject(ClientSnapshot)

Historický snapshot klienta uložený priamo na tomto doklade.

client.​idinteger

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

Example: 101
client.​namestring

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

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

Typ klienta uložený na faktúre.

Example: "company"
client.​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"
client.​taxIdstring or null

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

Example: "2020123456"
client.​vatIdstring or null

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

Example: "SK2020123456"
client.​isVatPayerboolean

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

Example: true
client.​emailstring or null

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

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

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

Example: "Hlavná 1"
client.​citystring or null

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

Example: "Bratislava"
client.​zipstring or null

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

Example: "81101"
client.​countryIdinteger or null

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

Example: 703
client.​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.

client.​country.​idinteger

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

Example: 703
client.​country.​namestring

Názov krajiny.

Example: "Slovensko"
client.​country.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
client.​country.​euboolean

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

Example: true
client.​country.​flagstring

URL adresa ikony vlajky.

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

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

Example: true
client.​deliveryStreetstring or null

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

Example: "Skladová 9"
client.​deliveryCitystring or null

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

Example: "Košice"
client.​deliveryZipstring or null

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

Example: "04001"
client.​deliveryCountryIdinteger or null

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

Example: 703
client.​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.

client.​deliveryCountry.​idinteger

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

Example: 703
client.​deliveryCountry.​namestring

Názov krajiny.

Example: "Slovensko"
client.​deliveryCountry.​codestring

Dvojpísmenový ISO kód krajiny.

Example: "SK"
client.​deliveryCountry.​euboolean

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

Example: true
client.​deliveryCountry.​flagstring

URL adresa ikony vlajky.

Example: "https://flagcdn.com/80x60/sk.png"
bankAccountobject(InvoiceBankAccountReference)

Bankový účet naviazaný na faktúru ako live väzba načítaná aj cez soft delete.

bankAccount.​idinteger

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

Example: 201
bankAccount.​bankIdinteger or null

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

Example: 1
bankAccount.​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.

bankAccount.​bank.​idinteger

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

Example: 1
bankAccount.​bank.​namestring

Názov banky.

Example: "Tatra banka"
bankAccount.​bank.​logostring

URL adresa loga banky, ak je dostupná.

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

SWIFT kód banky, ak je dostupný.

Example: "TATRSKBX"
bankAccount.​namestring

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

Example: "Hlavný účet"
bankAccount.​ibanstring

IBAN naviazaného bankového účtu.

Example: "SK3111000000001234567890"
bankAccount.​swiftstring

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

Example: "TATRSKBX"
bankAccount.​isPrimaryboolean

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

Example: true
bankAccount.​autoPaymentMatchingboolean

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

Example: true
variableSymbolinteger
Example: 20260001
constantSymbolinteger or null
Example: 308
specificSymbolinteger or null
Example: 55
issueDatestring(date)
Example: "2026-03-03"
dueDatestring(date)
Example: "2026-03-17"
deliveryDatestring(date)
Example: "2026-03-03"
discountTypestring or null
Example: "percentage"
discountValuenumber or null(float)
Example: 10
transferTaxLiabilityboolean
Example: false
numericalSeriesIdinteger or null
Example: 12
deliveryMethodIdinteger

ID spôsobu dodania z referenčnej tabuľky spôsobov dodania.

Example: 1
paymentMethodIdinteger

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady.

Example: 1
currencyIdinteger

ID meny z referenčnej tabuľky mien.

Example: 1
currencyRatenumber(float)
Example: 1
languageIdinteger

ID jazyka z referenčnej tabuľky jazykov.

Example: 1
qrTypeIdinteger

ID QR typu z referenčnej tabuľky QR typov.

Example: 1
notestring or null
Example: "Ďakujeme za objednávku."
textAboveItemsstring or null
Example: "Dakujeme za spoluprácu."
itemsTotalnumber(float)
Example: 200
itemsTotalWithVatnumber(float)
Example: 240
totalnumber(float)
Example: 200
totalWithVatnumber(float)
Example: 240
toBePaidnumber(float)
Example: 240
statusstring
Example: "unpaid"
hasVatboolean
Example: true
creditNotesSumTotalWithVatnumber(float)
Example: 0
itemsArray of objects(InvoiceItem)
items[].​idinteger
Example: 1
items[].​namestring
Example: "Konzultácia"
items[].​descriptionstring or null
Example: "Mesačný balík konzultácií"
items[].​unitPricenumber(float)
Example: 100
items[].​unitIdinteger

ID jednotky z referenčnej tabuľky jednotiek.

Example: 1
items[].​quantitynumber(float)
Example: 2
items[].​vatRatenumber(float)
Example: 20
items[].​discountNamestring or null
Example: "Vernostná zľava"
items[].​discountTypestring or null
Example: "percentage"
items[].​discountValuenumber or null(float)
Example: 10
items[].​priceListItemIdinteger or null
Example: 501
items[].​totalnumber(float)
Example: 200
items[].​totalWithVatnumber(float)
Example: 240
Response
application/json
{
  "id": 301,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "invoice",
  "number": "20260001",
  "company": {
    "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"
  },
  "client": {
    "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": { … },
    "hasDeliveryAddress": true,
    "deliveryStreet": "Skladová 9",
    "deliveryCity": "Košice",
    "deliveryZip": "04001",
    "deliveryCountryId": 703,
    "deliveryCountry": { … }
  },
  "bankAccount": {
    "id": 201,
    "bankId": 1,
    "bank": { … },
    "name": "Hlavný účet",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "isPrimary": true,
    "autoPaymentMatching": true
  },
  "variableSymbol": 20260001,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "deliveryDate": "2026-03-03",
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "numericalSeriesId": 12,
  "deliveryMethodId": 1,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "qrTypeId": 1,
  "note": "Ďakujeme za objednávku.",
  "textAboveItems": "Dakujeme za spoluprácu.",
  "itemsTotal": 200,
  "itemsTotalWithVat": 240,
  "total": 200,
  "totalWithVat": 240,
  "toBePaid": 240,
  "status": "unpaid",
  "hasVat": true,
  "creditNotesSumTotalWithVat": 0,
  "items": [
    { … }
  ]
}

Zmazať faktúru

Request

Zmaže faktúru aktuálnej firmy.

Security
bearerAuth
Path
invoiceintegerrequired

ID faktúry.

Example: 301
curl -i -X DELETE \
  https://docs.fintoro.sk/_mock/openapi/invoices/301 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Faktúra bola zmazaná.

Headers
X-Request-Idstring

Unikátny identifikátor requestu pre traceovanie, audit a support diagnostiku.

Example: "req_public_api_01"
Response
No content

Schemas

Schemas