View Categories

5.2 Multi-round signing with simple PDF

Even when using simple PDF document, it is possible to register several signature requests and create multi-round signing. The registration of the first signature Request is the same as it was in one-round signing in the example before.

{
    "signatureRequestId": "1d58a59e-e8f7-4d07-bb99-d3fa39cb58a8",
    "expirationTime": "1702288000000",
    "sendInfoURL": "http://api.okdokument/info",
    "resulturl": "https://okdokument.com/",
    "filedata": {
        "content": "xyz_JVBERi0xLjc==",
        "state": "tosign"
    }
}

For the second round of signing the Portal has to:

  • Register new signatureRequestId – if generated by OKdokument API it will be new random value, if pre-filled by Portal new ID must be used
  • Reference to document ID – signed document from the first round of signing is stored in internal OKdokument API storage. Use document ID as a reference of the document (filedata with document content is not needed)
  • Change state – after signing the document in the first round, the document changes the state to “signed”. It is needed to change the document state to “tosign” in order to sign the document in the next round of signing
{
    "signatureRequestId": "1d58a59e-e8f7-4d07-bb99-d3fa39cb58a8",
    "expirationTime": "1702288000000",
    "sendInfoURL": "http://api.okdokument/info",
    "resulturl": "https://okdokument.com/",
    "id": "y7Ki_u1mrUwijfb-o_S1JiphSsoXya8iypH380F",
    "changeState": "tosign"
}