Kam umístit podpisy v dokumentu

Kde se v dokumentu objeví podpisy, určujete u každého podepisujícího polem positions. Jsou tři možnosti.

A. Souřadnice

Zadáte přesné místo v procentech stránky:

"positions": [
    { "x": 50, "y": 80, "page": 0, "relativeWidth": 30 }
]

• x, y — procenta velikosti stránky (0–100): 0, 0 je levý horní roh, 100, 100 pravý dolní. Souřadnice určuje levý horní roh obdélníku s podpisem. x: 50, y: 80 = podpis začíná vodorovně uprostřed, u spodního okraje.
• page — číslo stránky, první stránka je 0. Záporná čísla počítají od konce: -1 znamená „na konec dokumentu" (poslední strana).
• relativeWidth — šířka podpisu v procentech šířky stránky (nepovinné, výchozí 30).

Více podpisů jednoho člověka

Jeden člověk může mít v dokumentu podpisů víc — stačí přidat další položky do positions. Například parafa na první straně a podpis na konci:

"positions": [
    { "x": 85, "y": 92, "page": 0 },
    { "x": 50, "y": 80, "page": 4 }
]

Stejně to funguje se zástupnými poli — každé místo jedna položka:

"positions": [
    { "anchor": "parafa-strana-1" },
    { "anchor": "podpis-zaver" }
]

B. Zástupné pole v dokumentu (anchor)

Do textu dokumentu vložíte značku (kotvu) a místo souřadnic uvedete v anchor přesně stejný text. Podpis se umístí na místo značky. Hodí se, když dokumenty generujete a místo podpisu se posouvá s délkou textu.

Vyzkoušejte na ukázkovém souboru kotvy-ukazka.pdf — má v textu značky #signi_user_signature# (pro navrhovatele) a #signi_signature# (pro protistranu):

{
    "people": [
        { "is_proposer": true, "email": "vas@email.cz", "contract_role": "sign",
          "positions": [ { "anchor": "#signi_user_signature#" } ] },
        { "is_proposer": false, "email": "protistrana@email.cz", "contract_role": "sign",
          "first_name": "Jan", "last_name": "Novák", "person_type": "nature",
          "positions": [ { "anchor": "#signi_signature#" } ] }
    ],
    "file": "uploaded_file_key"
}

• Hodnota anchor musí odpovídat textu v dokumentu doslovně — když se značka nenajde, zpracování dokumentu selže.
• Text značky v dokumentu zůstává — podpis ho jen překryje. Napište značku bílým písmem, ať v dokumentu není vidět.
• Funguje jen pro podepisující (role sign).

C. Bez umístění — podpisy na konec

Když positions vynecháte a v settings nastavíte "missing_positions": "append_to_the_end", podpisy se automaticky umístí na konec dokumentu. Nedoporučujeme používat, pokud je možné se tomu vyhnout — podpisový arch mění dokument, a tudíž rozbije úvodní pečeť na něm. Více v článku Zabezpečení dokumentu. (Bez tohoto nastavení chybějící pozice vrátí chybu.)

Role approve (schvalovatel) žádné umístění nepotřebuje — v dokumentu se nic nezobrazuje.

Kam dál

• Více podepisujících
• Quickstart — první dokument k podpisu přes API