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

# Prehľad udalostí

Názvy udalostí používajte v poli `subscribedEvents` pri [vytváraní odberu](https://docs.fintoro.sk/webhooks.md). Typ záznamu v prijatom webhooku určuje `resource.type` a jeho ID je v `resource.id`.

## Vytvorenie, úprava a zmazanie

Názov udalosti tvorí skupina a prípona oddelená bodkou: napríklad `invoices.created`, `invoices.updated` a `invoices.deleted`.

| Skupina | Prípony | `resource.type` |
| - | - | - |
| `clients` | `created`, `updated`, `deleted` | `client` |
| `suppliers` | `created`, `updated`, `deleted` | `supplier` |
| `bank-accounts` | `created`, `updated`, `deleted` | `bankAccount` |
| `business-case-statuses` | `created`, `updated`, `deleted` | `businessCaseStatus` |
| `business-cases` | `created`, `updated`, `deleted` | `businessCase` |
| `contact-activity-logs` | `created`, `updated`, `deleted` | `contactActivityLog` |
| `warehouses` | `created`, `updated`, `deleted` | `warehouse` |
| `warehouse-inbound-receipts` | `created`, `updated`, `deleted` | `warehouseInboundReceipt` |
| `warehouse-outbound-receipts` | `created`, `updated`, `deleted` | `warehouseOutboundReceipt` |
| `price-list-items` | `created`, `updated`, `deleted` | `priceListItem` |
| `invoices` | `created`, `updated`, `deleted` | `invoice` |
| `credit-notes` | `created`, `updated`, `deleted` | `creditNote` |
| `proformas` | `created`, `updated`, `deleted` | `proforma` |
| `orders` | `created`, `updated`, `deleted` | `order` |
| `quotations` | `created`, `updated`, `deleted` | `quotation` |
| `document-payments` | `created`, `deleted` | `documentPayment` |

`created` označuje vytvorenie záznamu, `updated` jeho úpravu a `deleted` zmazanie. Detail načítate cez `GET /{skupina}/{id}`, napríklad `GET /clients/42`. Pri zmazanom zázname už detail nemusí byť dostupný.

## Úhrady dokladov

| Udalosť | `resource.type` |
| - | - |
| `invoices.paid` | `invoice` |
| `credit-notes.paid` | `creditNote` |
| `proformas.paid` | `proforma` |
| `received-invoices.paid` | `receivedInvoice` |
| `received-receipts.paid` | `receivedReceipt` |

Udalosť `paid` vzniká pri zaevidovaní úhrady, po ktorej je doklad vo Fintoro plne uhradený. Ide o stav evidovaných úhrad; pri čiastočne uhradenom doklade sa udalosť neposiela. Môže vzniknúť aj pri ďalšej úhrade už uhradeného dokladu. Samotné zaevidovanie úhrady oznamuje `document-payments.created`.

Fintoro API v1 neposkytuje detail prijatých faktúr ani bločkov. Udalosti `received-invoices.paid` a `received-receipts.paid` môžete použiť s vlastným mapovaním týchto dokladov, ale detail cez túto verziu verejného API nenačítate.

## Skladový stav

Udalosť `price-list-items.stock-updated` má `resource.type: "priceListItem"`. Vzniká po vytvorení, úprave alebo zmazaní skladovej príjemky či výdajky pre dotknuté položky.

Aktuálny stav položky načítajte cez `GET /price-list-items/{id}`. Môže sa zmeniť aj bez udalosti `price-list-items.updated`, preto na synchronizáciu skladových stavov odoberajte aj `price-list-items.stock-updated`.


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