DocuSign API: Как получить "Tab Data" (данные формы) из подписанного документа?

Навигация по DocuSign API для извлечения данных форм: бизнес-перспектива

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

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

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

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

Что такое Tab Data в DocuSign?

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

С точки зрения бизнеса, извлечение Tab Data через API является преобразующей функцией для предприятий, обрабатывающих большие объемы соглашений. Это обеспечивает бесшовную интеграцию с такими инструментами, как Salesforce или ERP-системы, потенциально сокращая время ввода данных на 70-80%. Однако такие проблемы, как статус конверта (например, аннулирован или отклонен) и сериализация данных, могут усложнить извлечение, если оно не будет обработано должным образом.

Пошаговое руководство: извлечение Tab Data из подписанных документов с помощью DocuSign API

Чтобы получить доступ к Tab Data после подписания, вы будете использовать REST API DocuSign (рекомендуется версия 2.1 для обеспечения стабильности в 2025 году). Этот процесс предполагает, что у вас есть учетная запись разработчика, учетные данные API (ключ интеграции, секретный ключ и идентификатор пользователя) и активный конверт. Конечные точки API защищены с помощью OAuth 2.0, что обеспечивает соответствие таким стандартам, как ESIGN и eIDAS.

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

1. Получите доступ к API: войдите в центр разработчиков DocuSign (developer.docusign.com) и создайте приложение. Сгенерируйте ключ интеграции и включите JWT или Auth Code Grant для аутентификации. Для производственной среды переключитесь с песочницы на реальные учетные данные.

2. Идентифицируйте конверт: убедитесь, что конверт находится в состоянии "Completed". Используйте конечную точку GET /envelopes/{envelopeId} для проверки:

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

   Это вернет детали конверта, включая статус.

3. Аутентификация: реализуйте OAuth. Для JWT используйте свой закрытый ключ для генерации токена:

   import requests
   from docusign_esign import ApiClient, EnvelopesApi
   
   api_client = ApiClient()
   api_client.host = "https://demo.docusign.net/restapi"
   api_client.request_header['Authorization'] = 'Bearer ' + access_token  # из потока JWT
   

Бизнес-совет: в средах с высокими ставками используйте корпоративные планы для получения более высоких квот API (самый высокий уровень настраиваемых ограничений, начиная с 5760 долларов США в год), поскольку бесплатная песочница разработчика ограничена 25 конвертами в месяц.

Извлечение Tab Data: основные вызовы API

Ключевой конечной точкой является GET /envelopes/{envelopeId}/documents/{documentId}/form_data, но для всестороннего Tab Data объедините ее с получателями конверта и пользовательскими полями. Вот рабочий процесс:

1. Перечислите документы в конверте: Сначала получите идентификатор документа, поскольку Tab Data связана с конкретным PDF.

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

   Ответ включает documentId (например, 1 для основного PDF).

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

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

   Пример ответа (JSON):

   {
     "formData": [
       {
         "name": "customerName",
         "value": "John Doe",
         "pageNumber": 1,
         "xPosition": 100,
         "yPosition": 200,
         "width": 150,
         "height": 20
       },
       {
         "name": "signatureDate",
         "value": "2025-01-15",
         "recipient": "Signer1"
       }
     ]
   }
   

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

3. Обработка данных для конкретного получателя: Для конвертов с несколькими подписантами используйте GET /envelopes/{envelopeId}/recipients/{recipientId}/tabs для фильтрации по получателю. Это вернет табы, назначенные этому подписанту:

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

   Ответ включает tabLabel (соответствует имени вашего поля формы) и value.

4. Расширенные возможности: пользовательские поля и вложения: Если используются функции Business Pro, такие как вложения подписантов, извлеките их через GET /envelopes/{envelopeId}/custom_fields. Для полного аудиторского следа (актуально для соответствия требованиям) добавьте ?include=summary в запросы конверта.

Реализация кода (пример на Python)

Используйте DocuSign eSign SDK:

from docusign_esign import EnvelopesApi, EnvelopeFormData

envelopes_api = EnvelopesApi(api_client)
envelope_id = 'your-envelope-id'
account_id = 'your-account-id'
document_id = 1  # Основной документ

# Получите данные формы
form_data_result = envelopes_api.get_form_data(account_id, envelope_id, document_id=document_id)
for fd in form_data_result.form_data:
    print(f"Field: {fd.name}, Value: {fd.value}")

Этот скрипт выводит все Tab Data, готовые для экспорта в CSV или вставки в базу данных.

Общие проблемы и лучшие практики

