(Express) Order of signing

Questions and Answers
1

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?

2

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,
  }],
}

This post has been migrated from the previous community