| Table of Contents |
|---|
Co si má business rozmyslet před integrací?
Klíčové otázky jsou popsané v 7 otázek k rozmyšlení před integrací se Signi . Doporučujeme si je projít, člověk se pak vyhne nepříjemným překvapením typu “Aha a kde vezmeme e-mail jednatele zákazníka?” nebo “Aha a jak uživatel vlastně vybere, které dokumenty chce odesílat v jedné sadě?” v situaci, kdy už má integraci skoro odevzdat. Ač se zdá “podepsání dokumentu” triviální úloha, někdy získání všech podkladů, různé podpisové scénáře a reakce na výsledky podepisování zcela triviální nejsou.
Jak si nastavit prostředí Signi pro integraci?
1.Založit jediný hlavní účet na Signi, který je Vlastníkem všech workspace
Založení účtu na Signi - viz postup na Vytvoření účtu a první přihlášení do aplikace. Hlavní účet Signi doporučujeme založit pod e-mailem nikoliv konkrétního člověka, ale na e-mail typu info@firma.cz či signi@firma.cz s tím, že pošta zaslaná na tento e-mail musí být přístupná zřizovateli účtu. Ten musí potvrdit registrační e-mail zaslaný ze Signi.
Přes tento účet se následně řeší i veškeré objednávání a placení služeb Signi, zakládání workspace, nastavování jejich parametrů, přidávání lidí do týmu, generování API klíčů apod. pro vaši firmu.
Založit workspace pro testování integrace
Při založení účtu na Signi se automaticky vytvoří pracovní prostor - workspace pro zřizovatele účtu.
Pro integraci se pod hlavním účtem vytvoří typicky ještě další 2-3 workspace např. Agenda X - PRODUKCE / Agenda X - TEST / Agenda X - DEVELOPMENT, viz Vytvoření více workspace . Nemíchají se tak provozní data s vývojovými či testovacími.
Každý workspace má svůj API klíč, každé prostředí na straně integrované aplikace používá API klíč pro "svůj" workspace. Při přechodu z vývoje na test či produkci tedy stačí prohazovat API klíče.
Zpřístupnění API a získání API klíčů
Pro vývojový / demonstrační workspace je přístup API zdarma, aktuálním řešením je napsat na help@signi.com žádost “Integrační balíček” s uvedeným hlavním e-mailem a názvem workspace, které chcete v tomto režimu používat. My vám přístup přes API povolíme.
Následně si pro workspace pod svým hlavním účtem vygenerujete API klíče svých workspace, viz Generování API klíče.
Využití workspace pro agendy mimo integraci
Ve vaší organizaci můžete mít i workspace pro používání Signi napřímo přes uživatelské rozhraní, kdy uživatelé vkládají dokumenty k podpisu přes uživatelské rozhraní Signi.
Více viz Kombinace obou přístupů.
| Info |
|---|
Pokud se nastavováním nechcete probírat sami, rádi vás celým procesem provedeme v rámci zprovozňování Signi ve vaší firmě. Osvědčilo se vám něco jiného? Narazili jste na situace, kdy vám toto uspořádání nevyhovuje? Dejte nám vědět. |
Jaké jsou nejčastější chyby při volání Signi API
...
Chybové kódy začínající 400 jsou specifické chyby Signi, kde z chybového hlášení má být zřejmé, co je příčinou a jak ji odstranit.
...
“Invalid JSON” může znamenat , že je skutečně někde syntaktická chyba v JSON, což se vzhledem k jeho složitosti snadno stane. Pomoci mohou různé JSON validátory, např. https://jsonformatter.curiousconcept.com/. Další možností je, že soubor resp. řetězec není ve znakové sadě UTF-8 , ale ASCII , UNCODE a podobně.
...
400 - "Contract must have at least one proposer." - Musí být určeno, kdo bude autor dokumentu za navrhovatele. Hodnota parametru isProposer je v tomto případě true. Může to být e-mail vlastníka workspace, který dokument jen schvaluje tj. nepodepisuje, příčemž schválení proběhne při volání přes API automaticky. Více vic Příklad 2.
...
Podepisování dokumentů vypadá jako triviální úloha - pošle se dokument k podpisu a vrátí se podepsaný. Nicméně zkušenosti ukazují, že variabilita procesů spojených s podepisováním je docela veliká.
Proto poporučujeme při příprave na integraci se Signi alespoň zběžně proběhnout následující témata:
| Child pages (Children Display) |
|---|