员工纳税人时间范围变更¶
功能说明¶
根据userid更新员工纳税人时间范围
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/employee/taxpayer/updateRange
- 生产环境: https://openapi.guanaitong.com/employee/taxpayer/updateRange
HTTP请求方式¶
- Method: POST
- Content-Type: application/x-www-form-urlencoded
参数说明¶
- 公有参数
发送请求是必须传入公共参数,详见公共参数
- 私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| userid | 是 | string | [1,100] | 员工第三方唯一标识,不会变更 |
| enterprise_code | 否 | string | [1,20] | 企业编号(集团和运营商必填,企业不填) |
| taxpayer_identifier | 是 | string | [15,18] | 纳税人识别号 (事先管理端提前维护) |
| third_type | 否 | int | [1,5] | 第三方类型,1:企业微信, 2:钉钉,3:飞书,4, 定制, 5:标准对接,非必填默认5 |
| start_date | 否 | string | [10] | 纳税人开始时间 YYYY-MM-DD |
| end_date | 否 | string | [10] | 纳税人结束时间 YYYY-MM-DD |
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码。详见错误返回码。 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回true。 |
正确返回示例¶
常见错误码¶
| 错误码 | 错误信息 | 排查方法 |
|---|---|---|
| 1000220002 | 参数验证不通过 | 检测参数是否符合要求,如:entryDay日期格式错误, 需要yyyy-MM-dd的日期格式 |
| 1000220096 | 该用户ID对应员工不存在 | userid对应员工是否已添加 |
| 1000220102 | 员工不存在 | userid对应员工是否已添加 |
| 1002219003 | 员工工号已存在 | 员工工号已存在,工号企业下唯一 |
| 1000220010 | dept_code not exists ! | 部门编号不存在,校验是否对应部门已添加 |
| 1002218004 | 会员:邮箱已存在 | 邮箱已存在,邮箱企业下唯一 |
| 1002218007 | 会员:手机已存在 | 手机已存在,手机号企业下唯一 |
| 1002219046 | 员工身份证号码错误 | 身份证类型是大陆身份,不符合大陆身份证号格式 护照,只能为1-20位大小写字母和数字 |
| 1000220030 | 该员工分级未设置 | 需要去企业管理后台设置 |
| 1000210028 | 该员工分类未设置 | 需要去企业管理后台设置 |
| 1000220072 | politicalVisage1未启用,扩展信息字段attributeCode错误或未启用 | 需要去企业管理后台设置 |
| 1000240002 | enterprise_code校验失败 | 检查enterprise_code是否是已绑定的编码 |
| 1002219069 | 员工国际区号不存在 | 对应手机号区号,检查是否是正确的国际电话区号 |
| other | 其他公共错误码 | 其他公共错误码 |