Obdobně jako v aplikaci lze i přes REST API dohledat historii vybraných záznamů. Ve vybraných evidencích se zaznamenávají provedené změny záznamů a jejich jednotlivých polí — tzv. žurnál — a přehled změn vám je zpřístupní k zobrazení i další analýze.
Sestavení URL
Služba je podřízeným zdrojem konkrétního záznamu:
GET https://demo.flexibee.eu/c/demo/faktura-vydana/1/zmeny.json
V adrese /c/{firma}/{evidence}/{id}/zmeny je {firma} databázový identifikátor firmy, {evidence} evidence a {id} identifikátor záznamu. Jak adresu poskládat, popisuje návod pro sestavování URL adresy. Fungují i běžné parametry jako limit a add-row-count.
Ve kterých evidencích je přehled dostupný
Do žurnálu se ukládají změny pro většinu, ne však pro všechny evidence — subevidence /zmeny je proto dostupná jen na některých, stejně jako v aplikaci:
faktury vydané a přijaté,
banka, pokladna a interní doklady,
přijaté a vydané objednávky,
příjemky a výdejky,
adresář,
ceník,
majetek,
cenové úrovně,
zakázky,
typy dokladů.
ℹ️ Chybu si nepleťte se dvěma různými 404: formZaznamNenalezen znamená, že subevidence existuje, ale záznam s daným ID ne. Kód adresaNeplatnaUrl naopak říká, že tato evidence přehled změn vůbec nemá.
Ukázka výstupu
Každý řádek popisuje jednu změnu jednoho pole — název sloupce v databázi, původní i novou hodnotu, uživatele a čas:
{
"winstrom":{
"@version":"1.0",
"zmeny":[
{
"hlavicka_polozka":"Hlavička dok.",
"nazev":"",
"poradi_polozky":"",
"sloupec":"juhsum",
"puvodni_hodnota":"0.00",
"zmenena_na":"2500.00",
"uzivatelem":"knovak",
"operace":"změna",
"datcas":"2018.01.11 - 13:13:43"
},
{
"hlavicka_polozka":"Hlavička dok.",
"nazev":"",
"poradi_polozky":"",
"sloupec":"stavuhrk",
"puvodni_hodnota":"",
"zmenena_na":"stavUhr.uhrazeno",
"uzivatelem":"knovak",
"operace":"změna",
"datcas":"2018.01.11 - 13:13:43"
}
]
}
}
U dokladů rozlišuje hlavicka_polozka a poradi_polozky, zda šlo o změnu hlavičky nebo konkrétní položky, a operace nese hodnoty jako vloženo či změna. U ceníku, adresáře a číselníků se tyto tři vlastnosti nevracejí — výstup obsahuje jen nazev, sloupec, puvodni_hodnota, zmenena_na, uzivatelem a datcas.
📝 Vlastnost sloupec obsahuje název sloupce v databázi (například stavuhrk), nikoli názvy vlastností používané v REST API. Potřebujete-li naopak zjistit, které záznamy se od určitého okamžiku změnily, použijte Changes API.