Integrace - Signi a MAKE / Integromat

Změněno dne Út, 4 Červen v 2:13 ODPOLEDNE

Principy a přínosy
Než začnete s integrací
Metody Signi konektoru vs. přímé volání Signi API
Příklad integračního scénáře “Google Form > Signi s využitím vzorů” v Integromatu
Příklad integračního scénáře “GoogleDrive > Signi s předáním souboru” v Integromatu
Stažení a nahrání příkladů blueprintů integračních scénářů
Další informace
Příklady realizovaných propojení

Principy a přínosy

Signi je aplikace, služba, IT komponenta, která zajistí elektronické podpisy na dokumenty od vašeho okolí, od vašich zákazníků, dodavatelům či zaměstnanců. Signi lze využívat přes uživatelské rozhraní nebo lze ovládat přes tzv. rozhraní pro programy - API.
Vaše aplikace má obdobně také nějaké API, kterým jde na dálku ovládat, nebo alespoň nějaký export souborů, možnost čtení z databáze apod.
MAKE/ Integromat je pak “lepidlem” mezi aplikacemi, služba, která zajistí, že se obě aplikace domluví na spolupráci s tím, že v něm lze můžete nadefinovat scénáře jak spolu mají “mluvit”, …
… aby byl zautomatizován celý firemní proces.

Než začnete s integrací

Podepisování dokumentů vypadá jako triviální úloha. Pošle se dokument k podpisu a vrátí se podepsaný. Zkušenosti nicméně ukazují, že variabilita procesů spojených s podepisováním je docela veliká - Kde se vezmou údaje pro podepsání? Kdo bude podepisovat kdy? Co se má stát po podpisu? Co pří odmítnutí podpisu či schválení?

Proto doporučujeme při přípravě na integraci se Signi alespoň zběžně proběhnout následující témata.

To nejdůležitější:

Budete potřebovat vytvořit dva integrační scénáře - jeden předává do Signi podklady, druhý naopak předává zpět výsledky podepisování.
Předávat jako podklady do Signi můžete buď hotové PDF/DOCX soubory nebo jen strukturovaná data pro vyplnění vzoru v Signi.
Získávat výsledky ze Signi zpět můžete tak, že si vytvoříte v Integromatu / MAKE tzv. webhooky a jejichž adresy předáte do Signi při předávání podkladů anebo si z výsledku volání uložíte contract_id tj. číslo dokumentu v Signi a periodicky se budete ptát na jejich stav.
Signi konektor vs. přímé volání Signi API - Signi konektor pro MAKE/Integromat obsahuje základní metody v základní variantě. Pokud to vaši potřebám nestačí, variantou přímé volání endpointů Signi API přes HTTP Request operátor. Více viz níže.

Příklad integračního scénáře v MAKE / Integromatu : Pipedrive > Signi

Příklad integračního scénáře v MAKE / Integromatu : Signi > Pipedrive

Metody Signi konektoru vs. přímé volání Signi API

Signi konektor pro MAKE/Integromat obsahuje základní metody v základní variantě . Stačí ho vyhledat pod názvem “Signi” při budování integračního scénáře. Více viz https://www.make.com/en/help/app/signi
HTTP request pro přímé volání API - Pokud vašim potřebám nestačí konektor je možností přímé volání endpointů Signi API přes HTTP Request operátor, který si vyhledáte pod názvem HTTP při návrhu integračního scénáře. Obsah pro jeho parametry viz Příklady volání Signi API a Typické úlohy při integraci. Jde tak využívat nové a pokročilé funkce, které nejsou dostupné v konektoru.

Příklad integračního scénáře “Google Form > Signi s využitím vzorů” v Integromatu

Podepsání dokumentu s využitím vzorů dokumentů v Signi je velmi rychlým způsobem integrace, kdy integrovaná aplikace obsahuje podklady pro vytvoření dokumentu, ale vlastní dokument vytvořit neumí, bylo by to moc složité či drahé.

