契约锁 API
  1. 常见问题
契约锁 API
  • 平台简介
    • 平台简介
  • 新手指南
    • 接入流程
    • 名称解释
    • 接入示例
  • API协议
    • API协议
  • API文档
    • 合同管理
      • 合同管理-创建合同草稿
      • 合同管理-用文件添加合同文档
      • 合同管理-多文件添加合同文档
      • 合同管理-用模板添加合同文档
      • 合同管理-发起合同
      • 合同管理-抄送合同
      • 合同管理-修改签署方
      • 合同管理-添加签署方
      • 合同管理-浏览页面
      • 合同管理-合同详情
      • 合同管理-获取合同列表
      • 合同管理-下载合同与附属文件
      • 合同管理-下载合同文档
      • 合同管理-强制结束合同
      • 合同管理-上传强制结束附件
      • 合同管理-合同文档添加水印
      • 合同管理-合同延期
      • 合同管理-获取合同操作记录
      • 合同管理-获取合同与附属文件下载链接
    • 签署服务
      • 签署服务-公章签署
      • 签署服务-签署法人章
      • 签署服务-审批
      • 签署服务-合同催签
      • 签署服务-签署页面
      • 签署服务-预签署页面
      • 签署服务-获取短链接
      • 签署服务-撤回/作废合同
      • 签署服务-自定义文件作废合同
      • 签署服务-自定义模板文件作废合同
      • 签署服务-签署作废合同
      • 签署服务-签署个人签名
    • 组织架构
      • 组织架构-子公司列表
      • 组织架构-发送子公司邀请
      • 组织架构-移除子公司
      • 组织架构-对接方信息
      • 组织架构-公司详情
      • 组织架构-获取企业信息变更链接
      • 组织架构-员工列表
      • 组织架构-添加员工
      • 组织架构-更新员工
      • 组织架构-员工详情
      • 组织架构-管理员工角色
      • 组织架构-移除员工
    • 印章管理
      • 印章管理-印章列表
      • 印章管理-印章图片
      • 印章管理-创建印章
      • 印章管理-印章详情
      • 印章管理-编辑印章
      • 印章管理-创建图片印章
      • 印章管理-管理印章状态
      • 印章管理-删除印章
      • 印章管理-公司印章
    • 模板管理
      • 模板管理-模板列表
      • 模板管理-模板详情
      • 模板管理-模版预览页面
      • 模板管理-创建Word模板
      • 模板管理-编辑模板
      • 模板管理-管理模板状态
      • 模板管理-下载模板
      • 模板管理-删除模板
    • 业务分类
      • 业务分类-业务分类列表
      • 业务分类-业务分类详情
    • 个人认证
      • 个人认证-获取个人认证链接
      • 个人认证-查询个人认证状态
    • 企业认证
      • 企业认证-获取企业认证链接PC
      • 企业认证-获取企业认证链接H5
      • 企业认证-获取企业认证链接-带营业执照PC
      • 企业认证-获取企业认证链接-带营业执照H5
      • 企业认证-查询认证结果
    • 外部客户
      • 外部客户-新增外部客户
    • 授权管理
      • 授权管理-单点登录模块授权页面
      • 授权管理-个人签名授权页面
      • 授权管理-取消个人签名授权
      • 授权管理-查询个人静默签授权记录
    • 辅助工具
      • 辅助工具-文件验签
    • 信息校验
      • 信息校验-个人身份校验
      • 信息校验-企业身份校验
  • 单点登录集成
    • 集成流程说明
    • 单点登录
    • 单点登出
    • CAS验证接口规范
  • JS SDK文档
    • JS SDK简介
    • 集成方式说明
    • 对接方服务端接口说明
  • 公告
    • 关于开发平台控制台的说明
  • 小程序插件
    • 插件简介
    • 插件集成说明
    • 生成合同签署令牌
    • 生成个人认证令牌
    • 生成企业认证令牌
    • 生成企业认证令牌(带营业执照)
    • 插件更新记录
  • 常见问题
    • 认证问题
    • 配置问题
    • 接口问题
    • 其他问题
  1. 常见问题

接口问题

合同发起#

问题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分钟内未提交则页面失效 。
上一页
配置问题
下一页
其他问题
Built with