契约锁 API

签署服务-公章签署

POST

/v2/contract/companysign

若合同存在平台方公司或平台方子公司的公章节点时，调用此接口完成公章签署。

请求参数

Header 参数

x-qys-open-accesstoken

string

可选

默认值:

x-qys-open-timestamp

string

可选

默认值:

x-qys-open-nonce

string

可选

默认值:

x-qys-open-signature

string

可选

默认值:

Body 参数application/json

contractId

string

合同ID

可选

合同ID与业务ID二选一，不能同时为空

bizId

string

业务ID

可选

合同ID与业务ID二选一，不能同时为空

tenantName

string

签署方名称

可选

若以子公司身份签署，需要传递子公司全名

sealId

string

印章ID

可选

若指定了签署位置，可直接在此传递印章ID，同时若下方签署位置参数中无印章ID，会从此处获取

locateAllStamperKeywords

boolean

是否必须找出全部签署位置传入的关键字

可选

默认为true；传入false时，对于传入的关键字定位的签署位置，只需定位到任意一个签署位置的关键字即可

stampers

array[object (StamperRequest) {9}]

指定签署位置

可选

type

enum<string>

签署类型

必需

COMPANY（公章），TIMESTAMP（时间戳），ACROSS_PAGE（骑缝章）

枚举值:

COMPANYTIMESTAMPACROSS_PAGE

documentId

string

合同文档ID

必需

sealId

string

印章ID

可选

keyword

string

关键字

可选

keywordIndex

integer

关键字索引

可选

1代表第1个关键字，0代表所有关键字，-1代表倒数第1个关键字；默认为1

page

string

坐标页码

可选

0代表所有,-1代表最后一页

offsetX

string

横坐标/关键字偏移量

可选

offsetY

string

纵坐标/关键字偏移量

可选

datePattern

enum<string>

时间戳格式

可选

HYPHEN（yyyy-mm-dd），Chinese（yyyy年mm月dd日（阿拉伯数字）），ALL_Chinese（yyyy年mm月dd日（中文））；仅type为TIMESTAMP时生效，默认为HYPHEN

枚举值:

HYPHENChineseALL_Chinese

示例

{
  "contractId": "{{create_contractId}}",
  "bizId": null,
  "stampers": [
    {
      "type": "COMPANY",
      "documentId": "{{create_documentId}}",
      "sealId": "2566229349702860958",
      "offsetX": "0.2",
      "offsetY": "-0.2",
      "keyword": "劳动",
      "keywordIndex": "2"
    },
    {
      "type": "TIMESTAMP",
      "documentId": "{{create_documentId}}",
      "sealId": "2566229349702860958",
      "offsetX": "0.5",
      "offsetY": "0.5",
      "page": "1"
    },
    {
      "type": "ACROSS_PAGE",
      "documentId": "{{create_documentId}}",
      "sealId": "2566229349702860958",
      "offsetY": "0.5"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.qiyuesuo.com/v2/contract/companysign' \
--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 '{
    "contractId": "{{create_contractId}}",
    "bizId": null,
    "stampers": [
        {
            "type": "COMPANY",
            "documentId": "{{create_documentId}}",
            "sealId": "2566229349702860958",
            "offsetX": "0.2",
            "offsetY": "-0.2",
            "keyword": "劳动",
            "keywordIndex": "2"
        },
        {
            "type": "TIMESTAMP",
            "documentId": "{{create_documentId}}",
            "sealId": "2566229349702860958",
            "offsetX": "0.5",
            "offsetY": "0.5",
            "page": "1"
        },
        {
            "type": "ACROSS_PAGE",
            "documentId": "{{create_documentId}}",
            "sealId": "2566229349702860958",
            "offsetY": "0.5"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

示例

{
  "code": 0,
  "message": "SUCCESS"
}

合同管理-获取合同与附属文件下载链接

签署服务-签署法人章