合同管理-创建合同草稿

请求参数

Header 参数

x-qys-open-accesstoken

string

可选

默认值:

x-qys-open-timestamp

string

可选

默认值:

x-qys-open-nonce

string

可选

默认值:

x-qys-open-signature

string

可选

默认值:

Body 参数application/json

id

string

合同ID

可选

接口返回值

bizId

string

业务ID

可选

一个合同对应一个bizId，不能重复

tenantName

string

子公司名称

可选

若需以子公司身份发起合同需要传递该值，默认为对接方公司

subject

string

合同主题

可选

若业务分类中未配置文件主题按规则生成，则需要传递

description

string

合同描述

可选

sn

string

合同编号

可选

可由用户传入，也可由契约锁自动生成

expireTime

string

合同过期时间

可选

格式为yyyy-MM-dd HH:mm:ss，默认过期时间为业务分类中配置的时

endTime

string

合同终止时间

可选

格式为yyyy-MM-dd HH:mm:ss，传递后会重置为当天23:59:59

ordinal

boolean

是否顺序签署

可选

默认为true

send

string

是否发起合同

可选

发起合同后不能再进行添加文档、指定签署位置等操作

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://openapi.qiyuesuo.com/v2/contract/draft' \
--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}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "sn": "0219",
  "subject": "测试回调SaaS空20",
  "description": "合同描述",
  "expireTime": "2022-12-27 23:59:58",
  "endTime":"2022-12-27 00:00:00",
  "ordinal": false,
  "send": true,
  "tenantName": "上海契约锁电子合同签名有限公司",
  "creator": {
    "contact": "15021504325",
    "contactType": "MOBILE"
  },
 
  "signatories": [{
      "tenantType": "COMPANY",
      "tenantName": "上海契约锁电子合同签名有限公司",
      "receiver": {
        "contact": "15021504325",
        "contactType": "MOBILE"
      },
      "serialNo": 1,
      "actions": [{
        "type": "COMPANY",
        "name": "单位签章" 
      }]
  },
    {
      "tenantType": "PERSONAL",
       "tenantName": "朱明月",
           "receiver": {
                "contact": "test001",
                "contactType": "BIZID"
            },
      "delaySet":"true",
      "serialNo": "4"
    }
  ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

示例

{
    "result": {
        "id": "3053227767890968697",
        "subject": "接口发起",
        "description": "合同描述",
        "sn": "接口发起",
        "tenantName": "思晨教育",
        "ordinal": true,
        "category": {
            "id": "3053202902198805409",
            "name": "自动化测试-勿动zxs"
        },
        "creator": {
            "name": "韩军超",
            "contact": "18663049557",
            "contactType": "MOBILE"
        },
        "status": "DRAFT",
        "expireTime": "2023-02-17 15:17:06",
        "signatories": [
            {
                "id": "3053227768113266811",
                "tenantType": "COMPANY",
                "status": "DRAFT",
                "tenantName": "思晨教育",
                "receiver": {
                    "name": "韩军超",
                    "contact": "18663049557",
                    "contactType": "MOBILE"
                },
                "serialNo": 0,
                "actions": [
                    {
                        "id": "3053227768201347196",
                        "type": "AUDIT",
                        "status": "INIT",
                        "name": "审批动作",
                        "serialNo": 0,
                        "autoSign": false,
                        "operators": [
                            {
                                "contact": "18663049557",
                                "contactType": "MOBILE"
                            }
                        ]
                    },
                    {
                        "id": "3053227768226513022",
                        "type": "LP",
                        "status": "INIT",
                        "name": "法人签署动作",
                        "serialNo": 1,
                        "autoSign": false
                    },
                    {
                        "id": "3053227768289427583",
                        "type": "COMPANY",
                        "status": "INIT",
                        "name": "公章签署动作",
                        "serialNo": 2,
                        "autoSign": false,
                        "operators": [
                            {
                                "contact": "18663049557",
                                "contactType": "MOBILE"
                            }
                        ]
                    }
                ],
                "delaySet": false,
                "sponsor": true
            },
            {
                "id": "3053227768331370625",
                "tenantType": "PERSONAL",
                "status": "DRAFT",
                "tenantName": "韩军超",
                "receiver": {
                    "contact": "18663049557",
                    "contactType": "MOBILE"
                },
                "serialNo": 1,
                "delaySet": false,
                "sponsor": false
            }
        ]
    },
    "code": 0,
    "message": "SUCCESS"
}