Docusign收件人狀態

Question

是否可以通過API獲取DocuSign文檔的每個收件人的狀態？ 什么是xml / java來獲取收件人的狀態？ 我發送的信封上寫着不同人的電子郵件，但是當我使用這里描述的過程http://iodocs.docusign.com/APIWalkthrough/getEnvelopeRecipientStatus時 ，似乎沒有地方指定哪個收件人檢查狀態。

這將是我正在尋找的一個例子。

憑證xxxxxxxxx收件人1已發送收件人2簽名mm / dd / yyyy收件人3下降mm / dd / yyy

Answer 1

對DocuSign REST API“獲取信封收件人狀態”呼叫（GET / accounts / {accountId} /信封/ {envelopeId} /收件人）的響應將包含信封的所有收件人的收件人狀態信息。 DocuSign REST API指南（ http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf ）的第145-146頁顯示了一個示例請求和響應（采用JSON格式）。

這是一個包含4個收件人的信封的樣本響應正文：1）Jane簽名/完成了信封（路由順序＃1）。 2）John簽署/完成了信封（路由順序＃2）。 3）Jimmy收到了信封的副本，作為Carbon Copy收件人（路由訂單＃3）。 4）安倍拒絕了信封（路由順序＃4）。

{
"signers": [
    {
        "signInEachLocation": "false",
        "name": "Abe Miller",
        "email": "emailAbe@outlook.com",
        "recipientId": "ea3362b6-cf00-4797-8cfb-56ca09b988a8",
        "requireIdLookup": "false",
        "userId": "5b97e1be-3cea-49fb-a1c3-b77890b0b154",
        "routingOrder": "4",
        "status": "declined",
        "declinedDateTime": "2013-09-23T19:28:40.7670000Z",
        "declinedReason": "I don't want to sign."
    },
    {
        "signInEachLocation": "false",
        "name": "Jane Smith",
        "email": "emailJane@outlook.com",
        "recipientId": "54fb0d38-7c60-4d37-976a-6c72ea2ce32d",
        "requireIdLookup": "false",
        "userId": "17f820b1-f2a0-455a-88c2-e356a9c6914b",
        "routingOrder": "1",
        "status": "completed",
        "signedDateTime": "2013-09-23T19:27:54.2330000Z",
        "deliveredDateTime": "2013-09-23T19:27:49.9900000Z"
    },
    {
        "signInEachLocation": "false",
        "name": "John Doe",
        "email": "emailJohn@outlook.com",
        "recipientId": "78ef67bf-8795-4026-a57e-63ec960eb5a4",
        "requireIdLookup": "false",
        "userId": "03c8a856-c0ae-41bf-943d-ac6e92db66a8",
        "routingOrder": "2",
        "status": "completed",
        "signedDateTime": "2013-09-23T19:28:11.6900000Z",
        "deliveredDateTime": "2013-09-23T19:28:06.4170000Z"
    }
],
"agents": [],
"editors": [],
"intermediaries": [],
"carbonCopies": [
    {
        "name": "Jimmy Adams",
        "email": "emailJimmy@outlook.com",
        "recipientId": "afc51052-85e9-4575-8c06-b0f87c1a5d8b",
        "requireIdLookup": "false",
        "userId": "7a64f726-8985-490b-9e94-04e54292f53c",
        "routingOrder": "3",
        "status": "completed",
        "deliveredDateTime": "2013-09-23T19:28:21.3600000Z"
    }
],
"certifiedDeliveries": [],
"inPersonSigners": [],
"recipientCount": "4"
}

通過遍歷響應中每種類型的收件人（簽名者，代理人，編輯者，中介者，carbonCopies，certifiedDeliveries，inPersonSigners），您可以訪問每個收件人的狀態信息。

（注意：如果您使用的是DocuSign REST API，我建議您考慮使用JSON而不是XML。雖然DocuSign REST API在技術上支持JSON和XML，但可以使用XML和REST API的文檔非常有限的 - 你可以通過使用JSON而不是XML來節省時間和挫折，因為DocuSign生成的大多數代碼示例和文檔都是JSON。）