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

合同管理-合同详情

GET
/v2/contract/detail
调用此接口获取合同的详情,支持子公司的合同查询。

请求参数

Query 参数
contractId
string 
可选
合同ID,合同ID于业务ID二选一,不能同时为空
bizId
string 
可选
业务ID,合同ID于业务ID二选一,不能同时为空
tenantName
string 
可选
子公司名称,若使用业务ID查询合同详情,且合同是以子公司身份创建的,则需要传递该值,用于确定合同主体
queryActionOperator
string 
可选
是否查询签署人的信息:如果签署动作已启动时返回待签署人,签署动作已完成时返回实际签署人;如果签署方是平台方或平台方的子公司,才会返回签署人信息
queryLocation
string 
可选
是否查询签署方签署位置信息
queryRelatedContract
string 
是否查询关联合同
可选
querySealStats
string 
可选
是否查询印章签署次数
Header 参数
x-qys-open-accesstoken
string 
可选
默认值:
{{x-qys-open-accesstoken}}
x-qys-open-timestamp
string 
可选
默认值:
{{x-qys-open-timestamp}}
x-qys-open-nonce
string 
可选
默认值:
{{x-qys-open-nonce}}
x-qys-open-signature
string 
可选
默认值:
{{x-qys-open-signature}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://openapi.qiyuesuo.com/v2/contract/detail' \
--header 'x-qys-open-accesstoken: {{x-qys-open-accesstoken}}' \
--header 'x-qys-open-timestamp: {{x-qys-open-timestamp}}' \
--header 'x-qys-open-nonce: {{x-qys-open-nonce}}' \
--header 'x-qys-open-signature: {{x-qys-open-signature}}'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
result
object (ContractResponse) 
必需
id
string 
合同ID
可选
tenantName
string 
发起方名称
可选
subject
string 
合同主题(合同名称)
可选
description
string 
合同描述
可选
sn
string 
合同编号
可选
expireTime
string 
过期时间
可选
publishTime
string 
合同发起时间
可选
tags
array[string]
标签列表
可选
category
object 
业务分类
可选
creator
object (UserResponse) 
创建人
可选
signatories
array[object (SignatoryResponse) {14}] 
签署方
可选
签署合同的公司/个人
documents
array[object (DocumentResponse) {6}] 
合同文档
可选
comments
string 
合同已撤回/已退回状态时的原因说明
可选
invalidReason
string 
合同作废中/已作废状态时的作废原因
可选
endTime
string 
文件的终止时间
可选
signFlowStrategy
string 
接收方签署策略
可选
ANY_SIGN_FINISH(任意一个接收方签署完成,则合同完成)
relatedContractIds
array[string]
否
可选
customFields
array[object (ContractCustomFieldResponse) {7}] 
合同自定义参数
可选
copySendReceivers
array[object (CopySendReceiverResponse) {4}] 
合同抄送人
可选
businessData
string 
自定义业务参数
可选
示例
{
  "result": {
    "id": "3053227767890968697",
    "subject": "接口发起",
    "description": "合同描述",
    "sn": "接口发起",
    "tenantName": "思晨教育",
    "ordinal": true,
    "category": {
      "id": "3053202902198805409",
      "name": "自动化测试-勿动zxs"
    },
    "creator": {
      "name": "韩军超",
      "contact": "18663049557",
      "contactType": "MOBILE"
    },
    "status": "SIGNING",
    "expireTime": "2023-03-19 00:00:00",
    "publishTime": "2023-01-18 15:17:08",
    "signatories": [
      {
        "id": "3053227768113266811",
        "tenantType": "COMPANY",
        "status": "SIGNING",
        "tenantName": "思晨教育",
        "receiver": {
          "name": "韩军超",
          "contact": "18663049557",
          "contactType": "MOBILE"
        },
        "serialNo": 0,
        "actions": [
          {
            "id": "3053227768201347196",
            "type": "AUDIT",
            "status": "START",
            "name": "审批动作",
            "serialNo": 0,
            "autoSign": false,
            "operators": [
              {}
            ]
          },
          {
            "id": "3053227768226513022",
            "type": "LP",
            "status": "INIT",
            "name": "法人签署动作",
            "serialNo": 1,
            "autoSign": false
          },
          {
            "id": "3053227768289427583",
            "type": "COMPANY",
            "status": "INIT",
            "name": "公章签署动作",
            "serialNo": 2,
            "autoSign": false,
            "operators": [
              {}
            ]
          }
        ],
        "delaySet": false,
        "sponsor": true
      },
      {
        "id": "3053227768331370625",
        "tenantType": "PERSONAL",
        "status": "WAITING",
        "tenantName": "韩军超",
        "receiver": {
          "contact": "18663049557",
          "contactType": "MOBILE"
        },
        "serialNo": 1,
        "delaySet": false,
        "sponsor": false
      },
      {
        "id": "3053227780717150393",
        "tenantType": "PERSONAL",
        "status": "WAITING",
        "tenantName": "程桂英",
        "receiver": {
          "contact": "18161426316",
          "contactType": "MOBILE"
        },
        "serialNo": 2,
        "delaySet": false,
        "sponsor": false
      }
    ],
    "documents": [
      {
        "id": "3053227770336247942",
        "title": "ces",
        "pageCount": 2,
        "createTime": "2023-01-18 15:17:07",
        "contentType": "CONTRACT",
        "params": []
      },
      {
        "id": "3053227772693446794",
        "title": "V2添加模板文档",
        "pageCount": 6,
        "createTime": "2023-01-18 15:17:07",
        "contentType": "CONTRACT",
        "params": [
          {
            "name": "乙方姓名",
            "value": "张三",
            "required": false,
            "type": "text"
          },
          {
            "name": "身份证号",
            "required": false,
            "type": "text"
          },
          {
            "name": "合同开始时间",
            "required": false,
            "type": "text"
          },
          {
            "name": "合同截止时间",
            "required": false,
            "type": "text"
          },
          {
            "name": "试用期开始时间",
            "required": false,
            "type": "text"
          },
          {
            "name": "试用期截止时间",
            "required": false,
            "type": "text"
          },
          {
            "name": "薪资",
            "required": false,
            "type": "text"
          },
          {
            "name": "薪资大写",
            "required": false,
            "type": "text"
          },
          {
            "name": "乙方姓名2",
            "required": false,
            "type": "text"
          },
          {
            "name": "乙方姓名3",
            "required": false,
            "type": "text"
          }
        ]
      }
    ],
    "copySendReceivers": [
      {
        "name": "{{userName}}",
        "receiver": {
          "contact": "18663049557",
          "contactType": "MOBILE"
        },
        "createTime": "2023-01-18 15:17:09",
        "send": false
      }
    ]
  },
  "code": 0,
  "message": "SUCCESS"
}
上一页
合同管理-浏览页面
下一页
合同管理-获取合同列表
Built with