Ukázat si vše lze na příkladu integračního scénáře “Google Form > Signi” kde se do Signi předají údaje pro vzor dokumentu, dokument vytvoří Signi, doplní údaje, zajistí podpisy a vrátí podepsaný dokument. Obdobně jako s Google Form lze integraci udělat s dalšími formulářovými řešeními typu Typeform , či z formulářů ERP, CRM, SCM systémů apod.

Integrační scénář pro MAKE Integromat Google Forms > Signi s předáním údajů do vzoru
Google Form formulář	Integrační scénář v Integromatu	Výsledný podepsaný dokument zaslaný na e-mailovou adresu z formuláře

Vyplňte na Signi API - Test Contract 2022 Zdroj údajů pro podepisovaný dokument. Tlačítko Odeslat / Submit odesílá údaje k dalšímu zpracování.	Ke stažení na Demo Integration - Google Forms > Signi Scénář přijme strukturované údaje z formuláře. pošle je do Signi spolu s číslem vzoru v Signi, kam se mají doplnit, Signi na základě toho vytvoří dokument a odešle ho k podpisu. Výsledek předání do Signi se odesílá emailem k dalšímu zpracování.	Výsledný podepsaný dokument vytvořený ze vzoru Testovací smlouva doplněný údaji z formuláře odeslaný v příloze všem podepisujícím Může obsahovat podpisy na úrovni prostý, zaručený, uznávaný i kvalifikovaný, předcházet může vzdálená identifikace až na úrovni AML zákona, součástí správy dokumentu může být dlouhodobá archivace na desítky let.

Příklad integračního scénáře “GoogleDrive > Signi s předáním souboru” v Integromatu

Podepsání dokumentu vytvořeného ze souboru je řešením pro situace, kdy vaše aplikace umí vytvořit soubor k podpisu a zároveň dodat data o tom, kdo má kdy co jak podepsat.

Ukázat si vše lze na příkladu integračního scénáře “Google Drive > Signi” kde se do Signi předají podpisu soubory z Google Drive složky.

Integrační scénář pro MAKE Integromat Google Drive > Signi s předáním souboru
Soubor na Google Drive	Integrační scénář v Integromatu	Výsledný podepsaný dokument
Ve složce na Google Drive je uložený soubor k podpisu. - zde Pro umístění podpisů využívá tzv. pole pro umístění podpisů - placeholdery, aby Signi mohlo umístit podpisy tam, kde je třeba .	Ke stažení Signi Integromat Blueprint - Google Drive - HTTP Request Scénář načte soubory ze složky Google Drive a předá je do Signi. Zároveň do Signi předá podpisový scénář ve formátu JSON - zde V něm jsou pro určení, kde se v dokumentu objeví čí podpis, u osob uvedeny názvy polí pro umístění podpisů - placeholdery z dokumentu.	Výsledný podepsaný dokument odeslaný v příloze všem podepisujícím Může obsahovat podpisy na úrovni prostý, zaručený, uznávaný i kvalifikovaný, předcházet může vzdálená identifikace až na úrovni AML zákona, součástí správy dokumentu může být dlouhodobá archivace na desítky let.

Stažení a nahrání příkladů blueprintů integračních scénářů

Příkladové scénáře integrace se Signi přes MAKE/Integromat najdete v této složce.
Do vašeho prostředí v MAKE / Integromat si je naimportujete přes Import Blue Print v editoru integračního scénáře .
Příkladové scénáře mají v sobě API klíč pro workspace DEMO API, API klíč svého workspace si nastavíte v parametrech modulu Signi či HTTP request v integračním scénáři.
Obdobně budete upravovat podpisové scénáře ve formátu JSON souboru, posílat své soubory k podpisu apod.

Stažení a nahrání příkladů blueprintů integračních scénářů v MAKE Integromat
Nahrání blueprintu od Make / Integromat	Nastavení API key na váš workspace	JSON obsahující detaily podpisového scénáře

Blueprinty integračních scénářů ke stažení