Песочница для подписи Пеннео (предварительная версия)

Пеннео преобразует сложные процессы в простой, ориентированный на человека опыт. Интегрируя цифровые подписи в автоматизированные рабочие процессы, наша платформа упрощает проверку того, кто одобрил данные и когда, уменьшая административные нагрузки, обеспечивая полное соответствие требованиям и безопасность. Этот соединитель позволяет отправлять документы для подписывания.

Этот соединитель доступен в следующих продуктах и регионах:

Песочница для подписи Пеннео

Пеннео преобразует сложные процессы в простой, ориентированный на человека опыт. Интегрируя цифровые подписи в автоматизированные рабочие процессы, наша платформа упрощает проверку того, кто одобрил данные и когда, уменьшая административные нагрузки, обеспечивая полное соответствие требованиям и безопасность.

Prerequisites

Чтобы использовать этот соединитель, вам потребуется активная учетная запись Песочницы Penneo.

Поддерживаемые действия

Создание файла регистра

Создает новый файл регистра в Пенно с указанными документами и подписывателями. Файл дела будет создан в Penneo, а UUID и полезные данныеHash будут возвращены, которые можно использовать для проверки состояния создания через конечную точку состояния очереди.

Проверка состояния задания

Извлекает текущее состояние файла casefile, предоставив задание UUID и полезные данныеHash. Эта конечная точка используется для опроса состояния завершения задания после отправки запроса на создание файла дела. Конечная точка ограничена скоростью до 20 запросов в минуту на комбинацию uuid-payloadHash.

Получение сведений о файле дела

Извлекает сведения о конкретном файле дела из Penneo на основе идентификатора файла дела. К ним относятся подписи, документы и текущее состояние.

Скачивание документа

Загружает содержимое документа из Пенно в виде строки в кодировке Base64. По умолчанию возвращается подписанная версия документа; signed Используйте параметр для получения неподписанных версий. Если ваш файл дела содержит больше документов, убедитесь, что цикл по каждому документу.

Получение учетных данных

Соединитель настроен для использования OAuth с предоставлением кода авторизации. При использовании соединителя пользователям придется войти с помощью обычных учетных данных.

Getting Started

Создание файла дела

1. Подготовка документов:

   • Преобразование PDF-документов в кодировку Base64
   • Убедитесь, что документы являются допустимыми PDF-файлами

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

   • Укажите имя и электронную почту подписывщика (обязательно)
   • При необходимости предоставьте роль, язык, заказ подписывания и т. д.
   • Настройка уведомлений электронной почты и пользовательских шаблонов электронной почты при необходимости

3. Создайте файл дела:

   • Используйте действие "Создать новый файл дела"
   • Заполните сведения о файле дела:
     • Title
     • Документы (PDF-файлы в кодировке Base64)
     • Подписыватели (с именами и необязательными сведениями)
     • Необязательные параметры (срок действия, язык, видимость и т. д.)

4. Проверьте состояние создания CaseFile:

   • После создания файла дела вы получите идентификатор UUID и полезные данныеHash
   • Используйте действие "Проверить состояние задания" для опроса завершения задания
   • Соблюдайте ограничение скорости в 20 запросов в минуту на комбинацию хэша uuid-hash

Примечание. Вы можете проверить, что делает каждое поле, проверив https://penneo.readme.io/reference/createcasefile.

Получение файла дела и его документов

1. Получение сведений о файле дела:

   • Использование действия "Получение сведений о файле дела" с идентификатором файла дела
   • Ответ включает состояние файла регистра, подписывателей и список документов (с идентификаторами документа).

2. Скачайте документ:

   • Используйте действие "Скачать документ" с идентификатором документа, полученным из сведений о файле дела.
   • Ответ содержит содержимое документа в виде строки в кодировке Base64, которую можно декодировать для извлечения PDF-файла.

Известные проблемы и ограничения

1. Ограничение скорости. Конечная точка состояния задания check ограничена скоростью до 20 запросов в минуту в сочетании uuid-hash. Реализуйте соответствующую логику повторных попыток с экспоненциальным обратным выходом.

2. Асинхронная обработка: создание файла регистра является асинхронным. Для проверки завершения необходимо использовать конечную точку состояния задания, а не ожидать немедленных результатов.

3. Кодировка Base64: документы должны быть закодированы в кодировке Base64. Убедитесь, что правильная кодировка позволяет избежать сбоев запросов(можно использовать строку base64 в Power Platform для кодирования двоичных PDF-файлов).

4. Среда песочницы: этот соединитель настроен для среды песочницы Penneo (sandbox.penneo.com).

5. Размер документа: обработка больших документов может занять больше времени. Учитывайте ограничения размера документа при кодировке в base64.

Инструкции по развертыванию

Выполните следующие команды и следуйте инструкциям.

paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png --script script.csx

Ограничения регулирования

Действия

Получение сведений о файле дела

Проверка состояния задания

Скачивание документа

Создание файла регистра

Определения

JobResponse

Job

QueueJob

CcRecipient

CaseFileDetails

SignerDetails

ПодписываниеRequestDetails

DocumentDetails

DocumentContent