合同管理-创建合同草稿

POST

/v2/contract/draft

根据业务分类的预设配置或者接口的传参，创建相应的合同草稿，业务分类在契约锁云平台中配置。若合同文件已提前在云平台业务分类中维护，可通过send参数设置创建并直接发起合同。创建合同草稿后，支持传入合同id或bizId，进行草稿合同信息的覆盖修改。

请求参数

Header 参数

Body 参数application/json

示例

{
  "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"
    }
  ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

示例

{
    "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"
}

修改于 2023-01-19 03:00:25

API协议

合同管理-用文件添加合同文档