DocuSign API: Как обновить дату истечения срока действия конверта, находящегося в процессе обработки?

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

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

Зачем обновлять дату истечения срока действия конверта в процессе работы?

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

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

Пошаговое руководство: Обновление даты истечения срока действия через DocuSign API

Для решения этой проблемы разработчики обычно используют DocuSign eSignature REST API (версии 2.1 или выше), который требует аутентификации через OAuth 2.0 (JWT или авторизационный код). Предположим, у вас есть учетная запись разработчика с доступом к API; цены начинаются от 600 долларов США в год за план Starter, включая примерно 40 конвертов в месяц. Вот практическое руководство:

1. Получение статуса конверта

Сначала убедитесь, что конверт находится в процессе работы (статус: "sent" или "in progress"). Используйте конечную точку GET /accounts/{accountId}/envelopes/{envelopeId}.

Пример запроса (cURL):

curl -X GET "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}" \
-H "Authorization: Bearer {accessToken}" \
-H "Accept: application/json"

Фрагмент ответа:

{
  "status": "sent",
  "expireDateTime": "2025-01-15T12:00:00Z",
  "envelopeId": "abc123"
}

Это извлекает текущую дату истечения срока действия. Если статус "voided" или "completed", обновление невозможно - необходимо повторно создать конверт.

2. Исправление конверта (предпочтительный метод для незначительных изменений)

Для конвертов в процессе работы, с которыми еще не работали подписанты, используйте PUT /accounts/{accountId}/envelopes/{envelopeId} в сочетании с запросом на исправление. Хотя прямое редактирование отдельных полей для обновления даты истечения срока действия не поддерживается, вы можете аннулировать его и повторно отправить с новой датой или косвенно сбросить таймер с помощью функции "исправления".

API исправления DocuSign позволяет изменять определенные атрибуты, такие как дата истечения срока действия, если подпись не была поставлена. Подготовьте определение конверта исправления:

Тело запроса на исправление (JSON):

{
  "status": "sent",
  "expireAfter": "30",  // Дней с настоящего момента; настройте по мере необходимости (максимум 999 дней)
  "expireDateTime": "2025-02-15T12:00:00Z"  // Или укажите абсолютную дату
}

Пример cURL:

curl -X PUT "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/correct" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "clientUserId": "signer1",
  "routingOrder": "1",
  "corrector": {
    "email": "admin@company.com",
    "userId": "{userId}"
  },
  "envelopeDefinition": {
    "expireAfter": "60"
  }
}'

Это продлит дату истечения срока действия на 60 дней. Примечание: исправление требует, чтобы конверт был исправимым (без завершенных вкладок) и может уведомлять подписантов об изменениях, сохраняя при этом контрольный журнал.

3. Аннулирование и повторная отправка (для сложных обновлений)

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

Шаг 3a: Аннулирование конверта

curl -X PUT "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "status": "voided",
  "voidedReason": "Extending expiration for ongoing negotiations"
}'

Шаг 3b: Повторная отправка с новым определением Повторно создайте с помощью POST /accounts/{accountId}/envelopes, скопировав исходные документы и получателей, но установив новые expireAfter или expireDateTime.

Тело запроса нового конверта:

{
  "emailSubject": "Updated Agreement",
  "documents": [ /* Original docs */ ],
  "recipients": [ /* Original signers */ ],
  "expireAfter": "90",  // Новый срок истечения 90 дней
  "status": "sent"
}

cURL:

curl -X POST "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{ /* Полное определение конверта с обновленным сроком действия */ }'

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

• Квоты и затраты: Каждое аннулирование/повторная отправка учитывается в вашем лимите конвертов (около 100 в год на пользователя для плана Business Pro, цена 480 долларов США в год на пользователя). Используйте панели мониторинга через API, чтобы избежать превышения.
• Обработка ошибок: Распространенные проблемы включают 400 Bad Request (недопустимый статус) или 401 Unauthorized. Используйте try-catch в коде (например, Node.js или Python SDK).
• Безопасность: Все изменения регистрируются в контрольном журнале конверта, поддерживая функции IAM DocuSign, такие как SSO и расширенный контроль доступа в планах Enhanced.
• Тестирование: Среда песочницы (бесплатная для разработчиков) идеально подходит перед производством.

