Работа с несколькими подписантами

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

Маршрут подписания

Маршрут подписания, также известный как этапы подписания или порядок подписания, определяет последовательность взаимодействия получателей с документом в конверте. API Sign.Plus для электронной подписи позволяет создавать индивидуальные маршруты подписания для различных сценариев — от простых документов с одним подписантом до сложных многоэтапных процессов согласования.

Ключевые моменты, которые важно учитывать:

1. Для каждого получателя в конверте можно задать определённый порядок подписания.
2. Подписывать документ должны не все получатели: некоторые могут только получить его копию.
3. У получателей могут быть разные роли, например SIGNER или RECEIVES_COPY.

Настройка этапов подписания

Для настройки маршрута подписания используется конечная точка POST /v2/envelope/{envelope_id}/signing_steps.

Важное примечание: значение {envelope_id} в URL конечной точки должно быть получено при создании конверта. Убедитесь, что конверт уже создан и у вас есть его ID, прежде чем настраивать этапы подписания.

Ниже показано, как формировать тело запроса для различных сценариев:

Сценарий 1: один получатель, один этап подписания

Это самый простой случай — всего один подписант:

{
"signing_steps": [
{
"recipients": [
{
"name": "John Doe",
"email": "john.doe@example.com",
"role": "SIGNER"
}
]
}
]
}

Сценарий 2: несколько получателей, один этап подписания

В этом случае несколько получателей действуют одновременно:

{
"signing_steps": [
{
"recipients": [
{
"name": "John Doe",
"email": "john.doe@example.com",
"role": "SIGNER"
},
{
"name": "Mark Twain",
"email": "mark.twain@example.com",
"role": "SIGNER"
},
{
"name": "Bob Dylan",
"email": "bob.dylan@example.com",
"role": "RECEIVES_COPY"
}
]
}
]
}

Сценарий 3: несколько получателей, несколько этапов подписания

Для более сложных процессов можно настроить несколько этапов подписания:

{
"signing_steps": [
{
"recipients": [
{
"name": "John Doe",
"email": "john.doe@example.com",
"role": "SIGNER"
},
{
"name": "Bob Dylan",
"email": "bob.dylan@example.com",
"role": "RECEIVES_COPY"
}
]
},
{
"recipients": [
{
"name": "Alice Doe",
"email": "alice.doe@example.com",
"role": "SIGNER"
},
{
"name": "Jane Doe",
"email": "jane.doe@example.com",
"role": "SIGNER"
}
]
},
{
"recipients": [
{
"name": "Louis Dupont",
"email": "louis.dupont@example.com",
"role": "RECEIVES_COPY"
},
{
"name": "Michel Dupont",
"email": "michel.dupont@example.com",
"role": "RECEIVES_COPY"
}
]
}
]
}


В этом примере используются три этапа подписания:

1. Джон Доу подписывает документ, а Боб Дилан получает копию.
2. Алиса Доу и Джейн Доу подписывают документ.
3. Луи Дюпон и Мишель Дюпон получают копии.

Все получатели текущего этапа должны завершить свои действия, прежде чем начнётся следующий этап.

Рекомендации по работе с несколькими подписантами

1. Спланируйте процесс подписания: прежде чем приступать к реализации, продумайте весь процесс подписания целиком. Определите, кто должен подписать документ, в каком порядке и кто должен получить копии.
2. Правильно используйте роли: используйте разные роли (SIGNER , RECEIVES_COPY), чтобы обеспечить каждому получателю правильный уровень взаимодействия с документом.
3. Определите порядок подписания — параллельный или последовательный: решите, могут ли некоторые подписанты подписывать документ одновременно (в рамках одного этапа) или требуется строгая последовательность.

Используя эти возможности API Sign.Plus, вы можете создавать сложные процессы подписания, соответствующие широкому спектру бизнес-процессов и требований.