对接必读

灵活用工人员签约

商户付款

灵活用工人员签约(settle.register.api.sign）

简要描述

通过API方式进行灵活用工人员的API标准签约，签约接口返回签约页面地址；

签约完成后跳转页面回调地址，异步通知签约结果。若商户配置了API快速签约此接口不可调用。

请求参数

参数名 类型 是否必填 最大长度 参数含义 参数说明
persNo String 是 32 灵活用工人员编号 注册时返回的persNo
serverCallbackUrl String 是 512 后台通知地址 签约成功后服务器端通知地址
webCallbackUrl String 是 512 前台通知地址 签约成功后跳转回商户页面地址

响应参数

参数名 类型 参数含义 参数说明
redirectUrl String 手动签约地址 商户接收后跳转该地址让用户进行签约
contactNo String 合同号 用户签约合同的编号
code String 返回码 详见错误表
message String 错误信息描述 详见错误码表

服务端异步通知参数

参数名 类型 参数含义 参数说明
persNo String 灵活用工人员编号 签约灵活用工人员编号
signStat Int 签约状态 4-签约成功，5-签约失败，其他状态为签约中
downloadUrl String 合同下载地址 调用该链接获取合同pdf文件
signCompleteTime String 签约完成时间 格式yyyy-MM-dd HH:mm:ss
contractName String 合同名称
failReason String 失败理由 签约失败理由，signStat=5时，该参数有值
contractNo String 合同编号

错误码

错误码 错误码描述
0000 成功
0001 参数为空或格式错误
9999 系统异常
0011 客户信息不存在核对灵活用工人员编号是否正确
0017 签约失败
0023 首次调用签约接口，返回code码0000包含协议链接
如果灵活用工人员已注册且协议签署完成，调用签约接口时返回code码0023（无协议链接）