当前位置: 首页 > 知识库问答 >
问题:

在信封上充当两个收件人的用户的DocuSign Recipient视图

徐翔
2023-03-14

我们有一个用例,同一个用户需要在同一个信封上作为两个不同的收件人签名。这似乎或多或少起到了作用。请参阅下面的测试信封之一的“获取收件人”响应。如您所见,两个不同的收件人具有相同的用户ID值。

{
    "signers": [        
        {
            "signatureInfo": {
                "signatureName": "test",
                "signatureInitials": "T",
                "fontStyle": "freehand575"
            },
            "tabs": {
                "signHereTabs": [
                    {
                        "stampType": "signature",
                        "name": "SignHere",
                        "tabLabel": "Sign Here",
                        "scaleValue": 1,
                        "optional": "false",
                        "documentId": "1",
                        "recipientId": "2",
                        "pageNumber": "1",
                        "xPosition": "191",
                        "yPosition": "123",
                        "anchorString": "@SW1R",
                        "anchorXOffset": "0",
                        "anchorYOffset": "0",
                        "anchorUnits": "pixels",
                        "tabId": "19f2a250-7ffc-4452-b7e2-e0bf1fddd660",
                        "status": "signed"
                    }
                ]
            },
            "creationReason": "sender",
            "isBulkRecipient": "false",
            "identityVerification": {},
            "name": "test",
            "email": "Test@test.com",
            "recipientId": "2",
            "recipientIdGuid": "215d99bb-5c50-4bdd-b298-21639d0aad4c",
            "requireIdLookup": "false",
            "userId": "386ae756-5c1c-480e-abd5-94d960781f5c",
            "clientUserId": "49b09797-cea5-4d87-b653-49f13f733dd3",
            "routingOrder": "1",
            "status": "completed",
            "signedDateTime": "2019-08-02T21:21:53.9570000Z",
            "deliveredDateTime": "2019-08-02T21:16:54.9800000Z",
            "totalTabCount": "4"
        },
        {
            "signatureInfo": {
                "signatureName": "test",
                "signatureInitials": "T",
                "fontStyle": "freehand575"
            },
            "tabs": {
                "signHereTabs": [
                    {
                        "stampType": "signature",
                        "name": "SignHere",
                        "tabLabel": "Sign Here",
                        "scaleValue": 1,
                        "optional": "false",
                        "documentId": "1",
                        "recipientId": "3",
                        "pageNumber": "1",
                        "xPosition": "189",
                        "yPosition": "167",
                        "anchorString": "@SPAAR",
                        "anchorXOffset": "0",
                        "anchorYOffset": "0",
                        "anchorUnits": "pixels",
                        "tabId": "e2def7a9-bfdb-404d-8901-e387d9e4f856"
                    }
                ]
            },
            "creationReason": "sender",
            "isBulkRecipient": "false",
            "identityVerification": {},
            "name": "test",
            "email": "Test@test.com",
            "recipientId": "3",
            "recipientIdGuid": "0b6541f4-45b7-4b6e-a4cb-740d2f9f07a7",
            "requireIdLookup": "false",
            "userId": "386ae756-5c1c-480e-abd5-94d960781f5c",
            "clientUserId": "49b09797-cea5-4d87-b653-49f13f733dd3",
            "routingOrder": "1",
            "status": "delivered",
            "deliveredDateTime": "2019-08-02T20:36:14.5170000Z",
            "totalTabCount": "4"
        }
    ],
    "agents": [],
    "editors": [],
    "intermediaries": [],
    "carbonCopies": [],
    "certifiedDeliveries": [],
    "inPersonSigners": [],
    "seals": [],
    "witnesses": [],
    "recipientCount": "3",
    "currentRoutingOrder": "1"
}

我们关心的是当我们调用POST-EnvelopeViews:createRecipient时。我们发现,这似乎为任何尚未具有完成状态的收件人返回了收件人视图。这是否可靠/确定?我们已尝试在此请求中指定recipientId,但它不会影响我们接收的收件人视图。例如,以下请求将按请求返回收件人3(已传递)的视图,而不是收件人2(已完成)的视图。

