DocuSign API: Как объединить несколько PDF-файлов с помощью "Составных шаблонов"?

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

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

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

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

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

Использование составных шаблонов DocuSign API для объединения PDF-файлов

Что такое составные шаблоны?

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

С точки зрения бизнеса, эта функция сокращает количество вызовов API, минимизирует ошибки маршрутизации документов и ускоряет время оборота — что имеет решающее значение для отделов продаж, закрывающих сделки, или отделов кадров, обрабатывающих пакеты документов для приема на работу. Согласно ресурсам для разработчиков DocuSign, составные шаблоны доступны на уровнях Intermediate и Advanced API, годовая плата за которые начинается примерно с 3600 долларов США для умеренного использования.

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

Чтобы объединить несколько PDF-файлов с помощью составных шаблонов, вы будете взаимодействовать с DocuSign REST API (версия 2.1 или выше). Необходимые условия включают учетную запись разработчика DocuSign (предлагается бесплатная песочница) и учетные данные API, полученные через OAuth. Вот практическое руководство:

1. Подготовьте свои документы и шаблоны:

   • Загрузите свои PDF-файлы во временное хранилище DocuSign или сошлитесь на них через кодировку base64. Например, подготовьте pdf1.pdf (контракт) и pdf2.pdf (дополнение).
   • Если они многоразовые, создайте шаблоны в веб-приложении DocuSign. Каждый шаблон может содержать предопределенные вкладки, такие как подпись, дата или текстовые поля. Запишите идентификаторы шаблонов с панели управления DocuSign.

2. Настройте определение конверта:

   • Создайте новый конверт, используя конечную точку /envelopes. Структурируйте массив compositeTemplates в теле JSON-запроса.
   • Ключевые элементы:
     • document: встроенный или удаленный PDF-файл.
     • serverTemplates или inlineTemplates: ссылки на существующие шаблоны.
     • recipients: определяет подписантов (например, роль подписанта) и прикрепляет их к составному шаблону.

   Пример фрагмента JSON (используйте Node.js или аналогичный инструмент для вызовов API):

   {
     "status": "sent",
     "emailSubject": "Пожалуйста, подпишите объединенное соглашение",
     "compositeTemplates": [
       {
         "compositeTemplateId": "template1",
         "document": {
           "documentBase64": "base64_of_pdf1",
           "name": "Основной контракт",
           "fileExtension": "pdf",
           "documentId": "1"
         },
         "serverTemplates": [
           {
             "sequence": "1",
             "templateId": "your-template-id-1"
           }
         ],
         "inlineTemplates": [
           {
             "sequence": "1",
             "recipients": {
               "signers": [
                 {
                   "email": "signer@example.com",
                   "name": "John Doe",
                   "recipientId": "1",
                   "tabs": {
                     "signHereTabs": [
                       {
                         "documentId": "1",
                         "pageNumber": "1",
                         "xPosition": "100",
                         "yPosition": "200"
                       }
                     ]
                   }
                 }
               ]
             }
           }
         ]
       },
       {
         "compositeTemplateId": "template2",
         "document": {
           "documentBase64": "base64_of_pdf2",
           "name": "Дополнение",
           "fileExtension": "pdf",
           "documentId": "2"
         },
         "serverTemplates": [
           {
             "sequence": "2",
             "templateId": "your-template-id-2"
           }
         ]
       }
     ],
     "recipients": {
       "signers": [
         {
           "email": "signer@example.com",
           "name": "John Doe",
           "recipientId": "1",
           "routingOrder": "1"
         }
       ]
     }
   }
   

   Это объединяет pdf1 и pdf2 в один конверт. Первый составной шаблон прикрепляет шаблон 1 к первому PDF-файлу и добавляет вкладку подписи; второй добавляет дополнение через шаблон 2. Получатели подписывают объединенный документ, не просматривая отдельные конверты.

3. Обработка логики объединения:

   • Используйте documentId для уникальной ссылки на PDF-файлы. Вкладки из шаблонов применяются к определенным документам, но отображаются в унифицированном представлении.
   • Для массового объединения интегрируйтесь с Bulk Send API (планы Business Pro или Advanced), с ограничением примерно в 100 отправок в год на пользователя.
   • Обработка ошибок: проверьте размер base64 (максимум 5 МБ на документ) и убедитесь, что область OAuth включает signature.

4. Отправьте и отслеживайте конверт:

   • POST на https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes.
   • Получите статус через /envelopes/{envelopeId}. Завершенные конверты возвращают объединенный PDF-файл через API.
   • Бизнес-совет: в производственной среде используйте веб-перехватчики (функция Connect в плане Advanced) для уведомлений в режиме реального времени о завершении подписи.

5. Тестирование и оптимизация:

   • Тестирование в песочнице не учитывается в квоте конвертов. Отслеживайте использование на панели управления API, чтобы избежать превышения лимита — план Starter ограничивает 40 конвертами в месяц.
   • Для сложных объединений объедините с PowerForms для общедоступных шаблонов, повышая масштабируемость для электронной коммерции или адаптации партнеров.

Согласно отраслевым стандартам, этот подход может сократить время подготовки документов на 50-70% в средах с большим объемом данных. Однако для предприятий пользовательская интеграция может потребовать плана Enterprise API, цены на который настраиваются в зависимости от объема.

Интеграция с DocuSign IAM CLM

Интеллектуальное управление соглашениями (IAM) и управление жизненным циклом контрактов (CLM) DocuSign расширяют ценность составных шаблонов. IAM предоставляет оценку рисков на основе искусственного интеллекта и извлечение условий, а CLM обеспечивает сквозную автоматизацию рабочих процессов, включая библиотеки шаблонов и аналитику. В контексте API они интегрируются с составными шаблонами для динамической генерации PDF-файлов — например, извлечение данных из систем CRM для заполнения объединенных документов. Предприятия в регулируемых отраслях, таких как финансы, получают выгоду от инструментов соответствия требованиям IAM, таких как журналы аудита и SSO, хотя дополнительные функции, такие как аутентификация, влекут за собой плату за использование.

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

По мере глобализации предприятий выбор поставщика электронных подписей требует баланса между гибкостью API, соответствием требованиям и стоимостью. DocuSign лидирует с надежными возможностями API, такими как составные шаблоны, но альтернативы предлагают различные преимущества. Adobe Sign превосходно справляется с процессами, ориентированными на PDF, благодаря бесшовной интеграции с Adobe Acrobat для расширенного редактирования перед объединением. Его API поддерживает аналогичные составные структуры через "соглашения", а базовые планы начинаются от 10 долларов США в месяц на пользователя.

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

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

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

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

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

Сравнительная таблица конкурентов

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

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

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