docusignapi - 如何确认 Docusign Connect 事件

Question

我正在使用 Docusign Connect 并愉快地接收事件。最近，我在查看文档时注意到了 requireAcknowledgement 标志，并且我正尝试以混合成功的方式实现它。通常，当我收到连接事件时，我会返回一个空主体的 200。但在翻转该标志后，事件落入连接失败日志中，并显示错误消息:“错误”:“https://scrubbed/::错误 - 返回的信封 ID 不匹配，返回的数据:200 OK”

因此，按照诊断顺序:

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

这是我的连接配置:

{
  "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"
}

感谢您提供的任何帮助!

Answer 1

在浏览连接日志时发现了这一点。 Docusign 有自己的连接配置，这是他们作为确认发回的响应(给他们自己)。可能还有一个纯 xml 版本，但我不知道。

注意:这通常不是必需的，只有在您使用 requireAcknowledgement 标志时才需要。关键是要向 Docusign 证明您不仅获得了数据，而且能够解析它并获得一些值。因此，如果您担心损坏或您的服务器因某种原因出现故障，它会很有帮助。

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <soap:response>
      <EnvelopeID>xxxx-xxxx-xxxx-xxxx</EnvelopeID>
    </soap:response>
  </soap:Body>
</soap:Envelope>