DocuSign API: Получение списка всех получателей конверта, которые еще не подписали его

Навигация по DocuSign API для управления конвертами

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

Понимание DocuSign API и получателей конвертов

eSignature API от DocuSign предоставляет конечные точки для управления конвертами, которые по сути являются контейнерами для документов, требующих подписи. Конверт может иметь несколько получателей, каждый из которых имеет роль, такую как подписывающий, утверждающий или получатель копии. API использует RESTful архитектуру, поддерживает JSON-загрузки и требует аутентификации через OAuth 2.0 или JWT.

Чтобы перечислить всех получателей конверта, которые еще не подписали его, разработчики обычно запрашивают статус конверта и детали получателей. Ключевой конечной точкой является GET /accounts/{accountId}/envelopes/{envelopeId}/recipients в Envelopes API. Это вернет полный список получателей, включая их статус (например, "sent", "declined", "signed" или "needs_to_sign").

Ниже приведено пошаговое руководство по реализации этой функции:

1. Настройка аутентификации: Используйте песочницу разработчика DocuSign для получения токена доступа. Для производственной среды интегрируйтесь с системой IAM (управление идентификацией и доступом) вашего приложения. Функции IAM DocuSign являются частью его расширенной программы, включая интеграцию SSO с такими провайдерами, как Okta или Azure AD, обеспечивая безопасный доступ к API без раскрытия учетных данных.

2. Получение деталей конверта: Сначала получите конверт, используя GET /envelopes/{envelopeId}. Это подтвердит статус конверта (например, "sent" или "in_progress") и предоставит метаданные, такие как дата создания и срок действия.

3. Запрос получателей: Вызовите конечную точку получателей. Ответ включает массив объектов получателей, каждый из которых содержит:

   • id: Уникальный идентификатор.
   • email: Электронная почта получателя.
   • status: Текущий статус (отфильтруйте "sent" или "needs_to_sign", чтобы идентифицировать неподписанных получателей).
   • routingOrder: Порядок в процессе подписи.
   • name: Имя получателя.

   Пример фрагмента JSON из ответа API:

   {
     "recipients": {
       "signers": [
         {
           "email": "john.doe@example.com",
           "status": "sent",
           "name": "John Doe",
           "signedDateTime": null
         },
         {
           "email": "jane.smith@example.com",
           "status": "signed",
           "name": "Jane Smith",
           "signedDateTime": "2025-01-15T10:00:00Z"
         }
       ]
     }
   }
   

4. Фильтрация неподписанных получателей: В вашем коде (например, с использованием Python с библиотекой requests или Node.js с использованием Axios) проанализируйте ответ и отфильтруйте случаи, когда status != "signed" и signedDateTime равен null. Для пакетных операций используйте конечную точку GET /envelopes с параметрами запроса, такими как status=sent, чтобы перечислить несколько конвертов.

   Пример кода на Python:

   import requests
   
   access_token = "your_access_token"
   account_id = "your_account_id"
   envelope_id = "your_envelope_id"
   base_url = "https://demo.docusign.net/restapi"
   
   headers = {
       "Authorization": f"Bearer {access_token}",
       "Accept": "application/json"
   }
   
   response = requests.get(
       f"{base_url}/v2.1/accounts/{account_id}/envelopes/{envelope_id}/recipients",
       headers=headers
   )
   
   if response.status_code == 200:
       data = response.json()
       unsigned_recipients = [
           r for r in data.get('recipients', {}).get('signers', [])
           if r.get('status') != 'signed' and r.get('signedDateTime') is None
       ]
       print("Unsigned recipients:", unsigned_recipients)
   

5. Обработка ошибок и лучшие практики: Обрабатывайте ограничения скорости (например, 1000 вызовов API в минуту) и ошибки, такие как 404 (конверт не найден). Для корпоративных пользователей используйте расширенные планы API DocuSign, которые включают веб-хуки Connect API для обновления статуса в реальном времени. Это позволяет избежать опроса и уменьшить количество вызовов API.

Этот подход гарантирует, что вы можете программно уведомлять неподписанных получателей, эскалировать задержки или интегрироваться с CRM-системами, такими как Salesforce. В коммерческой среде такая автоматизация может сократить ручное отслеживание до 70% в соответствии с отраслевыми показателями ресурсов для разработчиков DocuSign.

Цены на API DocuSign начинаются с 600 долларов США в год за план Starter (40 конвертов в месяц) и расширяются до пользовательских корпоративных вариантов. Для команд в регулируемых отраслях объединение этого с функциями IAM, такими как расширенное отслеживание аудита и доступ на основе ролей, может повысить соответствие требованиям без пользовательской разработки.

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

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

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

Изучение экосистемы DocuSign и функций IAM

DocuSign выходит за рамки базовой подписи, предлагая интегрированные инструменты, такие как CLM (управление жизненным циклом контрактов) в своем пакете Intelligent Agreement Management (IAM). IAM CLM автоматизирует создание, согласование и исполнение контрактов, извлекая данные из конвертов для отслеживания обязательств. Для пользователей API он поддерживает встраивание церемоний подписи и извлечение данных о неподписанных получателях на панели мониторинга.

На практике предприятия используют IAM для сквозной видимости: ввод неподписанных получателей конверта вызывает оповещения о рисках или рабочие процессы утверждения. Цены на обновления IAM являются индивидуальными и обычно связаны с планом Business Pro, 480 долларов США в год на пользователя, добавляя функции управления и аналитики.

Конкурентная среда: нейтральное сравнение

Рынок электронных подписей является конкурентным, и платформы различаются по глубине API, ценообразованию и региональному соответствию требованиям. Ниже приведена таблица сравнения Markdown ключевых игроков с упором на API-функции управления получателями, основное ценообразование и преимущества. Данные взяты из общедоступных источников в 2025 году для обеспечения нейтральности.

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

Adobe Sign: обзор интеграции и API

Adobe Sign, часть Adobe Document Cloud, делает акцент на процессах, ориентированных на PDF. Его API аналогичен DocuSign в отслеживании получателей, используя GET /agreements/{agreementId}/participants для перечисления неподписавших сторон. Он подходит для творческих отраслей, имея встроенные функции редактирования PDF. Цены начинаются с 10 долларов США в месяц за индивидуальный план и расширяются до индивидуальных корпоративных тарифов. Преимущество Adobe заключается в бесшовной интеграции с Acrobat и маркетинговыми инструментами, но квоты API могут быть ограничивающими для использования с большим объемом данных.

HelloSign (Dropbox Sign): простота для SMB

HelloSign, теперь Dropbox Sign, предлагает простой API для управления конвертами. Неподписанные получатели извлекаются через GET /v3/signature_request/{request_id}, фильтруя по статусу. Он известен своей простотой использования, имеет встроенные шаблоны и функции напоминаний. План Essentials за 180 долларов США в год является бюджетным для небольших команд, хотя ему не хватает расширенных IAM DocuSign.

eSignGlobal: альтернатива, оптимизированная для APAC

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

API платформы включает запросы статуса получателей, аналогичные DocuSign, с поддержкой массовой отправки и веб-хуков в плане Professional. Цены конкурентоспособны: версия Essential стоит всего 16,6 долларов США в месяц (эквивалентно 199 долларам США в год в некоторых акциях), что позволяет использовать до 100 подписанных документов, неограниченное количество мест для пользователей и проверку кода доступа, сохраняя при этом соответствие требованиям. Он легко интегрируется с iAM Smart в Гонконге и Singpass в Сингапуре, что подходит для трансграничных операций в APAC.

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

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

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

Коммерческое влияние и рекомендации

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