批量删除填报行

批量删除填报行后，可在【设置-编制规划设置-编制规划XXX-集中填报-查看数据】进行查看。

Warning: 批量删除填报行说明：同批次操作场景下，禁止重复删除同一行。

删除填报行的时候请注意：底层是将编制规划与预估在职人数清0，如果被删除行的预增人员、预减人员不为0，该行依旧会显示在页面上。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/report_detail_row/batchDelete
HTTP Method	POST
接口频率限制	5 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	corehr:workforce_plan_centralized_reporting_project_detail:write 写入编制规划集中填报明细信息

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

请求体

名称	类型	必填	描述
workforce_plan_id	string	是	编制规划id，可在「设置-编制规划设置-编制规划XXX-页面URL」中解析到。 示例值："7430330781544564268"
centralized_reporting_project_id	string	是	集中填报id，可在「设置-编制规划设置-编制规划XXX-集中填报XXX-查看数据-页面URL」中解析report_id。 示例值："7430470688844023340"
items	workforce_plan_detail_row\[\]	是	集中填报的填报行数量应介于 1 至 5 个之间。 数据校验规则： - 长度范围：1 ～ 5
└ dimensions	dimension_entity\[\]	是	集中填报的维度信息要和用户创建的维度匹配，即传入除自动匹配维度外的所有维度，不多不少。 通过「设置-编制规划设置-编制规划XXX」查看该编制规划有哪些维度。 数据校验规则： - 长度范围：1 ～ 20
└ dimension_key	string	是	维度key，可从下面列表中进行选择： - "department"：部门。 - "employee_type" ：人员类型。 - "location"：地点。 - "position" ：岗位。 - "cost_center" ：成本中心/业务线。 - "job_family" ：序列。 - "job_level" ：职级。 - "job" ：职务。 - "pathway"：通道。 自定义组织： - "custom_org_01" - "custom_org_02" - "custom_org_03" - "custom_org_04" - "custom_org_05" 示例值："department"
└ dimension_value	string	是	维度value。 - department_id：可从查询部门获得。 - location_id：可从查询地点获得。 - cost_center_id：可从查询成本中心获得。 - job_id：可从查询职务获得。 - job_level_id：可从查询职级获得。 - job_family_id：可从查询序列获得。 - employee_type_id：可从查询人员类型获得。 - position_id：可从查询岗位获得。 - pathway_id: 可从查询通道获得。 - custom_org_01_id：可从查询自定义组织获得。 - custom_org_02_id：可从查询自定义组织获得。 - custom_org_03_id：可从查询自定义组织获得。 - custom_org_04_id：可从查询自定义组织获得。 - custom_org_05_id：可从查询自定义组织获得。 示例值："7322790168290739756"
└ eai_details	workforce_plan_eai_detail\[\]	否	预估在职人数相关信息。可从「设置-编制规划设置-编制规划XXX-集中填报」查看预估在职人数的时间，如果不存在该字段说明用户创建时即没有允许填写该字段，批量删除填报行时则无需给该字段，如果存在，用户需要查看预估在职人数的日期，使用示例值格式进行传参。（该字段无效，可忽略） 数据校验规则： - 长度范围：0 ～ 15
└ date	string	否	预估在职人数的日期，和集中填报页面上显示的预估在职人数的日期一致，且格式要依照示例给定，若二者不匹配，则无法完成识别更新。 示例值："2020-10-31"
└ estimated_active_individuals	string	否	预估在职人数应与创建编制规划时指定的小数位数相匹配，若不匹配，则无法更新。小数位查看方式：「设置-编制规划-编制规划XXX」查看预估在职人数的小数位数。 示例值："10"
└ plan_value	string	否	编制规划值。需与创建编制规划时指定的小数位数相匹配，若不匹配，则无法更新。小数位查看方式：「设置-编制规划-编制规划XXX」查看编制规划的小数位数。（该字段无效，可忽略） 示例值："12"

请求体示例

{
    "workforce_plan_id": "7435976673130317356",
    "centralized_reporting_project_id": "7436723164333753900",
    "items": [
        {
            "dimensions": [
                {
                    "dimension_key": "department",
                    "dimension_value": "7371716294248908332"
                },
                {
                    "dimension_key": "location",
                    "dimension_value": "7312702817660487212"
                },
                {
                    "dimension_key": "cost_center",
                    "dimension_value": "7212847939319219756"
                },
                {
                    "dimension_key": "job_family",
                    "dimension_value": "7210959705752192556"
                },
                {
                    "dimension_key": "employee_type",
                    "dimension_value": "7210608964277601836"
                }
            ],
            "plan_value": "919",
            "eai_details": [
                {
                    "date": "2029-01-31",
                    "estimated_active_individuals": "9"
                },
                {
                    "date": "2029-02-28",
                    "estimated_active_individuals": "99"
                }
            ]
        }
    ]
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {}
}

下面是错误码的简单示例，详细描述可通过下面的链接查看。

错误码

HTTP状态码	错误码	描述	排查建议
400	1160001	param is invalid	请先参考全量错误码详细描述进行错误排查，如问题始终无法解决请联系技术支持

其他错误码参考: 全量错误码详细描述