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ů 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 vašeho integrovaného systému viz Koncepty Signi API.
Jak si nastavit prostředí Signi pro integraci?
Založte hlavní účet na Signi, který bude vlastníkem všech vašich pracovních prostorů - workspace na Signi - viz postup na Vytvoření účtu a první přihlášení do aplikace. Hlavní účet Signi doporučujeme založit pod e-mailovou adresou nikoliv konkrétního člověka, ale na e-mail typu info@firma.cz či signi@firma.cz. Nemusí jít přímo o e-mailovou schránku, za kterou se často platí, stačí e-mailová skupina, do které je zařazen někdo z týmu. Podstatné je, aby někdo z týmu mohl potvrdit registrační e-mail zaslaný ze Signi.
Při založení účtu na Signi se automaticky vytvoří pracovní prostor - workspace pro zřizovatele účtu. Ten ignorujte. Založte workspace pro testování integrace a školení, doporučujeme název DEMO a jeden produkční workspace pro firmu či více workspace pro jednotlivé agendy u vás ve firmě např. MARKETING, SALES, HR, SOURCING, ADMIN, jednotlivé země apod. viz Vytvoření více workspace. Nebudou se tak míchat provozní data s vývojovými či testovacími. Pozor! Ve všeh případech musí jít o pracovní prostor pro právnické osoby, aby zde byla možnost zpřístupnit pracovní prostor širšímu týmu.
Pro testovací a produkční workspace si vygenerujte API klíč , který souží pro autentizaci při volání Signi přes API. Přes Signi API pak předávajte dokumenty k podpisu, zjišťujte stav jejich podepsání, stahujte si podepsané dokumenty apod.
Pokud se nastavováním nechcete probírat sami, rádi celé nastavení uděláme společně s vámi.
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 .