Agregar destinatario en copia

POST /esignglobal/v1/envelope/recipients/addCCs

Descripción de la interfaz

Agrega destinatarios en copia a un sobre. Una vez iniciado el sobre, el sistema notificará automáticamente a los destinatarios en copia, quienes solo tendrán permisos de visualización.

Notas importantes:

Se admite agregar destinatarios en copia cuando el estado del sobre esBorrador、En firmaAgregar destinatarios en copia.
El orden de visualización de los destinatarios en copia no afecta el orden de envío de las copias del sobre.
No se permite agregar repetidamente al mismo destinatario en copia (identificado de forma única por su correo electrónico). Si necesita actualizar la información de la tarea de firma, vuelva a agregar el destinatario en copia correspondiente.

Parámetros de solicitud

Nombre del parámetro				Tipo	Obligatorio	Descripción
envelopeId				string	true	ID del sobre
CCInfos				array	true	Conjunto de información de los destinatarios en copia
	userEmail			string	true	Dirección de correo electrónico del destinatario en copia
	userName			string	true	Nombre del destinatario en copia, utilizado para mostrar el nombre de la parte en copia en la página de firma y en el flujo del proceso. [Nota] No debe contener los siguientes 9 caracteres especiales: / \ : * " < > \| ? ni ningún emoji
	ccOrder			int	false	Posición ordenada del destinatario en copia dentro del flujo de firma, compartiendo el orden con signOrder de los firmantes. Solo se puede configurar en nodos de firma que aún no han comenzado; si no se proporciona, se mantiene la lógica original de notificación por copia adicional.
	customizeSettings			object	false	Configuración personalizada
		notificationSettings		object	false	Configuración personalizada para notificaciones
			notificationLanguage	string	false	Idioma de la notificación, por defecto toma la configuración de "idioma de notificación predeterminado" en-US Inglés zh-CN Chino simplificado zh-Hant Chino tradicional ja-JP Japonés es-MX Español pt-PT Portugués th-TH Tailandés id-ID indonesio vi-VN vietnamita ms-MY malayo fil-PH filipino de-DE alemán fr-FR francés ru-RU ruso it-IT italiano ko-KR coreano

Parámetros de solicitud

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

Parámetros de respuesta

Nombre del parámetro		Tipo	Descripción
envelopeId		string	ID del sobre
CCInfos		array	Conjunto de información de los destinatarios en copia
	userEmail	string	Dirección de correo electrónico del destinatario en copia
	userName	string	Nombre del destinatario en copia

Ejemplo de respuesta

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