Prehľad udalostí

Názvy udalostí používajte v poli subscribedEvents pri vytváraní odberu. 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. 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ť 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.