Question

我正在开发一个PHP应用程序，它有多个产品需要在购买产品之前与客户签名。我正在使用powerforms链接将它们嵌入到我的应用程序中（使用iFrame）。

他们工作正常。但问题是我需要将文档签名状态存储在我的数据库中。

我们可以在Docusign首选项页面中设置返回URL。但这将是静态的，我不知道用户选择了什么产品。

Answer 1

您可以使用 DocuSign Connect 接收信封事件的实时通知（例如， Envelope Completed ）。在高级别，它的工作原理如下：

您登录DocuSign Web控制台（作为管理员）并创建自定义连接配置。作为创建此配置的一部分，您将指定希望Connect向其发送通知的端点（http地址）以及要通知哪些事件。
您构建了一个“侦听器” - 即将从DocuSign Connect接收HTTP POST消息的网页，并处理这些消息。
当发生Envelope或Recipient事件时（您已在DocuSign Connect配置中启用了通知），Connect几乎会立即向您的侦听器发送HTTP POST。此消息包含XML，其中包含有关信封，收件人，文档，字段等的信息。您将开发侦听器，以便解析XML消息以确定信封状态，数据字段值等，然后可以在上下文中进行适当响应您的应用程序（即，在您的方案中，您的侦听器将使用来自Connect的XML消息来确定信封状态以及用户选择的产品）。

有关配置/使用DocuSign Connect的更多详细信息，请参阅DocuSign开发人员中心（http://www.docusign.com/sites/default/files/DocuSign_Connect_Service_Guide.pdf）中的本指南（http://www.docusign.com/developer-center/explore/connect）和此页面。

更新 - 使用自定义字段填充信封的唯一标识符

根据用例的性质，您可能需要使用“信封自定义字段”在“创建/发送信封”请求中为每个信封填充唯一标识符，以便您的侦听器应用程序有一种在收到Connect消息时识别信封的方法。（“信封自定义字段”只是信封上的自定义元数据。）只需在“创建信封”请求中设置 customFields 属性，然后填充单个 textCustomFields 项使用唯一标识符。例如：

{
  "emailSubject": "Please sign this",
  "emailBlurb": "Please sign...thanks!",
  "customFields": {
        "textCustomFields": [
            {
                "value": "1234567",
                "required": "false",
                "show": "true",
                "name": "ProductId"
            }
        ]
    },
  "status": "sent"
  ...
}

有关使用自定义信封字段的详细信息，请参阅REST API指南（http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf）。

Docusign Powerforms嵌入成功状态

1 个答案: