添加签署人

POST/esignglobal/v1/envelope/recipients/addSigners

接口描述

向信封中添加签署人，签署人即为签署任务。包括为签署人添加控件、身份验证方式等信息。

注意：

支持在信封开启后添加新的签署人，新添加的签署人的签署顺序，不可以小于或等于有任何一个正在签署的签署人的签署顺序值。
同一签署人（以邮箱作为用户唯一标识）不允许重复添加，如需更新签署任务信息，请重新添加对应的签署人。
一个信封中最多仅能有10个签署人。

请求参数

参数名称					类型	必填	说明
envelopeId					string	true	信封 ID
signerInfos					array	true	签署人信息集合
	businessId				string	false	开发者自定义业务编号，长度500
	userEmail				string	true	签署人邮箱地址
	phoneNumber				object	false	当需要进行短信通知时为必填，countryCode与number都需要入参，默认为空
		countryCode			string	false	国家地区的国际码，无需传入“+”
		number			string	false	不做格式校验，长度最大为13位
	userName				string	true	签署人姓名，用于签署页面与流程对外展示签署人姓名。【注意】不可含有以下9个特殊字符：/ \ : * " < > \| ？以及所有emoji表情
	signOrder				int	true	签署人签署顺序，最小为1。无序签可指定相同顺序值。
	anySigner				boolean	false	是否支持任一人签署，默认 false true-同一signOrder仅需其中一人签署 false-同一signOrder所有人均需签署
	authModes				string	false	身份验证方式，默认为0 枚举类型： 0-不验证 1-使用签署口令验证 2-使用智方便身份信息验证 3-SMS OTP 验证 4-身份证件验证
	authConfig				object	false	验证方式设置
		accessCode			object	false	签署口令设置，当authModes=1时必填
			accessCode		string	false	口令内容，不区分大小写，可以包含字母数字，长度45
		iAMSmart			object	false	智方便身份验证设置，当authModes=2时必填
			name		string	false	签署人香港身份证件上的姓名全称，最大长度100个字符
			idCardType		string	false	身份证件类型： HKG_PSN_IDCARD-香港居民身份证
			idCardNum		string	false	身份证件号码，目前不限制格式香港居民身份证号码示例：A888888(A)
		sms			object	false	SMS OTP验证，当authModes=3时必填
			countryCode		string	false	国家地区的国际码，无需带“+”
			number		string	false	不做格式校验，长度最大为13位
		idVerification			object	false	身份证件验证设置，当authModes=4时必填
			name		string	false	签署人身份证件上的姓名全称，最大长度100个字符
	digitalSignature				boolean	false	是否开启数字签名，默认false true-开启 false-不开启
	freeFormSign				boolean	false	签署人是否自由签章，默认值 false 补充说明：当选择freeFormSign为true时，针对sealInfos下的其他参数无需传入。如同时传入，freeFormSign优先级高于sealInfos，sealInfos下的参数不会生效。【注意】自由签章即不限制签名人可拖入的图章/签名数量和位置。
	sealInfos				array	false	签署任务信息
		fileKey			string	true	签署文件fileKey
		signConfigs			array	false	控件位置信息，必须指定控件的位置信息才可以进行电子签名。
			fieldType		string	false	控件类型，可入参： signature-签名控件 stamp-图章控件默认为signature
			height		int	false	签署控件高度，适用于fieldType为signature/stamp，单位为px，仅支持正整数传入，默认auto（即系统自动尺寸）；当fieldType=signature时，可设置范围为20-250px；当fieldType=stamp时，可设置范围为30-280px
			width		int	false	签署控件宽度，适用于fieldType为signature/stamp，单位为px，仅支持正整数传入，默认auto（即系统自动尺寸）；当fieldType=signature时，可设置范围为20-250px；当fieldType=stamp时，可设置范围为30-280px
			signatureOptions		string	false	签名控件选项。仅适用于fieldType为signature。可入参： template handDrawn upload 可多选，用","分隔，默认全选
			movable		boolean	false	签署时允许移动位置，默认false false-不允许签署人调整自己的签署控件位置 true-允许签署人调整自己的签署控件位置
			pageNo		string	false	签署页码；连续页码用"-"连接，单独页码用","连接，例如：1-3, 6-10
			posX		string	false	X轴坐标补充说明：若fieldType为signature，则坐标位置指签名区左下角；若fieldType为stamp，则坐标位置指盖章区中心点位置
			posY		string	false	Y轴坐标补充说明：若fieldType为signature，则坐标位置指签名区左下角；若fieldType为stamp，则坐标位置指盖章区中心点位置
		fillConfigs			array	false	填写控件信息
			fieldName		string	false	控件名称，字符数限制128
			required		boolean	false	是否必填，默认必填 true-必填 false-非必填
			fieldType		string	false	控件类型： 1-单行文本 15-勾选框
			textField		object	false	文本控件属性
				overflowType	int	false	只对text生效，默认1 1-自动缩小字号 2-限制输入
				minFontSize	float	false	只对text生效，只对overflowType=1生效，默认8。 5, 5.5, 6, 6.5, 7, 7.5, 8, 9, 10, 10.5, 11, 12, 14, 15, 16, 18, 20, 22, 24, 26, 28, 36, 42, 48, 56, 72
				width	int	false	控件宽度，默认160px
				font	int	false	只对text生效，字体，默认宋体。 1-宋体 2-新宋体 4-黑体 5-楷体 6-Arial 7-Helvetica 9-Times New Roman 10-仿宋 11-Georgia 12-Monospace
				fontSize	float	false	只对text生效，字体大小，默认12 5, 5.5, 6, 6.5, 7, 7.5, 8, 9, 10, 10.5, 11, 12, 14, 15, 16, 18, 20, 22, 24, 26, 28, 36, 42, 48, 56, 72
				textColor	string	false	只对text生效，十六进制颜色，默认黑色#000
				bold	boolean	false	只对text生效，字体是否加粗，默认false true-加粗 false-不加粗
				italic	boolean	false	只对text生效，是否斜体，默认false true-斜体 false-非斜体
				underline	boolean	false	只对text生效，字体是否添加下划线，默认false true-添加下划线 false-不添加下划线
				lineThrough	boolean	false	只对text生效，是否添加删除线，默认false true-添加删除线 false-不添加删除线
				horizontalAlignment	string	false	只对text生效，水平居中格式，默认left LEFT-靠左 CENTER-居中 RIGHT-靠右
			tickBoxField		object	false	勾选框属性
				tickOptions	array	false	只对Check生效，默认1 1-勾 2-叉
			posX		float	false	控件位置X横坐标
			posY		float	false	控件位置Y纵坐标
			pageNo		string	false	控件所在页码
		signDateConfigs			array	false	签署日期位置信息
			movable		boolean	false	签署时允许移动位置，默认false false-不允许签署人调整自己的签署控件位置 true-允许签署人调整自己的签署控件位置
			pageNo		string	false	签署页码；连续页码用"-"连接，单独页码用","连接，例如：1-3, 6-10 非连续则传入","进行分割
			posX		float	false	x轴偏移量，页面左下角为坐标原点
			posY		float	false	y轴偏移量，页面左下角为坐标原点
			signDateFormat		string	false	签署日期格式，默认格式为yyyy-MM-dd 支持指定格式： yyyy年MM月dd日 yyyy-MM-dd yyyy/MM/dd dd.MM.yyyy MM dd yyyy dd MM yyyy

