平台简介
新手指南
API协议
API文档
单点登录集成
小程序插件
常见问题
开放平台API接口调用常见报错以及解决方法汇总
帮助中心 / 开放平台帮助文档 / 接口问题
接口问题
接口问题

接口问题

合同发起

问题1:测试环境下,账户余额为0.00,无法发起合同。

​ 测试环境下,可以联系客服同事进行充值。

问题2:发起合同时提示错误“用户认证信息与合同经办人信息不匹配:XX”,是什么原因导致的?

​ 接收方手机号对应的账号已经实名认证通过,且认证的姓名与发起时填写的不相符,所以会提示上述错误,建议检查并确认接收方的名称是否有误之后,再重新发起合同。

问题3:如果要求接收方在签署合同的同时也提交相应的材料,如身份证正反面照片,毕业证照片等,合同发起的时候应该怎么设置?

​ 可以在云平台的业务分类模块下,基础信息设置中配置签署方,勾选按预设方式添加签署方,可设置接收方的附件要求;或者调用发起合同接口时,可设置接收方附件(Attachment)的相关信息,这样接收方在签署时便会要求上传对应附件。

问题4:在契约锁云平台创建了一个业务分类,也配置了签署流程,如何在接口发起合同时使用该签署流程发起合同?

​ 调用创建合同草稿接口的时候,category参数指定该业务分类后发起,即可使用该业务分类中指定的签署流程,未指定使用默认业务分类的签署流程。

问题5:使用接口创建草稿状态的合同,为什么在云平台上看不到相关合同信息?

​ 草稿状态的合同只有创建人能查看,所以在接口创建的合同为草稿状态下,需要通过creator参数指定创建人,创建人登陆云平台后就可以看到相应的合同草稿信息了。

问题6: 为什么在开放平台控制台维护好文件模板,通过调用上传模板文件作为合同文件接口时,提示没有使用模板的权限、或模板Id无效?

​ 开放平台控制台维护的文件模板与契约锁云平台维护的文件模板是两个隔离的文件模板种类,不可混用,新版接口使用的是契约锁云平台上维护的文件模板,请登录契约锁云平台:文件 –- 文件模板获取相应的模板Id。

问题7:都是对接方内部企业,两个公司可以使用同一个token调用接口吗?

​ 可以的,登陆云平台,将企业认证通过的子公司加入下级法人单位管理中,接口调用时相应的加上子公司名称(tenantName)参数即可。

合同签署

问题1:如何跟进合同的进度状态,使业务系统能够知道合同的流转情况?

​ 合同支持状态回调,可以在业务分类中配置回调地址,文件在签署过程中,若发生签署、拒绝签署、撤回、退回等事件时,契约锁电子签署平台服务器会向应用的“回调地址”推送相应的事件消息。

问题2:手机短信发送的签署链接会不会过期?

​ 链接不会过期,但是合同有截止签署时间,合同截止签署时间可以设置,合同没有在截止签署时间前完成所有签署就不能继续签署了。

问题3:在发起合同时,作为发起方,添加了经办人签字节点,可以通过接口调用完成经办人签字吗?

​ 目前签署接口仅支持公章签署、法人章签署、审批和作废流程,经办人签字需对应经办人登录契约锁云平台,在页面上进行签署。

问题4:调用签署合同接口时,什么情况下可以不传签署位置参数?

​ 在合同相应的业务分类中,配置预设流程,指定了签署印章和签署位置后,在调用接口签署合同时,可以不传签署位置(stampers)参数。

问题5: 调用公章以及法人章签署接口时均提示“this contract is not turn to sign or has bean signed”,是什么原因导致的?

​ 这种情况一般是合同未到公章或者法人章的签署节点导致的,一般会有如下情况会导致该问题:

​ 1. 合同未发起或者合同已经完成,可通过获取合同详情接口查看合同状态;

​ 2. 合同中不存在调用方的公章或法人章签署节点,请检查发起接口时接收方是否包含该签署节点;

​ 3. 若合同发起时存在调用方的公章或法人章签署节点,调用接口仍失败,请检查是否指定了经办人签署,目前经办人签署仅可登陆契约锁云平台进行签署,签署完成后即可正常调用接口。

问题6:通过印章ID签署,印章的大小是印章图片原本的大小吗?印章显示大小是否可设置?

​ 印章大小在创建印章的时候可以设置 ,在签署的时候不能修改大小。

问题7:获取签署页面的链接有效期是多久?

​ 获取到的链接有效期为10分钟。

个人实名认证

问题1:调用认证接口返回的认证页面为何没有打开过就失效了?

​ 确认复制链接之后是否对链接进行了用聊天软件,包括但不限于QQ、微信等进行传递发送操作,导致了链接失效。链接只能打开一次,此类聊天软件有对链接的安全校验,会在后台默认打开。

问题2:获取个人实名认证页面链接有效期是多久?

​ 个人实名认证链接未打开失效时长为5分钟, 打开页面并在15分钟内未提交则页面失效 。