通知换班通过
更新于 2023-01-18通过本接口，换班审批通过后，通知考勤执行换班动作，可以和自己换班，也可以和别人换班。
例如，企业某员工11月2日排班，该员工需要换班，在企业自有的审批系统提交了补卡申请审批单，审批通过后调用本接口通知考勤执行换班动作。
换班约束条件如下：
换班双方必须都在排班制考勤组。
换班日期和还班日期双方必须都要有排班或排休。
换完班后的打卡时间不能有冲突。例如1号的排班是8：00-22：00，2号的排班是10：00-次日9：00，假如1号和2号换班。换完班后1号的排班是10：00-次日9：00，2号的排班是8：00-22：00，此时1号的打卡时间范围内包含了2号上班时间，这种情况称之为打卡时间冲突。
换班不支持撤销。
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。
基本信息
请求方式：POST
请求地址：https://oapi.dingtalk.com/topapi/attendance/approve/schedule/switch
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 6d1bxxxx | 调用该接口的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
userid | String | 是 | manager123 | 发起人的userId。 |
switch_date | String | 是 | 2019-09-08 | 申请换班日期，当天必须有排班或排休。 |
reback_date | String | 是 | 2019-09-09 | 还班日期，当天必须有排班或排休。 说明 如果申请换班人和被换班人是同一个人，那么必须要有还班日期。 |
apply_userid | String | 是 | manager123 | 申请换班人的userId，仅支持排班制考勤组用户。 |
target_userid | String | 是 | user123 | 被换班人的userId，仅支持排班制考勤组用户。 |
approve_id | String | 是 | 2376620852 | 审批单ID，自定义参数值。 |
apply_shift_id | Number | 是 | 1234566 | 申请人换班日期当天的班次ID。
|
target_shift_id | Number | 是 | 1234566 | 被换班人换班日期当天的班次ID。
|
reback_apply_shift_id | Number | 是 | 1234566 | 申请人还班日期当天的班次ID。
|
reback_target_shift_id | Number | 是 | 1234566 | 被换班人还班日期当天的班次ID。
|
返回参数
名称 | 类型 | 示例值 | 描述 |
errcode | Number | 0 | 返回码。 |
errmsg | String | ok | 返回码描述。 |
示例
请求示例（HTTP）
请求正文
请求示例（JAVA SDK）
返回示例
