(Express) Order of signing

Question:

Using Express I try to set the order the document should be signed. I don’t get this to work either with “required”: true or with “order”. Do I need to set something more or do I miss something from the docs? Also not sure if notification email should be delayed for user2 until user1 have signed, now it’s not.

Expected behaviour: user1@example.com should need to sign first before user2@example.com can sign.

My behaviour: user2@example.com can sign the document even user1@example.com have not signed the document.

My requests.

Using “required”

{
“title”: “As simple as that 5”,
“description”: “This is an important document 5”,
“externalId”: “ae7b9ca7-3839-4e0d-a070-9f14bffbbf55”,
“dataToSign”: {
“base64Content”: “VGhpcyB0ZXh0IGNhbiBzYWZlbHkgYmUgc2lnbmVk”,
“fileName”: “sample.txt”
}, “contactDetails”: {
“email”: “test@test.com
},
“signers”: [ {
“notifications”: {
“setup”: {
“request”: “sendEmail”
}
},
“signerInfo”: {
email":"user1@example.com”,
“required”: true,
“socialSecurityNumber”: “199603226137”
},
“externalSignerId”: “uoiahsd321982983jhrmnec2wsadm32”,
“redirectSettings”: {
“redirectMode”: “redirect”,
“success”: “https://developer.signicat.io/landing-pages/signing-success.html”,
“cancel”: “https://developer.signicat.io/landing-pages/something-wrong.html”,
“error”: “https://developer.signicat.io/landing-pages/something-wrong.html
},
“signatureType”: {
“mechanism”: “pkisignature”,
“signatureMethods”: [“se_bankid”]
}
},
{
“notifications”: {
“setup”: {
“request”: “sendEmail”
}
},
“signerInfo”: {
email":"user2@example.com”,
“socialSecurityNumber”: “199603226136”

  },
  "externalSignerId": "uoiahsd321982983jhrmnec2wsadm322",
  "redirectSettings": {
  	"redirectMode": "redirect",
	"success": "https://developer.signicat.io/landing-pages/signing-success.html",
	"cancel": "https://developer.signicat.io/landing-pages/something-wrong.html",
	"error": "https://developer.signicat.io/landing-pages/something-wrong.html"
  },
  "signatureType": {
    "mechanism": "pkisignature",
    "signatureMethods": ["se_bankid"]
  }
}

],
“advanced”: {
“requiredSignatures”: 2
}
}

With “order”

{
“title”: “As simple as that 5”,
“description”: “This is an important document 5”,
“externalId”: “ae7b9ca7-3839-4e0d-a070-9f14bffbbf55”,
“dataToSign”: {
“base64Content”: “VGhpcyB0ZXh0IGNhbiBzYWZlbHkgYmUgc2lnbmVk”,
“fileName”: “sample.txt”
}, “contactDetails”: {
“email”: “test@test.com
},
“signers”: [ {
“notifications”: {
“setup”: {
“request”: “sendEmail”
}
},
“signerInfo”: {
email":"user1@example.com”,
“order”: 1,
“socialSecurityNumber”: “199603226137”
},
“externalSignerId”: “uoiahsd321982983jhrmnec2wsadm32”,
“redirectSettings”: {
“redirectMode”: “redirect”,
“success”: “https://developer.signicat.io/landing-pages/signing-success.html”,
“cancel”: “https://developer.signicat.io/landing-pages/something-wrong.html”,
“error”: “https://developer.signicat.io/landing-pages/something-wrong.html
},
“signatureType”: {
“mechanism”: “pkisignature”,
“signatureMethods”: [“se_bankid”]
}
},
{
“notifications”: {
“setup”: {
“request”: “sendEmail”
}
},
“signerInfo”: {
email":"user2@example.com”,
“socialSecurityNumber”: “199603226136”
“order”: 2
},
“externalSignerId”: “uoiahsd321982983jhrmnec2wsadm322”,
“redirectSettings”: {
“redirectMode”: “redirect”,
“success”: “https://developer.signicat.io/landing-pages/signing-success.html”,
“cancel”: “https://developer.signicat.io/landing-pages/something-wrong.html”,
“error”: “https://developer.signicat.io/landing-pages/something-wrong.html
},
“signatureType”: {
“mechanism”: “pkisignature”,
“signatureMethods”: [“se_bankid”]
}
}
],
“advanced”: {
“requiredSignatures”: 2
}
}

It seams the rules are respected if the generic link to the document is used. Not for the links sent with email notification. Is this expected behaviour? Or do I do something wrong?

Hi! I can see in your example that you have set required/order under signerInfo like this, which will not work.

{
  "signers": [{

“signerInfo”: {
“order”: 2
}
}]
}

It has to be specified on the root of the signer like below, more examples can be found here

Regarding your question about notifications, the signer/recipient will not receive a notification before it is their turn to sign

{
  "signers": [{
    "order": 2,
  }],
}