> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoro.sk/llms.txt
> Use this file to discover all available pages before exploring further.

# Upraviť zálohovú faktúru

> Pošlite úplné údaje ako pri vytvorení vrátane `items` a buď `clientId`, alebo `client`. Vynechané polia sa vyhodnotia podľa pravidiel vytvorenia; pôvodné hodnoty sa nezachovajú.



## OpenAPI

````yaml /openapi.yaml put /proformas/{proforma}
openapi: 3.1.0
info:
  title: Fintoro API v1
  version: 1.0.0
  description: >-
    REST API na vystavovanie faktúr a ďalších dokladov, správu kontaktov, CRM a
    skladov.


    API token určuje firmu, ku ktorej máte prístup. Vytvorenie tokenu a prvé
    volanie popisuje [Prvé pripojenie](/getting-started).
servers:
  - url: https://app.fintoro.sk/api/public/v1
    description: Spoločná URL pre produkčné aj sandboxové firmy.
security:
  - bearerAuth: []
tags:
  - name: Identita tokenu
    description: Overenie firmy priradenej k API tokenu.
  - name: Lookupy
    description: Číselníky so stabilnými ID.
  - name: Číselné rady
    description: Číslovanie dokladov a variabilné symboly.
  - name: Subjekty
    description: Vyhľadávanie firiem a živnostníkov v referenčnom registri.
  - name: Klienti
    description: Klienti, adresy a predvolené hodnoty pre nové doklady.
  - name: Dodávatelia
    description: Dodávatelia a ich identifikačné a fakturačné údaje.
  - name: Stavy obchodných prípadov
    description: Stavy obchodných prípadov zodpovedajú stĺpcom obchodného procesu.
  - name: Obchodné prípady
    description: Obchodné prípady priradené klientovi alebo dodávateľovi.
  - name: CRM udalosti
    description: Poznámky, e-maily, telefonáty, odkazy na doklady a prílohy.
  - name: Bankové účty
    description: Bankové účty a údaje o existujúcom open banking napojení.
  - name: Webhooky
    description: >-
      Odbery udalostí a rotácia secretu. Doručovanie a overenie podpisu popisuje
      [príručka webhookov](/webhooks).
  - name: Sklady
    description: Sklady a číselné rady príjemiek a výdajok.
  - name: Skladové príjemky
    description: Príjem tovaru na sklad.
  - name: Skladové výdajky
    description: Výdaj tovaru zo skladu.
  - name: Skladové a cenníkové položky
    description: Cenník a položky s evidenciou skladového stavu.
  - name: Úhrady dokladov
    description: >-
      Úhrady vystavených a prijatých dokladov. Podporované typy sa líšia podľa
      operácie.
  - name: Dokladové e-maily
    description: Odosielanie dokladov e-mailom.
  - name: Faktúry
    description: Vystavovanie a správa faktúr.
  - name: Dobropisy
    description: Dobropisy naviazané na pôvodnú faktúru.
  - name: Zálohové faktúry
    description: Vystavovanie a správa zálohových faktúr.
  - name: Objednávky
    description: Vystavovanie a správa objednávok.
  - name: Cenové ponuky
    description: Vystavovanie a správa cenových ponúk.
