DocuSign API: Как добавить получателя "Carbon Copy" после отправки?

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

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

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

Основы управления получателями в DocuSign API

Прежде чем добавлять получателей CC после отправки, важно понимать жизненный цикл конверта DocuSign. Конверт представляет собой пакет документов, и как только он "отправлен", он находится в активном состоянии, когда изменения ограничены для защиты опыта подписывающего и юридической целостности. eSignature REST API (v2.1) управляет этими взаимодействиями, требуя аутентификации через JWT или OAuth для безопасного доступа.

Ключевые концепции:

• Получатели: Включают подписывающих, утверждающих и CC. CC добавляются через массив carbonCopies в объекте получателя.
• Статус конверта: После отправки конверт находится в состоянии "sent" или "delivered". Изменения ограничены; вы не можете добавлять подписывающих, требующих действий, но CC разрешены, поскольку они не меняют порядок подписи.
• Конечные точки API: Используйте /envelopes/{envelopeId}/recipients для обновления.

С коммерческой точки зрения, цены на API DocuSign начинаются с 600 долларов в год для плана Starter, поддерживающего до 40 конвертов в месяц, что подходит для небольших интеграций, но потребности в больших объемах увеличивают стоимость.

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

Добавление CC после отправки требует использования режима correct или обходного пути void-and-resend, поскольку прямое добавление после отправки не всегда является простым. DocuSign рекомендует планировать получателей заранее, но для динамических сценариев (например, добавление менеджеров на основе условной бизнес-логики) выполните следующие действия. Этот процесс предполагает, что у вас есть учетная запись разработчика и токен доступа к API.

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

1. Настройка API: Интегрируйте DocuSign SDK (для Java, .NET, PHP и т. д.) или используйте необработанные вызовы REST. Аутентифицируйтесь, используя ваш ключ интеграции и идентификатор пользователя.
2. Идентификатор конверта: Получите идентификатор из начального ответа отправки (например, через POST /envelopes).
3. Разрешения: Убедитесь, что ваша учетная запись разрешает исправление конвертов (включено в "Features" в настройках Admin).
4. Проверка статуса конверта: Запросите /envelopes/{envelopeId}, чтобы подтвердить, что он находится в состоянии "sent" и ни один из подписывающих не завершил действие, блокирующее изменения.

Бизнес-совет: Для предприятий план Advanced API (5760 долларов в год) разблокирует такие функции, как Bulk Send и веб-хуки, которые могут автоматически уведомлять CC по завершении.

Метод 1: Использование исправления конверта (рекомендуется для небольших изменений)

Функция "Correct" в DocuSign позволяет вносить изменения в процессе, не аннулируя конверт, что подходит для добавления CC.

1. Начать исправление:

   • PUT на /envelopes/{envelopeId}/correct с телом:

     {
       "clientUserId": "optional_client_id",
       "correctInProgress": true
     }
     

     Это временно приостанавливает конверт.

2. Добавить получателя CC:

   • POST на /envelopes/{envelopeId}/recipients с деталями CC:

     {
       "carbonCopies": [
         {
           "email": "cc@example.com",
           "name": "John Doe",
           "recipientId": "unique_id_for_cc",  // Например, "CC1"
           "routingOrder": 0  // CC не влияет на порядок
         }
       ],
       "resendEnvelope": false  // Пока не отправлять уведомление повторно
     }
     

     • recipientId должен быть уникальным; избегайте конфликтов с существующими получателями.
     • Дополнительно: добавьте accessControl для защиты паролем доступа CC.

3. Повторно отправить или уведомить:

   • Снова PUT на /envelopes/{envelopeId}/correct для возобновления:

     {
       "resendEnvelope": true  // Запускает электронное письмо для нового CC
     }
     

     CC получит копию, как только конверт будет завершен или по запросу.

Потенциальная ловушка: Если конверт "completed", его нельзя исправить - используйте веб-хуки через функцию Connect (план Advanced) для мониторинга статуса.

Метод 2: Аннулировать и повторно отправить (подходит для сложных сценариев)

Если исправление невозможно (например, из-за действий подписывающего), аннулируйте конверт и воссоздайте его с новым CC.

1. Аннулировать конверт:

   • PUT на /envelopes/{envelopeId}:

     {
       "status": "voided",
       "voidedReason": "Adding CC recipient"
     }
     

2. Воссоздать с CC:

   • POST на /envelopes с исходной полезной нагрузкой, плюс CC в объекте recipients:

     {
       "emailSubject": "Updated Document",
       "documents": [/* original docs */],
       "recipients": {
         "signers": [/* original signers */],
         "carbonCopies": [
           {
             "email": "cc@example.com",
             "name": "John Doe",
             "recipientId": "CC1"
           }
         ]
       },
       "status": "sent"
     }
     

3. Уведомить исходных подписывающих: Используйте /envelopes/{newEnvelopeId}/recipients/{recipientId}/resend для каждого подписывающего, чтобы возобновить.

Бизнес-наблюдение: Этот метод влечет за собой дополнительные затраты на использование конвертов (например, Business Pro ~100 конвертов на пользователя в год, 480 долларов США/пользователь/год), поэтому он подходит для исправлений с низким объемом. Используйте панели мониторинга для отслеживания квот через API для управления.

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

• Обработка ошибок: Распространенные ошибки включают 400 (недопустимый получатель) или 403 (недостаточно разрешений). Всегда сначала проверяйте с помощью GET /envelopes/{envelopeId}/recipients.
• Тестирование: Используйте Developer Sandbox DocuSign (бесплатно) для моделирования, не потребляя производственные конверты.
• Соответствие нормативным требованиям: Добавление CC поддерживает контрольный журнал, соответствующий стандартам ESIGN/UETA, но записывайте причины, чтобы избежать споров.
• Альтернативы автоматизации: Для частых потребностей после отправки интегрируйте веб-хуки (план Advanced) для запуска внешних уведомлений вместо изменений API.

На практике предприятия сообщают о повышении эффективности на 20-30% за счет скриптов SDK для этих операций, но для крупномасштабных операций рассмотрите пользовательские планы Enterprise для неограниченной настройки.

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

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

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

Сравнение DocuSign с ключевыми конкурентами

Чтобы предоставить сбалансированную точку зрения, давайте сравним возможности API DocuSign с альтернативами, такими как Adobe Sign, eSignGlobal и HelloSign (теперь Dropbox Sign). Эта таблица основана на общедоступных данных за 2025 год и выделяет цены, управление получателями и региональные преимущества, чтобы помочь предприятиям принимать решения при выборе поставщика.

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

Фокус на Adobe Sign

Adobe Sign, часть Adobe Document Cloud, предоставляет бесшовный API для управления получателями, включая более простое добавление CC после отправки через конечную точку API "Amend". Цены конкурентоспособны, начиная с 10 долларов в месяц/пользователь для базовой версии, и расширяются до пользовательской версии Enterprise. Он подходит для предприятий, уже использующих пакет Adobe, предлагая надежную обработку PDF и глобальное соответствие нормативным требованиям, хотя задержка APAC может быть проблемой.

Фокус на eSignGlobal

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

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

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

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

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

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

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