docusignapi - RecipientId 被docusign更改

Question

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

您能帮我在创建信封时如何设置自己的“RecipientId”吗？

-- 创建信封请求

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

-- Web hook 响应查看收件人 ID --

<DocuSignEnvelopeInformation><EnvelopeStatus>
    <RecipientStatuses>
        <RecipientStatus>
            <Type>Signer</Type>
            <Email>xxx.yyy@abc.com</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!"
    ]
  }],
}