DocuSign :: 如何使用 Template :: templateRoles 使用 PHP 发送 CarbonCopy？

Question

任何一个...

我目前正在研究文档签名和抄送功能。 我尝试了几种方法，但都失败了。

我是从 php 执行此操作的，请注意，我只使用签名者创建模板没有问题。我无法使用 CarbonCopy 功能。

这是我要传递给docusign的现有数组：

[ Array
(
    [0] => EnvelopeDealerListController::generateTemplateData
    [1] => Array
    (
        [accountId] => *****
        [emailSubject] => Document
        [emailBlurb] => Some Random Text
        [templateId] => 3C38D406-718D-4FF5-BA3A-05F58B3C0B7A
        [status] => sent
        [templateRoles] => Array
            (
                [0] => Array
                    (
                        [email] => johndoe@test.com
                        [name] => John Doe
                        [roleName] => Signer
                        [clientUserId] => 1
                        [RoutingOrder] => 1
                    )

                [1] => Array
                    (
                        [email] => janedoe@test.com
                        [name] => Jane Doe
                        [roleName] => Signer2
                        [clientUserId] => 2
                        [RoutingOrder] => 2


                    )

                [2] => Array
                    (
                        [email] => joedoe@test.com
                        [name] => Joe Doe
                        [roleName] => CarbonCopy
                        [clientUserId] => 3
                        [RoutingOrder] => 3
                    )
            )
    )
) ]

这是我尝试添加碳副本的列表：

1. 我尝试在与“templateRoles”相同的级别添加“carbonCopies”数组，但失败了。
2. 我尝试将“carbonCopies”作为“templateRoles”的子代，但失败了。
3. 我尝试在模板文档中创建抄送并分配角色名称“抄送1”，然后在模板角色中添加了一个角色名称抄送1的收件人，它也失败了。

您能否指出正确的方向，让我了解如何在无需收件人签名的情况下向用户添加 CarbonCopy 文档？

以下是我在研究此问题时查阅的参考页面： 一个。 http://www.docusign.com/p/RESTAPIGuide/RESTAPIGuide.htm#REST%20API%20References/Recipients/Carbon%20Copies%20Recipient.htm?Highlight=CarbonCopy

b. __0">http://www.docusign.com/p/RESTAPIGuide/RESTAPIGuide.htm#REST%20API%20References/Recipient%20Parameter.htm%3FTocPath%3DREST%20API%20References|Send%20an%20Envelope %20or%20Create%20a%20Draft%20Envelope|Recipient%20Parameters|__0

有没有人有一个完整的 php 示例，说明如何使用“templateRoles”创建带有签名者和副本的信封？

谢谢

Answer 1

我刚刚测试过，上班没有问题。这是我采取的步骤和我发送的请求正文。我可以通过两种方式添加抄送收件人 - 1）通过使用添加了抄送角色的模板 2）通过文档上的签名请求（不使用模板），我在其中即时添加抄送收件人。

要使用模板，请按以下步骤操作：

• 登录 DocuSign 控制台并创建一个具有 2 个签名角色和 1 个 CC 角色的模板。
• 分别将角色命名为“Signer”、“Signer2”和“CarbonCopy”并保存。
• 使用以下 JSON 请求正文通过 API 创建信封：

（确保输入特定于您帐户的值）

{
    "accountId": "221765",
    "emailSubject": "Carbon Copy Testing",
    "emailBlurb": "This comes from PHP",
    "templateId": "7D5CF173-3EA5-******************",
    "templateRoles": [
        {
            "email": "firstperson@gmail.com",
            "name": "John Doe",
            "roleName": "Signer"
        },
        {
            "email": "secondperson@gmail.com",
            "name": "Jane Doe",
            "roleName": "Signer2"
        },
        {
            "email": "thirdperson@gmail.com",
            "name": "Bob Doe",
            "roleName": "CarbonCopy"
        }
    ],
    "status": "sent"
}

---

另一方面，如果您想添加签名者和抄送收件人不使用模板，您可以使用以下 JSON 请求正文：

{
"emailBlurb": "This comes from PHP",
"emailSubject": "API Signature Request",
"documents": [
    {
        "documentId": "1",
        "name": "document.pdf"
    }
],
"recipients": {
    "signers": [
        {
            "email": "firstperson@gmail.com",
            "name": "John Doe",
            "recipientId": "1",
            "tabs": {
                "signHereTabs": [
                    {
                        "xPosition": "100",
                        "yPosition": "100",
                        "documentId": "1",
                        "pageNumber": "1"
                    }
                ]
            }
        }
    ],
    "carbonCopies": [
        {
            "email": "secondperson@gmail.com",
            "name": "Jane Doe",
            "recipientId": "2"
        }
    ]
},
"status": "sent"
}

有关从模板创建/发送信封的示例，请参阅 DocuSign API 演练 #1： http://iodocs.docusign.com/APIWalkthrough/requestSignatureFromTemplate

有关从文档创建/发送信封的示例，请参阅 DocuSign API 演练 #4： http://iodocs.docusign.com/APIWalkthrough/requestSignatureFromDocument