请求示例

{
    "envelopeId": "{{envelope-id}}",
    "signerInfos": [
        {
    	   "userEmail": "sender_user@esignglobal.com",
    	   "userName": "sender_user_name",
    	   "signOrder": 1,
    	   "authModes": "3",
           "authConfig": {
                "sms": {
                    "countryCode": "86",
                    "number": "158****9242"
                }
            },
            "sealInfos": [
                {
                    "fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c",
                    "signConfigs": [
                        {
                           "fieldType": "stamp",
                            "pageNo": "1",
                            "posX": 100.22,
                            "posY": 100
                        }
                    ],
                    "fillConfigs": [
                        {
                            "fieldId": "df0dd777bcc4d108de242d",
                            "fieldKey": "demo",
                            "pageNo": "1",
                            "posX": "88.70021",
                            "posY": 745.409,
                            "fieldType": "1",
                            "required": true,
                            "textField": {
                                "overflowType": "1",
                                "minFontSize": 8,
                                "font": "6",
                                "fontSize": "12",
                                "textColor": "#54ACD2",
                                "bold": false,
                                "italic": true,
                                "lineThrough": false,
                                "horizontalAlignment": "RIGHT"
                            }
                        },
                        {
                            "fieldId": "96e6c7d414f04e98938ea84013b",
                            "fieldKey": "红色加深斜体下划线删除线",
                            "pageNo": "1",
                            "posX": 94.516624,
                            "posY": 284.54953,
                            "fieldType": "1",
                            "required": false,
                            "textField": {
                                "overflowType": "1",
                                "minFontSize": 10.5,
                                "font": "1",
                                "fontSize": 12.0,
                                "textColor": "#E25041",
                                "bold": true,
                                "italic": true,
                                "lineThrough": true,
                                "horizontalAlignment": "LEFT"
                            }
                        },
                        {
                            "fieldId": "888b899853544c49bd819d9f6d1",
                            "fieldKey": "必填勾选控件选中样式不显示边框",
                            "pageNo": "3",
                            "posX": 451.77127,
                            "posY": 429.07626,
                            "fieldType": "15",
                            "required": true,
                            "tickBoxField": {
                                "tickOptions": [1,2],
                                "showBorder": false
                            }
                        }
                    ]
                    "signDateConfigs":[
                          "pageNo":"1",
                          "posX": 100.22,
                          "posY": 100,
                          "signDateFormat": "dd MMM yyyy"
                    ]
                }
            ]
        }
    ]
}

响应参数

参数名称			类型	说明
envelopeId			string	信封 ID
signFiles			array	签署文件集合
	fileKey		string	签署文件fileKey
attachments			array	信封附件集合
	fileKey		string	文件fileKey
signerInfos			array	签署人信息集合
	businessId		string	开发者自定义业务编号，长度500
	userEmail		string	签署人邮箱地址
	userName		string	签署人姓名
	signOrder		int	签署人节点顺序，最小为1
		accessCode	string	签署页访问口令

响应示例

{
    "code": "0",
    "data": {
        "signerInfos": [
            {
                "organizationName": "Esign Global CO.",
                "userLastName": "",
                "accessCode": "",
                "userEmail": "sender_user@tsign.cn",
                "userFirstName": "",
                "signOrder": "1"
            }
        ],
        "signFiles": [
            {
                "fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c"
            }
        ],
        "attachments": [

        ],
        "envelopeId": "9fbe6c8190824227bde29136b0145c81"
    },
    "message": "success"
}