Docusignapi 在进程内共享文档上切换签名者

在处理信封时，是否可以在共享文档上切换签名者（带选项卡）

我们的过程如下：

生成一个共享PDF文档（不使用DocuSign模板），其中包含所有签名者的签名占位符

我们为文档PDF创建并发送信封

一个或多个客户签署文档（使用嵌入式签名页）

最后一个签名者（我们的员工）对文档进行签名（也使用嵌入的签名页）

员工签名者可以是多个员工中的一个，但不管是谁，他们都会在文档上的相同位置签名。我们希望能够将选择哪个员工签署文档的时间推迟到流程结束，而不是在信封创建时指定他们

一旦信封处理完毕，我就可以添加和删除员工收件人，但我找不到一种方法来包括他们的标签。我在请求中包含选项卡，但添加的员工始终处于类似“已创建”的草稿状态，没有选项卡。嵌入式视图仍然要求查看器手动放置选项卡。我需要标签已经放置并锁定在文档上，以便员工可以签名

我们正在使用RESTAPI，这需要是一个自动化的解决方案（无需手动修改信封）。有什么方法可以达到这个或类似的目的吗

这是我的添加收件人请求

POST https://demo.docusign.net/restapi/v2/accounts/<account>/envelopes/<envelope-id>/recipients?resend_envelope=true

{
"signers" : [{
        "recipientId" : 4,
        "email" : "john@example.com",
        "name" : "John Citizen",
        "tabs" : {
            "initialHereTabs" : [{
                    "documentId" : "1",
                    "recipientId" : 4,
                    "name" : "InitialHere_3",
                    "pageNumber" : 1,
                    "xPosition" : 282,
                    "yPosition" : 454,
                    "tabName" : "InitialHere_3"
                }
            ],
            "signHereTabs" : [{
                    "documentId" : "1",
                    "recipientId" : 4,
                    "name" : "SignHere_3",
                    "pageNumber" : 1,
                    "xPosition" : 81,
                    "yPosition" : 447,
                    "tabName" : "SignHere_3"
                }
            ],
        },
        "clientUserId" : "LTEST_Resident4",
        "routingOrder" : 2,
    }
]
}

POSThttps://demo.docusign.net/restapi/v2/accounts//envelopes//recipients?resend_envelope=true
{
“签署人”：[{
“接收方ID”：4，
“电子邮件”：john@example.com",
“姓名”：“约翰公民”，
“选项卡”：{
“initialHereTabs”：[{
“documentId”：“1”，
“接收方ID”：4，
“姓名”：“姓名首字母3”，
“页码”：1，
“xPosition”：282，
“yPosition”：454，
“tabName”：“InitialHere_3”
}
],
“signHereTabs”：[{
“documentId”：“1”，
“接收方ID”：4，
“名称”：“在此处签名”，
“页码”：1，
“xPosition”：81，
“yPosition”：447，
“tabName”：“SignHere_3”
}
],
},
“客户端用户ID”：“LTEST\U Resident4”，
“路由顺序”：2，
}
]
}

---

（我也用PUT而不是POST尝试了相同的请求。结果是一样的）

听起来你好像在试图修改或更正并重新发送收件人信息

第137页

修改或更正并重新发送收件人信息

这使您可以修改草稿信封中的收件人或更正处理中信封的收件人信息。对于草稿信封，您可以编辑：电子邮件、用户名、路由顺序、传真号码、传递方法、访问码和RequiredLookup。发送信封后，您只能编辑：电子邮件、用户名、签名名、发送顺序、传真号码和发送方式。您还可以使用“重新发送信封”选项选择重新发送信封

请求示例：

    PUT https://{server}/restapi/{apiVersion}/accounts/{accountId}/envelopes/{envelopeId}/recipients?resend_envelope=true

    X-DocuSign-Authentication:<DocuSignCredentials><Username>{name}</Username><Password>{password}</Password><IntegratorKey>{integrator_key}</IntegratorKey></DocuSignCredentials>
    Accept: application/json
    Content-Type: application/json

    {

    "signers": [
        {
            "email": "email@domain.com",
            "name": "John Smith",
            "recipientId": "1"
        }
    ]
}

{
    "recipientUpdateResults": [
        {
            "errorDetails": {
                "errorCode": "SUCCESS",
                "message": ""
            },
            "recipientId": "1"
        }
    ]
}

---

听起来您的工作流需要执行以下操作：

    PUT https://{server}/restapi/{apiVersion}/accounts/{accountId}/envelopes/{envelopeId}/recipients?resend_envelope=true

    X-DocuSign-Authentication:<DocuSignCredentials><Username>{name}</Username><Password>{password}</Password><IntegratorKey>{integrator_key}</IntegratorKey></DocuSignCredentials>
    Accept: application/json
    Content-Type: application/json

    {

    "signers": [
        {
            "email": "email@domain.com",
            "name": "John Smith",
            "recipientId": "1"
        }
    ]
}

{
    "recipientUpdateResults": [
        {
            "errorDetails": {
                "errorCode": "SUCCESS",
                "message": ""
            },
            "recipientId": "1"
        }
    ]
}

使用“阻止收件人”创建信封

在识别其他收件人时添加其他收件人

向新收件人添加标记

当您希望发送文档时，请删除“阻止收件人”

我假设你有1个。注意，我将快速浏览2-4的示例。

2。创建其他收件人 3。向收件人添加标签 4。删除阻止程序收件人

---

你能发布你的添加员工请求吗，这样我们就可以看到你在尝试时做了什么？我已经添加了我的请求。这是我的简化概念证明。实际文档要复杂得多。谢谢Justin，我也尝试过修改（这是相同的请求，但使用PUT而不是POST），但结果相同。它可以很好地编辑一个签名者，但我想切换到另一个具有不同clientUserId的签名者。成功！非常感谢。与我之前所做的主要区别在于，选项卡是在一个单独的请求中添加的。似乎AddRecipient不处理signers中的选项卡，而CreateEnvelope和ModifyRecipient都处理。

DELETE: https://demo.docusign.net/restapi/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}