Docusign не позволяет мне добавлять получателей в шаблоны

Question

Я создал шаблон в пользовательском интерфейсе и загрузил документ.Затем я добавил получателя из пользовательского интерфейса и сопоставил несколько полей в документе.

Я хочу создать конверт на основе этого шаблона и заполнить некоторые поля перед отправкой для подписи.Идея в том, что у нас есть портал, где пользователь может заполнить форму и отправить ему документ для подписи.

Просмотр документов .Я должен отправить и заполнить его так:

{
    ...
    "templateId": "68a89cdc-xxxx-xxxx-xxxx-fa2ab60713e3",
    "recipients": {
        "signers": [
            {
                ...
                "name": "Example Name",
                "email": "examplename@example.com", 
                "roleName": "Signer One",
            }
        ]
    ...
    },

...
}

Это, однако, возвращает мне ошибку:

Status: 400  INVALID_REQUEST_PARAMETER: The request contained at least one invalid parameter. 'recipients' may not be specifed when 'templateId' is set. Use 'templateRoles'.

Я продолжил использовать templateRoles, как было предложено:

{
    "accountId": "301424",
    "emailSubject": "API Example - Populating Data in Templates",
    "templateId": "44D9E888-xxxx-xxxx-xxxx-7071BC87A0DA",
    "templateRoles": [{
        "email": "john.doe@email.com",
        "name": "John Doe",
        "roleName": "Customer",
        "tabs": {
            "textTabs": [{
                "tabLabel": "CustomerAddress",
                "value": "123 Main St. San Francisco, CA 94105"
            }, 
            {
                "tabLabel": "CustomerSSN",
                "value": "12-345-6789"
            }]
        }
    }],
    "status": "sent"
}

Но это не заполнило ни одно из полей данными, которые я предоставил.

Что мне здесь не хватает?

Answer 1

Я недавно столкнулся с этой проблемой и завел их команду поддержки. Документы, использующие templateId и Recipients, в основном неверны. Это всегда будет неудачей. Я думаю, что они скоро это изменят.

{
    "accountId": "301424",
    "emailSubject": "API Example - Populating Data in Templates",
    "templateId": "44D9E888-xxxx-xxxx-xxxx-7071BC87A0DA",
    "templateRoles": [{
        "email": "john.doe@email.com",
        "name": "John Doe",
        "roleName": "Customer",
        "tabs": {
            "textTabs": [{
                "tabLabel": "CustomerAddress",
                "value": "123 Main St. San Francisco, CA 94105"
            }, 
            {
                "tabLabel": "CustomerSSN",
                "value": "12-345-6789"
            }]
        }
    }],
    "status": "sent"
}

Я создал шаблон в пользовательском интерфейсе и загрузил документ. Затем я добавил Получатель из пользовательского интерфейса и сопоставил несколько полей в документе.

По-видимому, вы можете указать пустого получателя имя и электронная почта , несмотря на то, что в пользовательском интерфейсе в поле ввода отображается красная звездочка, как будто это и требуется.

Вам нужно только определить поле роли, и все готово. Так что в этом примере в вашем шаблоне (из пользовательского интерфейса):

И тебе надо идти.

Answer 2

Ваш JSON выглядит довольно хорошо для меня.

Вам не нужны атрибуты accountId или emailSubject, и я бы порекомендовал вам их опустить.

Перепроверьтечто ваши tabLabel значения точные совпадают с настройкой метки данных пользовательского интерфейса.

В качестве теста вы также можете загрузить шаблон с помощью API.См. Templates :: get

Вот пример PHP-кода , который устанавливает значения вкладок шаблона.