Konfigurace a Správa¶
Tato sekce popisuje, jak nastavit propojení EspoCRM se službou Signi a jak spravovat automatizaci.
Globální nastavení¶
Veškerá konfigurace se provádí v administraci systému v sekci Integrace (nebo v nastavení modulu, v závislosti na verzi).
Připojení k Signi API¶
- Přejděte do Administrace -> Integrace -> Signi.
- Zde musíte vyplnit API Key.
- Klíč získáte ve svém účtu na Signi.com v sekci API nastavení.
- Ujistěte se, že klíč má oprávnění pro
contract_writeacontract_read.
- Zaškrtněte políčko Enabled (Povoleno).
- Uložte nastavení.
Další možnosti¶
- Autosign Proposers: Pokud je povoleno, navrhovatelé (interní uživatelé) budou podepsáni automaticky bez nutnosti ruční interakce (pokud to Signi API dovoluje a je tak nastaven účet).
- Default:
false
- Default:
Automatizace (Cron)¶
Aby systém automaticky stahoval podepsané dokumenty a aktualizoval stavy, musí běžet naplánované úlohy (Cron Jobs).
Modul obsahuje job IsContractSigned, který:
* Hledá dokumenty, které mají vyplněné signiId ale nejsou isSigned.
* Dotazuje se API na jejich stav.
* Stahuje finální PDF.
Kontrola funkčnosti¶
- Přejděte do Administrace -> Naplánované úlohy.
- Najděte úlohu Signi: IsContractSigned (nebo podobný název, třída
Espo\Modules\Signi\Jobs\IsContractSigned). - Ujistěte se, že je ve stavu Active.
- Doporučená frekvence spouštění je každých 15-30 minut (záleží na objemu dokumentů).
- Cron výraz:
*/15 * * * *
- Cron výraz:
Řešení problémů (Admin)¶
Logování¶
Všechny akce modulu jsou logovány do standardního EspoCRM logu (data/logs/espocrm.log). Hledejte klíčové slovo Signi.
Příklady logů:
* Signi: send document internal signers: [...] - Kontrola před odesláním.
* Signi: send document response: {...} - Odpověď ze Signi API.
* Signi: IsContractSigned job: checking contract XYZ - Průběh jobu.
Časté chyby¶
- Error: Signi ApiKey is not set: Zkontrolujte nastavení v Integracích.
- 401 Unauthorized: Neplatný API klíč.
- Document has no internal/external signers: Dokument musí mít vazby na uživatele a kontakty.
- File is empty: Dokument nemá připojený soubor nebo je soubor poškozený.