SOAP API - удаление получателя

Question

Похоже, мы можем удалить получателя в REST API, но есть ли метод в SOAP API, который позволит удалить получателей?

В настоящее время мы вызываем CreateEnvelopeFromTemplatesAndForms() из SOAP API для создания конверта. Шаблон может иметь несколько получателей, а некоторые из них могут быть необязательными. Прежде чем мы сможем отправить конверт, установив ActivateEnvelope в true или вызывая SendEnvelope(), похоже, что вся информация получателей (то есть имя, адрес электронной почты и т. Д.) Должна быть заполнена, иначе звонок вызовет ошибку «... адрес электронной почты является недействительным...". Поэтому мы хотели бы удалить необязательных получателей, когда они не нужны.

Можем ли мы как-то определить InlineTemplate для вызова CreateEnvelopeFromTemplatesAndForms() для удаления получателей?

Мы также посмотрели CorrectAndResendEnvelope(), похоже, что мы можем редактировать информацию получателя, но не удалять.

Заранее благодарен!

Answer 1

Нет, для удаления получателей не существует эквивалента SOAP. Это одна из причин, по которой API REST DocuSign поощряется в отношении SOAP API, и этот разрыв функции растет с каждым ежемесячным выпуском.

Три обходные пути я могу думать:

1. Используйте тип получателя, как редактор или Агентом редактировать данные получателя после того, как конверт был отправлен.
2. Вместо удаления дополнительных получателей, добавьте их позже, если необходимо.
3. Используйте REST для удаления ваших дополнительных получателей.

Для # 1 существуют такие типы получателей, как Editor, Agent или Manage Recipients, которые позволяют редактировать информацию получателей получателей, которые позже находятся в routingOrder.

Для # 2 вместо добавления получателей в начале добавьте только требуемых получателей, а затем, если будет принято решение о необходимости дополнительных, добавьте их через Корректировку/Дополнение Получателя.

Для # 3 приятно, что вы можете смешивать API-интерфейсы и совершать некоторые вызовы в SOAP и других в REST. Единственное, что вам нужно сделать, это написать код для отправки запроса REST и разобрать ответ.