| 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.
Koncepty Signi API
Podepisování dokumentů na první pohled 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 je dobré se zorientovat, co jsou klíčové varianty při zabudování podepisování do integrovaného systému viz Koncepty Signi API.
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
...
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
...
| 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.
Občas můžete narazit na univerzální chybu 500, snažíme se ji minimalizovat. Pomozte nám ji minimalizovat nahlášením situace na help@signi.com .