# 修改发放记录 更新发放记录的发放数量和失效日期，对应假勤管理-休假管理-[发放记录](https://example.feishu.cn/people/workforce-management/manage/leave/leave_admin/granting_record) **注意事项**：- 仅飞书人事企业版可用 - 由系统生成的发放记录不可被更新 - 仅可更新「发放数量」和「失效日期」 ## 请求 基本 |   ---|--- HTTP URL | https://open.feishu.cn/open-apis/attendance/v1/leave_accrual_record/:leave_id HTTP Method | PATCH 接口频率限制 | [50 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) 支持的应用类型 | Custom App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 写入打卡管理规则(attendance:rule) 字段权限要求 | **注意事项**：该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请
获取用户 user ID(contact:user.employee_id:readonly) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use) Content-Type | string | 是 | **固定值**："application/json; charset=utf-8" ### 路径参数 名称 | 类型 | 描述 ---|---|--- leave_id | string | 假期类型ID，可通过[获取假期类型列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/leave_types)获取
**示例值**："7111688079785723436" ### 查询参数 名称 | 类型 | 必填 | 描述 ---|---|---|--- user_id_type | string | 否 | 用户 ID 类型
**示例值**：open_id
**可选值有**：
- open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)
- union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id)
- user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id)
- people_corehr_id：以飞书人事的 ID 来识别用户
**默认值**：`open_id`
**当值为 `user_id`，字段权限要求**：
获取用户 user ID(contact:user.employee_id:readonly) ### 请求体 名称 | 类型 | 必填 | 描述 ---|---|---|--- leave_granting_record_id | string | 是 | 发放记录的唯一ID，可通过[创建假期发放记录](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave_granting_record/create)
**示例值**："6893014062142064135" employment_id | string | 是 | 员工ID，类型对应user_id_type
**示例值**："6982509313466189342" leave_type_id | string | 是 | 假期类型ID，可通过[获取假期类型列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/leave_types)获取
**示例值**："7111688079785723436" reason | lang_text\[\] | 是 | 修改发放记录原因 lang | string | 是 | 语言码
**示例值**："zh_CN" value | string | 是 | 语言码对应的文本
**示例值**："test" time_offset | int | 否 | 时间偏移，东八区：480 8*60
**示例值**：480 expiration_date | string | 否 | 失效日期，格式"2020-01-01"
**示例值**："2020-01-01" quantity | string | 否 | 修改发放数量
**示例值**："1" ### 请求体示例 ```json { "leave_granting_record_id": "6893014062142064135", "employment_id": "6982509313466189342", "leave_type_id": "7111688079785723436", "reason": [ { "lang": "zh_CN", "value": "test" } ], "time_offset": 480, "expiration_date": "2020-01-01", "quantity": "1" } ``` ## 响应 ### 响应体 名称 | 类型 | 描述 ---|---|--- code | int | 错误码，非 0 表示失败 msg | string | 错误描述 data | \- | \- record | leave_accrual_record | 员工过期日期的发放记录 id | string | 发放记录唯一ID employment_id | string | 员工ID，类型对应user_id_type leave_type_id | string | 假期类型ID granting_quantity | string | 发放数量 granting_unit | int | 发放单位，1表示天，2表示小时 effective_date | string | 生效日期，格式为yyyy-MM-dd expiration_date | string | 失效日期，格式为yyyy-MM-dd granted_by | int | 发放来源，1：系统发放；2：手动发放；3：外部系统发放 reason | lang_text\[\] | 发放原因 lang | string | 语言码 value | string | 语言码对应的文本 created_at | string | 发放记录的创建时间，unix时间戳 created_by | string | 发放记录的创建人的ID，类型对应user_id_type updated_at | string | 发放记录的更新时间，unix时间戳 updated_by | string | 发放记录的更新人的ID，类型对应user_id_type ### 响应体示例 ```json { "code": 0, "msg": "success", "data": { "record": { "id": "6893014062142064135", "employment_id": "6982509313466189342", "leave_type_id": "6893014062142064135", "granting_quantity": "1", "granting_unit": 1, "effective_date": "2020-01-01", "expiration_date": "2020-01-01", "granted_by": 1, "reason": [ { "lang": "zh_CN", "value": "test" } ], "created_at": "1687428000", "created_by": "6982509313466189342", "updated_at": "1687428000", "updated_by": "6982509313466189342" } } } ``` ### 错误码 HTTP状态码 | 错误码 | 描述 | 排查建议 ---|---|---|--- 400 | 1220016 | Invalid param | 对照接口文档的入参排查，是否漏填参数、格式错误等（例如数值参数传了字母、日期格式错误等） 400 | 1220003 | Invalid effective date | 日期格式必须是类似“2020-01-01” 400 | 1220001 | No tenant ID | 租户ID为空 400 | 1220006 | Employment not found | 检查employmentID是否正确 400 | 1220002 | Invalid granting unit | 授予单位出错 400 | 1220004 | Invalid granting quantity | 必须是能解析成数字的字符串，例如“2.5” 400 | 1220005 | Accessed data object not found | 检查leaveTypeID是否正确 400 | 1220007 | Leave plan version not found | 假期计划版本数据不存在，请检查该类型的假期对应的计划配置是否创建 400 | 1220008 | Error occurred while checking if the employee is eligible for the vacation plan | 员工不适用于假期计划版本，请检查该假期计划适用人员范围是否和员工信息匹配 400 | 1220009 | Accrual rule not found | 检查该假期计划版本是否正确创建，是否存在有效的发放规则 400 | 1220010 | Granting record already exists | response里会带上已存在的发放记录的信息，用户可以将其取出，不需要再重试请求 500 | 1220011 | Error occurred when getting employment information | 获取员工信息失败 500 | 1220012 | An exception occurs in the database | 数据库异常，请联系 [技术支持](https://applink.feishu.cn/TLJpeNdW) 500 | 1220013 | Error occurred while checking if the employee is eligible for the vacation plan. | 检查员工是否符合假期计划适用范围时发生错误 500 | 1220028 | There is an error in the unit conversion configuration in the granting rule | 检查假期计划版本的单位转换规则是否配置正确 500 | 1220014 | Error occurred when calculate accrual record | 计算授予计划错误 400 | 1220024 | There is a subclass for the leave type, but the subclass ID has not been passed | 如果假期类型存在子类，那么leaveTypeID必须传子类ID 400 | 1220025 | The granting quantity range is from -9999 to 9999 | 额度范围为-9999～9999 400 | 1220026 | The number of decimal places of the granted quantity cannot exceed 6 | 最多6位小数 400 | 1220027 | The length of the granting reason cannot exceed 3000 | 发放原因长度最多3000 400 | 1220029 | The leave type has been deactivated | 不能往已停用的假期类型写发放记录 400 | 1220030 | The length of the granted unique ID cannot exceed 64 | 检查参数 500 | 1229999 | Unknown error | 未知错误，请联系 [技术支持](https://applink.feishu.cn/TLJpeNdW) 500 | 1220015 | Internal error | 内部错误，请联系 [技术支持](https://applink.feishu.cn/TLJpeNdW) 400 | 1220017 | User not found | 获取员工信息失败，请检查员工ID 500 | 1220018 | Invalid leave balance calculate Conf | 联系研发 500 | 1220019 | The calculation result of leave balance is empty | 联系研发 400 | 1220020 | When calculating the leave balance, there is no leave plan version that matches the employee | 检查该员工任职期间是否有对应的假期计划版本 400 | 1220021 | For the leave type that is not granted according to the cycle, balance calculation is not supported | 不按周期发放的假期类型，不支持余额计算，联系研发 400 | 1220022 | The data of the leave plan version is invalid | 假期计划版本数据不合法 400 | 1220031 | This granting record cannot be edited or deleted | 该授予记录不可编辑或删除 400 | 1220032 | The expiration time of this granting record is invalid | 更新发放记录的过期时间异常，请仔细校验下，过期时间可能小于生效时间。 400 | 1220600 | 通用错误信息 | 通用错误信息包含多条，详细的错误信息以及处理建议可参见 [错误信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)