RecipientIdがdocusignによって変更される

Question

DocuSign APIを使用して封筒を作成しています。エンベロープを作成している間、私は署名者のリストを渡しているだけでなく、署名者ごとに独自の "RecipientId"（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" 
} 

を作成エンベロープを作成中

<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

あなたは受信者ごとにユニークなrecipientIdを指定することができます。ここで

サンプルCreateEnvelope要求

POST /v2/accounts/{accountId}/envelopes 

JSONペイロードです。

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

       ] 
      } 
     }, 
     { 
      "email": "johnsmith@acme.com", 
      "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": "janedoe@acme.com", 
     "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": "johnsmith@acme.com", 
     "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" 
}