# Fintoro API

## Docs

- [Detail bankového účtu](https://docs.fintoro.sk/api-reference/bankové-účty/detail-bankového-účtu.md): Vráti detail jedného bankového účtu. Okrem samotných údajov o účte vracia aj vnorený objekt banky, stav primárneho účtu a open banking metadata, ak sú dostupné.
- [Upraviť bankový účet](https://docs.fintoro.sk/api-reference/bankové-účty/upraviť-bankový-účet.md): Aktualizuje bankový účet. Pošlite len polia, ktoré chcete zmeniť. Ak pošlete `isPrimary: true`, účet sa nastaví ako primárny účet firmy.
- [Vytvoriť bankový účet](https://docs.fintoro.sk/api-reference/bankové-účty/vytvoriť-bankový-účet.md): Vytvorí nový bankový účet. V requeste posielate len business údaje účtu. Novovytvorený účet sa v aktuálnej implementácii vždy nastaví ako primárny účet firmy, preto sa tento stav v create payloade neposiela. Odpoveď vráti výsledný uložený objekt vrátane informácie, či je účet aktuálne vedený ako pri…
- [Zmazať bankový účet](https://docs.fintoro.sk/api-reference/bankové-účty/zmazať-bankový-účet.md): Zmaže bankový účet. Po úspešnom spracovaní endpoint nevracia response body.
- [Zoznam bankových účtov](https://docs.fintoro.sk/api-reference/bankové-účty/zoznam-bankových-účtov.md): Vráti všetky bankové účty v jednom zozname. Endpoint nepodporuje filtrovanie ani stránkovanie, preto je vhodný najmä na synchronizáciu účtov do externého systému alebo vlastného frontendu.
- [Aktualizovať cenovú ponuku](https://docs.fintoro.sk/api-reference/cenové-ponuky/aktualizovať-cenovú-ponuku.md): Aktualizuje existujúcu cenovú ponuku cez plný `PUT` kontrakt.
- [Detail cenovej ponuky](https://docs.fintoro.sk/api-reference/cenové-ponuky/detail-cenovej-ponuky.md): Vráti detail cenovej ponuky. Response obsahuje snapshot dodávateľa, historický snapshot klienta uložený priamo na doklade, finálne vypočítané položky cenovej ponuky a URL na verejný web doklad aj PDF download endpoint.
- [Stiahnuť cenovú ponuku ako pdf](https://docs.fintoro.sk/api-reference/cenové-ponuky/stiahnuť-cenovú-ponuku-ako-pdf.md): Stiahne PDF export cenovej ponuky ako prílohu (`application/pdf`). URL tohto endpointu nájdete aj v poli `pdfDownloadUrl` v detaile cenovej ponuky.
- [Vytvoriť cenovú ponuku](https://docs.fintoro.sk/api-reference/cenové-ponuky/vytvoriť-cenovú-ponuku.md): Vytvorí novú cenovú ponuku.
- [Zmazať cenovú ponuku](https://docs.fintoro.sk/api-reference/cenové-ponuky/zmazať-cenovú-ponuku.md): Zmaže cenovú ponuku.
- [Zoznam cenových ponúk](https://docs.fintoro.sk/api-reference/cenové-ponuky/zoznam-cenových-ponúk.md): Vráti paginovaný zoznam cenových ponúk v zjednodušenom preview tvare. Endpoint je vhodný na listy, synchronizáciu a rýchly prehľad nad rozpracovanými ponukami; pre detail použite detail endpoint cenovej ponuky.
- [Detail CRM udalosti](https://docs.fintoro.sk/api-reference/crm-udalosti/detail-crm-udalosti.md): Vráti detail jednej CRM udalosti vrátane metadata payloadu a zoznamu príloh.
- [Nahrať prílohy CRM udalosti](https://docs.fintoro.sk/api-reference/crm-udalosti/nahrať-prílohy-crm-udalosti.md): Nahraje jednu alebo viac príloh do temporary storage a vráti `uploadToken` hodnoty použiteľné v `attachmentUploadTokens[]` pri create alebo update `contact-activity-logs`. Tento endpoint používa `multipart/form-data` a neberie Filepond server IDs.
- [Stiahnuť prílohy CRM udalosti](https://docs.fintoro.sk/api-reference/crm-udalosti/stiahnuť-prílohy-crm-udalosti.md): Vráti ZIP stream príloh danej CRM udalosti. Ak udalosť prílohy nemá, endpoint vráti `404`.
- [Upraviť CRM udalosť](https://docs.fintoro.sk/api-reference/crm-udalosti/upraviť-crm-udalosť.md): Čiastočne aktualizuje CRM udalosť. Meniteľné sú iba `metadata`, `attachmentUploadTokens[]` a `deletedAttachmentIds[]`; `type` a target polia sú pri update zakázané. Pri `document_linked` type sa attachmenty nepodporujú. Dostupnosť jednotlivých metadata polí je popísaná priamo pri `metadata.content`,…
- [Vytvoriť CRM udalosť](https://docs.fintoro.sk/api-reference/crm-udalosti/vytvoriť-crm-udalosť.md): Vytvorí novú CRM udalosť. Musíte poslať presne jeden target z `businessCaseId`, `clientId` alebo `supplierId`, `type`, `metadata` a voliteľne `attachmentUploadTokens[]`. Pre `document_linked` použite `metadata.documentType` a `metadata.documentId`; attachmenty sa pri tomto type nepodporujú. Ak pošle…
- [Zmazať CRM udalosť](https://docs.fintoro.sk/api-reference/crm-udalosti/zmazať-crm-udalosť.md): Zmaže CRM udalosť. Po úspešnom spracovaní endpoint nevracia response body.
- [Zoznam CRM udalostí](https://docs.fintoro.sk/api-reference/crm-udalosti/zoznam-crm-udalostí.md): Vráti CRM udalosti. Query musí obsahovať presne jedno target pole z `businessCaseId`, `clientId` alebo `supplierId`. Voliteľne môžete filtrovať podľa `type` a stránkovať pomocou `perPage` a `page`.
- [Detail dobropisu](https://docs.fintoro.sk/api-reference/dobropisy/detail-dobropisu.md): Vráti detail dobropisu. Response obsahuje snapshot dodávateľa, historický snapshot klienta uložený na dobropise, live väzbu na bankový účet použitý na doklade, `invoiceId` pôvodnej faktúry a aj zoznam `payments` patriacich k tomuto dobropisu. Nájdete tu aj `webDokladUrl` a `pdfDownloadUrl` pre ďalši…
- [Stiahnuť dobropis ako pdf](https://docs.fintoro.sk/api-reference/dobropisy/stiahnuť-dobropis-ako-pdf.md): Stiahne PDF export dobropisu ako prílohu (`application/pdf`). URL tohto endpointu nájdete aj v poli `pdfDownloadUrl` v detaile dobropisu.
- [Upraviť dobropis](https://docs.fintoro.sk/api-reference/dobropisy/upraviť-dobropis.md): Aktualizuje existujúci dobropis.
- [Vytvoriť dobropis](https://docs.fintoro.sk/api-reference/dobropisy/vytvoriť-dobropis.md): Vytvorí nový dobropis.
- [Vytvoriť dobropis z faktúry](https://docs.fintoro.sk/api-reference/dobropisy/vytvoriť-dobropis-z-faktúry.md): Vytvorí dobropis priamo zo zvolenej faktúry.
- [Zmazať dobropis](https://docs.fintoro.sk/api-reference/dobropisy/zmazať-dobropis.md): Zmaže dobropis.
- [Zoznam dobropisov](https://docs.fintoro.sk/api-reference/dobropisy/zoznam-dobropisov.md): Vráti paginovaný zoznam dobropisov v zjednodušenom preview tvare. Endpoint je vhodný na listy, synchronizáciu a rýchly prehľad nad stavom dobropisov; pre detail použite detail endpoint dobropisu.
- [Detail dodávateľa](https://docs.fintoro.sk/api-reference/dodávatelia/detail-dodávateľa.md): Vráti detail jedného dodávateľa vrátane vnoreného objektu krajiny.
- [Upraviť dodávateľa](https://docs.fintoro.sk/api-reference/dodávatelia/upraviť-dodávateľa.md): Aktualizuje dodávateľa cez full `PUT` payload. Pošlite celý payload v rovnakom tvare ako pri vytvorení. Backend pri update nedoťahuje vynechané polia z existujúcich dát. Pri inferred poliach `type` a `isVatPayer` platí rovnaké správanie ako pri vytvorení dodávateľa.
- [Vytvoriť dodávateľa](https://docs.fintoro.sk/api-reference/dodávatelia/vytvoriť-dodávateľa.md): Vytvorí nového dodávateľa. Ak nepošlete `type`, backend ho inferuje z identifikačných polí `subjectId`, `taxId` a `vatId`. Ak nepošlete `isVatPayer`, backend ho inferuje z prítomnosti `vatId`. Ak pošlete `Idempotency-Key`, rovnaký key s rovnakým payloadom vráti pôvodnú odpoveď bez druhého vytvorenia…
- [Zmazať dodávateľa](https://docs.fintoro.sk/api-reference/dodávatelia/zmazať-dodávateľa.md): Zmaže dodávateľa. Endpoint po úspešnom spracovaní nevracia response body.
- [Zoznam dodávateľov](https://docs.fintoro.sk/api-reference/dodávatelia/zoznam-dodávateľov.md): Vráti dodávateľov. Endpoint je vhodný na synchronizáciu dodávateľov do externého systému alebo vlastného frontendu a podporuje základné fulltextové vyhľadávanie aj triedenie.
- [Odoslať doklad emailom](https://docs.fintoro.sk/api-reference/dokladové-e-maily/odoslať-doklad-emailom.md): Odošle podporovaný public doklad emailom.
- [Detail faktúry](https://docs.fintoro.sk/api-reference/faktúry/detail-faktúry.md): Vráti detail faktúry. Response obsahuje snapshot dodávateľa, historický snapshot klienta uložený priamo na doklade, naviazaný bankový účet použitý na faktúre a aj zoznam `payments` patriacich k tejto faktúre. Snapshoty firmy a klienta reprezentujú stav údajov v čase práce s faktúrou kvôli auditovate…
- [Stiahnuť faktúru ako pdf](https://docs.fintoro.sk/api-reference/faktúry/stiahnuť-faktúru-ako-pdf.md): Stiahne PDF export faktúry ako prílohu (`application/pdf`). URL tohto endpointu nájdete aj v poli `pdfDownloadUrl` v detaile faktúry.
- [Upraviť faktúru](https://docs.fintoro.sk/api-reference/faktúry/upraviť-faktúru.md): Aktualizuje existujúcu faktúru.
- [Vytvoriť faktúru](https://docs.fintoro.sk/api-reference/faktúry/vytvoriť-faktúru.md): Vytvorí novú faktúru.
- [Zmazať faktúru](https://docs.fintoro.sk/api-reference/faktúry/zmazať-faktúru.md): Zmaže faktúru.
- [Zoznam faktúr](https://docs.fintoro.sk/api-reference/faktúry/zoznam-faktúr.md): Vráti paginovaný zoznam faktúr v zjednodušenom preview tvare. Tento endpoint je určený na listy, synchronizáciu a rýchly prehľad nad dokladmi. Na detail jedného dokladu použite detail endpoint faktúry.
- [API referencia](https://docs.fintoro.sk/api-reference/index.md): Interaktívna OpenAPI referencia pre Fintoro API.
- [Detail klienta](https://docs.fintoro.sk/api-reference/klienti/detail-klienta.md): Vráti detail jedného klienta vrátane vnorených krajín a klientských predvolených hodnôt, ktoré môžete použiť pri tvorbe nových dokladov.
- [Upraviť klienta](https://docs.fintoro.sk/api-reference/klienti/upraviť-klienta.md): Aktualizuje klienta cez plnohodnotný `PUT` payload. Pošlite rovnaké polia ako pri vytvorení klienta. Endpoint nehydratuje chýbajúce polia z existujúcich dát klienta; ak optional pole vynecháte, uloží sa jeho create default alebo `null` podľa create kontraktu. Polia dodacej adresy a inferované hodnot…
- [Vytvoriť klienta](https://docs.fintoro.sk/api-reference/klienti/vytvoriť-klienta.md): Vytvorí nového klienta. V requeste posielate business údaje klienta a voliteľné klientské predvolené hodnoty, ktoré sa ukladajú pri klientovi a pri tvorbe nových dokladov sa používajú ako fallback predvolené hodnoty, ak explicitnú hodnotu nepošlete v payloade. Ak pošlete `Idempotency-Key`, rovnaký k…
- [Zmazať klienta](https://docs.fintoro.sk/api-reference/klienti/zmazať-klienta.md): Zmaže klienta. Po úspešnom zmazaní endpoint nevracia response body.
- [Zoznam klientov](https://docs.fintoro.sk/api-reference/klienti/zoznam-klientov.md): Vráti klientov. Endpoint je vhodný na synchronizáciu klientov do externého systému alebo vlastného frontendu a podporuje základné fulltextové vyhľadávanie, filtrovanie a triedenie.
- [Zoznam bánk](https://docs.fintoro.sk/api-reference/lookupy/zoznam-bánk.md): Vráti zoznam bánk, ktoré môžete použiť pri vytváraní alebo aktualizácii bankového účtu. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý lookup dataset. Banky považujte za stabilný číselník; nové záznamy môžu pribúdať, no existujúce ID ostávajú zachované kvôli kompatibilite s uloženým…
- [Zoznam jazykov](https://docs.fintoro.sk/api-reference/lookupy/zoznam-jazykov.md): Vráti fixný číselník jazykov. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID jazykov sú stabilné v rámci tejto verzie API a nájdete ich aj v [referenčnej tabuľke jazykov](/reference-tables#jazyky). Názvy sa dajú lokalizovať cez `Accept-Language`.
- [Zoznam jednotiek](https://docs.fintoro.sk/api-reference/lookupy/zoznam-jednotiek.md): Vráti fixný číselník jednotiek. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID jednotiek sú stabilné v rámci tejto verzie API a nájdete ich aj v [referenčnej tabuľke jednotiek](/reference-tables#jednotky). Názvy sa dajú lokalizovať cez `Accept-Language`.
- [Zoznam krajín](https://docs.fintoro.sk/api-reference/lookupy/zoznam-krajín.md): Vráti fixný číselník krajín. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID krajín sú stabilné v rámci tejto verzie API a nájdete ich aj v [referenčnej tabuľke krajín](/reference-tables#krajiny). Názvy sa dajú lokalizovať cez `Accept-Language`.
- [Zoznam mien](https://docs.fintoro.sk/api-reference/lookupy/zoznam-mien.md): Vráti fixný číselník mien. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID mien sú stabilné v rámci tejto verzie API a nájdete ich aj v [referenčnej tabuľke mien](/reference-tables#meny). Názvy sa dajú lokalizovať cez `Accept-Language`.
- [Zoznam QR typov](https://docs.fintoro.sk/api-reference/lookupy/zoznam-qr-typov.md): Vráti fixný číselník QR typov. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID QR typov sú stabilné v rámci tejto verzie API a nájdete ich aj v [referenčnej tabuľke QR typov](/reference-tables#qr-typy). Názvy sa dajú lokalizovať cez `Accept-Language`.
- [Zoznam spôsobov dodania](https://docs.fintoro.sk/api-reference/lookupy/zoznam-spôsobov-dodania.md): Vráti fixný číselník spôsobov dodania. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID spôsobov dodania sú stabilné v rámci tejto verzie API a nájdete ich aj v [referenčnej tabuľke spôsobov dodania](/reference-tables#sposoby-dodania). Názvy sa dajú lokalizovať cez `Accept…
- [Zoznam spôsobov úhrady](https://docs.fintoro.sk/api-reference/lookupy/zoznam-spôsobov-úhrady.md): Vráti fixný číselník spôsobov úhrady. Endpoint nepodporuje filtrovanie ani stránkovanie a vracia celý dataset. ID spôsobov úhrady sú stabilné v rámci tejto verzie API a nájdete ich aj v [referenčnej tabuľke spôsobov úhrady](/reference-tables#sposoby-uhrady). Názvy sa dajú lokalizovať cez `Accept-Lan…
- [Detail obchodného prípadu](https://docs.fintoro.sk/api-reference/obchodné-prípady/detail-obchodného-prípadu.md): Vráti detail jedného obchodného prípadu vrátane vnoreného klienta alebo dodávateľa a voliteľného stavu.
- [Upraviť obchodný prípad](https://docs.fintoro.sk/api-reference/obchodné-prípady/upraviť-obchodný-prípad.md): Čiastočne aktualizuje obchodný prípad. Môžete meniť `name`, `description` a `statusId`, pričom `statusId` môže byť aj `null`. Väzbu na klienta alebo dodávateľa tento endpoint nemení; polia `clientId` a `supplierId` sú pri update zakázané a vrátia validačnú chybu.
- [Vytvoriť obchodný prípad](https://docs.fintoro.sk/api-reference/obchodné-prípady/vytvoriť-obchodný-prípad.md): Vytvorí nový obchodný prípad. V requeste musíte poslať presne jedno z polí `clientId` alebo `supplierId`. `statusId` je voliteľné a môže byť `null`. Ak pošlete `Idempotency-Key`, opakované create volanie s rovnakým key a rovnakým payloadom vráti pôvodnú odpoveď bez druhého vytvorenia prípadu.
- [Zmazať obchodný prípad](https://docs.fintoro.sk/api-reference/obchodné-prípady/zmazať-obchodný-prípad.md): Zmaže obchodný prípad. Po úspešnom spracovaní endpoint nevracia response body.
- [Zoznam obchodných prípadov](https://docs.fintoro.sk/api-reference/obchodné-prípady/zoznam-obchodných-prípadov.md): Vráti obchodné prípady aktuálnej firmy. Endpoint podporuje filtrovanie podľa klienta, dodávateľa, stavu a fulltextové vyhľadávanie v názve alebo popise. Response vždy vracia vnorený objekt klienta alebo dodávateľa podľa reality záznamu, voliteľný vnorený stav a paginator pre stránkovanie.
- [Aktualizovať objednávku](https://docs.fintoro.sk/api-reference/objednávky/aktualizovať-objednávku.md): Aktualizuje existujúcu objednávku cez plný `PUT` kontrakt.
- [Detail objednávky](https://docs.fintoro.sk/api-reference/objednávky/detail-objednávky.md): Vráti detail objednávky. Response obsahuje snapshot dodávateľa, historický snapshot klienta uložený priamo na doklade, finálne vypočítané položky objednávky a URL na verejný web doklad aj PDF download endpoint.
- [Stiahnuť objednávku ako pdf](https://docs.fintoro.sk/api-reference/objednávky/stiahnuť-objednávku-ako-pdf.md): Stiahne PDF export objednávky ako prílohu (`application/pdf`). URL tohto endpointu nájdete aj v poli `pdfDownloadUrl` v detaile objednávky.
- [Vytvoriť objednávku](https://docs.fintoro.sk/api-reference/objednávky/vytvoriť-objednávku.md): Vytvorí novú objednávku.
- [Zmazať objednávku](https://docs.fintoro.sk/api-reference/objednávky/zmazať-objednávku.md): Zmaže objednávku.
- [Zoznam objednávok](https://docs.fintoro.sk/api-reference/objednávky/zoznam-objednávok.md): Vráti paginovaný zoznam objednávok v zjednodušenom preview tvare. Endpoint je vhodný na listy, synchronizáciu a rýchly prehľad nad rozpracovanými dokladmi; pre detail použite detail endpoint objednávky.
- [Detail skladovej alebo cenníkovej položky](https://docs.fintoro.sk/api-reference/skladové-a-cenníkové-položky/detail-skladovej-alebo-cenníkovej-položky.md): Vráti detail jednej skladovej alebo cenníkovej položky.
- [Upraviť skladovú alebo cenníkovú položku](https://docs.fintoro.sk/api-reference/skladové-a-cenníkové-položky/upraviť-skladovú-alebo-cenníkovú-položku.md): Aktualizuje skladovú alebo cenníkovú položku. Fintoro API používa plný `PUT` kontrakt, preto pošlite celý výsledný stav položky vrátane required business polí.
- [Vytvoriť skladovú alebo cenníkovú položku](https://docs.fintoro.sk/api-reference/skladové-a-cenníkové-položky/vytvoriť-skladovú-alebo-cenníkovú-položku.md): Vytvorí novú skladovú alebo cenníkovú položku. Ak pošlete `Idempotency-Key`, opakované create volanie s rovnakým key a rovnakým payloadom vráti pôvodnú odpoveď bez druhého vytvorenia položky.
- [Zmazať skladovú alebo cenníkovú položku](https://docs.fintoro.sk/api-reference/skladové-a-cenníkové-položky/zmazať-skladovú-alebo-cenníkovú-položku.md): Zmaže skladovú alebo cenníkovú položku. Po úspešnom spracovaní endpoint nevracia response body.
- [Zoznam skladových a cenníkových položiek](https://docs.fintoro.sk/api-reference/skladové-a-cenníkové-položky/zoznam-skladových-a-cenníkových-položiek.md): 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.
- [Detail skladovej príjemky](https://docs.fintoro.sk/api-reference/skladové-príjemky/detail-skladovej-príjemky.md): Vráti detail jednej skladovej príjemky vrátane skladu, dodávateľského snapshotu, položiek a `pdfDownloadUrl`.
- [Stiahnuť skladovú príjemku ako pdf](https://docs.fintoro.sk/api-reference/skladové-príjemky/stiahnuť-skladovú-príjemku-ako-pdf.md): Stiahne PDF export skladovej príjemky ako prílohu (`application/pdf`). URL tohto endpointu nájdete aj v poli `pdfDownloadUrl` v detaile príjemky.
- [Upraviť skladovú príjemku](https://docs.fintoro.sk/api-reference/skladové-príjemky/upraviť-skladovú-príjemku.md): Aktualizuje existujúcu skladovú príjemku. Fintoro API používa plný `PUT` kontrakt, preto pošlite celé hlavičkové aj položkové dáta príjemky. Partner flow je rovnaký ako pri create: `supplierId` použije existujúceho dodávateľa, objekt `supplier` bez `supplierId` spustí resolve-or-create flow.
- [Vytvoriť skladovú príjemku](https://docs.fintoro.sk/api-reference/skladové-príjemky/vytvoriť-skladovú-príjemku.md): Vytvorí novú skladovú príjemku. Ak pošlete `supplierId`, použije sa existujúci dodávateľ. Ak `supplierId` nepošlete a pošlete objekt `supplier`, backend podľa týchto údajov dodávateľa dopáruje alebo vytvorí. Ak pošlete `Idempotency-Key`, opakované create volanie s rovnakým payloadom vráti pôvodnú od…
- [Zmazať skladovú príjemku](https://docs.fintoro.sk/api-reference/skladové-príjemky/zmazať-skladovú-príjemku.md): Zmaže skladovú príjemku. Endpoint po úspešnom spracovaní nevracia response body.
- [Zoznam skladových príjemiek](https://docs.fintoro.sk/api-reference/skladové-príjemky/zoznam-skladových-príjemiek.md): Vráti paginovaný zoznam skladových príjemiek. Endpoint podporuje filtrovanie podľa skladu, dodávateľa a čísla dokladu.
- [Detail skladovej výdajky](https://docs.fintoro.sk/api-reference/skladové-výdajky/detail-skladovej-výdajky.md): Vráti detail jednej skladovej výdajky vrátane skladu, klientského snapshotu, položiek a `pdfDownloadUrl`.
- [Stiahnuť skladovú výdajku ako pdf](https://docs.fintoro.sk/api-reference/skladové-výdajky/stiahnuť-skladovú-výdajku-ako-pdf.md): Stiahne PDF export skladovej výdajky ako prílohu (`application/pdf`). URL tohto endpointu nájdete aj v poli `pdfDownloadUrl` v detaile výdajky.
- [Upraviť skladovú výdajku](https://docs.fintoro.sk/api-reference/skladové-výdajky/upraviť-skladovú-výdajku.md): Aktualizuje existujúcu skladovú výdajku. Fintoro API používa plný `PUT` kontrakt a zachováva rovnakú stock availability validáciu ako create flow. Partner flow je rovnaký ako pri create: `clientId` použije existujúceho klienta, objekt `client` bez `clientId` spustí resolve-or-create flow.
- [Vytvoriť skladovú výdajku](https://docs.fintoro.sk/api-reference/skladové-výdajky/vytvoriť-skladovú-výdajku.md): 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 endpoi…
- [Zmazať skladovú výdajku](https://docs.fintoro.sk/api-reference/skladové-výdajky/zmazať-skladovú-výdajku.md): Zmaže skladovú výdajku. Endpoint po úspešnom spracovaní nevracia response body.
- [Zoznam skladových výdajok](https://docs.fintoro.sk/api-reference/skladové-výdajky/zoznam-skladových-výdajok.md): Vráti paginovaný zoznam skladových výdajok. Endpoint podporuje filtrovanie podľa skladu, klienta a čísla dokladu.
- [Detail skladu](https://docs.fintoro.sk/api-reference/sklady/detail-skladu.md): Vráti detail jedného skladu vrátane kompletnej konfigurácie inbound a outbound číselného radu.
- [Upraviť sklad](https://docs.fintoro.sk/api-reference/sklady/upraviť-sklad.md): Aktualizuje sklad. Fintoro API používa plný `PUT` kontrakt, preto pošlite celý payload skladu vrátane číselných radov.
- [Vytvoriť sklad](https://docs.fintoro.sk/api-reference/sklady/vytvoriť-sklad.md): Vytvorí nový sklad vrátane inbound a outbound číselného radu. Response vracia výsledný uložený warehouse objekt.
- [Zmazať sklad](https://docs.fintoro.sk/api-reference/sklady/zmazať-sklad.md): Zmaže sklad. Posledný sklad firmy nie je možné zmazať; v takom prípade endpoint vráti `422`.
- [Zoznam skladov](https://docs.fintoro.sk/api-reference/sklady/zoznam-skladov.md): Vráti všetky sklady v jednom zozname. Endpoint nepodporuje filtrovanie ani stránkovanie, preto je vhodný najmä na synchronizáciu skladov do externého systému alebo vlastného frontendu.
- [Detail stavu obchodného prípadu](https://docs.fintoro.sk/api-reference/stavy-obchodných-prípadov/detail-stavu-obchodného-prípadu.md): Vráti detail jedného stavu obchodného prípadu.
- [Upraviť stav obchodného prípadu](https://docs.fintoro.sk/api-reference/stavy-obchodných-prípadov/upraviť-stav-obchodného-prípadu.md): Aktualizuje jeden stav obchodného prípadu. Payload je plný `PUT` kontrakt a vyžaduje `name` aj `color`.
- [Vytvoriť stav obchodného prípadu](https://docs.fintoro.sk/api-reference/stavy-obchodných-prípadov/vytvoriť-stav-obchodného-prípadu.md): Vytvorí nový stav obchodného prípadu. Nový stav sa zaradí na koniec existujúcej pipeline. Ak pošlete `Idempotency-Key`, opakované create volanie s rovnakým kľúčom a rovnakým payloadom vráti pôvodnú odpoveď bez druhého vytvorenia stavu.
- [Zmazať stav obchodného prípadu](https://docs.fintoro.sk/api-reference/stavy-obchodných-prípadov/zmazať-stav-obchodného-prípadu.md): Zmaže stav obchodného prípadu. Po úspešnom spracovaní endpoint nevracia response body. Naviazané obchodné prípady zostanú zachované a ich `statusId` sa automaticky nastaví na `null`.
- [Zoznam stavov obchodných prípadov](https://docs.fintoro.sk/api-reference/stavy-obchodných-prípadov/zoznam-stavov-obchodných-prípadov.md): Vráti všetky statusy obchodných prípadov v poradí podľa ich pozície v pipeline. Endpoint nepodporuje filtrovanie ani stránkovanie a je vhodný najmä na synchronizáciu pipeline stĺpcov do externého CRM alebo vlastného frontendu.
- [Detail subjektu](https://docs.fintoro.sk/api-reference/subjekty/detail-subjektu.md): Vráti jeden konkrétny subjekt z referenčného registra podľa jeho ID.
- [Vyhľadávanie subjektov](https://docs.fintoro.sk/api-reference/subjekty/vyhľadávanie-subjektov.md): Tento endpoint použite, keď potrebujete dohľadať údaje o firme alebo živnostníkovi podľa názvu či IČO.
- [Aktualizovať odber webhookov](https://docs.fintoro.sk/api-reference/webhooky/aktualizovať-odber-webhookov.md): Aktualizuje odber webhookov cez plný `PUT` payload. Ak meníte `url` alebo `subscribedEvents`, existujúci secret sa nemení. Secret rotujte samostatne cez rotate-secret endpoint. Zmena konfigurácie odberu neprehráva historické udalosti spätne.
- [Detail odberu webhookov](https://docs.fintoro.sk/api-reference/webhooky/detail-odberu-webhookov.md): Vráti detail jedného odberu webhookov aktuálnej firmy. Secret v otvorenej podobe sa v detaile už nikdy nevracia.
- [Rotovať webhook secret](https://docs.fintoro.sk/api-reference/webhooky/rotovať-webhook-secret.md): Vygeneruje nový secret pre existujúci odber webhookov. Nový `plainTextSecret` sa v odpovedi zobrazí iba pri tejto rotácii; starý secret po úspešnej rotácii prestáva platiť.
- [Vytvoriť odber webhookov](https://docs.fintoro.sk/api-reference/webhooky/vytvoriť-odber-webhookov.md): Vytvorí nový odber webhookov. `plainTextSecret` sa v odpovedi zobrazí iba pri vytvorení a musíte si ho bezpečne uložiť. Ak pošlete `Idempotency-Key`, opakované create volanie s rovnakým kľúčom a rovnakým payloadom vráti pôvodnú odpoveď bez druhého vytvorenia odberu. Pred uvedením do produkcie odporú…
- [Zmazať odber webhookov](https://docs.fintoro.sk/api-reference/webhooky/zmazať-odber-webhookov.md): Zmaže odber webhookov. Endpoint po úspešnom spracovaní nevracia response body.
- [Zoznam odberov webhookov](https://docs.fintoro.sk/api-reference/webhooky/zoznam-odberov-webhookov.md): Vráti všetky odbery webhookov aktuálnej firmy. Endpoint nepodporuje filtrovanie ani stránkovanie a je vhodný na synchronizáciu subscription konfigurácie do Vášho integračného rozhrania alebo administračného panelu integrácie.
- [Aktualizovať zálohovú faktúru](https://docs.fintoro.sk/api-reference/zálohové-faktúry/aktualizovať-zálohovú-faktúru.md): Zálohovú faktúru aktualizuje cez plný `PUT` kontrakt. Update používa rovnaké polia, rovnaké validačné pravidlá a rovnaké defaulty ako create flow. Omitted polia sa nepreberajú z pôvodného dokladu; backend ich vyrieši rovnako ako pri create.
- [Detail zálohovej faktúry](https://docs.fintoro.sk/api-reference/zálohové-faktúry/detail-zálohovej-faktúry.md): Vráti detail zálohovej faktúry. Response obsahuje snapshot dodávateľa, historický snapshot klienta uložený priamo na doklade, naviazaný bankový účet použitý na doklade a aj zoznam `payments` patriacich k tejto zálohovej faktúre. Response zároveň vracia `webDokladUrl` pre verejný web doklad a `pdfDow…
- [Stiahnuť zálohovú faktúru ako pdf](https://docs.fintoro.sk/api-reference/zálohové-faktúry/stiahnuť-zálohovú-faktúru-ako-pdf.md): Stiahne PDF export zálohovej faktúry ako prílohu (`application/pdf`). URL tohto endpointu nájdete aj v poli `pdfDownloadUrl` v detaile zálohovej faktúry.
- [Vytvoriť zálohovú faktúru](https://docs.fintoro.sk/api-reference/zálohové-faktúry/vytvoriť-zálohovú-faktúru.md): Vytvorí novú zálohovú faktúru.
- [Zmazať zálohovú faktúru](https://docs.fintoro.sk/api-reference/zálohové-faktúry/zmazať-zálohovú-faktúru.md): Zmaže zálohovú faktúru.
- [Zoznam zálohových faktúr](https://docs.fintoro.sk/api-reference/zálohové-faktúry/zoznam-zálohových-faktúr.md): Vráti paginovaný zoznam zálohových faktúr v zjednodušenom preview tvare. Endpoint je vhodný na listy, synchronizáciu a rýchly prehľad nad stavom úhrad; pre detail použite detail endpoint zálohovej faktúry.
- [Detail úhrady dokladu](https://docs.fintoro.sk/api-reference/úhrady-dokladov/detail-úhrady-dokladu.md): Vráti detail jednej úhrady. Response obsahuje typ a ID zdrojového dokladu, použitú menu, spôsob úhrady a prípadne aj preview daňového dokladu k prijatej platbe.
- [Vytvoriť úhradu dokladu](https://docs.fintoro.sk/api-reference/úhrady-dokladov/vytvoriť-úhradu-dokladu.md): Vytvorí novú úhradu pre public doklad.
- [Zmazať úhradu dokladu](https://docs.fintoro.sk/api-reference/úhrady-dokladov/zmazať-úhradu-dokladu.md): Zmaže úhradu dokladu. Ak je úhrada naviazaná na invoice typu `payment_receipt`, endpoint vráti `422` a zmazanie neprebehne.
- [Zoznam úhrad dokladu](https://docs.fintoro.sk/api-reference/úhrady-dokladov/zoznam-úhrad-dokladu.md): Vráti zoznam úhrad konkrétneho public dokladu. Zoznam je nefiltrovaný a nepaginuje sa; vždy vracia všetky úhrady daného dokladu v poradí od najnovšej.
- [Detail číselného radu](https://docs.fintoro.sk/api-reference/číselné-rady/detail-číselného-radu.md): Vráti detail jedného číselného radu v rovnakom tvare ako list endpoint. Endpoint je vhodný vtedy, keď si chcete uložiť konkrétne `numericalSeriesId` a neskôr si ho overiť alebo znovu načítať pred vytvorením dokladu.
- [Zoznam číselných radov](https://docs.fintoro.sk/api-reference/číselné-rady/zoznam-číselných-radov.md): Vráti číselné rady používané pri tvorbe public dokumentov. Endpoint nepoužíva stránkovanie; vracia celý relevantný dataset pre podporovaný document typ zadaný v povinnom query parametri `documentType`. Podporované hodnoty sú `invoice`, `proforma`, `credit-note`, `order` a `quotation`. Okrem internéh…
- [Autentifikácia](https://docs.fintoro.sk/authentication.md)
- [Konvencie API](https://docs.fintoro.sk/conventions.md)
- [Chyby, rate limiting a retry správanie](https://docs.fintoro.sk/errors-and-idempotency.md)
- [Začíname](https://docs.fintoro.sk/getting-started.md)
- [Fintoro API](https://docs.fintoro.sk/index.md): REST API na integráciu Fintoro fakturácie, CRM a skladového systému do systémov tretích strán.
- [Referenčné tabuľky](https://docs.fintoro.sk/reference-tables.md)
- [Testovanie v sandboxe](https://docs.fintoro.sk/sandbox-testing.md)
- [Webhooky](https://docs.fintoro.sk/webhooks.md)

## OpenAPI Specs

- [openapi](https://docs.fintoro.sk/openapi.yaml)

## Optional

- [Fintoro](https://fintoro.sk)