> ## 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.

# Vytvoriť skladovú výdajku

> Vytvorí novú skladovú výdajku. Ak pošlete `clientId`, použije sa existujúci klient. Ak `clientId` nepošlete a pošlete objekt `client`, backend podľa týchto údajov klienta dopáruje alebo vytvorí. Request používa rovnakú stock availability validáciu ako web, preto pri nedostatočnom stave skladu endpoint vráti `422`.



## OpenAPI

````yaml /openapi.yaml post /warehouse-outbound-receipts
openapi: 3.1.0
info:
  title: Fintoro API v1
  version: 1.0.0
  description: >
    Fintoro API v1 je REST API pre integráciu Fintoro fakturácie, CRM a
    skladového systému do systémov tretích strán.


    Produkčné aj sandboxové firmy používajú rovnakú základnú URL
    `https://app.fintoro.sk/api/public/v1`. O tom, s ktorou firmou pracujete,
    rozhoduje bearer token.


    Voliteľný request header `Accept-Language` lokalizuje systémové názvy v
    lookupoch, v súvisiacich objektoch v odpovediach aj vo validačných chybách.
    Response header `Content-Language` vracia jazyk použitý v odpovedi.


    Pre onboarding a prevádzkové pravidlá si pozrite aj:

    - [Začíname](/getting-started)

    - [Autentifikácia](/authentication)

    - [Webhooky](/webhooks)

    - [Testovanie v sandboxe](/sandbox-testing)

    - [Konvencie API](/conventions)

    - [Chyby a idempotencia](/errors-and-idempotency)
servers:
  - url: https://app.fintoro.sk/api/public/v1
    description: Produkčné Fintoro API.
security:
  - bearerAuth: []
