只有在查看了所有收件人之后，才显示Docusign API传递状态

Question

朋友，

我正在使用Docusign API，它运行良好。目前，如果我向多个客户发送信封，只有在所有收件人都查看了文档后，Docusign才会将状态显示为已送达。

即使第一个收件人打开了文档，我也希望获得已送达状态。

使用Docusign API是否可行？

提前谢谢。

Answer 1

在DocuSign中，信封可以有状态，也可以有收件人。例如，假设你有一个信封，里面有两个顺序的收件人，第一个收件人已经签名，信封已经发送给第二个收件人。在这种情况下，整个信封状态将是Processing，第一个收件人状态将是Completed，第二个收件人状态为Delivered（如果他们已经查看了信封，或者如果他们还没有查看，则为Sent）

请参阅本页开发人员中心的"收件人状态"部分

因此，您不需要获取信封状态，而需要调用API来获取收件人状态。该电话的详细信息是：

GET /accounts/{accountId}/envelopes/{envelopeId}/recipients
Optional query strings: include_tabs={true or false}, include_extended={true or false}

样品响应：

{
  "agents":[]
  "carbonCopies":[],
  "certifiedDeliveries":[],
  "currentRoutingOrder":"String content",
  "editors":[],
  "inPersonSigners":[],
  "intermediaries":[],
  "recipientCount":"String content",
  "signers":[{
    "deliveredDateTime": "String content",
    "recipientAuthenticationStatus":{
      "(authentication status result)":
        "eventTimestamp":"String content"
        "status":"String content"
      }
    },
    "recipientId": "String content",
    "requireIdLookup": "String content",
    "roleName":"String content",
    "routingOrder": "String content",
    "signedDateTime": "String content",
    "status": "String content",
    "email": "String content",
    "name": "String content"  }]
  }]
}

有关更多信息，请参阅DocuSign API指南第191页