如何处理DocuSign API的打印签署事件通知及签署状态验证

针对你遇到的电子签署/打印签署状态识别，以及多签署者状态区分的问题，结合DocuSign API v2的特性，我整理了以下解决方案：

1. 电子签署的状态获取（最直接方式） #

当用户使用DocuSign原生电子签署时，通知响应里的TabStatuses是最精准的判断依据。每个TabStatus节点会明确标注签署标签的状态（比如Signed），还附带标签类型、位置、所属文档等细节，能直接确认签署动作已完成。

示例片段：

<TabStatuses>
  <TabStatus>
    <TabType> SignHere </TabType>
    <Status> Signed </Status>
    <XPosition> 699 </XPosition>
    <YPosition> 754 </YPosition>
    <TabLabel> Signature 1_SignHere_gibberish_id </TabLabel>
    <TabName />
    <DocumentID> 2460 </DocumentID>
    <PageNumber> 1 </PageNumber>
  </TabStatus>
</TabStatuses>

2. 打印签署的状态识别（最优方案） #

对于用户选择打印签署的场景，响应里不会返回TabStatuses。虽然可以通过DocumentStatuses中名称为Signed-on-Paper_<reference_id>的节点来推断，但这并不是最稳定的方式。

更可靠的判断逻辑是查看RecipientStatus节点：

• 检查Status字段是否为Completed
• 确认<Signed>时间戳存在且有效

只要满足这两个条件，就说明该签署者已完成打印签署流程。示例中的关键片段：

<RecipientStatus>
  <Type> Signer </Type>
  <Email> sdasari@plxs.com.au </Email>
  <UserName> Shyam Dasari </UserName>
  <RoutingOrder> 1 </RoutingOrder>
  <Sent> 2019-10-15T16:23:38.06 </Sent>
  <Delivered> 2019-10-15T16:23:50.15 </Delivered>
  <Signed> 2019-10-15T16:24:35.167 </Signed>
  <Status> Completed </Status>
  <!-- 其他字段省略 -->
</RecipientStatus>

3. 多签署者场景的状态区分 #

在多签署者的信封中，每个签署者的状态都被单独封装在RecipientStatuses下的RecipientStatus节点里。你可以通过以下字段来精准识别每个签署者的状态：

• Email/UserName：签署者的联系方式和姓名，用于直观匹配
• RoutingOrder：签署顺序，对应信封设置中的签署步骤
• RecipientId：签署者的唯一ID，和创建信封时的配置一一对应
• Status：该签署者的当前状态（Completed表示已完成，Sent表示已发送，Delivered表示已送达等）

每个RecipientStatus还包含完整的时间线（Sent/Delivered/Signed），能清晰追踪每个签署者的签署进度。

总结 #

无论哪种签署方式，优先通过RecipientStatus中的Status和Signed时间戳来验证签署完成状态，比依赖DocumentStatuses的命名规则更稳定。对于多签署者，只需遍历RecipientStatuses下的每个节点，结合签署者的标识字段就能逐一确认状态。

内容的提问来源于stack exchange，提问作者Shyam Dasari