> 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/display-bo-api/undefined-15.md).

# 기획전 정보 관리

## 기획전 등록/수정 팝업 구분자탭 저장

> \## 기능설명\
> \* 기획전 등록/수정 팝업\_구분자 탭을 등록/수정/삭제 API 입니다.\
> \---\
> \## 상세설명\
> \* 구분자 유형으로 텍스트, 배너, HTML 등록 할 수 있으며 필수로 입력해야 합니다.\
> \* 구분자명은 구분자 상품 리스트에서 상품을 구분짓는 구분자 명으로 사용됩니다.\
> \
> \* 입력 파라미터( \* : 필수)\
> &#x20;   \* create : divobjNm \*, divobjGbCd \*, tmplNo \*, dispYn \*, dispSeq \*, dispMediaCd \*, langCd \*, bnrImgPathNm, bnrImgFileNm, cpnBnrImgPathNm, cpnBnrImgFileNm, htmlFileCont, textDivobjNm ,stateForm \*\
> &#x20;   \* update : divobjNo \*, divobjNm \*, divobjGbCd \*, tmplNo \*, dispYn \*, dispSeq \*, dispMediaCd \*, langCd \*, bnrImgPathNm, bnrImgFileNm, cpnBnrImgPathNm, cpnBnrImgFileNm, htmlFileCont, textDivobjNm ,stateForm \*\
> &#x20;   \* delete : mkdpNo \*, divobjNo \*<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":{"PrMkdpDivobjInfo":{"type":"object","description":"기획전 구분자 정보","properties":{"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"divobjGbCd":{"type":"string","description":"구분자구분코드(DP024)"},"divobjNm":{"type":"string","description":"구분자명"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"tmplNo":{"type":"string","description":"템플릿번호"},"cpnNo":{"type":"string","description":"쿠폰번호"},"textDivobjNm":{"type":"string","description":"텍스트구분자명"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"cpnBnrImgPathNm":{"type":"string","description":"쿠폰배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"쿠폰배너이미지대체텍스트"},"cpnBnrImgFileNm":{"type":"string","description":"쿠폰배너이미지파일명"},"htmlFileCont":{"type":"string","description":"HTML파일내용"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"stateForm":{"type":"string","description":"구분자상태"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ResponseString":{"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":{"type":"string","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"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/savePrMkdpDivobj":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 등록/수정 팝업 구분자탭 저장","description":"## 기능설명\n* 기획전 등록/수정 팝업_구분자 탭을 등록/수정/삭제 API 입니다.\n---\n## 상세설명\n* 구분자 유형으로 텍스트, 배너, HTML 등록 할 수 있으며 필수로 입력해야 합니다.\n* 구분자명은 구분자 상품 리스트에서 상품을 구분짓는 구분자 명으로 사용됩니다.\n\n* 입력 파라미터( * : 필수)\n    * create : divobjNm *, divobjGbCd *, tmplNo *, dispYn *, dispSeq *, dispMediaCd *, langCd *, bnrImgPathNm, bnrImgFileNm, cpnBnrImgPathNm, cpnBnrImgFileNm, htmlFileCont, textDivobjNm ,stateForm *\n    * update : divobjNo *, divobjNm *, divobjGbCd *, tmplNo *, dispYn *, dispSeq *, dispMediaCd *, langCd *, bnrImgPathNm, bnrImgFileNm, cpnBnrImgPathNm, cpnBnrImgFileNm, htmlFileCont, textDivobjNm ,stateForm *\n    * delete : mkdpNo *, divobjNo *\n","operationId":"savePrMkdpDivobj","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"string","format":"binary"}},"prMkdpDivobjInfoList":{"type":"array","items":{"$ref":"#/components/schemas/PrMkdpDivobjInfo"}}},"required":["prMkdpDivobjInfoList"]}}}},"responses":{"200":{"description":"기획전 구분자탭 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"기획전 구분자탭 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 등록/수정 팝업 기본정보 탭 - 기획전 구분자 다국어 저장

> \## 기능설명\
> \* 기획전 구분자 다국어 정보를 저장하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 구분자 기본정보 유형에 따라 다국어 정보를 입력할 수 있습니다. (HTML -> HTML, 배너 -> 배너, 텍스트 -> 텍스트)\
> \* 구분자 다국어명은 구분자 상품 리스트에서 상품을 구분짓는 구분자 다국어 명으로 사용됩니다.\
> \
> \* 입력 파라미터( \* : 필수)\
> &#x20;   \* update : mkdpNo \*, divobjNo \*, divobjNm \*, txtDivobjNm, bnrImagPathNm, bnrImgFileNm, cpnBnrImgPathNm, cpnBnrImgFileNm, htmlFileCont, langCd \*<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":{"PrMkdpDivobjInfo":{"type":"object","description":"기획전 구분자 정보","properties":{"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"divobjGbCd":{"type":"string","description":"구분자구분코드(DP024)"},"divobjNm":{"type":"string","description":"구분자명"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"tmplNo":{"type":"string","description":"템플릿번호"},"cpnNo":{"type":"string","description":"쿠폰번호"},"textDivobjNm":{"type":"string","description":"텍스트구분자명"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"cpnBnrImgPathNm":{"type":"string","description":"쿠폰배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"쿠폰배너이미지대체텍스트"},"cpnBnrImgFileNm":{"type":"string","description":"쿠폰배너이미지파일명"},"htmlFileCont":{"type":"string","description":"HTML파일내용"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"stateForm":{"type":"string","description":"구분자상태"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ResponseString":{"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":{"type":"string","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"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/savePrMkdpDivobjMl":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 등록/수정 팝업 기본정보 탭 - 기획전 구분자 다국어 저장","description":"## 기능설명\n* 기획전 구분자 다국어 정보를 저장하는 API 입니다.\n---\n## 상세설명\n* 구분자 기본정보 유형에 따라 다국어 정보를 입력할 수 있습니다. (HTML -> HTML, 배너 -> 배너, 텍스트 -> 텍스트)\n* 구분자 다국어명은 구분자 상품 리스트에서 상품을 구분짓는 구분자 다국어 명으로 사용됩니다.\n\n* 입력 파라미터( * : 필수)\n    * update : mkdpNo *, divobjNo *, divobjNm *, txtDivobjNm, bnrImagPathNm, bnrImgFileNm, cpnBnrImgPathNm, cpnBnrImgFileNm, htmlFileCont, langCd *\n","operationId":"savePrMkdpDivobjMl","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"string","format":"binary"}},"prMkdpDivobjInfo":{"$ref":"#/components/schemas/PrMkdpDivobjInfo"}},"required":["prMkdpDivobjInfo"]}}}},"responses":{"200":{"description":"기획전 구분자정보 다국어 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"기획전 구분자정보 다국어 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 등록/수정 팝업\_기본정보 탭 저장

