标签: docusignapi

我想将DocuSign Connect作为休息监听器来实现.

我无法在任何地方找到侦听器将接收的xml架构的完整文档.

我知道pdf中有一个例子:

http://764be237d39fdfa0985f-37a6c1f0731907180d9764651d02bea9.r5.cf2.rackcdn.com/DocuSign_Connect_Service_Guide.pdf

但我想知道是否有更正式的描述,例如xsd.

我正在使用DocuSign REST API使用/ envelopes/{envelopeID}/views/recipient调用为预定义的文档模板创建嵌入式签名.我知道在创建信封时可以预先填充标记值,但是可以在签名完成后检索接收者在给定标记字段中实际提供的值以便在应用程序中使用吗？如果是这样,有没有人有一个例子？

/我需要传递头信息/ header{ "X-DocuSign-Authentication": "{\"Username\":\"abc@gmail.com\",\"Password\":\"mypassword\",\ "IntegratorKey\":\"the-super-long-key\"}" } / ***我如何将用户名、密码和integratorKey传递给docusign** / '我在docusign站点上测试了参数，它们工作。

Dim sUrl As String = "https://demo.docusign.net/restapi/v1/login_information?api_password=true&include_account_id_guid=true&login_settings=all"         


    Dim oRequest As HttpWebRequest
    oRequest = WebRequest.Create(sUrl)
    oRequest.KeepAlive = False
    oRequest.Headers.Add("Username", "abc@gmail.com")
    oRequest.Headers.Add("Password", "mypassword")
    oRequest.Headers.Add("IntegratorKey", "my-integrator-key")


    Dim oResponse As HttpWebResponse = oRequest.GetResponse   '*****FAILS****

我正在与Docusign Connect合作并愉快地接收活动.最近我正在查看文档,并注意到了requireAcknowledgement标志,我正在努力实现这一点并取得了成功.通常,当我收到连接事件时,我会返回一个空体200.但在翻转该标志后,事件将落入Connect失败日志中并显示错误消息:"error": "https://scrubbed/ :: Error - Envelope Id returned does not match, returned data: 200 OK"

所以,按照诊断顺序:

• Docusign Connect通常工作正常,我接收事件并发回空200
• 当我翻转requireAcknowledgement布尔值时,所有事件都会进入连接失败日志,并显示有关信封ID不匹配的错误.由于我没有在身体中发回信封ID,这似乎是正确的
• 我找不到关于如何在确认中指定信封ID的文档.这是标题吗？它身体是xml吗？是json吗？它只是遇到的第一个字符串吗？
• 如果我关闭,requireAcknowledgement我可以再次获得状态更改而无需其他更改.

这是我的Connect Config:

{
  "connectId": "xxx",
  "urlToPublishTo": "https://{snip}/",
  "name": "POST everything to test webhook",
  "allowEnvelopePublish": "true",
  "enableLog": "true",
  "includeDocuments": "false",
  "includeCertificateOfCompletion": "false",
  "requiresAcknowledgement": "true",
  "signMessageWithX509Certificate": "true",
  "useSoapInterface": "false",
  "includeTimeZoneInformation": "true",
  "includeEnvelopeVoidReason": "false",
  "includeSenderAccountasCustomField": "true",
  "envelopeEvents": "Sent,Delivered,Signed,Completed,Declined,Voided",
  "recipientEvents": "Sent,Delivered,Completed,Declined",
  "soapNamespace": "",
  "allUsers": "true",
  "includeCertSoapHeader": "false"
}

感谢您提供任何帮助!

findall('Email')给定以下 xml，如何使用查询元素树？

<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>
        <RecipientStatus>
                <Type>Signer</Type>
                <Email>joe@gmail.com</Email>
                <UserName>Joe Shmoe</UserName>
                <RoutingOrder>1</RoutingOrder>
                <Sent>2015-05-04T09:58:01.947</Sent>
                <Delivered>2015-05-04T09:58:14.403</Delivered>
                <Signed>2015-05-04T09:58:29.473</Signed>
        </RecipientStatus>
    </EnvelopeStatus>
</DocuSignEnvelopeInformation>

我有一种感觉，它与命名空间有关，但我不确定。我查看了文档并没有运气。

tree = <xml.etree.ElementTree.ElementTree object at 0x7f27a47c4fd0>
root = tree.getroot()
root
<Element '{http://www.docusign.net/API/3.0}DocuSignEnvelopeInformation' at 0x7f27a47b8a48>

root.findall('Email')
[]

使用 DocuSign Rest API，我正在从一个模板创建一个信封，该模板具有一个必须签名的收件人角色。在为该收件人角色创建模板时，我启用了 Identity Check -> SMS Auth $。当我尝试从 DocuSign 门户发送信封时，它工作正常。但是，当我尝试使用 API 调用发送它时，我收到一条错误消息：RECIPIENT_SMS_AUTH_PHONE_MISSING: SMS 身份验证电话号码不能为空。请求正文已包含在模板角色中：

