Forms and tablet sessions

Version 1.30.0

Tvarka Formos asks a person to fill in forms on their own phone and sign them once. Tablet sessions collect a drawn signature at the desk. Both are part of Tvarka Sign.

Send your first form

Pick a published form, prefill the known fields and send the request. The values come back when the person has submitted the form.

BASE=https://sign-api.tvarka.pro
# TVARKA_KEY holds your API key.
curl -sS "$BASE/v1/form-templates" \
  -H "Authorization: Bearer $TVARKA_KEY"

Tvarka Formos: forms filled and signed on the person's phone

A form request asks one person to fill one or more published form templates on their own phone and sign them once, as one document, with a qualified signature by Smart-ID or Mobile-ID (v1.16.0). Templates are built in the Tvarka Sign app (Formos) from the business's own PDF, or adopted from the statutory library; every published version carries its legal basis.

GET /v1/form-templates lists the published versions with their fields, each under its semantic identifier (person.given_name). POST /v1/form-requests takes templateVersionIds, the respondent (phone for an SMS link and code, or email), visitAt, prefill by semantic identifier, an optional personalCode (only that person's signature is accepted), externalId, webhookUrl and an Idempotency-Key. The link goes out three days before the visit, at sendAt, or at once with sendNow; one reminder goes out a day before the visit, and the request expires a day after it.

GET /v1/form-requests/{formRequestId} returns the status, the events and, once submitted, the values. PATCH with visitAt, resend or cancel changes it without a second submission. The signed PDF is at /document, an evidence ZIP at /evidence and the attachments at /attachments. Webhooks form_request.opened, submitted, completed, cancelled, expired and failed reach the request's webhookUrl and the workspace's webhook subscriptions; completed carries the values and the document link. MCP: list_form_templates, send_forms, get_form_request. A completed request is charged as one e-signature document, plus the qualified signature and the SMS codes as on any signing.

Tablet sessions

A tablet at your desk is registered in Tvarka Sign under Planšetės and paired with an eight-letter code. A person then reads a document on it and signs by hand (v1.15.0). The drawn signature is sealed into the PDF with its pen data, and the round gets a qualified document timestamp.

GET /v1/kiosks lists the tablets with paired, online and busy. POST /v1/kiosk-sessions takes kioskId, a title and one PDF in document, through the same intake as a signing (content, fileToken, url or markdown). No link is mailed. signer.name may be left empty, so the person types it on the tablet. signer.email receives the signed PDF. identity: sms sends a one-time code to signer.phone and checks it on the tablet first. A busy tablet answers 409.

product: forms with formRequestId sends a Tvarka Formos request to the tablet instead (v1.17.0). The person fills the form on the tablet and signs it there. A staff signature place, such as the doctor's, is signed next on the same tablet.

GET /v1/kiosk-sessions/{kioskSessionId} follows the session from waiting to completed. PATCH with assisted: true lets a staff member fill fields from a computer while the tablet shows them, and status: cancelled withdraws the document. Once completed, /document returns the signed PDF and referenceCode its public check code. One round is charged once, as one e-signature document (EUR 0.13, excluding VAT), however many people sign on the tablet.

Related pages

Questions: info@tvarka.pro