DocuSign API: Отправка конверта из шаблона с предварительно заполненными вкладками

Упрощение документооборота с помощью DocuSign API

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

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

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

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

Освоение DocuSign API: отправка конвертов из шаблонов

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

Предварительно заполненные теги — это поля, заполненные данными перед отправкой конверта, например, текстовые поля, даты или флажки. Это особенно полезно, когда информация о получателе известна, что обеспечивает более удобный процесс подписания. Для предприятий эта функция легко интегрируется с CRM-системами (такими как Salesforce) или ERP-инструментами, автоматизируя извлечение данных.

Для реализации этого через API разработчики обычно используют RESTful endpoints, а аутентификация обрабатывается через OAuth 2.0 или JWT authorization. DocuSign's developer sandbox предоставляет бесплатную тестовую среду, что крайне важно для предприятий для итеративной интеграции без производственных затрат.

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

Прежде чем углубляться в код, убедитесь, что у вас есть:

• Учетная запись разработчика DocuSign (бесплатная регистрация).
• Ключ интеграции (ID приложения) и API-токен для аутентификации.
• Знакомство с JSON payload, поскольку API использует этот формат для связи.
• DocuSign SDK для вашего предпочтительного языка (например, Java, .NET, Python), который упрощает HTTP-запросы.

Предприятия также должны учитывать уровни цен на API: план Starter за 600 долларов в год поддерживает до 40 конвертов в месяц, что подходит для небольших интеграций, в то время как план Advanced за 5760 долларов в год разблокирует массовую отправку и веб-хуки, что подходит для более масштабных операций.

Пошаговое руководство по отправке конверта с предварительно заполненными тегами

Шаг 1: Создание или получение шаблона

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

• Текстовые теги: для имен, адресов и т.д.
• Теги даты: автоматически заполняют текущую дату или пользовательские значения.
• Теги флажков: для соглашений.
• Теги инициалов/подписи: для действий подписывающего.

Используйте Templates API для перечисления существующих шаблонов:

GET /restapi/v2.1/accounts/{accountId}/templates

Это вернет JSON-массив шаблонов. Запишите templateId для использования в последующих шагах.

Шаг 2: Подготовка определения конверта

Создайте объект конверта, ссылающийся на шаблон. Предварительно заполните теги, включив данные получателя и значения тегов в payload.

Ниже приведен пример JSON для создания конверта (с использованием Node.js и DocuSign SDK для иллюстрации):

const dsApi = new docusign.ApiClient();
dsApi.setBasePath('https://demo.docusign.net/restapi');
const envelopesApi = new docusign.EnvelopesApi(dsApi);

const envelopeDefinition = new docusign.EnvelopeDefinition();
envelopeDefinition.emailSubject = 'Please sign this document';
envelopeDefinition.status = 'sent'; // Options: 'created', 'sent', 'delivered'

// Reference the template
const template = new docusign.TemplateReference();
template.templateId = 'your-template-id';
template.roleName = 'Signer1'; // Matches template role
envelopeDefinition.templateReferences = [template];

// Define recipient and pre-fill tabs
const signer = new docusign.TemplateRole();
signer.roleName = 'Signer1';
signer.email = 'recipient@example.com';
signer.name = 'John Doe';
signer.clientUserId = '1000'; // For embedded signing if needed

// Pre-fill tabs (tabs from template)
const textTab = new docusign.Text();
textTab.tabLabel = 'FullName'; // Matches tab in template
textTab.value = 'John Doe';
signer.tabs = new docusign.Tabs();
signer.tabs.textTabs = [textTab];

const dateTab = new docusign.Date();
dateTab.tabLabel = 'AgreementDate';
dateTab.value = new Date().toISOString().split('T')[0];
signer.tabs.dateTabs = [dateTab];

envelopeDefinition.templateRoles = [signer];

const results = await envelopesApi.createEnvelope(accountId, { envelopeDefinition });
console.log(`Envelope ID: ${results.envelopeId}`);

Этот код создает конверт из шаблона, предварительно заполняя текстовый тег "FullName" значением "John Doe" и заполняя тег даты сегодняшней датой. tabLabel должен точно соответствовать метке, назначенной тегу в шаблоне.

Шаг 3: Обработка аутентификации и отправка

Аутентифицируйтесь с помощью JWT или access token. В производственной среде используйте базовый путь NA1 (США) или EU1 (Европа) в зависимости от региона вашей учетной записи. Отправьте конверт, используя:

const accessToken = await getJwtToken(); // Your auth function
dsApi.addDefaultHeader('Authorization', `Bearer ${accessToken}`);

Для массовых сценариев план Advanced API поддерживает до 100 конвертов в месяц и предварительное заполнение данных из внешних источников, таких как базы данных.

Шаг 4: Мониторинг и получение статуса

После отправки отслеживайте статус, используя веб-хуки (функция Connect в плане Advanced) или опрашивая endpoint /envelopes/{envelopeId}. Это имеет решающее значение для бизнес-процессов, обеспечивая соответствие требованиям аудита.

Распространенные проблемы и решения

• Ошибки соответствия тегов: убедитесь, что теги уникальны и правильно указаны. Сначала получите детали тегов с помощью Template API.
• Маршрутизация получателей: для конвертов с несколькими подписывающими назначьте роли в шаблоне и сопоставьте их в вызове API.
• Ограничения: стандартные планы ограничивают автоматизированную отправку примерно 100 конвертами в год на пользователя; планы API имеют квоты на конверты.
• Обработка ошибок: API-ответы включают коды ошибок (например, 400 для недействительного тега); реализуйте повторные попытки для временных проблем.

С коммерческой точки зрения эта интеграция API может сократить ручной ввод данных на 70%, но предприятия должны взвесить затраты — API-дополнения, такие как аутентификация, влекут за собой плату за использование.

Изучение более широкой экосистемы DocuSign

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

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

Рынок электронных подписей является конкурентным, DocuSign лидирует по глобальному внедрению, но сталкивается с конкурентами, предлагающими специализированные преимущества. Adobe Sign подчеркивает бесшовную интеграцию с Adobe Creative Suite, подходящую для рабочих процессов с интенсивным использованием документов. Он поддерживает предварительное заполнение форм через свой API и соответствует требованиям ESIGN/UETA в США и eIDAS в Европе. Цены начинаются с 10 долларов в месяц для отдельных лиц и расширяются до пользовательских планов для предприятий, включая такие функции, как мобильная подпись и сбор платежей.

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

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

Эта таблица подчеркивает нейтральные компромиссы: DocuSign для масштаба, Adobe для рабочих процессов проектирования, eSignGlobal для эффективности в АТР, HelloSign для простоты использования.

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

Хотя заголовок фокусируется на механизмах API, понимание правил может улучшить реализацию. В США закон ESIGN и UETA обеспечивают юридическую силу, эквивалентную мокрой подписи, для большинства коммерческих транзакций. Европейская структура eIDAS требует квалифицированных электронных подписей для потребностей с высокой степенью защиты. АТР различается: Закон об электронных транзакциях Сингапура соответствует eIDAS, но для государственных дел требуется Singpass, в то время как постановления Гонконга подчеркивают безопасную аутентификацию через iAM Smart. Предприятия, использующие DocuSign API, должны настроить теги в соответствии с полями соответствия, такими как журналы аудита, для соответствия этим стандартам.

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

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