DocuSign: template sign position issue when establishing routing order

Question

My question is related to a specific REST operation for sending an Envelope using a Template where there are at least 2 roles defined as Signers (Signer1, Signer2) The template is defined as follows: there is a document uploaded, 2 roles as signers (with no routing order, no email, no name) and the position of the Sign for each signer. I have tried from the API explorer, and this is the JSON request:

{
"emailSubject": "template to sign",
"status": "sent",
"templateId": "xxxxx",
"templateRoles": [
    {
        "email": "email1@gmail.com",
        "name": "signer1",
        "roleName": "Signer1",
        "routingOrder": "1"
    },
    {
        "email": "email2@gmail.com",
        "name": "signer2",
        "roleName": "Signer2",
        "routingOrder": "2"
    }
]}

All works fine except for the possition of the sign for Signer2. It should only appear the square of the sign in the document. However, It behaves like this role does not exist, and all objects for signing are available to this user. If this same Envelope is sent without the routing order for neither of both signers, the position of the sign works as defined in the template for both signers, i.e. it works as expected.

I don't know if it is a bug, or something I am doing wrong or didn't understand well, but the tests have been executed using the Docusign API explorer.

Thanks in advance.

Answer 1

Updated answer You can update the routing order but you must:

1. Use the composite templates API feature to do so.
2. Tell DocuSign that you're changing the routing order from the template's original routing by setting a query parameter.

Full details in this answer.

Original answer

First, try using the template for an envelope from the DocuSign webtool.

My guess from your question is that the template is not set up the way you want it.

When you use the tagger window of the web tool for your template, check that you're creating the signing tabs for the two different roles. There's a dropdown chooser for each role in the tagger window. See the screenshot. It sets the owner for the document tabs (fields) shown on the screen

Once the envelope (driven by the template) is working well from the DocuSign web tool, switch to using the API.