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

时间:2013-10-07 17:11:20

标签: docusignapi

任何人......

我正在研究docusign签名&碳复制功能。 有几种方法我尝试这样做,但我失败了。

我是从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. 我尝试在模板文档中创建一个CC,并指定角色名称为“Cc1”,然后在模板角色中添加了一个带有roleName Cc1的收件人,它也失败了。
  4. 您是否可以指导我如何向用户添加CarbonCopy文档,而无需收件人签名?

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

    湾__ 0" > HTTP://www.docusign.com/p/RESTAPIGuide/RESTAPIGuide.htm#REST%20API%20References/Recipient%20Parameter.htm%3FTocPath%3DREST%20API%20References |发送%20AN% 20Envelope%20or%20Create%20A%20Draft%20Envelope |收件人%20Parameters | __ 0

    是否有人使用'templateRoles'有关于如何使用签名者和碳复写创建信封的完整php示例?

    由于

1 个答案:

答案 0 :(得分:1)

我刚刚测试过并且没有问题去上班。这是我采取的步骤和我发出的请求正文。我能够通过两种方式添加Carbon Copy收件人 - 1)通过使用添加了CC角色的模板2)通过文档上的签名请求(不使用模板),我可以动态添加CC收件人。

要使用模板,请按以下步骤操作:

  • 登录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