# 휴일 관리
## 휴일 등록/수정/삭제
> \## 기능설명\
> \* 휴일을 등록, 수정, 삭제합니다.\
> \---\
> \## 상세설명\
> \* 휴일에 대한 공휴일구분, 휴일메뉴, 사용여부를 수정합니다.\
> \* 휴일 목록을 삭제합니다.
```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로 업로드된 파일에 대한 휴일 정보를 일괄로 등록합니다.\
> \* 중복된 휴일이 존재해 등록되지 못한 날짜를 반환합니다.
```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"}}}}}}}}}
```
## 휴일 관리 목록 조회
> \## 기능설명\
> \* 화면에서 넘어온 공휴일자, 업무구분, 공휴일 구분에 맞는 휴일 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 넘어온 공휴일자, 업무구분, 공휴일 구분에 맞는 휴일 목록을 조회합니다.
```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"}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/back-office-api/system-bo-api/undefined-10.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.