Delegování podpisu (API)

ℹ️ Novinka — k dispozici od začátku listopadu 2026.

Delegování podpisu — přenesení možnosti podepsat na jinou osobu — jde i přes API, ve stejném rozsahu a se stejnými pravidly jako v aplikaci.

Jak na to

Nejdřív zjistěte docs_person_id podepisujícího z detailu dokumentu:

curl -H "x-api-key: VAS_API_KLIC" \
  "https://api.signi.com/api/v1/contract/1234567?with=people"

{ "people": [ { "docs_person_id": 1234503, "email": "protistrana@email.cz", "is_proposer": false } ] }

Pak podpis delegujte na jinou osobu:

curl -X PUT "https://api.signi.com/api/v1/contract/1234567/docsPerson/replace/1234503" \
  -H "x-api-key: VAS_API_KLIC" \
  -H "Content-Type: application/json" \
  -d '{
    "docs_person": {
      "email": "novy.podepisujici@email.cz",
      "first_name": "Petra",
      "last_name": "Svobodová",
      "identity_form": "nature",
      "docs_role": "counterparty",
      "mobile": "+420601000000"
    },
    "signature_footer": "Petra Svobodová, v zastoupení"
  }'

{ "docs_person_id": 1234503 }

Vrací se stejné docs_person_id — místo na dokumentu si drží identifikátor, mění se osoba na něm.

Nová osoba dostane výzvu k podpisu, původní odkaz přestane platit.

Pravidla

• docs_role je povinné — counterparty, resp. proposer podle delegované strany.
• Delegovat jde jen stranu, která ještě nepodepsala.
• Jen pokud to dokument a workspace dovolují — jinak vrátí 400.
• U firemní strany lze poslat i organization_name, organization_position, organization_ico a další firemní údaje.

Kam dál

• Delegování podpisů — jak to funguje v aplikaci
• Delegování podpisů z pohledu protistrany
• Kdo už podepsal — stav jednotlivých podepisujících