subscribedEvents field when creating a subscription. 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.
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
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
Theprice-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.