{
  "authenticationMethod": "email",
  "email": "Test@test.com",
  "returnUrl": "http://www.google.com",
  "userName": "test",
  "clientUserId": "49b09797-cea5-4d87-b653-49f13f733dd3",
  "recipientId": "2"
}

更新-有关业务需求的更多详细信息:
我们创建一个包含2个专属收件人Presenter和Agent的信封。在创建信封时,我们不知道谁将作为代理签名,因此初始收件人是占位符用户。在业务流程的后期,我们确定谁将充当代理,并调用DocuSign API来更新和“交换”代理收件人的电子邮件、clientUserId和用户名,使其成为将签名的实际用户。这是我们多年来一直成功使用的过程。

我们现在有一种情况,演示者和代理可以是同一个人,但演示者必须先完成签名,然后代理(同一个人或其他人)才能签名。如果他们是同一个人,按照上述“交换”方法,我们仍然有两个收件人,但代理收件人的用户ID与演示者收件人的用户ID相同。

我主要关心的是POST-EnvelopeViews:createRecipient方法是否具有确定性,因为它似乎忽略了recipientId参数。我想确保我们能够可靠地做到以下几点:

  1. 允许演示者用户完成签名
  2. “交换”同一用户以作为代理登录
  3. 已成功获取作为代理收件人的用户的收件人视图

共有1个答案

姚伟
2023-03-14

你到底想做什么?收件人完成后,是否仍要为该收件人创建收件人视图?即使同一个收件人还必须在发送顺序的下方填写此信封?这很可能不是受支持的方案。我建议,如果同一个人需要对信封进行多次操作,并且他们完成了第一次交互,那么下一个请求将/应该将他们带到下一次交互。我觉得做其他任何事都没有意义。

 类似资料:
  • 我正在发送来自Salesforce的文档,使用DocuSign签名,使用自定义对象记录上的自定义按钮。我在记录中捕获收件人,并在CRL,CCRM,CCTM中传递细节。现在,我想删除在发送前添加、删除或编辑信封中显示的收件人的功能。我能做些什么来实现这一点。 提前致谢

  • 我正在使用docusign api,但在查询字符串参数方面遇到了一些问题。基本上,我试图在一个电话中获取信封的收件人信息以及信封的状态。 我可以用下面的api调用单独获取每一个信息,它们都工作 但是,我想看看是否可以在一个API调用中获取所有这些信息。根据这里的通用信封endpoint文档,我认为我应该能够使用以下查询参数https://developers.docusign.com/esign-

  • 我的web应用程序在收集合适的签名者、发送电子邮件、请求签名、跟踪签名者状态等方面都有相当大的参与,因此我相信嵌入式收件人体验对我们来说是最有意义的。 然而,我们使用集成的第一个客户已经使用DocuSign一段时间了,他们的签名者(CEO、CFO等)习惯于登录到DocuSign,在收件箱中看到信封并单击信封签名--这只有在集成中通过将他们添加为远程收件人才能实现。嵌入的收件人不能与DocuSign

  • 在获取Docusign信封收件人视图的查询参数中,其中GET调用是“/RESTAPI/v2.1/accounts/{accountId}/envelops/{envelopeId}/documents/composited?recipient_id=123&documents_by_userid=false”,是recipient_id,即Docusign生成的GUID,还是我们必须在信封创建调用

  • 我对Docusign有两个问题,第一,它总是用相同的帐户发送信封,无论谁被记录总是用相同的帐户发送,我不知道为什么。

  • 我在用嵌入式签名。要获取签名仪式URL,我调用POST Recipient View方法。该方法使用某种信息组合来匹配信封中的签名者以生成URL。在电子邮件和用户名字段中,文档声明: 然而,当我尝试这个,它不起作用。我得到这个错误: 当我开始传递userId时,这个错误就会出现,并且不管我是否在正文中传递userName,或者我是否只是以空字符串的形式传递它,它都会被抛出。以下是我的请求体: 我已