> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/system-bo-api/undefined-10.md).

# 휴일 관리

## 휴일 등록/수정/삭제

> \## 기능설명\
> \* 휴일을 등록, 수정, 삭제합니다.\
> \---\
> \## 상세설명\
> \* 휴일에 대한 공휴일구분, 휴일메뉴, 사용여부를 수정합니다.\
> \* 휴일 목록을 삭제합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridCUDRequestStHoliInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/StHoliInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/StHoliInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/StHoliInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/StHoliInfo"}}}},"StHoliInfo":{"type":"object","properties":{"holiDt":{"type":"string","description":"휴일일자"},"holiJobGbCd":{"type":"string","description":"휴일업무구분코드(CM001) 01: 일반휴무, 02: 매장휴무, 03: 물류센터(택배배송), 04: 고객센터"},"holiGbCd":{"type":"string","description":"공휴일구분코드(CM002) 01: 국경일, 02: 휴일, 03: 설날, 04: 추석, 05: 기타"},"holiMemo":{"type":"string","description":"휴일메모"},"useYn":{"type":"string","description":"사용여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/system/holidayMgmt/saveHolidayList":{"post":{"tags":["휴일 관리"],"summary":"휴일 등록/수정/삭제","description":"## 기능설명\n* 휴일을 등록, 수정, 삭제합니다.\n---\n## 상세설명\n* 휴일에 대한 공휴일구분, 휴일메뉴, 사용여부를 수정합니다.\n* 휴일 목록을 삭제합니다.\n","operationId":"saveHolidayList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestStHoliInfo"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 휴일 일괄등록

> \## 기능설명\
> \* 휴일을 일괄 등록합니다.\
> \---\
> \## 상세설명\
> \* 엑셀 혹은 csv로 업로드된 파일에 대한 휴일 정보를 일괄로 등록합니다.\
> \* 중복된 휴일이 존재해 등록되지 못한 날짜를 반환합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridCUDRequestStHoliInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/StHoliInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/StHoliInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/StHoliInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/StHoliInfo"}}}},"StHoliInfo":{"type":"object","properties":{"holiDt":{"type":"string","description":"휴일일자"},"holiJobGbCd":{"type":"string","description":"휴일업무구분코드(CM001) 01: 일반휴무, 02: 매장휴무, 03: 물류센터(택배배송), 04: 고객센터"},"holiGbCd":{"type":"string","description":"공휴일구분코드(CM002) 01: 국경일, 02: 휴일, 03: 설날, 04: 추석, 05: 기타"},"holiMemo":{"type":"string","description":"휴일메모"},"useYn":{"type":"string","description":"사용여부"}}},"RealGridListResponseStHoliBatchResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/StHoliBatchResponse"}}}},"StHoliBatchResponse":{"type":"object","description":"사용자 상세 정보 Response DTO","properties":{"holiDt":{"type":"string","description":"휴일일자"},"holiJobGbCd":{"type":"string","description":"휴일업무구분코드(CM001) 01: 일반휴무, 02: 매장휴무, 03: 물류센터(택배배송), 04: 고객센터"},"holiGbCd":{"type":"string","description":"공휴일구분코드(CM002) 01: 국경일, 02: 휴일, 03: 설날, 04: 추석, 05: 기타"},"holiMemo":{"type":"string","description":"휴일메모"},"useYn":{"type":"string","description":"사용여부"},"errMsg":{"type":"string","description":"사용자 상세 정보"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/system/holidayMgmt/registHolidayExcelList":{"post":{"tags":["휴일 관리"],"summary":"휴일 일괄등록","description":"## 기능설명\n* 휴일을 일괄 등록합니다.\n---\n## 상세설명\n* 엑셀 혹은 csv로 업로드된 파일에 대한 휴일 정보를 일괄로 등록합니다.\n* 중복된 휴일이 존재해 등록되지 못한 날짜를 반환합니다.\n","operationId":"registHolidayExcelList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestStHoliInfo"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseStHoliBatchResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 휴일 관리 목록 조회

> \## 기능설명\
> \* 화면에서 넘어온 공휴일자, 업무구분, 공휴일 구분에 맞는 휴일 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 넘어온 공휴일자, 업무구분, 공휴일 구분에 맞는 휴일 목록을 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"HolidayMgmtRequest":{"type":"object","properties":{"holiDtS":{"type":"string","minLength":1},"holiDtE":{"type":"string","minLength":1},"holiJobGbCd":{"type":"string","minLength":1},"holiGbCd":{"type":"string","minLength":1},"useYn":{"type":"string","minLength":1},"holiMemo":{"type":"string"},"dateSelect":{"type":"string","minLength":1}},"required":["dateSelect","holiDtE","holiDtS","holiGbCd","holiJobGbCd","useYn"]},"RealGridListResponseHolidayMgmtResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/HolidayMgmtResponse"}}}},"HolidayMgmtResponse":{"type":"object","description":"휴일 관리 조회 Response","properties":{"holiDt":{"type":"string","description":"공휴일자"},"holiJobGbCd":{"type":"string","description":"업무구분(CM001)"},"holiGbCd":{"type":"string","description":"업무구분(CM002)"},"useYn":{"type":"string","description":"사용여부","enum":["Y","N"]},"holiMemo":{"type":"string","description":"휴일설명"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/system/holidayMgmt/getHolidayList":{"get":{"tags":["휴일 관리"],"summary":"휴일 관리 목록 조회","description":"## 기능설명\n* 화면에서 넘어온 공휴일자, 업무구분, 공휴일 구분에 맞는 휴일 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 넘어온 공휴일자, 업무구분, 공휴일 구분에 맞는 휴일 목록을 조회합니다.\n","operationId":"getHolidayList","parameters":[{"name":"holidayMgmtRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/HolidayMgmtRequest"}},{"name":"holiDtS","in":"query","description":"시작일자","required":true,"schema":{"type":"string"}},{"name":"holiDtE","in":"query","description":"종료일자","required":true,"schema":{"type":"string"}},{"name":"holiJobGbCd","in":"query","description":"휴일업무구분코드(CM001)","schema":{"type":"string"}},{"name":"holiGbCd","in":"query","description":"공휴일구분코드(CM002)","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseHolidayMgmtResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```