Удаление вкладок документов в DocuSign с помощью API

#javascript #docusignapi #netsuite #suitescript2.0

Вопрос:

Я настраиваю интеграцию с DocuSign в NetSuite для удаления определенных вкладок в документе на основе выбора пользователя, чтобы, когда подписавший получает документ для подписи, не оставалось заполненных пустых вкладок, которые не применимы к ситуации и вызывают путаницу. Однако представляется довольно неясным, как этого добиться. Я просмотрел документацию для того, что кажется необходимой конечной точкой API здесь:

https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopedocumenttabs/delete/

Это указывает на вызов с помощью команды УДАЛЕНИЯ, но также, похоже, говорит о том, что должны быть включены данные POST, даже если данные POST с вызовом УДАЛЕНИЯ не поддерживаются в SuiteScript (или на большинстве платформ в целом).

Было бы лучше, если бы вместо этого я попытался обновить выбранные вкладки? Используя ссылку на эту конечную точку и пытаясь либо заблокировать, скрыть и/или уменьшить эти вкладки?

https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopedocumenttabs/update/

Ответ №1:

Я бы на самом деле рекомендовал использовать https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/enveloperecipienttabs/update/ если у вас есть идентификатор получателя для конкретного получателя, для которого вы хотите удалить вкладки. И при использовании этого вы должны указать нужные вкладки, даже те, которые вы не удалили. По сути, вы переопределяете список вкладок для этого получателя.

Обратите внимание, что конечная точка DEL для вкладок удаляет все вкладки, а не только конкретную вкладку, поэтому это не будет делать то, что вам нужно.

Комментарии:

1. А, ладно. Это приятно знать. Немного объясняет документацию, учитывая, что они не упоминали об этом из того, что я мог видеть. Каковы же тогда рекомендуемые метаданные для «удаления» вкладок? Запереть их? Уменьшить высоту и ширину до нуля? И то, и другое? Что-то еще?

2. вы просто не включаете их, никаких данных или метаданных. Вы просто включаете все вкладки, которые хотите иметь, вы не говорите, что хотите удалить, вы просто удаляете это.

3. Ах! Отлично. Спасибо. Я попробую это сделать.

4. Если это сработает — пожалуйста, отметьте это как ответ. Огромное спасибо!

5. Это, похоже, приведет меня к тому, где мне нужно быть с этим, а также к некоторому творческому редактированию перед отправкой запроса на создание первоначального документа. Спасибо!

Ответ №2:

Это определенно наша ошибка. Конечные точки УДАЛЕНИЯ не должны иметь тел запросов.

Мы приведем его в порядок, как только сможем. Спасибо, что дали нам знать.