DocuSign API: Удаление получателя из отправленного конверта

Навигация по DocuSign API: Управление получателями в отправленных конвертах

В быстро меняющемся мире цифровых транзакций платформы электронных подписей, такие как DocuSign, стали незаменимым инструментом для предприятий, стремящихся оптимизировать рабочие процессы, связанные с контрактами. DocuSign API выступает в качестве мощного инструмента для разработчиков, позволяя беспрепятственно интегрироваться в пользовательские приложения, автоматизируя создание, отправку и управление конвертами. Однако распространенная проблема возникает, когда необходимо удалить получателя из конверта — термин DocuSign для пакета документов, подготовленных для подписи — после его отправки из-за ошибок, изменений в условиях транзакции или обновлений соответствия требованиям. Этот сценарий проверяет пределы гибкости API и подчеркивает важность надежной обработки ошибок в процессах электронной подписи.

Сравнение платформ электронных подписей с DocuSign или Adobe Sign?

eSignGlobal предлагает более гибкое и экономичное решение для электронных подписей с глобальным соответствием требованиям, прозрачным ценообразованием и более быстрой адаптацией.

👉 Начать бесплатную пробную версию

Понимание проблем удаления в DocuSign API

В экосистеме DocuSign удаление получателя из отправленного конверта не является простым, в основном потому, что как только конверт находится в процессе передачи, он предназначен для поддержания контрольного журнала и юридической целостности. С точки зрения бизнеса, это ограничение предотвращает несанкционированные изменения, которые могут привести к аннулированию подписей или подвергнуть компанию спорам. API обеспечивает это посредством проверок состояния: конверты в состоянии «sent» (отправлено) блокируются для сохранения цепочки хранения, что является основным принципом стандартов электронной подписи, таких как Закон ESIGN США или eIDAS ЕС.

Попытка прямого удаления через API обычно приводит к ошибкам, таким как «ENVELOPE_IS_SENT» или «Невозможно изменить получателей после отправки». Это сделано намеренно и отражает приверженность DocuSign соответствию требованиям. Предприятия часто сталкиваются с этим в операциях с большим объемом, таких как массовые рассылки в конвейерах продаж, где списки получателей могут нуждаться в быстрых исправлениях. Без надлежащей обработки это может привести к узким местам в рабочих процессах, увеличению ручного вмешательства и потенциальным задержкам в получении дохода.

Пошаговое руководство по удалению получателей после отправки

Чтобы решить эту проблему, DocuSign предоставляет обходные пути через API, ориентированные на исправление, а не на прямое удаление. Основной подход включает использование функции «Correct» (Исправить), которая создает новую версию конверта, аннулируя исходную или косвенно обновляя получателей. Это поддерживает соответствие требованиям, регистрируя все изменения. Вот как это можно реализовать с помощью DocuSign eSignature REST API (версия 2.1), предполагая, что у вас настроены учетные данные API.

Предварительные условия

• Получите токен API через OAuth (процессы авторизации JWT или Auth Code).
• Определите идентификатор конверта из отправленного конверта (доступен через GET /envelopes/{envelopeId}).
• Убедитесь, что у вашей учетной записи есть разрешения на исправление конвертов (доступно в планах Business Pro и выше).

Рабочий процесс API

1. Получение статуса конверта: Сначала подтвердите, что конверт находится в состоянии «sent» (отправлено).

   GET https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}
   

   Ответ включает status: "sent" и детали получателя.

2. Аннулирование исходного конверта (если необходимо): Если удаление имеет решающее значение и подпись еще не началась, аннулируйте конверт, чтобы остановить все действия.

   PUT https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}
   Body: {
     "status": "voided",
     "voidedReason": "Требуется исправление получателя"
   }
   

   Это останавливает процесс, не удаляя данные, сохраняя таким образом журнал аудита.

3. Создание исправленного конверта: Используйте конечную точку «Correct» (Исправить) для создания новой версии. Это позволяет удалить получателей, исключив их из нового списка получателей.

   POST https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/correct
   Body: {
     "envelopeReassign": false,
     "notifyUser": true
   }
   

   Затем обновите получателей с помощью последующего PUT к /envelopes/{envelopeId}/recipients.

   • В теле перечислите только нужных получателей, исключив того, кого нужно «удалить».
   • Пример фрагмента JSON:

     {
       "recipients": {
         "signers": [
           {
             "email": "remaining@signer.com",
             "name": "John Doe",
             "recipientId": "1",
             "routingOrder": "1"
           }
         ]
       }
     }
     

   Повторно отправьте исправленный конверт со status: "sent".

4. Обработка крайних случаев: Если получатель уже подписал, исправление может не удалить его — DocuSign отдает приоритет завершенным действиям. В этом случае используйте API «Decline» (Отклонить) для этого получателя или создайте совершенно новый конверт. Для массовых сценариев используйте Bulk Send API (функция расширенного плана), чтобы заранее избежать ошибок.

Лучшие практики и ограничения