"SmsAuthentication":{
"senderProvidedNumbers":["recipient_number"] },
"IdCheckConfigurationName":"SMS Auth $",
"RequireIdLookup":true

在进行 API 调用时，这是否有任何原因不起作用？

无法预先填充公司和标题的默认选项卡,但textTabs user_name可以正常工作.我也可以更改字段的锁定属性,但不能更改值.

params = {
    "accountId" : ACCOUNT_ID,
    "emailSubject": "Test Sign",
    "emailBlurb": "Auto generated",
    "templateId": POWERFORM_ID,
    "templateRoles": [{
        "clientUserId" : str(user_id),
        "roleName": "Recipient",
        "name": name,
        "email": email,
        'company': 'test',
        'Company': 'test21',
        "tabs": {
            "companyTabs": [{
                "tabLabel": "Company",
                "value": 'this is a test',
            }],
            "textTabs": [{
                "tabLabel": "user_name",
                "value": user_name,
            }],
            "titleTabs": [{
                  "value": title,
                  "required": "true",
                  "tabLabel": "Title",
            }],
        },
  }],
  "status":"sent"
}

我正在查询其余 API 以获取所有信封。

以下是UI中的文档

当我使用信封列表查询时，会更改正确的起始日期和截止日期以及帐户 ID

它只给了我第一个和最后一个文档，如下所示。

我在 DocuSign 沙箱中创建了一个测试模板，为与另一个系统进行一些自动化做准备。我正在尝试填充这些自定义字段，因为需要包含动态输入的数据。

到目前为止，我在身份验证、创建基于模板的“信封”或分配角色方面没有遇到任何问题。我可以毫无问题地获取模板、信封、文档的 ID。但是，我尝试检索自定义字段列表或通过 REST API 填充它们都没有成功。

我尝试从模板中提取字段，并在应用模板后从信封中提取字段。我什至通过用户界面手动设置了值，但仍然一无所获。而且请求并没有失败。他们很成功。要么只有空的响应数据结构，要么没有执行更新。

例如，当我尝试检索自定义字段时，我得到的是：

{
  "textCustomFields": [],
  "listCustomFields": []
}

尽管已经通过 UI 创建了自定义字段并将其应用到模板等，但仍然如此。我也尝试获取文档字段，但收到的响应基本相同：

{
  "documentFields": []
}

我忍不住想我在这里错过了一些东西，但不知道是什么。我从身份验证响应中提取基本 URL，并调用了以下 API URL：

• /信封/{1}/custom_fields
• /信封/{1}/文档/{2}/字段
• /envelopes/{1}/recipients/{2}/tabs
• /templates/{1}/custom_fields
• /templates/{1}/documents/{2}/fields

- 编辑 -

好的，根据下面答案的建议，我发现这些字段实际上都是“选项卡”，尽管在创建模板期间如何在 UI 中实际引用它们。现在的问题仍然是为什么它们仅针对单个收件人角色返回。以下是信封上角色的屏幕截图（电子邮件地址已编辑）：

即使该角色被标记为“需要签名”，也不会返回“That Guy”的选项卡。他们因“其他人”而回归，尽管这个角色只是为了被复制。所以，也许现在看来问题更多地与角色定义有关，而不是其他任何事情。或者我必须再次回顾所有这些，因为必须为所有收件人设置这些需要预先填充的字段，并且不依赖于角色。每个人都应该看到同样的事情。

我正在探索各种设计 API（docusign、esignature.io 等），但找不到适合我需求的 API。

我们希望将设计融入到我们的软件中。我们的软件以 SaaS 形式出售，并由我们的客户在自己的地点使用。我们在内部托管我们的软件，客户通过托管的 RDP 会话进行连接。

我需要以下内容：

• 低成本或按文档定价

• 能够完全控制发件人身份、电子邮件等。它必须允许我使用我的客户电子邮件地址作为发件人。

• 能够拥有无限的发件人（用户），每个发件人都有自己的业务身份，我可以在 API 中设置这些身份。我的客户会将文件发送给他们的客户。例如我们的软件->客户端->客户端。

• 能够要求在移动设备上手绘签名

• 能够发送带有签名 URL 的短信

• 能够通过上传现有 PDF 并设置字段值来动态创建文档

• 能够让用户登录 iframe

• 用于获取签名事件的 Webhook

我探索过的大多数服务的问题在于，它们似乎都是面向客户使用 API 和客户自己的内部软件。我似乎无法为使用我们软件的客户找到可以为他们的客户使用它的 API。除了极其昂贵的 docusign 之外，我找不到允许我在移动设备上强制手绘签名的服务。

任何建议都会很棒！