Docusign: API REST: BulkSendRecipients с использованием CSV / Text

Question

Мне нужно заполнить некоторые поля в нашем fillabe .pdf, применить к нему наш шаблон Docusign и выполнить массовую отправку для 2 ролей, поэтому вот мой подход:

1 - я создаю черновой конверт из предварительно заполненный .pdf и я использую шаблон при создании конверта:

POST "https://demo.docusign.net/restapi/v2.1/accounts/ {accountId} / envelopes"

Тело:

{
"status": "created",
"documents": [{
"documentId": "documentId_placeholder",
"name": "RaymondJames_prefilled.pdf",
"documentBase64": "lcDocumentBase64",
"transformPdfFields": "true"
}],
"templateId": "TemplateID_placeholder",
"templateRoles":
[
{
"roleName": "RecipientNo1RoleName_placeholder",
"isBulkRecipient": "true",
"name":"Name_placeholder",
"email":"Email_placeholder",
"emailSubject": "EmailSubject_placeholder",
"tabs":{
"textTabs":[
{

"tabLabel":"First Name",
"value": "FirstName_placeholder"
},
{

"tabLabel":"managertext",
"value": "ManagerText_placeholder"
}
]
}
},
]
}

2- Затем я загружаю основной CSV-файл в конверт bulk_recipients:

PUT "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/"+{envelopeId}+"/recipients/"+{recipientId}+"/bulk_recipients"

Тело:

"Имя, электронная почта, Тема сообщения, managertext, Домашний телефон, Имя John S. ,test1@test1.com, Пожалуйста, измените форму и подпись, Manager # 1,888-111-1111, JS_firstname Mary S. ,test2@test2.com, Пожалуйста, измените форму и подпись, Manager # 2,888 -111-1111, MS_firstname "

3- Затем я изменяю статус конверта на" Отправлено "и отправляю конверт групповым получателям.

Вышеприведенное работает, но как только имя файла CSV изменяется с Name на Role1 :: Name (как указано в документации), оно ищет поле «Name» и не принимает роли на всех. поэтому для добавления ролей я пробовал другую конечную точку, но никто не мог сделать то, что мне нужно, для добавления предварительно заполненных шаблонов pdf + docusign и добавленных файлов docusign + bulk_recipients.

Буду признателен за помощь в этом.
Спасибо,
Кэти

Answer 1

для шага # 2 вы не используете CSV, но JSON

вот пример JSON

{
    "name": "sample.csv",
    "bulkCopies": [{
        "recipients": [{
            "recipientId": "39542944",
            "role": "signer",
            "tabs": [],
            "name": "Alice UserName",
            "email": "alice.username@example.com"
        },
        {
            "recipientId": "84754526",
            "role": "cc",
            "tabs": [],
            "name": "Bob CarbonCopied",
            "email": "bob.carboncopy@example.com"
        }],
        "customFields": []
    },
{
        "recipients": [{
            "recipientId": "39542944",
            "role": "signer",
            "tabs": [],
            "name": "Carol NextUser",
            "email": "carol.nextuser@example.com"
        },
        {
            "recipientId": "84754526",
            "role": "cc",
            "tabs": [],
            "name": "Dave NextCarbon",
            "email": "dave.nextcarbon@example.com"
        }],
        "customFields": []
    }]

Полный пример кода, показывающий, как использовать Bulk Отправьте go на: https://developers.docusign.com/esign-rest-api/code-examples/bulk-sending-envelopes