# Audit · Dokumentace DameDokladu

> Kdo, co, kdy a odkud ve firmě změnil. Každá změna dat, zapsaná přímo databází.

Source: https://damedoklad.cz/docs/guides/audit/

# Audit

Kdo, co, kdy a odkud ve firmě změnil. Každá změna dat, zapsaná přímo databází.

**Audit** v bočním menu ukazuje historii firmy: kdo co udělal, kdy a odkud. Vidí ho vlastník a účetní. Vlastní role ho nedostane, ať má jakákoli práva, protože shrnuje všechny agendy.

Každou změnu dat zapisuje přímo databáze, ve stejné transakci jako změnu samotnou. Nezáleží tedy na tom, jestli změna přišla z aplikace, přes API, z MCP, z importu nebo z úlohy na pozadí. Záznam nejde změnit ani smazat. Výjimkou je jen smazání celé firmy, které odstraní i její audit: kde byl účetní záznam opraven přepsáním, je audit dokladem o opravě (zákon o účetnictví § 35 odst. 3) a zákon může vyžadovat, abyste ho uchovali spolu s účetními záznamy (§ 31). Před smazáním si proto stáhněte export celé firmy, audit v něm je.

## Co v něm najdete

Jeden záznam odpovídá jedné akci. Vystavení faktury je jeden řádek, i když změnilo čtrnáct řádků v databázi. Když akce založí mnoho věcí najednou, například první faktura účtovou osnovu, jsou složené do jednoho řádku a rozbalí se na požádání. Po otevření vidíte:

-   **Kdo:** člověk se jménem a e-mailem z té chvíle, API klíč, připojená aplikace, nebo která úloha na pozadí. Když za klíčem, připojením nebo spuštěnou úlohou stojí člověk, je tam také. Změna, u které nikdo známý není, se ukáže jako „Nikdo známý“.
-   **Co:** agenda, doklad nebo kontakt a každé změněné pole, před a po.
-   **Odkud:** aplikace, veřejné API, MCP, úloha na pozadí, import, veřejný odkaz nebo webhook, a k tomu IP adresa a prohlížeč.

Kromě změn dat zapisuje i věci, které nic nemění, ale mají být vidět: přihlášení a neúspěšná přihlášení, stažení exportu celé firmy, mzdových dokumentů a hromadných souborů, použití oprávnění odesílat přes API a stažení samotného auditu. Běžné čtení a prohlížení se nezapisuje.

## Hledání a export

Filtrujte podle člověka nebo klíče, agendy, akce, místa a období, nebo hledejte třeba číslo faktury. **CSV** a **XLSX** stáhnou to, co vidíte, nejvýše 20 000 záznamů. Soubor shrnuje každý záznam na jeden řádek, jednotlivá pole jsou v aplikaci a v API. Celý audit i s hodnotami polí před a po je v exportu celé firmy v **Nastavení > Import a export**, v souborech `data/audit_transactions.json`, `data/audit_changes.json` a `data/audit_seals.json`.

## Historie dokladu

Na fakturách a dalších dokladech, na kontaktu, u zaměstnance a na skladových dokladech najdete tlačítko **Historie**, u pokladních dokladů je v nabídce řádku. Ukáže celou stopu záznamu včetně jeho řádků a plateb. Vidí ji každý, kdo smí číst ten záznam, jen bez IP adres.

## Co se do auditu neukládá

U tajných údajů audit zapíše jen to, že se změnily, nikdy jejich hodnotu: hesla, tokeny, certifikáty, klíče, přístupové údaje k bankám a úřadům, i jejich části, například začátek API klíče nebo přihlašovací jméno k dopravci. U adresy webhooku zůstává jen server, u zprávy v připojené schránce jen to, že přišla. Celé rodné číslo a bankovní účet v něm nejsou, ukazuje se stejná maska jako jinde v aplikaci, například `850101/****` a `****1234/0100`.

Mzdové údaje se řídí stejným pravidlem. U zaměstnanců a mezd audit říká, kdo a kdy změnil které pole, ale ne částku, adresu ani zdravotní údaje. Zůstává jen to, co záznam pojmenuje: jméno, osobní číslo, stav, období.

Audit je trvalý záznam. Když kontakt změníte nebo smažete nebo když člověk smaže svůj účet, původní hodnoty a jeho jméno v auditu zůstávají, protože ten nejde měnit. Vedení záznamů o činnosti je pro firmu oprávněný důvod, posouzení ale patří vašemu poradci.

## Ověření integrity

Záznamy se průběžně pečetí do řetězu otisků, zvlášť pro každou firmu. **Ověřit integritu** přepočítá řetěz z uložených dat a řekne, jestli nikdo nezměnil už zapečetěné záznamy. Výsledek zůstane na stránce a sám je také záznamem. Otisk z konce řetězu si můžete opsat a později porovnat: kdyby někdo s přístupem přímo do databáze přepsal celý řetěz, pozná se to jen tak.

## Přes API a MCP

Vše je dostupné i přes API a MCP: `GET /v1/audit/entries`, `GET /v1/audit/entries/{id}`, `GET /v1/audit/objects/{id}/history`, `GET /v1/audit/chain` a `POST /v1/audit/verify`. Parametr `locale` volí jazyk. Klíč potřebuje roli vlastníka nebo účetního, historie záznamu právo číst ten záznam. Dosavadní `GET /v1/audit-events` zůstává.