• Обработка ошибок: ограничения скорости API (например, 1000 вызовов в час для среднего плана, 3600 долларов США в год) могут ограничивать большие запросы. Реализуйте механизмы повторных попыток с экспоненциальной задержкой.
• Конфиденциальность данных: обеспечьте соответствие GDPR/eIDAS, маскируя конфиденциальные поля после извлечения.
• Тестирование: используйте конверты песочницы для моделирования подписей без затрат. Для пакетных сценариев используйте Connect Webhooks для запуска извлечения данных при завершении событий, уменьшая накладные расходы на опрос.
• Влияние на стоимость: вызовы API учитываются в квотах конвертов (например, 100 в месяц для стандартного плана, 300 долларов США в год на пользователя). Превышение приведет к оплате по факту, поэтому отслеживайте использование API централизованно.

С точки зрения бизнеса, эта интеграция API может принести ROI за счет автоматизации — предприятия сообщают об ускорении цикла контрактов на 50% — но требует предварительного времени разработчика (2-4 недели для надежной настройки). Для предприятий расширенные уровни API DocuSign (5760 долларов США в год) разблокируют массовую отправку и функции веб-хуков, подходящие для масштабирования.

Более широкий набор продуктов DocuSign

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

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

На рынке электронных подписей стоимостью более 5 миллиардов долларов DocuSign лидирует с надежными возможностями API для извлечения Tab Data, как описано выше, но альтернативы предлагают различные преимущества в ценообразовании, соответствии требованиям и региональной направленности. Ниже приведено нейтральное сравнение ключевых игроков на основе общедоступных данных за 2025 год.

Обзор DocuSign

DocuSign доминирует в глобальном масштабе с всесторонней поддержкой API для извлечения Tab Data, как описано ранее. Его сильные стороны заключаются в функциях корпоративного уровня, таких как массовая отправка и надстройки аутентификации (оплата по факту). Однако ценообразование на основе мест может резко возрасти для больших команд, а задержки в Азиатско-Тихоокеанском регионе могут повлиять на производительность.

Обзор Adobe Sign

Adobe Sign интегрируется с экосистемой Adobe Acrobat, предлагая аналогичный доступ к данным формы через свой REST API (например, GET /agreements/{agreementId}/formData). Он ценится за бесшовную обработку PDF и корпоративную безопасность, с личными планами, начинающимися с 10 долларов США в месяц на пользователя. Недостатки включают более высокие затраты на расширенную автоматизацию и меньшую гибкость для настраиваемых рабочих процессов по сравнению с DocuSign.

Обзор eSignGlobal

eSignGlobal позиционирует себя как альтернатива, ориентированная на соответствие требованиям, поддерживая электронные подписи в более чем 100 основных странах мира. Он превосходит в Азиатско-Тихоокеанском регионе, где правила электронных подписей фрагментированы, имеют высокие стандарты и строго регулируются — часто требуя подхода к интеграции экосистемы, такого как глубокое аппаратное/API сопряжение с государственными цифровыми удостоверениями (G2B). В отличие от рамочных стандартов ESIGN/eIDAS, зависящих от проверки электронной почты или самодекларации, как в Америке и Европе, Азиатско-Тихоокеанский регион требует локальных интеграций для обеспечения юридической силы. План Essential от eSignGlobal предлагает надежную ценность за 299 долларов США в год (примерно 24,9 доллара США в месяц, хотя рекламные цены могут снизиться до эквивалента 16,6 доллара США в месяц), позволяя до 100 подписанных документов, неограниченное количество мест пользователей и проверку кода доступа. Он бесшовно интегрируется с iAM Smart в Гонконге и Singpass в Сингапуре, что делает его идеальным для регионального соответствия без дополнительных затрат. В глобальном масштабе, включая США и ЕС, eSignGlobal конкурирует, оставаясь ниже конкурентов по стоимости, сохраняя при этом такие функции, как извлечение данных формы на основе API.

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

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

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

HelloSign (Dropbox Sign) и другие конкуренты

HelloSign, теперь Dropbox Sign, предлагает простой API для извлечения полей формы (через GET /signature_request/{request_id}/details), с бесплатным уровнем для небольших команд. Он удобен для SMB, но ему не хватает глубины DocuSign в автоматизации. Другие игроки, такие как PandaDoc, ориентированы на предложения со встроенными формами, а SignNow подчеркивает мобильный опыт.

Эта таблица подчеркивает компромиссы: DocuSign ориентирован на глубину, eSignGlobal — на эффективность в Азиатско-Тихоокеанском регионе.

Заключительные мысли: выбор подходящего решения

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