关于DocuSign Connect回调中原签署人类型未从Signer变更为CarbonCopy的配置咨询
我已经查阅了「变更签署人时DocuSign Connect回调未触发」相关问题的答案,现在有个具体疑问:在使用legacy data格式的Connect回调中,当原签署人把签署权限委托给其他用户后,我没有看到原签署人的Recipient type从Signer变更为CarbonCopy,只能看到被委托方的类型显示为Signer。这个现象是不是和Connect的配置有关?我暂时没找到对应的配置项。
这个逻辑在我的演示账户里能正常运行,但在客户的DocuSign账户里就失效了。因为我的集成逻辑已经依赖CarbonCopy标签做处理,所以这个信息是必须的。想问问有没有账户级别的配置项,可以控制原签署人的类型从Signer转为CarbonCopy?
补充说明
在下面的XML示例中,mainsigner@yyy.com已经把权限委托给delegatedto@yyy.com,我预期会出现一个针对mainsigner@yyy.com的新RecipientStatus节点,其Type为CarbonCopy。
<?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>CarbonCopy</Type> <Email>abc@xxx.com</Email> <UserName>ABC</UserName> <RoutingOrder>1</RoutingOrder> <Sent>2021-10-28T11:51:53.177</Sent> <DeclineReason/> <Status>Completed</Status> <RecipientIPAddress/> <CustomFields> <CustomField>NonSignerCarbonCopy</CustomField> <CustomField/> <CustomField/> </CustomFields> <AccountStatus>Active</AccountStatus> <RecipientId>d4bee1ca-8af2-4d45-83b9-xxxxxxxxx</RecipientId> </RecipientStatus> <RecipientStatus> <Type>Signer</Type> <Email>delegatedto@yyy.com</Email> <UserName>delegatedto</UserName> <RoutingOrder>1</RoutingOrder> <Sent>2021-11-04T07:44:41.59</Sent> <Delivered>2021-11-04T07:55:46.007</Delivered> <Signed>2021-11-04T07:56:03.007</Signed> <DeclineReason/> <Status>Completed</Status> <RecipientIPAddress>ipaddress</RecipientIPAddress> <CustomFields> <CustomField>S||mainsigner@yyy.com</CustomField> <CustomField/> <CustomField/> </CustomFields> <TabStatuses> <TabStatus> <TabType>SignHere</TabType> <Status>Signed</Status> <XPosition>187</XPosition> <YPosition>508</YPosition> <TabLabel>Sign Here</TabLabel> <TabName>SignHere</TabName> <TabValue/> <DocumentID>336845219</DocumentID> <PageNumber>2</PageNumber> </TabStatus> <TabStatus> <TabType>DateSigned</TabType> <Status>Signed</Status> <XPosition>195</XPosition> <YPosition>816</YPosition> <TabLabel>Date Signed</TabLabel> <TabName>DateSigned</TabName> <TabValue>11/4/2021 | 7:56 AM PDT</TabValue> <DocumentID>336845219</DocumentID> <PageNumber>2</PageNumber> </TabStatus> </TabStatuses> <RecipientAttachment> <Attachment> <Data>somedaata</Data> <Label>DSXForm</Label> </Attachment> </RecipientAttachment> <AccountStatus>Closed</AccountStatus> <EsignAgreementInformation> <AccountEsignId>GUID</AccountEsignId> <UserEsignId>GUID</UserEsignId> <AgreementDate>2021-11-04T07:55:46.007</AgreementDate> </EsignAgreementInformation> <FormData> <xfdf> <fields> <field name="DateSigned"> <value>11/4/2021 | 7:56 AM PDT</value> </field> </fields> </xfdf> </FormData> <RecipientId>98525aa9-ae3e-4d1c-aa48-xxxxxxxxxx</RecipientId> </RecipientStatus> </RecipientStatuses> <TimeGenerated>2021-11-04T07:56:23.8331339</TimeGenerated> <EnvelopeID>ee738247-57a4-49d7-8914-xxxxxxxx</EnvelopeID> <Subject>C345</Subject> <UserName>Admin</UserName> <Email>Admin@yyy.com</Email> <Status>Completed</Status> <Created>2021-10-28T11:51:51.707</Created> <Sent>2021-11-04T07:44:41.637</Sent> <Delivered>2021-11-04T07:55:46.273</Delivered> <Signed>2021-11-04T07:56:03.007</Signed> <Completed>2021-11-04T07:56:03.007</Completed> <ACStatus>Original</ACStatus> <ACStatusDate>2021-10-28T11:51:51.707</ACStatusDate> <ACHolder>Admin</ACHolder> <ACHolderEmail>Admin@yyy.com</ACHolderEmail> <ACHolderLocation>DocuSign</ACHolderLocation> <SigningLocation>Online</SigningLocation> <SenderIPAddress>ipaddress </SenderIPAddress> <EnvelopePDFHash/> <CustomFields/> <AutoNavigation>true</AutoNavigation> <EnvelopeIdStamping>true</EnvelopeIdStamping> <AuthoritativeCopy>false</AuthoritativeCopy> <DocumentStatuses> <DocumentStatus> <ID>888888888</ID> <Name>C3459</Name> <TemplateName/> <Sequence>1</Sequence> </DocumentStatus> </DocumentStatuses> </EnvelopeStatus> <DocumentPDFs> <DocumentPDF> <Name>CertificateOfCompletion_GUID.pdf</Name> <PDFBytes>Bn8iUlJSRa7MTExKzHx1DNb//bFeKyLoldo39X9/S ......... </DocumentPDF> </DocumentPDFs> </DocuSignEnvelopeInformation>
我订阅的Connect事件
- Envelope Sent
- Envelope Signed/Completed
- Envelope Declined
- Envelope Voided
- Recipient Signed/Completed
- Recipient Declined
首先,这个差异确实和账户级别的配置有关,核心是Enable Delegation as Carbon Copy这个账户设置项——它直接决定了委托签署后原签署人会不会被转为CarbonCopy类型并出现在回调里。
具体步骤检查客户账户配置:
- 登录客户的DocuSign Admin账户,进入Settings(设置)页面。
- 在左侧导航栏找到Signing Settings(签署设置),展开后选择Delegation(委托)选项。
- 查看是否勾选了Enable Delegation as Carbon Copy这个选项。如果没勾选,原签署人不会被转为CarbonCopy,回调里自然不会出现对应的
RecipientStatus节点。
为什么演示账户正常?
DocuSign的演示(Sandbox)账户默认会开启这个配置,而正式生产账户默认是关闭的——这就是为什么你的测试环境正常,客户环境失效的原因。
额外提示:
如果客户账户没有这个配置项的权限(比如某些企业套餐需要联系DocuSign支持开启),你也可以通过解析回调中被委托方RecipientStatus里的CustomFields来获取原签署人信息(比如你示例里的<CustomField>S||mainsigner@yyy.com</CustomField>),作为临时兼容方案,但长期来看还是建议开启账户配置项,以匹配你的原有集成逻辑。
内容的提问来源于stack exchange,提问作者Kiran Badgujar