> \## 기능설명\
> \* 기획전 등록/수정 팝업\_기본정보 탭을 등록 및 수정하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 사이트, 사이트기준 몰, 몰기준 그룹을 선택 할 수 있습니다.\
> \* 리스트 콘텐츠1, 리스트 콘텐츠2는 필수값입니다. 또한 전시매체 PC, MO 하나씩 등록하거나 공통을 등록 할 수 있습니다.\
> \* 회원 등급 및 임직원 여부에 따라 FO 노출이 제한됩니다.\
> \
> \* 입력 파라미터( \* : 필수)\
> &#x20;   \* create : mkdpNm \*, siteNo \*, dpmlNo \*, tmplNo \*, dispYn \*, dispSeq \*, dispStrDtm \*, dispEndDtm \*, mdId \*, mkdpTtlHtml, mkdpTtlHtmlPc\
> &#x20;   , htmlContYn, kwdNm, brefDsec, introConts, fotrFileConts, aplyBrand, pcTtopExpYn, langCd \*, dispMediaCd \*, dispStafYn, mbrDispGradCd\
> &#x20;   \* update : mkdpNo \*, mkdpNm \*, siteNo \*, dpmlNo \*, tmplNo \*, dispYn \*, dispSeq \*, dispStrDtm \*, dispEndDtm \*, mdId \*, mkdpTtlHtml, mkdpTtlHtmlPc\
> &#x20;   , htmlContYn, kwdNm, brefDsec,introConts,fotrFileConts, aplyBrand, pcTtopExpYn, langCd \*, dispMediaCd \*, dispStafYn, mbrDispGradCd<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":{"PrMkdpBase":{"type":"object","description":"기획전기본","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"tmplNo":{"type":"string","description":"템플릿번호"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispEndDtm":{"type":"string","format":"date-time","description":"전시종료일시"},"mdId":{"type":"string","description":"담당MD"},"mkdpTtlHtml":{"type":"string","description":"기획전타이틀HTML_MO"},"mkdpTtlHtmlPc":{"type":"string","description":"기획전타이틀HTML_PC"},"htmlContYn":{"type":"string","description":"HTML컨텐츠여부"},"kwdNm":{"type":"string","description":"키워드명"},"brefDesc":{"type":"string","description":"간략설명"},"introConts":{"type":"string","description":"소개글"},"fotrFileConts":{"type":"string","description":"푸터파일내용"},"brandInfoMap":{"type":"object","additionalProperties":{"type":"string"},"description":"브랜드 정보"},"aplyBrand":{"type":"array","description":"기획전브랜드리스트","items":{"type":"string"}},"pcTtopExpYn":{"type":"string","description":"PC상단노출여부"},"dispGrpNo":{"type":"string","description":"전시그룹번호"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"deleteList":{"type":"array","description":"삭제이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"dispMediaCd":{"type":"string","description":"전시매체코드"},"dispStafYn":{"type":"string","description":"임직원여부"},"tmplFileNm":{"type":"string","description":"템플릿파일명"},"dispGrpNoList":{"type":"array","items":{"type":"string"}},"mbrDispGradeCd":{"type":"array","description":"전시회원코드 배열","items":{"type":"string"}},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"배너이미지대체텍스트"},"totalCount":{"type":"integer","format":"int32","description":"전체개수"},"fileIdx":{"type":"integer","format":"int32","description":"업로드파일 순번"},"dispStat":{"type":"string"},"dispStatName":{"type":"string"},"dispMediaNm":{"type":"string"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ResponsePrMkdpBase":{"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":{"$ref":"#/components/schemas/PrMkdpBase","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"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/savePrMkdpBase":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 등록/수정 팝업_기본정보 탭 저장","description":"## 기능설명\n* 기획전 등록/수정 팝업_기본정보 탭을 등록 및 수정하는 API 입니다.\n---\n## 상세설명\n* 사이트, 사이트기준 몰, 몰기준 그룹을 선택 할 수 있습니다.\n* 리스트 콘텐츠1, 리스트 콘텐츠2는 필수값입니다. 또한 전시매체 PC, MO 하나씩 등록하거나 공통을 등록 할 수 있습니다.\n* 회원 등급 및 임직원 여부에 따라 FO 노출이 제한됩니다.\n\n* 입력 파라미터( * : 필수)\n    * create : mkdpNm *, siteNo *, dpmlNo *, tmplNo *, dispYn *, dispSeq *, dispStrDtm *, dispEndDtm *, mdId *, mkdpTtlHtml, mkdpTtlHtmlPc\n    , htmlContYn, kwdNm, brefDsec, introConts, fotrFileConts, aplyBrand, pcTtopExpYn, langCd *, dispMediaCd *, dispStafYn, mbrDispGradCd\n    * update : mkdpNo *, mkdpNm *, siteNo *, dpmlNo *, tmplNo *, dispYn *, dispSeq *, dispStrDtm *, dispEndDtm *, mdId *, mkdpTtlHtml, mkdpTtlHtmlPc\n    , htmlContYn, kwdNm, brefDsec,introConts,fotrFileConts, aplyBrand, pcTtopExpYn, langCd *, dispMediaCd *, dispStafYn, mbrDispGradCd\n","operationId":"savePrMkdpBase","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"string","format":"binary"}},"prMkdpBase":{"$ref":"#/components/schemas/PrMkdpBase"}},"required":["prMkdpBase"]}}}},"responses":{"200":{"description":"기획전 기본정보 탭 등록/수정 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePrMkdpBase"}}}},"900":{"description":"기획전 기본정보 탭 등록/수정 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 구성안 목록 전시여부·전시순서 저장