С коммерческой точки зрения этот процесс упрощает операции, но подчеркивает уровни цен API - план Advanced (5760 долларов США в год) разблокирует массовую отправку и веб-хуки для автоматизации, уменьшая ручное вмешательство.

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

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

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

Более широкая экосистема DocuSign и функции IAM

Платформа eSignature DocuSign, включая ее API, легко интегрируется с инструментами управления идентификацией и доступом (IAM) для повышения безопасности. IAM в DocuSign включает интеграцию SSO (например, с Okta или Azure AD), контроль доступа на основе ролей и многофакторную аутентификацию, которые имеют решающее значение для развертывания на уровне предприятия. Эти функции доступны в планах Enhanced (индивидуальное ценообразование для более чем 50 пользователей), гарантируя, что обновления, управляемые API, такие как изменения даты истечения срока действия, соответствуют глобальным стандартам, не раскрывая конфиденциальные данные. Цены варьируются от 120 долларов США в год за план Personal до пользовательских планов для предприятий, DocuSign подчеркивает масштабируемость, но дополнительные функции, такие как доставка SMS или проверка идентификации, могут повлечь за собой дополнительные расходы.

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

Рынок электронных подписей является конкурентным, DocuSign лидирует по глобальному внедрению, но региональные потребности стимулируют альтернативы. Ниже приведено ключевое нейтральное сравнение платформ на основе цен, функций и соответствия требованиям (данные за 2025 год; фактические значения могут отличаться).

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

Adobe Sign: Альтернатива, ориентированная на PDF

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

HelloSign: Простота для малого и среднего бизнеса

HelloSign (теперь Dropbox Sign) отдает приоритет удобному интерфейсу с быстрым созданием шаблонов и неограниченным количеством отправок на более высоких уровнях. Его API позволяет исправлять конверты, включая продление срока действия с помощью обновленных вызовов, но ему не хватает глубины DocuSign в массовых операциях. Начальная цена составляет 15 долларов США в месяц, что подходит для малого бизнеса, с акцентом на бесшовную синхронизацию с Dropbox, а не на корпоративное соответствие требованиям.

eSignGlobal: Лидер в области регионального соответствия требованиям

eSignGlobal позиционирует себя как глобальный конкурент, соответствующий требованиям в более чем 100 основных странах и регионах, с сильным присутствием в Азиатско-Тихоокеанском регионе. Нормативные акты в этом регионе фрагментированы, стандарты высоки, а надзор строг - в отличие от рамочных ESIGN/eIDAS в США/ЕС, Азиатско-Тихоокеанский регион требует решений "экосистемной интеграции". Это означает глубокую аппаратную/API интеграцию с государственными цифровыми удостоверениями (G2B), что выходит далеко за рамки проверки электронной почты или самозаявления, обычно встречающихся на Западе. eSignGlobal превосходит в этой области, легко интегрируя iAM Smart в Гонконге и Singpass в Сингапуре для юридически обязательных подписей.

Цены конкурентоспособны, а его план Essential стоит всего 16,6 долларов США в месяц при ежегодной оплате, что позволяет использовать до 100 документов с электронной подписью, неограниченное количество мест для пользователей и проверку кода доступа - и все это построено на основе соответствия требованиям. Эта модель без мест обеспечивает высокую ценность для команд и оснащена инструментами AI для оценки рисков и перевода. По мере расширения в США/ЕС eSignGlobal бросает вызов существующим игрокам, таким как DocuSign и Adobe Sign, за счет более низкой стоимости и более высокой производительности в Азиатско-Тихоокеанском регионе, включая массовую отправку без дополнительных планов для разработчиков.

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

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

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

Коммерческие идеи и заключительные мысли

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

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