tags:
  - name: Identita tokenu
    description: >-
      Technický read-only endpoint na overenie, ku ktorej firme bearer token
      aktuálne patrí.
  - name: Lookupy
    description: >-
      Endpointy len na čítanie pre integračné dáta. Tieto endpointy vracajú
      číselníky so stabilnými ID, ktoré môžete bezpečne ukladať do cache na
      svojej strane. Pri doplnení nových lookup hodnôt sa existujúce ID nemenia
      ani neprepisujú.
  - name: Číselné rady
    description: >-
      Endpointy len na čítanie nad číselnými radmi. Vracia sa aktuálna
      konfigurácia použitá pri tvorbe dokladov vrátane ďalšieho vygenerovaného
      čísla a variabilného symbolu.
  - name: Subjekty
    description: Vyhľadanie a overenie údajov o subjekte ešte pred vytvorením klienta.
  - name: Klienti
    description: >-
      Správa klientov vrátane fakturačnej adresy, dodacej adresy a klientských
      predvolených hodnôt použiteľných pri tvorbe nových dokladov. Create,
      update a delete operácie môžu emitovať webhook eventy `clients.created`,
      `clients.updated` a `clients.deleted`.
  - name: Dodávatelia
    description: >-
      Správa dodávateľov vrátane fakturačnej adresy a identifikačných údajov
      použiteľných aj pri resolve-or-create flowe skladových príjemiek. Create,
      update a delete operácie môžu emitovať webhook eventy `suppliers.created`,
      `suppliers.updated` a `suppliers.deleted`.
  - name: Stavy obchodných prípadov
    description: >-
      Správa stavov obchodných prípadov. Stavy reprezentujú stĺpce pipeline.
      Endpoint na zmenu poradia v tejto verzii dostupný nie je; pri zmazaní
      stavu sa naviazané obchodné prípady odviažu na `null`. Create, update a
      delete operácie môžu emitovať webhook eventy
      `business-case-statuses.created`, `business-case-statuses.updated` a
      `business-case-statuses.deleted`.
  - name: Obchodné prípady
    description: >-
      Správa obchodných prípadov vrátane vnoreného klienta alebo dodávateľa a
      voliteľného stavu. Zmena poradia ani zmena naviazaného kontaktu cez update
      v tejto verzii dostupné nie sú. Create, update a delete operácie môžu
      emitovať webhook eventy `business-cases.created`, `business-cases.updated`
      a `business-cases.deleted`.
  - name: CRM udalosti
    description: >-
      Správa CRM udalostí pre typy `note`, `email`, `phone_call` a
      `document_linked`. Attachmenty používajú dvojkrokový upload cez samostatný
      endpoint. Create, update a delete operácie môžu emitovať webhook eventy
      `contact-activity-logs.created`, `contact-activity-logs.updated` a
      `contact-activity-logs.deleted`.
  - name: Bankové účty
    description: >-
      Správa bankových účtov vrátane údajov o banke, primárnom účte a stave open
      banking napojenia. Create, update a delete operácie môžu emitovať webhook
      eventy `bank-accounts.created`, `bank-accounts.updated` a
      `bank-accounts.deleted`.
  - name: Webhooky
    description: >-
      Správa odberov webhookov pre Fintoro API. Táto sekcia pokrýva CRUD
      operácie nad odbermi, manuálnu rotáciu secretu a payload kontrakt pre
      integrácie riadené udalosťami. Kontrakt doručenia, overenie podpisu, retry
      mechanizmus a podrobný katalóg eventov nájdete v [príručke
      Webhooky](/webhooks).
  - name: Sklady
    description: >-
      CRUD operácie nad skladmi vrátane inbound a outbound číselných radov.
      Create, update a delete operácie môžu emitovať webhook eventy
      `warehouses.created`, `warehouses.updated` a `warehouses.deleted`.
  - name: Skladové príjemky
    description: >-
      CRUD operácie nad skladovými príjemkami vrátane detailu skladu,
      dodávateľského snapshotu, položiek a `pdfDownloadUrl`. Create, update a
      delete operácie môžu emitovať webhook eventy
      `warehouse-inbound-receipts.created`, `warehouse-inbound-receipts.updated`
      a `warehouse-inbound-receipts.deleted`.
  - name: Skladové výdajky
    description: >-
      CRUD operácie nad skladovými výdajkami vrátane detailu skladu, klientského
      snapshotu, položiek a `pdfDownloadUrl`. Create a update flow používajú
      rovnakú stock availability validáciu ako web. Create, update a delete
      operácie môžu emitovať webhook eventy
      `warehouse-outbound-receipts.created`,
      `warehouse-outbound-receipts.updated` a
      `warehouse-outbound-receipts.deleted`.
  - name: Skladové a cenníkové položky
    description: >-
      CRUD operácie nad skladovými a cenníkovými položkami. Endpointy vracajú
      jednotku ako vnorený objekt, podporujú filtrovanie podľa názvu, EANu,
      skladového kódu, ceny a stavu skladu a používajú rovnaký business kontrakt
      ako administrácia Fintoro pre warehouse evidenciu, EAN a nákupné ceny.
      Create, update a delete operácie môžu emitovať webhook eventy
      `price-list-items.created`, `price-list-items.updated` a
      `price-list-items.deleted`. Zmeny skladového stavu vyvolané skladovými
      príjemkami a výdajkami môžu emitovať webhook event
      `price-list-items.stock-updated`.
  - name: Úhrady dokladov
    description: >-
      Evidencia úhrad pre podporované doklady. Táto sekcia pokrýva zoznam úhrad
      konkrétneho dokladu, vytvorenie novej úhrady, detail jednej úhrady a jej
      zmazanie. Podporované typy dokladov sú `invoice`, `proforma`,
      `credit-note`, `received-invoice` a `received-receipt`. Create a delete
      operácie môžu emitovať webhook eventy `document-payments.created` a
      `document-payments.deleted`. Ak nová úhrada spôsobí, že podporovaný doklad
      sa stane plne uhradeným, môže sa navyše vyemitovať aj zodpovedajúci
      `*.paid` event pre daný resource dokladu.
  - name: Dokladové e-maily
    description: >-
      Odosielanie podporovaných public dokumentov emailom. Endpoint používa
      jednotný kontrakt nad kombináciou `documentType` + `documentId`, validuje
      vlastníctvo dokladu a podporuje typy `invoice`, `proforma`, `order`,
      `credit-note` a `quotation`.
  - name: Faktúry
    description: >-
      CRUD operácie nad faktúrami. Create, update a delete operácie môžu
      emitovať webhook eventy `invoices.created`, `invoices.updated` a
      `invoices.deleted`. Keď sa faktúra po zaevidovaní úhrady stane plne
      uhradenou, môže sa vyemitovať aj `invoices.paid`.
  - name: Dobropisy
    description: >-
      CRUD operácie nad dobropismi. Kontrakt používa camelCase payloady, plný
      `PUT` update flow a explicitnú väzbu na pôvodnú faktúru cez `invoiceId`.
      Klient dobropisu sa vždy odvodzuje zo zvolenej zdrojovej faktúry;
      `clientId` nie je súčasťou request kontraktu a inline client resolution
      ani create flow sa tu nepoužívajú. Create, update a delete operácie môžu
      emitovať webhook eventy `credit-notes.created`, `credit-notes.updated` a
      `credit-notes.deleted`. Keď sa dobropis po zaevidovaní úhrady stane plne
      uhradeným, môže sa vyemitovať aj `credit-notes.paid`.
  - name: Zálohové faktúry
    description: >-
      CRUD operácie nad zálohovými faktúrami. Kontrakt je navrhnutý rovnakou
      filozofiou ako Fintoro API faktúry: camelCase payloady, deterministický
      resolve/create klienta, create-like defaulty a plný `PUT` update flow bez
      patch fallbacku na pôvodný stav dokladu. Create, update a delete operácie
      môžu emitovať webhook eventy `proformas.created`, `proformas.updated`,
      `proformas.deleted` a pri plnom uhradení po zaevidovaní úhrady aj
      `proformas.paid`.
  - name: Objednávky
    description: >-
      CRUD operácie nad objednávkami. Kontrakt používa camelCase payloady,
      deterministický resolve/create klienta, create-like defaulty a plný `PUT`
      update flow bez patch fallbacku na pôvodný stav dokladu. Create, update a
      delete operácie môžu emitovať webhook eventy `orders.created`,
      `orders.updated` a `orders.deleted`.
  - name: Cenové ponuky
    description: >-
      CRUD operácie nad cenovými ponukami. Kontrakt používa camelCase payloady,
      deterministický resolve/create klienta, create-like defaulty a plný `PUT`
      update flow bez patch fallbacku na pôvodný stav dokladu. Create, update a
      delete operácie môžu emitovať webhook eventy `quotations.created`,
      `quotations.updated` a `quotations.deleted`.
