SaldoDokumentace Otevřít Saldo

Rychlý start

Za pár minut načtete firmy a doklady přes API a vytvoříte první koncept faktury. Zápisy si nejdřív vyzkoušejte na ukázkové firmě se smyšlenými daty.

Ověřeno 28. září 2026 proti kódu API.

Co budete potřebovat

  • Účet TechTools a aspoň jednu firmu v Saldu, ve které jste přijatým členem. Ukázková firma stačí.
  • Osobní API klíč z aplikace (postup níže). Klíč jen pro čtení stačí na operace GET kromě stažení XML hlášení JMHZ.
  • Nástroj, který umí poslat požadavek HTTPS s hlavičkou, například curl nebo fetch v Node.js 18 a novějším.

Veřejné operace, jako sazby, lhůty nebo kalkulátory, klíč nepotřebují. Najdete je v části Veřejné kalkulátory a číselníky.

Vytvořte API klíč

Kdo
Kdokoli přihlášený do Salda. Klíč jedná s vašimi právy ve všech firmách, kde jste přijatým členem.
Platí pro
Všechny firmy.

Než začnete

  • Přihlášení v prohlížeči. Klíče se spravují jen v aplikaci, API klíčem je spravovat nelze.

Postup

  1. V Saldu otevřete Nastavení a záložku API a integrace.
  2. V části API klíče pro skripty a AI agenty napište do textového pole název klíče, podle kterého ho poznáte, například Export do tabulek.
  3. Nechte zaškrtnuté Jen čtení, pokud klíčem nebudete nic měnit. Pro zápisy zaškrtnutí zrušte.
  4. Klikněte na Vytvořit klíč.
  5. V okně s klíčem klikněte na Kopírovat a klíč si uložte do správce hesel nebo proměnné prostředí.

Výsledek

Klíč začíná saldo_ a je v seznamu Vaše klíče se stavem Aktivní. Celý klíč se zobrazí jen jednou. Saldo si ukládá pouze jeho otisk a v seznamu ukazuje poslední čtyři znaky.

Když něco nejde

Hláška „Můžete mít nejvýš 20 aktivních klíčů“.
Klíč, který už nepoužíváte, zrušte tlačítkem Zrušit a potvrďte Zrušit klíč. Pak vytvořte nový.
Klíč jste nestihli zkopírovat.
Znovu ho zobrazit nejde. Klíč zrušte a vytvořte nový.

Související

Zjistěte ID firmy

Operace jedné firmy mají v cestě /entities/{entity_id}. Seznam firem, ke kterým máte přístup, vrátí Firmy, ke kterým má uživatel přístup.

cURL
export SALDO_API_KEY="saldo_…"
curl -H "X-API-Key: $SALDO_API_KEY" https://techtools.cz/ucetnictvi-api/entities

Odpověď je pole firem. U každé najdete id, název, právní formu, způsob vedení účetnictví, stav plátce DPH a vaši roli v poli role a příznaky can_write a can_manage. Ukázkové firmy mají settings.demo rovno true.

Načtěte doklady

Seznam dokladů filtruje mimo jiné podle druhu, stavu platby, textu a roku. Stránkuje parametry page a per, výchozích je 100 dokladů na stránku, nejvýš 500.

cURL
curl -H "X-API-Key: $SALDO_API_KEY" \
  "https://techtools.cz/ucetnictvi-api/entities/1/documents?kind=invoice_out&state=unpaid&per=2"
JavaScript (Node.js 18+)
const base = 'https://techtools.cz/ucetnictvi-api';
const response = await fetch(`${base}/entities/1/documents?kind=invoice_out&state=unpaid&per=2`, {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const { total, page, per, rows } = await response.json();

Odpověď obsahuje total (počet všech nalezených dokladů), page, per, sums (součty v Kč) a rows. Každý řádek nese mimo jiné number, status, payment_state, total_payable a remaining.

Vytvořte koncept faktury

Založení dokladu bez issue: true uloží koncept: bez čísla, bez zaúčtování a bez vlivu na DPH. Koncept je bezpečný první krok. Vystavení je samostatná akce.

cURL
curl -X POST -H "X-API-Key: $SALDO_API_KEY" -H "Content-Type: application/json" \
  -d '{"document":{"kind":"invoice_out","partner_id":1,"issue_date":"2026-09-28","taxable_date":"2026-09-28","due_date":"2026-10-12","lines_attributes":[{"description":"Konzultace – digitální strategie","quantity":6,"unit":"hod","unit_price":2200,"vat_rate":21}]}}' \
  https://techtools.cz/ucetnictvi-api/entities/1/documents

ID firmy i kontaktu z příkladu nahraďte svými. partner_id je ID kontaktu ze seznamu kontaktů; kontakt, který ve firmě není, API bez chyby vynechá a koncept uloží bez odběratele.

Odpověď 201 vrátí koncept se status draft a dopočtenými částkami. Až koncept zkontrolujete, vystavíte ho operací Vystaví koncept. Vystavení přidělí číslo z číselné řady a v podvojném účetnictví vytvoří účetní zápisy. Co se při kterém kroku změní, popisuje Stavy a vedlejší účinky.

Kam dál