收件人 ID 由文档签名更改

Question

我正在使用DocuSign API创建信封。在创建信封时，我还传递了签名者列表，并为每个签名者设置了自己唯一的"收件人 ID"(GUID)。但是当创建信封并检查收件人(签名者)列表并发现收件人 ID 一直在更改时。它不是我传递的"收件人ID"。

你能帮我如何在创建信封时设置自己的"收件人ID"吗？

-- 创建信封请求

{ "documents": [{
"documentBase64": "<Base64BytesHere>", 
"documentId": "1", 
"fileExtension": "pdf", 
"name": "lite" 
}], 
"emailSubject": "test recipient 2", 
"recipients": { "signers": [ { "email": "[e-mail]", 
"name": "xxx yyy", 
"recipientId": "1" 
} ]
}, 
"status": "sent" 
}

--网络挂钩响应请参阅收件人 ID --

<DocuSignEnvelopeInformation><EnvelopeStatus>
<RecipientStatuses>
<RecipientStatus>
<Type>Signer</Type>
<Email>[e-mail]</Email>
<UserName>xxx yyy</UserName>
<RoutingOrder>1</RoutingOrder>
<Sent>2017-08-29T02:13:33.853</Sent>
<DeclineReason xsi:nil="true"/>
<Status>Sent</Status>
<RecipientIPAddress/>
<CustomFields/>
<AccountStatus>Active</AccountStatus>
<RecipientId>011eac75-f2fa-4f57-94df-5aedaxxxxxxx</RecipientId>
</RecipientStatus>
</RecipientStatuses>
....
<DocuSignEnvelopeInformation><EnvelopeStatus>

Answer 1

另一种解决方法是使用recipient.customFields.它是一个字符串数组：

someEnvelopeSigner.customFields = [yourUUID, somethingElse]

在 webhook/事件通知中，它将以DocuSignEnvelopeInformation.EnvelopeStatus[0].RecipientStatuses[0].RecipientStatus[i].CustomFields的方式出现，看起来像(以 JSON 化形式)

{
"CustomFields": [{
"CustomField": [
"6e45cb20-3953-11ea-b02d-dedef9da77b9",
"something else!"
]
}],
}

Answer 2

您可以在创建信封时为每个收件人指定唯一的收件人 ID。

下面是一个示例 CreateEnvelope 请求

POST /v2/accounts/{accountId}/envelopes

Json 有效负载。

{
"emailSubject": "Please sign the agreement",
"status": "sent",
"recipients": {
"signers": [
{
"email": "[e-mail]",
"name": "jane doe",
"recipientId": 1,
"routingOrder": 1,
"tabs": {
"signHereTabs": [
{
"documentId": "1", "pageNumber": "1", "xPosition": "80", "yPosition": "80"
}
]
}
},
{
"email": "[e-mail]",
"name": "john smith",
"recipientId": 2,
"routingOrder": 2,
"tabs": {
"signHereTabs": [
{
"documentId": "1", "pageNumber": "1", "xPosition": "80", "yPosition": "180"
}
]
}
}
]
},
"documents": [
{
"documentId": "1",
"name": "Contract",
"fileExtension": "txt",
"documentBase64": "RG9jIFRXTyBUV08gVFdP"
}
]
}

---

使用 listEnvelopeRecipients api 检索信封中的收件人列表。

{
"signers": [
{
"creationReason": "sender",
"isBulkRecipient": "false",
"name": "jane doe",
"email": "[e-mail]",
"recipientId": "1",
"recipientIdGuid": "98d60cc3-5f67-46e4-9fc0-ca6bb519f1c9",
"requireIdLookup": "false",
"userId": "585b8733-b1a9-4329-87e7-4f20bcde00c2",
"routingOrder": "1",
"status": "sent"
},
{
"creationReason": "sender",
"isBulkRecipient": "false",
"name": "john smith",
"email": "[e-mail]",
"recipientId": "2",
"recipientIdGuid": "726bd54d-89ed-41ba-a751-fdb129894b8b",
"requireIdLookup": "false",
"userId": "45abe022-ae12-4816-8c42-fd66d207807a",
"routingOrder": "2",
"status": "created"
}
],
"agents": [],
"editors": [],
"intermediaries": [],
"carbonCopies": [],
"certifiedDeliveries": [],
"inPersonSigners": [],
"recipientCount": "2",
"currentRoutingOrder": "1"
}