| Table of Contents |
|---|
Princip propojení se Signi
Výhodou propojení aplikací a služeb se Signi je jeho jednoduchost, celý proces zahrnuje 3 kroky.
...
Varianty použití Signi API
Předání podkladů
Podporujeme dva způsoby předávání podkladů při integraci:
...
Výchozí rozsah služeb Signi zahrnuje pouze předávání dokumentů. Použití vzorů je placené rozšíření.
...
Varianty vyvolání podepsání z integrované aplikace
Jsou tří základní 4 cesty :
Distanční podepsání - Podepisujícím po zavolání end pointu pro podpis dokumentu či vzoru Signi odesílá e-mailová notifikace s odkazem na stránky pro podepsání. Pokud je uvedeno tel. číslo, může odcházet i SMS notifikace. Je to obdoba standardního odeslání dokumentu k podpisu přes uživatelské rozhraní Signi.
Podpis v integrované aplikaci - End point pro podpis dokumentu vrací URL pro podpis jednotlivých podepisujících, viz Jak získám výsledek předání podkladů pro podpis, a integrovaná aplikace zobrazí odpovídající odkazy, rámce apod. pro podpis jednotlivých osob. Pozor, pokud je podepisujících více, musí mít všichni svůj prostor k podpisu. Je to obdoba podpisu na jednom zařízení přes uživatelské rozhraní Signi.
Signi jako fronta práce - Integrovaná apliakce zakládá do Signi dokumenty ve stavu rozpracováno a uživatelé “v poli” používají Signi jako svojí aplikaci s frontou své práce, odkud berou dokumenty a postupně je s pritistranami podepisují.
...
Předávání výsledků
Zpětným voláním
Součástí předávání podkladů pro podpis jsou i tři URL adresy tzv. “webhooků” pro každou hodnotu výsledku:
...
Více viz Jak získám výsledek předání podkladů pro podpis
3 kroky elektronického právního jednání
Elektronické právní jednání zahrnuje 3 kroky a to vzálenou identifikaci , el. podpis a archivaci elektronických dokumentů. Všechny tři kroky se nějakým způsobem promítají i do Signi API.
Vzdálená identifikace - v rámci podepisování v Signi probíhá standardně 2-faktorové ověření přes e-mail a telefon přes PIN zaslaný v SMS. Volitelně lze přes API vyvolat i pokročilé varianty vzdálené identifkace.
Podepisování - lze předávat soubory k podpisu nebo parametry pro vzory v Signi
Archivace - Dlouhodobou archivaci dokumentů lze zajistit přímo v Signi pomocí Signi Archiv . Alternativně lze jakýkoliv elektronický archiv se SIgni integrovat - podepsané uzavřené dokumenty posíoá Signi přes zpětně volané webhooky nebo si archiv dokumenty vhodné k archivaci zjiš%tuje archiv sám. Archiv dokumenty načtě, případně je může přes API ze Signi i smazat.
Způsoby autentikace
Jediný servisní účet v Signi
...
Připravujeme i možnost osobních API klíčů či autentikaci přes Oauth2 apod.
Navrhovatel vs. smluvní strany
Při podepisování a tedy i předávání podkladů přes API je třeba odlišit:
...
Při integraci přes API je nejjednoudušší scénář Jediný servisní účet (viz výše). V tomto případě je automaticky navrhovatelem resp. autorem dokumentů vždy vlastník pracovního prostoru Signi, do kterého se posílá dokument k podpisu přes API. Ten na dokumentu nikde nefiguruje, ani ho nepodepisuje, ani ho neschvaluje. Podepisující či schvalovatelé, ať z firmy navrhovatele či mimo ni jsou smluvními stranami.
Existence účtu na službě Signi
Člověk podepisující, resp. schvalující dokument může a nemusí mít účet v Signi. Z hlediska volání API je to jedno, liší se pouze chování služby, resp. její uživatelské rozhraní před zobrazením dokumentu k podpisu.
Mohou tedy nastat 2 situace:
uživatel nemá účet v Signi - po kliknutí na link v notifikační SMS / e-mailu se mu ukáže rovnou dokument k podepsání; až po podpisu se mu nabídne, zda si chce zřídit účet v Signi,
uživatel již má účet v Signi - po kliknutí na link v notifikační SMS / e-mailu se mu ukáže přihlašovací obrazovka Signi a po přihlášení má přístup k dokumentu k podepsání.
Scénáře podepisování
Ač se to na první pohled nezdá, existuje více různých variant podepisování, resp. schvalování dokumentu, které lze navíc kombinovat pro různé zúčastněné strany:
...
Podepisují nejdříve navrhovatelé a pak protistrany
Záleží na pořadí podepisujících
Jak zajistit propojení
Integrace Signi na jiný systém může být zajištěna různými způsoby. Integraci může zajistit:
...