Kapitola 3: Administrátorská příručka (Signi)

3.1 Nastavení integrace

Cesta: Administrace > Integrace > Signi.
Vyplňte API klíč a zapněte integraci (pouze globální integrace je podporována).
Hook uloží SigniApiKey do konfigurace; bez povolené integrace s klíčem akce odeslání/storno selžou.

Parametr	Výchozí hodnota	Popis
`Místo podpisu`	prázdné	Volitelný text s místem navrhovatele; ukládá se do konfigurace, aktuální odesílání ho do payloadu Signi nepřidává.

Modul přidává panely Podepisovatelé a Signi do detailu/malého detailu Dokumentu. Úpravy proveďte v Administrace > Správce rozložení > Dokument.
Stavová pole signiId, isSend, isSigned a signiDocumentLink jsou jen pro čtení; přidejte je do seznamu/detailu, pokud chcete vidět průběh.
Akce Signi: Odeslat k podpisu / Signi: Stornovat vyžadují oprávnění upravit na entitu Dokument. Uživatel musí mít přístup k Uživatelům/Kontaktům, aby mohl vybírat podepisující.

Naplánujte úlohu Espo\Modules\Signi\Jobs\IsContractSigned v Administrace > Úlohy (např. každých 10–15 minut).
Úloha dotazuje Signi pro dokumenty se signiId a isSigned = false. Při stavu completed stáhne podepsané PDF do signedDocument a vyplní signatureDate/isSigned. Při stavech expired, rejected nebo 404 vyčistí příznaky odeslání, aby bylo možné znovu odeslat.

Akce volají GET /signi/send-document/:entityType/:entityId a GET /signi/storno/:signiId. Zajistěte, aby byly dostupné z klienta (používá se standardní session autentizace Espo).