API pro Trynx
Napojte na Trynx svůj e-shop, BI nástroj, účetnictví nebo vlastní aplikaci. Faktury, sklad, zakázky, úkoly i partnery předáte bez ručního přepisování a exportů.
REST API s odpověďmi v JSON, přes 250 endpointů a dokumentací OpenAPI 3. Pro AI agenty je připravený přehled llms.txt.
Dokumentace API → Jak začít# nezaplacené faktury vydané curl -X POST https://klienti.cz/api/invoice/get-all \ -d "api_token=VÁŠ_TOKEN" \ -d 'dataJSON={"unpaid":1,"limit":20}' # odpověď { "status": "ok", "total": 137, "data": [ … ] }
Co můžete napojit
E-shop a objednávky
Zakládejte partnery, zakázky a faktury z objednávek, čtěte stav skladu a ceník pro web.
BI a reporting
Power BI, Excel nebo vlastní sklad dat: faktury, úhrady, skladové pohyby, zakázky a nabídky. Stahujte jen změny od posledního načtení.
Účetnictví a závazky
Faktury vydané i přijaté včetně položek, úhrad a příloh, pokladní doklady, import přijaté faktury z ISDOC.
Úkoly a helpdesk
Požadavky zákazníků z vlastního portálu nebo formuláře rovnou jako úkoly, včetně zpráv, souborů a odpracované práce.
Doprava, dodávky a sklad
Rozvozy, dodávky, přijaté dodací listy, objednávky u dodavatelů a prodejna — pro dispečink nebo logistický systém.
AI agenti
Přehled llms.txt a specifikace po modulech jsou psané tak, aby si je AI agent načetl sám. Pro Claude a ChatGPT je hotový AI asistent.
Moduly API
| Modul | Endpointů | Přihlášení uživatele | Integrační token |
|---|---|---|---|
| Faktury vydané — položky, úhrady, přílohy | 44 | čtení i zápis | čtení |
| Faktury přijaté — úhrady, zakázky, přílohy, ISDOC | 27 | čtení i zápis | čtení |
| Pokladna | 17 | čtení i zápis | čtení |
| Úkoly — stavy, pracovníci, práce, zprávy, soubory, formuláře | 49 | čtení i zápis | — |
| Zakázky — položky, úkoly, práce, soubory | 18 | čtení i zápis | — |
| Nabídky — položky, úkoly, práce, soubory | 18 | čtení i zápis | — |
| Partneři — kontakty, pobočky | 11 | čtení i zápis | — |
| Znalostní báze — články, kategorie, soubory | 14 | čtení i zápis | — |
| Reporting — sklad, ceník, zakázky, nabídky, dodací listy, partneři | 17 | čtení | čtení |
| Doprava, dodávky, dodací listy přijaté, prodejna, objednávky | 20 | čtení | čtení |
| ORO a COCCZ — oznámení pro celní správu, exporty pro Coca-Colu | 9 | čtení | čtení |
Vždy platí práva uživatele, případně role, se kterou správce token vytvořil. Úplný seznam endpointů je v dokumentaci.
Jak začít
- Správce firmy vytvoří integrační token. V Trynxu v menu Nastavení → Firma → Nastavení → Integrace → Integrační tokeny vyplní název, vybere roli, jejíž práva token dostane, a token si zkopíruje. Zobrazí se jen jednou.
- Projdete si dokumentaci. Interaktivní Swagger UI pro lidi, llms.txt pro AI agenty. Pro zápis dat se aplikace přihlásí jako uživatel přes
/api/homepage/login. - Pošlete první požadavek. Všechny endpointy přijímají POST, token se posílá v těle požadavku, ne v adrese.
curl -X POST https://klienti.cz/api/invoicearrived/get-all \ -d "api_token=VÁŠ_TOKEN" \ -d 'dataJSON={"limit":10}'
Bezpečnost
- Integrační token je jen pro čtení. Přes něj nejde nic zapsat, upravit ani smazat.
- Vidí jen to, co smí. Platí práva role, se kterou správce token vytvořil, u přihlášení práva konkrétního uživatele.
- Rozhoduje správce firmy. Tokeny vytváří a odvolává jen on a vidí, kdy byl který naposledy použit.
- Odvolání platí okamžitě. Nástroj s odvolaným tokenem ztratí přístup při dalším požadavku.
- Token patří do těla požadavku. Posílejte ho přes HTTPS v těle POST, ne v adrese — tam by skončil v historii prohlížeče a v logech serverů.
Dokumentace
Časté dotazy
V jakém formátu API komunikuje?
Požadavky jsou POST s parametry ve formuláři, data a filtry se posílají jako JSON v parametru dataJSON. Odpovědi jsou v JSON. Všechny endpointy popisuje specifikace OpenAPI 3.
Můžu přes API data i zapisovat?
Ano, po přihlášení uživatele lze zakládat a upravovat například úkoly, zakázky, nabídky, faktury nebo partnery, vždy s právy toho uživatele. Integrační token je jen pro čtení.
Kdo vytvoří integrační token?
Správce firmy v Trynxu v Nastavení → Firma → Nastavení → Integrace → Integrační tokeny. Při vytvoření vybere roli, jejíž práva token dostane.
Jak token zrušit?
Ve stejném místě, kde vznikl, ho správce firmy odvolá. Nástroje, které ho používají, okamžitě ztratí přístup.
Funguje to pro více firem?
Integrační token patří vždy jedné firmě. Pro další firmu vytvoří její správce vlastní token.
Kde najdu pomoc s napojením?
V dokumentaci, nebo nám napište na info@klienti.cz.
Vyzkoušejte Trynx na 30 dní zdarma →
Nebo se nejdřív zeptejte — info@klienti.cz, +420 778 052 219.