Question

我正在使用DocuSign API从我的客户那里获取签名。

情境：

客户填写完整表格并在成功重定向之前填写我希望他们在特定地点签署该pdf文档。

将在运行时为每个用户动态生成PDF文件。

究竟能做到什么？它的步骤应该是什么？

平台是铁轨上的红宝石。我找不到确切的文档。

Answer 1

我对Ruby不太熟悉，但我可以解释实现您所描述的DocuSign API场景的一般过程。然后，您可以将此信息与DocuSign Ruby SDK一起使用，以实现您的目标。（看起来Ruby SDK repo中的unit tests包含一些可能对您有用的示例代码。）

您所描述的方案要求您发出2个API请求：

创建信封请求（指定嵌入式/强制收件人）
获取收件人视图请求

首先，使用DocuSign API发出 Create Envelope 请求。

作为请求的一部分，您将指定收件人信息，选项卡信息（以指示收件人需要对文档签名的位置）以及文档字节。
在收件人信息中，请确保包含clientUserId属性，该属性会将收件人指定为embedded/captive recipient - 这对您的方案至关重要。
在tabs（收件人）对象的signer属性中，您将使用{{1为收件人签署文档的每个位置指定signHereTab }，documentId，pageNumber和xPosition指定每个标签的位置。

以下示例显示创建信封请求，其中包含单个文档，一个嵌入式/捕获式收件人（签名者）和一个签名选项卡（显示在文档的第一页上，位于x / y坐标25/25）。

yPosition

收到创建信封响应后，表示信封已成功创建，请立即发出 Get Recipient View 请求。响应将包含一个URL，您可以通过DocuSign Web UI重定向用户以完成签名仪式。

以下示例显示了与上一个示例中指定的信封（和收件人）相对应的获取收件人视图请求。

POST /v2/accounts/{accountId}/envelopes
{
    "status": "sent",
    "emailSubject":"Please Sign",
    "recipients": {
      "signers": [
          {
              "name": "John Doe",
              "email": "john.doe@test.com",
              "recipientId": "1",
              "clientUserId": "12345",
              "tabs": {
                  "signHereTabs": [
                      {
                         "xPosition":25,
                         "yPosition":25,
                         "documentId":1,
                         "pageNumber":1
                      }
                  ]
              }
          }
      ]
    },
    "documents": [
        {
            "documentId": "1",
            "documentBase64": "DOCUMENT_BYTES_HERE",
            "fileExtension": "pdf",
            "name": "FILENAME.pdf"

        }
    ]
}

Answer 2

正如Kim所说，你需要为你的用例使用嵌入式签名。您需要遵循以下策略之一来了解DS选项卡的位置以获取签名：

通过在PDF文档中使用X / Y位置，在Kim的共享示例交
通过使用锚点字符串，您可以在PDF上放置隐藏文本在DS API调用中传递这些隐藏文本，并通知DS哪些选项卡这些隐藏文本的地方。有关详细信息，请访问Anchoring Tabs和Anchoring Rules。示例可用here
如果您根据DS标准创建PDF表单字段，则可以如解释here

DocuSign：创建自定义pdf后在网站上进行嵌入式签名

2 个答案: