DocuSign: I need the first recipient of a document

问题:

I have a template with a known first signer, then a second signer who is defined by templateRoles. The first signer needs to know the name of the second signer. I have not found a way to do this via the DocuSign console, since prefilled tabs are specific to the current receiver, or to someone who has already signed or reviewed the document. I need to prefill a tab when I create the envelope. How can I assign a prefilled tab for a known recipient, since templateRoles requires a roleName and I have a recipientId?

Revised: I am able to explore an existing template via the API. In order to get a list of tabs for recipient, I use a recipientId in a request to envelopes/{envelope}/recipients/{recipientId}/tabs. I can then associate a tab with the recipientId. But in the process of prefilling a tab when creating an envelope from a template, the recipientId is rejected and a roleName is required, which makes this much more complicated.

回答1:

[I'm not exactly clear on your scenario, but I'll take a stab at answering anyway. Please clarify the question (via Comments) if I've missed the mark.]

How you inform one recipient of other recipient(s) name(s) will depend on whether or not you want that information (i.e., the recipient names) to actually appear somewhere in the documents themselves.

If you do NOT want the name(s) of subsequent recipient(s) to appear anywhere within the documents themselves, but still need a way to inform the first signer of subsequent recipient(s) name(s), then you can achieve this by specifying a note for the first recipient. Contents of the "note" will appear only in the email that the recipient receives and in a popup dialog when the recipient first enters the Envelope -- it will not appear anywhere in the Envelope's document(s). For example, here's what a note looks like when the recipient accesses the Envelope:

If the Envelope is being created/sent via the DocuSign console, then the sender can manually add a NOTE for the first recipient that indicates the name of the subsequent signer(s), and/or whatever other information the first recipient needs to know.

If you're creating/sending the envelope via the API, then you can specify a NOTE for the first recipient simply by populating the note property for the first recipient (in the Create Envelope request):

POST https://{{env}}.docusign.net/restapi/{{version}}/accounts/{{acctId}}/envelopes
{
  "emailSubject": "Please sign",
  "emailBlurb": "Please sign...thanks!",
  "status": "sent",
    "compositeTemplates": [
    {
        "serverTemplates": [
        {
            "sequence" : 1,
            "templateId": "9C848429-3C12-4C5E-BDD1-681C4FE25A2A"
        }],
        "inlineTemplates": [
        {
            "sequence" : 2,
            "recipients": {
                "signers" : [{
                    "email": "[e-mail]",
                    "name": "John Doe",
                    "recipientId": "1",
                    "roleName": "Signer 1",
                    "note": "Hi John -- the second signer's name is: Mary Adams.",
                    "routingOrder": "1"
                  },
                  {
                    "email": "[e-mail]",
                    "name": "Mary Adams",
                    "recipientId": "2",
                    "roleName": "Signer 2",
                    "routingOrder": "2"
                  }
                ]
            }
        }]
    }]
}

Alternatively -- if you DO want the second recipient's name to actually appear in the document(s) when the first recipient views the Envelope documents, then you should be able to simply create the Template (in the DocuSign console) with a FullName tab assigned-to / owned-by the second recipient, like this:

Then, when the first recipient views the envelope, he should see the second recipient's name where you placed the Fullname tab in the Template:

Note: If you use the "Fullname" tab approach that I've described, you might also need to make sure that this account setting (in Preferences >> Features) is enabled:

回答2:

It appears I need to use the roleName in the send envelope request, even though I get the tab information using the recipientId. This is cumbersome, since I have to track two specific and unique values that refer to the same record while integrating the tab information into my application.

However, the behavior of setting tabs using the roleName appears to be extremely buggy. I can successfully set the tabs on one template, but it does not appear to work for other templates. Is there a known bug with this? I will have to abandon this approach and trying something different, so the original question still stands.