Versions Compared

Old Version 8

changes.mady.by.user Roman Řípa (Unlicensed)

Saved on

compared with

New Version 9

changes.mady.by.user Zuzana Vankeova

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
Info

Stručný tahák - Co si ujasnit před integrací Signi s vaším systémem

  1. Odkud se vezmou kontaktní údaje na podepisující? - Jméno, Příjmení, emailE-mail, telefon Telefon (ten není povinný, ale pak ho uživatel musí zadat sám, aby mu přišla SMS a on mohl být ověřen).

  2. Co se bude to posílat? - Hotový dokument PDF/DOCX/HTML/XSLX nebo parametry pro vzor dokumentu uložený v Signi?

  3. Jak se vyvolá akce podpisování? - Akce v menu na relevantním záznamu, nastavení nějakého custom pole na hodnotu "Odeslat k podpisu” apod.

  4. Kde se uživateli ukáže výsledek podpisu? - Stav podepisování / výsledný dokument případně celou historii podepisování (viz kontrolní list)

  5. Jak se umístí podpisy? - Nejjednodušší je statické umístění na přesné souřadnice (vhodné pro formuláře typu Evidenční list důchodového pojištění), umístění na konci dokumentu (dostupné již brzy, Signi vloží podpis, jméno, příjmení, místo, čas ), dynamické umístění podpisu (cílový stav, placeholdery pro podpisy v dokumentu, vyžaduje flexibilitu určení např. více smluvních stran, za každou stranu podepisuje více lidí).

  6. Jak se předávají výsledky zpět? - Preferovanou variantou je webhook volající aktivně integrovaný systému systém s výsledkem podepisování. Alternativně se lze z integrovaného systému periodicky ptát na výsledek podepisování.

  7. Jaká bude vazba mezi uživateli a pracovními prostory - workspace v Signi? - Nejjednodušší scénář: V Signi je zavedený servisní účet pro celý integrovaný systém nebo jeho jednotlivé koncové zákazníky. Podepisující z firmy zákazníka jsou uváděni jako jedna z podepisujících stran, přijde jim email e-mail a SMS. Jinou variantou je, že si zákazníci zřídí svůj účet na Signi sami, mají pak možnost přístupu k dokumentům i v Signi, pouze se nastaví integrace přes API, která jim posílá dokumenty k podpisu do určeného pracovního prostoru / workspace . Další scénáře jsou možné dle domluvy.

  8. Kdo bude platit? - Bud měsíční vyúčtování koncovému zákazníkovi zasílá provozovatel integrovaného systému a nakupuje kredity u Signi za velkoobchodní cenu, anebo koncový zákazník platí Signi a provozovatel integrovaného systému posílá měsíční fakturu na provizi. V obou případech Signi dodává přehled s počtem kreditů vyčerpaných po pracovních prostorech / workspacech a měsících.

Propojení se Signi

Výhodou propojení aplikací a služeb s iSmlovou 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ů

...

Předání podkladů

Podporujeme dva způsoby předávání podkladů při integraci:

  • Předání souborů - Ve vaší Aplikace Aplikaci je vygenerován kompletní soubor ve formátu pdf, doc, docx, odt, který je s ostatními parametry odeslán do API Signi k podpisu.

  • Předání parametrů pro vzor - Vaše Aplikace poskytne metadata (hlavičky, obsah jednotlivých doplňovacích polí smlouvy apod.) pro doplnění vzoru dokumentu, který je vytvořen a uložen v aplikaci Signi. Tato metadata společně s ostatními parametry jsou odeslány do API Signi.

...

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ň navrhoatelem navrhovatelem), nebo v Přijatých dokumentech , (pokud nikolivnení navrhovatelem).

Existence účtu na službě Signi

Člověk podepisující, resp. schvalující dokument může a nemusí  mít 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. Po kliknutí na notifikační SMS a e-mail, člověku, který
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:

...

  • 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. 

  • Podepisuje první / poslední / v pořadí - Aktuálně notifikační SMS a e-mail odejde vždy všem stranám najednou. Tím se API liší od uživatelského rozhraní, kdy v rámci přípravy nejprve podepisuje navrhovatel a pat teprve protistrany. Pořadí podepisování půjde nastavovat.

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:

...