• Тестирование: Всегда используйте Demo Environment (demo.docusign.net) перед использованием Production Environment.
• Квоты: Исправления учитываются в лимитах конвертов (например, 100 в год для стандартных планов).
• Обработка ошибок: Реализуйте try-catch для ответов API; распространенные проблемы включают недостаточные разрешения или истекшие токены.
• Соответствие требованиям: Эти операции генерируют неизменяемые события аудита, что имеет решающее значение для таких правил, как GDPR или HIPAA.

С точки зрения бизнеса, освоение этого процесса API может сэкономить значительное время — предприятия сообщают о сокращении времени цикла управления контрактами до 30%. Однако для сред с высоким риском интеграция с инструментами управления идентификацией и доступом (IAM) DocuSign может добавить уровень проверки для минимизации ошибок перед отправкой.

Обзор экосистемы продуктов DocuSign

Набор DocuSign выходит за рамки базовой электронной подписи. Платформа eSignature обрабатывает подписание основных документов, а API обеспечивает пользовательскую интеграцию. Для расширенных потребностей DocuSign IAM предоставляет надежную аутентификацию, включая SSO, многофакторную аутентификацию и биометрические проверки — это важно для регулируемых отраслей. Управление жизненным циклом контрактов (CLM) интегрирует отслеживание переговоров на основе искусственного интеллекта и управление репозиториями, оптимизируя процессы от черновика до архивирования. Цены начинаются с 10 долларов в месяц для личных планов и расширяются до пользовательских корпоративных версий с интенсивным использованием API, с дополнительными функциями, такими как доставка SMS, оплачиваемая за сообщение.

Конкурентная среда: Сравнение платформ электронных подписей

Рынок электронных подписей является конкурентным, такие игроки, как Adobe Sign, HelloSign (теперь Dropbox Sign) и eSignGlobal, борются за долю рынка. Каждая платформа предлагает API-функции для управления получателями, но подходы различаются по гибкости, стоимости и региональной направленности. Например, Adobe Sign делает упор на бесшовную интеграцию с набором Adobe Creative Suite и инструментами PDF, что делает его подходящим для рабочих процессов с интенсивным использованием документов. Его API поддерживает аналогичные механизмы исправления, но превосходит автоматизацию корпоративного уровня, цены начинаются с 10 долларов в месяц на пользователя для отдельных лиц.

HelloSign, приобретенный Dropbox, отдает приоритет простоте, предлагая удобный API для исправления конвертов, часто с более низкой начальной стоимостью (15 долларов в месяц для базовой версии). Он популярен среди малых и средних предприятий, которым требуется быстрая настройка без глубокой настройки.

Чтобы помочь в принятии решений, ниже приведена нейтральная сравнительная таблица, основанная на ключевых бизнес-факторах (цены 2025 года, оплата за год, регион США):

Эта таблица подчеркивает компромиссы: DocuSign превосходит по зрелости, в то время как альтернативы предлагают преимущества в стоимости или нише.

eSignGlobal: Региональный конкурент с глобальным охватом

eSignGlobal позиционирует себя как альтернатива, соответствующая требованиям, поддерживающая электронные подписи в более чем 100 основных странах и регионах по всему миру. Он особенно силен в Азиатско-Тихоокеанском регионе (APAC), где правила электронной подписи фрагментированы, имеют высокие стандарты и строго регулируются — в отличие от более основанных на рамках стандартов ESIGN/eIDAS в США и ЕС. Требования APAC к соответствию требованиям «экосистемной интеграции» требуют глубокого аппаратного и API-уровня взаимодействия с цифровыми удостоверениями правительства для бизнеса (G2B), что намного превышает технические барьеры обычной проверки электронной почты или самодекларации, распространенной на Западе.

Например, eSignGlobal беспрепятственно интегрируется с iAM Smart в Гонконге и Singpass в Сингапуре, обеспечивая юридическую силу на этих рынках. Цены конкурентоспособны, его план Essential стоит всего 16,6 долларов в месяц (оплата за год), что позволяет использовать до 100 документов для подписи, неограниченное количество мест для пользователей и проверку кода доступа — и все это построено на основе соответствия требованиям. Это делает его очень экономичным для растущих команд, ниже модели DocuSign по количеству мест, и напрямую конкурирует с Adobe Sign в планах глобальной экспансии.

Ищете более разумную альтернативу DocuSign?

eSignGlobal предлагает более гибкое и экономичное решение для электронных подписей с глобальным соответствием требованиям, прозрачным ценообразованием и более быстрой адаптацией.

👉 Начать бесплатную пробную версию

Заключительные мысли о выборе электронной подписи

При оценке решений DocuSign API для управления получателями предприятия должны сопоставлять надежность API с операционными потребностями. Для глобальных предприятий DocuSign остается эталоном. По мере того, как альтернативы набирают обороты, eSignGlobal выделяется как нейтральный вариант, соответствующий региональным требованиям, который стоит рассмотреть для операций, ориентированных на APAC.