Životní cyklus dokumentu

Každý dokument v Signi prochází stavy. Podle stavu poznáte, co se s dokumentem děje a co s ním v tu chvíli jde dělat.

Přehled stavů

Jak stavy navazují

1. Dokument založíte přes API — buď rovnou k podpisu (pending), nebo jako rozpracovaný (draft), když v JSON pokynech nastavíte "state": "draft".
2. U dokumentů s vyplňovacími poli může podpisu předcházet doplnění údajů protistranou (waiting_for_answers).
3. Ve stavu pending podepisují jednotlivé strany.
4. Končí se jedním ze tří stavů: completed, rejected, nebo expired.

Jak stav zjistit

Dotazem na detail dokumentu:

curl -H "x-api-key: VAS_API_KLIC" https://api.signi.com/api/v1/contract/ID_DOKUMENTU

V odpovědi je stav v poli state:

{ "contract_id": "1234567", "contract_name": "…", "state": "pending", "creator": { "email": "…" } }

Pohodlnější je nechat si změny hlásit automaticky webhookem — Signi zavolá vaši aplikaci při přechodu dokumentu do stavu pending, completed, rejected nebo expired. Podrobně v článku Webhooky — automatická hlášení změn stavu dokumentu.

Na co si dát pozor

• PDF s podpisy jde stáhnout až ve stavu completed — dřív dostanete dokument bez podpisů.
• Mazání dokumentů má podle stavu omezení — podrobnosti v článku Zrušení a smazání dokumentu.

Kam dál

• Webhooky — automatická hlášení změn stavu dokumentu
• Kdo už podepsal — stav jednotlivých podepisujících
• Zrušení a smazání dokumentu
• Quickstart — první dokument k podpisu přes API