连接响应中的路由顺序/签名组信息?

时间:2019-05-06 16:15:00

标签: docusignapi

我试图了解连接API(使用Webhook状态更新)发送的响应。该文档说,答案仅提供EvenvelopeStatus类型的XML元素(如果需要,还提供文档PDF)。这不包括当前的路由顺序信息或签名组信息,对吗?

  1. 有人知道(如果是这样,是否有解决方法)如何在不解析收件人状态的情况下获取连接消息中的当前路由顺序?
  2. 如果其中一个收件人是一个签名组,则在该组成员之一查看/签名文档之前,姓名和电子邮件字段会保持空白吗?然后,我希望名称/电子邮件字段中会填写实际的签名者。

谢谢您的帮助!

2 个答案:

答案 0 :(得分:1)

我通过调试界面找到了问题的答案。就像预期的那样:签名组的名称在名称标签中报告,并在签名完成后由实际的签名人名称替换。必须通过解释接收者的状态来“计算”路由状态-不能像信封:获取服务呼叫中那样获得总体路由信息。

答案 1 :(得分:0)

可以从通知消息中确定当前路由情况。查看信封收件人的状态属性。

您需要通过查看收件人的status值来推断当前的路由状态。这是一个示例通知。您可以看到一个收件人处于completed状态,另一个收件人处于sent状态。

请记住,如果信封使用并行路由,则多个收件人可以同时处于sent状态。

<?xml version="1.0" encoding="utf-8"?>
<DocuSignEnvelopeInformation 
   xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
   xmlns="http://www.docusign.net/API/3.0">
<EnvelopeStatus>
    <RecipientStatuses>
        <RecipientStatus>
            <Type>Signer</Type>
            <Email>Sam.Spade@example.com</Email>
            <UserName>Sam Spade</UserName>
            <RoutingOrder>1</RoutingOrder>
            <Sent>2019-05-07T10:43:40.073</Sent>
            <Delivered>2019-05-07T10:44:06.023</Delivered>
            <Signed>2019-05-07T10:44:12.323</Signed>
            <DeclineReason xsi:nil="true"/>
            <Status>Completed</Status>
            <RecipientIPAddress>141.226.10.195</RecipientIPAddress>
            <CustomFields/>
            <TabStatuses>
                <TabStatus>
                    <TabType>SignHere</TabType>
                    <Status>Signed</Status>
                    <XPosition>341</XPosition>
                    <YPosition>697</YPosition>
                    <TabLabel>Sign Here</TabLabel>
                    <TabName>SignHere</TabName>
                    <DocumentID>1</DocumentID>
                    <PageNumber>1</PageNumber>
                </TabStatus>
                <TabStatus>
                    <TabType>SignHere</TabType>
                    <Status>Signed</Status>
                    <XPosition>416</XPosition>
                    <YPosition>412</YPosition>
                    <TabLabel>Sign Here</TabLabel>
                    <TabName>SignHere</TabName>
                    <DocumentID>2</DocumentID>
                    <PageNumber>1</PageNumber>
                </TabStatus>
                <TabStatus>
                    <TabType>SignHere</TabType>
                    <Status>Signed</Status>
                    <XPosition>416</XPosition>
                    <YPosition>316</YPosition>
                    <TabLabel>Sign Here</TabLabel>
                    <TabName>SignHere</TabName>
                    <DocumentID>3</DocumentID>
                    <PageNumber>1</PageNumber>
                </TabStatus>
            </TabStatuses>
            <AccountStatus>Active</AccountStatus>
            <RecipientId>64d1f093-d51e-4d38-914e-3255f46c0e18</RecipientId>
        </RecipientStatus>
        <RecipientStatus>
            <Type>Signer</Type>
            <Email>Susan.smith@example.com</Email>
            <UserName>Susan Smith</UserName>
            <RoutingOrder>2</RoutingOrder>
            <Sent>2019-05-07T10:44:13.76</Sent>
            <DeclineReason xsi:nil="true"/>
            <Status>Sent</Status>
            <RecipientIPAddress/>
            <CustomFields/>
            <AccountStatus>Active</AccountStatus>
            <RecipientId>ad82fdb5-dfe9-479e-a4ca-0032a51b076a</RecipientId>
        </RecipientStatus>
    </RecipientStatuses>
    <TimeGenerated>2019-05-07T10:47:56.4026603</TimeGenerated>
    <EnvelopeID>a65c99da-39aa-488f-909a-1b3964634758</EnvelopeID>
    <Subject>Please sign this document set</Subject>
    <UserName>Sam Spade</UserName>
    <Email>Sam.Spade@example.com</Email>
    <Status>Sent</Status>
    <Created>2019-05-07T10:43:27.943</Created>
    <Sent>2019-05-07T10:44:13.79</Sent>
    <ACStatus>Original</ACStatus>
    <ACStatusDate>2019-05-07T10:43:27.943</ACStatusDate>
    <ACHolder>Sam Spade</ACHolder>
    <ACHolderEmail>Sam.Spade@example.com</ACHolderEmail>
    <ACHolderLocation>DocuSign</ACHolderLocation>
    <SigningLocation>Online</SigningLocation>
    <SenderIPAddress>141.226.10.195 </SenderIPAddress>
    <EnvelopePDFHash/>
    <CustomFields>
        <CustomField>
            <Name>Order ID</Name>
            <Show>True</Show>
            <Required>False</Required>
            <Value/>
        </CustomField>
        <CustomField>
            <Name>Sales order</Name>
            <Show>True</Show>
            <Required>False</Required>
            <Value>16</Value>
        </CustomField>
        <CustomField>
            <Name>AccountId</Name>
            <Show>false</Show>
            <Required>false</Required>
            <Value>3964103</Value>
            <CustomFieldType>Text</CustomFieldType>
        </CustomField>
        <CustomField>
            <Name>AccountName</Name>
            <Show>false</Show>
            <Required>false</Required>
            <Value>World Wide Corp</Value>
            <CustomFieldType>Text</CustomFieldType>
        </CustomField>
        <CustomField>
            <Name>AccountSite</Name>
            <Show>false</Show>
            <Required>false</Required>
            <Value>demo</Value>
            <CustomFieldType>Text</CustomFieldType>
        </CustomField>
    </CustomFields>
    <AutoNavigation>true</AutoNavigation>
    <EnvelopeIdStamping>true</EnvelopeIdStamping>
    <AuthoritativeCopy>false</AuthoritativeCopy>
    <DocumentStatuses>
        <DocumentStatus>
            <ID>1</ID>
            <Name>Order acknowledgement</Name>
            <TemplateName/>
            <Sequence>1</Sequence>
        </DocumentStatus>
        <DocumentStatus>
            <ID>2</ID>
            <Name>Battle Plan</Name>
            <TemplateName/>
            <Sequence>2</Sequence>
        </DocumentStatus>
        <DocumentStatus>
            <ID>3</ID>
            <Name>Lorem Ipsum</Name>
            <TemplateName/>
            <Sequence>3</Sequence>
        </DocumentStatus>
    </DocumentStatuses>
</EnvelopeStatus>
</DocuSignEnvelopeInformation>