> \## 기능설명\
> \* 기획전 구성안 목록 그리드에서 고친 \*\*전시여부·전시순서만\*\* 저장하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전 관리 목록의 저장(\`saveMarketingDisplayMgmtList\`)과 경로를 나눕니다 —\
> &#x20; 그 쪽은 전시기간까지 함께 덮으므로, 목록을 조회한 뒤 다른 운영자가 편집기에서\
> &#x20; 기간을 바꾸면 먼저 조회한 목록에서 순서만 저장해도 그 기간이 옛 값으로 되돌아갑니다.\
> \* 전시순서는 필수이며 1 이상입니다. 같은 순서가 여럿인 것은 막지 않습니다.\
> \* 수정자는 받지 않고 로그인 사용자로 채웁니다.\
> \* 삭제 목록이 없습니다 — 기획전 삭제는 기획전 정보 관리가 맡습니다.\
> \* 저장 후 해당 기획전들의 FO 캐시를 무효화합니다.<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":{"SavePlanLayoutDispRequest":{"type":"object","description":"기획전 구성안 목록 전시여부·전시순서 저장 요청","properties":{"update":{"type":"array","description":"고친 행 목록","items":{"$ref":"#/components/schemas/Entry"}}}},"Entry":{"type":"object","description":"기획전 구성안 목록에서 고친 행","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"dispYn":{"type":"string","description":"전시여부","enum":["Y","N"]},"dispSeq":{"type":"integer","format":"int32","description":"전시순서(1 ~ 999)"}}},"ResponseVoid":{"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"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/savePlanLayoutDispList":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 구성안 목록 전시여부·전시순서 저장","description":"## 기능설명\n* 기획전 구성안 목록 그리드에서 고친 **전시여부·전시순서만** 저장하는 API 입니다.\n---\n## 상세설명\n* 기획전 관리 목록의 저장(`saveMarketingDisplayMgmtList`)과 경로를 나눕니다 —\n  그 쪽은 전시기간까지 함께 덮으므로, 목록을 조회한 뒤 다른 운영자가 편집기에서\n  기간을 바꾸면 먼저 조회한 목록에서 순서만 저장해도 그 기간이 옛 값으로 되돌아갑니다.\n* 전시순서는 필수이며 1 이상입니다. 같은 순서가 여럿인 것은 막지 않습니다.\n* 수정자는 받지 않고 로그인 사용자로 채웁니다.\n* 삭제 목록이 없습니다 — 기획전 삭제는 기획전 정보 관리가 맡습니다.\n* 저장 후 해당 기획전들의 FO 캐시를 무효화합니다.\n","operationId":"savePlanLayoutDispList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavePlanLayoutDispRequest"}}},"required":true},"responses":{"200":{"description":"저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}},"900":{"description":"저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 구성안 저장

> \## 기능설명\
> \* 기획전의 구성안 문서(LayoutDocument)를 저장하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 없으면 만들고 있으면 덮습니다. 기획전 하나에 문서 한 벌입니다.\
> \* \*\*게시 단계가 없습니다.\*\* 저장하면 곧 화면입니다 — 구좌로 저작하던 때와 같고,\
> &#x20; 노출 여부·기간은 기획전 기본정보가 갖습니다. 저장 전 확인은 미리보기가 맡습니다.\
> \* 저장 후 해당 기획전의 FO 캐시를 무효화합니다.\
> \* 사이트·전시몰은 기획전 기본정보에서 가져옵니다. 요청에서 받지 않습니다 —\
> &#x20; 받으면 같은 기획전의 문서가 딴 사이트 자리에 저장될 수 있습니다.<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":{"SavePlanLayoutConfigRequest":{"type":"object","description":"기획전 구성안 저장 요청","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"layoutDoc":{"$ref":"#/components/schemas/JsonNode","description":"레이아웃 문서(LayoutDocument)"},"layoutSysModDtm":{"type":"string","description":"문서를 읽어 간 시각(동시 저장 검사용)"}}},"JsonNode":{},"PlanLayoutConfig":{"type":"object","description":"기획전 구성안","properties":{"siteNo":{"type":"string","description":"사이트번호"},"layoutSysModDtm":{"type":"string","description":"동시 저장 검사용 문서 버전(해석하지 말고 그대로 돌려보낸다)"},"layoutNo":{"type":"string","description":"레이아웃번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(기획전번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"dispYn":{"type":"string","description":"전시여부"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"layoutJson":{"type":"string","description":"레이아웃 JSON"},"useYn":{"type":"string","description":"사용여부"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/savePlanLayoutConfig":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 구성안 저장","description":"## 기능설명\n* 기획전의 구성안 문서(LayoutDocument)를 저장하는 API 입니다.\n---\n## 상세설명\n* 없으면 만들고 있으면 덮습니다. 기획전 하나에 문서 한 벌입니다.\n* **게시 단계가 없습니다.** 저장하면 곧 화면입니다 — 구좌로 저작하던 때와 같고,\n  노출 여부·기간은 기획전 기본정보가 갖습니다. 저장 전 확인은 미리보기가 맡습니다.\n* 저장 후 해당 기획전의 FO 캐시를 무효화합니다.\n* 사이트·전시몰은 기획전 기본정보에서 가져옵니다. 요청에서 받지 않습니다 —\n  받으면 같은 기획전의 문서가 딴 사이트 자리에 저장될 수 있습니다.\n","operationId":"savePlanLayoutConfig","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavePlanLayoutConfigRequest"}}},"required":true},"responses":{"200":{"description":"기획전 구성안 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PlanLayoutConfig"}}}},"900":{"description":"기획전 구성안 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 편집기 저장(기본정보+구성안)

> \## 기능설명\
> \* 기획전 구성안 편집기의 저장입니다. 기본정보와 구성안 문서를 \*\*한 트랜잭션\*\*에서 씁니다.\
> \---\
> \## 상세설명\
> \* 기획전번호가 비어 있으면 새 기획전을 만듭니다 — 등록과 첫 저장이 한 번에 끝납니다.\
> \* \*\*템플릿번호는 받지 않습니다.\*\* 이 편집기로 저장한 기획전은 언제나 구성안(위지윅)이고,\
> &#x20; 번호는 환경마다 다르게 채번되므로 서버가 템플릿 파일명으로 찾습니다.\
> \* \*\*그룹은 이름으로 다룹니다.\*\* 그룹번호 없이 이름만 오면 같은 사이트·전시몰에서 찾아보고,\
> &#x20; 없으면 새로 만듭니다. 이름까지 비면 그룹 미지정입니다.\
> \* 저장 후 해당 기획전의 FO 캐시를 무효화합니다.<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":{"SavePlanEditorRequest":{"type":"object","description":"기획전 편집기 저장 요청","properties":{"basics":{"$ref":"#/components/schemas/PrMkdpBase","description":"기획전 기본정보"},"layoutDoc":{"$ref":"#/components/schemas/JsonNode","description":"레이아웃 문서(LayoutDocument)"},"layoutSysModDtm":{"type":"string","description":"문서를 읽어 간 시각(동시 저장 검사용). 없으면 검사하지 않는다"},"basicsMl":{"type":"array","description":"기본정보 번역(기준 언어 제외). 없으면 기준 언어만 저장한다","items":{"$ref":"#/components/schemas/Entry"}}}},"PrMkdpBase":{"type":"object","description":"기획전기본","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"tmplNo":{"type":"string","description":"템플릿번호"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispEndDtm":{"type":"string","format":"date-time","description":"전시종료일시"},"mdId":{"type":"string","description":"담당MD"},"mkdpTtlHtml":{"type":"string","description":"기획전타이틀HTML_MO"},"mkdpTtlHtmlPc":{"type":"string","description":"기획전타이틀HTML_PC"},"htmlContYn":{"type":"string","description":"HTML컨텐츠여부"},"kwdNm":{"type":"string","description":"키워드명"},"brefDesc":{"type":"string","description":"간략설명"},"introConts":{"type":"string","description":"소개글"},"fotrFileConts":{"type":"string","description":"푸터파일내용"},"brandInfoMap":{"type":"object","additionalProperties":{"type":"string"},"description":"브랜드 정보"},"aplyBrand":{"type":"array","description":"기획전브랜드리스트","items":{"type":"string"}},"pcTtopExpYn":{"type":"string","description":"PC상단노출여부"},"dispGrpNo":{"type":"string","description":"전시그룹번호"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"deleteList":{"type":"array","description":"삭제이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"dispMediaCd":{"type":"string","description":"전시매체코드"},"dispStafYn":{"type":"string","description":"임직원여부"},"tmplFileNm":{"type":"string","description":"템플릿파일명"},"dispGrpNoList":{"type":"array","items":{"type":"string"}},"mbrDispGradeCd":{"type":"array","description":"전시회원코드 배열","items":{"type":"string"}},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"배너이미지대체텍스트"},"totalCount":{"type":"integer","format":"int32","description":"전체개수"},"fileIdx":{"type":"integer","format":"int32","description":"업로드파일 순번"},"dispStat":{"type":"string"},"dispStatName":{"type":"string"},"dispMediaNm":{"type":"string"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"JsonNode":{},"Entry":{"type":"object","description":"기획전 구성안 목록에서 고친 행","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"dispYn":{"type":"string","description":"전시여부","enum":["Y","N"]},"dispSeq":{"type":"integer","format":"int32","description":"전시순서(1 ~ 999)"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/savePlanEditor":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 편집기 저장(기본정보+구성안)","description":"## 기능설명\n* 기획전 구성안 편집기의 저장입니다. 기본정보와 구성안 문서를 **한 트랜잭션**에서 씁니다.\n---\n## 상세설명\n* 기획전번호가 비어 있으면 새 기획전을 만듭니다 — 등록과 첫 저장이 한 번에 끝납니다.\n* **템플릿번호는 받지 않습니다.** 이 편집기로 저장한 기획전은 언제나 구성안(위지윅)이고,\n  번호는 환경마다 다르게 채번되므로 서버가 템플릿 파일명으로 찾습니다.\n* **그룹은 이름으로 다룹니다.** 그룹번호 없이 이름만 오면 같은 사이트·전시몰에서 찾아보고,\n  없으면 새로 만듭니다. 이름까지 비면 그룹 미지정입니다.\n* 저장 후 해당 기획전의 FO 캐시를 무효화합니다.\n","operationId":"savePlanEditor","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"string","format":"binary"}},"request":{"$ref":"#/components/schemas/SavePlanEditorRequest"}},"required":["request"]}}}},"responses":{"200":{"description":"기획전 편집기 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrMkdpBase"}}}},"900":{"description":"기획전 편집기 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 등록/수정 팝업 상품정보 탭 - 상품 엑셀 일괄 저장

> \## 기능설명\
> \* 상품정보 탭 > 상품 일괄등록탭 - 상품 엑셀 일괄 저장하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 엘셀 상품 등록시 중복된 상품을 제외하고 등록합니다.\
> \* 중복된 상품이 있을경우 해당 중복된 상품은 리스트형식으로 리턴됩니다.\
> \
> \* 입력 파라미터( \* : 필수)\
> &#x20;   \* 필요 값 : mkdpNo \*, divobjNo \*, goodsNo \*, itmNo \*, dispSeq \*<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":{"PrMkdpGoodsInfo":{"type":"object","description":"기획전상품정보","properties":{"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"할인가"},"errorMessage":{"type":"string","description":"오류메시지"},"validStat":{"type":"string","description":"오류상태"},"timeDealYn":{"type":"string","description":"타임딜적용여부"},"tmdlHistStrDtm":{"type":"string","format":"date-time","description":"타임딜시작일시"},"tmdlHistEndDtm":{"type":"string","format":"date-time","description":"타임딜종료일시"},"tmdlSalePrc":{"type":"number","description":"타임딜판매가"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/saveMarketingMgmtExcelGoodsList":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 등록/수정 팝업 상품정보 탭 - 상품 엑셀 일괄 저장","description":"## 기능설명\n* 상품정보 탭 > 상품 일괄등록탭 - 상품 엑셀 일괄 저장하는 API 입니다.\n---\n## 상세설명\n* 엘셀 상품 등록시 중복된 상품을 제외하고 등록합니다.\n* 중복된 상품이 있을경우 해당 중복된 상품은 리스트형식으로 리턴됩니다.\n\n* 입력 파라미터( * : 필수)\n    * 필요 값 : mkdpNo *, divobjNo *, goodsNo *, itmNo *, dispSeq *\n","operationId":"saveMarketingMgmtExcelGoodsList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}}}},"required":true},"responses":{"200":{"description":"기획전 상품 엑셀 일괄 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}}}},"900":{"description":"기획전 상품 엑셀 일괄 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}},"deprecated":true}}}}
```

## 기획전 정보 관리 목록 저장

> \## 기능설명\
> \* 기획전 정보관리 목록을 수정/삭제하는 API 입니다.\
> \---\
> \## 상세설명\
> \* realGrid를 통해 해당 기획전 관리 - 기횐전 정보를 수정/삭제 합니다.\
> \
> \* 입력 파라미터( \* : 필수)\
> &#x20;   \* update : mkdpNo \*, dispYn \*, dispSeq \*, dispStrDtm \*, dispEndDtm \*\
> &#x20;   \* delete : mkdpNo \*<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":{"RealGridCUDRequestPrMkdpBase":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrMkdpBase"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrMkdpBase"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrMkdpBase"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrMkdpBase"}}}},"PrMkdpBase":{"type":"object","description":"기획전기본","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"tmplNo":{"type":"string","description":"템플릿번호"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispEndDtm":{"type":"string","format":"date-time","description":"전시종료일시"},"mdId":{"type":"string","description":"담당MD"},"mkdpTtlHtml":{"type":"string","description":"기획전타이틀HTML_MO"},"mkdpTtlHtmlPc":{"type":"string","description":"기획전타이틀HTML_PC"},"htmlContYn":{"type":"string","description":"HTML컨텐츠여부"},"kwdNm":{"type":"string","description":"키워드명"},"brefDesc":{"type":"string","description":"간략설명"},"introConts":{"type":"string","description":"소개글"},"fotrFileConts":{"type":"string","description":"푸터파일내용"},"brandInfoMap":{"type":"object","additionalProperties":{"type":"string"},"description":"브랜드 정보"},"aplyBrand":{"type":"array","description":"기획전브랜드리스트","items":{"type":"string"}},"pcTtopExpYn":{"type":"string","description":"PC상단노출여부"},"dispGrpNo":{"type":"string","description":"전시그룹번호"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"deleteList":{"type":"array","description":"삭제이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"dispMediaCd":{"type":"string","description":"전시매체코드"},"dispStafYn":{"type":"string","description":"임직원여부"},"tmplFileNm":{"type":"string","description":"템플릿파일명"},"dispGrpNoList":{"type":"array","items":{"type":"string"}},"mbrDispGradeCd":{"type":"array","description":"전시회원코드 배열","items":{"type":"string"}},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"배너이미지대체텍스트"},"totalCount":{"type":"integer","format":"int32","description":"전체개수"},"fileIdx":{"type":"integer","format":"int32","description":"업로드파일 순번"},"dispStat":{"type":"string"},"dispStatName":{"type":"string"},"dispMediaNm":{"type":"string"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ResponseString":{"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":{"type":"string","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"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/saveMarketingDisplayMgmtList":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 정보 관리 목록 저장","description":"## 기능설명\n* 기획전 정보관리 목록을 수정/삭제하는 API 입니다.\n---\n## 상세설명\n* realGrid를 통해 해당 기획전 관리 - 기횐전 정보를 수정/삭제 합니다.\n\n* 입력 파라미터( * : 필수)\n    * update : mkdpNo *, dispYn *, dispSeq *, dispStrDtm *, dispEndDtm *\n    * delete : mkdpNo *\n","operationId":"saveMarketingDisplayMgmtList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestPrMkdpBase"}}},"required":true},"responses":{"200":{"description":"기획전 목록 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"기획전 목록 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 등록/수정 팝업 기본정보 탭 - 기획전 기본정보 다국어 저장

> \## 기능설명\
> \* 기획전 기본정보 다국어 정보를 저장하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 리스트 콘텐츠1, 리스트 콘텐츠2는 필수값입니다. 또한 전시매체 PC, MO 하나씩 등록하거나 공통을 등록 할 수 있습니다.\
> \
> \* 입력 파라미터( \* : 필수)\
> &#x20;   \* update : mkdpNo \*, mkdpNm \*, mkdpTtlHtml , mkdpTtlHtmlPc , brefDesc, introConts, fotrFileConts, langcd \*<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":{"PrMkdpBase":{"type":"object","description":"기획전기본","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"tmplNo":{"type":"string","description":"템플릿번호"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispEndDtm":{"type":"string","format":"date-time","description":"전시종료일시"},"mdId":{"type":"string","description":"담당MD"},"mkdpTtlHtml":{"type":"string","description":"기획전타이틀HTML_MO"},"mkdpTtlHtmlPc":{"type":"string","description":"기획전타이틀HTML_PC"},"htmlContYn":{"type":"string","description":"HTML컨텐츠여부"},"kwdNm":{"type":"string","description":"키워드명"},"brefDesc":{"type":"string","description":"간략설명"},"introConts":{"type":"string","description":"소개글"},"fotrFileConts":{"type":"string","description":"푸터파일내용"},"brandInfoMap":{"type":"object","additionalProperties":{"type":"string"},"description":"브랜드 정보"},"aplyBrand":{"type":"array","description":"기획전브랜드리스트","items":{"type":"string"}},"pcTtopExpYn":{"type":"string","description":"PC상단노출여부"},"dispGrpNo":{"type":"string","description":"전시그룹번호"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"deleteList":{"type":"array","description":"삭제이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"dispMediaCd":{"type":"string","description":"전시매체코드"},"dispStafYn":{"type":"string","description":"임직원여부"},"tmplFileNm":{"type":"string","description":"템플릿파일명"},"dispGrpNoList":{"type":"array","items":{"type":"string"}},"mbrDispGradeCd":{"type":"array","description":"전시회원코드 배열","items":{"type":"string"}},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"배너이미지대체텍스트"},"totalCount":{"type":"integer","format":"int32","description":"전체개수"},"fileIdx":{"type":"integer","format":"int32","description":"업로드파일 순번"},"dispStat":{"type":"string"},"dispStatName":{"type":"string"},"dispMediaNm":{"type":"string"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ResponsePrMkdpBase":{"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":{"$ref":"#/components/schemas/PrMkdpBase","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"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/saveMarketingDisplayMgmtBaseMl":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 등록/수정 팝업 기본정보 탭 - 기획전 기본정보 다국어 저장","description":"## 기능설명\n* 기획전 기본정보 다국어 정보를 저장하는 API 입니다.\n---\n## 상세설명\n* 리스트 콘텐츠1, 리스트 콘텐츠2는 필수값입니다. 또한 전시매체 PC, MO 하나씩 등록하거나 공통을 등록 할 수 있습니다.\n\n* 입력 파라미터( * : 필수)\n    * update : mkdpNo *, mkdpNm *, mkdpTtlHtml , mkdpTtlHtmlPc , brefDesc, introConts, fotrFileConts, langcd *\n","operationId":"saveMarketingDisplayMgmtBaseMl","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"string","format":"binary"}},"prMkdpBase":{"$ref":"#/components/schemas/PrMkdpBase"}},"required":["prMkdpBase"]}}}},"responses":{"200":{"description":"기획전 기본정보 다국어 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePrMkdpBase"}}}},"900":{"description":"기획전 기본정보 다국어 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 등록/수정 팝업 상품정보 탭 - 상품 그리드 저장

> \## 기능설명\
> \* 상품정보 탭 - 상품 그리드 등록/수정/삭제하는 API 입니다.\
> \---\
> \## 상세설명\
> \* realGrid를 통해 해당 상품 목록 정보를 저장합니다.\
> \
> \* 입력 파라미터( \* : 필수)\
> &#x20;   \* create : mkdpNo \*, divobjNo \*, goodsNo \*, itmNo \*, dispSeq \*\
> &#x20;   \* update : mkdpNo \*, divobjNo \*, goodsNo \*, itmNo \*, dispSeq \*\
> &#x20;   \* delete : mkdpNo \*, divobjNo \*, goodsNo \*, itmNo \*<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":{"RealGridCUDRequestPrMkdpGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}}}},"PrMkdpGoodsInfo":{"type":"object","description":"기획전상품정보","properties":{"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"할인가"},"errorMessage":{"type":"string","description":"오류메시지"},"validStat":{"type":"string","description":"오류상태"},"timeDealYn":{"type":"string","description":"타임딜적용여부"},"tmdlHistStrDtm":{"type":"string","format":"date-time","description":"타임딜시작일시"},"tmdlHistEndDtm":{"type":"string","format":"date-time","description":"타임딜종료일시"},"tmdlSalePrc":{"type":"number","description":"타임딜판매가"}}},"ResponseString":{"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":{"type":"string","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"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/saveDivobjGoodsGridList":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 등록/수정 팝업 상품정보 탭 - 상품 그리드 저장","description":"## 기능설명\n* 상품정보 탭 - 상품 그리드 등록/수정/삭제하는 API 입니다.\n---\n## 상세설명\n* realGrid를 통해 해당 상품 목록 정보를 저장합니다.\n\n* 입력 파라미터( * : 필수)\n    * create : mkdpNo *, divobjNo *, goodsNo *, itmNo *, dispSeq *\n    * update : mkdpNo *, divobjNo *, goodsNo *, itmNo *, dispSeq *\n    * delete : mkdpNo *, divobjNo *, goodsNo *, itmNo *\n","operationId":"saveDivobjGoodsGridList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestPrMkdpGoodsInfo"}}},"required":true},"responses":{"200":{"description":"기획전 상품 정보 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"기획전 상품 정보 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 등록/수정 팝업 상품정보 탭 - 상품 엑셀 일괄 저장

> \## 기능설명\
> \* 상품정보 탭 > 상품 일괄등록탭 - 상품 엑셀 일괄 저장하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 엑셀 상품 등록시 중복된 상품을 제외하고 등록합니다.\
> \* 상품 예외상황 발생 시 상품에 에러메시지를 담아서 결과값을 반환합니다.\
> \* 일반상품만 등록이 가능합니다.\
> \
> \* 입력 파라미터( \* : 필수)\
> &#x20;   \* 필요 값 : mkdpNo \*, divobjNo \*, goodsNo \*, itmNo \*, dispSeq \*\
> \---\
> \## 특이사항 (에러메시지)\
> \* 존재X or 묶음상품 : 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.\
> \* 중복상품, 중복입력상품 : 이미 추가된 상품입니다.<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":{"PrMkdpGoodsInfo":{"type":"object","description":"기획전상품정보","properties":{"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"할인가"},"errorMessage":{"type":"string","description":"오류메시지"},"validStat":{"type":"string","description":"오류상태"},"timeDealYn":{"type":"string","description":"타임딜적용여부"},"tmdlHistStrDtm":{"type":"string","format":"date-time","description":"타임딜시작일시"},"tmdlHistEndDtm":{"type":"string","format":"date-time","description":"타임딜종료일시"},"tmdlSalePrc":{"type":"number","description":"타임딜판매가"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/saveBulkDivobjGoodsUpload":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 등록/수정 팝업 상품정보 탭 - 상품 엑셀 일괄 저장","description":"## 기능설명\n* 상품정보 탭 > 상품 일괄등록탭 - 상품 엑셀 일괄 저장하는 API 입니다.\n---\n## 상세설명\n* 엑셀 상품 등록시 중복된 상품을 제외하고 등록합니다.\n* 상품 예외상황 발생 시 상품에 에러메시지를 담아서 결과값을 반환합니다.\n* 일반상품만 등록이 가능합니다.\n\n* 입력 파라미터( * : 필수)\n    * 필요 값 : mkdpNo *, divobjNo *, goodsNo *, itmNo *, dispSeq *\n---\n## 특이사항 (에러메시지)\n* 존재X or 묶음상품 : 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.\n* 중복상품, 중복입력상품 : 이미 추가된 상품입니다.\n","operationId":"saveBulkDivobjGoodsUpload","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}}}},"required":true},"responses":{"200":{"description":"기획전 상품 엑셀 일괄 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}}}},"900":{"description":"기획전 상품 엑셀 일괄 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 관리 - 기획전 단건 복사

> \## 기능설명\
> \* 기획전 정보를 단건 복사하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전 복사시 복사된 기획전 명은 '기획전명 + (복사)' 형식으로 저장됩니다.\
> \* 복사된 기획전의 전시여부는 전시안함으로 고정됩니다.\
> \
> \* 입력 파라미터( \* : 필수)\
> &#x20;   \* 필요 값 : mkdpNo \*\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.05\_231204\`\`\` : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선<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":{"PrMkdpBase":{"type":"object","description":"기획전기본","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"tmplNo":{"type":"string","description":"템플릿번호"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispEndDtm":{"type":"string","format":"date-time","description":"전시종료일시"},"mdId":{"type":"string","description":"담당MD"},"mkdpTtlHtml":{"type":"string","description":"기획전타이틀HTML_MO"},"mkdpTtlHtmlPc":{"type":"string","description":"기획전타이틀HTML_PC"},"htmlContYn":{"type":"string","description":"HTML컨텐츠여부"},"kwdNm":{"type":"string","description":"키워드명"},"brefDesc":{"type":"string","description":"간략설명"},"introConts":{"type":"string","description":"소개글"},"fotrFileConts":{"type":"string","description":"푸터파일내용"},"brandInfoMap":{"type":"object","additionalProperties":{"type":"string"},"description":"브랜드 정보"},"aplyBrand":{"type":"array","description":"기획전브랜드리스트","items":{"type":"string"}},"pcTtopExpYn":{"type":"string","description":"PC상단노출여부"},"dispGrpNo":{"type":"string","description":"전시그룹번호"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"deleteList":{"type":"array","description":"삭제이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"dispMediaCd":{"type":"string","description":"전시매체코드"},"dispStafYn":{"type":"string","description":"임직원여부"},"tmplFileNm":{"type":"string","description":"템플릿파일명"},"dispGrpNoList":{"type":"array","items":{"type":"string"}},"mbrDispGradeCd":{"type":"array","description":"전시회원코드 배열","items":{"type":"string"}},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"배너이미지대체텍스트"},"totalCount":{"type":"integer","format":"int32","description":"전체개수"},"fileIdx":{"type":"integer","format":"int32","description":"업로드파일 순번"},"dispStat":{"type":"string"},"dispStatName":{"type":"string"},"dispMediaNm":{"type":"string"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ResponseString":{"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":{"type":"string","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"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/registerCopyMarketingDisplayMgmt":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 관리 - 기획전 단건 복사","description":"## 기능설명\n* 기획전 정보를 단건 복사하는 API 입니다.\n---\n## 상세설명\n* 기획전 복사시 복사된 기획전 명은 '기획전명 + (복사)' 형식으로 저장됩니다.\n* 복사된 기획전의 전시여부는 전시안함으로 고정됩니다.\n\n* 입력 파라미터( * : 필수)\n    * 필요 값 : mkdpNo *\n---\n## 수정번호\n* ```Release v1.05_231204``` : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선\n","operationId":"registerCopyMarketingDisplayMgmt","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrMkdpBase"}}},"required":true},"responses":{"200":{"description":"기획전 복사 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"기획전 복사 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 기획전 상품 일괄등록의 중복, 존재하지 않는 상품 제외 리스트 조회

> \## 기능설명\
> \* 기획전 상품 일괄등록의Ø 중복, 존재하지 않는 상품 제외하고 해당 리스트를 리턴하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 상품 예외상황 발생 시 상품에 에러메시지를 담아서 결과값을 반환합니다.\
> \* 일반상품만 등록이 가능합니다.\
> \---\
> \## 특이사항 (에러메시지)\
> \* 존재X or 묶음상품 : 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.\
> \* 중복상품 : 상품번호는 중복이 불가능합니다.<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":{"PrMkdpGoodsInfoSearch":{"type":"object","description":"기획전상품정보 Search 모델","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"goodsNo":{"type":"string","description":"상품번호"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"goodsArray":{"type":"array","description":"상품번호 배열","items":{"type":"string"}},"goodsInfoList":{"type":"array","description":"상품 정보 리스트","items":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}}}},"PrMkdpGoodsInfo":{"type":"object","description":"기획전상품정보","properties":{"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"할인가"},"errorMessage":{"type":"string","description":"오류메시지"},"validStat":{"type":"string","description":"오류상태"},"timeDealYn":{"type":"string","description":"타임딜적용여부"},"tmdlHistStrDtm":{"type":"string","format":"date-time","description":"타임딜시작일시"},"tmdlHistEndDtm":{"type":"string","format":"date-time","description":"타임딜종료일시"},"tmdlSalePrc":{"type":"number","description":"타임딜판매가"}}},"ResponseListPrMkdpGoodsInfo":{"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":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}},"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":{"/v1/display/marketingDisplayMgmt/getValidPlanShopGoodsList":{"post":{"tags":["기획전 정보 관리"],"summary":"기획전 상품 일괄등록의 중복, 존재하지 않는 상품 제외 리스트 조회","description":"## 기능설명\n* 기획전 상품 일괄등록의Ø 중복, 존재하지 않는 상품 제외하고 해당 리스트를 리턴하는 API 입니다.\n---\n## 상세설명\n* 상품 예외상황 발생 시 상품에 에러메시지를 담아서 결과값을 반환합니다.\n* 일반상품만 등록이 가능합니다.\n---\n## 특이사항 (에러메시지)\n* 존재X or 묶음상품 : 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.\n* 중복상품 : 상품번호는 중복이 불가능합니다.\n","operationId":"getValidDisplayGoodsListV2","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","required":true,"schema":{"type":"string"}},{"name":"divobjNo","in":"query","description":"구분자번호","required":true,"schema":{"type":"string"}},{"name":"goodsInfoList","in":"query","description":"상품정보리스트","required":true,"schema":{"type":"List"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrMkdpGoodsInfoSearch"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListPrMkdpGoodsInfo"}}}}},"deprecated":true}}}}
```

## 기획전 구성안 상품 유닛 조회

> \## 기능설명\
> \* 상품번호 목록으로 \*\*고객 화면이 받는 것과 같은\*\* 상품 값을 조회합니다.\
> \---\
> \## 상세설명\
> \* 구성안은 상품번호만 저장합니다. 이름·가격·할인·브랜드·아이콘은 상품 쪽에서\
> &#x20; 바뀌므로 구성안에 베껴 두지 않고 그릴 때 번호로 받아 갑니다.\
> \* api-display 의 전시상품 조회를 그대로 전달합니다 — 저작 화면과 고객 화면이\
> &#x20; 같은 값을 써야 "저장했는데 다르게 보인다" 가 생기지 않습니다.\
> \* 조회에 실패해도 빈 목록을 돌려줍니다. 상품 자리만 비고 구성안은 그려집니다.<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":{"ResponseListMapStringObject":{"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":{"type":"array","description":"payload","items":{"type":"object","additionalProperties":{}}},"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":{"/v1/display/marketingDisplayMgmt/planGoodsUnits":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 구성안 상품 유닛 조회","description":"## 기능설명\n* 상품번호 목록으로 **고객 화면이 받는 것과 같은** 상품 값을 조회합니다.\n---\n## 상세설명\n* 구성안은 상품번호만 저장합니다. 이름·가격·할인·브랜드·아이콘은 상품 쪽에서\n  바뀌므로 구성안에 베껴 두지 않고 그릴 때 번호로 받아 갑니다.\n* api-display 의 전시상품 조회를 그대로 전달합니다 — 저작 화면과 고객 화면이\n  같은 값을 써야 \"저장했는데 다르게 보인다\" 가 생기지 않습니다.\n* 조회에 실패해도 빈 목록을 돌려줍니다. 상품 자리만 비고 구성안은 그려집니다.\n","operationId":"getPlanGoodsUnits","parameters":[{"name":"goodsNoList","in":"query","description":"상품번호 목록","required":true,"schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListMapStringObject"}}}}}}}}}
```

## 기획전 팝업 구분자탭 탭 - 구분자 다국어 정보 조회

> \## 기능설명\
> \* 기획전 구분자 다국어 정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전번호,언어코드를 받아 기획전 구분자 다국어 정보를 조회합니다.<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":{"PrMkdpDivobjInfo":{"type":"object","description":"기획전 구분자 정보","properties":{"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"divobjGbCd":{"type":"string","description":"구분자구분코드(DP024)"},"divobjNm":{"type":"string","description":"구분자명"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"tmplNo":{"type":"string","description":"템플릿번호"},"cpnNo":{"type":"string","description":"쿠폰번호"},"textDivobjNm":{"type":"string","description":"텍스트구분자명"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"cpnBnrImgPathNm":{"type":"string","description":"쿠폰배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"쿠폰배너이미지대체텍스트"},"cpnBnrImgFileNm":{"type":"string","description":"쿠폰배너이미지파일명"},"htmlFileCont":{"type":"string","description":"HTML파일내용"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"stateForm":{"type":"string","description":"구분자상태"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/getPrMkdpDivobjMultiLanguage":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 팝업 구분자탭 탭 - 구분자 다국어 정보 조회","description":"## 기능설명\n* 기획전 구분자 다국어 정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 기획전번호,언어코드를 받아 기획전 구분자 다국어 정보를 조회합니다.\n","operationId":"getPrMkdpDivobjMultiLanguage","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","required":true,"schema":{"type":"string"}},{"name":"divobjNo","in":"query","description":"구분자번호","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","description":"언어코드","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"기획전 구분자 다국어정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrMkdpDivobjInfo"}}}},"900":{"description":"기획전 구분자 다국어정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 팝업 기본정보 탭 - 기본정보 다국어 조회

> \## 기능설명\
> \* 기획전 기본정보 다국어 상세정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전번호,언어코드를 받아 기획전 다국어 기본 정보를 조회합니다.<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":{"PrMkdpBase":{"type":"object","description":"기획전기본","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"tmplNo":{"type":"string","description":"템플릿번호"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispEndDtm":{"type":"string","format":"date-time","description":"전시종료일시"},"mdId":{"type":"string","description":"담당MD"},"mkdpTtlHtml":{"type":"string","description":"기획전타이틀HTML_MO"},"mkdpTtlHtmlPc":{"type":"string","description":"기획전타이틀HTML_PC"},"htmlContYn":{"type":"string","description":"HTML컨텐츠여부"},"kwdNm":{"type":"string","description":"키워드명"},"brefDesc":{"type":"string","description":"간략설명"},"introConts":{"type":"string","description":"소개글"},"fotrFileConts":{"type":"string","description":"푸터파일내용"},"brandInfoMap":{"type":"object","additionalProperties":{"type":"string"},"description":"브랜드 정보"},"aplyBrand":{"type":"array","description":"기획전브랜드리스트","items":{"type":"string"}},"pcTtopExpYn":{"type":"string","description":"PC상단노출여부"},"dispGrpNo":{"type":"string","description":"전시그룹번호"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"deleteList":{"type":"array","description":"삭제이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"dispMediaCd":{"type":"string","description":"전시매체코드"},"dispStafYn":{"type":"string","description":"임직원여부"},"tmplFileNm":{"type":"string","description":"템플릿파일명"},"dispGrpNoList":{"type":"array","items":{"type":"string"}},"mbrDispGradeCd":{"type":"array","description":"전시회원코드 배열","items":{"type":"string"}},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"배너이미지대체텍스트"},"totalCount":{"type":"integer","format":"int32","description":"전체개수"},"fileIdx":{"type":"integer","format":"int32","description":"업로드파일 순번"},"dispStat":{"type":"string"},"dispStatName":{"type":"string"},"dispMediaNm":{"type":"string"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/getPrMkdpBaseMultiLanguage":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 팝업 기본정보 탭 - 기본정보 다국어 조회","description":"## 기능설명\n* 기획전 기본정보 다국어 상세정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 기획전번호,언어코드를 받아 기획전 다국어 기본 정보를 조회합니다.\n","operationId":"getPrMkdpBaseMultiLanguage","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","description":"언어코드","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"기획전 기본정보 다국어 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrMkdpBase"}}}},"900":{"description":"기획전 기본정보 다국어 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 정보 관리 - 기획전 정보 목록 조회

> \## 기능설명\
> \* 기획전 정보 목록을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전번호,기획전명,담당MD,사용자아이디,전시여부,브랜드명,전시시작날짜,전시종료날짜,기획전상태,사이트번호,그룹번호 조회조건에 따라 기획전 정보를 조회합니다.\
> &#x20;   \* 사이트번호, 사이트기준 몰번호, 몰 기준 전시그룹번호로 조회합니다.\
> \* 기획전 정보 목록은 전시순서 내림차순, 전시시작날짜 내림차순으로 노출됩니다.<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":{"PrMkdpBase":{"type":"object","description":"기획전기본","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"tmplNo":{"type":"string","description":"템플릿번호"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispEndDtm":{"type":"string","format":"date-time","description":"전시종료일시"},"mdId":{"type":"string","description":"담당MD"},"mkdpTtlHtml":{"type":"string","description":"기획전타이틀HTML_MO"},"mkdpTtlHtmlPc":{"type":"string","description":"기획전타이틀HTML_PC"},"htmlContYn":{"type":"string","description":"HTML컨텐츠여부"},"kwdNm":{"type":"string","description":"키워드명"},"brefDesc":{"type":"string","description":"간략설명"},"introConts":{"type":"string","description":"소개글"},"fotrFileConts":{"type":"string","description":"푸터파일내용"},"brandInfoMap":{"type":"object","additionalProperties":{"type":"string"},"description":"브랜드 정보"},"aplyBrand":{"type":"array","description":"기획전브랜드리스트","items":{"type":"string"}},"pcTtopExpYn":{"type":"string","description":"PC상단노출여부"},"dispGrpNo":{"type":"string","description":"전시그룹번호"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"deleteList":{"type":"array","description":"삭제이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"dispMediaCd":{"type":"string","description":"전시매체코드"},"dispStafYn":{"type":"string","description":"임직원여부"},"tmplFileNm":{"type":"string","description":"템플릿파일명"},"dispGrpNoList":{"type":"array","items":{"type":"string"}},"mbrDispGradeCd":{"type":"array","description":"전시회원코드 배열","items":{"type":"string"}},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"배너이미지대체텍스트"},"totalCount":{"type":"integer","format":"int32","description":"전체개수"},"fileIdx":{"type":"integer","format":"int32","description":"업로드파일 순번"},"dispStat":{"type":"string"},"dispStatName":{"type":"string"},"dispMediaNm":{"type":"string"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/getPrMkdpBaseList":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 정보 관리 - 기획전 정보 목록 조회","description":"## 기능설명\n* 기획전 정보 목록을 조회하는 API 입니다.\n---\n## 상세설명\n* 기획전번호,기획전명,담당MD,사용자아이디,전시여부,브랜드명,전시시작날짜,전시종료날짜,기획전상태,사이트번호,그룹번호 조회조건에 따라 기획전 정보를 조회합니다.\n    * 사이트번호, 사이트기준 몰번호, 몰 기준 전시그룹번호로 조회합니다.\n* 기획전 정보 목록은 전시순서 내림차순, 전시시작날짜 내림차순으로 노출됩니다.\n","operationId":"getPrMkdpBaseList","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","schema":{"type":"string"}},{"name":"mkdpNm","in":"query","description":"기획전명","schema":{"type":"string"}},{"name":"mdId","in":"query","description":"담당MD","schema":{"type":"string"}},{"name":"dispMediaCd","in":"query","description":"전시매체코드(DP018)","schema":{"type":"string"}},{"name":"userId","in":"query","description":"사용자아이디","schema":{"type":"string"}},{"name":"dispYn","in":"query","description":"전시여부","schema":{"type":"string"}},{"name":"brandNm","in":"query","description":"브랜드명","schema":{"type":"string"}},{"name":"startDate","in":"query","description":"전시시작날짜","schema":{"type":"string"}},{"name":"endDate","in":"query","description":"전시종료날짜","schema":{"type":"string"}},{"name":"dispStat","in":"query","description":"기획전상태","schema":{"type":"string"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string"}},{"name":"dpmlNo","in":"query","description":"몰번호","schema":{"type":"string"}},{"name":"dispGrpNo","in":"query","description":"전시그룹번호","schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"기획전 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrMkdpBase"}}}},"900":{"description":"기획전 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 팝업 - 기획전 정보 상세 조회

> \## 기능설명\
> \* 기획전 상세 정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전번호,언어코드를 받아 기획전 상세 정보를 조회합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.05\_231204\`\`\` : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선<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":{"PrMkdpBase":{"type":"object","description":"기획전기본","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"tmplNo":{"type":"string","description":"템플릿번호"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispEndDtm":{"type":"string","format":"date-time","description":"전시종료일시"},"mdId":{"type":"string","description":"담당MD"},"mkdpTtlHtml":{"type":"string","description":"기획전타이틀HTML_MO"},"mkdpTtlHtmlPc":{"type":"string","description":"기획전타이틀HTML_PC"},"htmlContYn":{"type":"string","description":"HTML컨텐츠여부"},"kwdNm":{"type":"string","description":"키워드명"},"brefDesc":{"type":"string","description":"간략설명"},"introConts":{"type":"string","description":"소개글"},"fotrFileConts":{"type":"string","description":"푸터파일내용"},"brandInfoMap":{"type":"object","additionalProperties":{"type":"string"},"description":"브랜드 정보"},"aplyBrand":{"type":"array","description":"기획전브랜드리스트","items":{"type":"string"}},"pcTtopExpYn":{"type":"string","description":"PC상단노출여부"},"dispGrpNo":{"type":"string","description":"전시그룹번호"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"deleteList":{"type":"array","description":"삭제이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"dispMediaCd":{"type":"string","description":"전시매체코드"},"dispStafYn":{"type":"string","description":"임직원여부"},"tmplFileNm":{"type":"string","description":"템플릿파일명"},"dispGrpNoList":{"type":"array","items":{"type":"string"}},"mbrDispGradeCd":{"type":"array","description":"전시회원코드 배열","items":{"type":"string"}},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"배너이미지대체텍스트"},"totalCount":{"type":"integer","format":"int32","description":"전체개수"},"fileIdx":{"type":"integer","format":"int32","description":"업로드파일 순번"},"dispStat":{"type":"string"},"dispStatName":{"type":"string"},"dispMediaNm":{"type":"string"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/getPrMkdpBaseDetail":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 팝업 - 기획전 정보 상세 조회","description":"## 기능설명\n* 기획전 상세 정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 기획전번호,언어코드를 받아 기획전 상세 정보를 조회합니다.\n---\n## 수정번호\n* ```Release v1.05_231204``` : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선\n","operationId":"getPrMkdpBaseDetail","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","description":"언어코드","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"기획전 상세정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrMkdpBase"}}}},"900":{"description":"기획전 상세정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 기획전 팝업 - 기획전 이미지 상세 조회

> \## 기능설명\
> \* 기획전 이미지 상세 정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전번호,언어코드를 받아 기획전 이미지 상세 정보를 조회합니다.<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":{"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/getPrDispImgInfoDetail":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 팝업 - 기획전 이미지 상세 조회","description":"## 기능설명\n* 기획전 이미지 상세 정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 기획전번호,언어코드를 받아 기획전 이미지 상세 정보를 조회합니다.\n","operationId":"getPrDispImgInfoDetail","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","description":"언어코드","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"기획전 상세 이미지 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrDispImgInfo"}}}},"900":{"description":"기획전 상세 이미지 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 구성안 조회

> \## 기능설명\
> \* 기획전의 구성안 문서(LayoutDocument)를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전 하나에 문서 한 벌입니다. 전시위치는 기획전 자신이며 따로 고르지 않습니다.\
> \* 아직 저작하지 않은 기획전이면 payload 가 비어 있습니다 — 오류가 아닙니다.\
> \* 전시 스튜디오(구성안 관리) 화면은 기획전 문서를 다루지 않습니다. 기획전 문서는\
> &#x20; 이 경로로만 읽고 씁니다.<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":{"PlanLayoutConfig":{"type":"object","description":"기획전 구성안","properties":{"siteNo":{"type":"string","description":"사이트번호"},"layoutSysModDtm":{"type":"string","description":"동시 저장 검사용 문서 버전(해석하지 말고 그대로 돌려보낸다)"},"layoutNo":{"type":"string","description":"레이아웃번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(기획전번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"dispYn":{"type":"string","description":"전시여부"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"layoutJson":{"type":"string","description":"레이아웃 JSON"},"useYn":{"type":"string","description":"사용여부"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/getPlanLayoutConfig":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 구성안 조회","description":"## 기능설명\n* 기획전의 구성안 문서(LayoutDocument)를 조회하는 API 입니다.\n---\n## 상세설명\n* 기획전 하나에 문서 한 벌입니다. 전시위치는 기획전 자신이며 따로 고르지 않습니다.\n* 아직 저작하지 않은 기획전이면 payload 가 비어 있습니다 — 오류가 아닙니다.\n* 전시 스튜디오(구성안 관리) 화면은 기획전 문서를 다루지 않습니다. 기획전 문서는\n  이 경로로만 읽고 씁니다.\n","operationId":"getPlanLayoutConfig","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"기획전 구성안 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PlanLayoutConfig"}}}},"900":{"description":"기획전 구성안 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 팝업 구분자탭 탭 - 구분자정보 조회

> \## 기능설명\
> \* 기획전 구분자 상세정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전번호,언어코드를 받아 기획전 구분자 정보를 조회합니다.<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":{"PrMkdpDivobjInfo":{"type":"object","description":"기획전 구분자 정보","properties":{"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"divobjGbCd":{"type":"string","description":"구분자구분코드(DP024)"},"divobjNm":{"type":"string","description":"구분자명"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"tmplNo":{"type":"string","description":"템플릿번호"},"cpnNo":{"type":"string","description":"쿠폰번호"},"textDivobjNm":{"type":"string","description":"텍스트구분자명"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"cpnBnrImgPathNm":{"type":"string","description":"쿠폰배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"쿠폰배너이미지대체텍스트"},"cpnBnrImgFileNm":{"type":"string","description":"쿠폰배너이미지파일명"},"htmlFileCont":{"type":"string","description":"HTML파일내용"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"stateForm":{"type":"string","description":"구분자상태"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/getMarketingDisplayMgmtDivobj":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 팝업 구분자탭 탭 - 구분자정보 조회","description":"## 기능설명\n* 기획전 구분자 상세정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 기획전번호,언어코드를 받아 기획전 구분자 정보를 조회합니다.\n","operationId":"getMarketingDisplayMgmtDivobj","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","description":"언어코드","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"기획전 구분자정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrMkdpDivobjInfo"}}}},"900":{"description":"기획전 구분자정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 등록/수정 팝업 상품정보 탭 - 기획전 구분자 그리드 목록 조회

> \## 기능설명\
> \* 상품정보 탭 - 기획전 구분자 그리드 목록을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전 번호를 받아 기획전 구분자 목록을 조회합니다.\
> \* 기획전 구분자 목록은 전시순서,구분자번호 오름차순으로 노출됩니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.02\_231023\`\`\` : 스프린트2 PO1 결함/개선<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":{"PrMkdpDivobjInfo":{"type":"object","description":"기획전 구분자 정보","properties":{"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"divobjGbCd":{"type":"string","description":"구분자구분코드(DP024)"},"divobjNm":{"type":"string","description":"구분자명"},"dispYn":{"type":"string","description":"전시여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"tmplNo":{"type":"string","description":"템플릿번호"},"cpnNo":{"type":"string","description":"쿠폰번호"},"textDivobjNm":{"type":"string","description":"텍스트구분자명"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"cpnBnrImgPathNm":{"type":"string","description":"쿠폰배너이미지경로명"},"bnrImgAltCont":{"type":"string","description":"쿠폰배너이미지대체텍스트"},"cpnBnrImgFileNm":{"type":"string","description":"쿠폰배너이미지파일명"},"htmlFileCont":{"type":"string","description":"HTML파일내용"},"imgList":{"type":"array","description":"이미지리스트","items":{"$ref":"#/components/schemas/PrDispImgInfo"}},"stateForm":{"type":"string","description":"구분자상태"}}},"PrDispImgInfo":{"type":"object","description":"전시이미지정보","properties":{"langCd":{"type":"string","description":"언어코드"},"dispShopGbCd":{"type":"string","description":"전시매장구분코드(DP009)"},"shopCtgNo":{"type":"string","description":"매장카테고리번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"imgSn":{"type":"string","description":"이미지일련번호"},"bnrImgPathNm":{"type":"string","description":"배너이미지경로명"},"bnrImgFileNm":{"type":"string","description":"배너이미지파일명"},"bnrImgAltCont":{"type":"string","description":"배너이미지 대체텍스트"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispStat":{"type":"string","description":"기획전상태"},"contPathNm":{"type":"string","description":"썸네일이미지경로"},"contGbCd":{"type":"string","description":"콘텐츠구분코드(SN007)"},"copyShopCtgNo":{"type":"string","description":"매장카테코리번호(복사)"},"fileIdx":{"type":"integer","format":"int32","description":"이미지업로드 순번"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/getMarketingDisplayDivobjGridList":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 등록/수정 팝업 상품정보 탭 - 기획전 구분자 그리드 목록 조회","description":"## 기능설명\n* 상품정보 탭 - 기획전 구분자 그리드 목록을 조회하는 API 입니다.\n---\n## 상세설명\n* 기획전 번호를 받아 기획전 구분자 목록을 조회합니다.\n* 기획전 구분자 목록은 전시순서,구분자번호 오름차순으로 노출됩니다.\n---\n## 수정번호\n```Release v1.02_231023``` : 스프린트2 PO1 결함/개선\n","operationId":"getMarketingDisplayDivobjGridList","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"기획전 구분자정보 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrMkdpDivobjInfo"}}}},"900":{"description":"기획전 구분자정보 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 기획전 등록/수정 팝업 상품정보 탭 - 기획전 상품정보 상세 조회

> \## 기능설명\
> \* 상품정보 탭 - 기획전 구분자별 상품 상세정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전번호,구분자번호를 받아 구분자별 상품 상세 정보를 조회합니다.\
> \* 중복되는 상품이 있으면 해당 상품은 제외하고 상품들의 전시순서는 1부터 세팅해줍니다.<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":{"PrMkdpGoodsInfo":{"type":"object","description":"기획전상품정보","properties":{"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"할인가"},"errorMessage":{"type":"string","description":"오류메시지"},"validStat":{"type":"string","description":"오류상태"},"timeDealYn":{"type":"string","description":"타임딜적용여부"},"tmdlHistStrDtm":{"type":"string","format":"date-time","description":"타임딜시작일시"},"tmdlHistEndDtm":{"type":"string","format":"date-time","description":"타임딜종료일시"},"tmdlSalePrc":{"type":"number","description":"타임딜판매가"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/getGoodsListDetail":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 등록/수정 팝업 상품정보 탭 - 기획전 상품정보 상세 조회","description":"## 기능설명\n* 상품정보 탭 - 기획전 구분자별 상품 상세정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 기획전번호,구분자번호를 받아 구분자별 상품 상세 정보를 조회합니다.\n* 중복되는 상품이 있으면 해당 상품은 제외하고 상품들의 전시순서는 1부터 세팅해줍니다.\n","operationId":"getGoodsListDetail_1","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","required":true,"schema":{"type":"string"}},{"name":"divobjNo","in":"query","description":"구분자번호","required":true,"schema":{"type":"string"}},{"name":"goodsArray","in":"query","description":"상품번호Array","required":true,"schema":{"type":"array"}}],"responses":{"200":{"description":"기획전 구분자별 상품 목록 조회 및 세팅 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}}}},"900":{"description":"기획전 구분자별 상품 목록 조회 및 세팅 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 기획전 등록/수정 팝업 상품정보 탭 - 기획전 구분자별 상품 그리드 목록 조회

> \## 기능설명\
> \* 상품정보 탭 - 기획전 구분자별 상품그리드 목록을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전번호,구분자번호를 받아 구분자별 상품 목록을 조회합니다.\
> \* 기획전 구분자별 상품 목록은 전시순서 오름차순, 상품등록날짜 오름차순으로 노출됩니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.02\_231023\`\`\` : 스프린트2 PO1 결함/개선\
> \`\`\`Release v1.06\_250609\`\`\` : 타임딜 상품 추가 시 타임딜 관련 정보 조회<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":{"PrMkdpGoodsInfo":{"type":"object","description":"기획전상품정보","properties":{"langCd":{"type":"string","description":"언어코드"},"mkdpNo":{"type":"string","description":"기획전번호"},"divobjNo":{"type":"string","description":"구분자번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"할인가"},"errorMessage":{"type":"string","description":"오류메시지"},"validStat":{"type":"string","description":"오류상태"},"timeDealYn":{"type":"string","description":"타임딜적용여부"},"tmdlHistStrDtm":{"type":"string","format":"date-time","description":"타임딜시작일시"},"tmdlHistEndDtm":{"type":"string","format":"date-time","description":"타임딜종료일시"},"tmdlSalePrc":{"type":"number","description":"타임딜판매가"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/getDivobjGoodsGridList":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 등록/수정 팝업 상품정보 탭 - 기획전 구분자별 상품 그리드 목록 조회","description":"## 기능설명\n* 상품정보 탭 - 기획전 구분자별 상품그리드 목록을 조회하는 API 입니다.\n---\n## 상세설명\n* 기획전번호,구분자번호를 받아 구분자별 상품 목록을 조회합니다.\n* 기획전 구분자별 상품 목록은 전시순서 오름차순, 상품등록날짜 오름차순으로 노출됩니다.\n---\n## 수정번호\n```Release v1.02_231023``` : 스프린트2 PO1 결함/개선\n```Release v1.06_250609``` : 타임딜 상품 추가 시 타임딜 관련 정보 조회\n","operationId":"getDivobjGoodsGridList","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","required":true,"schema":{"type":"string"}},{"name":"divobjNo","in":"query","description":"구분자번호","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"기획전 구분자별 상품 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrMkdpGoodsInfo"}}}},"900":{"description":"기획전 구분자별 상품 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 기획전 구좌 → 구성안 변환(저장 전)

> \## 기능설명\
> 구 편집기로 저작된 기획전의 구분자·상품·쿠폰을 구성안 문서로 옮겨 돌려준다.\
> \*\*저장하지 않는다\*\* — 편집기에 띄울 문서를 만들 뿐이고, 전환은 저장할 때 확정된다.<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":{"ResponseJsonNode":{"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":{"$ref":"#/components/schemas/JsonNode","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"JsonNode":{},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/display/marketingDisplayMgmt/convertPlanLayout":{"get":{"tags":["기획전 정보 관리"],"summary":"기획전 구좌 → 구성안 변환(저장 전)","description":"## 기능설명\n구 편집기로 저작된 기획전의 구분자·상품·쿠폰을 구성안 문서로 옮겨 돌려준다.\n**저장하지 않는다** — 편집기에 띄울 문서를 만들 뿐이고, 전환은 저장할 때 확정된다.\n","operationId":"convertPlanLayout","parameters":[{"name":"mkdpNo","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseJsonNode"}}}}}}}}}
```
