> ## 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. # Zoznam skladových a cenníkových položiek > Vráti skladové a cenníkové položky patriace. Endpoint podporuje fulltextové vyhľadávanie podľa názvu, skladového kódu a EANu, filtrovanie podľa ceny a stavu skladu a stránkovanie. Response vracia celkový stock položky, nie detailný rozpad po jednotlivých skladoch. ## OpenAPI ````yaml /openapi.yaml get /price-list-items 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: /price-list-items: get: tags: - Skladové a cenníkové položky summary: Zoznam skladových a cenníkových položiek description: >- Vráti skladové a cenníkové položky patriace. Endpoint podporuje fulltextové vyhľadávanie podľa názvu, skladového kódu a EANu, filtrovanie podľa ceny a stavu skladu a stránkovanie. Response vracia celkový stock položky, nie detailný rozpad po jednotlivých skladoch. operationId: listPriceListItems parameters: - name: name in: query required: false description: >- Fulltextové vyhľadávanie podľa názvu položky, skladového kódu alebo EANu. schema: type: string maxLength: 255 example: match - name: priceFrom in: query required: false description: Minimálna jednotková cena bez DPH. schema: type: number format: float example: 10 - name: priceTo in: query required: false description: Maximálna jednotková cena bez DPH. schema: type: number format: float example: 100 - name: stockFrom in: query required: false description: Minimálny aktuálny stav skladu položky. schema: type: number format: float example: 1 - name: stockTo in: query required: false description: Maximálny aktuálny stav skladu položky. schema: type: number format: float example: 50 - name: onlyWarehouseItems in: query required: false description: >- Ak pošlete `true`, endpoint vráti len položky so zapnutou skladovou evidenciou. schema: type: boolean default: false example: true - name: sortBy in: query required: false description: Pole, podľa ktorého sa zoznam zoradí. schema: type: string enum: - name - unit_price - stock default: name example: stock - name: sortDirection in: query required: false description: Smer zoradenia. schema: type: string enum: - asc - desc example: desc default: asc - name: perPage in: query required: false description: Počet položiek na jednu stránku. Maximum je 200. schema: type: integer minimum: 1 maximum: 200 default: 50 example: 50 - name: page in: query required: false description: Číslo stránky, ktorá sa má vrátiť. schema: type: integer minimum: 1 default: 1 example: 2 responses: '200': description: Zoznam skladových a cenníkových položiek. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: type: object properties: data: description: Položky aktuálnej stránky. type: array items: $ref: '#/components/schemas/PriceListItem' paginator: $ref: '#/components/schemas/Paginator' description: Metadata stránkovania pre aktuálny výsledok. '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' '503': $ref: '#/components/responses/ServiceUnavailable' components: 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 schemas: PriceListItem: description: >- Skladová alebo cenníková položka. Objekt vracia business údaje použiteľné pri tvorbe dokladov aj skladové nastavenia, ak má položka zapnutú evidenciu skladu. type: object properties: id: description: Interné ID položky vo Fintoro. type: integer example: 701 name: description: Názov položky. type: string example: Servisný balík description: description: Detailnejší popis položky, ak je na nej uložený. type: - string - 'null' example: Mesačný servis a podpora unitId: description: >- ID jednotky z [referenčnej tabuľky jednotiek](/reference-tables#jednotky). type: integer example: 1 unit: $ref: '#/components/schemas/Unit' description: Jednotka položky ako vnorený lookup objekt. unitPrice: description: Predajná jednotková cena bez DPH. type: number format: float example: 129.9 vatRate: description: Sadzba DPH použitá na predajnú cenu položky. type: number format: float example: 20 unitPriceWithVat: description: Predajná jednotková cena s DPH dopočítaná backendom. type: number format: float example: 155.88 stock: description: Aktuálny celkový skladový stav položky naprieč všetkými skladmi. type: number format: float example: 12 stocks: description: >- Rozpis aktuálneho skladového stavu položky po jednotlivých skladoch firmy. type: array items: $ref: '#/components/schemas/PriceListItemStock' ean: description: EAN kód položky, ak je evidovaný. type: - string - 'null' maxLength: 255 example: '8586012345678' useWarehouse: description: Označuje, či je na položke zapnutá skladová evidencia. type: boolean example: true warehouseCode: description: >- Interný kód skladovej karty. Pri zapnutej skladovej evidencii má byť unikátny v rámci firmy. type: - string - 'null' maxLength: 255 example: SKU-PUBLIC-001 enableNegativeStock: description: Označuje, či položka povoľuje záporný stav skladu. type: boolean example: false maxStock: description: Maximálny odporúčaný stav skladu, ak je na položke nastavený. type: - number - 'null' format: float example: 250 purchasePrice: description: Nákupná cena bez DPH, ak je na položke evidovaná. type: - number - 'null' format: float example: 89.5 purchaseVatRate: description: Nákupná sadzba DPH, ak je na položke evidovaná. type: - number - 'null' format: float example: 20 purchasePriceWithVat: description: >- Nákupná cena s DPH dopočítaná backendom, ak je dostupná nákupná cena a sadzba DPH. type: - number - 'null' format: float example: 107.4 Paginator: description: Metadáta stránkovania vracané pri paginovaných list endpointoch. type: object properties: currentPage: description: Aktuálna stránka výsledku. type: integer example: 2 perPage: description: Počet výsledkov na jednej stránke. type: integer example: 10 totalPages: description: Celkový počet stránok. type: integer example: 5 totalResults: description: Celkový počet záznamov naprieč všetkými stránkami. type: integer example: 42 currentFrom: description: Poradové číslo prvého záznamu na aktuálnej stránke. type: integer example: 11 currentTo: description: Poradové číslo posledného záznamu na aktuálnej stránke. type: integer example: 20 firstPageUrl: description: URL prvej stránky. type: string example: https://app.fintoro.sk/api/public/v1/invoices?page=1 lastPageUrl: description: URL poslednej stránky. type: string example: https://app.fintoro.sk/api/public/v1/invoices?page=5 nextPageUrl: description: URL ďalšej stránky alebo `null`, ak ďalšia stránka neexistuje. type: - string - 'null' example: https://app.fintoro.sk/api/public/v1/invoices?page=3 previousPageUrl: description: >- URL predchádzajúcej stránky alebo `null`, ak predchádzajúca stránka neexistuje. type: - string - 'null' example: https://app.fintoro.sk/api/public/v1/invoices?page=1 links: description: >- Kompletný zoznam stránkovacích linkov v poradí, v akom ich vracia backend. type: array items: $ref: '#/components/schemas/PaginatorLink' Unit: description: Jednotka dostupná v lookup endpointoch Fintoro API. type: object properties: id: description: Stabilné ID jednotky používané v API. type: integer example: 1 name: description: >- Lokalizovaný názov jednotky. Ak pošlete `Accept-Language`, backend podľa neho preloží systémový label. type: string example: ks PriceListItemStock: description: >- Aktuálny skladový stav konkrétnej cenníkovej položky na jednom sklade firmy. type: object properties: warehouseId: description: Interné ID skladu, ku ktorému sa stav viaže. type: integer example: 15 warehouseName: description: Názov skladu. type: string example: Hlavný sklad warehouseCode: description: Interný kód skladu. type: string example: MAIN-WH stockQuantity: description: >- Aktuálne množstvo položky na danom sklade po započítaní príjemok a výdajok. type: number format: float example: 7 PaginatorLink: description: Jeden link v paginatori. type: object properties: url: description: URL cieľovej stránky alebo `null`, ak daný link nie je dostupný. type: - string - 'null' example: https://app.fintoro.sk/api/public/v1/invoices?page=2 label: description: Textový label linku. type: string example: '2' active: description: Označuje, či ide o aktuálne aktívnu stránku. type: boolean example: false responses: 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. ````