# 写入审批结果

由于部分企业使用的是自己的审批系统，而不是飞书审批系统，因此员工的请假、加班等数据无法流入到飞书考勤系统中，导致员工在请假时间段内依然收到打卡提醒，并且被记为缺卡。
对于这些只使用飞书考勤系统，而未使用飞书审批系统的企业，可以通过考勤开放接口的形式，将三方审批结果数据回写到飞书考勤系统中。（请注意，如果在飞书审批、自助服务或假勤应用中发起加班，请勿使用该接口写入和系统同一天生成的加班数据，否则写入的数据不计入）

**注意事项**：1. 目前支持写入加班、请假、出差和外出这四种审批结果，写入只会追加(insert)，不会覆盖(update)（开放接口导入的加班假期记录，在管理后台的假期加班里查不到，可以在考勤统计报表查看，或者通过[获取审批通过数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query)来查询）
2. 离职人员没有考勤组，所以写入和返回的时间会有差异

## 请求

基本 | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/attendance/v1/user_approvals
HTTP Method | POST
接口频率限制 | [50 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 写入打卡数据(attendance:task)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 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"

### 查询参数

名称 | 类型 | 必填 | 描述
---|---|---|---
employee_type | string | 是 | 请求体和响应体中的 user_id 的员工ID类型。如果没有后台管理权限，可使用[通过手机号或邮箱获取用户 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id)<br>**示例值**：employee_id<br>**可选值有**：<br>- employee_id：员工 employee ID，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的用户 ID<br>- employee_no：员工工号，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的工号<br>- open_id：用户在某个应用中的身份，可以参考[如何获取不同的用户 ID<br>](https://open.feishu.cn/document/home/user-identity-introduction/open-id)

### 请求体

名称 | 类型 | 必填 | 描述
---|---|---|---
user_approval | user_approval | 否 | 审批信息
user_id | string | 是 | 审批提交人 ID。传入的ID类型需要与employee_type的取值一致<br>**示例值**："abd754f7"
date | string | 是 | 审批作用日期，格式为yyyyMMdd<br>**示例值**："20210104"
outs | user_out\[\] | 否 | 外出信息
uniq_id | string | 是 | 外出类型唯一 ID，代表一种外出类型，长度小于 14<br>* 如何获取？可以选择填入三方的外出类型id。如市内外出、市外外出的id<br>**示例值**："9496E43696967658A512969523E89870"
unit | int | 是 | 外出时长单位<br>**示例值**：1<br>**可选值有**：<br>- 1：天<br>- 2：小时<br>- 3：半天<br>- 4：半小时
interval | int | 是 | 关联审批单外出时长，单位为秒，与unit无关<br>**示例值**：3600
start_time | string | 是 | 开始时间，时间格式为 yyyy-MM-dd HH:mm:ss<br>**示例值**："2021-01-04 09:00:00"
end_time | string | 是 | 结束时间，时间格式为 yyyy-MM-dd HH:mm:ss<br>**示例值**："2021-01-04 19:00:00"
i18n_names | i18n_names | 是 | 外出多语言展示，格式为 map，key 为 ["ch"、"en"、"ja"]，其中 ch 代表中文、en 代表英语、ja 代表日语
ch | string | 否 | 中文描述<br>**示例值**："中文描述"
en | string | 否 | 英语描述<br>**示例值**："English description"
ja | string | 否 | 日语描述<br>**示例值**："日本語の説明"
default_locale | string | 是 | 默认语言类型，由于飞书客户端支持中、英、日三种语言，当用户切换语言时，如果假期名称没有所对应的语言，会使用默认语言的名称<br>**示例值**："ch"
reason | string | 是 | 外出理由<br>**示例值**："外出办事"
idempotent_id | string | 否 | 外出记录的唯一幂等键，用于避免外出记录重复创建，可以填入三方的外出记录id<br>**示例值**："1233432312"
correct_process_id | string\[\] | 否 | 更正流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。<br>**示例值**：["7304865941202929196"]
cancel_process_id | string\[\] | 否 | 撤销流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。<br>**示例值**：["7304865941202929196"]
process_id | string\[\] | 否 | 发起流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。<br>**示例值**：["7304865941202929196"]
leaves | user_leave\[\] | 否 | 请假信息
uniq_id | string | 否 | 假期类型唯一ID，代表一种假期类型<br>**示例值**："6852582717813440527"
unit | int | 是 | 假期时长单位。假期时长单位若传3，不足半天按照半天计算，以此类推<br>**示例值**：1<br>**可选值有**：<br>- 1：天<br>- 2：小时<br>- 3：半天<br>- 4：半小时
interval | int | 是 | 无效字段，暂时不支持<br>**示例值**：3600
start_time | string | 是 | 开始时间，时间格式为 yyyy-MM-dd HH:mm:ss<br>**示例值**："2021-01-04 09:00:00"
end_time | string | 是 | 结束时间，时间格式为 yyyy-MM-dd HH:mm:ss<br>**示例值**："2021-01-04 19:00:00"
i18n_names | i18n_names | 是 | 假期多语言展示，格式为 map，key 为 ["ch"、"en"、"ja"]，其中 ch 代表中文、en 代表英语、ja 代表日语
ch | string | 否 | 中文描述<br>**示例值**："中文描述"
en | string | 否 | 英语描述<br>**示例值**："English description"
ja | string | 否 | 日语描述<br>**示例值**："日本語の説明"
default_locale | string | 是 | 默认语言类型，由于飞书客户端支持中、英、日三种语言，当用户切换语言时，如果假期名称没有所对应的语言，会使用默认语言的名称<br>**示例值**："ch"<br>**可选值有**：<br>- ch：中文<br>- en：英文<br>- ja：日文
reason | string | 是 | 请假理由，必选字段<br>**示例值**："家里有事"
idempotent_id | string | 否 | 请假记录的唯一幂等键，用于避免请假记录重复创建，可以填入三方的请假记录id<br>**示例值**："1233432312"
leave_detail_range_objs | time_range_list\[\] | 否 | 根据班次计算出来的请假具体时间，格式为list<br>**数据校验规则**：<br>- 长度范围：`0` ～ `30`
day | int | 否 | 日期day<br>**示例值**：20220501<br>**数据校验规则**：<br>- 取值范围：`17000101` ～ `20990101`
time_ranges | time_range\[\] | 否 | 时间范围，是一个list<br>**数据校验规则**：<br>- 长度范围：`0` ～ `20`
start_time_stamp | int | 否 | 开始时间<br>**示例值**：1751385600<br>**数据校验规则**：<br>- 取值范围：`0` ～ `9223372036`
end_time_stamp | int | 否 | 结束时间<br>**示例值**：1751385600<br>**数据校验规则**：<br>- 取值范围：`0` ～ `9223372036`
overtime_works | user_overtime_work\[\] | 否 | 加班信息
duration | number(float) | 是 | 加班时长，如需使用此字段进行加班时长计算，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)开通。默认采用start_time和end_time计算<br>**示例值**：1.5
unit | int | 是 | 加班时长单位<br>**示例值**：1<br>**可选值有**：<br>- 1：天<br>- 2：小时<br>- 3：半天<br>- 4：半小时
category | int | 是 | 加班日期类型<br>**示例值**：2<br>**可选值有**：<br>- 1：工作日<br>- 2：休息日<br>- 3：节假日
type | int | 是 | 加班规则类型<br>**示例值**：1<br>**可选值有**：<br>- 0：仅记录<br>- 1：调休<br>- 2：加班费<br>- 3：【该可选值已废弃】
start_time | string | 是 | 开始时间，时间格式为 yyyy-MM-dd HH:mm:ss<br>**示例值**："2021-01-09 09:00:00"
end_time | string | 是 | 结束时间，时间格式为 yyyy-MM-dd HH:mm:ss<br>**示例值**："2021-01-10 13:00:00"
reason | string | 否 | 加班事由<br>**示例值**："推进项目进度"
idempotent_id | string | 否 | 加班记录的唯一幂等键，用于避免加班记录重复创建，可以填入三方的加班记录id<br>**示例值**："1233432312"
correct_process_id | string\[\] | 否 | 更正流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。<br>**示例值**：["7304865941202929196"]
cancel_process_id | string\[\] | 否 | 撤销流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。<br>**示例值**：["7304865941202929196"]
process_id | string\[\] | 否 | 发起流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。<br>**示例值**：["7304865941202929196"]
trips | user_trip\[\] | 否 | 出差信息。<br>目前仅支持全天出差（未满全天则按全天计入）。如果你需要支持半天出差，请咨询[技术支持](https://applink.feishu.cn/TLJpeNdW)。
start_time | string | 是 | 开始时间，时间格式为 yyyy-MM-dd HH:mm:ss<br>**示例值**："2021-01-04 09:00:00"
end_time | string | 是 | 结束时间，时间格式为 yyyy-MM-dd HH:mm:ss<br>**示例值**："2021-01-04 19:00:00"
reason | string | 是 | 出差理由<br>**示例值**："培训"
approve_pass_time | string | 是 | 审批通过时间，时间格式为 yyyy-MM-dd HH:mm:ss<br>**示例值**："2021-01-04 12:00:00"
approve_apply_time | string | 是 | 审批申请时间，时间格式为 yyyy-MM-dd HH:mm:ss<br>**示例值**："2021-01-04 11:00:00"
idempotent_id | string | 否 | 出差记录的唯一幂等键，用于避免出差记录重复创建，可以填入三方的出差记录id<br>**示例值**："1233432312"
correct_process_id | string\[\] | 否 | 更正流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。<br>**示例值**：["7304865941202929196"]
cancel_process_id | string\[\] | 否 | 撤销流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。<br>**示例值**：["7304865941202929196"]
process_id | string\[\] | 否 | 发起流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。<br>**示例值**：["7304865941202929196"]
departure | region_place | 否 | 出发地（只有一个）
region_level | string | 否 | 地理等级（国家｜省｜市｜区）<br>l1：国家级；<br>l2：省级；<br>l3：市级；<br>l4：区/县级<br>**示例值**："l1"
region_id | string | 否 | 地理id可以通过[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)或[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取（仅支持飞书人事企业版使用）<br>**示例值**："6863333418483058189"
destinations | region_place\[\] | 否 | 目的地（可写多个）
region_level | string | 否 | 地理等级（国家｜省｜市｜区）<br>l1：国家级；<br>l2：省级；<br>l3：市级；<br>l4：区/县级<br>**示例值**："l1"
region_id | string | 否 | 地理id可以通过[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)或[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取（仅支持飞书人事企业版使用）<br>**示例值**："6863333418483058189"
transportation | int\[\] | 否 | 交通工具（1 飞机，2 火车，3 汽车，4 高铁/动车，5 船，6 其他）<br>**示例值**：[1]
trip_type | int | 否 | 出差类型(1:单程 2:往返)<br>**示例值**：1
remarks | string | 否 | 出差备注<br>**示例值**："出差备注"
time_zone | string | 否 | 此字段不再使用，以用户匹配的考勤组时区为准<br>**示例值**："0"

### 请求体示例
```json
{
    "user_approval": {
        "user_id": "abd754f7",
        "date": "20210104",
        "outs": [
            {
                "uniq_id": "9496E43696967658A512969523E89870",
                "unit": 1,
                "interval": 3600,
                "start_time": "2021-01-04 09:00:00",
                "end_time": "2021-01-04 19:00:00",
                "i18n_names": {
                    "ch": "中文描述",
                    "en": "English description",
                    "ja": "日本語の説明"
                },
                "default_locale": "ch",
                "reason": "外出办事",
                "idempotent_id": "1233432312",
                "correct_process_id": [
                    "7304865941202929196"
                ],
                "cancel_process_id": [
                    "7304865941202929196"
                ],
                "process_id": [
                    "7304865941202929196"
                ]
            }
        ],
        "leaves": [
            {
                "uniq_id": "6852582717813440527",
                "unit": 1,
                "interval": 3600,
                "start_time": "2021-01-04 09:00:00",
                "end_time": "2021-01-04 19:00:00",
                "i18n_names": {
                    "ch": "中文描述",
                    "en": "English description",
                    "ja": "日本語の説明"
                },
                "default_locale": "ch",
                "reason": "家里有事",
                "idempotent_id": "1233432312",
                "leave_detail_range_objs": [
                    {
                        "day": 20220501,
                        "time_ranges": [
                            {
                                "start_time_stamp": 1751385600,
                                "end_time_stamp": 1751385600
                            }
                        ]
                    }
                ]
            }
        ],
        "overtime_works": [
            {
                "duration": 1.5,
                "unit": 1,
                "category": 2,
                "type": 1,
                "start_time": "2021-01-09 09:00:00",
                "end_time": "2021-01-10 13:00:00",
                "reason": "推进项目进度",
                "idempotent_id": "1233432312",
                "correct_process_id": [
                    "7304865941202929196"
                ],
                "cancel_process_id": [
                    "7304865941202929196"
                ],
                "process_id": [
                    "7304865941202929196"
                ]
            }
        ],
        "trips": [
            {
                "start_time": "2021-01-04 09:00:00",
                "end_time": "2021-01-04 19:00:00",
                "reason": "培训",
                "approve_pass_time": "2021-01-04 12:00:00",
                "approve_apply_time": "2021-01-04 11:00:00",
                "idempotent_id": "1233432312",
                "correct_process_id": [
                    "7304865941202929196"
                ],
                "cancel_process_id": [
                    "7304865941202929196"
                ],
                "process_id": [
                    "7304865941202929196"
                ],
                "departure": {
                    "region_level": "l1",
                    "region_id": "6863333418483058189"
                },
                "destinations": [
                    {
                        "region_level": "l1",
                        "region_id": "6863333418483058189"
                    }
                ],
                "transportation": [
                    1
                ],
                "trip_type": 1,
                "remarks": "出差备注"
            }
        ],
        "time_zone": "0"
    }
}
```

## 响应

### 响应体

名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
user_approval | user_approval | 审批信息
user_id | string | 审批提交人 ID
date | string | 审批作用日期，格式为yyyyMMdd
outs | user_out\[\] | 外出信息
approval_id | string | 审批实例id 创建的时候无效字段无需传入
uniq_id | string | 外出类型唯一 ID，代表一种假期类型，长度小于 14<br>* 此ID对应外出类型(即: i18n_names)，因此需要保证唯一
unit | int | 外出时长单位<br>**可选值有**：<br>- 1：天<br>- 2：小时<br>- 3：半天<br>- 4：半小时
interval | int | 关联审批单外出时长，单位为秒，与unit无关
start_time | string | 开始时间，时间格式为 yyyy-MM-dd HH:mm:ss
end_time | string | 结束时间，时间格式为 yyyy-MM-dd HH:mm:ss
i18n_names | i18n_names | 外出多语言展示，格式为 map，key 为 ["ch"、"en"、"ja"]，其中 ch 代表中文、en 代表英语、ja 代表日语
ch | string | 中文描述
en | string | 英语描述
ja | string | 日语描述
default_locale | string | 默认语言类型，由于飞书客户端支持中、英、日三种语言，当用户切换语言时，如果假期名称没有所对应的语言，会使用默认语言的名称
reason | string | 外出理由
approve_pass_time | string | 审批通过时间，时间格式为 yyyy-MM-dd HH:mm:ss
approve_apply_time | string | 审批申请时间，时间格式为 yyyy-MM-dd HH:mm:ss
idempotent_id | string | 外出记录的唯一幂等键，响应体中无需关注
correct_process_id | string\[\] | 更正流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。
cancel_process_id | string\[\] | 撤销流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。
process_id | string\[\] | 发起流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。
leaves | user_leave\[\] | 请假信息
approval_id | string | 审批实例 ID
uniq_id | string | 假期类型唯一 ID，代表一种假期类型，长度小于 14<br>* 此ID对应假期类型(即: i18n_names)，因此需要保证唯一
unit | int | 假期时长单位<br>**可选值有**：<br>- 1：天<br>- 2：小时<br>- 3：半天<br>- 4：半小时
interval | int | 关联审批单假期时长，单位为秒，与unit无关
start_time | string | 开始时间，时间格式为 yyyy-MM-dd HH:mm:ss
end_time | string | 结束时间，时间格式为 yyyy-MM-dd HH:mm:ss
i18n_names | i18n_names | 假期多语言展示，格式为 map，key 为 ["ch"、"en"、"ja"]，其中 ch 代表中文、en 代表英语、ja 代表日语
ch | string | 中文描述
en | string | 英语描述
ja | string | 日语描述
default_locale | string | 默认语言类型，由于飞书客户端支持中、英、日三种语言，当用户切换语言时，如果假期名称没有所对应的语言，会使用默认语言的名称<br>**可选值有**：<br>- ch：中文<br>- en：英文<br>- ja：日文
reason | string | 请假理由，必选字段
approve_pass_time | string | 审批通过时间，时间格式为 yyyy-MM-dd HH:mm:ss
approve_apply_time | string | 审批申请时间，时间格式为 yyyy-MM-dd HH:mm:ss
idempotent_id | string | 请假记录的唯一幂等键，响应体中无需关注
leave_detail_range_objs | time_range_list\[\] | 根据班次计算出来的请假具体时间，格式为list
day | int | 日期day
time_ranges | time_range\[\] | 时间范围，是一个list
start_time_stamp | int | 开始时间
end_time_stamp | int | 结束时间
overtime_works | user_overtime_work\[\] | 加班信息
approval_id | string | 审批实例 ID
duration | number(float) | 加班时长
unit | int | 加班时长单位<br>**可选值有**：<br>- 1：天<br>- 2：小时<br>- 3：半天<br>- 4：半小时
category | int | 加班日期类型<br>**可选值有**：<br>- 1：工作日<br>- 2：休息日<br>- 3：节假日
type | int | 加班规则类型<br>**可选值有**：<br>- 0：仅记录<br>- 1：调休<br>- 2：加班费<br>- 3：关联加班规则，没有调休或加班费
start_time | string | 开始时间，时间格式为 yyyy-MM-dd HH:mm:ss
end_time | string | 结束时间，时间格式为 yyyy-MM-dd HH:mm:ss
reason | string | 加班事由
idempotent_id | string | 加班记录的唯一幂等键，响应体中无需关注
correct_process_id | string\[\] | 更正流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。
cancel_process_id | string\[\] | 撤销流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。
process_id | string\[\] | 发起流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。
trips | user_trip\[\] | 出差信息
approval_id | string | 审批实例id
start_time | string | 开始时间，时间格式为 yyyy-MM-dd HH:mm:ss
end_time | string | 结束时间，时间格式为 yyyy-MM-dd HH:mm:ss
reason | string | 出差理由
approve_pass_time | string | 审批通过时间，时间格式为 yyyy-MM-dd HH:mm:ss
approve_apply_time | string | 审批申请时间，时间格式为 yyyy-MM-dd HH:mm:ss
idempotent_id | string | 出差记录的唯一幂等键，响应体中无需关注
correct_process_id | string\[\] | 更正流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。
cancel_process_id | string\[\] | 撤销流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。
process_id | string\[\] | 发起流程实例 ID。该字段由系统自动生成，在写入审批结果时，无需传入该参数。
departure | region_place | 出发地（只有一个）
region_level | string | 地理等级（国家｜省｜市｜区）<br>l1：国家级；<br>l2：省级；<br>l3：市级；<br>l4：区/县级
region_id | string | 地理id
destinations | region_place\[\] | 目的地（可写多个）
region_level | string | 地理等级（国家｜省｜市｜区）<br>l1：国家级；<br>l2：省级；<br>l3：市级；<br>l4：区/县级
region_id | string | 地理id
transportation | int\[\] | 交通工具（1 飞机，2 火车，3 汽车，4 高铁/动车，5 船，6 其他）
trip_type | int | 出差类型(1:单程 2:往返)
remarks | string | 出差备注
time_zone | string | 计算时间所用的时区信息

### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "user_approval": {
            "user_id": "abd754f7",
            "date": "20210104",
            "outs": [
                {
                    "approval_id": "6737202939523236113",
                    "uniq_id": "9496E43696967658A512969523E89870",
                    "unit": 1,
                    "interval": 3600,
                    "start_time": "2021-01-04 09:00:00",
                    "end_time": "2021-01-04 19:00:00",
                    "i18n_names": {
                        "ch": "中文描述",
                        "en": "English description",
                        "ja": "日本語の説明"
                    },
                    "default_locale": "ch",
                    "reason": "外出办事",
                    "approve_pass_time": "2021-01-04 12:00:00",
                    "approve_apply_time": "2021-01-04 11:00:00",
                    "idempotent_id": "1233432312",
                    "correct_process_id": [
                        "7304865941202929196"
                    ],
                    "cancel_process_id": [
                        "7304865941202929196"
                    ],
                    "process_id": [
                        "7304865941202929196"
                    ]
                }
            ],
            "leaves": [
                {
                    "approval_id": "6737202939523236113",
                    "uniq_id": "6852582717813440527",
                    "unit": 1,
                    "interval": 3600,
                    "start_time": "2021-01-04 09:00:00",
                    "end_time": "2021-01-04 19:00:00",
                    "i18n_names": {
                        "ch": "中文描述",
                        "en": "English description",
                        "ja": "日本語の説明"
                    },
                    "default_locale": "ch",
                    "reason": "家里有事",
                    "approve_pass_time": "2021-01-04 12:00:00",
                    "approve_apply_time": "2021-01-04 11:00:00",
                    "idempotent_id": "1233432312",
                    "leave_detail_range_objs": [
                        {
                            "day": 20220501,
                            "time_ranges": [
                                {
                                    "start_time_stamp": 1751385600,
                                    "end_time_stamp": 1751385600
                                }
                            ]
                        }
                    ]
                }
            ],
            "overtime_works": [
                {
                    "approval_id": "6737202939523236113",
                    "duration": 1.5,
                    "unit": 1,
                    "category": 2,
                    "type": 1,
                    "start_time": "2021-01-09 09:00:00",
                    "end_time": "2021-01-10 13:00:00",
                    "reason": "推进项目进度",
                    "idempotent_id": "1233432312",
                    "correct_process_id": [
                        "7304865941202929196"
                    ],
                    "cancel_process_id": [
                        "7304865941202929196"
                    ],
                    "process_id": [
                        "7304865941202929196"
                    ]
                }
            ],
            "trips": [
                {
                    "approval_id": "6737202939523236113",
                    "start_time": "2021-01-04 09:00:00",
                    "end_time": "2021-01-04 19:00:00",
                    "reason": "培训",
                    "approve_pass_time": "2021-01-04 12:00:00",
                    "approve_apply_time": "2021-01-04 11:00:00",
                    "idempotent_id": "1233432312",
                    "correct_process_id": [
                        "7304865941202929196"
                    ],
                    "cancel_process_id": [
                        "7304865941202929196"
                    ],
                    "process_id": [
                        "7304865941202929196"
                    ],
                    "departure": {
                        "region_level": "l1",
                        "region_id": "6863333418483058189"
                    },
                    "destinations": [
                        {
                            "region_level": "l1",
                            "region_id": "6863333418483058189"
                        }
                    ],
                    "transportation": [
                        1
                    ],
                    "trip_type": 1,
                    "remarks": "出差备注"
                }
            ],
            "time_zone": "Asia/Shanghai"
        }
    }
}
```

### 错误码

HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
400 | 1220001 | param is invalid | 入参校验失败，请根据具体返回的信息检查入参。例如“employee_type invalid”代表人员类型异常。如仍无法解决可联系 [技术支持](https://applink.feishu.cn/TLJpeNdW)
400 | 1220002 | tenant_id is empty | 请检查入参中的 tenant_access_token是否正确
400 | 1220004 | param is invalid | 请参考实际返回的错误信息排查问题。例如“user_id is not exist or does not have permission”代表入参传入的用户id不存在或者没有权限。如仍无法解决可联系 [技术支持](https://applink.feishu.cn/TLJpeNdW)
400 | 1220005 | permission denied | 请前往[考勤管理后台](https://oa.feishu.cn/attendance/manage/member/list)检查数据权限范围
500 | 1225000 | param is invalid | 请参考实际返回的错误信息排查问题。例如“internal server error”代表内部服务异常。如仍无法解决可联系 [技术支持](https://applink.feishu.cn/TLJpeNdW)
400 | 1225001 | param is invalid | 请参考实际返回的错误信息排查问题。返回错误格式为导入的审批数据，格式为：{"TripErrorRecords":"","OvertimeWorkErrorRecords":"","LeaveErrorRecords":"","OutErrorRecords":""}。如仍无法解决可联系 [技术支持](https://applink.feishu.cn/TLJpeNdW)
400 | 1220600 | general error information | 通用错误信息包含多条，详细的错误信息以及处理建议可参见[错误信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)。

