Dokumentace API Salda
Stejné rozhraní, které používá aplikace Saldo. Čtěte a zapisujte doklady, banku, knihy, daně i mzdy z vlastních nástrojů. Veřejné kalkulátory a číselníky fungují bez přihlášení.
Základní adresa
https://techtools.cz/ucetnictvi-apiVšechny cesty v této dokumentaci jsou relativní k základní adrese. Operace jedné firmy začínají /entities/{entity_id}; seznam firem, ke kterým máte přístup, vrátí GET /entities.
cURL
curl -H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entitiesJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const firms = await response.json();Než začnete
- Rychlý startZa 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.
- Přihlášení, klíče a oprávněníAPI přijímá osobní klíč nebo přihlášení v prohlížeči. Co smíte, určuje vaše role ve firmě. Klíč nikdy nedostane víc práv, než máte vy.
- Formát dat a konvenceJak API zapisuje částky, měny, datumy a období, jak se posílá tělo požadavku a jak se stránkují seznamy.
- Chyby a limityCo API vrací, když požadavek neprojde, a jaké limity platí. Chyby konkrétní operace uvádí reference u ní.
- Soubory, importy a opakováníJak do Salda posílat soubory, kolik a jak velké smějí být, a které operace lze bezpečně zopakovat. Obecný klíč proti zdvojení požadavků API nemá, chování se liší podle operace.
- Stavy a vedlejší účinkyKoncept, vystavení, zaúčtování, úhrada, spárování, podání a doručenka jsou v Saldu různé kroky. Tady je, co který krok zapíše a co nechá beze změny.
Reference podle oblastí
- Veřejné kalkulátory a číselníkySazby, svátky, lhůty, číselníky, QR Platba, čtení ISDOC, kalkulátory a sdílené faktury bez přihlášení.11 operací
- Účet, firmy a přístupyAPI klíče, pozvánky, firmy, jejich nastavení, členové a role, historie změn, vyhledání firmy podle IČO.24 operací
- KontaktyOdběratelé a dodavatelé, načtení z ARES, kontrola v registru plátců DPH a v insolvenčním rejstříku.10 operací
- Doklady a jejich stavyFaktury, zálohy, dobropisy, pokladní a obchodní doklady; koncept, vystavení, storno, platby a opakování.35 operací
- Schvalování výdajůPravidla schvalování přijatých výdajů a rozhodnutí o jednotlivých dokladech.5 operací
- Přílohy a importyPřílohy dokladů, import ISDOC a převod dat z jiných programů s náhledem a vrácením.9 operací
- Banka, párování a výpisyÚčty a pokladny, import výpisů, archiv originálů, kontrola zůstatků, párování a bankovní pravidla.30 operací
- Účetní knihy a výkazyÚčtový rozvrh, účetní zápisy, sestavy a výkazy, měsíční a roční uzávěrka.14 operací
- Daně, podání a doručenkyDPH, kontrolní a souhrnné hlášení, daň z příjmů, přehledy OSVČ, XML, EPO, evidence podání a doručenek.21 operací
- Majetek, mzdy a cestyDlouhodobý majetek a odpisy, zaměstnanci a výplatní pásky, JMHZ a cestovní náhrady.25 operací
- Automatizace, fronta a podkladyAutomatizace, přehled klientů, fronta úkolů účetní a žádosti o chybějící podklady.14 operací
- Exporty a předání účetníBalíček pro účetní, export do POHODY a Money S3, platební příkazy a export dat firmy do JSON.6 operací