# 查询成本分摊报表明细 根据报表方案、期间、和报表类型获取成本分摊明细数据。调用接口前，需打开「财务过账」开关，并且完成发布成本分摊报表。 ## 请求 基本 |   ---|--- HTTP URL | https://open.feishu.cn/open-apis/payroll/v1/cost_allocation_details HTTP Method | GET 接口频率限制 | [5 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) 支持的应用类型 | Custom App、Store App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 获取成本分摊报表明细数据(payroll:cost_allocation_details:read) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
或
`user_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use) ### 查询参数 名称 | 类型 | 必填 | 描述 ---|---|---|--- page_size | int | 是 | 分页大小
**示例值**：50
**数据校验规则**：
- 取值范围：`1` ～ `100` page_token | string | 否 | 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果
**示例值**：eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0= cost_allocation_plan_id | string | 是 | 成本分摊方案ID，通过[批量查询成本分摊方案](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/cost_allocation_plan/list)获取
**示例值**：72131231231231231 pay_period | string | 是 | 期间，成本分摊报表对应的年月。长度为7个字符。
**示例值**：2024-06 report_type | int | 是 | 报表类型
**示例值**：0
**可选值有**：
- 0：默认
- 1：计提
- 2：实发
**数据校验规则**：
- 取值范围：`0` ～ `2` ## 响应 ### 响应体 名称 | 类型 | 描述 ---|---|--- code | int | 错误码，非 0 表示失败 msg | string | 错误描述 data | \- | \- cost_allocation_report_datas | cost_allocation_report_data\[\] | 报表明细数据 data_summary_dimensions | data_summary_dimension\[\] | 数据维度汇总 dimension_level | int | 层级 dimension_type | int | 类型：
公司主体 - 1
成本中心 - 2
部门 - 3
薪资组 - 4
人员类型 - 5
雇佣状态 - 6
转正状态 - 7
职务 - 8
序列 - 9
职级 - 10
工时制度 - 11
合同类型 - 12
算薪项 - 13
自定义维度 - 100 dimension_value_id | string | 维度ID，需要根据dimension_type再次转换，如：当dimension_type为1时，该值表示公司主体的ID。
对应的接口映射如下：
dimension_type = 1 [公司主体](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/company/batch_get)
dimension_type = 2 [成本中心](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)
dimension_type = 3 [部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)
dimension_type = 4 [薪资组](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list)
dimension_type = 5 [人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/get)
dimension_type = 8 [职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/get)
dimension_type = 9 [序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/batch_get)
dimension_type = 10 [职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_level/batch_get)
dimension_type = 11 [工时制度](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/get) enum_dimension | enum_object | 算薪项汇总维度时，当算薪项是特定枚举值，会使用该字段返回枚举值ID以及枚举值Key，业务需要获取枚举对象的详情信息，可根据ID去对应的对象中查找，其中枚举对象的映射如下：
workCalendar [工作日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)
location [地点](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/location/batch_get)
company [公司主体](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/company/batch_get)
costCenter [成本中心](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)
department [部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)
employeeType [人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/get)
job [职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/get)
jobFamily [序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/batch_get)
jobLevel [职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_level/batch_get)
workingHoursType [工时制度](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/get) enum_value_id | string | 枚举对象ID enum_key | string | 枚举对象 dimension_value_lookup_info | dimension_value_lookup_info | 维度引用对象的基础信息，当维度为引用类型字段才会有值，目前支持的引用对象类型见type type | string | 引用对象类型，类型对应的对象映射包括不仅限：
type = company [公司主体](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/company/batch_get)
type = cost_center [成本中心](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)
type = department [部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)
type = pay_group [薪资组](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list)
type = employee_type [人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/get)
type = job [职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/get)
type = job_family [序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/batch_get)
type = job_level [职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_level/batch_get)
type = working_hours_type [工时制度](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/get) id | string | 引用对象的id，可根据相关API查询到对象的完整信息 code | string | 引用对象的code，目前下面的对象会有code：
type = company [公司主体](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/company/batch_get)
type = cost_center [成本中心](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)
type = department [部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)
type = job [职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/get)
type = job_family [序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/batch_get)
type = job_level [职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_level/batch_get)
type = location [地点](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/location/batch_get) dimension_names | i18n_content\[\] | 维度名称，算薪项、自定义维度使用 locale | string | 语种 value | string | 语种对应的值 dimension_titles | i18n_content\[\] | 数据维度表头，算薪项、自定义维度使用 locale | string | 语种 value | string | 语种对应的值 id | string | 名称对应的实体id
需要根据dimension_type再次转换，如：当dimension_type为13时，该值表示算薪项的ID。
对应的接口映射如下：
dimension_type = 13 [算薪项](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/acct_item/list) compensation_cost_item | compensation_cost_item | 成本项数据 compensation_costs | compensation_cost\[\] | 成本项数据 compensation_cost_value | string | 成本项值。单位为元。 i18n_names | i18n_content\[\] | 成本项名称 locale | string | 语种 value | string | 语种对应的值 employment_id | string | 员工id cost_allocation_report_names | i18n_content\[\] | 报表名称 locale | string | 语种 value | string | 语种对应的值 pay_period | string | 期间 page_token | string | 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token has_more | boolean | 是否还有更多项 ### 响应体示例 ```json { "code": 0, "msg": "success", "data": { "cost_allocation_report_datas": [ { "data_summary_dimensions": [ { "dimension_level": 1, "dimension_type": 1, "dimension_value_id": "6823630319749580306", "dimension_names": [ { "locale": "zh_cn", "value": "名称", } ], "dimension_titles": [ { "locale": "zh_cn", "value": "名称", "id": "723123123123123213" } ] } ], "compensation_cost_item": { "compensation_costs": [ { "compensation_cost_value": "123456.78", "i18n_names": [ { "locale": "zh_cn", "value": "名称", } ] } ] }, "employment_id": "72321836123692186" } ], "cost_allocation_report_names": [ { "locale": "zh_cn", "value": "名称", } ], "pay_period": "2024-06", "page_token": "eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0=", "has_more": true } } ``` ### 错误码 HTTP状态码 | 错误码 | 描述 | 排查建议 ---|---|---|--- 500 | 2500001 | unknown error | 未知错误，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)。 400 | 2500002 | param is invalid | 参数错误，请检查参数 500 | 2500003 | rpc fail | 请求调用出错，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) 500 | 2500004 | get plan version fail | 获取成本分摊方案版本出错，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) 200 | 2500005 | report has changed, please fetch again | 报表已变更，请重新获取。一般为报表拉取过程中新发布了报表。需要不传page_token参数，重新从头拉取 200 | 2500006 | report not found or unpublished | 报表不存在或者未发布，请检查参数并且联系报表管理员确认发布报表后再尝试 500 | 2500007 | report fetch fail | 获取报表数据失败，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) 、