Description
The following example shows how the OKdokument API can be used for multi-round signing. In Multi-round signing several signatories can sign at different places and at different times. Each round of signing represents different signature Request.
How it works
The input to the signing process is a PDF document, which contains signature acrofields. Therefore, there is no need to pre-process the document (search for tags and add acrofields).
As this is a two-round signing process, within the Create signature Request we define the allowedFields:SIGNATURE parameter, which tells about which signature field will be
available for the given signature round. This way we can ensure that the signatory signs in the right place. In this case, make a signature field named _SO1_ available.
After signing and confirming the document (or canceling the signing) by the first signer, OKdokument API redirects the signer to the resulturl with the appropriate state.
Before starting the next round of signing, the Portal can save a signed version of the document.
For the next round of signing it is again necessary to create a new signature Request where it is necessary to:
- Change the status of the document to “tosign”, as the document was in the “signed” state after the first round of signing
- Add a reference to the document ID. Since the signed document is in the temporary storage of the OKdokument API, it is not necessary to re-upload it.
- Define available signature field – Signature on _SO2_
After signing and confirming the document (or canceling the signing) by the second signer, OKdokument API redirects the signer to the resulturl with the appropriate status.
In this way, it is possible to insert multiple signatures into a document remotely.
After signing with the last signer, the Portal downloads the finally signed document with the Download document service and then deletes it with the Delete document service.


