将签名者切换到In Process共享文档

时间:2014-07-23 16:44:39

标签: docusignapi

一旦信封处于正在处理状态,是否可以在共享文档上切换签名者(带标签)?

我们的流程如下:

  1. 为所有签名者生成单个共享PDF文档(不使用DocuSign模板)和签名占位符。

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

  3. 一个或多个客户签署文档(使用嵌入式签名页面)。

  4. 最后一位签名者(我们的员工)签署文件(也使用嵌入式签名页)。

  5. 员工签名者可以是几个员工中的一个,但无论是谁,他们都会在文档上签署相同的位置。我们希望能够延迟选择哪个员工签署文档直到流程结束,而不必在创建信封时指定它们。

    信封处于正在处理状态后,我可以添加和删除员工收件人,但我也无法找到包含其选项卡的方法。我在请求中包含选项卡,但添加的员工始终处于草稿状的“已创建”状态,没有选项卡。嵌入视图仍然要求查看者手动放置其标签。我需要将标签放置并锁定在文档上,以便员工签名。

    我们正在使用REST API,这需要是一个自动化解决方案(无需手动修改信封)。有没有办法实现这个或类似的东西?

    这是我的添加收件人请求

    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,
        }
    ]
    }
    

    (我也尝试过使用PUT而不是POST的相同请求。结果是一样的)

2 个答案:

答案 0 :(得分:2)

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

  1. 使用“拦截器收件人”创建信封
  2. 识别后添加其他收件人
  3. 将标签添加到新收件人
  4. 如果希望在
  5. 上发送文档,请删除“拦截器收件人”

    我假设你有1.照顾,我会仔细阅读2-4的例子。

    2。创建其他收件人

    POST: https://demo.docusign.net/restapi/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients
    
    {
        "signers": [
            {
                "email": "email@domain.com",
                "name": "Andrew Wilson",
                "recipientId": "3",
                "defaultRecipient": "true",
                "routingOrder": "3"
            }
        ]
    }
    

    3。将标签添加到收件人

    POST: https://demo.docusign.net/restapi/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/tabs
    
    {
        "signHereTabs": [
            {
                "xPosition": "100",
                "yPosition": "200",
                "documentId": "1",
                "pageNumber": "1"
            },
            {
                "xPosition": "200",
                "yPosition": "200",
                "documentId": "1",
                "pageNumber": "1"
            }
        ]
    }
    

    4。删除拦截器收件人

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

答案 1 :(得分:0)

听起来您正在尝试修改或更正并重新发送收件人信息。

https://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf Page 137

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

这使您可以修改草稿信封中的收件人或更正正在处理的信封的收件人信息。对于草稿信封,您可以编辑:email,userName,routingOrder,faxNumber,deliveryMethod,accessCode和requireIdLookup。发送信封后,您只能编辑:email,userName,signerName,routingOrder,faxNumber和deliveryMethod。您还可以选择使用resend_envelope选项重新发送信封。

示例请求:

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

<强>响应

如果更正成功,则返回响应。以下示例显示响应json正文。

响应示例:

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