Hodnoty vyplněné ve vzoru (API)

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

Když má dokument ze vzoru pole, která doplňuje protistrana, dostanete vyplněné hodnoty zpět přes API — nemusíte je vytahovat z podepsaného PDF.

Jak na to

Dokument s poli protistrany je po odeslání ve stavu waiting_for_answers — protistrana nejdřív doplní pole, pak podepisuje. Hodnoty čtete kdykoli:

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

Odpověď (ověřený příklad — vzor s jedním polem protistrany):

{
    "fields": [
        {
            "id": "122",
            "name": "Připomínky",
            "value": "Testovací připomínka vyplněná protistranou",
            "filled_by": "counterparty",
            "filled_by_email": "protistrana@email.cz",
            "filled_by_docs_person_id": 1234503,
            "assigned_to": { "role": "counterparty", "party_order": null }
        }
    ]
}

Klíčová pole:

• value — vyplněná hodnota; null, dokud pole nikdo nevyplnil.
• filled_by / filled_by_email / filled_by_docs_person_id — kdo hodnotu doplnil (proposer / counterparty).
• assigned_to — komu je pole určené (role, u vícestranných vzorů party_order).

Hodnoty jsou dostupné hned po doplnění — nemusíte čekat na podpis ani dokončení dokumentu. O dokončení doplňování se dozvíte přechodem dokumentu ze stavu waiting_for_answers (viz Životní cyklus dokumentu), o podpisech webhookem.

Stejný endpoint vrací i pole formulářového dokumentu z PDF se značkami.

Kam dál

• Dokument ze vzoru — jak dokument ze vzoru založit
• Doplňování údajů do vzoru protistranou — jak to vidí protistrana
• Formulářový dokument z PDF se značkami