eSign.AIeSign.AI
Центр разработчиков

Добавить получателя копии

POST /esignglobal/v1/envelope/recipients/addCCs

Описание интерфейса

Добавление копии в конверт. После отправки конверта система автоматически уведомляет получателей копии, которые имеют только права на просмотр.

Примечания:

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

Параметры запроса

Имя параметра

Тип

Обязательно ли

Описание

envelopeId

string

true

ID конверта

CCInfos

array

true

Список лиц, указанных в копии

 

userEmail

string

true

Адрес электронной почты лица, указанного в копии

 

userName

string

true

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

[Внимание] Не должно содержать следующих 9 специальных символов: / \ : * " < > | ? , а также любые эмодзи

 

ccOrder

int

false

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

 

customizeSettings

object

false

Пользовательская настройка

 

 

notificationSettings

object

false

Настройка уведомлений

 

 

 

notificationLanguage

string

false

Язык уведомлений; по умолчанию используется значение из конфигурации «Язык уведомлений по умолчанию»

en-US Английский (США)

zh-CN Упрощенный китайский

zh-Hant Традиционный китайский

ja-JP Японский

es-MX Испанский (Мексика)

pt-PT Португальский (Португалия)
th-TH Тайский
id-ID индонезийский
vi-VN вьетнамский
ms-MY малайский
fil-PH филиппинский
de-DE немецкий
fr-FR французский
ru-RU русский
it-IT итальянский
ko-KR корейский

Параметры запроса

{
	"envelopeId": "flow1234567890",
	"CCInfos": [{
		"userEmail": "buweiqiang@xxxx.com",
		"userName": "WeiQiang",
		"ccOrder": 2
		},{
		"userEmail": "tiandou@xxxx.com",
		"userName": "dou",
		"ccOrder": 3
	}
}

Параметры ответа

Имя параметра

Тип

Описание

envelopeId

string

ID конверта

CCInfos

array

Коллекция информации о получателях копии

 

userEmail

string

Адрес электронной почты получателя копии

 

userName

string

Имя получателя копии

Пример ответа

{
	"code": "0",
	"message": "成功",
	"data": {
		"envelopeId": "flow1234567890",
		"CCInfos": [{
			"userEmail": "buweiqiang@xxxx.com",
			"userName": "WeiQiang"
			},{
			"userEmail": "tiandou@xxxx.com",
			"userName": "dou"
		}]
	}
}