paths:
  /proformas/{proforma}:
    parameters:
      - $ref: '#/components/parameters/ProformaId'
    put:
      tags:
        - Zálohové faktúry
      summary: Upraviť zálohovú faktúru
      description: >-
        Pošlite úplné údaje ako pri vytvorení vrátane `items` a buď `clientId`,
        alebo `client`. Vynechané polia sa vyhodnotia podľa pravidiel
        vytvorenia; pôvodné hodnoty sa nezachovajú.
      operationId: updateProforma
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProformaUpdateInput'
      responses:
        '200':
          description: Zálohová faktúra bola aktualizovaná.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Proforma'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          description: Neplatné údaje požiadavky.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: The given data was invalid.
                  errors:
                    type: object
                    additionalProperties:
                      type: array
                      items:
                        type: string
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
components:
  parameters:
    ProformaId:
      name: proforma
      in: path
      required: true
      description: ID zálohovej faktúry.
      schema:
        type: integer
        example: 401
  schemas:
    ProformaUpdateInput:
      description: >-
        Úplné údaje zálohovej faktúry. Vynechané hodnoty sa vyhodnotia ako pri
        vytvorení.
      allOf:
        - $ref: '#/components/schemas/ProformaInput'
        - type: object
          properties:
            orderId:
              description: >-
                ID objednávky, ktorá ešte nie je priradená alebo je naviazaná na
                práve upravovaný doklad.
              type:
                - integer
                - 'null'
              example: 501
            quotationId:
              description: >-
                ID cenovej ponuky, ktorá ešte nie je priradená alebo je
                naviazaná na práve upravovaný doklad.
              type:
                - integer
                - 'null'
              example: 601
            items:
              description: Položky dokladu.
              type: array
              minItems: 1
              maxItems: 100
              items:
                $ref: '#/components/schemas/ProformaItemInput'
    Proforma:
      description: Zálohová faktúra.
      type: object
      properties:
        id:
          type: integer
          example: 401
        uuid:
          type: string
          example: 6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19
        type:
          type: string
          example: proforma
        number:
          type: string
          example: '20260001'
        webDokladUrl:
          type: string
          format: uri
          description: Absolútna URL na verejný web doklad tejto zálohovej faktúry.
          example: >-
            https://app.fintoro.sk/web-doklad/proforma/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1
        pdfDownloadUrl:
          type: string
          format: uri
          description: >-
            Absolútna URL na Fintoro API endpoint, ktorý stiahne PDF tejto
            zálohovej faktúry ako prílohu.
          example: https://app.fintoro.sk/api/public/v1/proformas/401/pdf
        company:
          $ref: '#/components/schemas/CompanySnapshot'
          description: Údaje dodávateľa uložené priamo na tomto doklade.
        clientId:
          description: >-
            ID klienta. Po jeho zmazaní je `null`; údaje klienta uložené na
            doklade zostanú zachované.
          type:
            - integer
            - 'null'
          example: 101
        client:
          $ref: '#/components/schemas/ClientSnapshot'
          description: >-
            Údaje klienta uložené na doklade. Jeho ID je samostatne v
            `clientId`.
        bankAccount:
          $ref: '#/components/schemas/InvoiceBankAccountReference'
          description: >-
            Bankový účet naviazaný na zálohovú faktúru ako živá väzba načítaná
            aj cez soft delete.
        payments:
          description: Úhrady naviazané na túto zálohovú faktúru v poradí od najnovšej.
          type: array
          items:
            $ref: '#/components/schemas/DocumentPayment'
        variableSymbol:
          type: integer
          example: 20260001
        constantSymbol:
          type:
            - integer
            - 'null'
          example: 308
        specificSymbol:
          type:
            - integer
            - 'null'
          example: 55
        issueDate:
          type: string
          format: date
          example: '2026-03-03'
        dueDate:
          type: string
          format: date
          example: '2026-03-17'
        businessCaseId:
          type:
            - integer
            - 'null'
          description: >-
            Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť
            zvolenému klientovi na doklade.
          example: 701
        discountType:
          type:
            - string
            - 'null'
          example: percentage
        discountValue:
          type:
            - number
            - 'null'
          format: float
          example: 10
        transferTaxLiability:
          type: boolean
          example: false
        numericalSeriesId:
          type:
            - integer
            - 'null'
          example: 12
        deliveryMethodId:
          type: integer
          description: >-
            ID spôsobu dodania z [referenčnej tabuľky spôsobov
            dodania](/reference-tables#sposoby-dodania).
          example: 1
        paymentMethodId:
          type: integer
          description: >-
            ID spôsobu úhrady z [referenčnej tabuľky spôsobov
            úhrady](/reference-tables#sposoby-uhrady).
          example: 1
        currencyId:
          type: integer
          description: ID meny z [referenčnej tabuľky mien](/reference-tables#meny).
          example: 1
        languageId:
          type: integer
          description: ID jazyka z [referenčnej tabuľky jazykov](/reference-tables#jazyky).
          example: 1
        qrTypeId:
          type: integer
          description: >-
            ID QR typu z [referenčnej tabuľky QR
            typov](/reference-tables#qr-typy).
          example: 1
        note:
          type:
            - string
            - 'null'
          example: Ďakujeme za objednávku.
        textAboveItems:
          type:
            - string
            - 'null'
          example: Dakujeme za spoluprácu.
        itemsTotal:
          type: number
          format: float
          example: 200
        itemsTotalWithVat:
          type: number
          format: float
          example: 240
        alreadyPaid:
          type: number
          format: float
          example: 0
        total:
          type: number
          format: float
          example: 200
        totalWithVat:
          type: number
          format: float
          example: 240
        toBePaid:
          type: number
          format: float
          example: 240
        willBePaid:
          type: boolean
          example: true
        status:
          type: string
          enum:
            - paid
            - unpaid
            - partially_paid
            - overdue
            - will_not_be_paid
          example: unpaid
        hasVat:
          type: boolean
          example: true
        items:
          type: array
          items:
            $ref: '#/components/schemas/ProformaItem'
    ProformaInput:
      description: >-
        Pošlite `items` a buď `clientId`, alebo objekt `client`. Predvolené
        hodnoty sú uvedené pri jednotlivých poliach.
      type: object
      required:
        - items
      anyOf:
        - required:
            - clientId
        - required:
            - client
      properties:
        number:
          description: >-
            Manuálne číslo zálohovej faktúry. Bez hodnoty sa vygeneruje z
            číselného radu. Nemožno kombinovať s `numericalSeriesId`.
          type:
            - string
            - 'null'
          minLength: 1
          maxLength: 20
          example: '20260001'
        orderId:
          description: Voliteľné ID objednávky, z ktorej sa zálohová faktúra vytvára.
          type:
            - integer
            - 'null'
          example: 501
        quotationId:
          description: Voliteľné ID cenovej ponuky, z ktorej sa zálohová faktúra vytvára.
          type:
            - integer
            - 'null'
          example: 601
        clientId:
          description: >-
            ID existujúceho klienta firmy. Súčasne zadaný objekt `client` mení
            iba údaje klienta na tomto doklade.
          type:
            - integer
            - 'null'
          example: 101
        client:
          description: >-
            Údaje na vyhľadanie alebo vytvorenie klienta; s `clientId` menia iba
            údaje na doklade.
          anyOf:
            - $ref: '#/components/schemas/InvoiceClientInput'
            - type: 'null'
        businessCaseId:
          description: >-
            Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť
            klientovi určenému cez finálny `clientId`.
          type:
            - integer
            - 'null'
          example: 701
        numericalSeriesId:
          description: >-
            ID číselného radu. Ak ho nepošlete a nepošlete ani `number`, použije
            sa primárny číselný rad pre zálohové faktúry. Ak pošlete
            `numericalSeriesId`, nepošlite zároveň manuálne `number`.
          type:
            - integer
            - 'null'
          example: 12
        bankAccountId:
          description: >-
            Bankový účet firmy. Bez hodnoty sa použije primárny účet; ak
            neexistuje, API vráti `422` pri `bankAccountId`.
          type: integer
          example: 201
        issueDate:
          description: >-
            Dátum vystavenia vo formáte `Y-m-d`. Musí byť po `2009-01-01` a pred
            dátumom o jeden rok v budúcnosti. Ak ho nepošlete, použije sa dnešný
            dátum.
          type: string
          format: date
          example: '2026-03-03'
        dueDateDays:
          description: >-
            Počet dní splatnosti. Priorita je požiadavka → klientská predvolená
            hodnota → nastavenia dokladov firmy.
          type: integer
          minimum: 0
          maximum: 1000
          example: 14
        variableSymbol:
          description: >-
            Variabilný symbol s 1 až 10 číslicami. Bez hodnoty sa odvodí z čísla
            dokladu.
          type: integer
          minimum: 0
          maximum: 9999999999
          example: 20260001
        constantSymbol:
          description: >-
            Konštantný symbol. Povolené sú hodnoty s dĺžkou 1 až 4 číslic.
            Priorita je požiadavka → klientská predvolená hodnota → `null`.
          type:
            - integer
            - 'null'
          minimum: 0
          maximum: 9999
          example: 308
        specificSymbol:
          description: >-
            Špecifický symbol. Povolené sú hodnoty s dĺžkou 1 až 10 číslic.
            Priorita je požiadavka → klientská predvolená hodnota → `null`.
          type:
            - integer
            - 'null'
          minimum: 0
          maximum: 9999999999
          example: 55
        discountType:
          description: Typ zľavy na úrovni celého dokladu.
          type:
            - string
            - 'null'
          enum:
            - percentage
            - fixed
          example: percentage
        discountValue:
          description: Hodnota zľavy na úrovni celého dokladu.
          type:
            - number
            - 'null'
          format: float
          minimum: 0
          example: 10
        transferTaxLiability:
          description: >-
            Príznak prenesenej daňovej povinnosti. Ak ho nepošlete, použije sa
            `false`.
          type: boolean
          example: false
        deliveryMethodId:
          type: integer
          description: >-
            ID spôsobu dodania z [referenčnej tabuľky spôsobov
            dodania](/reference-tables#sposoby-dodania). Priorita je požiadavka
            → klientská predvolená hodnota → nastavenia dokladov firmy.
          example: 1
        paymentMethodId:
          type: integer
          description: >-
            ID spôsobu úhrady z [referenčnej tabuľky spôsobov
            úhrady](/reference-tables#sposoby-uhrady). Priorita je požiadavka →
            klientská predvolená hodnota → nastavenia dokladov firmy.
          example: 1
        currencyId:
          type: integer
          description: >-
            ID meny z [referenčnej tabuľky mien](/reference-tables#meny).
            Priorita je požiadavka → klientská predvolená hodnota → nastavenia
            dokladov firmy.
          example: 1
        languageId:
          type: integer
          description: >-
            ID jazyka z [referenčnej tabuľky jazykov](/reference-tables#jazyky).
            Priorita je požiadavka → klientská predvolená hodnota → nastavenia
            dokladov firmy.
          example: 1
        qrTypeId:
          type: integer
          description: >-
            ID QR typu z [referenčnej tabuľky QR
            typov](/reference-tables#qr-typy). Ak ho nepošlete, použije sa
            nastavenia dokladov firmy.
          example: 1
        note:
          description: >-
            Poznámka na doklade. Priorita je požiadavka → klientská predvolená
            hodnota → nastavenia dokladov firmy.
          type:
            - string
            - 'null'
          maxLength: 3000
          example: Ďakujeme za objednávku.
        textAboveItems:
          description: >-
            Text nad položkami. Priorita je požiadavka → klientská predvolená
            hodnota → nastavenia dokladov firmy.
          type:
            - string
            - 'null'
          maxLength: 3000
          example: Dakujeme za spoluprácu.
        items:
          description: Položky zálohovej faktúry. Toto pole je povinné vždy.
          type: array
          minItems: 1
          maxItems: 100
          items:
            $ref: '#/components/schemas/ProformaItemInput'
    ProformaItemInput:
      description: >-
        S `priceListItemId` sa názov, jednotka, cena a DPH doplnia z cenníka;
        zaslané hodnoty ich prepíšu. Bez ID pošlite ručnú položku s názvom,
        množstvom, cenou a DPH. `uuid` sa ignoruje a `warehouseAllocations` sa
        nepodporujú.
      type: object
      required:
        - quantity
      anyOf:
        - required:
            - priceListItemId
        - required:
            - name
            - unitPrice
            - vatRate
      properties:
        name:
          description: Názov ručnej položky alebo zmena názvu z cenníka.
          type:
            - string
            - 'null'
          maxLength: 255
          example: Konzultácia
        description:
          description: >-
            Voliteľný popis položky. Pri `priceListItemId` môže prepísať alebo
            doplniť popis z cenníkovej položky.
          type:
            - string
            - 'null'
          maxLength: 1000
          example: Mesačný balík konzultácií
        unitPrice:
          description: >-
            Jednotková cena bez DPH. Pri cenníkovej položke prepíše cenu z
            cenníka.
          type:
            - number
            - 'null'
          format: float
          minimum: -10000000000000
          maximum: 10000000000000
          example: 100
        unitId:
          description: >-
            ID jednotky z [číselníka](/reference-tables#jednotky). Bez hodnoty
            sa pri ručnej položke použije `1` (kus), pri cenníkovej položke jej
            jednotka.
          type:
            - integer
            - 'null'
          example: 1
        quantity:
          description: Množstvo položky.
          type: number
          format: float
          minimum: 0.00001
          maximum: 1000000
          example: 2
        vatRate:
          description: >-
            Sadzba DPH v percentách. Pri cenníkovej položke prepíše sadzbu z
            cenníka.
          type:
            - number
            - 'null'
          format: float
          minimum: 0
          maximum: 100
          example: 20
        discountType:
          description: Typ zľavy položky.
          type:
            - string
            - 'null'
          enum:
            - percentage
            - fixed
          example: percentage
        discountValue:
          description: Hodnota zľavy; povinná pri zadanom `discountType`.
          type:
            - number
            - 'null'
          format: float
          minimum: -10000000000000
          maximum: 10000000000000
          example: 10
        discountName:
          description: Názov zľavy. Bez hodnoty sa doplní názov podľa jazyka dokladu.
          type:
            - string
            - 'null'
          maxLength: 255
          example: Vernostná zľava
        priceListItemId:
          description: >-
            ID položky, z ktorej sa preberie názov, jednotka, cena a DPH.
            Jednotlivé hodnoty môžete prepísať.
          type:
            - integer
            - 'null'
          example: 501
    CompanySnapshot:
      description: Údaje firmy v čase vystavenia alebo posledného uloženia dokladu.
      type: object
      properties:
        name:
          description: Obchodné meno dodávateľa uložené na faktúre.
          type: string
          example: Fintoro s.r.o.
        subjectId:
          description: IČO dodávateľa uložené na faktúre.
          type: string
          example: '12345678'
        legalForm:
          description: Právna forma dodávateľa uložená na faktúre.
          type: string
          example: Spoločnosť s ručením obmedzeným
        taxId:
          description: DIČ dodávateľa uložené na faktúre, ak bolo k dispozícii.
          type:
            - string
            - 'null'
          example: '2020123456'
        vatId:
          description: IČ DPH dodávateľa uložené na faktúre, ak bolo k dispozícii.
          type:
            - string
            - 'null'
          example: SK2020123456
        vatPayerTypeId:
          description: Typ platcu DPH dodávateľa uložený na faktúre.
          type: integer
          example: 4
        country:
          description: Krajina dodávateľa uložená na faktúre ako textová hodnota.
          type: string
          example: Slovensko
        city:
          description: Mesto dodávateľa uložené na faktúre.
          type: string
          example: Bratislava
        street:
          description: Ulica a číslo dodávateľa uložené na faktúre.
          type: string
          example: Hlavná 1
        zip:
          description: PSČ dodávateľa uložené na faktúre.
          type:
            - string
            - 'null'
          example: '81101'
        registrationCourt:
          description: Registrový súd dodávateľa uložený na faktúre, ak bol k dispozícii.
          type:
            - string
            - 'null'
          example: Mestský súd Bratislava III
        registrationNumber:
          description: >-
            Registračné číslo dodávateľa uložené na faktúre, ak bolo k
            dispozícii.
          type:
            - string
            - 'null'
          example: 12345/B
        email:
          description: Kontaktný e-mail dodávateľa uložený na faktúre.
          type:
            - string
            - 'null'
          example: support@fintoro.sk
        phone:
          description: Kontaktný telefón dodávateľa uložený na faktúre.
          type:
            - string
            - 'null'
          example: '+421900000000'
        web:
          description: Web dodávateľa uložený na faktúre.
          type:
            - string
            - 'null'
          example: https://fintoro.sk
    ClientSnapshot:
      description: >-
        Údaje klienta v čase vystavenia alebo posledného uloženia dokladu.
        Neskoršia zmena klienta ich automaticky nemení.
      type: object
      properties:
        name:
          description: >-
            Meno osoby alebo obchodné meno klienta uložené na faktúre v danom
            čase.
          type: string
          example: Acme s.r.o.
        type:
          description: Typ klienta uložený na faktúre.
          type: string
          example: company
        subjectId:
          type:
            - string
            - 'null'
          description: >-
            IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu viete
            typicky dohľadať aj cez [referenčný register
            subjektov](#operation/searchSubjects).
          example: '12345678'
        taxId:
          description: DIČ klienta uložené na faktúre, ak bolo k dispozícii.
          type:
            - string
            - 'null'
          example: '2020123456'
        vatId:
          description: IČ DPH klienta uložené na faktúre, ak bolo k dispozícii.
          type:
            - string
            - 'null'
          example: SK2020123456
        isVatPayer:
          description: >-
            Informácia, či bol klient v čase uloženia dokladu vedený ako platca
            DPH.
          type: boolean
          example: true
        email:
          description: Kontaktný e-mail klienta uložený na faktúre.
          type:
            - string
            - 'null'
          example: billing@acme.test
        street:
          description: Ulica a číslo fakturačnej adresy uložené na faktúre.
          type:
            - string
            - 'null'
          example: Hlavná 1
        city:
          description: Mesto fakturačnej adresy uložené na faktúre.
          type:
            - string
            - 'null'
          example: Bratislava
        zip:
          description: PSČ fakturačnej adresy uložené na faktúre.
          type:
            - string
            - 'null'
          example: '81101'
        countryId:
          description: >-
            ID krajiny z [referenčnej tabuľky
            krajín](/reference-tables#krajiny).
          type:
            - integer
            - 'null'
          example: 703
        country:
          description: Fakturačná krajina uložená na faktúre ako vnorený objekt.
          anyOf:
            - $ref: '#/components/schemas/Country'
            - type: 'null'
        hasDeliveryAddress:
          description: Či sú na doklade uložené aj údaje dodacej adresy.
          type: boolean
          example: true
        deliveryStreet:
          description: Ulica a číslo dodacej adresy uložené na faktúre.
          type:
            - string
            - 'null'
          example: Skladová 9
        deliveryCity:
          description: Mesto dodacej adresy uložené na faktúre.
          type:
            - string
            - 'null'
          example: Košice
        deliveryZip:
          description: PSČ dodacej adresy uložené na faktúre.
          type:
            - string
            - 'null'
          example: '04001'
        deliveryCountryId:
          description: >-
            ID krajiny z [referenčnej tabuľky
            krajín](/reference-tables#krajiny).
          type:
            - integer
            - 'null'
          example: 703
        deliveryCountry:
          description: Dodacia krajina uložená na faktúre ako vnorený objekt.
          anyOf:
            - $ref: '#/components/schemas/Country'
            - type: 'null'
    InvoiceBankAccountReference:
      description: >-
        Aktuálne údaje bankového účtu použitého na faktúre. Účet sa načítava aj
        po zmazaní z aktívneho zoznamu.
      type: object
      properties:
        id:
          description: Interné ID bankového účtu vo Fintoro.
          type: integer
          example: 201
        bankId:
          description: >-
            ID banky z [číselníkového endpointu bánk](#operation/listBanks), ak
            je účet naviazaný na známu banku.
          type:
            - integer
            - 'null'
          example: 1
        bank:
          description: Vnorený objekt banky priradenej k účtu, ak je známa.
          anyOf:
            - $ref: '#/components/schemas/Bank'
            - type: 'null'
        name:
          description: Názov bankového účtu v aktuálnom stave databázy.
          type: string
          example: Hlavný účet
        iban:
          description: IBAN naviazaného bankového účtu.
          type: string
          example: SK3111000000001234567890
        swift:
          description: SWIFT alebo BIC kód naviazaného bankového účtu.
          type: string
          example: TATRSKBX
        isPrimary:
          description: Informácia, či je účet aktuálne vedený ako primárny účet firmy.
          type: boolean
          example: true
        autoPaymentMatching:
          description: >-
            Informácia, či je účet aktuálne napojený na automatické párovanie
            platieb cez open banking.
          type: boolean
          example: true
    DocumentPayment:
      description: Úhrada dokladu.
      type: object
      properties:
        id:
          description: Interné ID úhrady.
          type: integer
          example: 801
        documentType:
          description: Typ dokladu, ku ktorému úhrada patrí.
          type: string
          enum:
            - invoice
            - proforma
            - credit-note
          example: invoice
        documentId:
          description: ID dokladu, ku ktorému úhrada patrí.
          type: integer
          example: 301
        paymentMethod:
          $ref: '#/components/schemas/PaymentMethod'
          description: Použitý spôsob úhrady ako vnorený číselníkový objekt.
        currency:
          $ref: '#/components/schemas/Currency'
          description: Mena úhrady ako vnorený číselníkový objekt.
        paymentDate:
          description: Dátum úhrady vo formáte `Y-m-d`.
          type: string
          format: date
          example: '2026-03-07'
        amount:
          description: >-
            Suma v mene úhrady. Ukladá sa so záporným znamienkom pre dobropis, s
            kladným pre faktúru a zálohovú faktúru.
          type: number
          format: float
          example: 15.5
        currencyRate:
          description: Kurz meny úhrady k EUR. Pre EUR je vždy `1.0`.
          type: number
          format: float
          example: 1
        receiptInvoice:
          description: Základné údaje daňového dokladu k prijatej platbe, ak existuje.
          anyOf:
            - $ref: '#/components/schemas/InvoicePreview'
            - type: 'null'
    ProformaItem:
      description: Jedna položka zálohovej faktúry.
      type: object
      properties:
        id:
          type: integer
          example: 1
        name:
          type: string
          example: Konzultácia
        description:
          type:
            - string
            - 'null'
          example: Mesačný balík konzultácií
        unitPrice:
          type: number
          format: float
          example: 100
        unitId:
          description: >-
            ID jednotky z [referenčnej tabuľky
            jednotiek](/reference-tables#jednotky).
          type: integer
          example: 1
        quantity:
          type: number
          format: float
          example: 2
        vatRate:
          type: number
          format: float
          example: 20
        discountName:
          type:
            - string
            - 'null'
          example: Vernostná zľava
        discountType:
          type:
            - string
            - 'null'
          example: percentage
        discountValue:
          type:
            - number
            - 'null'
          format: float
          example: 10
        total:
          type: number
          format: float
          example: 200
        totalWithVat:
          type: number
          format: float
          example: 240
    InvoiceClientInput:
      description: >-
        S `clientId` zadané polia menia iba údaje klienta na doklade, nie
        samotného klienta. Bez `clientId` sa klient vyhľadá v rámci firmy alebo
        vytvorí.


        Poradie hľadania pri firmách: `vatId`, `countryId + subjectId`, `name +
        email`, `name + street`. Pri osobách: `name + email`, `name + street`.
        Pri viacerých zhodách sa použije klient s najnižším ID.
      type: object
      properties:
        name:
          description: >-
            Názov firmy alebo meno osoby. Ak `clientId` neposielate, toto pole
            je povinné.
          type: string
          maxLength: 255
          example: Acme s.r.o.
        type:
          description: Typ klienta. Bez hodnoty sa odvodí z identifikačných údajov.
          type: string
          enum:
            - person
            - company
          example: company
        subjectId:
          description: IČO klienta alebo firmy.
          type:
            - string
            - 'null'
          maxLength: 40
          example: '12345678'
        taxId:
          description: DIČ klienta alebo firmy.
          type:
            - string
            - 'null'
          maxLength: 20
          example: '2020123456'
        vatId:
          description: IČ DPH klienta alebo firmy.
          type:
            - string
            - 'null'
          maxLength: 20
          example: SK2020123456
        isVatPayer:
          description: Či je klient platca DPH. Bez hodnoty sa odvodí zo zadaného `vatId`.
          type: boolean
          example: true
        email:
          description: Kontaktný e-mail klienta.
          type:
            - string
            - 'null'
          format: email
          maxLength: 255
          example: billing@acme.test
        street:
          description: Fakturačná ulica. Pri zadanom `clientId` mení iba údaje na doklade.
          type:
            - string
            - 'null'
          maxLength: 255
          example: Hlavná 1
        city:
          description: Fakturačné mesto klienta.
          type:
            - string
            - 'null'
          maxLength: 255
          example: Bratislava
        zip:
          description: Fakturačné PSČ klienta.
          type:
            - string
            - 'null'
          maxLength: 20
          example: '81101'
        countryId:
          description: >-
            ID krajiny z [referenčnej tabuľky
            krajín](/reference-tables#krajiny).
          type:
            - integer
            - 'null'
          example: 703
        hasDeliveryAddress:
          description: >-
            Či má klient samostatnú dodaciu adresu. Bez hodnoty sa odvodí z
            dodacích polí.
          type: boolean
          example: true
        deliveryStreet:
          description: Dodacia ulica na tomto doklade.
          type:
            - string
            - 'null'
          maxLength: 255
          example: Skladová 5
        deliveryCity:
          description: Dodacie mesto na tomto doklade.
          type:
            - string
            - 'null'
          maxLength: 255
          example: Trnava
        deliveryZip:
          description: Dodacie PSČ na tomto doklade.
          type:
            - string
            - 'null'
          maxLength: 20
          example: '91701'
        deliveryCountryId:
          type:
            - integer
            - 'null'
          description: >-
            ID krajiny dodacej adresy z [referenčnej tabuľky
            krajín](/reference-tables#krajiny).
          example: 703
    Country:
      description: Krajina z číselníka.
      type: object
      properties:
        id:
          description: Stabilné ID krajiny používané v API.
          type: integer
          example: 703
        name:
          description: Názov krajiny podľa `Accept-Language`.
          type: string
          example: Slovensko
        code:
          description: Dvojpísmenový ISO kód krajiny.
          type: string
          example: SK
        eu:
          description: Informácia, či krajina patrí do Európskej únie.
          type: boolean
          example: true
    Bank:
      description: Banka z číselníka so stabilnými ID.
      type: object
      properties:
        id:
          description: >-
            Stabilné ID banky používané vo Fintoro. Po doplnení nových bánk sa
            existujúce ID nemenia ani neprepisujú.
          type: integer
          example: 23
        name:
          description: Názov banky.
          type: string
          example: Tatra Banka
        swift:
          description: SWIFT kód banky, ak je dostupný.
          type: string
          example: TATRSKBX
    PaymentMethod:
      description: Spôsob úhrady z číselníka.
      type: object
      properties:
        id:
          description: Stabilné ID spôsobu úhrady používané v API.
          type: integer
          example: 1
        name:
          description: Názov spôsobu úhrady podľa `Accept-Language`.
          type: string
          example: Platba prevodom
    Currency:
      description: Mena z číselníka.
      type: object
      properties:
        id:
          description: Stabilné ID meny používané v API.
          type: integer
          example: 1
        symbol:
          description: ISO alebo interný symbol meny.
          type: string
          example: EUR
        name:
          description: Názov meny podľa `Accept-Language`.
          type: string
          example: Euro
        mark:
          description: Skrátená značka meny zobrazovaná vo Fintoro.
          type: string
          example: €
    InvoicePreview:
      description: >-
        Záznam v zozname bez položiek a bankového účtu. Obsahuje údaje klienta
        uložené na doklade.
      type: object
      properties:
        id:
          description: Interné ID faktúry vo Fintoro.
          type: integer
          example: 301
        uuid:
          description: Stabilný UUID identifikátor faktúry.
          type: string
          example: 6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19
        type:
          description: Typ dokladu.
          type: string
          example: invoice
        number:
          description: Číslo faktúry.
          type: string
          example: '20260001'
        clientId:
          description: >-
            ID klienta. Po jeho zmazaní je `null`; údaje klienta uložené na
            doklade zostanú zachované.
          type:
            - integer
            - 'null'
          example: 101
        client:
          $ref: '#/components/schemas/InvoicePreviewClient'
          description: >-
            Údaje klienta uložené na doklade. Jeho ID je samostatne v
            `clientId`.
        issueDate:
          description: Dátum vystavenia faktúry.
          type: string
          format: date
          example: '2026-03-03'
        dueDate:
          description: Dátum splatnosti faktúry.
          type: string
          format: date
          example: '2026-03-17'
        deliveryDate:
          description: Dátum dodania.
          type: string
          format: date
          example: '2026-03-03'
        currency:
          $ref: '#/components/schemas/Currency'
          description: Mena faktúry ako vnorený objekt.
        total:
          description: Celková suma bez DPH.
          type: number
          format: float
          example: 200
        totalWithVat:
          description: Celková suma s DPH.
          type: number
          format: float
          example: 240
        toBePaid:
          description: Zostávajúca suma na úhradu.
          type: number
          format: float
          example: 240
        status:
          description: Aktuálny stav úhrady faktúry.
          type: string
          enum:
            - paid
            - unpaid
            - partially_paid
            - overdue
            - will_not_be_paid
          example: unpaid
        hasVat:
          description: Informácia, či faktúra obsahuje položky s DPH.
          type: boolean
          example: true
    InvoicePreviewClient:
      description: Údaje klienta uložené na doklade. ID klienta je samostatne v `clientId`.
      allOf:
        - $ref: '#/components/schemas/ClientSnapshot'
  headers:
    XRequestId:
      description: Identifikátor požiadavky pre diagnostiku a podporu.
      schema:
        type: string
        example: req_public_api_01
    ContentLanguage:
      description: Jazyk vybraný podľa `Accept-Language`.
      schema:
        type: string
        example: en
  responses:
    Forbidden:
      description: Token alebo firma nemá oprávnenie na operáciu.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        Content-Language:
          $ref: '#/components/headers/ContentLanguage'
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: This action is unauthorized.
    NotFound:
      description: Požadovaný zdroj sa nenašiel.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        Content-Language:
          $ref: '#/components/headers/ContentLanguage'
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: No query results for model.
    TooManyRequests:
      description: >-
        Prekročený limit požiadaviek firmy. Pred ďalším pokusom počkajte podľa
        `Retry-After`. [Limity a opakovanie
        požiadaviek](/errors-and-idempotency).
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        X-RateLimit-Limit:
          description: >-
            Limit požiadaviek firmy v aktuálnom 60-sekundovom okne. Vracia sa aj
            pri úspešných požiadavkách.
          schema:
            type: integer
            example: 120
        X-RateLimit-Remaining:
          description: >-
            Zostávajúci počet požiadaviek v aktuálnom okne. Vracia sa aj pri
            úspešných požiadavkách.
          schema:
            type: integer
            example: 0
        Retry-After:
          description: Počet sekúnd do ďalšieho pokusu. Vracia sa pri `429`.
          schema:
            type: integer
            example: 60
        X-RateLimit-Reset:
          description: Čas obnovenia limitu ako Unix timestamp. Vracia sa pri `429`.
          schema:
            type: integer
            example: 1774810800
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Too Many Attempts.
    InternalServerError:
      description: Interná chyba.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        Content-Language:
          $ref: '#/components/headers/ContentLanguage'
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Server Error
    ServiceUnavailable:
      description: Služba je dočasne nedostupná.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        Content-Language:
          $ref: '#/components/headers/ContentLanguage'
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Service Unavailable
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Token
      description: >-
        API token firmy vytvorený vo Fintoro v Automatizácie → Fintoro API.
        [Správa tokenov](/authentication).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.