# lwc-cloud-erp-hr API 接口文档

- 文档标题：lwc-cloud-erp-hr
- 版本：3.0.9
- 描述：LWC Cloud API接口文档
- 数据来源：https://api.leadwaycloud.com/lwc-cloud-erp-hr/v3/api-docs
- 生成时间：2026-08-03T22:00:04.441Z
- 接口数量：54
- 分组数量：7
- 模型数量：70

## 服务地址

| 地址 | 说明 |
| --- | --- |
| http://localhost:8080 | 开发环境 |
| https://api.leadwaycloud.com | 测试环境 |

## 接口目录

### 班次管理

- [PUT /api/shift/update/{id} - 排班方案-编辑排班](#put-api-shift-update-id-update)
- [POST /api/shift/version/statusChange/{shiftScheduleVersionId} - 版本-状态变更](#post-api-shift-version-statuschange-shiftscheduleversionid-versionstatuschange)
- [POST /api/shift/version/copy/{shiftScheduleVersionId} - 版本-复制](#post-api-shift-version-copy-shiftscheduleversionid-copyversion)
- [POST /api/shift/version/add/{shiftScheduleId} - 版本-创建](#post-api-shift-version-add-shiftscheduleid-createversion)
- [POST /api/shift/statusChange/{id} - 排班方案-状态变更](#post-api-shift-statuschange-id-statuschange)
- [POST /api/shift/item/update/{shiftScheduleItemId} - 班次-编辑](#post-api-shift-item-update-shiftscheduleitemid-updateitem)
- [POST /api/shift/item/add/{versionId} - 班次-新增](#post-api-shift-item-add-versionid-additem)
- [POST /api/shift/add - 排班方案-添加](#post-api-shift-add-add)
- [GET /api/shift/page - 排班方案-分页](#get-api-shift-page-page)
- [GET /api/shift/list - 排班方案-列表](#get-api-shift-list-list)
- [GET /api/shift/get/{id} - 排班方案-详情](#get-api-shift-get-id-get)
- [DELETE /api/shift/item/delete/{shiftScheduleItemId} - 班次-删除](#delete-api-shift-item-delete-shiftscheduleitemid-deleteitem)

### 职位管理

- [PUT /api/hr/position/update/{id} - 编辑职位](#put-api-hr-position-update-id-update-1)
- [POST /api/hr/position/add - 添加职位](#post-api-hr-position-add-add-1)
- [GET /api/hr/position/list - 查询职位列表](#get-api-hr-position-list-list-1)
- [GET /api/hr/position/get/{id} - 查询职位详情](#get-api-hr-position-get-id-get-1)

### 员工管理

- [PUT /api/hr/employee/update/{id} - 编辑员工](#put-api-hr-employee-update-id-update-2)
- [POST /api/hr/employee/add - 添加员工](#post-api-hr-employee-add-add-2)
- [POST /api/hr/employee/addUserEmployee/{userId} - 添加用户员工](#post-api-hr-employee-adduseremployee-userid-addemployeeuser)
- [GET /api/hr/employee/queryUserEmployee/{userId} - 查询用户员工信息](#get-api-hr-employee-queryuseremployee-userid-queryuseremployee)
- [GET /api/hr/employee/queryByPositionId/{positionId} - 查询职位下的员工列表](#get-api-hr-employee-querybypositionid-positionid-querybypositionid)
- [GET /api/hr/employee/queryByDepartmentId/{departmentId} - 查询部门下的员工列表](#get-api-hr-employee-querybydepartmentid-departmentid-querybydepartmentid)
- [GET /api/hr/employee/page - 查询员工列表](#get-api-hr-employee-page-page-1)
- [GET /api/hr/employee/get/{id} - 查询员工详情](#get-api-hr-employee-get-id-get-2)

### 部门管理

- [PUT /api/hr/department/updateBingStockWarehouse/{id} - 编辑部门绑定仓库](#put-api-hr-department-updatebingstockwarehouse-id-updatebingstockwarehouse)
- [PUT /api/hr/department/updateBingGoodsCategory/{id} - 编辑部门绑定商品类型](#put-api-hr-department-updatebinggoodscategory-id-updatebinggoodscategory)
- [PUT /api/hr/department/update/{id} - 编辑部门](#put-api-hr-department-update-id-update-3)
- [POST /api/hr/department/add - 添加部门](#post-api-hr-department-add-add-3)
- [GET /api/hr/department/queryStockWarehouse/{id} - 查询部门下的仓库](#get-api-hr-department-querystockwarehouse-id-querystockwarehouse)
- [GET /api/hr/department/queryHrDepartment/{warehouseId} - 查询仓库下的部门](#get-api-hr-department-queryhrdepartment-warehouseid-queryhrdepartment)
- [GET /api/hr/department/queryGoodsCategory/{id} - 查询部门下的商品类型](#get-api-hr-department-querygoodscategory-id-querygoodscategory)
- [GET /api/hr/department/list - 查询部门列表](#get-api-hr-department-list-list-2)
- [GET /api/hr/department/get/{id} - 查询部门详情](#get-api-hr-department-get-id-get-3)

### 日历日程管理

- [PUT /api/hr/calendarSchedule/update/{id} - 编辑日历日程](#put-api-hr-calendarschedule-update-id-update-4)
- [POST /api/hr/calendarSchedule/add - 添加日历日程](#post-api-hr-calendarschedule-add-add-4)
- [GET /api/hr/calendarSchedule/page - 查询日历日程](#get-api-hr-calendarschedule-page-page-2)
- [GET /api/hr/calendarSchedule/list - 查询时间区间日程](#get-api-hr-calendarschedule-list-list-3)
- [DELETE /api/hr/calendarSchedule/delete/{id} - 删除日历日程](#delete-api-hr-calendarschedule-delete-id-updatebingstockwarehouse-1)

### 餐食

- [PUT /api/dining/updateTicketType/{ticketTypeId} - 修改餐票类型](#put-api-dining-updatetickettype-tickettypeid-updatetickettype)
- [PUT /api/dining/updateCanteen/{canteenId} - 修改食堂信息](#put-api-dining-updatecanteen-canteenid-updatetickettype-1)
- [PUT /api/dining/destroyTicket/{ticketId} - 餐票核销](#put-api-dining-destroyticket-ticketid-destoryticket)
- [POST /api/dining/manualTicket - 手工发放餐票](#post-api-dining-manualticket-manualticket)
- [POST /api/dining/applyTicket - 领取餐票](#post-api-dining-applyticket-applyticket)
- [POST /api/dining/addTicketType - 添加餐票类型](#post-api-dining-addtickettype-addtickettype)
- [POST /api/dining/addCanteen - 添加食堂](#post-api-dining-addcanteen-addtickettype-1)
- [GET /api/dining/qyerMerchantCurrentDayTicketCount - 查询商户当日各类型餐票订餐数量](#get-api-dining-qyermerchantcurrentdayticketcount-querycurrentdayticketcount)
- [GET /api/dining/queryUserTicket - 用户餐票查询](#get-api-dining-queryuserticket-queryuserticket)
- [GET /api/dining/queryTicketType/{ticketTypeId} - 查询餐票类型详情](#get-api-dining-querytickettype-tickettypeid-querytickettypelist)
- [GET /api/dining/queryTicketType/list - 查询餐票类型列表](#get-api-dining-querytickettype-list-querytickettypelist-1)
- [GET /api/dining/queryCanteenTicket/{canteenId} - 食堂餐票查询](#get-api-dining-querycanteenticket-canteenid-querycanteenticket)
- [GET /api/dining/queryCanteenList - 获取食堂列表](#get-api-dining-querycanteenlist-querycanteenlist)
- [DELETE /api/dining/removeExpireTicket - 删除过期餐票](#delete-api-dining-removeexpireticket-removeexpireticket)

### 服务监控管理

- [GET /api/monitor/version - 获取服务版本信息](#get-api-monitor-version-version)
- [GET /api/monitor/health - 心跳检查](#get-api-monitor-health-health)


## 接口详情

<a id="put-api-shift-update-id-update"></a>

### PUT /api/shift/update/{id}

- 分组：班次管理
- 名称：排班方案-编辑排班
- OperationId：update

#### 调用方法

`PUT /api/shift/update/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) |  |  |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：ShiftScheduleDTO$UpdateDTO（com.leadwaycloud.hr.model.dto.shift.ShiftScheduleDTO$UpdateDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 是 | 方案编码 |  |
| name | string | 是 | 方案名称 |  |
| note | string | 否 | 备注 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Object（com.leadwaycloud.core.model.RJava.lang.Object）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="post-api-shift-version-statuschange-shiftscheduleversionid-versionstatuschange"></a>

### POST /api/shift/version/statusChange/{shiftScheduleVersionId}

- 分组：班次管理
- 名称：版本-状态变更
- OperationId：versionStatusChange

#### 调用方法

`POST /api/shift/version/statusChange/{shiftScheduleVersionId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| shiftScheduleVersionId | path | 是 | integer(int64) |  |  |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：ShiftScheduleDTO$StatusChangeDTO（com.leadwaycloud.hr.model.dto.shift.ShiftScheduleDTO$StatusChangeDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | string | 是 | 状态 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Object（com.leadwaycloud.core.model.RJava.lang.Object）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="post-api-shift-version-copy-shiftscheduleversionid-copyversion"></a>

### POST /api/shift/version/copy/{shiftScheduleVersionId}

- 分组：班次管理
- 名称：版本-复制
- OperationId：copyVersion

#### 调用方法

`POST /api/shift/version/copy/{shiftScheduleVersionId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| shiftScheduleVersionId | path | 是 | integer(int64) |  |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Long（com.leadwaycloud.core.model.RJava.lang.Long）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | integer(int64) | 否 | 返回数据 |  |

<a id="post-api-shift-version-add-shiftscheduleid-createversion"></a>

### POST /api/shift/version/add/{shiftScheduleId}

- 分组：班次管理
- 名称：版本-创建
- OperationId：createVersion

#### 调用方法

`POST /api/shift/version/add/{shiftScheduleId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| shiftScheduleId | path | 是 | integer(int64) |  |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Long（com.leadwaycloud.core.model.RJava.lang.Long）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | integer(int64) | 否 | 返回数据 |  |

<a id="post-api-shift-statuschange-id-statuschange"></a>

### POST /api/shift/statusChange/{id}

- 分组：班次管理
- 名称：排班方案-状态变更
- OperationId：statusChange

#### 调用方法

`POST /api/shift/statusChange/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) |  |  |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：ShiftScheduleDTO$StatusChangeDTO（com.leadwaycloud.hr.model.dto.shift.ShiftScheduleDTO$StatusChangeDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | string | 是 | 状态 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Object（com.leadwaycloud.core.model.RJava.lang.Object）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="post-api-shift-item-update-shiftscheduleitemid-updateitem"></a>

### POST /api/shift/item/update/{shiftScheduleItemId}

- 分组：班次管理
- 名称：班次-编辑
- OperationId：updateItem

#### 调用方法

`POST /api/shift/item/update/{shiftScheduleItemId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| shiftScheduleItemId | path | 是 | integer(int64) |  |  |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：ShiftScheduleItemDTO$UpdateDTO（com.leadwaycloud.hr.model.dto.shift.ShiftScheduleItemDTO$UpdateDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 是 | 班次编码 |  |
| name | string | 是 | 班次名称 |  |
| no | integer(int32) | 是 | 排序号 |  |
| totalWorkHours | number | 是 | 总工时 |  |
| timeSegmentList | ShiftScheduleItemDTO$TimeSegmentDTO | 否 |  |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Object（com.leadwaycloud.core.model.RJava.lang.Object）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="post-api-shift-item-add-versionid-additem"></a>

### POST /api/shift/item/add/{versionId}

- 分组：班次管理
- 名称：班次-新增
- OperationId：addItem

#### 调用方法

`POST /api/shift/item/add/{versionId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| versionId | path | 是 | integer(int64) |  |  |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：ShiftScheduleItemDTO$AddDTO（com.leadwaycloud.hr.model.dto.shift.ShiftScheduleItemDTO$AddDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 是 | 班次编码 |  |
| name | string | 是 | 班次名称 |  |
| no | integer(int32) | 是 | 排序号 |  |
| totalWorkHours | number | 是 | 总工时 |  |
| timeSegmentList | ShiftScheduleItemDTO$TimeSegmentDTO | 否 |  |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Long（com.leadwaycloud.core.model.RJava.lang.Long）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | integer(int64) | 否 | 返回数据 |  |

<a id="post-api-shift-add-add"></a>

### POST /api/shift/add

- 分组：班次管理
- 名称：排班方案-添加
- OperationId：add

#### 调用方法

`POST /api/shift/add`

#### 参数

无

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：ShiftScheduleDTO$AddDTO（com.leadwaycloud.hr.model.dto.shift.ShiftScheduleDTO$AddDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| merchantId | integer(int64) | 是 | 商户ID |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| code | string | 是 | 方案编码 |  |
| name | string | 是 | 方案名称 |  |
| note | string | 否 | 备注 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Long（com.leadwaycloud.core.model.RJava.lang.Long）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | integer(int64) | 否 | 返回数据 |  |

<a id="get-api-shift-page-page"></a>

### GET /api/shift/page

- 分组：班次管理
- 名称：排班方案-分页
- OperationId：page

#### 调用方法

`GET /api/shift/page`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| page | query | 是 | integer(int32) | 查询页码 | 0 |
| size | query | 是 | integer(int32) | 查询页行数 | 10 |
| code | query | 否 | string | 方案编码 |  |
| name | query | 否 | string | 方案名称 |  |
| status | query | 否 | string | 状态  【 DRAFT : ACTIVE : DEACTIVATE : DELETE : 】 |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：ShiftScheduleVO$ListVO（com.leadwaycloud.core.model.RCom.leadwaycloud.core.model.PCom.leadwaycloud.hr.model.vo.shift.ShiftScheduleVO$ListVO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | ShiftScheduleVO$ListVO | 否 |  |  |

<a id="get-api-shift-list-list"></a>

### GET /api/shift/list

- 分组：班次管理
- 名称：排班方案-列表
- OperationId：list

#### 调用方法

`GET /api/shift/list`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| code | query | 否 | string | 方案编码 |  |
| name | query | 否 | string | 方案名称 |  |
| status | query | 否 | string | 状态  【 DRAFT : ACTIVE : DEACTIVATE : DELETE : 】 |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：ShiftScheduleVO$DetailVO（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.vo.shift.ShiftScheduleVO$DetailVO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | ShiftScheduleVO$DetailVO[] | 否 | 返回数据 |  |

<a id="get-api-shift-get-id-get"></a>

### GET /api/shift/get/{id}

- 分组：班次管理
- 名称：排班方案-详情
- OperationId：get

#### 调用方法

`GET /api/shift/get/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 排班方案ID |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：ShiftScheduleVO$DetailVO（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.vo.shift.ShiftScheduleVO$DetailVO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | ShiftScheduleVO$DetailVO | 否 |  |  |

<a id="delete-api-shift-item-delete-shiftscheduleitemid-deleteitem"></a>

### DELETE /api/shift/item/delete/{shiftScheduleItemId}

- 分组：班次管理
- 名称：班次-删除
- OperationId：deleteItem

#### 调用方法

`DELETE /api/shift/item/delete/{shiftScheduleItemId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| shiftScheduleItemId | path | 是 | integer(int64) |  |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Object（com.leadwaycloud.core.model.RJava.lang.Object）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="put-api-hr-position-update-id-update-1"></a>

### PUT /api/hr/position/update/{id}

- 分组：职位管理
- 名称：编辑职位
- OperationId：update_1

#### 调用方法

`PUT /api/hr/position/update/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 主键ID | 0 |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：PositionDTO$UpdateDTO（com.leadwaycloud.hr.model.dto.PositionDTO$UpdateDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 否 | 名称 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| phone | string | 否 | 电话 |  |
| fax | string | 否 | 传真 |  |
| email | string | 否 | 邮箱 |  |
| note | string | 否 | 备注 |  |
| externalCode | string | 否 | 外部编号 |  |
| code | string | 否 | 编号 |  |
| status | string | 否 | 状态 | "ACTIVE" |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrPosition（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrPosition）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrPosition | 否 |  |  |

<a id="post-api-hr-position-add-add-1"></a>

### POST /api/hr/position/add

- 分组：职位管理
- 名称：添加职位
- OperationId：add_1

#### 调用方法

`POST /api/hr/position/add`

#### 参数

无

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：PositionDTO$AddDTO（com.leadwaycloud.hr.model.dto.PositionDTO$AddDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 是 | 名称 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| note | string | 否 | 备注 |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| merchantId | integer(int64) | 是 | 商户号ID |  |
| externalCode | string | 否 | 外部编号 |  |
| code | string | 否 | 编号 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrPosition（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrPosition）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrPosition | 否 |  |  |

<a id="get-api-hr-position-list-list-1"></a>

### GET /api/hr/position/list

- 分组：职位管理
- 名称：查询职位列表
- OperationId：list_1

#### 调用方法

`GET /api/hr/position/list`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| companyId | query | 是 | integer(int64) | 公司ID |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrPosition（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.hr.HrPosition）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrPosition[] | 否 | 返回数据 |  |

<a id="get-api-hr-position-get-id-get-1"></a>

### GET /api/hr/position/get/{id}

- 分组：职位管理
- 名称：查询职位详情
- OperationId：get_1

#### 调用方法

`GET /api/hr/position/get/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 主键ID | 0 |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrPosition（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrPosition）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrPosition | 否 |  |  |

<a id="put-api-hr-employee-update-id-update-2"></a>

### PUT /api/hr/employee/update/{id}

- 分组：员工管理
- 名称：编辑员工
- OperationId：update_2

#### 调用方法

`PUT /api/hr/employee/update/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 员工ID | 0 |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：EmployeeDTO$UpdateDTO（com.leadwaycloud.hr.model.dto.EmployeeDTO$UpdateDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 否 | 编号 |  |
| nationality | string | 否 | 民族 |  |
| domicile | string | 否 | 户籍 |  |
| status | string | 否 | 状态 | "PERIOD_OF_PROBATION" |
| entryDate | string(date) | 否 | 入职日期 | "2020-10-11" |
| positiveDate | string(date) | 否 | 转正日期 | "2020-10-11" |
| resignDate | string(date) | 否 | 离职日期 | "2020-10-11" |
| bankCard | string | 否 | 银行卡 |  |
| bankCardNum | string | 否 | 银行卡号 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| externalCode | string | 否 | 外部编号 |  |
| name | string | 否 | 名称 |  |
| image | string | 否 | 头像 |  |
| birthday | string(date) | 否 | 出生日期 |  |
| sex | string | 否 | 性别 |  |
| bank | string | 否 | 银行(名)，sys_property获取 |  |
| contact | ContactDTO$UpdateDTO | 否 |  |  |
| positionDepartmentDTOList | PositionDepartmentDTO[] | 否 | 部门职位对象集合 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrEmployee（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrEmployee）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrEmployee | 否 |  |  |

<a id="post-api-hr-employee-add-add-2"></a>

### POST /api/hr/employee/add

- 分组：员工管理
- 名称：添加员工
- OperationId：add_2

#### 调用方法

`POST /api/hr/employee/add`

#### 参数

无

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：EmployeeDTO$AddDTO（com.leadwaycloud.hr.model.dto.EmployeeDTO$AddDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 否 | 编号 |  |
| nationality | string | 是 | 民族 |  |
| domicile | string | 是 | 户籍 |  |
| status | string | 是 | 状态 | "PERIOD_OF_PROBATION" |
| entryDate | string(date) | 否 | 入职日期 | "2020-10-11" |
| positiveDate | string(date) | 否 | 转正日期 | "2020-10-11" |
| resignDate | string(date) | 否 | 离职日期 | "2020-10-11" |
| bankCard | string | 否 | 开户行 |  |
| bankCardNum | string | 否 | 银行卡号 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| merchantId | integer(int64) | 是 | 商户号ID |  |
| externalCode | string | 否 | 外部编号 |  |
| name | string | 否 | 名称 |  |
| image | string | 否 | 头像 |  |
| birthday | string(date) | 否 | 出生日期 |  |
| sex | string | 否 | 性别 |  |
| bank | string | 否 | 银行(名)，sys_property获取 |  |
| partnerId | integer(int64) | 否 | CRM关系ID |  |
| contact | ContactDTO$AddDTO | 是 |  |  |
| positionDepartmentDTOList | PositionDepartmentDTO[] | 是 | 部门职位对象集合 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrEmployee（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrEmployee）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrEmployee | 否 |  |  |

<a id="post-api-hr-employee-adduseremployee-userid-addemployeeuser"></a>

### POST /api/hr/employee/addUserEmployee/{userId}

- 分组：员工管理
- 名称：添加用户员工
- OperationId：addEmployeeUser

#### 调用方法

`POST /api/hr/employee/addUserEmployee/{userId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| userId | path | 是 | integer(int64) | 用户ID | 1 |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：EmployeeDTO$AddDTO（com.leadwaycloud.hr.model.dto.EmployeeDTO$AddDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 否 | 编号 |  |
| nationality | string | 是 | 民族 |  |
| domicile | string | 是 | 户籍 |  |
| status | string | 是 | 状态 | "PERIOD_OF_PROBATION" |
| entryDate | string(date) | 否 | 入职日期 | "2020-10-11" |
| positiveDate | string(date) | 否 | 转正日期 | "2020-10-11" |
| resignDate | string(date) | 否 | 离职日期 | "2020-10-11" |
| bankCard | string | 否 | 开户行 |  |
| bankCardNum | string | 否 | 银行卡号 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| merchantId | integer(int64) | 是 | 商户号ID |  |
| externalCode | string | 否 | 外部编号 |  |
| name | string | 否 | 名称 |  |
| image | string | 否 | 头像 |  |
| birthday | string(date) | 否 | 出生日期 |  |
| sex | string | 否 | 性别 |  |
| bank | string | 否 | 银行(名)，sys_property获取 |  |
| partnerId | integer(int64) | 否 | CRM关系ID |  |
| contact | ContactDTO$AddDTO | 是 |  |  |
| positionDepartmentDTOList | PositionDepartmentDTO[] | 是 | 部门职位对象集合 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrEmployee（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrEmployee）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrEmployee | 否 |  |  |

<a id="get-api-hr-employee-queryuseremployee-userid-queryuseremployee"></a>

### GET /api/hr/employee/queryUserEmployee/{userId}

- 分组：员工管理
- 名称：查询用户员工信息
- OperationId：queryUserEmployee

#### 调用方法

`GET /api/hr/employee/queryUserEmployee/{userId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| userId | path | 是 | integer(int64) | 用户ID | 1 |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrEmployee（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrEmployee）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrEmployee | 否 |  |  |

<a id="get-api-hr-employee-querybypositionid-positionid-querybypositionid"></a>

### GET /api/hr/employee/queryByPositionId/{positionId}

- 分组：员工管理
- 名称：查询职位下的员工列表
- OperationId：queryByPositionId

#### 调用方法

`GET /api/hr/employee/queryByPositionId/{positionId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| positionId | path | 是 | integer(int64) | 职位ID | 0 |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrEmployeeDepartmentPosition（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.hr.HrEmployeeDepartmentPosition）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrEmployeeDepartmentPosition[] | 否 | 返回数据 |  |

<a id="get-api-hr-employee-querybydepartmentid-departmentid-querybydepartmentid"></a>

### GET /api/hr/employee/queryByDepartmentId/{departmentId}

- 分组：员工管理
- 名称：查询部门下的员工列表
- OperationId：queryByDepartmentId

#### 调用方法

`GET /api/hr/employee/queryByDepartmentId/{departmentId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| departmentId | path | 是 | integer(int64) | 部门ID | 0 |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrEmployeeDepartmentPosition（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.hr.HrEmployeeDepartmentPosition）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrEmployeeDepartmentPosition[] | 否 | 返回数据 |  |

<a id="get-api-hr-employee-page-page-1"></a>

### GET /api/hr/employee/page

- 分组：员工管理
- 名称：查询员工列表
- OperationId：page_1

#### 调用方法

`GET /api/hr/employee/page`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| page | query | 是 | integer(int32) | 查询页码 | 0 |
| size | query | 是 | integer(int32) | 查询页行数 | 10 |
| companyId | query | 是 | integer(int64) | 公司ID |  |
| code | query | 否 | string | 编号 |  |
| nationality | query | 否 | string | 民族 |  |
| domicile | query | 否 | string | 户籍 |  |
| statusList | query | 否 | string | 状态 | "PERIOD_OF_PROBATION" |
| parentId | query | 否 | integer(int64) | 上一级ID |  |
| externalCode | query | 否 | string | 外部编号 |  |
| name | query | 否 | string | 名称 |  |
| companyIdList | query | 否 | integer(int64)[] |  |  |
| queryAssociateUser | query | 否 | boolean | 查询关联用户 |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrEmployee（com.leadwaycloud.core.model.RCom.leadwaycloud.core.model.PCom.leadwaycloud.hr.model.entity.hr.HrEmployee）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrEmployee | 否 |  |  |

<a id="get-api-hr-employee-get-id-get-2"></a>

### GET /api/hr/employee/get/{id}

- 分组：员工管理
- 名称：查询员工详情
- OperationId：get_2

#### 调用方法

`GET /api/hr/employee/get/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 员工ID | 0 |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrEmployee（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrEmployee）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrEmployee | 否 |  |  |

<a id="put-api-hr-department-updatebingstockwarehouse-id-updatebingstockwarehouse"></a>

### PUT /api/hr/department/updateBingStockWarehouse/{id}

- 分组：部门管理
- 名称：编辑部门绑定仓库
- OperationId：updateBingStockWarehouse

#### 调用方法

`PUT /api/hr/department/updateBingStockWarehouse/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 部门ID | 0 |
| stockWarehouseIdList | query | 是 | string | 仓库ID集合 | 0 |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：integer(int64)[]

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| (array) | integer(int64)[] |  |  |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Void（com.leadwaycloud.core.model.RJava.lang.Void）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="put-api-hr-department-updatebinggoodscategory-id-updatebinggoodscategory"></a>

### PUT /api/hr/department/updateBingGoodsCategory/{id}

- 分组：部门管理
- 名称：编辑部门绑定商品类型
- OperationId：updateBingGoodsCategory

#### 调用方法

`PUT /api/hr/department/updateBingGoodsCategory/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 部门ID | 0 |
| goodsCategoryIdList | query | 是 | string | 产品类型ID集合 | [0,1,2] |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：integer(int64)[]

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| (array) | integer(int64)[] |  |  |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Void（com.leadwaycloud.core.model.RJava.lang.Void）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="put-api-hr-department-update-id-update-3"></a>

### PUT /api/hr/department/update/{id}

- 分组：部门管理
- 名称：编辑部门
- OperationId：update_3

#### 调用方法

`PUT /api/hr/department/update/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 部门ID | 0 |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：DepartmentDTO$UpdateDTO（com.leadwaycloud.hr.model.dto.DepartmentDTO$UpdateDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 是 | 名称 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| phone | string | 否 | 电话 |  |
| fax | string | 否 | 传真 |  |
| email | string | 否 | 邮箱 |  |
| note | string | 否 | 备注 |  |
| externalCode | string | 否 | 外部编号 |  |
| code | string | 是 | 编号 |  |
| status | string | 否 | 状态 | "ACTIVE" |
| shortName | string | 否 | 简称 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrDepartment（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrDepartment）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrDepartment | 否 |  |  |

<a id="post-api-hr-department-add-add-3"></a>

### POST /api/hr/department/add

- 分组：部门管理
- 名称：添加部门
- OperationId：add_3

#### 调用方法

`POST /api/hr/department/add`

#### 参数

无

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：DepartmentDTO$AddDTO（com.leadwaycloud.hr.model.dto.DepartmentDTO$AddDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 是 | 名称 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| phone | string | 否 | 电话 |  |
| fax | string | 否 | 传真 |  |
| email | string | 否 | 邮箱 |  |
| note | string | 否 | 备注 |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| merchantId | integer(int64) | 是 | 商户号ID |  |
| externalCode | string | 否 | 外部编号 |  |
| code | string | 否 | 编号 |  |
| shortName | string | 否 | 简称 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrDepartment（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrDepartment）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrDepartment | 否 |  |  |

<a id="get-api-hr-department-querystockwarehouse-id-querystockwarehouse"></a>

### GET /api/hr/department/queryStockWarehouse/{id}

- 分组：部门管理
- 名称：查询部门下的仓库
- OperationId：queryStockWarehouse

#### 调用方法

`GET /api/hr/department/queryStockWarehouse/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 部门ID | 0 |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：StockWarehouse（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.stock.StockWarehouse）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | StockWarehouse[] | 否 | 返回数据 |  |

<a id="get-api-hr-department-queryhrdepartment-warehouseid-queryhrdepartment"></a>

### GET /api/hr/department/queryHrDepartment/{warehouseId}

- 分组：部门管理
- 名称：查询仓库下的部门
- OperationId：queryHrDepartment

#### 调用方法

`GET /api/hr/department/queryHrDepartment/{warehouseId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| warehouseId | path | 是 | integer(int64) | 仓库id |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrDepartment（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.hr.HrDepartment）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrDepartment[] | 否 | 返回数据 |  |

<a id="get-api-hr-department-querygoodscategory-id-querygoodscategory"></a>

### GET /api/hr/department/queryGoodsCategory/{id}

- 分组：部门管理
- 名称：查询部门下的商品类型
- OperationId：queryGoodsCategory

#### 调用方法

`GET /api/hr/department/queryGoodsCategory/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 部门ID | 0 |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：StockGoodsCategory（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.stock.StockGoodsCategory）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | StockGoodsCategory[] | 否 | 返回数据 |  |

<a id="get-api-hr-department-list-list-2"></a>

### GET /api/hr/department/list

- 分组：部门管理
- 名称：查询部门列表
- OperationId：list_2

#### 调用方法

`GET /api/hr/department/list`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| name | query | 否 | string | 名称 |  |
| companyId | query | 否 | integer(int64) | 公司ID |  |
| merchantId | query | 否 | integer(int64) | 商户ID |  |
| statusList | query | 否 | string[] |  |  |
| code | query | 否 | string | 编号 |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrDepartment（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.hr.HrDepartment）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrDepartment[] | 否 | 返回数据 |  |

<a id="get-api-hr-department-get-id-get-3"></a>

### GET /api/hr/department/get/{id}

- 分组：部门管理
- 名称：查询部门详情
- OperationId：get_3

#### 调用方法

`GET /api/hr/department/get/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 部门ID | 0 |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：HrDepartment（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrDepartment）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrDepartment | 否 |  |  |

<a id="put-api-hr-calendarschedule-update-id-update-4"></a>

### PUT /api/hr/calendarSchedule/update/{id}

- 分组：日历日程管理
- 名称：编辑日历日程
- OperationId：update_4

#### 调用方法

`PUT /api/hr/calendarSchedule/update/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 日历日程ID | 0 |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：CalendarScheduleDTO$UpdateDTO（com.leadwaycloud.hr.model.dto.CalendarScheduleDTO$UpdateDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| companyList | integer(int64)[] | 否 | 公司ID |  |
| type | string | 是 | 类型(WEEKEND:周末 TAKE:调休 HOLIDAY:节假日) |  |
| bigAndSmall | boolean | 否 | 是否大小周 |  |
| wage | integer(int32) | 是 | 薪资倍数 |  |
| startDate | string(date) | 否 | 开始日期 | "2024-01-02" |
| endDate | string(date) | 否 | 结束日期 | "2020-10-11" |
| repeat | string | 是 | 重复类型 NONE:无 DAY:每天 WEEK:每周 MONTH:每月 YEAR:每年 | "NONE" |
| weekDay | integer(int32) | 否 | 每周周几(1,2,3,4,5,6,7) |  |
| monthDay | integer(int32) | 否 | 每月几号(1,2,3...31) |  |
| yearDay | string | 否 | 每年的几月几号(01-01) |  |
| content | string | 是 | 日程内容 |  |
| attachment | string | 否 | 自定义数据(json格式) |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：CalendarSchedule（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.calendar.schedule.CalendarSchedule）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | CalendarSchedule | 否 |  |  |

<a id="post-api-hr-calendarschedule-add-add-4"></a>

### POST /api/hr/calendarSchedule/add

- 分组：日历日程管理
- 名称：添加日历日程
- OperationId：add_4

#### 调用方法

`POST /api/hr/calendarSchedule/add`

#### 参数

无

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：CalendarScheduleDTO$AddDTO（com.leadwaycloud.hr.model.dto.CalendarScheduleDTO$AddDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| companyId | integer(int64) | 否 | 公司ID |  |
| type | string | 是 | 类型(WEEKEND:周末 TAKE:调休 HOLIDAY:节假日) |  |
| bigAndSmall | boolean | 否 | 是否大小周 |  |
| wage | integer(int32) | 是 | 薪资倍数 |  |
| startDate | string(date) | 否 | 开始日期 | "2024-01-02" |
| endDate | string(date) | 否 | 结束日期 | "2020-10-11" |
| repeat | string | 是 | 重复类型 NONE:无 DAY:每天 WEEK:每周 MONTH:每月 YEAR:每年 | "NONE" |
| weekDay | integer(int32) | 否 | 每周周几(1,2,3,4,5,6,7) |  |
| monthDay | integer(int32) | 否 | 每月几号(1,2,3...31) |  |
| yearDay | string | 否 | 每年的几月几号(01-01) |  |
| content | string | 是 | 日程内容 |  |
| attachment | string | 否 | 自定义数据(json格式) |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：CalendarSchedule（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.calendar.schedule.CalendarSchedule）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | CalendarSchedule | 否 |  |  |

<a id="get-api-hr-calendarschedule-page-page-2"></a>

### GET /api/hr/calendarSchedule/page

- 分组：日历日程管理
- 名称：查询日历日程
- OperationId：page_2

#### 调用方法

`GET /api/hr/calendarSchedule/page`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| page | query | 是 | integer(int32) | 查询页码 | 0 |
| size | query | 是 | integer(int32) | 查询页行数 | 10 |
| companyId | query | 否 | integer(int64) | 公司ID |  |
| type | query | 否 | string | 类型(WEEKEND:周末 TAKE:调休 HOLIDAY:节假日)  【 WORK : WEEKEND : TAKE : HOLIDAY : 】 |  |
| content | query | 否 | string | 日程内容 |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：CalendarSchedule（com.leadwaycloud.core.model.RCom.leadwaycloud.core.model.PCom.leadwaycloud.hr.model.entity.calendar.schedule.CalendarSchedule）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | CalendarSchedule | 否 |  |  |

<a id="get-api-hr-calendarschedule-list-list-3"></a>

### GET /api/hr/calendarSchedule/list

- 分组：日历日程管理
- 名称：查询时间区间日程
- OperationId：list_3

#### 调用方法

`GET /api/hr/calendarSchedule/list`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| companyList | query | 否 | integer(int64)[] |  |  |
| startDate | query | 是 | string(date) | 开始日期 | "2024-01-01" |
| endDate | query | 是 | string(date) | 结束日期 | "2024-01-30" |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：CalendarScheduleVO（com.leadwaycloud.core.model.RJava.util.MapJava.lang.StringCom.leadwaycloud.hr.model.vo.CalendarScheduleVO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="delete-api-hr-calendarschedule-delete-id-updatebingstockwarehouse-1"></a>

### DELETE /api/hr/calendarSchedule/delete/{id}

- 分组：日历日程管理
- 名称：删除日历日程
- OperationId：updateBingStockWarehouse_1

#### 调用方法

`DELETE /api/hr/calendarSchedule/delete/{id}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer(int64) | 日历日程ID | 0 |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Void（com.leadwaycloud.core.model.RJava.lang.Void）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="put-api-dining-updatetickettype-tickettypeid-updatetickettype"></a>

### PUT /api/dining/updateTicketType/{ticketTypeId}

- 分组：餐食
- 名称：修改餐票类型
- OperationId：updateTicketType

#### 调用方法

`PUT /api/dining/updateTicketType/{ticketTypeId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| ticketTypeId | path | 是 | integer(int64) | 餐票类型ID |  |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：DiningDTO$UpdateTicketTypeDTO（com.leadwaycloud.hr.model.dto.DiningDTO$UpdateTicketTypeDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 否 |  |  |
| image | string | 否 |  |  |
| style | string | 否 |  |  |
| predictEndTime | LocalTime | 否 |  |  |
| validStartTime | LocalTime | 否 |  |  |
| validEndTime | LocalTime | 否 |  |  |
| status | string | 否 | ACTIVE:可用 VOID:作废 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：DiningTicketType（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.dining.DiningTicketType）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningTicketType | 否 |  |  |

<a id="put-api-dining-updatecanteen-canteenid-updatetickettype-1"></a>

### PUT /api/dining/updateCanteen/{canteenId}

- 分组：餐食
- 名称：修改食堂信息
- OperationId：updateTicketType_1

#### 调用方法

`PUT /api/dining/updateCanteen/{canteenId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| canteenId | path | 是 | integer(int64) | 食堂ID |  |

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：DiningDTO$UpdateCanteenDTO（com.leadwaycloud.hr.model.dto.DiningDTO$UpdateCanteenDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 否 |  |  |
| image | string | 否 |  |  |
| status | string | 否 |  |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：DiningCanteen（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.dining.DiningCanteen）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningCanteen | 否 |  |  |

<a id="put-api-dining-destroyticket-ticketid-destoryticket"></a>

### PUT /api/dining/destroyTicket/{ticketId}

- 分组：餐食
- 名称：餐票核销
- OperationId：destoryTicket

#### 调用方法

`PUT /api/dining/destroyTicket/{ticketId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| ticketId | path | 是 | integer(int64) | 餐票ID |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Void（com.leadwaycloud.core.model.RJava.lang.Void）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="post-api-dining-manualticket-manualticket"></a>

### POST /api/dining/manualTicket

- 分组：餐食
- 名称：手工发放餐票
- OperationId：manualTicket

#### 调用方法

`POST /api/dining/manualTicket`

#### 参数

无

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：DiningDTO$ManualTicketDTO（com.leadwaycloud.hr.model.dto.DiningDTO$ManualTicketDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| canteenId | integer(int64) | 是 |  |  |
| date | string(date) | 是 |  |  |
| ticketTypeId | integer(int64) | 是 |  |  |
| userIdList | integer(int64) | 是 |  |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：DiningTicket（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.dining.DiningTicket）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningTicket[] | 否 | 返回数据 |  |

<a id="post-api-dining-applyticket-applyticket"></a>

### POST /api/dining/applyTicket

- 分组：餐食
- 名称：领取餐票
- OperationId：applyTicket

#### 调用方法

`POST /api/dining/applyTicket`

#### 参数

无

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：DiningDTO$ApplyTicketDTO（com.leadwaycloud.hr.model.dto.DiningDTO$ApplyTicketDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| canteenId | integer(int64) | 是 | 食堂ID |  |
| date | string(date) | 是 | 使用日期 |  |
| ticketTypeIdList | integer(int64)[] | 是 | 餐食票类型ID集合 |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：DiningTicket（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.dining.DiningTicket）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningTicket[] | 否 | 返回数据 |  |

<a id="post-api-dining-addtickettype-addtickettype"></a>

### POST /api/dining/addTicketType

- 分组：餐食
- 名称：添加餐票类型
- OperationId：addTicketType

#### 调用方法

`POST /api/dining/addTicketType`

#### 参数

无

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：DiningDTO$AddTicketTypeDTO（com.leadwaycloud.hr.model.dto.DiningDTO$AddTicketTypeDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 是 | 名称 |  |
| image | string | 是 | 图片 |  |
| style | string | 是 | 样式 |  |
| predictEndTime | LocalTime | 是 |  |  |
| validStartTime | LocalTime | 是 |  |  |
| validEndTime | LocalTime | 是 |  |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：DiningTicketType（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.dining.DiningTicketType）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningTicketType | 否 |  |  |

<a id="post-api-dining-addcanteen-addtickettype-1"></a>

### POST /api/dining/addCanteen

- 分组：餐食
- 名称：添加食堂
- OperationId：addTicketType_1

#### 调用方法

`POST /api/dining/addCanteen`

#### 参数

无

#### 请求体


- Content-Type：`application/json`
- 必填：是
- 类型：DiningDTO$AddCanteenDTO（com.leadwaycloud.hr.model.dto.DiningDTO$AddCanteenDTO）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 是 |  |  |
| name | string | 是 |  |  |
| image | string | 是 |  |  |

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：DiningCanteen（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.dining.DiningCanteen）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningCanteen | 否 |  |  |

<a id="get-api-dining-qyermerchantcurrentdayticketcount-querycurrentdayticketcount"></a>

### GET /api/dining/qyerMerchantCurrentDayTicketCount

- 分组：餐食
- 名称：查询商户当日各类型餐票订餐数量
- OperationId：queryCurrentDayTicketCount

#### 调用方法

`GET /api/dining/qyerMerchantCurrentDayTicketCount`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| companyId | query | 否 | integer(int64) | 公司ID |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Integer（com.leadwaycloud.core.model.RJava.util.MapJava.lang.StringJava.util.MapJava.lang.StringJava.lang.Integer）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="get-api-dining-queryuserticket-queryuserticket"></a>

### GET /api/dining/queryUserTicket

- 分组：餐食
- 名称：用户餐票查询
- OperationId：queryUserTicket

#### 调用方法

`GET /api/dining/queryUserTicket`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| date | query | 否 | string(date) |  |  |
| isDestory | query | 否 | boolean |  |  |
| ticketTypeId | query | 否 | integer(int64) |  |  |
| canteenId | query | 否 | integer(int64) |  |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：DiningTicket（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.dining.DiningTicket）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningTicket[] | 否 | 返回数据 |  |

<a id="get-api-dining-querytickettype-tickettypeid-querytickettypelist"></a>

### GET /api/dining/queryTicketType/{ticketTypeId}

- 分组：餐食
- 名称：查询餐票类型详情
- OperationId：queryTicketTypeList

#### 调用方法

`GET /api/dining/queryTicketType/{ticketTypeId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| ticketTypeId | path | 是 | integer(int64) | 餐票类型ID |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：DiningTicketType（com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.dining.DiningTicketType）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningTicketType | 否 |  |  |

<a id="get-api-dining-querytickettype-list-querytickettypelist-1"></a>

### GET /api/dining/queryTicketType/list

- 分组：餐食
- 名称：查询餐票类型列表
- OperationId：queryTicketTypeList_1

#### 调用方法

`GET /api/dining/queryTicketType/list`

#### 参数

无

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：DiningTicketType（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.dining.DiningTicketType）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningTicketType[] | 否 | 返回数据 |  |

<a id="get-api-dining-querycanteenticket-canteenid-querycanteenticket"></a>

### GET /api/dining/queryCanteenTicket/{canteenId}

- 分组：餐食
- 名称：食堂餐票查询
- OperationId：queryCanteenTicket

#### 调用方法

`GET /api/dining/queryCanteenTicket/{canteenId}`

#### 参数

| 名称 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| canteenId | path | 是 | integer(int64) | 食堂ID |  |
| date | query | 否 | string(date) |  |  |
| isDestory | query | 否 | boolean |  |  |
| ticketTypeId | query | 否 | integer(int64) |  |  |
| userId | query | 否 | integer(int64) |  |  |

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：DiningTicket（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.dining.DiningTicket）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningTicket[] | 否 | 返回数据 |  |

<a id="get-api-dining-querycanteenlist-querycanteenlist"></a>

### GET /api/dining/queryCanteenList

- 分组：餐食
- 名称：获取食堂列表
- OperationId：queryCanteenList

#### 调用方法

`GET /api/dining/queryCanteenList`

#### 参数

无

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：DiningCanteen（com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.dining.DiningCanteen）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningCanteen[] | 否 | 返回数据 |  |

<a id="delete-api-dining-removeexpireticket-removeexpireticket"></a>

### DELETE /api/dining/removeExpireTicket

- 分组：餐食
- 名称：删除过期餐票
- OperationId：removeExpireTicket

#### 调用方法

`DELETE /api/dining/removeExpireTicket`

#### 参数

无

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Void（com.leadwaycloud.core.model.RJava.lang.Void）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="get-api-monitor-version-version"></a>

### GET /api/monitor/version

- 分组：服务监控管理
- 名称：获取服务版本信息
- OperationId：version

#### 调用方法

`GET /api/monitor/version`

#### 参数

无

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Object（com.leadwaycloud.core.model.RJava.lang.Object）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

<a id="get-api-monitor-health-health"></a>

### GET /api/monitor/health

- 分组：服务监控管理
- 名称：心跳检查
- OperationId：health

#### 调用方法

`GET /api/monitor/health`

#### 参数

无

#### 请求体

无

#### 响应


- 状态码：`200`
- 说明：OK
- Content-Type：`*/*`
- 类型：Object（com.leadwaycloud.core.model.RJava.lang.Object）

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |


## 模型定义

### com.leadwaycloud.core.model.RJava.lang.Object

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

### com.leadwaycloud.hr.model.dto.shift.ShiftScheduleDTO$UpdateDTO

更新排班方案DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 是 | 方案编码 |  |
| name | string | 是 | 方案名称 |  |
| note | string | 否 | 备注 |  |

### com.leadwaycloud.hr.model.dto.PositionDTO$UpdateDTO

编辑职位DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 否 | 名称 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| phone | string | 否 | 电话 |  |
| fax | string | 否 | 传真 |  |
| email | string | 否 | 邮箱 |  |
| note | string | 否 | 备注 |  |
| externalCode | string | 否 | 外部编号 |  |
| code | string | 否 | 编号 |  |
| status | string | 否 | 状态 | "ACTIVE" |

### com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrPosition

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrPosition | 否 |  |  |

### com.leadwaycloud.hr.model.entity.hr.HrPosition

职位

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| name | string | 是 | 名称 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| idChain | string | 是 | 完成的组织架构值 |  |
| note | string | 否 | 备注 |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| merchantId | integer(int64) | 是 | 商户号ID |  |
| externalCode | string | 否 | 外部编号 |  |
| code | string | 是 | 编号 |  |
| status | string | 是 | 状态 | "ACTIVE" |

### com.leadwaycloud.hr.model.dto.ContactDTO$UpdateDTO

编辑联系地址DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| countryId | integer(int64) | 否 | 国家ID |  |
| stateId | integer(int64) | 否 | 省、直辖市ID |  |
| cityId | integer(int64) | 否 | 城市ID |  |
| areaId | integer(int64) | 否 | 区、县ID |  |
| streetId | integer(int64) | 否 | 街道ID |  |
| address | string | 否 | 详细地址 |  |
| postcode | string | 否 | 邮编 |  |
| phone | string | 否 | 电话 |  |
| mobile | string | 否 | 手机 |  |
| fax | string | 否 | 传真 |  |
| email | string | 否 | 邮箱 |  |

### com.leadwaycloud.hr.model.dto.EmployeeDTO$UpdateDTO

编辑员工DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 否 | 编号 |  |
| nationality | string | 否 | 民族 |  |
| domicile | string | 否 | 户籍 |  |
| status | string | 否 | 状态 | "PERIOD_OF_PROBATION" |
| entryDate | string(date) | 否 | 入职日期 | "2020-10-11" |
| positiveDate | string(date) | 否 | 转正日期 | "2020-10-11" |
| resignDate | string(date) | 否 | 离职日期 | "2020-10-11" |
| bankCard | string | 否 | 银行卡 |  |
| bankCardNum | string | 否 | 银行卡号 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| externalCode | string | 否 | 外部编号 |  |
| name | string | 否 | 名称 |  |
| image | string | 否 | 头像 |  |
| birthday | string(date) | 否 | 出生日期 |  |
| sex | string | 否 | 性别 |  |
| bank | string | 否 | 银行(名)，sys_property获取 |  |
| contact | ContactDTO$UpdateDTO | 否 |  |  |
| positionDepartmentDTOList | PositionDepartmentDTO[] | 否 | 部门职位对象集合 |  |

### com.leadwaycloud.hr.model.dto.PositionDepartmentDTO

编辑员工职位/部门DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| positionId | integer(int64) | 是 | 职位ID |  |
| departmentId | integer(int64) | 是 | 部门ID |  |
| companyId | integer(int64) | 是 | 公司ID |  |

### com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrEmployee

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrEmployee | 否 |  |  |

### com.leadwaycloud.hr.model.entity.hr.HrDepartment

部门

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| name | string | 是 | 名称 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| idChain | string | 是 | 完整的组织架构值 |  |
| phone | string | 否 | 电话 |  |
| fax | string | 否 | 传真 |  |
| email | string | 否 | 邮箱 |  |
| note | string | 否 | 备注 |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| merchantId | integer(int64) | 是 | 商户号ID |  |
| externalCode | string | 否 | 外部编号 |  |
| code | string | 是 | 编号 |  |
| status | string | 是 | 状态 |  |
| idaasId | string | 否 | idaas唯一ID |  |
| shortName | string | 否 | 简称 |  |

### com.leadwaycloud.hr.model.entity.hr.HrEmployee

员工

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| code | string | 是 | 编号 |  |
| nationality | string | 是 | 名族 |  |
| domicile | string | 是 | 户籍 |  |
| status | string | 是 | 状态 | "PERIOD_OF_PROBATION" |
| entryDate | string(date) | 否 | 入职日期 | "2020-10-11" |
| positiveDate | string(date) | 否 | 转正日期 | "2020-10-11" |
| resignDate | string(date) | 否 | 离职日期 | "2020-10-11" |
| bankCard | string | 否 | 银行卡 |  |
| bankCardNum | string | 否 | 银行卡号 |  |
| partnerId | integer(int64) | 是 | 客户关系对象ID |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| merchantId | integer(int64) | 是 | 商户号ID |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| idChain | string | 是 | 完整的组织架构值 |  |
| externalCode | string | 否 | 外部编号 |  |
| name | string | 否 | 名称 |  |
| image | string | 否 | 头像 |  |
| contactId | integer(int64) | 是 | 地址ID |  |
| birthday | string(date) | 否 | 出生日期 |  |
| sex | string | 否 | 性别 |  |
| bank | string | 否 | 银行(名)，sys_property获取 |  |
| contact | ResContact | 否 |  |  |
| employeeDepartmentPositionList | HrEmployeeDepartmentPosition[] | 否 | 员工-部门-职位 |  |

### com.leadwaycloud.hr.model.entity.hr.HrEmployeeDepartmentPosition

员工-部门-职位

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| employeeId | integer(int64) | 是 | 员工ID |  |
| positionId | integer(int64) | 是 | 职位ID |  |
| departmentId | integer(int64) | 是 | 部门ID |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| employee | HrEmployee | 否 |  |  |
| position | HrPosition | 否 |  |  |
| department | HrDepartment | 否 |  |  |
| company | ResCompany | 否 |  |  |

### com.leadwaycloud.hr.model.entity.res.ResCompany

公司模型

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| merchantId | integer(int64) | 是 | 商户ID |  |
| partnerId | integer(int64) | 是 | 关系ID |  |
| code | string | 是 | 公司编号（仅允许字母和数字） | "CD01" |
| otherCode | string | 否 | 其他编号 | "AAAA-01" |
| type | string | 是 | 类型 |  |
| status | string | 是 | 状态 |  |
| parentId | integer(int64) | 否 | 上级公司ID |  |
| idChain | string | 否 | 公司ID完整架构（上下级公司id用-连接） | "123-456" |
| slogan | string | 否 | 公司标语 |  |
| initConfig | boolean | 否 | 是否已经初始化公司配置 true:已初始化 false:未初始化 | false |
| name | string | 是 | 名称 |  |
| image | string | 否 | 图片 |  |
| contactId | integer(int64) | 否 | 地址ID |  |
| foreignNames | string | 否 | 其他国家名称JSON字符串 |  |
| content | string | 否 | 其他详情JSON字符串，可动态添加附件字段名 |  |
| enName | string | 否 | 发票名称 |  |
| currencyId | integer(int64) | 否 | 货币Id |  |

### com.leadwaycloud.hr.model.entity.res.ResContact

地址联系关系

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| countryId | integer(int64) | 否 | 国家ID |  |
| stateId | integer(int64) | 否 | 省、直辖市ID |  |
| cityId | integer(int64) | 否 | 城市ID |  |
| areaId | integer(int64) | 否 | 区、县ID |  |
| streetId | integer(int64) | 否 | 街道ID |  |
| address | string | 否 | 详细地址 |  |
| postcode | string | 否 | 邮编 |  |
| phone | string | 否 | 电话 |  |
| phoneExtension | string | 否 | 电话-分机号 |  |
| mobile | string | 否 | 手机 |  |
| fax | string | 否 | 传真 |  |
| faxExtension | string | 否 | 传真-分机号 |  |
| email | string | 否 | 邮箱 | "邮箱" |
| houseNumber | string | 否 | 门牌号 |  |

### com.leadwaycloud.core.model.RJava.lang.Void

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

### com.leadwaycloud.hr.model.dto.DepartmentDTO$UpdateDTO

编辑部门DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 是 | 名称 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| phone | string | 否 | 电话 |  |
| fax | string | 否 | 传真 |  |
| email | string | 否 | 邮箱 |  |
| note | string | 否 | 备注 |  |
| externalCode | string | 否 | 外部编号 |  |
| code | string | 是 | 编号 |  |
| status | string | 否 | 状态 | "ACTIVE" |
| shortName | string | 否 | 简称 |  |

### com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.hr.HrDepartment

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrDepartment | 否 |  |  |

### com.leadwaycloud.hr.model.dto.CalendarScheduleDTO$UpdateDTO

编辑日历日程

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| companyList | integer(int64)[] | 否 | 公司ID |  |
| type | string | 是 | 类型(WEEKEND:周末 TAKE:调休 HOLIDAY:节假日) |  |
| bigAndSmall | boolean | 否 | 是否大小周 |  |
| wage | integer(int32) | 是 | 薪资倍数 |  |
| startDate | string(date) | 否 | 开始日期 | "2024-01-02" |
| endDate | string(date) | 否 | 结束日期 | "2020-10-11" |
| repeat | string | 是 | 重复类型 NONE:无 DAY:每天 WEEK:每周 MONTH:每月 YEAR:每年 | "NONE" |
| weekDay | integer(int32) | 否 | 每周周几(1,2,3,4,5,6,7) |  |
| monthDay | integer(int32) | 否 | 每月几号(1,2,3...31) |  |
| yearDay | string | 否 | 每年的几月几号(01-01) |  |
| content | string | 是 | 日程内容 |  |
| attachment | string | 否 | 自定义数据(json格式) |  |

### com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.calendar.schedule.CalendarSchedule

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | CalendarSchedule | 否 |  |  |

### com.leadwaycloud.hr.model.entity.calendar.schedule.CalendarSchedule

返回数据

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| merchantId | integer(int64) | 是 | 商户ID |  |
| companyId | integer(int64) | 否 | 公司ID |  |
| type | string | 是 | 类型(WORK:工作日 WEEKEND:周末 TAKE:调休 HOLIDAY:节假日) |  |
| bigAndSmall | boolean | 否 | 是否大小周 |  |
| wage | integer(int32) | 是 | 薪资倍数 |  |
| startDate | string(date) | 是 | 开始日期 | "2024-01-02" |
| endDate | string(date) | 否 | 结束日期 | "2020-10-11" |
| repeat | string | 是 | 重复类型 NONE:无 DAY:每天 WEEK:每周 MONTH:每月 YEAR:每年 | "NONE" |
| weekDay | integer(int32) | 否 | 每周周几(1,2,3,4,5,6,7) |  |
| monthDay | integer(int32) | 否 | 每月几号(1,2,3...31) |  |
| yearDay | string | 否 | 每年的几月几号(01-01) |  |
| content | string | 是 | 日程内容 |  |
| attachment | string | 否 | 自定义数据(json格式) |  |

### com.leadwaycloud.hr.model.dto.DiningDTO$UpdateTicketTypeDTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 否 |  |  |
| image | string | 否 |  |  |
| style | string | 否 |  |  |
| predictEndTime | LocalTime | 否 |  |  |
| validStartTime | LocalTime | 否 |  |  |
| validEndTime | LocalTime | 否 |  |  |
| status | string | 否 | ACTIVE:可用 VOID:作废 |  |

### java.time.LocalTime

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| hour | integer(int32) | 否 |  |  |
| minute | integer(int32) | 否 |  |  |
| second | integer(int32) | 否 |  |  |
| nano | integer(int32) | 否 |  |  |

### com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.dining.DiningTicketType

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningTicketType | 否 |  |  |

### com.leadwaycloud.hr.model.entity.dining.DiningTicketType

返回数据

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| name | string | 否 |  |  |
| image | string | 否 |  |  |
| style | string | 否 |  |  |
| validStartTime | LocalTime | 否 |  |  |
| validEndTime | LocalTime | 否 |  |  |
| predictEndTime | LocalTime | 否 |  |  |
| companyId | integer(int64) | 否 |  |  |
| status | string | 否 |  |  |

### com.leadwaycloud.hr.model.dto.DiningDTO$UpdateCanteenDTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 否 |  |  |
| image | string | 否 |  |  |
| status | string | 否 |  |  |

### com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.entity.dining.DiningCanteen

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningCanteen | 否 |  |  |

### com.leadwaycloud.hr.model.entity.dining.DiningCanteen

公司员工食堂

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| code | string | 否 | 编号 |  |
| name | string | 否 | 名称 |  |
| merchantId | integer(int64) | 否 | 商户ID |  |
| image | string | 否 | 图片 |  |
| status | string | 否 | 状态 |  |

### com.leadwaycloud.hr.model.dto.shift.ShiftScheduleDTO$StatusChangeDTO

状态变更DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | string | 是 | 状态 |  |

### com.leadwaycloud.core.model.RJava.lang.Long

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | integer(int64) | 否 | 返回数据 |  |

### com.leadwaycloud.hr.model.dto.shift.ShiftScheduleItemDTO$TimeSegmentDTO

添加排班方案班次时间段DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| startTime | LocalTime | 是 |  |  |
| endTime | LocalTime | 是 |  |  |
| type | string | 是 | 类型 |  |
| workHours | number | 是 | 工时 |  |

### com.leadwaycloud.hr.model.dto.shift.ShiftScheduleItemDTO$UpdateDTO

编辑排班方案班次DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 是 | 班次编码 |  |
| name | string | 是 | 班次名称 |  |
| no | integer(int32) | 是 | 排序号 |  |
| totalWorkHours | number | 是 | 总工时 |  |
| timeSegmentList | ShiftScheduleItemDTO$TimeSegmentDTO | 否 |  |  |

### com.leadwaycloud.hr.model.dto.shift.ShiftScheduleItemDTO$AddDTO

新增排班方案班次DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 是 | 班次编码 |  |
| name | string | 是 | 班次名称 |  |
| no | integer(int32) | 是 | 排序号 |  |
| totalWorkHours | number | 是 | 总工时 |  |
| timeSegmentList | ShiftScheduleItemDTO$TimeSegmentDTO | 否 |  |  |

### com.leadwaycloud.hr.model.dto.shift.ShiftScheduleDTO$AddDTO

添加排班方案DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| merchantId | integer(int64) | 是 | 商户ID |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| code | string | 是 | 方案编码 |  |
| name | string | 是 | 方案名称 |  |
| note | string | 否 | 备注 |  |

### com.leadwaycloud.hr.model.dto.PositionDTO$AddDTO

添加职位DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 是 | 名称 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| note | string | 否 | 备注 |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| merchantId | integer(int64) | 是 | 商户号ID |  |
| externalCode | string | 否 | 外部编号 |  |
| code | string | 否 | 编号 |  |

### com.leadwaycloud.hr.model.dto.ContactDTO$AddDTO

添加联系地址DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| countryId | integer(int64) | 否 | 国家ID |  |
| stateId | integer(int64) | 否 | 省、直辖市ID |  |
| cityId | integer(int64) | 否 | 城市ID |  |
| areaId | integer(int64) | 否 | 区、县ID |  |
| streetId | integer(int64) | 否 | 街道ID |  |
| address | string | 否 | 详细地址 |  |
| postcode | string | 否 | 邮编 |  |
| phone | string | 否 | 电话 |  |
| mobile | string | 否 | 手机 |  |
| fax | string | 否 | 传真 |  |
| email | string | 否 | 邮箱 |  |

### com.leadwaycloud.hr.model.dto.EmployeeDTO$AddDTO

添加员工DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 否 | 编号 |  |
| nationality | string | 是 | 民族 |  |
| domicile | string | 是 | 户籍 |  |
| status | string | 是 | 状态 | "PERIOD_OF_PROBATION" |
| entryDate | string(date) | 否 | 入职日期 | "2020-10-11" |
| positiveDate | string(date) | 否 | 转正日期 | "2020-10-11" |
| resignDate | string(date) | 否 | 离职日期 | "2020-10-11" |
| bankCard | string | 否 | 开户行 |  |
| bankCardNum | string | 否 | 银行卡号 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| merchantId | integer(int64) | 是 | 商户号ID |  |
| externalCode | string | 否 | 外部编号 |  |
| name | string | 否 | 名称 |  |
| image | string | 否 | 头像 |  |
| birthday | string(date) | 否 | 出生日期 |  |
| sex | string | 否 | 性别 |  |
| bank | string | 否 | 银行(名)，sys_property获取 |  |
| partnerId | integer(int64) | 否 | CRM关系ID |  |
| contact | ContactDTO$AddDTO | 是 |  |  |
| positionDepartmentDTOList | PositionDepartmentDTO[] | 是 | 部门职位对象集合 |  |

### com.leadwaycloud.hr.model.dto.DepartmentDTO$AddDTO

添加部门DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 是 | 名称 |  |
| parentId | integer(int64) | 否 | 上一级ID |  |
| phone | string | 否 | 电话 |  |
| fax | string | 否 | 传真 |  |
| email | string | 否 | 邮箱 |  |
| note | string | 否 | 备注 |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| merchantId | integer(int64) | 是 | 商户号ID |  |
| externalCode | string | 否 | 外部编号 |  |
| code | string | 否 | 编号 |  |
| shortName | string | 否 | 简称 |  |

### com.leadwaycloud.hr.model.dto.CalendarScheduleDTO$AddDTO

添加日历日程

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| companyId | integer(int64) | 否 | 公司ID |  |
| type | string | 是 | 类型(WEEKEND:周末 TAKE:调休 HOLIDAY:节假日) |  |
| bigAndSmall | boolean | 否 | 是否大小周 |  |
| wage | integer(int32) | 是 | 薪资倍数 |  |
| startDate | string(date) | 否 | 开始日期 | "2024-01-02" |
| endDate | string(date) | 否 | 结束日期 | "2020-10-11" |
| repeat | string | 是 | 重复类型 NONE:无 DAY:每天 WEEK:每周 MONTH:每月 YEAR:每年 | "NONE" |
| weekDay | integer(int32) | 否 | 每周周几(1,2,3,4,5,6,7) |  |
| monthDay | integer(int32) | 否 | 每月几号(1,2,3...31) |  |
| yearDay | string | 否 | 每年的几月几号(01-01) |  |
| content | string | 是 | 日程内容 |  |
| attachment | string | 否 | 自定义数据(json格式) |  |

### com.leadwaycloud.hr.model.dto.DiningDTO$ManualTicketDTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| canteenId | integer(int64) | 是 |  |  |
| date | string(date) | 是 |  |  |
| ticketTypeId | integer(int64) | 是 |  |  |
| userIdList | integer(int64) | 是 |  |  |

### com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.dining.DiningTicket

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningTicket[] | 否 | 返回数据 |  |

### com.leadwaycloud.hr.model.entity.dining.DiningTicket

餐食票

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| userId | integer(int64) | 是 |  |  |
| companyId | integer(int64) | 是 |  |  |
| applicationId | integer(int64) | 否 |  |  |
| canteenId | integer(int64) | 是 |  |  |
| ticketTypeId | integer(int64) | 是 |  |  |
| useDate | string(date) | 是 |  |  |
| batchCode | string | 是 |  |  |
| destroyTime | string(date-time) | 否 |  |  |
| destroyCode | string | 否 |  |  |
| destroyDeviceId | integer(int64) | 否 |  |  |
| sectionId | integer(int64) | 否 |  |  |
| ticketType | DiningTicketType | 否 |  |  |
| canteen | DiningCanteen | 否 |  |  |
| user | ResUser | 否 |  |  |
| company | ResCompany | 否 |  |  |

### com.leadwaycloud.hr.model.entity.res.ResUser

用户模型

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| status | string | 是 | 状态 |  |
| userName | string | 是 | 登录名称 |  |
| language | string | 是 | 语言 | "zh_CN" |
| companyId | integer(int64) | 否 | 公司ID |  |
| merchantId | integer(int64) | 否 | 商户ID |  |
| readVersionInfo | boolean | 否 | 是否已读更新版本信息 | false |
| name | string | 否 | 名称 |  |
| image | string | 否 | 图片 |  |
| partnerId | integer(int64) | 是 | CRM对象ID |  |
| contactId | integer(int64) | 否 | 地址联系ID |  |
| sign | string | 否 | 用户签名 |  |
| forceUpdatePassword | boolean | 否 | 是否强制修改密码 |  |
| idaasId | string | 否 | idaas唯一ID |  |
| allowLoginChannel | string | 否 | 允许登陆渠道(ERP:ERP_BACKEND,电商平台:ECOMMERCE_PLATFORM,供应商平台:SUPPLIER_PLATFORM)。如果有多个用,逗号隔开 |  |
| registerChannel | string | 否 | 注册渠道(ERP:ERP_BACKEND,电商平台:ECOMMERCE_PLATFORM,IDaaS平台:IDAAS) |  |
| userAuditStatus | string | 否 | 用户审核状态 |  |
| externalCode | string | 否 | 外部编号 |  |
| contact | ResContact | 否 |  |  |

### com.leadwaycloud.hr.model.dto.DiningDTO$ApplyTicketDTO

领取餐票DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| canteenId | integer(int64) | 是 | 食堂ID |  |
| date | string(date) | 是 | 使用日期 |  |
| ticketTypeIdList | integer(int64)[] | 是 | 餐食票类型ID集合 |  |

### com.leadwaycloud.hr.model.dto.DiningDTO$AddTicketTypeDTO

餐食票类型DTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| name | string | 是 | 名称 |  |
| image | string | 是 | 图片 |  |
| style | string | 是 | 样式 |  |
| predictEndTime | LocalTime | 是 |  |  |
| validStartTime | LocalTime | 是 |  |  |
| validEndTime | LocalTime | 是 |  |  |

### com.leadwaycloud.hr.model.dto.DiningDTO$AddCanteenDTO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| code | string | 是 |  |  |
| name | string | 是 |  |  |
| image | string | 是 |  |  |

### com.leadwaycloud.core.model.PCom.leadwaycloud.hr.model.vo.shift.ShiftScheduleVO$ListVO

返回数据

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| first | boolean | 是 | 是否是第一页 | true |
| last | boolean | 是 | 是否是最后一页 | true |
| totalPages | integer(int32) | 是 | 总页数 | 1 |
| totalElements | integer(int64) | 是 | 总数据条数 | 1 |
| size | integer(int32) | 是 | 每页条数 | 10 |
| number | integer(int32) | 是 | 当前页码 | 0 |
| numberOfElements | integer(int32) | 是 | 当前页数据条数 | 0 |
| dataList | ShiftScheduleVO$ListVO[] | 否 | 当前页数据 |  |

### com.leadwaycloud.core.model.RCom.leadwaycloud.core.model.PCom.leadwaycloud.hr.model.vo.shift.ShiftScheduleVO$ListVO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | ShiftScheduleVO$ListVO | 否 |  |  |

### com.leadwaycloud.hr.model.vo.shift.ShiftScheduleVO$ListVO

排班方案列表VO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 | 主键ID |  |
| code | string | 否 | 方案编码 |  |
| name | string | 否 | 方案名称 |  |
| note | string | 否 | 备注 |  |
| status | string | 否 | 状态 |  |
| createUserName | string | 否 | 创建人名称 |  |
| createTime | string(date-time) | 否 | 创建时间 |  |
| publishUserName | string | 否 | 发布人名称 |  |
| publishTime | string(date-time) | 否 | 发布时间 |  |

### com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.vo.shift.ShiftScheduleVO$DetailVO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | ShiftScheduleVO$DetailVO[] | 否 | 返回数据 |  |

### com.leadwaycloud.hr.model.entity.shift.ShiftScheduleItem

排班方案班次

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| code | string | 是 | 班次编码 |  |
| name | string | 是 | 班次名称 |  |
| no | integer(int32) | 是 | 排序号 |  |
| totalWorkHours | number | 是 | 总工时 |  |
| status | string | 是 | 状态 |  |
| timeSegmentList | ShiftScheduleItemTimeSegment | 否 |  |  |

### com.leadwaycloud.hr.model.entity.shift.ShiftScheduleItemTimeSegment

排班方案班次时间段

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| startTime | LocalTime | 是 |  |  |
| endTime | LocalTime | 是 |  |  |
| type | string | 是 | 类型 |  |
| workHours | number | 是 | 工时 |  |

### com.leadwaycloud.hr.model.vo.shift.ShiftScheduleVO$DetailVO

排班方案详情VO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 | 主键ID |  |
| code | string | 否 | 方案编码 |  |
| name | string | 否 | 方案名称 |  |
| note | string | 否 | 备注 |  |
| status | string | 否 | 状态 |  |
| createUserName | string | 否 | 创建人名称 |  |
| createTime | string(date-time) | 否 | 创建时间 |  |
| publishUserName | string | 否 | 发布人名称 |  |
| publishTime | string(date-time) | 否 | 发布时间 |  |
| versionList | ShiftScheduleVersionVO | 否 |  |  |

### com.leadwaycloud.hr.model.vo.shift.ShiftScheduleVersionVO

排班方案版本详情VO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 | 主键ID |  |
| version | integer(int32) | 否 | 版本号 |  |
| status | string | 否 | 状态 |  |
| createUserName | string | 否 | 创建人名称 |  |
| createTime | string(date-time) | 否 | 创建时间 |  |
| publishUserName | string | 否 | 发布人名称 |  |
| publishTime | string(date-time) | 否 | 发布时间 |  |
| shiftScheduleItemList | ShiftScheduleItem | 否 |  |  |

### com.leadwaycloud.core.model.RCom.leadwaycloud.hr.model.vo.shift.ShiftScheduleVO$DetailVO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | ShiftScheduleVO$DetailVO | 否 |  |  |

### com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.hr.HrPosition

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrPosition[] | 否 | 返回数据 |  |

### com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.hr.HrEmployeeDepartmentPosition

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrEmployeeDepartmentPosition[] | 否 | 返回数据 |  |

### com.leadwaycloud.core.model.PCom.leadwaycloud.hr.model.entity.hr.HrEmployee

返回数据

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| first | boolean | 是 | 是否是第一页 | true |
| last | boolean | 是 | 是否是最后一页 | true |
| totalPages | integer(int32) | 是 | 总页数 | 1 |
| totalElements | integer(int64) | 是 | 总数据条数 | 1 |
| size | integer(int32) | 是 | 每页条数 | 10 |
| number | integer(int32) | 是 | 当前页码 | 0 |
| numberOfElements | integer(int32) | 是 | 当前页数据条数 | 0 |
| dataList | HrEmployee[] | 否 | 当前页数据 |  |

### com.leadwaycloud.core.model.RCom.leadwaycloud.core.model.PCom.leadwaycloud.hr.model.entity.hr.HrEmployee

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrEmployee | 否 |  |  |

### com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.stock.StockWarehouse

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | StockWarehouse[] | 否 | 返回数据 |  |

### com.leadwaycloud.hr.model.entity.stock.StockWarehouse

仓库

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| code | string | 是 | 编号 |  |
| name | string | 是 | 名称 |  |
| idChain | string | 是 | 完整的组织结构 |  |
| system | boolean | 是 | 系统创建 |  |
| parentId | integer(int64) | 否 | 父级ID |  |
| images | string | 否 | 图片 |  |
| type | string | 是 | 仓库类型 |  |
| merchantId | integer(int64) | 是 | 商户号ID |  |
| companyId | integer(int64) | 是 | 公司ID |  |
| status | string | 是 | 状态 |  |
| financeCenterId | integer(int64) | 否 | 成本中心ID |  |
| goodsType | string | 否 | 仓库商品类型 |  |
| goodsSubType | string | 否 | 仓库商品子类型 |  |
| manufactureType | string | 否 | 质量类型（合格库/不合格库/待检库...） |  |
| inventoryMoveType | string | 否 | 入库/回库类型-万航 |  |
| calcCost | boolean | 否 | 是否计算成本。科研，料头仓库为false，默认值为true。 |  |
| externalCode | string | 否 | 外部编号 |  |
| asset | boolean | 否 | 是否资产-爱达 |  |

### com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.hr.HrDepartment

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | HrDepartment[] | 否 | 返回数据 |  |

### com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.stock.StockGoodsCategory

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | StockGoodsCategory[] | 否 | 返回数据 |  |

### com.leadwaycloud.hr.model.entity.stock.StockGoodsCategory

商品分类

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| id | integer(int64) | 否 |  |  |
| createBy | integer(int64) | 否 |  |  |
| createTime | string(date-time) | 否 |  |  |
| updateBy | integer(int64) | 否 |  |  |
| updateTime | string(date-time) | 否 |  |  |
| name | string | 是 | 名称 |  |
| code | string | 是 | 编号 |  |
| status | string | 是 | 状态 |  |
| parentId | integer(int64) | 否 | 父级ID |  |
| idChain | string | 是 | 完整的组织结构 |  |
| images | string | 否 | 图片 |  |
| merchantId | integer(int64) | 是 | 商户ID |  |
| externalCode | string | 否 | 外部编号 |  |
| saleTaxId | integer(int64) | 否 | 销售税ID |  |
| purchaseTaxId | integer(int64) | 否 | 采购税ID |  |
| accountingTitleId | integer(int64) | 否 | 会计科目ID |  |
| costAccountingTitleId | integer(int64) | 否 | 成本科目ID |  |
| description | string | 否 | 描述 |  |
| origin | string | 否 | 来源 |  |
| boutique | boolean | 否 | 是否为精品分类 |  |
| specificationGroupId | integer(int64) | 否 | 商品规格组ID |  |
| extensionInfo | string | 否 | 额外属性 |  |

### com.leadwaycloud.core.model.PCom.leadwaycloud.hr.model.entity.calendar.schedule.CalendarSchedule

返回数据

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| first | boolean | 是 | 是否是第一页 | true |
| last | boolean | 是 | 是否是最后一页 | true |
| totalPages | integer(int32) | 是 | 总页数 | 1 |
| totalElements | integer(int64) | 是 | 总数据条数 | 1 |
| size | integer(int32) | 是 | 每页条数 | 10 |
| number | integer(int32) | 是 | 当前页码 | 0 |
| numberOfElements | integer(int32) | 是 | 当前页数据条数 | 0 |
| dataList | CalendarSchedule[] | 否 | 当前页数据 |  |

### com.leadwaycloud.core.model.RCom.leadwaycloud.core.model.PCom.leadwaycloud.hr.model.entity.calendar.schedule.CalendarSchedule

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | CalendarSchedule | 否 |  |  |

### com.leadwaycloud.core.model.RJava.util.MapJava.lang.StringCom.leadwaycloud.hr.model.vo.CalendarScheduleVO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

### com.leadwaycloud.hr.model.vo.CalendarScheduleVO

时间区间日程VO

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| date | string(date) | 否 | 日期 | "2020-10-11" |
| type | string | 否 | 类型(WORK:工作日 WEEKEND:周末 TAKE:调休 HOLIDAY:节假日) |  |
| wage | integer(int32) | 否 | 薪资倍数 |  |
| content | string | 否 | 日程内容 |  |

### com.leadwaycloud.core.model.RJava.util.MapJava.lang.StringJava.util.MapJava.lang.StringJava.lang.Integer

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | object | 否 | 返回数据 |  |

### com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.dining.DiningTicketType

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningTicketType[] | 否 | 返回数据 |  |

### com.leadwaycloud.core.model.RJava.util.ListCom.leadwaycloud.hr.model.entity.dining.DiningCanteen

| 名称 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| status | integer(int32) | 是 | 状态码 | 200 |
| code | string | 是 | 业务代码 | "000" |
| message | string | 是 | 消息描述 | "成功" |
| data | DiningCanteen[] | 否 | 返回数据 |  |

