Preskoči na glavno vsebino

Prehľad zmien záznamu v REST API

Ako vyhľadať históriu záznamu cez REST API?

Avtor: Petr Pech

Obdobne ako je to v aplikácii, je aj cez API možné vyhľadať celú históriu vybraných záznamov.

Vo vybraných evidenciách sú zaznamenávané vykonané zmeny záznamov a ich jednotlivých polí, tzv. žurnál. Prostredníctvom prehľadu zmien záznamov je možné zobraziť históriu zmien a analyzovať ich.

Služba je dostupná na adrese: /c/{firma}/{evidence}/{id}/zmeny.json

  • {firma} je databázový identifikátor firmy,

  • {evidence} je evidencia,

  • {id} je identifikátor záznamu.

Ako zostaviť URL adresu nájdete v návode pre zostavovanie URL adresy.

Do žurnálu sa ukladajú zmeny pre väčšinu evidencií, nie však pre všetky. Subevidencia /zmeny je dostupná iba v niektorých (obdobne ako je to v aplikácii).

Jedná sa o evidencie:

  • Faktúry vydané, faktúry prijaté

  • Banka, pokladnica a interné doklady

  • Prijaté a vydané objednávky

  • Príjemky/výdajky

  • Adresár

  • Cenník

  • Majetok

  • Cenové úrovne

  • Zákazky

  • Typy dokladov

Ukážka použitia:

Ukážka výstupu:

{
"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"
}
]
}
}
Ste s tem dobili odgovor na svoje vprašanje?