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

# Event catalog

Use event names in the `subscribedEvents` field when [creating a subscription](https://docs.fintoro.sk/en/webhooks.md). In a received webhook, `resource.type` identifies the record type and `resource.id` contains its ID.

## Creation, updates, and deletion

An event name combines a group and suffix separated by a dot: for example, `invoices.created`, `invoices.updated`, and `invoices.deleted`.

| Group | Suffixes | `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` identifies record creation, `updated` an update, and `deleted` deletion. Fetch details through `GET /{group}/{id}`, such as `GET /clients/42`. The detail endpoint may no longer return a deleted record.

## Document payments

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

A `paid` event is emitted when a payment is recorded and the document is fully paid in Fintoro afterwards. It reflects recorded payments; the event is not sent while the document remains partially paid. It can also be emitted for another payment on an already paid document. The payment record itself is announced by `document-payments.created`.

Fintoro API v1 does not provide details for received invoices or receipts. You can use `received-invoices.paid` and `received-receipts.paid` with your own document mapping, but cannot fetch their details through this version of the public API.

## Stock levels

The `price-list-items.stock-updated` event uses `resource.type: "priceListItem"`. It is emitted for affected items after a warehouse inbound or outbound receipt is created, updated, or deleted.

Fetch the current item state through `GET /price-list-items/{id}`. Stock levels can change without a `price-list-items.updated` event, so also subscribe to `price-list-items.stock-updated` when synchronizing stock.


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