Docusign добавляет заметку в шаблон и заполняет ее перед отправкой конверта

Question

Мне нужно ввести адрес подписывающей стороны в шаблоне docusign в качестве поля примечания и предварительно заполнить его при создании конверта и перед его отправкой. Спасибо за помощь.

вот мой код php:

$envelope_definition = new EnvelopeDefinition([
    'status' => 'sent', 'template_id' => $this->template_id
]);
# Create the template role elements to connect the signer and cc recipients
# to the template

$signer = new TemplateRole([
    'email'             => $args['signer_email'],
    'name'              => $args['signer_name'],
    'role_name'         => 'signer'
]);

$ address_note = new Note (['selected' => 'true', 'tab_label' => 'signer_address ',' value '=> $ args [' signer_address ']]); $ signer-> setTabs (новые вкладки ([$ address_note])); $ envelope_definition-> setTemplateRoles ([$ signer]);

и есть конфигурация поля примечания на панели инструментов docusign: поле примечания

Но проблема в том, что когда подписываю документ, я могу » t видеть адрес подписывающей стороны

Когда я пытаюсь найти вкладки в соответствующем шаблоне, используя этот код php:

# create the envelope definition with the template_id
    $envelope_definition = new EnvelopeDefinition([
        'status' => 'sent', 'template_id' => $this->template_id
    ]);
    # Create the template role elements to connect the signer and cc recipients
    # to the template

    $signer = new TemplateRole([
        'email'             => $args['signer_email'],
        'name'              => $args['signer_name'],
        'role_name'         => 'signer'
    ]);

    dd($signer->getTabs());

, я получил нулевой результат.

Answer 1

Спасибо за помощь, проблема решена, решение:

    $envelope_definition = new EnvelopeDefinition([
        'status' => 'sent', 'template_id' => $this->template_id
    ]);

    $address_note = new Note(['selected' => "true", 'tab_label' => 'signer_address', 'value' => $args['signer_address']]);
    $tabs = new Tabs(['note_tabs' => [$address_note]]);
    $signer = new TemplateRole([
        'email'             => $args['signer_email'],
        'name'              => $args['signer_name'],
        'role_name'         => 'signer',
        'tabs'              => $tabs
    ]);

Answer 2

Перед тем, как сделать запрос, убедитесь, что ваш шаблон содержит соответствующее поле примечания, которое вы хотите заполнить заранее. Вы можете сделать это, отправив запрос GET к /templates.

GET https://demo.docusign.net/restapi/v2.1/accounts/{account_ID}/templates/{template_ID}?include=recipients,tabs

Теперь, чтобы предварительно заполнить поле заметки физическим почтовым адресом для конкретного получателя, вы можете отправить запрос POST на / envelopes. Вы найдете tabLabel из предыдущего шага.

{
    "status": "sent",
    "templateId": "00df08bf-xxxx-xxxx-xxxx-ecaa2360c121",
    "templateRoles": [
        {
            "email": "test@test.com",
            "name": "ABC",
            "roleName": "signer",
            "routingOrder": "1",
            "tabs": {
                "noteTabs": [
                    {
                        "selected": "true",
                        "tabLabel": "userAddress",
                        "value": "theUsersAddressGoesHere"
                    }
                ]
            }
        },
        {
            "email": "test2@test.com",
            "name": "EFG",
            "roleName": "cc",
            "routingOrder": "2"
        }
    ]
}

Если вы не можете увидеть значение поля примечания при подписании, вам может потребоваться изменить размер ограничивающей рамки. Вы можете сделать это, отредактировав шаблон в пользовательском интерфейсе или добавив свойства X / Y в свой запрос.