跳到主要内容
文档icon文档中心

接口常见报错

同一份合同中的同一签署人不可同时以企业及个人身份签署

同一个自然人,不能同时作为个人和企业(经办人)两个签署方去签署。
解决方式:
方式一:合同只保留企业签署方(去掉个人签署方),并指定印章签字两个签署控件;
方式二:如果除了此自然人外,合同还有其他签署方,可联系客户经理给开白处理。
注意:
如果合同涉及到本方企业自动签署,其经办人取的合同发起人(即自建应用是 Operator.UserId,第三方应用是 Agent.ProxyOperator.OpenId),请确保此员工和个人签署方不是一个人。

其他公司自动签署功能暂未开放,请联系客户经理申请【他方自动签署权限】后使用

假设合同由 A 企业发起(即调接口使用的 API 密钥来自于 A 企业),签署方为另外一个企业(B 企业),如果需要 B 企业自动签署,请参考:

本企业自动签印章无权限使用

1. 请检查传入的印章是否存在并启用
2. 请检查经办人是否有此印章权限。需要注意的是对于自动签署而言,经办人默认为发起人且不能更改。具体请参考以下:
自建应用:发起人为 Operator.UserId
Clipboard_Screenshot_1739777112#562px #433px


第三方应用:发起人为 Agent.ProxyOperator.OpenId
Clipboard_Screenshot_1742296135



合作方企业自动签印章未授权

自建应用:
假设合同由 A 企业发起(即调接口使用的 API 密钥来自于 A 企业),签署方为另外一个企业(B 企业),如果需要 B 企业自动签署,则被称为合作方企业自动签,需要 B 企业授权操作。
情况1
若采用 B 企业主动给 A 企业授权,请参考 让合作方主动给我授权情况2
若采用 A 企业邀请 B 企业给固定模板授权,请参考 邀请合作方给我授权
第三方应用:
假设合同由 A 企业发起(Agent.ProxyOrganizationOpenId 为 A 子客的 OpenId),签署方为另外一个子客(B 企业),如果需要 B 企业自动签署,则被称为合作方企业自动签,需要 B 企业授权操作,请参考 合作方企业自动签署
注意:
比如 B 企业给 A 企业只授权了「公章」,但发起合同时传入了「财务专用章」的印章 ID,那也会报此错误。
在自建应用情况2中,如果被授权的模板发生了变更,授权会失效,需要重新授权。

在此合同中不存在该签署人,请确认传入的签署人信息是否正确

请检查是否发起合同时指定了签署人身份证号,但获取 H5签署链接时没有指定。如果签署人之前已经在电子签实名过,且绑定的手机号并非获取签署链接时传入的手机号,就会报此错误。
例如:比如发起合同时指定了张三,手机号133,身份证号 abc。由于张三之前在电子签实名过,且绑定的手机号为188,则发起的这个合同就关联到了188手机号。再用133手机号去获取签署链接就会报错。
解决方式:
方式1:引导用户直接去小程序签署
方式2:获取签署链接时也传入身份证号
方式3:发起合同时不传身份证号,上例中张三会在签署过程中将绑定的手机号更换为133(需要注意的是换绑过程133手机号需要收验证码,请确保133为张三当前在用的手机号)

未在合同中找到您提供的签署人信息。请核对姓名、手机号等提供的信息是否正确

请检查是否发起合同时指定了签署人身份证号,但获取合同组签署链接时没有指定。如果签署人之前已经在电子签实名过,且绑定的手机号并非获取签署链接时传入的手机号,就会报此错误。
例如:比如发起合同时指定了张三,手机号133,身份证号 abc。由于张三之前在电子签实名过,且绑定的手机号为188,则发起的这个合同就关联到了188手机号。再用133手机号去获取签署链接就会报错。
解决方式:
方式1:引导用户直接去小程序签署。
方式2:获取签署链接时也传入身份证号。

参数错误,指定的操作人不存在/不属于当前企业

操作人是指接口中的 Operator.UserId 参数,请先确认 UserId 是否取的是企业员工的用户 ID:

Clipboard_Screenshot_1737602145


另外一个常见原因是,这里的用户 ID 传入了正式/测试环境的企业员工,而接口请求到了测试/正式环境。
联调环境地址:
环境
地址
说明
文件服务的 EndPoint
file.test.ess.tencent.cn
UploadFiles 接口使用
通用接口请求 EndPoint
ess.test.ess.tencent.cn
除 UploadFiles 外其他接口使用
线上环境地址:
环境
地址
说明
文件服务的 EndPoint
file.ess.tencent.cn
UploadFiles 接口使用
通用接口请求 EndPoint
ess.tencentcloudapi.com
除 UploadFiles 外其他接口使用

在这个 PDF 中没有搜索到[xxx],请确认这个字符串是否存在

用关键字定位控件时报此错误,可以借助 Adobe Acrobat Reader 等 PDF 阅读器查找是否有对应关键字。另外一个常见问题是在传参时指定了 KeywordPage,即限定了搜索页码,请确认是否是此原因造成。

控件的 X(Y) 坐标超出了允许范围

请检查控件是否超过了 PDF 的最大宽度(595)或者最大高度(842),尤其需要注意,是否将 PDF 旋转了(宽842,高595)。

PDF 文件损坏,请上传正确的 PDF 文件

出现这种情况是指传入的 PDF 文件结构不规范,电子签无法处理此类文件。可以用 PDF 阅读器(例如 Adobe Acrobat Reader、福昕等)检查文件签名是否完整。比如以下文件已损坏:

Clipboard_Screenshot_1739266039



您输入的内容含不允许的敏感词汇

如果是签署方姓名、企业名称,可以选择使用模板发起合同,使用签署方信息控件;
image#229px #505px


如果是其他的填写控件,可以联系电子签侧处理后再操作。

参数错误,签署人填写控件不支持[SIGN_SEAL]类型

请检查是否传参时将签署控件(SignComponents)字段写成了填写控件(Components)。

用户[xxx]未开启或已关闭自动签服务

在发起带有个人自动签功能的合同时,如果报此错误,并且已确认该签署人已经开通了个人自动签。请检查是否签署人开通自动签时的手机号,和发起合同时传入的手机号不一致。

发起方签署审核/节点签署审核不能同时使用

请检查代表签署审批的参数 NeedSignReview 是指定到哪个维度的:
如果指定的是合同维度的 NeedSignReview 参数,在调审批接口时无需RecipientId
如果指定的是签署方维度的 ApproverNeedSignReview,在调审批接口时必须传 RecipientId

您当前正在使用【自建应用集成】功能,升级至【专业版】及以上版本后即可使用

如果是通过集团主代子的方式调用接口报此错误,请联系电子签客户经理开白处理。

签署人 RecipientId 不属于当前模版

在调用 CreatePrepareFlow 接口时报此错误,请确认是否模板发生了调整,模板的任意变化都可能导致 RecipientId 变更。

您上传的文件不是 PDF 格式,导致无法发起合同

通过文件发起合同时,仅支持 PDF 格式的文件。需要注意的是,如果通过创建文件转换任务接口对源文件格式进行了转换,还需要调查询转换任务状态接口去获取转换后的 ResourceId(PDF 格式),用于合同发起。

缺少登录用户 ID,请检查登录账号并重试

自建应用集成中,所有接口的 Operator 字段都是必传,请检查是否少传了此参数。如果没有用电子签提供的 SDK(不建议),请确保传入的所有字段为大写字母开头。