客户合同接口

新增客户合同任务接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/contract/v1/addContract/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
    "contract_code": "CM0001",
    "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) 签署截止日期
unsign_file_url VARCHAR(4000) 签署文件URL
remark VARCHAR(1000) 备注
creator_id VARCHAR(32) 创建人ID
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_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) 创建时间
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) 签署截止日期
file_url VARCHAR(4000) 签署文件URL
remark VARCHAR(1000) 备注
contract_name VARCHAR(32) 合同名称
contract_status VARCHAR(32) 合同状态
part_b_sign_time VARCHAR(32) 乙方签署时间
part_a_sign_time VARCHAR(32) 甲方签署时间
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-失败, 其他参照附件错误码
return_msg String 响应说明

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

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/contract/v1/getTenantVerification/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

参数说明:

参数 类型 必填 说明

返回结果数据说明:

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

返回结果:

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": "",
	"response_data": [{"tenantId":"1","tenantName":"xxx科技公司","artificialPerson":"张三","artificialMobile":"18455124451"}]
}