Dokument s přílohami

K hlavnímu dokumentu můžete připojit přílohy — podepisují se společně v jedné obálce, ale každá je samostatný soubor s vlastními podpisy.

Jak na to

V JSON pokynech přidejte pole attachments. Každá příloha má vlastní seznam lidí a vlastní soubor:

{
    "people": [
        { "is_proposer": true, "email": "vas@email.cz", "contract_role": "approve" },
        { "is_proposer": false, "email": "protistrana@email.cz", "contract_role": "sign",
          "first_name": "Jan", "last_name": "Novák", "person_type": "nature",
          "positions": [ { "x": 50, "y": 80, "page": 0 } ] }
    ],
    "file": "uploaded_file_key",
    "attachments": [
        {
            "people": [
                { "email": "vas@email.cz", "contract_role": "approve" },
                { "email": "protistrana@email.cz", "contract_role": "sign",
                  "positions": [ { "x": 50, "y": 80, "page": 0 } ] }
            ],
            "file": "priloha_1"
        }
    ]
}

Pozor: v people každé přílohy musí být přiřazeni všichni lidé z dokumentu — jinak API vrátí chybu „People must be assigned to all attachments".

Hodnota file u přílohy je název pole, ve kterém soubor pošlete — každý soubor jedno pole:

curl -X POST "https://api.signi.com/api/v1/contract/" \
  -H "x-api-key: VAS_API_KLIC" \
  -F "data=@dokument.json;type=application/json" \
  -F "uploaded_file_key=@hlavni-dokument.pdf" \
  -F "priloha_1=@priloha.pdf"

Co se vrátí:

{
    "contract_id": 1234567,
    "state": "pending",
    "attachments": [
        { "contract_id": 1234568 }
    ],
    "notifications": [
        { "email": "vas@email.cz",
          "links": { "contract": "https://app.signi.com/dashboard/workspace/…/documents/1234567" } },
        { "email": "protistrana@email.cz",
          "links": { "contract": "https://app.signi.com/signing/…/received" } }
    ]
}

Odkazy v notifications se vztahují k celé obálce — podepisující v podpisovém průvodci projde hlavní dokument i přílohy najednou.

Každá příloha má vlastní contract_id — přes něj ji pak stáhnete nebo zjistíte její stav.

Přílohu jde také před některým podepisujícím skrýt — viz Skrytí přílohy podepisujícímu.

Kam dál

• Stažení podepsaného dokumentu
• Více podepisujících