提示:通过合同接口创建的合同,甲方企业必须通过自有系统进行签署,勤策平台界面仅支持查看,乙方仍可以正常通过订货平台签署

# 客户合同接口

# 新增客户合同任务接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/contract/v1/addContract/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "contract_code": "CM0001",
    "contract_name": "CM0001-name",
    "contract_start_date": "2022-06-01",
    "contract_end_date": "2022-08-01",
    "contract_type": "7389771106639629767",
    "part_a_tenant": "7389771106639629767",
    "part_a_auth": "7389771106639629767",
    "part_a_auth_code": "7389771106639629767",
    "part_b_cm": "7389771106639629767",
    "part_b_cm_code": "7389771106639629767",
    "sign_end_date": "2019-09-24",
    "unsign_file_url": "http://XXX/XXX/XXX/XXX/pdf",
    "remark": "XXX",
    "creator_id":"7389771106639629767",
    "pos_list": [
        {
            "signType": "1",
            "part_a_keyword": "123456789",
            "part_b_keyword": "123456789"
        },
        {
            "signType": "2",
            "part_a_position_x": "200",
            "part_a_position_y": "200",
            "part_a_sign_page": "1-2",
            "part_b_position_x": "200",
            "part_b_position_y": "200",
            "part_b_sign_page": "1-2"
        },
        {
            "signType": "3",
            "part_a_seal_y": "200",
            "part_b_seal_y": "400"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
contract_code VARCHAR(32) 合同编号
contract_type VARCHAR(32) 合同类型ID
part_a_tenant VARCHAR(32) 甲方签署企业ID
part_a_auth VARCHAR(32) 甲方授权人ID
part_a_auth_code VARCHAR(32) 甲方授权人CODE
part_b_cm VARCHAR(32) 乙方签署客户ID
part_b_cm_code VARCHAR(32) 乙方签署客户CODE
sign_end_date VARCHAR(32) 签署截止日期。格式:yyyy-MM-dd
unsign_file_url VARCHAR(4000) 签署文件URL
contract_name VARCHAR(32) 合同名称,如不传直接取乙方的客户编码
contract_start_date VARCHAR(32) 合同有效起始日期。格式:yyyy-MM-dd
contract_end_date VARCHAR(32) 合同有效结束日期。格式:yyyy-MM-dd
remark VARCHAR(1000) 备注
creator_id VARCHAR(32) 创建人ID
pos_list List 列表
pos_list.signType VARCHAR(32) 签署位置定位方式。1:关键字,2,坐标,3:骑缝章
pos_list.part_a_keyword VARCHAR(32) 甲方关键字。当选择关键字定位时甲乙方关键字最少填一个
pos_list.part_b_keyword VARCHAR(32) 乙方关键字。当选择关键字定位时甲乙方关键字最少填一个
pos_list.part_a_position_x VARCHAR(32) 甲方坐标定位-x坐标。当选择甲方坐标定位,传参时x坐标、y坐标、页码信息均不能为空,x坐标取值范围[153,595]
pos_list.part_a_position_y VARCHAR(32) 甲方坐标定位-y坐标。y坐标取值范围[153,842]
pos_list.part_a_sign_page VARCHAR(32) 甲方坐标定位-页码
pos_list.part_b_position_x VARCHAR(32) 乙方坐标定位-x坐标。当选择乙方坐标定位,传参时x坐标、y坐标、页码信息均不能为空,x坐标取值范围[153,595]
pos_list.part_b_position_y VARCHAR(32) 乙方坐标定位-y坐标 。y坐标取值范围[153,842]
pos_list.part_b_sign_page VARCHAR(32) 乙方坐标定位-页码
pos_list.part_a_seal_y VARCHAR(32) 甲方骑缝章y坐标。当选择骑缝章时,甲乙方骑缝章y坐标均不能为空
pos_list.part_b_seal_y VARCHAR(32) 乙方骑缝章y坐标

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
        {
            "contract_id": "7863150652620035205"
        }
]

参数说明:

参数 类型 说明
contract_id VARCHAR(32) 合同id(业务流程ID)

# 查询客户合同类型接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/contract/v1/queryContractType/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{   
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
        {
            "id": "7863150652620035205",
            "code": "CM0001",
            "name": "默认合同类型",
			"status":"1",
			"is_use":"1",
			"remark":"备注"
        }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 类型id
name VARCHAR(100) 类型名称
code VARCHAR(32) 类型编码
status VARCHAR(32) 是否删除。1:正常,0:删除
is_use VARCHAR(32) 是否启用。1:启用
remark VARCHAR(100) 备注

# 查询乙方客户签署合同任务接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/contract/v1/queryContractAfterPartB/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "contract_id":"7863150652620035205",
    "contract_code": "CM0001"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
contract_id varchar(32) 合同id (业务流程ID),合同id和合同code不能同时为空
contract_code varchar(32) 合同code (合同编码),合同id和合同code不能同时为空
contract_status varchar(32) 合同状态。1:待签署,2:签署中,3:已签署,4:已拒签,6:已撤销

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
        {
            "id": "7863150652620035205",
			"status":"1",
			"create_time":"2019-10-22",
            "contract_code": "CM0001",
            "contract_type": "合同类型",
			"contract_type_name":"合同类型名称",
			"contract_type_code":"合同类型编码",
            "part_a_tenant":"7863150652620035205",
            "part_a_auth":"7863150652620035205",
            "part_a_auth_code":"dddddd",
            "part_b_cm": "7389771106639629767",
            "part_b_cm_code": "cccccc",
            "sign_end_date": "2019-09-24",
            "file_url": "http://XXX/XXX/XXX/XXX/pdf",
            "remark":"",
			"contract_name":"合同名称",
			"contract_show_name":"合同名称.pdf",
			"contract_status":"1",
            "part_b_sign_time":"2019-10-22 15:30",
			"part_a_sign_time":"2019-10-22 15:30",
			"part_b_auth":"7863150652620035205",
			"reject_reason":"拒绝理由"
            
        }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 合同id(业务流程ID)
status varchar(32) 状态。1:正常,0:删除
create_time varchar(32) 创建时间。格式:yyyy-MM-dd
contract_code VARCHAR(32) 合同编号
contract_type VARCHAR(32) 合同类型ID
contract_type_name VARCHAR(32) 合同类型名称
contract_type_code VARCHAR(32) 合同类型编码
part_a_tenant VARCHAR(32) 甲方签署企业ID
part_a_auth VARCHAR(32) 甲方授权人ID
part_a_auth_code VARCHAR(32) 甲方授权人code
part_b_cm VARCHAR(32) 乙方签署客户ID
part_b_cm_code VARCHAR(32) 乙方签署客户code
sign_end_date VARCHAR(32) 签署截止日期。格式:yyyy-MM-dd
file_url VARCHAR(4000) 签署文件URL
remark VARCHAR(1000) 备注
contract_name VARCHAR(32) 合同名称
contract_status VARCHAR(32) 合同状态
part_b_sign_time VARCHAR(32) 乙方签署时间。格式:yyyy-MM-dd HH:mi
part_a_sign_time VARCHAR(32) 甲方签署时间。格式:yyyy-MM-dd HH:mi
part_b_auth VARCHAR(32) 乙方签署人
reject_reason VARCHAR(100) 拒绝理由
contract_show_name VARCHAR(100) 合同名称,如果在新增合同时有传该字段,则保存对应的所传信息,如果不传,则为文件url中截取的部分,例如http://AAA/BBB/CCC.pdf截取为CCC.pdf

# 第三方签署文件回传

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/contract/v1/signByPartA/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "contract_id":"7863150652620035205",
    "sign_file_url":""
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
contract_id varchar(32) 合同id (业务流程ID)
sign_file_url varchar(4000) 甲方签署后文件url

响应示例:

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 获取系统认证过的甲方企业信息

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/contract/v1/getTenantVerification/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "tenantId":"1",
        "tenantName":"xxx科技公司",
        "artificialPerson":"张三",
        "artificialMobile":"18455124451"
    }
]

