# 상품 공통

## 이미지 저장

> \## 기능설명\
> \* 상품 이미지를 등록합니다.\
> \---\
> \## 상세설명\
> \* 상품 이미지를 S3에 등록합니다.<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":{"PrGoodsContInfo":{"type":"object","description":"상품컨텐츠정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}}}},"paths":{"/v2/goods/goodsCommonApi/uploadGoodsImage":{"post":{"tags":["상품 공통"],"summary":"이미지 저장","description":"## 기능설명\n* 상품 이미지를 등록합니다.\n---\n## 상세설명\n* 상품 이미지를 S3에 등록합니다.\n","operationId":"uploadGoodsRegistImageFile","parameters":[{"name":"files","in":"query","description":"이미지 파일 목록","required":true,"schema":{"type":"string","format":"binary"}},{"name":"imageInfo","in":"query","description":"이미지 정보 Request","schema":{"type":"ImageInfoRequestV2"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"imageInfo":{"type":"ImageInfoRequestV2","description":"이미지 정보 Request"}}}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}}}}}}}}}}
```

## 상품 다국어 정보 등록/수정

> \## 기능설명\
> \* 상품의 다국어 정보를 등록/수정합니다.\
> \---\
> \## 상세설명\
> \* 상품의 다국어 정보들 등록하거나 수정합니다.\
> \* 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.<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":{"GeneralGoodsCUDRequestV2":{"type":"object","description":"일반상품 상세 Request","properties":{"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"상품기본정보"},"prGoodsItemInfoList":{"type":"array","description":"상품항목정보 목록","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prGoodsSafeCertiHistList":{"type":"array","description":"상품안전인증이력","items":{"$ref":"#/components/schemas/PrGoodsSafeCertiHist"}},"prGoodsAttInfoList":{"type":"array","description":"상품카테고리속성 목록","items":{"$ref":"#/components/schemas/PrGoodsAttInfo"}},"prGoodsPayMeanInfoList":{"type":"array","description":"상품결제수단 목록","items":{"$ref":"#/components/schemas/PrGoodsPayMeanInfo"}},"prAdveWrdHistList":{"type":"array","description":"홍보문구 목록","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}},"prPrestHistList":{"type":"array","description":"증정품 목록","items":{"$ref":"#/components/schemas/PrPrestHist"}},"prGoodsContInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 컨텐츠 정보"},"baseImageInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 기본이미지 정보"},"subImageInfoList":{"type":"array","description":"상품 추가이미지 정보","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"baseVideoInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 기본동영상 정보"},"deleteContsList":{"type":"array","description":"상품 컨텐츠(추가 이미지, 동영상) 삭제 목록","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"prGoodsPrceHist":{"$ref":"#/components/schemas/PrGoodsPrceHist","description":"상품 가격 정보"},"prRsvSaleHist":{"$ref":"#/components/schemas/PrRsvSaleHist","description":"예약 판매 정보"},"prDispGoodsInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrDispGoodsInfo"},"prAssocGoodsInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrAssocGoodsInfo"},"prGoodsIconInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrGoodsIconInfo"},"prItmBaseList":{"$ref":"#/components/schemas/RealGridCUDRequestPrItmBase"},"prItmBase":{"$ref":"#/components/schemas/PrItmBase"},"manualOptnInfoList":{"type":"array","description":"직접 입력 옵션 정보 목록 (sentinel ID 행, master JOIN 없이 VALUES 직삽)","items":{"$ref":"#/components/schemas/PrItmOptnInfo"}}}},"PrGoodsBase":{"type":"object","description":"상품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"salemnNm":{"type":"string","description":"판매자명"},"manufYm":{"type":"string","description":"제조년월"},"schKwdNm":{"type":"string","description":"검색키워드명"},"seoTitleNm":{"type":"string","description":"SEO 타이틀명"},"seoDesc":{"type":"string","description":"SEO 설명"},"seoKwdNm":{"type":"string","description":"SEO 키워드명"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"aprvReqDt":{"type":"string","description":"승인요청일자"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliDday":{"type":"integer","format":"int32","description":"배송기일"},"itmSoutNotiYn":{"type":"string","description":"단품품절알림여부"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035)"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029)"},"aprvDt":{"type":"string","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명(PR042)"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","description":"반려일자"},"schPsbYn":{"type":"string","description":"검색가능여부"},"optnYn":{"type":"string","description":"옵션관리여부"},"optnCDYn":{"type":"string","description":"옵션 추가/삭제 여부"},"goodsNoArray":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 등록방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 내용"},"gftWthdYn":{"type":"string","description":"회수 여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"}}},"PrGoodsItemInfo":{"type":"object","description":"상품항목정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNotiLisartCd":{"type":"string","description":"상품고시항목코드"},"goodsNotiItemCd":{"type":"string","description":"상품고시품목코드"},"notiItemCmt":{"type":"string","description":"고시항목내용"}}},"PrGoodsSafeCertiHist":{"type":"object","description":"상품안전인증이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"safeCertiGbCd":{"type":"string","description":"안전인증구분코드"},"safeCertiNo":{"type":"string","description":"안전인증번호"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"safeCertiOrnNm":{"type":"string","description":"안전인증기관명"}}},"PrGoodsAttInfo":{"type":"object","properties":{"langCd":{"type":"string","description":"언어코드(CM009)"},"goodsNo":{"type":"string","description":"상품번호"},"attCd":{"type":"string","description":"속성코드"},"attVal":{"type":"string","description":"속성값"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"}}},"PrGoodsPayMeanInfo":{"type":"object","description":"상품겿제수단정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"payWayCd":{"type":"string","description":"결제수단코드"},"useYn":{"type":"string","description":"사용여부"}}},"PrAdveWrdHist":{"type":"object","description":"상품홍보문구이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일자"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일자"},"adveWrd":{"type":"string","description":"홍보문구"},"useYn":{"type":"string","description":"사용여부"}}},"PrPrestHist":{"type":"object","description":"증정품이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"prestNm":{"type":"string","description":"증정품명"},"useYn":{"type":"string","description":"사용여부"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"}}},"PrGoodsContInfo":{"type":"object","description":"상품컨텐츠정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"PrGoodsPrceHist":{"type":"object","description":"상품가격이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"histStrDtm":{"type":"string","format":"date-time","description":"이력시작일시"},"histEndDtm":{"type":"string","format":"date-time","description":"이력종료일시"},"supPcost":{"type":"number","description":"공급원가"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"판매가"},"eventPrc":{"type":"number","description":"행사가"},"mrgnRate":{"type":"number","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"상품가격유형코드"},"prcChgCausCd":{"type":"string","description":"가격변경사유코드(PR033)"},"prcChgCausCdNm":{"type":"string","description":"가격변경사유"},"timeDealYn":{"type":"string","description":"타임딜 여부"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"PrRsvSaleHist":{"type":"object","description":"예약판매이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"예약시작일시"},"rsvEndDtm":{"type":"string","format":"date-time","description":"예약종료일시"},"rsvEndAfProcMethCd":{"type":"string","description":"예약종료후판매방식(PR011)"},"rsvStopYn":{"type":"string","description":"예약중단여부"},"rsvStopCausCd":{"type":"string","description":"예약중단사유코드(PR034)"},"rsvStopDtm":{"type":"string","format":"date-time","description":"예약중단일시"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자"}}},"RealGridCUDRequestPrDispGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}}}},"PrDispGoodsInfo":{"type":"object","description":"전시카테고리기본_상품정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispYn":{"type":"string","description":"전시여부"},"errorMessage":{"type":"string","description":"오류메시지","readOnly":true},"goodsList":{"type":"array","description":"상품번호 리스트","items":{"type":"string"}},"goodsArray":{"type":"array","description":"상품번호 배열","items":{"type":"string"}},"itemList":{"type":"array","description":"단품번호 리스트","items":{"type":"string"}},"itemArray":{"type":"array","description":"단품번호 배열","items":{"type":"string"}},"goodsNm":{"type":"string","description":"상품명","readOnly":true},"goodsTypCd":{"type":"string","description":"상품유형","readOnly":true},"norPrc":{"type":"number","description":"정상가","readOnly":true},"salePrc":{"type":"number","description":"판매가","readOnly":true},"saleStatCd":{"type":"string","description":"판매상태","readOnly":true},"entrNm":{"type":"string","description":"협력사명","readOnly":true},"goodsImg":{"type":"string","description":"상품이미지","readOnly":true},"moodTagVal":{"type":"string","description":"무드","readOnly":true},"wght":{"type":"string","description":"가중치","readOnly":true}}},"RealGridCUDRequestPrAssocGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}}}},"PrAssocGoodsInfo":{"type":"object","description":"연관상품정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"asctGoodsNo":{"type":"string","description":"연관상품번호"},"asctGbCd":{"type":"string","description":"연관구분코드"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"}}},"RealGridCUDRequestPrGoodsIconInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}}}},"PrGoodsIconInfo":{"type":"object","description":"상품아이콘정보","properties":{"siteNo":{"type":"string","description":"사이트번호"},"goodsNo":{"type":"string","description":"상품번호"},"dispIconNo":{"type":"string","description":"전시아이콘번호"},"siteNm":{"type":"string","description":"사이트명"},"iconNm":{"type":"string","description":"아이콘명"},"dispMediaCdNm":{"type":"string","description":"전시매체"},"iconTypCdNm":{"type":"string","description":"아이콘 유형"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"iconPathNm":{"type":"string","description":"아이콘 이미지 경로"},"delYn":{"type":"string","description":"삭제여부"}}},"RealGridCUDRequestPrItmBase":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}}}},"PrItmBase":{"type":"object","description":"단품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"optnCatNm1":{"type":"string","description":"옵션분류명_1"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnCatNm2":{"type":"string","description":"옵션분류명_2"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnCatNm3":{"type":"string","description":"옵션분류명_3"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnCatNm4":{"type":"string","description":"옵션분류명_4"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnCatNm5":{"type":"string","description":"옵션분류명_5"},"optnNm5":{"type":"string","description":"옵션명_5"},"lgcItmNo":{"type":"string","description":"자체단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"itmSaleStatCdNm":{"type":"string","description":"단품판매상태코드명"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상) 42:판매종료(삭제)"},"repItmYn":{"type":"string","description":"대표단품여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"addSupPcost":{"type":"number","description":"추가공급원가"},"addSalePrc":{"type":"number","description":"추가판매가"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리, 13:익일배송지연 자동품절처리, 14:모든단품품절로 상품 품절처리, 15:예약상품 품절처리, 16:묶음상품 품절로 인한 품절"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"optnCatNo1":{"type":"string","description":"옵션분류번호_1"},"optnNo1":{"type":"string","description":"옵션번호_1"},"optnCatNo2":{"type":"string","description":"옵션분류번호_2"},"optnNo2":{"type":"string","description":"옵션번호_2"},"optnCatNo3":{"type":"string","description":"옵션분류번호_3"},"optnNo3":{"type":"string","description":"옵션번호_3"},"optnCatNo4":{"type":"string","description":"옵션분류번호_4"},"optnNo4":{"type":"string","description":"옵션번호_4"},"optnCatNo5":{"type":"string","description":"옵션분류번호_5"},"optnNo5":{"type":"string","description":"옵션번호_5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"PrItmOptnInfo":{"type":"object","description":"단품옵션정보","properties":{"langCd":{"type":"string","description":"언어코드"},"goodsNo":{"type":"string","description":"상품번호"},"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnNo":{"type":"string","description":"옵션번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"옵션분류 순서"},"optnSortSeq":{"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":{"/v2/goods/goodsCommonApi/registGoodsMultiLanguage":{"post":{"tags":["상품 공통"],"summary":"상품 다국어 정보 등록/수정","description":"## 기능설명\n* 상품의 다국어 정보를 등록/수정합니다.\n---\n## 상세설명\n* 상품의 다국어 정보들 등록하거나 수정합니다.\n* 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.\n","operationId":"registGoodsMultiLanguage","parameters":[{"name":"request","in":"query","description":"상품 다국어 정보 Request","schema":{"type":"GeneralGoodsCUDRequestV2"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneralGoodsCUDRequestV2"}}},"required":true},"responses":{"200":{"description":"상품 다국어 정보 등록/수정 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"상품 다국어 정보 등록/수정 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 묶음상품 수정

> \## 기능설명\
> \* 묶음상품 정보를 수정합니다.\
> \---\
> \## 상세설명\
> \* 묶음상품 정보를 수정합니다.\
> \* 판매상태가 종료인 상품은 상품정보를 수정할 수 없습니다.\
> \* 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\`\
> &#x20;\- 묶음상품 구입자나이제한코드(buyrAgeLmtCd) 추가<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":{"PackageGoodsCUDRequest":{"type":"object","description":"묶음상품 상세 Requset","properties":{"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"상품기본"},"prGoodsContInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 컨텐츠 정보"},"baseImageInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 기본이미지 정보"},"subImageInfoList":{"type":"array","description":"상품 추가 이미지 정보","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"baseVideoInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 기본 동영상 정보"},"deleteContsList":{"type":"array","description":"상품 컨텐츠(추가 이미지, 동영상) 삭제 정보","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"packageRelatedGoodsListGridCUD":{"$ref":"#/components/schemas/RealGridCUDRequestPrRelGoodsInfo","description":"연관상품 상품 추가/수정/삭제 정보"},"prDispGoodsInfoListGridCUD":{"$ref":"#/components/schemas/RealGridCUDRequestPrDispGoodsInfo","description":"전시카테고리 추가/수정/삭제 정보"}}},"PrGoodsBase":{"type":"object","description":"상품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"salemnNm":{"type":"string","description":"판매자명"},"manufYm":{"type":"string","description":"제조년월"},"schKwdNm":{"type":"string","description":"검색키워드명"},"seoTitleNm":{"type":"string","description":"SEO 타이틀명"},"seoDesc":{"type":"string","description":"SEO 설명"},"seoKwdNm":{"type":"string","description":"SEO 키워드명"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"aprvReqDt":{"type":"string","description":"승인요청일자"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliDday":{"type":"integer","format":"int32","description":"배송기일"},"itmSoutNotiYn":{"type":"string","description":"단품품절알림여부"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035)"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029)"},"aprvDt":{"type":"string","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명(PR042)"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","description":"반려일자"},"schPsbYn":{"type":"string","description":"검색가능여부"},"optnYn":{"type":"string","description":"옵션관리여부"},"optnCDYn":{"type":"string","description":"옵션 추가/삭제 여부"},"goodsNoArray":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 등록방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 내용"},"gftWthdYn":{"type":"string","description":"회수 여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"}}},"PrGoodsContInfo":{"type":"object","description":"상품컨텐츠정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"RealGridCUDRequestPrRelGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}}}},"PrRelGoodsInfo":{"type":"object","description":"관계상품정보","properties":{"baseGoodsNo":{"type":"string","description":"기준상품번호"},"tgtGoodsNo":{"type":"string","description":"대상상품번호"},"repYn":{"type":"string","description":"대표여부"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"}}},"RealGridCUDRequestPrDispGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}}}},"PrDispGoodsInfo":{"type":"object","description":"전시카테고리기본_상품정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispYn":{"type":"string","description":"전시여부"},"errorMessage":{"type":"string","description":"오류메시지","readOnly":true},"goodsList":{"type":"array","description":"상품번호 리스트","items":{"type":"string"}},"goodsArray":{"type":"array","description":"상품번호 배열","items":{"type":"string"}},"itemList":{"type":"array","description":"단품번호 리스트","items":{"type":"string"}},"itemArray":{"type":"array","description":"단품번호 배열","items":{"type":"string"}},"goodsNm":{"type":"string","description":"상품명","readOnly":true},"goodsTypCd":{"type":"string","description":"상품유형","readOnly":true},"norPrc":{"type":"number","description":"정상가","readOnly":true},"salePrc":{"type":"number","description":"판매가","readOnly":true},"saleStatCd":{"type":"string","description":"판매상태","readOnly":true},"entrNm":{"type":"string","description":"협력사명","readOnly":true},"goodsImg":{"type":"string","description":"상품이미지","readOnly":true},"moodTagVal":{"type":"string","description":"무드","readOnly":true},"wght":{"type":"string","description":"가중치","readOnly":true}}},"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":{"/v2/goods/goodsCommonApi/modifyPackageGoods":{"post":{"tags":["상품 공통"],"summary":"묶음상품 수정","description":"## 기능설명\n* 묶음상품 정보를 수정합니다.\n---\n## 상세설명\n* 묶음상품 정보를 수정합니다.\n* 판매상태가 종료인 상품은 상품정보를 수정할 수 없습니다.\n* 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.\n---\n## 수정번호\n```Release v1.04_231120```\n - 묶음상품 구입자나이제한코드(buyrAgeLmtCd) 추가\n","operationId":"modifyPackageGoods","parameters":[{"name":"request","in":"query","description":"묶음상품정보 Request","schema":{"type":"PackageGoodsCUDRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackageGoodsCUDRequest"}}},"required":true},"responses":{"200":{"description":"묶음상품 수정 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"묶음상품 수정 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 상품정보 일괄수정

> \## 기능설명\
> \* 선택한 상품들의 전시카테고리, 홍보문구를 일괄 수정합니다.\
> \---\
> \## 상세설명\
> \* 선택한 상품들의 전시카테고리 또는 홍보문구를 일괄 수정합니다.\
> \* 홍보문구를 수정하는 경우 기존 홍보문구를 삭제하고 요청한 홍보문구로 변경합니다.\
> \---\
> \## 코드정리\
> \* target : 'dispCtg' : 전시카테고리, 'adveWrd' : 홍보문구\
> \* state : 'U' : 업데이트, 'D' : 삭제<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":{"GoodsMgmtInfoSaveApiRequest":{"type":"object","description":"상품관리 일관변경 Requsest","properties":{"goodsNoList":{"type":"array","description":"상품번호 목록","items":{"type":"string"}},"goodsMgmtInfo":{"type":"array","description":"상품관리 변경 Request 목록","items":{"$ref":"#/components/schemas/GoodsMgmtInfoApiRequest"}}}},"GoodsMgmtInfoApiRequest":{"type":"object","description":"상품관리 변경 Request","properties":{"state":{"type":"string","description":"요청 상태"},"target":{"type":"string","description":"변경 항목"},"dispCtgNoList":{"type":"array","description":"전시카테고리 리스트","items":{"type":"string"}},"adveWrd":{"type":"string","description":"홍보문구"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일자"},"aplyEndDtm":{"type":"string","format":"date-time","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":{"/v2/goods/goodsCommonApi/modifyGoodsInfo":{"post":{"tags":["상품 공통"],"summary":"상품정보 일괄수정","description":"## 기능설명\n* 선택한 상품들의 전시카테고리, 홍보문구를 일괄 수정합니다.\n---\n## 상세설명\n* 선택한 상품들의 전시카테고리 또는 홍보문구를 일괄 수정합니다.\n* 홍보문구를 수정하는 경우 기존 홍보문구를 삭제하고 요청한 홍보문구로 변경합니다.\n---\n## 코드정리\n* target : 'dispCtg' : 전시카테고리, 'adveWrd' : 홍보문구\n* state : 'U' : 업데이트, 'D' : 삭제\n","operationId":"modifyGoodsInfo","parameters":[{"name":"request","in":"query","schema":{"type":"GoodsMgmtInfoSaveApiRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsMgmtInfoSaveApiRequest"}}},"required":true},"responses":{"200":{"description":"상품정보 일괄수정 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"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":{"GiftGoodsCUDRequest":{"type":"object","description":"사은품 등록/수정 Request","properties":{"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"사은품 기본 정보"},"prItmBase":{"$ref":"#/components/schemas/PrItmBase","description":"사은품 단품 정보"},"giftImageInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"사은품 이미지 정보"}}},"PrGoodsBase":{"type":"object","description":"상품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"salemnNm":{"type":"string","description":"판매자명"},"manufYm":{"type":"string","description":"제조년월"},"schKwdNm":{"type":"string","description":"검색키워드명"},"seoTitleNm":{"type":"string","description":"SEO 타이틀명"},"seoDesc":{"type":"string","description":"SEO 설명"},"seoKwdNm":{"type":"string","description":"SEO 키워드명"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"aprvReqDt":{"type":"string","description":"승인요청일자"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliDday":{"type":"integer","format":"int32","description":"배송기일"},"itmSoutNotiYn":{"type":"string","description":"단품품절알림여부"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035)"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029)"},"aprvDt":{"type":"string","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명(PR042)"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","description":"반려일자"},"schPsbYn":{"type":"string","description":"검색가능여부"},"optnYn":{"type":"string","description":"옵션관리여부"},"optnCDYn":{"type":"string","description":"옵션 추가/삭제 여부"},"goodsNoArray":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 등록방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 내용"},"gftWthdYn":{"type":"string","description":"회수 여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"}}},"PrItmBase":{"type":"object","description":"단품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"optnCatNm1":{"type":"string","description":"옵션분류명_1"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnCatNm2":{"type":"string","description":"옵션분류명_2"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnCatNm3":{"type":"string","description":"옵션분류명_3"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnCatNm4":{"type":"string","description":"옵션분류명_4"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnCatNm5":{"type":"string","description":"옵션분류명_5"},"optnNm5":{"type":"string","description":"옵션명_5"},"lgcItmNo":{"type":"string","description":"자체단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"itmSaleStatCdNm":{"type":"string","description":"단품판매상태코드명"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상) 42:판매종료(삭제)"},"repItmYn":{"type":"string","description":"대표단품여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"addSupPcost":{"type":"number","description":"추가공급원가"},"addSalePrc":{"type":"number","description":"추가판매가"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리, 13:익일배송지연 자동품절처리, 14:모든단품품절로 상품 품절처리, 15:예약상품 품절처리, 16:묶음상품 품절로 인한 품절"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"optnCatNo1":{"type":"string","description":"옵션분류번호_1"},"optnNo1":{"type":"string","description":"옵션번호_1"},"optnCatNo2":{"type":"string","description":"옵션분류번호_2"},"optnNo2":{"type":"string","description":"옵션번호_2"},"optnCatNo3":{"type":"string","description":"옵션분류번호_3"},"optnNo3":{"type":"string","description":"옵션번호_3"},"optnCatNo4":{"type":"string","description":"옵션분류번호_4"},"optnNo4":{"type":"string","description":"옵션번호_4"},"optnCatNo5":{"type":"string","description":"옵션분류번호_5"},"optnNo5":{"type":"string","description":"옵션번호_5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"PrGoodsContInfo":{"type":"object","description":"상품컨텐츠정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"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":{"/v2/goods/goodsCommonApi/modifyGiftGoods":{"post":{"tags":["상품 공통"],"summary":"사은품 수정","description":"## 기능설명\n* 사은품 정보를 수정합니다.\n---\n## 상세설명\n* 사은품 정보를 수정합니다.\n* 판매상태가 종료인 사은품은 사은품정보를 수정할 수 없습니다.\n* 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.\n","operationId":"modifyGiftGoods","parameters":[{"name":"request","in":"query","description":"사은품정보 Request","schema":{"type":"GiftGoodsCUDRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftGoodsCUDRequest"}}},"required":true},"responses":{"200":{"description":"사은품 수정 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"사은품 수정 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 일반상품 수정

> \## 기능설명\
> \* 일반상품 정보를 수정합니다.\
> \---\
> \## 상세설명\
> \* 일반상품 정보를 수정합니다.\
> \* 판매상태를 품절로 변경 시 상품과 상품 내 판매중인 모든 단품의 판매상태가 품절로 변경되며, 품절사유는 '관리자 품절' 사유로 저장됩니다.\
> \* 판매상태가 종료인 상품은 상품정보를 수정할 수 없습니다.\
> \* 예약판매 중인 상품의 판매상태가 품절인 경우 판매중으로 변경할 수 없습니다.\
> \* 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.02\_231023\`\`\`\
> &#x20;\- 선물하기가능여부(gvgfPsbYn) 변수추가\
> \
> \`\`\`Release v1.03\_231106\`\`\`\
> &#x20;\- 사이즈 가이드 관련 컬럼(szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts) 추가\
> &#x20;\- 아이콘(뱃지) 설정 추가\
> \
> \`\`\`Release v1.04\_231120\`\`\`\
> &#x20;\- 임시저장 시 validation 수정 및 대체값 추가\
> &#x20;\- 임시저장 시 단품 옵션 추가/삭제 로직 추가\
> &#x20;\- 아이콘(뱃지) 설정 기능 개선\
> &#x20;\- 정기배송상품여부 컬럼(rglrDeliGoodsYn) 추가\
> \
> &#x20;\`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- 상품등록 및 상품상세팝업에 표준카테고리 관리속성 추가\
> \
> \`\`\`Release v1.06\_251020\`\`\`\
> &#x20;\- 임시저장 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":{"GeneralGoodsCUDRequestV2":{"type":"object","description":"일반상품 상세 Request","properties":{"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"상품기본정보"},"prGoodsItemInfoList":{"type":"array","description":"상품항목정보 목록","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prGoodsSafeCertiHistList":{"type":"array","description":"상품안전인증이력","items":{"$ref":"#/components/schemas/PrGoodsSafeCertiHist"}},"prGoodsAttInfoList":{"type":"array","description":"상품카테고리속성 목록","items":{"$ref":"#/components/schemas/PrGoodsAttInfo"}},"prGoodsPayMeanInfoList":{"type":"array","description":"상품결제수단 목록","items":{"$ref":"#/components/schemas/PrGoodsPayMeanInfo"}},"prAdveWrdHistList":{"type":"array","description":"홍보문구 목록","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}},"prPrestHistList":{"type":"array","description":"증정품 목록","items":{"$ref":"#/components/schemas/PrPrestHist"}},"prGoodsContInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 컨텐츠 정보"},"baseImageInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 기본이미지 정보"},"subImageInfoList":{"type":"array","description":"상품 추가이미지 정보","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"baseVideoInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 기본동영상 정보"},"deleteContsList":{"type":"array","description":"상품 컨텐츠(추가 이미지, 동영상) 삭제 목록","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"prGoodsPrceHist":{"$ref":"#/components/schemas/PrGoodsPrceHist","description":"상품 가격 정보"},"prRsvSaleHist":{"$ref":"#/components/schemas/PrRsvSaleHist","description":"예약 판매 정보"},"prDispGoodsInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrDispGoodsInfo"},"prAssocGoodsInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrAssocGoodsInfo"},"prGoodsIconInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrGoodsIconInfo"},"prItmBaseList":{"$ref":"#/components/schemas/RealGridCUDRequestPrItmBase"},"prItmBase":{"$ref":"#/components/schemas/PrItmBase"},"manualOptnInfoList":{"type":"array","description":"직접 입력 옵션 정보 목록 (sentinel ID 행, master JOIN 없이 VALUES 직삽)","items":{"$ref":"#/components/schemas/PrItmOptnInfo"}}}},"PrGoodsBase":{"type":"object","description":"상품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"salemnNm":{"type":"string","description":"판매자명"},"manufYm":{"type":"string","description":"제조년월"},"schKwdNm":{"type":"string","description":"검색키워드명"},"seoTitleNm":{"type":"string","description":"SEO 타이틀명"},"seoDesc":{"type":"string","description":"SEO 설명"},"seoKwdNm":{"type":"string","description":"SEO 키워드명"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"aprvReqDt":{"type":"string","description":"승인요청일자"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliDday":{"type":"integer","format":"int32","description":"배송기일"},"itmSoutNotiYn":{"type":"string","description":"단품품절알림여부"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035)"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029)"},"aprvDt":{"type":"string","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명(PR042)"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","description":"반려일자"},"schPsbYn":{"type":"string","description":"검색가능여부"},"optnYn":{"type":"string","description":"옵션관리여부"},"optnCDYn":{"type":"string","description":"옵션 추가/삭제 여부"},"goodsNoArray":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 등록방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 내용"},"gftWthdYn":{"type":"string","description":"회수 여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"}}},"PrGoodsItemInfo":{"type":"object","description":"상품항목정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNotiLisartCd":{"type":"string","description":"상품고시항목코드"},"goodsNotiItemCd":{"type":"string","description":"상품고시품목코드"},"notiItemCmt":{"type":"string","description":"고시항목내용"}}},"PrGoodsSafeCertiHist":{"type":"object","description":"상품안전인증이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"safeCertiGbCd":{"type":"string","description":"안전인증구분코드"},"safeCertiNo":{"type":"string","description":"안전인증번호"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"safeCertiOrnNm":{"type":"string","description":"안전인증기관명"}}},"PrGoodsAttInfo":{"type":"object","properties":{"langCd":{"type":"string","description":"언어코드(CM009)"},"goodsNo":{"type":"string","description":"상품번호"},"attCd":{"type":"string","description":"속성코드"},"attVal":{"type":"string","description":"속성값"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"}}},"PrGoodsPayMeanInfo":{"type":"object","description":"상품겿제수단정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"payWayCd":{"type":"string","description":"결제수단코드"},"useYn":{"type":"string","description":"사용여부"}}},"PrAdveWrdHist":{"type":"object","description":"상품홍보문구이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일자"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일자"},"adveWrd":{"type":"string","description":"홍보문구"},"useYn":{"type":"string","description":"사용여부"}}},"PrPrestHist":{"type":"object","description":"증정품이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"prestNm":{"type":"string","description":"증정품명"},"useYn":{"type":"string","description":"사용여부"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"}}},"PrGoodsContInfo":{"type":"object","description":"상품컨텐츠정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"PrGoodsPrceHist":{"type":"object","description":"상품가격이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"histStrDtm":{"type":"string","format":"date-time","description":"이력시작일시"},"histEndDtm":{"type":"string","format":"date-time","description":"이력종료일시"},"supPcost":{"type":"number","description":"공급원가"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"판매가"},"eventPrc":{"type":"number","description":"행사가"},"mrgnRate":{"type":"number","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"상품가격유형코드"},"prcChgCausCd":{"type":"string","description":"가격변경사유코드(PR033)"},"prcChgCausCdNm":{"type":"string","description":"가격변경사유"},"timeDealYn":{"type":"string","description":"타임딜 여부"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"PrRsvSaleHist":{"type":"object","description":"예약판매이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"예약시작일시"},"rsvEndDtm":{"type":"string","format":"date-time","description":"예약종료일시"},"rsvEndAfProcMethCd":{"type":"string","description":"예약종료후판매방식(PR011)"},"rsvStopYn":{"type":"string","description":"예약중단여부"},"rsvStopCausCd":{"type":"string","description":"예약중단사유코드(PR034)"},"rsvStopDtm":{"type":"string","format":"date-time","description":"예약중단일시"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자"}}},"RealGridCUDRequestPrDispGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}}}},"PrDispGoodsInfo":{"type":"object","description":"전시카테고리기본_상품정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispYn":{"type":"string","description":"전시여부"},"errorMessage":{"type":"string","description":"오류메시지","readOnly":true},"goodsList":{"type":"array","description":"상품번호 리스트","items":{"type":"string"}},"goodsArray":{"type":"array","description":"상품번호 배열","items":{"type":"string"}},"itemList":{"type":"array","description":"단품번호 리스트","items":{"type":"string"}},"itemArray":{"type":"array","description":"단품번호 배열","items":{"type":"string"}},"goodsNm":{"type":"string","description":"상품명","readOnly":true},"goodsTypCd":{"type":"string","description":"상품유형","readOnly":true},"norPrc":{"type":"number","description":"정상가","readOnly":true},"salePrc":{"type":"number","description":"판매가","readOnly":true},"saleStatCd":{"type":"string","description":"판매상태","readOnly":true},"entrNm":{"type":"string","description":"협력사명","readOnly":true},"goodsImg":{"type":"string","description":"상품이미지","readOnly":true},"moodTagVal":{"type":"string","description":"무드","readOnly":true},"wght":{"type":"string","description":"가중치","readOnly":true}}},"RealGridCUDRequestPrAssocGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}}}},"PrAssocGoodsInfo":{"type":"object","description":"연관상품정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"asctGoodsNo":{"type":"string","description":"연관상품번호"},"asctGbCd":{"type":"string","description":"연관구분코드"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"}}},"RealGridCUDRequestPrGoodsIconInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}}}},"PrGoodsIconInfo":{"type":"object","description":"상품아이콘정보","properties":{"siteNo":{"type":"string","description":"사이트번호"},"goodsNo":{"type":"string","description":"상품번호"},"dispIconNo":{"type":"string","description":"전시아이콘번호"},"siteNm":{"type":"string","description":"사이트명"},"iconNm":{"type":"string","description":"아이콘명"},"dispMediaCdNm":{"type":"string","description":"전시매체"},"iconTypCdNm":{"type":"string","description":"아이콘 유형"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"iconPathNm":{"type":"string","description":"아이콘 이미지 경로"},"delYn":{"type":"string","description":"삭제여부"}}},"RealGridCUDRequestPrItmBase":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}}}},"PrItmBase":{"type":"object","description":"단품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"optnCatNm1":{"type":"string","description":"옵션분류명_1"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnCatNm2":{"type":"string","description":"옵션분류명_2"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnCatNm3":{"type":"string","description":"옵션분류명_3"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnCatNm4":{"type":"string","description":"옵션분류명_4"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnCatNm5":{"type":"string","description":"옵션분류명_5"},"optnNm5":{"type":"string","description":"옵션명_5"},"lgcItmNo":{"type":"string","description":"자체단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"itmSaleStatCdNm":{"type":"string","description":"단품판매상태코드명"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상) 42:판매종료(삭제)"},"repItmYn":{"type":"string","description":"대표단품여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"addSupPcost":{"type":"number","description":"추가공급원가"},"addSalePrc":{"type":"number","description":"추가판매가"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리, 13:익일배송지연 자동품절처리, 14:모든단품품절로 상품 품절처리, 15:예약상품 품절처리, 16:묶음상품 품절로 인한 품절"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"optnCatNo1":{"type":"string","description":"옵션분류번호_1"},"optnNo1":{"type":"string","description":"옵션번호_1"},"optnCatNo2":{"type":"string","description":"옵션분류번호_2"},"optnNo2":{"type":"string","description":"옵션번호_2"},"optnCatNo3":{"type":"string","description":"옵션분류번호_3"},"optnNo3":{"type":"string","description":"옵션번호_3"},"optnCatNo4":{"type":"string","description":"옵션분류번호_4"},"optnNo4":{"type":"string","description":"옵션번호_4"},"optnCatNo5":{"type":"string","description":"옵션분류번호_5"},"optnNo5":{"type":"string","description":"옵션번호_5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"PrItmOptnInfo":{"type":"object","description":"단품옵션정보","properties":{"langCd":{"type":"string","description":"언어코드"},"goodsNo":{"type":"string","description":"상품번호"},"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnNo":{"type":"string","description":"옵션번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"옵션분류 순서"},"optnSortSeq":{"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":{"/v2/goods/goodsCommonApi/modifyGeneralGoods":{"post":{"tags":["상품 공통"],"summary":"일반상품 수정","description":"## 기능설명\n* 일반상품 정보를 수정합니다.\n---\n## 상세설명\n* 일반상품 정보를 수정합니다.\n* 판매상태를 품절로 변경 시 상품과 상품 내 판매중인 모든 단품의 판매상태가 품절로 변경되며, 품절사유는 '관리자 품절' 사유로 저장됩니다.\n* 판매상태가 종료인 상품은 상품정보를 수정할 수 없습니다.\n* 예약판매 중인 상품의 판매상태가 품절인 경우 판매중으로 변경할 수 없습니다.\n* 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.\n---\n## 수정번호\n```Release v1.02_231023```\n - 선물하기가능여부(gvgfPsbYn) 변수추가\n\n```Release v1.03_231106```\n - 사이즈 가이드 관련 컬럼(szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts) 추가\n - 아이콘(뱃지) 설정 추가\n\n```Release v1.04_231120```\n - 임시저장 시 validation 수정 및 대체값 추가\n - 임시저장 시 단품 옵션 추가/삭제 로직 추가\n - 아이콘(뱃지) 설정 기능 개선\n - 정기배송상품여부 컬럼(rglrDeliGoodsYn) 추가\n\n ```Release v1.05_231204```\n - 상품등록 및 상품상세팝업에 표준카테고리 관리속성 추가\n\n```Release v1.06_251020```\n - 임시저장 or 승인대기 상품의 경우 이미 등록된 상품가격 마진율에 따라 단품정보 공급가 재계산\n","operationId":"modifyGeneralGoods","parameters":[{"name":"request","in":"query","description":"일반상품정보 Request","schema":{"type":"GeneralGoodsCUDRequestV2"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneralGoodsCUDRequestV2"}}},"required":true},"responses":{"200":{"description":"일반상품 수정 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"일반상품 수정 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 가격 변경 예약 등록/취소

> \## 기능설명\
> \* 가격 변경 예약을 등록 또는 취소합니다.\
> \---\
> \## 상세설명\
> \* 가격 변경 예약을 등록하거나 취소합니다.\
> \* 가격변경요청코드(rsvCudStat)에 따라 등록과 취소를 구분합니다.\
> \* 기존에 가격 변경 예약이 등록되어 있는 경우 기존 등록된 항목을 삭제하고 요청한 정보를 등록합니다.\
> \* 등록의 경우 필수값을 모두 입력해야합니다.\
> &#x20;\* 공급원가, 정상가, 판매가, 마진율, 이력시작일시, 가격변경사유코드(PR033)\
> \---\
> \## 코드정리\
> \* \`\`\`가격변경요청코드\`\`\` : C:등록, D:취소\
> \## 수정번호\
> \`\`\`Release v2.00\_240827\`\`\`\
> &#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":{"GoodsPriceHistoryRequest":{"type":"object","description":"상품가격이력 Request","properties":{"goodsNo":{"type":"string","description":"상품번호"},"histEndDtm":{"type":"string","format":"date","description":"이력종료일시"},"histStrDtm":{"type":"string","format":"date","description":"이력시작일시"},"supPcost":{"type":"number","description":"공급원가"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"판매가"},"mrgnRate":{"type":"number","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"상품가격유형코드"},"prcChgCausCd":{"type":"string","description":"가격변경사유코드(PR033)"},"rsvCudStat":{"type":"string","description":"가격변경요청코드"},"timeDealYn":{"type":"string","description":"타임딜여부"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"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/goods/goodsCommontApi/modifyGeneralGoodsPriceReservation":{"post":{"tags":["상품 공통"],"summary":"가격 변경 예약 등록/취소","description":"## 기능설명\n* 가격 변경 예약을 등록 또는 취소합니다.\n---\n## 상세설명\n* 가격 변경 예약을 등록하거나 취소합니다.\n* 가격변경요청코드(rsvCudStat)에 따라 등록과 취소를 구분합니다.\n* 기존에 가격 변경 예약이 등록되어 있는 경우 기존 등록된 항목을 삭제하고 요청한 정보를 등록합니다.\n* 등록의 경우 필수값을 모두 입력해야합니다.\n * 공급원가, 정상가, 판매가, 마진율, 이력시작일시, 가격변경사유코드(PR033)\n---\n## 코드정리\n* ```가격변경요청코드``` : C:등록, D:취소\n## 수정번호\n```Release v2.00_240827```\n - 판매가/행사가 통합\n","operationId":"modifyGeneralGoodsPriceReservation","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsPriceHistoryRequest"}}},"required":true},"responses":{"200":{"description":"가격 변경 예약 등록/취소 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"가격 변경 예약 등록/취소 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 아이콘 정보 조회

> \## 기능설명\
> \* 상품에 등록된 아이콘 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품에 등록된 아이콘 정보를 조회합니다.\
> \---\
> \## 특이사항\
> \* NEW, BEST 아이콘은 수동 등록이 아니라 쿼리 조회시마다 노출 여부가 결정됩니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- 스프린트5 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":{"GoodsIconApiRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"goodsNo":{"type":"string","description":"상품번호"},"dispIconNo":{"type":"string","description":"전시아이콘번호"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"delYn":{"type":"string","description":"삭제여부"}}},"ResponseListPrGoodsIconInfo":{"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/PrGoodsIconInfo"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PrGoodsIconInfo":{"type":"object","description":"상품아이콘정보","properties":{"siteNo":{"type":"string","description":"사이트번호"},"goodsNo":{"type":"string","description":"상품번호"},"dispIconNo":{"type":"string","description":"전시아이콘번호"},"siteNm":{"type":"string","description":"사이트명"},"iconNm":{"type":"string","description":"아이콘명"},"dispMediaCdNm":{"type":"string","description":"전시매체"},"iconTypCdNm":{"type":"string","description":"아이콘 유형"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"iconPathNm":{"type":"string","description":"아이콘 이미지 경로"},"delYn":{"type":"string","description":"삭제여부"}}},"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":{"/v2/goods/goodsCommonApi/getPrGoodsIconInfoList":{"get":{"tags":["상품 공통"],"summary":"아이콘 정보 조회","description":"## 기능설명\n* 상품에 등록된 아이콘 정보를 조회합니다.\n---\n## 상세설명\n* 상품에 등록된 아이콘 정보를 조회합니다.\n---\n## 특이사항\n* NEW, BEST 아이콘은 수동 등록이 아니라 쿼리 조회시마다 노출 여부가 결정됩니다.\n---\n## 수정번호\n```Release v1.05_231204```\n - 스프린트5 PO1 결함/개선 - 아이콘 이미지 쿼리 수정\n","operationId":"getPrGoodsIconInfoList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsIconApiRequest"}}],"responses":{"200":{"description":"상품 아이콘 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListPrGoodsIconInfo"}}}},"900":{"description":"상품 아이콘 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 묶음상품 정보 조회

> \## 기능설명\
> \* 묶음상품 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 묶음상품의 상품정보를 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- 전시 상품 조회 쿼리 inner join으로 변경<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":{"GoodsBaseResponse":{"type":"object","description":"상품기본 Response","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"salemnNm":{"type":"string","description":"판매자명"},"manufYm":{"type":"string","description":"제조년월"},"schKwdNm":{"type":"string","description":"검색키워드"},"seoTitleNm":{"type":"string","description":"SEO 타이틀명"},"seoDesc":{"type":"string","description":"SEO 설명"},"seoKwdNm":{"type":"string","description":"SEO 키워드명"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"aprvReqDt":{"type":"string","description":"승인요청일자"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliDday":{"type":"integer","format":"int32","description":"배송기일"},"itmSoutNotiYn":{"type":"string","description":"단품품절알림여부"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035)"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029)"},"aprvDt":{"type":"string","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명(PR042)"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","description":"반려일자"},"schPsbYn":{"type":"string","description":"검색가능여부"},"optnYn":{"type":"string","description":"옵션관리여부"},"optnCDYn":{"type":"string","description":"옵션 추가/삭제 여부"},"goodsNoArray":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 등록방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 내용"},"gftWthdYn":{"type":"string","description":"회수 여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"stdCtgHierarchy":{"type":"string","description":"표준분류하이라키구조"},"mdId":{"type":"string","description":"MD아이디"},"mdNm":{"type":"string","description":"MD명"},"goodsNotiLisartCd":{"type":"string","description":"상품고시품목코드"},"safeCertiNeedYn":{"type":"string","description":"안전인증필요여부(표준카테고리)"},"trdTypCd":{"type":"string","description":"거래형태코드(VD002)"},"mrgnRateGbCd":{"type":"string","description":"마진구분코드(VD008)"},"mrgnRate1":{"type":"number","description":"마진율1"},"mrgnRate2":{"type":"number","description":"마진율2"}}},"ResponsePackageGoodsResponse":{"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/PackageGoodsResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PackageGoodsResponse":{"type":"object","description":"묶음상품 상세 Response","properties":{"prGoodsBase":{"$ref":"#/components/schemas/GoodsBaseResponse","description":"상품 기본 정보"},"prRelGoodsInfoList":{"type":"array","description":"관계상품 목록","items":{"$ref":"#/components/schemas/RelatedGoodsResponse"}},"prStdCtgDispInfoList":{"type":"array","description":"표준카테고리전시정보 목록","items":{"$ref":"#/components/schemas/PrStdCtgDispInfo"}},"prGoodsContInfoList":{"type":"array","description":"상품 컨텐츠 목록","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}}}},"RelatedGoodsResponse":{"type":"object","properties":{"baseGoodsNo":{"type":"string","description":"기준상품번호"},"tgtGoodsNo":{"type":"string","description":"대상상품번호"},"repYn":{"type":"string","description":"대표여부"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"goodsNm":{"type":"string"},"brandNm":{"type":"string"},"entrNo":{"type":"string"},"entrNm":{"type":"string"},"mdId":{"type":"string"},"mdNm":{"type":"string"},"saleStatCdNm":{"type":"string"},"dispYn":{"type":"string"},"deliProcTypCdNm":{"type":"string"},"deliGoodsGbCdNm":{"type":"string"},"salePrc":{"type":"number"},"dispDlexAmt":{"type":"string"}}},"PrStdCtgDispInfo":{"type":"object","description":"표준카테고리전시정보","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"repCtgYn":{"type":"string","description":"대표카테고리여부"},"useYn":{"type":"string","description":"사용여부"},"dispCtgNm":{"type":"string","description":"전시카테고리명","readOnly":true},"dpmlNo":{"type":"string","description":"전시몰 번호"},"siteNm":{"type":"string","description":"사이트명","readOnly":true},"dpmlNm":{"type":"string","description":"전시몰명","readOnly":true},"dispCtgHierarchy":{"type":"string","description":"상품 BO-API_전시카테고리 구조","readOnly":true}}},"PrGoodsContInfo":{"type":"object","description":"상품컨텐츠정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"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":{"/v2/goods/goodsCommonApi/getPackageGoodsInfo":{"get":{"tags":["상품 공통"],"summary":"묶음상품 정보 조회","description":"## 기능설명\n* 묶음상품 정보를 조회합니다.\n---\n## 상세설명\n* 묶음상품의 상품정보를 조회합니다.\n---\n## 수정번호\n```Release v1.05_231204```\n - 전시 상품 조회 쿼리 inner join으로 변경\n","operationId":"getPackageGoodsInfo","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsBaseResponse"}}],"responses":{"200":{"description":"상품정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePackageGoodsResponse"}}}},"900":{"description":"상품정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 단품 옵션목록 조회

> \## 기능설명\
> \* 단품 옵션목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 단품 옵션목록을 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.03\_231106\`\`\`\
> \- 이미지경로명(imgPathNm), 이미지파일명(imgFileNm), RGB값(rgbVal) 변수추가<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":{"GoodsOptionApiRequest":{"type":"object","description":"상품 옵션 Request","properties":{"pregGoodsNo":{"type":"string"},"goodsNo":{"type":"string"},"entrNo":{"type":"string"},"optnCatNo":{"type":"string"}}},"ResponseListGoodsOptionApiResponse":{"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/GoodsOptionApiResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsOptionApiResponse":{"type":"object","description":"상품 단품옵션정보 Api Response","properties":{"goodsNo":{"type":"string","description":"상품번호"},"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNo":{"type":"string","description":"옵션번호"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"string","description":"옵션분류 순서"},"optnCatRegGbCd":{"type":"string","description":"옵션분류등록구분코드"},"optnCatRegGbNm":{"type":"string","description":"옵션분류등록구분코드명"},"optnCatTypCd":{"type":"string","description":"옵션분류유형코드(PR019)"},"optnCatTypCdNm":{"type":"string","description":"옵션분류유형코드명"},"optnList":{"type":"array","description":"단품 옵션값 리스트","items":{"$ref":"#/components/schemas/PrItmOptnInfo"}},"optnCdList":{"type":"string","deprecated":true,"description":"옵션값 리스트"},"optnCdNmList":{"type":"string","deprecated":true,"description":"옵션명 리스트"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"}}},"PrItmOptnInfo":{"type":"object","description":"단품옵션정보","properties":{"langCd":{"type":"string","description":"언어코드"},"goodsNo":{"type":"string","description":"상품번호"},"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnNo":{"type":"string","description":"옵션번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"옵션분류 순서"},"optnSortSeq":{"type":"integer","format":"int32","description":"옵션 순서"}}},"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":{"/v2/goods/goodsCommonApi/getItemOptionList":{"get":{"tags":["상품 공통"],"summary":"단품 옵션목록 조회","description":"## 기능설명\n* 단품 옵션목록을 조회합니다.\n---\n## 상세설명\n* 단품 옵션목록을 조회합니다.\n---\n## 수정번호\n```Release v1.03_231106```\n- 이미지경로명(imgPathNm), 이미지파일명(imgFileNm), RGB값(rgbVal) 변수추가\n","operationId":"getItemOptionList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsOptionApiRequest"}}],"responses":{"200":{"description":"단품 옵션목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListGoodsOptionApiResponse"}}}},"900":{"description":"단품 옵션목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 단품 판매상태 목록 조회

> \## 기능설명\
> \* 단품 판매상태 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 단품 판매상태 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.03\_231106\`\`\`\
> &#x20;\- 단품 판매상태 목록 조회 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":{"ResponseGoodsSaleStateResponse":{"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/GoodsSaleStateResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsSaleStateResponse":{"type":"object","description":"상품 판매상태조회 API Response DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"saleStatCd":{"type":"string","description":"상품 판매상태 코드"},"saleStatChgCausCd":{"type":"string","description":"상품 판매상태 변경 사유 코드"},"prItmBaseList":{"type":"array","description":"단품 판매상태 정보 리스트","items":{"$ref":"#/components/schemas/PrItmBase"}}}},"PrItmBase":{"type":"object","description":"단품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"optnCatNm1":{"type":"string","description":"옵션분류명_1"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnCatNm2":{"type":"string","description":"옵션분류명_2"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnCatNm3":{"type":"string","description":"옵션분류명_3"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnCatNm4":{"type":"string","description":"옵션분류명_4"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnCatNm5":{"type":"string","description":"옵션분류명_5"},"optnNm5":{"type":"string","description":"옵션명_5"},"lgcItmNo":{"type":"string","description":"자체단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"itmSaleStatCdNm":{"type":"string","description":"단품판매상태코드명"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상) 42:판매종료(삭제)"},"repItmYn":{"type":"string","description":"대표단품여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"addSupPcost":{"type":"number","description":"추가공급원가"},"addSalePrc":{"type":"number","description":"추가판매가"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리, 13:익일배송지연 자동품절처리, 14:모든단품품절로 상품 품절처리, 15:예약상품 품절처리, 16:묶음상품 품절로 인한 품절"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"optnCatNo1":{"type":"string","description":"옵션분류번호_1"},"optnNo1":{"type":"string","description":"옵션번호_1"},"optnCatNo2":{"type":"string","description":"옵션분류번호_2"},"optnNo2":{"type":"string","description":"옵션번호_2"},"optnCatNo3":{"type":"string","description":"옵션분류번호_3"},"optnNo3":{"type":"string","description":"옵션번호_3"},"optnCatNo4":{"type":"string","description":"옵션분류번호_4"},"optnNo4":{"type":"string","description":"옵션번호_4"},"optnCatNo5":{"type":"string","description":"옵션분류번호_5"},"optnNo5":{"type":"string","description":"옵션번호_5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"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":{"/v2/goods/goodsCommonApi/getGoodsSaleStateList":{"get":{"tags":["상품 공통"],"summary":"단품 판매상태 목록 조회","description":"## 기능설명\n* 단품 판매상태 목록을 조회합니다.\n---\n## 상세설명\n* 단품 판매상태 목록을 조회합니다.\n---\n## 수정번호\n```Release v1.03_231106```\n - 단품 판매상태 목록 조회 API 추가\n","operationId":"getGoodsSaleStateList","parameters":[{"name":"goodsNo","in":"query","description":"상품번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"단품 판매상태 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseGoodsSaleStateResponse"}}}},"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":{"ResponseListGoodsNotificationItemCodeResponse":{"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/GoodsNotificationItemCodeResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsNotificationItemCodeResponse":{"type":"object","description":"상품고시항목코드 Response","properties":{"goodsNotiItemCd":{"type":"string","description":"상품고시항목코드"},"notiItemNm":{"type":"string","description":"고시항목명"},"notiItemDesc":{"type":"string","description":"고시항목설명"},"insrtMethCd":{"type":"string","description":"입력방식코드(PR013)"},"useYn":{"type":"string","description":"사용여부"},"orgnNotiItemNm":{"type":"string","description":"(다국어)기존 고시항목명"},"orgnNotiItemDesc":{"type":"string","description":"(다국어)기존 고시항목설명"}}},"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":{"/v2/goods/goodsCommonApi/getGoodsNotificationItemList":{"get":{"tags":["상품 공통"],"summary":"상품고시항목 목록 조회","description":"## 기능설명\n* 상품등록/수정/상세 페이지에서 필요한 상품고시항목 목록을 조회합니다.\n---\n## 상세설명\n* 상품고시항목코드에 따른 상품고시항목의 목록을 조회합니다.\n","operationId":"getGoodsNotificationItemList","parameters":[{"name":"goodsNotiLisartCd","in":"query","description":"상품고시품목코드","required":false,"schema":{"type":"String"}},{"name":"langCd","in":"query","description":"언어코드","required":false,"schema":{"type":"String"}}],"responses":{"200":{"description":"상품고시항목 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListGoodsNotificationItemCodeResponse"}}}},"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":{"ResponseGoodsMultiLanguageResponse":{"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/GoodsMultiLanguageResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsMultiLanguageResponse":{"type":"object","description":"상품 다국어 Response","properties":{"goodsBase":{"$ref":"#/components/schemas/GoodsBaseResponse","description":"상품기본"},"goodsMultiLanguageDtoList":{"type":"array","description":"상품 다국어 DTO 리스트","items":{"$ref":"#/components/schemas/GoodsMultiLanguageDto"}}}},"GoodsBaseResponse":{"type":"object","description":"상품기본 Response","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"salemnNm":{"type":"string","description":"판매자명"},"manufYm":{"type":"string","description":"제조년월"},"schKwdNm":{"type":"string","description":"검색키워드"},"seoTitleNm":{"type":"string","description":"SEO 타이틀명"},"seoDesc":{"type":"string","description":"SEO 설명"},"seoKwdNm":{"type":"string","description":"SEO 키워드명"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"aprvReqDt":{"type":"string","description":"승인요청일자"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliDday":{"type":"integer","format":"int32","description":"배송기일"},"itmSoutNotiYn":{"type":"string","description":"단품품절알림여부"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035)"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029)"},"aprvDt":{"type":"string","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명(PR042)"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","description":"반려일자"},"schPsbYn":{"type":"string","description":"검색가능여부"},"optnYn":{"type":"string","description":"옵션관리여부"},"optnCDYn":{"type":"string","description":"옵션 추가/삭제 여부"},"goodsNoArray":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 등록방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 내용"},"gftWthdYn":{"type":"string","description":"회수 여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"stdCtgHierarchy":{"type":"string","description":"표준분류하이라키구조"},"mdId":{"type":"string","description":"MD아이디"},"mdNm":{"type":"string","description":"MD명"},"goodsNotiLisartCd":{"type":"string","description":"상품고시품목코드"},"safeCertiNeedYn":{"type":"string","description":"안전인증필요여부(표준카테고리)"},"trdTypCd":{"type":"string","description":"거래형태코드(VD002)"},"mrgnRateGbCd":{"type":"string","description":"마진구분코드(VD008)"},"mrgnRate1":{"type":"number","description":"마진율1"},"mrgnRate2":{"type":"number","description":"마진율2"}}},"GoodsMultiLanguageDto":{"type":"object","description":"상품 다국어 DTO","properties":{"goodsBase":{"$ref":"#/components/schemas/GoodsBaseResponse","description":"상품기본"},"prGoodsContInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 컨텐츠 정보"},"prGoodsItemInfoList":{"type":"array","description":"상품 항목 정보 목록","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prAdveWrdHistList":{"type":"array","description":" 홍보문구이력 목록","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}}}},"PrGoodsContInfo":{"type":"object","description":"상품컨텐츠정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"PrGoodsItemInfo":{"type":"object","description":"상품항목정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNotiLisartCd":{"type":"string","description":"상품고시항목코드"},"goodsNotiItemCd":{"type":"string","description":"상품고시품목코드"},"notiItemCmt":{"type":"string","description":"고시항목내용"}}},"PrAdveWrdHist":{"type":"object","description":"상품홍보문구이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일자"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일자"},"adveWrd":{"type":"string","description":"홍보문구"},"useYn":{"type":"string","description":"사용여부"}}},"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":{"/v2/goods/goodsCommonApi/getGoodsMultiLanguageInfo":{"get":{"tags":["상품 공통"],"summary":"상품 다국어 정보 조회","description":"## 기능설명\n* 상품의 다국어 정보를 조회합니다.\n---\n## 상세설명\n* 상품에 현재 등록된 모든 다국어 정보를 리스트로 조회합니다.\n","operationId":"getGoodsMultiLanguageInfo","parameters":[{"name":"goodsNo","in":"query","description":"상품번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"상품 다국어 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseGoodsMultiLanguageResponse"}}}},"900":{"description":"상품 다국어 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 상품 카테고리 속성 목록 조회

> \## 기능설명\
> \* 상품등록/수정/상세 페이지에서 필요한 상품 카테고리 속성 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 표준카테고리에 매핑한 상품속성정보 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- 표준카테고리 관리속성 추가에 따른 신규 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":{"GoodsCtgAttRequest":{"type":"object","description":"상품카테고리속성 Request","properties":{"langCd":{"type":"string","default":"ko","description":"사이트 언어"},"goodsNo":{"type":"string","description":"상품번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"}}},"ResponseListGoodsCtgAttResponse":{"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/GoodsCtgAttResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsCtgAttResponse":{"type":"object","description":"상품카테고리속성 Response","properties":{"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsNo":{"type":"string","description":"상품번호"},"attValTypCd":{"type":"string","description":"속성값유형코드(PR043)"},"attNm":{"type":"string","description":"속성명"},"attCd":{"type":"string","description":"속성코드"},"attVal":{"type":"string","description":"속성값"},"dispSeq":{"type":"string","description":"전시순서"},"orgnAttNm":{"type":"string","description":"(다국어)기존 속성명"},"orgnAttVal":{"type":"string","description":"(다국어)기존 속성값"}}},"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":{"/v2/goods/goodsCommonApi/getGoodsCtgAttInfoList":{"get":{"tags":["상품 공통"],"summary":"상품 카테고리 속성 목록 조회","description":"## 기능설명\n* 상품등록/수정/상세 페이지에서 필요한 상품 카테고리 속성 목록을 조회합니다.\n---\n## 상세설명\n* 표준카테고리에 매핑한 상품속성정보 목록을 조회합니다.\n---\n## 수정번호\n```Release v1.05_231204```\n - 표준카테고리 관리속성 추가에 따른 신규 API 생성\n","operationId":"getGoodsCtgAttInfoList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsCtgAttRequest"}}],"responses":{"200":{"description":"상품 카테고리 속성 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListGoodsCtgAttResponse"}}}},"900":{"description":"상품 카테고리 속성 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 상품 기본 정보 조회

> \## 기능설명\
> \* 상품 기본 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품 기본 정보를 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\`: 묶음상품 구입자나이제한코드(buyrAgeLmtCd) 추가<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":{"ResponseGoodsBaseResponse":{"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/GoodsBaseResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsBaseResponse":{"type":"object","description":"상품기본 Response","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"salemnNm":{"type":"string","description":"판매자명"},"manufYm":{"type":"string","description":"제조년월"},"schKwdNm":{"type":"string","description":"검색키워드"},"seoTitleNm":{"type":"string","description":"SEO 타이틀명"},"seoDesc":{"type":"string","description":"SEO 설명"},"seoKwdNm":{"type":"string","description":"SEO 키워드명"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"aprvReqDt":{"type":"string","description":"승인요청일자"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliDday":{"type":"integer","format":"int32","description":"배송기일"},"itmSoutNotiYn":{"type":"string","description":"단품품절알림여부"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035)"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029)"},"aprvDt":{"type":"string","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명(PR042)"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","description":"반려일자"},"schPsbYn":{"type":"string","description":"검색가능여부"},"optnYn":{"type":"string","description":"옵션관리여부"},"optnCDYn":{"type":"string","description":"옵션 추가/삭제 여부"},"goodsNoArray":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 등록방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 내용"},"gftWthdYn":{"type":"string","description":"회수 여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"stdCtgHierarchy":{"type":"string","description":"표준분류하이라키구조"},"mdId":{"type":"string","description":"MD아이디"},"mdNm":{"type":"string","description":"MD명"},"goodsNotiLisartCd":{"type":"string","description":"상품고시품목코드"},"safeCertiNeedYn":{"type":"string","description":"안전인증필요여부(표준카테고리)"},"trdTypCd":{"type":"string","description":"거래형태코드(VD002)"},"mrgnRateGbCd":{"type":"string","description":"마진구분코드(VD008)"},"mrgnRate1":{"type":"number","description":"마진율1"},"mrgnRate2":{"type":"number","description":"마진율2"}}},"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":{"/v2/goods/goodsCommonApi/getGoodsBaseInfo":{"get":{"tags":["상품 공통"],"summary":"상품 기본 정보 조회","description":"## 기능설명\n* 상품 기본 정보를 조회합니다.\n---\n## 상세설명\n* 상품 기본 정보를 조회합니다.\n---\n## 수정번호\n```Release v1.04_231120```: 묶음상품 구입자나이제한코드(buyrAgeLmtCd) 추가\n","operationId":"getGoodsBaseInfo","parameters":[{"name":"goodsNo","in":"query","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","required":false,"schema":{"type":"string","default":"ko"}}],"responses":{"200":{"description":"상품정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseGoodsBaseResponse"}}}},"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":{"ResponseGiftGoodsResponse":{"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/GiftGoodsResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GiftGoodsResponse":{"type":"object","description":"사은품 상세 Response","properties":{"prGoodsBase":{"$ref":"#/components/schemas/GoodsBaseResponse","description":"사은품 기본 정보"},"prItmBase":{"$ref":"#/components/schemas/PrItmBase","description":"사은품 단품 정보"},"giftImageInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"사은품 이미지 정보"}}},"GoodsBaseResponse":{"type":"object","description":"상품기본 Response","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"salemnNm":{"type":"string","description":"판매자명"},"manufYm":{"type":"string","description":"제조년월"},"schKwdNm":{"type":"string","description":"검색키워드"},"seoTitleNm":{"type":"string","description":"SEO 타이틀명"},"seoDesc":{"type":"string","description":"SEO 설명"},"seoKwdNm":{"type":"string","description":"SEO 키워드명"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"aprvReqDt":{"type":"string","description":"승인요청일자"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliDday":{"type":"integer","format":"int32","description":"배송기일"},"itmSoutNotiYn":{"type":"string","description":"단품품절알림여부"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035)"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029)"},"aprvDt":{"type":"string","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명(PR042)"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","description":"반려일자"},"schPsbYn":{"type":"string","description":"검색가능여부"},"optnYn":{"type":"string","description":"옵션관리여부"},"optnCDYn":{"type":"string","description":"옵션 추가/삭제 여부"},"goodsNoArray":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 등록방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 내용"},"gftWthdYn":{"type":"string","description":"회수 여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"stdCtgHierarchy":{"type":"string","description":"표준분류하이라키구조"},"mdId":{"type":"string","description":"MD아이디"},"mdNm":{"type":"string","description":"MD명"},"goodsNotiLisartCd":{"type":"string","description":"상품고시품목코드"},"safeCertiNeedYn":{"type":"string","description":"안전인증필요여부(표준카테고리)"},"trdTypCd":{"type":"string","description":"거래형태코드(VD002)"},"mrgnRateGbCd":{"type":"string","description":"마진구분코드(VD008)"},"mrgnRate1":{"type":"number","description":"마진율1"},"mrgnRate2":{"type":"number","description":"마진율2"}}},"PrItmBase":{"type":"object","description":"단품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"optnCatNm1":{"type":"string","description":"옵션분류명_1"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnCatNm2":{"type":"string","description":"옵션분류명_2"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnCatNm3":{"type":"string","description":"옵션분류명_3"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnCatNm4":{"type":"string","description":"옵션분류명_4"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnCatNm5":{"type":"string","description":"옵션분류명_5"},"optnNm5":{"type":"string","description":"옵션명_5"},"lgcItmNo":{"type":"string","description":"자체단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"itmSaleStatCdNm":{"type":"string","description":"단품판매상태코드명"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상) 42:판매종료(삭제)"},"repItmYn":{"type":"string","description":"대표단품여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"addSupPcost":{"type":"number","description":"추가공급원가"},"addSalePrc":{"type":"number","description":"추가판매가"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리, 13:익일배송지연 자동품절처리, 14:모든단품품절로 상품 품절처리, 15:예약상품 품절처리, 16:묶음상품 품절로 인한 품절"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"optnCatNo1":{"type":"string","description":"옵션분류번호_1"},"optnNo1":{"type":"string","description":"옵션번호_1"},"optnCatNo2":{"type":"string","description":"옵션분류번호_2"},"optnNo2":{"type":"string","description":"옵션번호_2"},"optnCatNo3":{"type":"string","description":"옵션분류번호_3"},"optnNo3":{"type":"string","description":"옵션번호_3"},"optnCatNo4":{"type":"string","description":"옵션분류번호_4"},"optnNo4":{"type":"string","description":"옵션번호_4"},"optnCatNo5":{"type":"string","description":"옵션분류번호_5"},"optnNo5":{"type":"string","description":"옵션번호_5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"PrGoodsContInfo":{"type":"object","description":"상품컨텐츠정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"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":{"/v2/goods/goodsCommonApi/getGiftGoodsInfo":{"get":{"tags":["상품 공통"],"summary":"사은품 정보 조회","description":"## 기능설명\n* 사은품 정보를 조회합니다.\n---\n## 상세설명\n* 사은품 정보를 조회합니다.\n---\n## 상세설명\n* 사은품의 상품정보를 조회합니다.\n","operationId":"getGiftGoodsInfo","parameters":[{"name":"goodsNo","in":"query","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","required":false,"schema":{"type":"string","default":"ko"}}],"responses":{"200":{"description":"상품정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseGiftGoodsResponse"}}}},"900":{"description":"상품정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 일반상품 정보 조회

> \## 기능설명\
> \* 일반상품 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 일반상품의 상품정보를 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.03\_231106\`\`\`\
> &#x20;\- 사이즈 가이드 관련 컬럼(szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts) 추가\
> &#x20;\- 아이콘(뱃지) 설정 추가\
> \
> \`\`\`Release v1.04\_231120\`\`\`\
> &#x20;\- 판매상태 임시저장인 상품 조회 시 대체텍스트를 빈 값으로 반환하도록 수정\
> &#x20;\- 정기배송상품여부 컬럼(rglrDeliGoodsYn) 추가\
> \`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- 전시 상품 조회 쿼리 inner join으로 변경<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":{"ResponseGeneralGoodsApiResponse":{"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/GeneralGoodsApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GeneralGoodsApiResponse":{"type":"object","description":"일반 상품 상세 Response","properties":{"prGoodsBase":{"$ref":"#/components/schemas/GoodsBaseResponse","description":"상품 기본 정보"},"prGoodsCurrentPrce":{"$ref":"#/components/schemas/PrGoodsPrceHist","description":"상품 현재 적용 가격 정보"},"prRsvSaleHistList":{"type":"array","description":"예약 판매 이력","items":{"$ref":"#/components/schemas/PrRsvSaleHist"}},"prGoodsItemInfoList":{"type":"array","description":"상품 고시 항목 목록","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prGoodsSafeCertiHistList":{"type":"array","description":"상품 안전인증 이력","items":{"$ref":"#/components/schemas/PrGoodsSafeCertiHist"}},"prGoodsAttInfoList":{"type":"array","description":"상품 카테고리 속성","items":{"$ref":"#/components/schemas/PrGoodsAttInfo"}},"prGoodsPayMeanInfoList":{"type":"array","description":"상품결제수단정보 목록","items":{"$ref":"#/components/schemas/PrGoodsPayMeanInfo"}},"prItmOptnInfoList":{"type":"array","description":"단품 옵션 목록","items":{"$ref":"#/components/schemas/GoodsOptionApiResponse"}},"prItmBaseList":{"type":"array","description":"단품 목록","items":{"$ref":"#/components/schemas/PrItmBase"}},"prGoodsContInfoList":{"type":"array","description":"상품 컨텐츠 목록","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"prStdCtgDispInfoList":{"type":"array","description":"표준카테고리전시정보 목록","items":{"$ref":"#/components/schemas/PrStdCtgDispInfo"}},"prAssocGoodsInfoList":{"type":"array","description":"연관상품 목록","items":{"$ref":"#/components/schemas/AssociatedGoodsResponse"}},"prAdveWrdHistList":{"type":"array","description":"홍보문구 목록","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}},"prPrestHistList":{"type":"array","description":"증정품 목록","items":{"$ref":"#/components/schemas/PrPrestHist"}},"prGoodsIconInfoList":{"type":"array","description":"상품아이콘 정보 목록","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}}}},"GoodsBaseResponse":{"type":"object","description":"상품기본 Response","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"salemnNm":{"type":"string","description":"판매자명"},"manufYm":{"type":"string","description":"제조년월"},"schKwdNm":{"type":"string","description":"검색키워드"},"seoTitleNm":{"type":"string","description":"SEO 타이틀명"},"seoDesc":{"type":"string","description":"SEO 설명"},"seoKwdNm":{"type":"string","description":"SEO 키워드명"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"aprvReqDt":{"type":"string","description":"승인요청일자"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliDday":{"type":"integer","format":"int32","description":"배송기일"},"itmSoutNotiYn":{"type":"string","description":"단품품절알림여부"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035)"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029)"},"aprvDt":{"type":"string","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명(PR042)"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","description":"반려일자"},"schPsbYn":{"type":"string","description":"검색가능여부"},"optnYn":{"type":"string","description":"옵션관리여부"},"optnCDYn":{"type":"string","description":"옵션 추가/삭제 여부"},"goodsNoArray":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 등록방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 내용"},"gftWthdYn":{"type":"string","description":"회수 여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"stdCtgHierarchy":{"type":"string","description":"표준분류하이라키구조"},"mdId":{"type":"string","description":"MD아이디"},"mdNm":{"type":"string","description":"MD명"},"goodsNotiLisartCd":{"type":"string","description":"상품고시품목코드"},"safeCertiNeedYn":{"type":"string","description":"안전인증필요여부(표준카테고리)"},"trdTypCd":{"type":"string","description":"거래형태코드(VD002)"},"mrgnRateGbCd":{"type":"string","description":"마진구분코드(VD008)"},"mrgnRate1":{"type":"number","description":"마진율1"},"mrgnRate2":{"type":"number","description":"마진율2"}}},"PrGoodsPrceHist":{"type":"object","description":"상품가격이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"histStrDtm":{"type":"string","format":"date-time","description":"이력시작일시"},"histEndDtm":{"type":"string","format":"date-time","description":"이력종료일시"},"supPcost":{"type":"number","description":"공급원가"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"판매가"},"eventPrc":{"type":"number","description":"행사가"},"mrgnRate":{"type":"number","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"상품가격유형코드"},"prcChgCausCd":{"type":"string","description":"가격변경사유코드(PR033)"},"prcChgCausCdNm":{"type":"string","description":"가격변경사유"},"timeDealYn":{"type":"string","description":"타임딜 여부"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"PrRsvSaleHist":{"type":"object","description":"예약판매이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"예약시작일시"},"rsvEndDtm":{"type":"string","format":"date-time","description":"예약종료일시"},"rsvEndAfProcMethCd":{"type":"string","description":"예약종료후판매방식(PR011)"},"rsvStopYn":{"type":"string","description":"예약중단여부"},"rsvStopCausCd":{"type":"string","description":"예약중단사유코드(PR034)"},"rsvStopDtm":{"type":"string","format":"date-time","description":"예약중단일시"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자"}}},"PrGoodsItemInfo":{"type":"object","description":"상품항목정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNotiLisartCd":{"type":"string","description":"상품고시항목코드"},"goodsNotiItemCd":{"type":"string","description":"상품고시품목코드"},"notiItemCmt":{"type":"string","description":"고시항목내용"}}},"PrGoodsSafeCertiHist":{"type":"object","description":"상품안전인증이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"safeCertiGbCd":{"type":"string","description":"안전인증구분코드"},"safeCertiNo":{"type":"string","description":"안전인증번호"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"safeCertiOrnNm":{"type":"string","description":"안전인증기관명"}}},"PrGoodsAttInfo":{"type":"object","properties":{"langCd":{"type":"string","description":"언어코드(CM009)"},"goodsNo":{"type":"string","description":"상품번호"},"attCd":{"type":"string","description":"속성코드"},"attVal":{"type":"string","description":"속성값"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"}}},"PrGoodsPayMeanInfo":{"type":"object","description":"상품겿제수단정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"payWayCd":{"type":"string","description":"결제수단코드"},"useYn":{"type":"string","description":"사용여부"}}},"GoodsOptionApiResponse":{"type":"object","description":"상품 단품옵션정보 Api Response","properties":{"goodsNo":{"type":"string","description":"상품번호"},"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNo":{"type":"string","description":"옵션번호"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"string","description":"옵션분류 순서"},"optnCatRegGbCd":{"type":"string","description":"옵션분류등록구분코드"},"optnCatRegGbNm":{"type":"string","description":"옵션분류등록구분코드명"},"optnCatTypCd":{"type":"string","description":"옵션분류유형코드(PR019)"},"optnCatTypCdNm":{"type":"string","description":"옵션분류유형코드명"},"optnList":{"type":"array","description":"단품 옵션값 리스트","items":{"$ref":"#/components/schemas/PrItmOptnInfo"}},"optnCdList":{"type":"string","deprecated":true,"description":"옵션값 리스트"},"optnCdNmList":{"type":"string","deprecated":true,"description":"옵션명 리스트"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"}}},"PrItmOptnInfo":{"type":"object","description":"단품옵션정보","properties":{"langCd":{"type":"string","description":"언어코드"},"goodsNo":{"type":"string","description":"상품번호"},"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnNo":{"type":"string","description":"옵션번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"옵션분류 순서"},"optnSortSeq":{"type":"integer","format":"int32","description":"옵션 순서"}}},"PrItmBase":{"type":"object","description":"단품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"optnCatNm1":{"type":"string","description":"옵션분류명_1"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnCatNm2":{"type":"string","description":"옵션분류명_2"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnCatNm3":{"type":"string","description":"옵션분류명_3"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnCatNm4":{"type":"string","description":"옵션분류명_4"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnCatNm5":{"type":"string","description":"옵션분류명_5"},"optnNm5":{"type":"string","description":"옵션명_5"},"lgcItmNo":{"type":"string","description":"자체단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"itmSaleStatCdNm":{"type":"string","description":"단품판매상태코드명"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상) 42:판매종료(삭제)"},"repItmYn":{"type":"string","description":"대표단품여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"addSupPcost":{"type":"number","description":"추가공급원가"},"addSalePrc":{"type":"number","description":"추가판매가"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리, 13:익일배송지연 자동품절처리, 14:모든단품품절로 상품 품절처리, 15:예약상품 품절처리, 16:묶음상품 품절로 인한 품절"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"optnCatNo1":{"type":"string","description":"옵션분류번호_1"},"optnNo1":{"type":"string","description":"옵션번호_1"},"optnCatNo2":{"type":"string","description":"옵션분류번호_2"},"optnNo2":{"type":"string","description":"옵션번호_2"},"optnCatNo3":{"type":"string","description":"옵션분류번호_3"},"optnNo3":{"type":"string","description":"옵션번호_3"},"optnCatNo4":{"type":"string","description":"옵션분류번호_4"},"optnNo4":{"type":"string","description":"옵션번호_4"},"optnCatNo5":{"type":"string","description":"옵션분류번호_5"},"optnNo5":{"type":"string","description":"옵션번호_5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"PrGoodsContInfo":{"type":"object","description":"상품컨텐츠정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"PrStdCtgDispInfo":{"type":"object","description":"표준카테고리전시정보","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"repCtgYn":{"type":"string","description":"대표카테고리여부"},"useYn":{"type":"string","description":"사용여부"},"dispCtgNm":{"type":"string","description":"전시카테고리명","readOnly":true},"dpmlNo":{"type":"string","description":"전시몰 번호"},"siteNm":{"type":"string","description":"사이트명","readOnly":true},"dpmlNm":{"type":"string","description":"전시몰명","readOnly":true},"dispCtgHierarchy":{"type":"string","description":"상품 BO-API_전시카테고리 구조","readOnly":true}}},"AssociatedGoodsResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"asctGoodsNo":{"type":"string","description":"연관상품번호"},"asctGbCd":{"type":"string","description":"연관구분코드"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"asctGoodsNm":{"type":"string"},"saleStatCdNm":{"type":"string"}}},"PrAdveWrdHist":{"type":"object","description":"상품홍보문구이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일자"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일자"},"adveWrd":{"type":"string","description":"홍보문구"},"useYn":{"type":"string","description":"사용여부"}}},"PrPrestHist":{"type":"object","description":"증정품이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"prestNm":{"type":"string","description":"증정품명"},"useYn":{"type":"string","description":"사용여부"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"}}},"PrGoodsIconInfo":{"type":"object","description":"상품아이콘정보","properties":{"siteNo":{"type":"string","description":"사이트번호"},"goodsNo":{"type":"string","description":"상품번호"},"dispIconNo":{"type":"string","description":"전시아이콘번호"},"siteNm":{"type":"string","description":"사이트명"},"iconNm":{"type":"string","description":"아이콘명"},"dispMediaCdNm":{"type":"string","description":"전시매체"},"iconTypCdNm":{"type":"string","description":"아이콘 유형"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"iconPathNm":{"type":"string","description":"아이콘 이미지 경로"},"delYn":{"type":"string","description":"삭제여부"}}},"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":{"/v2/goods/goodsCommonApi/getGeneralGoodsInfo":{"get":{"tags":["상품 공통"],"summary":"일반상품 정보 조회","description":"## 기능설명\n* 일반상품 정보를 조회합니다.\n---\n## 상세설명\n* 일반상품의 상품정보를 조회합니다.\n---\n## 수정번호\n```Release v1.03_231106```\n - 사이즈 가이드 관련 컬럼(szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts) 추가\n - 아이콘(뱃지) 설정 추가\n\n```Release v1.04_231120```\n - 판매상태 임시저장인 상품 조회 시 대체텍스트를 빈 값으로 반환하도록 수정\n - 정기배송상품여부 컬럼(rglrDeliGoodsYn) 추가\n```Release v1.05_231204```\n - 전시 상품 조회 쿼리 inner join으로 변경\n","operationId":"getGeneralGoodsInfo","parameters":[{"name":"goodsNo","in":"query","description":"상품번호","required":true,"schema":{"type":"String"}},{"name":"langCd","in":"query","description":"언어코드","required":false,"schema":{"type":"String"}}],"responses":{"200":{"description":"상품정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseGeneralGoodsApiResponse"}}}},"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":{"EnEntrBaseRequest":{"type":"object","description":"협력사 조회 팝업 Request","properties":{"argSelectType":{"type":"string","description":"선택구분","minLength":1},"argTrdStatCd":{"type":"string","description":"거래상태"},"argEntrGbCd":{"type":"string","description":"협력사구분"},"argTrdTypCd":{"type":"string","description":"거래형태코드"},"argEcpnUseYn":{"type":"string","description":"e쿠폰사용여부"},"entrGbCd":{"type":"string","description":"협력사구분코드(VD001) 10:상품공급업자, 20:제휴사업자"},"trdStatCd":{"type":"string","description":"거래상태코드(VD003) 10:거래대기, 20:거래중, 30:거래종료"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"trdTypCd":{"type":"string","description":"거래형태코드(VD002)"},"ecpnUseYn":{"type":"string","description":"e쿠폰사용여부"}},"required":["argSelectType"]},"ResponseEnEntrBaseResponse":{"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/EnEntrBaseResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"EnEntrBaseResponse":{"type":"object","description":"협력사 기본 정보 Response","properties":{"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"entrGbCd":{"type":"string","description":"협력사구분코드(VD001) 10:상품공급업자, 20:제휴사업자"},"latt":{"type":"number","format":"double","description":"위도"},"lngt":{"type":"number","format":"double","description":"경도"},"trdTypCd":{"type":"string","description":"거래형태코드(VD002) 10:직매입, 20:위탁판매, 30:제휴사"},"buyTypCdNm":{"type":"string","description":"매입형태코드명"},"trdStatCd":{"type":"string","description":"거래상태코드(VD003) 10:거래대기, 20:거래중, 30:거래종료"},"lgcEntrNo":{"type":"string","description":"기간계협력사번호"},"rpstmnNm":{"type":"string","description":"대표자명"},"bmanNo":{"type":"string","description":"사업자번호"},"bmanKindNm":{"type":"string","description":"사업자종류코드명"},"corpnNo":{"type":"string","description":"법인번호"},"btyp":{"type":"string","description":"업태"},"bkind":{"type":"string","description":"업종"},"contStrtDy":{"type":"string","format":"date","description":"계약시작일자"},"contEndDy":{"type":"string","format":"date","description":"계약종료일자"},"aempNm":{"type":"string","description":"담당자명"},"aempTelRgnNo":{"type":"string","description":"담당자전화지역번호"},"aempTelTxnoNo":{"type":"string","description":"담당자전화국번번호"},"aempTelEndNo":{"type":"string","description":"담당자전화끝번호"},"aempCellSctNo":{"type":"string","description":"담당자휴대폰구분번호"},"aempCellTxnoNo":{"type":"string","description":"담당자휴대폰국번번호"},"aempCellEndNo":{"type":"string","description":"담당자휴대폰끝번호"},"faxRgnNo":{"type":"string","description":"팩스지역번호"},"faxTxnoNo":{"type":"string","description":"팩스국번번호"},"faxEndNo":{"type":"string","description":"팩스끝번호"},"bmanKindCd":{"type":"string","description":"사업자종류코드(VD004) 10:면세업자, 20:일반과세자"},"zipNoSeq":{"type":"integer","format":"int64","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rmkCont":{"type":"string","description":"비고내용"},"mrgnRateGbCd":{"type":"string","description":"마진율구분코드(VD008) 10:고정마진, 20:구간마진"},"mrgnRate1":{"type":"number","description":"마진율1"},"mrgnRate2":{"type":"number","description":"마진율2"},"singleMrgnRate":{"type":"number","description":"단일마진율"},"intervalMrgnRate1":{"type":"number","description":"구간마진율1"},"intervalMrgnRate2":{"type":"number","description":"구간마진율2"},"ecpnUseYn":{"type":"string","description":"e쿠폰사용여부"},"ecpnLinkGbCd":{"type":"string","description":"E쿠폰연동구분코드"},"ecpnLinkGbNm":{"type":"string","description":"E쿠폰연동구분명"},"entrGbNm":{"type":"string","description":"협력사구분명"},"trdStatNm":{"type":"string","description":"거래상태명"},"itmSaleStatCd":{"type":"string","description":"단품판매상태","enum":["TEMPORARY_STORAGE","WAITING_FOR_APPROVAL","COMPANION","SALES","SOLD_OUT","SALE_END"]},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드","enum":["SALES","SOLD_OUT","SUSPEND","SALE_END","PARTNER_SALE_END"]},"rtGrpNo":{"type":"string","description":"권한그룹번호"},"endPage":{"type":"boolean","description":"마지막페이지 여부"},"totalCount":{"type":"integer","format":"int32","description":"총 개수"},"endPartnerSaleAndAuthGroup":{"type":"string","writeOnly":true}}},"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":{"/v2/goods/goodsCommonApi/getEtEntrBase":{"get":{"tags":["상품 공통"],"summary":"협력사 기본 정보 조회","description":"## 기능설명\n* 상품등록/수정/상세 페이지에서 필요한 협력사 기본 정보를 조회합니다.\n---\n## 상세설명\n* 협력사 번호에 따른 협력사 기본 정보를 조회합니다.\n","operationId":"getEtEntrBase","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/EnEntrBaseRequest"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}}],"responses":{"200":{"description":"협력사 기본 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseEnEntrBaseResponse"}}}},"900":{"description":"협력사 기본 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 표준카테고리별 전시카테고리 목록 조회

> \## 기능설명\
> \* 표준카테고리별 전시카테고리 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 표준카테고리별 전시카테고리 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.05\_231204\`\`\`\
> \- 표준카테고리전시정보 목록 조회 쿼리 goodsNo가 없을 경우 삭제\
> \- 전시 카테고리 사용 여부 조건 추가\
> \- 표준 전시 카테고리 연결 삭제 여부 조건 추가<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":{"StandardCategoryDisplayRequest":{"type":"object","description":"표준카테고리 전시정보 Requset","properties":{"stdCtgNo":{"type":"string","description":"표준카테고리번호"}}},"ResponseListPrStdCtgDispInfo":{"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/PrStdCtgDispInfo"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PrStdCtgDispInfo":{"type":"object","description":"표준카테고리전시정보","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"repCtgYn":{"type":"string","description":"대표카테고리여부"},"useYn":{"type":"string","description":"사용여부"},"dispCtgNm":{"type":"string","description":"전시카테고리명","readOnly":true},"dpmlNo":{"type":"string","description":"전시몰 번호"},"siteNm":{"type":"string","description":"사이트명","readOnly":true},"dpmlNm":{"type":"string","description":"전시몰명","readOnly":true},"dispCtgHierarchy":{"type":"string","description":"상품 BO-API_전시카테고리 구조","readOnly":true}}},"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":{"/v2/goods/goodsCommonApi/getDisplayCategoryListByStandardCategory":{"get":{"tags":["상품 공통"],"summary":"표준카테고리별 전시카테고리 목록 조회","description":"## 기능설명\n* 표준카테고리별 전시카테고리 목록을 조회합니다.\n---\n## 상세설명\n* 표준카테고리별 전시카테고리 목록을 조회합니다.\n---\n## 수정번호\n```Release v1.05_231204```\n- 표준카테고리전시정보 목록 조회 쿼리 goodsNo가 없을 경우 삭제\n- 전시 카테고리 사용 여부 조건 추가\n- 표준 전시 카테고리 연결 삭제 여부 조건 추가\n","operationId":"getDisplayCategoryListByStandardCategory","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StandardCategoryDisplayRequest"}}],"responses":{"200":{"description":"표준카테고리별 전시카테고리 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListPrStdCtgDispInfo"}}}},"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":{"ResponseListDeliveryPolicyResponse":{"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/DeliveryPolicyResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"DeliveryPolicyResponse":{"type":"object","description":"일반상품 배송정책 Response","properties":{"deliPolcNo":{"type":"string","description":"배송정책번호"},"entrNm":{"type":"string","description":"협력사명"},"entrNo":{"type":"string","description":"협력사번호"},"dlexRegnGrpCd":{"type":"string","description":"배송지역구분코드"},"dlexRegnGrpNm":{"type":"string","description":"배송지역구분명"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005)"},"dlexTypNm":{"type":"string","description":"배송비유형코드명"},"wthdRtnAmt":{"type":"string","description":"반품비"},"dlexAmt":{"type":"string","description":"배송비"},"stdAmt":{"type":"string","description":"기준금액"},"addDlexAmt":{"type":"string","description":"추가배송비"},"addDlexInfo":{"type":"string","description":"추가배송비 정보"},"dlexTotAmt":{"type":"string","description":"배송비 총계"}}},"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":{"/v2/goods/goodsCommonApi/getDeliveryPolicyList":{"get":{"tags":["상품 공통"],"summary":"배송비/반품비 정책 목록 조회","description":"## 기능설명\n* 상품등록/수정/상세 페이지에서 필요한 배송비/반품비 정책 목록을 조회합니다\n---\n## 상세설명\n* 협력사에 따른 배송비/반품비 정책 목록을 조회합니다.\n","operationId":"getDeliveryPolicyList","parameters":[{"name":"entrNo","in":"query","description":"협력사번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"배송비/반품비 정책 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListDeliveryPolicyResponse"}}}},"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":{"GoodsPriceHistoryRequest":{"type":"object","description":"상품가격이력 Request","properties":{"goodsNo":{"type":"string","description":"상품번호"},"histEndDtm":{"type":"string","format":"date","description":"이력종료일시"},"histStrDtm":{"type":"string","format":"date","description":"이력시작일시"},"supPcost":{"type":"number","description":"공급원가"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"판매가"},"mrgnRate":{"type":"number","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"상품가격유형코드"},"prcChgCausCd":{"type":"string","description":"가격변경사유코드(PR033)"},"rsvCudStat":{"type":"string","description":"가격변경요청코드"},"timeDealYn":{"type":"string","description":"타임딜여부"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"ResponsePrGoodsPrceHist":{"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/PrGoodsPrceHist","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PrGoodsPrceHist":{"type":"object","description":"상품가격이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"histStrDtm":{"type":"string","format":"date-time","description":"이력시작일시"},"histEndDtm":{"type":"string","format":"date-time","description":"이력종료일시"},"supPcost":{"type":"number","description":"공급원가"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"판매가"},"eventPrc":{"type":"number","description":"행사가"},"mrgnRate":{"type":"number","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"상품가격유형코드"},"prcChgCausCd":{"type":"string","description":"가격변경사유코드(PR033)"},"prcChgCausCdNm":{"type":"string","description":"가격변경사유"},"timeDealYn":{"type":"string","description":"타임딜 여부"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"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/goods/goodsCommontApi/getGoodsPrePriceHistory":{"get":{"tags":["상품 공통"],"summary":"적용 중인 가격 조회","description":"## 기능설명\n* 날짜 기준으로 적용 중인 가격를 조회합니다.\n---\n## 상세설명\n* 상품에 날짜기준으로 적용중인 행사가 정보를 조회합니다.\n","operationId":"getGoodsPrePriceHistory","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsPriceHistoryRequest"}},{"name":"goodsNo","in":"query","description":"상품번호","schema":{"type":"String"}}],"responses":{"200":{"description":"적용 중인 가격 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePrGoodsPrceHist"}}}},"900":{"description":"적용 중인 가격 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 가격이력 정보 조회

> \## 기능설명\
> \* 가격이력 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 일반상품의 가격이력을 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v2.00\_240808\`\`\`\
> &#x20;\- 일반상품 정보 조회에서 분할\
> \`\`\`Release v1.06\_250609\`\`\`\
> &#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":{"ResponseListPrGoodsPrceHist":{"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/PrGoodsPrceHist"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PrGoodsPrceHist":{"type":"object","description":"상품가격이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"histStrDtm":{"type":"string","format":"date-time","description":"이력시작일시"},"histEndDtm":{"type":"string","format":"date-time","description":"이력종료일시"},"supPcost":{"type":"number","description":"공급원가"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"판매가"},"eventPrc":{"type":"number","description":"행사가"},"mrgnRate":{"type":"number","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"상품가격유형코드"},"prcChgCausCd":{"type":"string","description":"가격변경사유코드(PR033)"},"prcChgCausCdNm":{"type":"string","description":"가격변경사유"},"timeDealYn":{"type":"string","description":"타임딜 여부"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"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/goods/goodsCommontApi/getGeneralGoodsPriceHist":{"get":{"tags":["상품 공통"],"summary":"가격이력 정보 조회","description":"## 기능설명\n* 가격이력 정보를 조회합니다.\n---\n## 상세설명\n* 일반상품의 가격이력을 조회합니다.\n---\n## 수정번호\n```Release v2.00_240808```\n - 일반상품 정보 조회에서 분할\n```Release v1.06_250609```\n - 타임딜 정보 조회 추가\n","operationId":"getGeneralGoodsPriceHist","parameters":[{"name":"goodsNo","in":"query","description":"상품번호","required":true,"schema":{"type":"String"}},{"name":"langCd","in":"query","description":"언어코드","required":false,"schema":{"type":"String"}}],"responses":{"200":{"description":"상품정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListPrGoodsPrceHist"}}}},"900":{"description":"상품정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api/back-office-api/goods-bo-api/undefined-4.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.