1.2 添加自由职业者
简要描述:
- 添加自由职业者/个人/人员,企业在引导自由职业者签约之前,需要将自由职业者信息添加到平台。当用户重复时,系统会默认返回已经重复的自由职业者id.
请求头参数:
Authorization: Bearer [accessToken]
请求URL:
- /contracts/employees/add
请求方式:
- POST
参数:
请求参数说明
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
name | string | 是 | 姓名,在上传身份证照片时,会以身份证OCR识别的结果覆盖。 |
phone | string | 否 | 登记手机号,系统将以手机号码和姓名作为用户唯一标识。phone和employeeNo不能同时为空! |
employeeNo | string | 否 | 自由职业者在企业的唯一编号,phone和employeeNo不能同时为空! |
papersType | int | 否 | 证件类型 0:身份证 |
papersNo | string | 否 | 证件号码 |
providerId | string | 是 | 服务商Id,当一个企业有跟多个服务商合作,则必须指定是服务商Id |
bankCardNo | string | 否 | 银行卡号 |
bankPhone | string | 否 | 银行预留手机号 |
notifyUrl | string | 否 | 接收该自由职业者签约结果的后端回调url。当该url没有传值时,系统会使用后台开发者配置中的回调链接。注意:该url必须为可以直接访问的http链接,例如:https://www.baidu.com |
extra | string | 否 | 扩展参数,回调时原文返回,建议JsonString格式。 |
nonce | string | 是 | 随机字符串,长度要求在32位以内。推荐 |
sign | string | 是 | 通过签名算法计算得出的签名值,详见 |
返回结果示例
成功示例
{
"extra": "string",
"employeeId": "12345678"
}
失败示例
{
"error": "BadRequest",
"message": "手机号码格式有误,"
}
响应参数说明
参数 | 类型 | 说明 |
---|---|---|
employeeId | string | 返回该自然人在工资来了平台唯一编号,该值需要调用方保存, 查询签约结果,签约结果回调都会需要该值.ex |
extra | string | 扩展参数,回调时原文返回,建议JsonString格式 |