| Table of Contents |
|---|
| Info |
|---|
Stručný tahák - Co si ujasnit před integrací Signi s vaším systémem
|
Propojení se Signi
| Table of Contents |
|---|
Princip propojení se Signi
Výhodou propojení aplikací a služeb se Signi je jeho jednoduchost, celý proces zahrnuje 3 kroky.
...
Ve vaší Aplikaci je/ se přidá informace o průběhu vytvoření a ověření dokumentů
Varianty použití Signi API
...
Předání podkladů
Podporujeme dva způsoby předávání podkladů při integraci:
...
Více viz Jak se předávají podklady k podepisování?
Navrhovatel vs. smluvní strany
Při podepisování a tedy i předávání podkladů přes API je třeba odlišit:
Navrhovatel - Je tvůrce podepisovaného dokumentu a tedy musí mít účet v Signi. Může a nemusí být smluvní stranou, např. u realitních makléřů. Chodí mu zpět notifikace o tom, kdo dokument podepsal, odmítl podepsat apod. Může dokument zrušit. Nový dokument vidí v Odeslaných dokumentech. Ve variantě integrace "Jediný servisní účet" je právě tento účet tvůrcem dokumentu, který ale nepodepisuje.
Smluvní strana - Může a nemusí mít účet v Signi. Dokument může podepsat a odmítnout. Pokud má účet v Signi, nový dokument vidí v Odeslaných dokumentech (pokud je zároveň navrhovatelem), nebo v Přijatých dokumentech (pokud není navrhovatelem).
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:
...
Podepisuje
...
Schvaluje
...
Bianco podpis
...
Bez akce
...
Potvrzuje pouze PINem
Podepisuje první / poslední / v pořadí
Podepisuje
Člověku se odesílá notifikační SMS a e-mail, musí dokument fyzicky podepsat.
Nastavení:
Is_proposer: true / false, jde-li o zástupce navrhovatele
"contract_role": "sign"
"autosign_place": parametr se nepředává anebo musí být prázdný
Člověk:
...
-
...
má
...
podpis
...
Ve variantě použití “Jediný servisní účet v Signi” skutečný statutární zástupce firmy není navrhovatelem tj. při volání je is_proposer = false, nesmí mít účet v Signi, jako navrhovatel bude veden servisní účet ve variantě “Bianco podpis”.
...
na dokumentu
...
Nastavení:
"contract_role": "sign",
"autosign_place": je vyplněn nějaký text, např. "V Praze"
Is_proposer: true
Člověk:
Tato možnosti se týká se pouze smluvní strany, která je zároveň navrhovatelem, tvůrcem dokumentu tj. Is_proposer: true. Uživatel s daným e-mailem musí být v týmu pracovního prostoru/workspace navrhovatele, má tam nastaveno právo podpisu a musí mít uložený grafický podpis ve svém uživatelském profilu. Pokud nemá uživatel uložený grafický podpis ve svém profilu, vrací se odpovídající chyba.
...
Člověku se neodesílá notifikační SMS a e-mail, nic nepodepisuje, pouze zmáčknutím tlačítka dokument schválí.
Nastavení:
"contract_role": "approve"
"autosign_place": je vyplněn nějaký text, např. "V Praze"
Člověk:
Člověk s daným e-mailem nemusí mít účet na Signi.
Pokud účet má a jde o zástupce navrhovatele tj. is_proposer=true, musí být v týmu pracovního prostoru/workspace navrhovatele, musí mít nastaveno právo podpisu, nemusí mít uložený podpis.
Bez akce
Týká se situací, kdy někdo dokument navrhuje, ale není smluvní stranou. Příkladem je makléř v realitní kanceláři. Druhým příkladem je varianta použití “Jediný servisní účet v Signi” při integraci. Člověku se neodesílá notifikační SMS a e-mail, na dokumentu není jeho podpis, dokument má k dispozici v pracovním prostoru.
Nastavení:
"is_proposer": true,
"contract_role": "approve",
"autosign_place": jakýkoliv text např. "V Praze"
Člověk:
Člověk s daným e-mailem je v týmu pracovního prostoru/workspace navrhovatele, nemusí mít právo podpisovat, nemusí mít uložený grafický podpis ve svém uživatelském podpisu.
...
Připravujeme další varianty podepisování, například:
...
Na vědomí - Člověku se odesílá SMS a e-mail s odkazem na podepsaný dokument, resp. informace o jeho odmítnutí či expiraci, nijak se k dokumentu nevyjadřuje.
...
Podepisuje jen PINem - Člověku se odesílá notifikační SMS a e-mail, kromě schválení zadává PIN pro 2faktorovou funkcionalizaci.
...
/ Schvaluje - jen potvrdí souhůas s dokumentem, podpis není vidět
Podepisují všichni najednou resp nejdříve navrovatelé a pak protistrany / Záleží na pořadí
Podepisuje první / poslední / v pořadí
Předá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
Autentikace
Jediný servisní účet v Signi
...
Připravujeme i možnost osobních API klíčů či autentikaci přes Oauth2 apod.
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:
...