RecipientId通过docusign更改

我使用DocuSign API创建信封。在创建信封时，我还通过了签名者列表，并为每个签名者设置了自己独特的“RecipientId”（GUID）。但是，当创建信封并检查收件人列表（签名人）时，发现收件人ID始终发生更改。这不是我收到的“RecipientId”。RecipientId通过docusign更改

你能帮助我怎样在创建信封时设置自己的“RecipientId”？

- 创建信封要求

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

- 网页钩响应看到收件人标识 -

<DocuSignEnvelopeInformation><EnvelopeStatus> 
    <RecipientStatuses> 
     <RecipientStatus> 
      <Type>Signer</Type> 
      <Email>[email protected]</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>

来源

2017-08-29 Jigar

请您分享您的请求。 –

@CodingDawg { “文档”：[{ “documentBase64”： “”， “documentId”： “1”， “fileExtension”： “PDF”， “名称”： “精简版” } ]， “Emailsubject的”： “测试收件人2”， “收件人”：{ “签名”：[{ “电子邮件”： “[email protected]”， “名称”：“ xxx yyy“， ”recipientId“：”1“ } ] }， ”status“：”sent“ } – Jigar

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

下面是一个示例CreateEnvelope请求

POST /v2/accounts/{accountId}/envelopes

的Json净荷。

{ 
"emailSubject": "Please sign the agreement", 
"status": "sent", 
"recipients": { 
    "signers": [ 
     { 
      "email": "[email protected]", 
      "name": "jane doe", 
      "recipientId": 1, 
      "routingOrder": 1, 
      "tabs": { 
       "signHereTabs": [ 
        { 
         "documentId": "1", "pageNumber": "1", "xPosition": "80", "yPosition": "80" 
        } 

       ] 
      } 
     }, 
     { 
      "email": "[email protected]", 
      "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": "[email protected]", 
     "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": "[email protected]", 
     "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" 
}

来源

2017-08-29 14:59:24

这是我也在做..但收件人ID从docusign更改。当我检索收件人列表时，收件人ID将更改为某些GUID。 – Jigar

看起来连接响应不包含在信封创建期间指定的收件人ID。 DocuSign在创建信封时还会创建一个内部收件人ID。您可以使用[listRecipients]（https://docs.docusign.com/esign/restapi/Envelopes/EnvelopeRecipients/list/）api检索收件人ID之间的地图。我已经更新了我的答案。 –

是的，这是正确的..但我需要它时，收件人状态发生变化。但现在我没事了，首先我会在创建信封时更新收件人列表。它包含RecipientGuidId，然后当状态发生变化，并且在webhook请求中，我将使用RecipientId作为RecipientGuidId。谢谢您的帮助。 – Jigar

RecipientId通过docusign更改

回答

相关问题