Уведомления о событиях Docusign

Question

Я реализую прослушиватель для уведомлений о событиях Docusign. Для каждого нового события Docusign отправляет новый xml-сериализованный объект DosuSignEnvelopeInformation. Мой вопрос в том, включает ли этот объект только новые измененные статусы или если, например, один из статуса получателей не изменился, он все равно будет включен. Кроме того, поскольку изменение статуса одного из получателей не обязательно изменяет статус конверта, будет ли уведомление всегда включать статус конверта?

Answer 1

Я рекомендую взглянуть на XSD: https://www.docusign.net/api/3.0/schema/dsx.xsd

Тип посланный Коннект DocuSignEnvelopeInformation, который состоит из EnvelopeStatus и DocumentPDF объектов, оба из которых имеют свои схемы определены в этом XSD. Короче говоря, соединение XML представляет собой моментальный снимок конверта во время отправки уведомления о вас - моментальный снимок будет содержать всю информацию о получателе.

В среде песочницы вы можете включить тестовую конфигурацию DS Connect с включенным протоколированием, чтобы узнать, какие типы сообщений вы будете получать.

Answer 2

Абсолютно правильно и имейте в виду, что для экономии места в демонстрационной среде мы не включаем поток байтов PDF в журнал, поскольку он не имеет логики, а это всего лишь куча байтов. Если вы хотите его увидеть, вы можете использовать webhook.com (бесплатно) или какой-нибудь другой инструмент.

Answer 3

Служба Connect и связанный с ней узел eventNotification в API управляются событиями. Они не публикуют события, а скорее текущий статус конверта, который включает статус конверта, статус получателя для всех получателей и т. Д. Служба всегда публикует текущий статус, поэтому два события «рядом» могут инициировать одно совместное опубликование статуса или две закрытые публикации. Однако последняя публикация будет содержать последние изменения. Если вы получаете «переизданный» статус (например, из-за неудачного подтверждения или прямого срабатывания), он снова является текущим статусом, а не «старым» статусом на момент публикации оригинала.