Ověření u dokumentu

ℹ️ Nová verze Signi ověření (včetně tohoto API) bude na produkci zveřejněna v průběhu září 2026. Do té doby volání nejsou dostupná a popis se může drobně změnit.

Hlavní scénář Signi ověření: protistrana dokumentu musí projít ověřením totožnosti, jinak se k podpisu vůbec nedostane. Celé flow má tři kroky:

1. Dokument založíte jako rozpracovaný ("state": "draft") — na odeslaný dokument už ověření navázat nejde.
2. Protistraně navážete ověření.
3. Dokument odešlete — protistrana nejdřív projde ověřením, teprve pak podepisuje.

Krok 1: Dokument jako draft

Založte dokument jako obvykle, jen se "state": "draft". V odpovědi dostanete kromě contract_id i docsUuid — tím se dokument adresuje ve všech voláních ověření.

Krok 2: Navázání ověření na protistranu

Protistranu určíte e-mailem, pod kterým je na dokumentu:

curl -X PUT -H "x-api-key: VAS_API_KLIC" -H "Content-Type: application/json" \
  https://api.signi.com/api/v2/docs/UUID_DOKUMENTU/verifications \
  -d '{
    "email": "jan.novak@email.cz",
    "offeredGroups": ["11111111-2222-3333-4444-555555555555"]
  }'

{
    "uuid": "aaaa1111-bbbb-2222-cccc-333344445555",
    "reused": false,
    "verificationUrl": "https://app.signi.com/…",
    "tokenExpiresAt": "2027-02-01T12:00:00+01:00"
}

Klíčové chování — platná ověření se recyklují: když má kontakt už schválené a neexpirované ověření, nic nového nevzniká a vrátí se "reused": true (bez verificationUrl). Nové ověření vynutíte "forceReverify": true.

• offeredGroups — 1–2 UUID skupin ověření.
• webhooks — hlášení změn stavu, viz Webhooky ověření; u recyklovaného ověření se neregistrují.

Co dalšího s vazbou:

# přehled ověření všech protistran dokumentu
curl -H "x-api-key: VAS_API_KLIC" https://api.signi.com/api/v2/docs/UUID_DOKUMENTU/verifications
# zrušení vazby (dokud je dokument rozpracovaný)
curl -X DELETE -H "x-api-key: VAS_API_KLIC" "https://api.signi.com/api/v2/docs/UUID_DOKUMENTU/verifications?email=jan.novak@email.cz"

Pozor: vazby jde přidávat a rušit jen u rozpracovaného dokumentu. Když stejný e-mail patří více protistranám dokumentu, volání skončí chybou 409 — e-mail musí být jednoznačný.

Krok 3: Odeslání dokumentu

curl -X POST -H "x-api-key: VAS_API_KLIC" https://api.signi.com/api/v2/docs/UUID_DOKUMENTU/send

{ "docsUuid": "…", "state": "pending" }

Dokument přejde do stavu pending a obešle protistrany. Protistrana s navázaným ověřením nejdřív projde ověřením — k podpisu ji Signi pustí až po schválení.

Když dokument ještě není připravený (PDF se zpracovává), vrátí /send chybu 409 document_processing — počkejte a zopakujte volání.

Kam dál

• Schválení a zamítnutí ověření — co se děje po dokončení kontrol
• Listy ověření — doklad o průběhu ověření