paths:
  /warehouse-outbound-receipts:
    post:
      tags:
        - Skladové výdajky
      summary: Vytvoriť skladovú výdajku
      description: >-
        Vytvorí novú skladovú výdajku. Ak pošlete `clientId`, použije sa
        existujúci klient. Ak `clientId` nepošlete a pošlete objekt `client`,
        backend podľa týchto údajov klienta dopáruje alebo vytvorí. Request
        používa rovnakú stock availability validáciu ako web, preto pri
        nedostatočnom stave skladu endpoint vráti `422`.
      operationId: createWarehouseOutboundReceipt
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WarehouseOutboundReceiptCreateInput'
      responses:
        '201':
          description: Skladová výdajka bola vytvorená.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
            Idempotency-Key:
              description: Pôvodný idempotency key, ak bol poslaný v requeste.
              schema:
                type: string
            Idempotency-Status:
              description: >-
                `Original` pri prvom spracovaní alebo `Repeated` pri vrátení
                pôvodnej odpovede.
              schema:
                type: string
                enum:
                  - Original
                  - Repeated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WarehouseOutboundReceipt'
        '422':
          $ref: '#/components/responses/ValidationError'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      description: >-
        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ť.
      schema:
        type: string
        example: invoice-create-2026-03-03-001
  schemas:
    WarehouseOutboundReceiptCreateInput:
      description: Payload pre vytvorenie skladovej výdajky.
      type: object
      required:
        - number
        - warehouseId
        - languageId
        - issueDate
        - items
      properties:
        number:
          description: >-
            Číslo skladovej výdajky. Ak chcete použiť automatické ďalšie číslo
            skladu, pošlite ho explicitne podľa aktuálneho warehouse radu.
          type: string
          minLength: 1
          maxLength: 20
          example: VYD-2026-0001
        warehouseId:
          description: ID skladu.
          type: integer
          example: 301
        clientId:
          description: >-
            Voliteľné ID existujúceho klienta. Ak pošlete `clientId`, objekt
            `client` sa použije len ako override snapshotu pre túto konkrétnu
            výdajku.
          type:
            - integer
            - 'null'
          example: 101
        client:
          description: >-
            Sparse klientský payload. Ak pošlete `clientId`, slúži ako override
            snapshotu na výdajke. Ak `clientId` nepošlete, backend podľa týchto
            údajov klienta dopáruje alebo vytvorí.
          anyOf:
            - $ref: '#/components/schemas/WarehouseOutboundReceiptClientInput'
            - type: 'null'
        languageId:
          description: ID jazyka z lookup endpointu jazykov.
          type: integer
          example: 1
        issueDate:
          description: Dátum vystavenia výdajky.
          type: string
          format: date
          example: '2026-03-11'
        note:
          description: Voliteľná interná poznámka na výdajke.
          type:
            - string
            - 'null'
          maxLength: 3000
          example: Výdaj pre manuálny odber
        items:
          description: >-
            Položky výdajky. Každá položka musí smerovať na warehouse-enabled
            cenníkovú položku a backend overuje dostupný stock.
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/WarehouseReceiptLineInput'
    WarehouseOutboundReceipt:
      description: Skladová výdajka vrátane skladu, klientského snapshotu a položiek.
      type: object
      properties:
        id:
          description: Interné ID skladovej výdajky.
          type: integer
          example: 951
        uuid:
          description: Verejné UUID skladovej výdajky použité aj vo webDoklad URL.
          type: string
          example: 3f4c9fdd-6f9b-42c9-8c4b-a9d3a3435cf4
        number:
          description: Číslo skladovej výdajky.
          type: string
          example: VYD-2026-0001
        webDokladUrl:
          description: URL verejného web dokladu tejto výdajky.
          type: string
          example: >-
            https://app.fintoro.sk/web-doklad/company/warehouse-outbound-receipt/uuid
        pdfDownloadUrl:
          description: Priama URL na stiahnutie PDF exportu tejto výdajky.
          type: string
          example: >-
            https://app.fintoro.sk/api/public/v1/warehouse-outbound-receipts/951/pdf
        company:
          $ref: '#/components/schemas/CompanySnapshot'
          description: Historický snapshot dodávateľa uložený na doklade.
        warehouse:
          $ref: '#/components/schemas/Warehouse'
          description: Sklad, z ktorého výdajka odpíše tovar.
        clientId:
          description: >-
            Live ID klienta, ak je výdajka stále naviazaná na existujúceho
            klienta.
          type:
            - integer
            - 'null'
          example: 101
        client:
          description: Historický snapshot klienta uložený na výdajke.
          anyOf:
            - $ref: '#/components/schemas/ClientSnapshot'
            - type: 'null'
        currency:
          $ref: '#/components/schemas/Currency'
          description: Mena výdajky.
        language:
          $ref: '#/components/schemas/Language'
          description: Jazyk výdajky.
        issueDate:
          description: Dátum vystavenia výdajky.
          type: string
          format: date
          example: '2026-03-11'
        note:
          description: Voliteľná interná poznámka na výdajke.
          type:
            - string
            - 'null'
          example: Výdaj pre manuálny odber
        hasVat:
          description: Označuje, či výdajka obsahuje DPH.
          type: boolean
          example: true
        total:
          description: Celková suma bez DPH.
          type: number
          format: float
          example: 30
        totalWithVat:
          description: Celková suma s DPH.
          type: number
          format: float
          example: 36
        items:
          description: Položky skladovej výdajky.
          type: array
          items:
            $ref: '#/components/schemas/WarehouseReceiptItem'
    WarehouseOutboundReceiptClientInput:
      description: >-
        Klientský payload pre resolve-or-create flow alebo snapshot override na
        skladovej výdajke.
      type: object
      required:
        - name
      properties:
        name:
          description: Obchodné meno alebo meno klienta.
          type: string
          maxLength: 255
          example: Client s.r.o.
        type:
          description: >-
            Typ klienta. Ak pole vynecháte, backend ho inferuje podľa
            identifikačných polí.
          type: string
          enum:
            - person
            - company
          example: company
        subjectId:
          description: IČO klienta, ak je dostupné.
          type:
            - string
            - 'null'
          maxLength: 40
          example: '12345678'
        taxId:
          description: DIČ klienta, ak je dostupné.
          type:
            - string
            - 'null'
          maxLength: 40
          example: '2020123456'
        vatId:
          description: IČ DPH klienta, ak je dostupné.
          type:
            - string
            - 'null'
          maxLength: 40
          example: SK2020123456
        isVatPayer:
          description: >-
            Informácia, či je klient platca DPH. Ak pole vynecháte, backend
            hodnotu inferuje z `vatId`.
          type: boolean
          example: true
        email:
          description: Kontaktný e-mail klienta.
          type:
            - string
            - 'null'
          format: email
          maxLength: 255
          example: billing@client.test
        street:
          description: Ulica a číslo fakturačnej adresy klienta.
          type:
            - string
            - 'null'
          maxLength: 255
          example: Klientská 1
        city:
          description: Mesto fakturačnej adresy klienta.
          type:
            - string
            - 'null'
          maxLength: 255
          example: Bratislava
        zip:
          description: PSČ fakturačnej adresy klienta.
          type:
            - string
            - 'null'
          maxLength: 10
          example: '81101'
        countryId:
          type:
            - integer
            - 'null'
          description: >-
            ID fakturačnej krajiny z [referenčnej tabuľky
            krajín](/reference-tables#krajiny).
          example: 703
    WarehouseReceiptLineInput:
      description: >-
        Jedna položka create alebo update payloadu skladovej príjemky alebo
        výdajky.
      type: object
      required:
        - priceListItemId
        - quantity
        - unitPrice
        - vatRate
      properties:
        priceListItemId:
          description: ID warehouse-enabled skladovej alebo cenníkovej položky.
          type: integer
          example: 701
        quantity:
          description: Množstvo položky. Minimálna hodnota je `0.00001`.
          type: number
          format: float
          minimum: 0.00001
          maximum: 10000000000000
          example: 3
        unitPrice:
          description: Jednotková cena bez DPH.
          type: number
          format: float
          minimum: -10000000000000
          maximum: 10000000000000
          example: 15
        vatRate:
          description: Sadzba DPH položky v percentách.
          type: number
          format: float
          minimum: 0
          maximum: 100
          example: 20
    CompanySnapshot:
      description: >-
        Snapshot dodávateľa uložený priamo na doklade. Tento objekt reprezentuje
        firemné údaje v čase vystavenia alebo posledného preuloženia dokladu,
        aby zostal na doklade zachovaný pôvodný názov, identifikačné údaje a
        adresa.
      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
    Warehouse:
      description: Sklad vrátane inbound a outbound číselného radu.
      type: object
      properties:
        id:
          description: Interné ID skladu vo Fintoro.
          type: integer
          example: 301
        name:
          description: Názov skladu zobrazený vo Fintoro.
          type: string
          example: Hlavný sklad
        code:
          description: Interný kód skladu. Musí byť unikátny.
          type: string
          example: MAIN-WH
        inboundNumericalSeriesPattern:
          description: Vzor číselného radu pre skladové príjemky tohto skladu.
          type: string
          example: PRI-(RR)-(CCCC)
        inboundNumericalSeriesNextNumber:
          description: >-
            Ďalšie poradové číslo, ktoré sa použije pri automatickom generovaní
            skladovej príjemky.
          type: integer
          example: 12
        outboundNumericalSeriesPattern:
          description: Vzor číselného radu pre skladové výdajky tohto skladu.
          type: string
          example: VYD-(RR)-(CCCC)
        outboundNumericalSeriesNextNumber:
          description: >-
            Ďalšie poradové číslo, ktoré sa použije pri automatickom generovaní
            skladovej výdajky.
          type: integer
          example: 8
    ClientSnapshot:
      description: >-
        Historický snapshot klienta uložený priamo na doklade. Tento objekt
        reprezentuje stav klientskych údajov v čase vystavenia alebo posledného
        preuloženia dokladu. Ak si klient neskôr zmení názov alebo adresu,
        doklad si ponechá túto historickú hodnotu kvôli auditovateľnosti a
        perzistencii dát. Príklad: doklad vystavený na adresu `Hlavná 1,
        Bratislava` zostane historicky správny aj vtedy, keď má klient dnes v
        profile už inú adresu.
      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 snapshotu 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: Informácia, či snapshot obsahuje samostatnú dodaciu adresu.
          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'
    Currency:
      description: Mena dostupná v lookup endpointoch Fintoro API.
      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: >-
            Lokalizovaný názov meny. Ak pošlete `Accept-Language`, backend podľa
            neho preloží systémový label.
          type: string
          example: Euro
        mark:
          description: Skrátená značka meny zobrazovaná vo Fintoro.
          type: string
          example: €
    Language:
      description: Jazyk dostupný v lookup endpointoch Fintoro API.
      type: object
      properties:
        id:
          description: Stabilné ID jazyka používané v API.
          type: integer
          example: 1
        name:
          description: >-
            Lokalizovaný názov jazyka. Ak pošlete `Accept-Language`, backend
            podľa neho preloží systémový label.
          type: string
          example: Slovenčina
        code:
          description: Krátky jazykový kód.
          type: string
          example: sk
    WarehouseReceiptItem:
      description: Jedna položka skladovej príjemky alebo výdajky.
      type: object
      properties:
        id:
          description: Interné ID položky skladového dokladu.
          type: integer
          example: 7001
        priceListItemId:
          description: ID skladovej alebo cenníkovej položky.
          type: integer
          example: 701
        priceListItemName:
          description: Názov skladovej alebo cenníkovej položky uložený na doklade.
          type: string
          example: Montážna sada
        priceListItemWarehouseCode:
          description: Skladový kód položky, ak je pri položke nastavený.
          type:
            - string
            - 'null'
          example: SKU-001
        unitName:
          description: Názov jednotky použitej na doklade.
          type:
            - string
            - 'null'
          example: ks
        quantity:
          description: Množstvo položky.
          type: number
          format: float
          example: 3
        unitPrice:
          description: Jednotková cena bez DPH.
          type: number
          format: float
          example: 15
        unitPriceWithVat:
          description: Jednotková cena s DPH.
          type: number
          format: float
          example: 18
        vatRate:
          description: Sadzba DPH na položke v percentách.
          type: number
          format: float
          example: 20
    Country:
      description: >-
        Krajina dostupná v lookup endpointoch Fintoro API a vo vnorených
        objektoch, kde sa krajina vracia priamo v response.
      type: object
      properties:
        id:
          description: Stabilné ID krajiny používané v API.
          type: integer
          example: 703
        name:
          description: >-
            Lokalizovaný názov krajiny. Ak pošlete `Accept-Language`, backend
            podľa neho preloží systémový label.
          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
  headers:
    XRequestId:
      description: >-
        Unikátny identifikátor requestu pre traceovanie, audit a support
        diagnostiku.
      schema:
        type: string
        example: req_public_api_01
    ContentLanguage:
      description: Jazyk vybraný pre request podľa headera `Accept-Language`.
      schema:
        type: string
        example: en
  responses:
    ValidationError:
      description: Request payload alebo query parametre neprešli validačnými pravidlami.
      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: The given data was invalid.
              errors:
                type: object
                additionalProperties:
                  type: array
                  items:
                    type: string
    TooManyRequests:
      description: >-
        Firma prekročila Fintoro API rate limit. Táto 429 odpoveď nesie tie isté
        `X-RateLimit-Limit` a `X-RateLimit-Remaining` hlavičky ako ostatné
        throttled odpovede a navyše pridáva `Retry-After` a `X-RateLimit-Reset`.
        Ak potrebujete vyšší limit, kontaktujte info@fintoro.sk pre individuálne
        enterprise nastavenie.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        X-RateLimit-Limit:
          description: >-
            Maximálny počet requestov povolený pre firmu v aktuálnom
            60-sekundovom okne. Túto hlavičku vraciame na všetkých throttled
            odpovediach, nielen pri 429.
          schema:
            type: integer
            example: 120
        X-RateLimit-Remaining:
          description: >-
            Počet requestov, ktoré ešte firme ostávajú v aktuálnom 60-sekundovom
            okne. Túto hlavičku vraciame na všetkých throttled odpovediach,
            nielen pri 429.
          schema:
            type: integer
            example: 0
        Retry-After:
          description: >-
            Počet sekúnd, po ktorých môžete request bezpečne zopakovať. Túto
            hlavičku posielame len pri 429.
          schema:
            type: integer
            example: 60
        X-RateLimit-Reset:
          description: >-
            Unix timestamp, kedy sa aktuálne rate-limit okno resetuje. Túto
            hlavičku posielame len pri 429.
          schema:
            type: integer
            example: 1774810800
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Too Many Attempts.
    InternalServerError:
      description: >-
        Nastala neočakávaná interná chyba. Tento stav by sa nemal vyskytovať pri
        bežnej prevádzke a automaticky ho reportujeme.
      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: >-
        API je dočasne nedostupné počas riadenej údržby. Plánovaný výpadok
        oznamujeme minimálne 24 hodín vopred.
      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: Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

````