17. DigiSign — configdigisign.asp a step75 (technicky)

17. DigiSign — configdigisign.asp a step75 (technicky)

www.iskasa.eu · návod k modulu Akce

Ctrl+P · doporučeno A4 na výšku

17. DigiSign — configdigisign a step75 (technicky)

Uživatelský průvodce: 7e DigiSign konfigurace a step75. Souvisí s 12 Smlouvy step60, 13 Ostatní kroky (step05, step70).

Integrace s DigiSign REST API — konfigurace v digisign/, práce u akce na step75. Referenční demo: configdigisign, step75?aa=5702.

17.1 Soubory modulu (digisign/)

SouborÚloha
configdigisignObal stránky konfigurace — oprávnění SESSION("admin") = "zz"
ConfigFormDigiSignFormulář + ukládání do configdigisign
DigiSignConfigLibNačtení/uložení config, DS_IsEnabled(), webhook URL
DigiSignApiLibAuth token, volání REST API, webhook registrace
DigiSignEnvelopeLibObálky, odeslání, sync stavu, auditní stopa, DS_Step75AdminOk()
DigiSignWebhookHTTP listener pro POST z DigiSign (?key=)
DigiSignWebhookLibZpracování eventů, archiv logu, změna stavu v digisign_podpis
DigiSignWebhookNastaveniUI registrace webhook eventů v configdigisign
DigiSignRegenWebhookAjaxAJAX generování nového webhook klíče
DigiSignWebhookSyncAjax, DigiSignWebhookTestAjaxSync a test webhooků z admin UI

17.2 step75 — obal a includes

SouborÚloha
step75Obal (AplikaceNastaveni = 510, AkceMenu = 75), include step75PodpisSeznam
step75PodpisSeznamTabulky Smlouvy / Dokumenty / Přílohy, legenda, AJAX sync
step75DigiSignNavodNávod při vypnuté integraci (NOT DS_IsEnabled())
step75SmlouvaPdfGenerování PDF smlouvy (wkhtmltopdf) → dovakcedokumenty
step75PodpisSyncAjaxAJAX sync jednoho řádku z API
step75PodpisOdeslatFormulář podepisujících + DS_EnvelopeOdeslat()

17.3 Oprávnění

Stránka / akcePodmínka
configdigisignSESSION("admin") = "zz"
step75 — vstupadmin ∈ {t, b, r, k} nebo admin2 ∈ {t, b, k}
Tlačítka odeslání / syncDS_Step75AdminOk() → admin = t nebo b
step75PodpisOdeslatStejně DS_Step75AdminOk()

17.4 Databáze

TabulkaÚčel
configdigisignJeden řádek na nájemce: API klíče, prostředí, webhook_klic, aktivni, embed, return_url…
digisign_podpisVazba obálky na akci: kodakce, zdroj_typ (dokument/priloha), zdroj_id, envelope_id, stav, podepisujici (JSON), audit soubor
digisign_webhook_logArchiv příchozích webhook eventů u akce
dovakcedokumentyZdroj typu dokument (step70 + PDF ze smlouvy, popis digisign_smlouva:{kod})
dovakceprilohyZdroj typu priloha (step05 sekce 0, případně dokumenty se sekcí > 0)
dovakcesmlouvyHTML smlouvy — na step75 jen generování PDF, ne přímé odeslání

17.5 Stavy podpisu (digisign_podpis.stav)

Hodnoty: nova, odeslano, castecne, podepsano, odmitnuto, expirovano, zruseno, chyba. Test záložky v menu: !akce/AkceDigisignPodpisTest — zelená pokud existuje záznam s envelope_id a stav <> 'nova'.

17.6 Tok odeslání dokumentu

sequenceDiagram
    participant U as Uživatel t/b
    participant S75 as step75PodpisSeznam
    participant O as step75PodpisOdeslat
    participant EL as DigiSignEnvelopeLib
    participant API as DigiSign API
    participant WH as DigiSignWebhook
    participant DB as digisign_podpis
    U->>S75: Odeslat k podpisu
    S75->>O: aa, zt, zi
    O->>EL: DS_EnvelopeOdeslat
    EL->>API: POST obálka + dokument
    API-->>EL: envelope_id
    EL->>DB: INSERT/UPDATE stav=odeslano
    Note over WH,DB: Později webhook nebo DS_PodpisAutoSyncAkceZApi
    WH->>DB: stav podepsano + audit PDF

Parametry URL odeslání: aa = kód akce, zt = dokument | priloha, zi = id z příslušné tabulky. POST action=send + pole podepisujících (rec_obch, rec_klient, volitelně další z users).

17.7 Webhook

  • Listener: DigiSignWebhook?key={webhook_klic} — URL sestaví DS_WebhookListenerUrl() z Return URL nebo aktuálního serveru.
  • Ověření registrace: DS_WebhookListForUrl, DS_WebhookMandatedCheck v admin UI.
  • Povinné eventy mění stav obálky; informační se jen logují do digisign_webhook_log.
  • Sync z API (DS_PodpisAutoSyncAkceZApi, ikona refresh, F5 step75) nečte webhook log — stáhne stav přímo z API a zapíše event dovisApiSync.

17.8 Formáty souborů

DS_PodpisSouborFormatChyba() — kategorie pdf, text, image, other. Obrázky: DS_SouborPrevedNaPdf() před uploadem do obálky. Kontrola disku: DS_SouborDiskKontrola(folder, filename).

17.9 SQL skripty (pořadí nasazení)

  1. digisign/configdigisign
  2. digisign/digisign_tables
  3. digisign/configdigisign_menu_path — cesta v menu administrátora (volitelně)
  4. !!MySQL/digisign_podpis, digisign_webhook_log — pokud nejsou v digisign_tables

Související kapitoly

16. Přehled klíčových stránek (zkráceně)