Verze 5.43 rozšiřuje REST API ISPadminu o tři nové možnosti: stáhnout vystavenou fakturu v PDF, odeslat fakturu klientovi a nahrát soubor přímo do Karty klienta. Dohromady to znamená, že kolem fakturace a klientské dokumentace už nemusíte nic překlikávat ručně — vaše vlastní aplikace, portál nebo skript si to obslouží samy. A protože od verze 5.42 řídíte přes Správu tokenů, kdo vůbec smí API klíč vytvořit, přibývá vám možností bez toho, aby ubývalo kontroly.
Kolikrát denně se u vás někdo přihlásí do ISPadminu jen proto, aby stáhl jednu fakturu v PDF a přeposlal ji klientovi? Kolik podepsaných smluv leží ve sdílené složce místo u klienta v systému, protože je nikdo nestihl nahrát? A kolik času sežere měsíční rozesílání faktur, které by se dalo spustit jedním voláním? Pokud vám tyhle otázky nejsou cizí, verze 5.43 vám má co nabídnout.
Proč to vůbec řešit
REST API je dnes běžná brána do ISPadminu. Přes API se k systému připojují vlastní klientské portály, nadřazené firemní aplikace, e-signature nástroje, účetní systémy i jednoduché skripty, které někdo v týmu napsal, protože ho už nebavilo dělat totéž ručně.
Fakturace ale byla dlouho tím místem, kde integrace narazila. Data se přes API číst dala, jenže jakmile došlo na samotný doklad — vygenerovat PDF, poslat ho klientovi, uložit k němu podepsanou smlouvu — musel k tomu vždycky přijít člověk a odkliknout to v systému. Čím víc klientů, tím větší otrava, a hlavně tím větší prostor pro to, že se na něco zapomene.
Verze 5.43 tuhle mezeru zavírá.
Co nové možnosti API přinášejí
Stažení vystavené faktury v PDF. Fakturu už si přes API vytáhnete v podobě hotového dokladu, ne jen jako sadu údajů. Váš klientský portál tak může nabídnout stažení faktury přímo, bez toho, aby si ji klient chodil hledat jinam. Stejně dobře to poslouží archivaci nebo předání do účetního systému.
Odeslání faktury klientovi. Rozeslání dokladů se dá spustit z vaší strany, ve chvíli, kdy to dává smysl vašemu procesu — třeba až po kontrole v nadřazeném systému nebo navázané na jinou událost. Nikdo nemusí kvůli tomu vstupovat do ISPadminu.
Nahrání souboru do Karty klienta. Dokumenty, které vznikají mimo ISPadmin, se k příslušnému klientovi dostanou automaticky. Typicky podepsaná smlouva z e-signature nástroje, předávací protokol z terénu nebo doklad z jiné agendy. Místo „někdo to pak nahraje“ máte soubor tam, kde patří, hned.
Tři role, tři důvody, proč to ocení
Fakturantka přestane být úzkým hrdlem měsíční uzávěrky. To, co dosud znamenalo desítky kliknutí, si vezme na starost systém — a její čas zůstane na případy, které opravdu potřebují lidské oko.
Vývojář nebo integrátor konečně dostane celý proces do jedné integrace. Nemusí řešit poloviční řešení, kde se část kroků udělá přes API a část ručně, a hlavně nemusí uživatele posílat do dvou různých systémů.
Majitel ISP vidí výsledek na dvou číslech: rychlejší doručení faktur znamená dřívější platby, a méně ručních kroků znamená méně chyb, které se pak dohledávají a opravují.
Jak to zapadá do zbytku systému
Rozšíření API navazuje na to, o čem jsme psali v červenci — na Správu tokenů z verze 5.42. Tam jsme řešili, kdo vůbec smí API klíč vygenerovat, a zavedli k tomu samostatná oprávnění. Teď přibývá to, co se s takovým klíčem dá dělat.
Obojí spolu úzce souvisí. Čím víc toho API umí, tím větší smysl dává mít pod kontrolou, komu klíč vydáte. Pokud jste si po přechodu na 5.42 tokeny ještě neprošli, je tohle dobrá chvíle.
Tři tipy, jak to nasadit dobře
- Tip 1 — Začněte jedním procesem, ne všemi. Vyberte si to, co vás nejvíc zdržuje, nejčastěji rozesílání faktur, a nasaďte nejdřív jen to. Ověříte si celý řetězec na něčem, co má okamžitě viditelný přínos.
- Tip 2 — Pro každou integraci vlastní token. Nesdílejte jeden klíč napříč nástroji. Když pak potřebujete jednu integraci odpojit nebo dohledat, odkud volání přišlo, budete si to pamatovat.
- Tip 3 — Otestujte na malém vzorku. Než pustíte automatické odesílání na celou databázi, projděte to na několika klientech a zkontrolujte, co jim skutečně dorazilo.
Co z toho má ISP
- Méně ruční práce kolem fakturace — stahování PDF i rozesílání dokladů zvládne systém sám.
- Dokumenty na správném místě — podepsané smlouvy a protokoly se dostanou ke klientovi automaticky, ne až si na to někdo vzpomene.
- Lepší klientský portál — vlastní portál může nabídnout fakturu ke stažení přímo, bez odkazování jinam.
- Rychlejší platby — čím dřív se faktura dostane ke klientovi, tím dřív může být uhrazená.
Jak začít
Nové možnosti API jsou součástí verze 5.43. Pokud ji ještě nemáte nasazenou, ozvěte se nám o aktualizaci. Pak doporučujeme tři kroky:
- Krok 1 — Projděte si ve Správě tokenů, jaké API klíče u vás existují, a vydejte nový token pro integraci, kterou chystáte.
- Krok 2 — Vyberte jeden proces, který vás dnes stojí nejvíc času, a začněte u něj.
- Krok 3 — Ověřte výsledek na několika klientech, než to pustíte naostro.
V případě zájmu vám rádi poradíme s návrhem integrace i s nastavením oprávnění.