参数说明:

字段名 类型 说明
tenantId VARCHAR(32) 系统认证企业对应的外勤id
tenantName VARCHAR(32) 系统认证企业名字
artificialPerson VARCHAR(32) 系统认证法人的名字
artificialMobile VARCHAR(32) 法人手机号码

# 查询电子合同数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/contract/v1/getOnlineContracts/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
  "page_number": "1",
  "page_length": "1000",
  "code":"XSHT_202209267939",
  "contract_status":"1",
  "start_create_date":"2022-09-26 14:09:04",
  "end_create_date":"2022-09-26 14:09:05",
  "type_id":"2",
  "type_code":"CUS000034"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
page_number varchar(32) 页码默认1
page_length varchar(32) 每页默认1000条
code varchar(32) 合同编号
contract_status varchar(32) 合同状态。1:待签署,2:签署中,3:已签署,4:已拒签,6:已撤销,7:待填写,8:填写中
start_create_date varchar(32) 开始创建时间。格式:YYYY-MM-DD hh:mm:ss
end_create_date varchar(32) 结束创建时间。格式:YYYY-MM-DD hh:mm:ss
type_id varchar(32) 签署人的类型: 1-企业 2-客户 0-员工
type_code varchar(32) 签署人编码:若是客户则需要传客户编码,若是企业或员工则需要传入员工编码

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
  {
    "contract_amount":"",
    "modify_name":"cjj",
    "contract_status":"1",
    "modify_time":"2022-09-26 14:09:04",
    "is_remind":"0",
    "remark":"",
    "contract_start_date":"2022-09-05",
    "contract_end_date":"2022-10-09",
    "contract_code":"XSHT_202209267939",
    "sign_end_date":"2022-10-08",
    "refuse_code":"",
    "contract_type_name":"企业章",
    "pay_type_id":"",
    "responsible_person_code":"021601",
    "remind_days":"",
    "id":7657350526962485177,
    "create_code":"cjj",
    "sales_opportunity_id":"",
    "current_signer_code":"yp",
    "create_time":"2022-09-26 14:09:04",
    "refuse_name":"",
    "refuse_reason":"",
    "contract_name":"cjj-企业-员工-客户",
    "sign_party":[
      {
        "signer_name":"yp",
        "org_type":"1",
        "signer_code":"yp"
      },
      {
        "signer_name":"cjj",
        "org_type":"0",
        "signer_code":"cjj"
      },
      {
        "signer_name":"062301",
        "org_type":"2",
        "signer_code":"CUS000034"
      }
    ],
    "auto_stamp":"1",
    "refuse_time":"",
    "sign_file_url":"https://wqcloud.shcengyu.com/contract_redirect/6264681423410307926/customer_contract_contract/202209/origin/7797954029192820435.pdf?Expires=1665838227&amp;OSSAccessKeyId=LTAI4Fkk66e1yEYkeG8dykyp&amp;Signature=u3Y0jmJWahHl6883bD3yTxUYaw8%3D",
    "responsible_person_name":"021601",
    "sales_opportunity_name":"",
    "pay_type_name":"",
    "modify_code":"cjj",
    "current_signer_name":"yp",
    "create_name":"cjj"
  }
]

参数说明:

字段名 类型 说明
contract_code VARCHAR() 合同编号
sign_file_url VARCHAR() 合同文件
contract_name VARCHAR() 合同名称
responsible_person_code VARCHAR() 负责人编码
responsible_person_name VARCHAR() 负责人名称
contract_type_name VARCHAR() 合同类型
sign_party List 签署方
sign_party.signer_name VARCHAR() 签署方名称
sign_party.org_type VARCHAR() 签署方类型 1-企业 2-客户 0-员工
sign_party.signer_code VARCHAR() 签署方编码
auto_stamp VARCHAR() 是否自动加盖骑缝章 1是2否
sign_end_date VARCHAR() 合同签署截止日期
current_signer_code VARCHAR() 当前处理人编码
current_signer_name VARCHAR() 当前处理人名称
sales_opportunity_id VARCHAR() 所属商机编码
sales_opportunity_name VARCHAR() 所属商机名称
contract_start_date VARCHAR() 合同有效期开始
contract_end_date VARCHAR() 合同有效期结束
contract_status VARCHAR() 签署状态 1:待签署,2:签署中,3:已签署,4:已拒签,6:已撤销,7:待填写,8:填写中
is_remind VARCHAR() 是否到期提醒 1是0否
remind_days VARCHAR() 提前提醒天数
contract_amount VARCHAR() 合同金额
pay_type_name VARCHAR() 付款方式
remark VARCHAR() 备注
refuse_code VARCHAR() 拒签人编码
refuse_name VARCHAR() 拒签人名称
refuse_time VARCHAR() 拒签时间
refuse_reason VARCHAR() 拒签原因
modify_code VARCHAR() 最后修改人编码
modify_name VARCHAR() 最后修改人名称
modify_time VARCHAR() 最后修改时间
create_code VARCHAR() 创建人编码
create_name VARCHAR() 创建人名称
create_time VARCHAR() 创建时间